Upstream/WordPress
1
0
Fork 0
mirror of https://github.com/WordPress/WordPress.git synced 2024-12-22 17:18:32 +01:00
Code Issues Projects Releases Wiki Activity

L10N: improve accuracy of docs.

Browse Source 
Props johnbillion.
Fixes #37585.

Built from https://develop.svn.wordpress.org/trunk@38360


git-svn-id: http://core.svn.wordpress.org/trunk@38301 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Scott Taylor 2016-08-26 09:38:28 +00:00
parent 6a43b84454
commit ac6c22c392
2 changed files with 21 additions and 28 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

47
wp-includes/l10n.php
View File

@ -91,18 +91,18 @@ function get_locale() {
*/ */
function translate( $text, $domain = 'default' ) { function translate( $text, $domain = 'default' ) {
$translations = get_translations_for_domain( $domain ); $translations = get_translations_for_domain( $domain );
$translations = $translations->translate( $text ); $translation = $translations->translate( $text );
/** /**
* Filters text with its translation. * Filters text with its translation.
* *
* @since 2.0.11 * @since 2.0.11
* *
* @param string $translations Translated text. * @param string $translation Translated text.
* @param string $text Text to translate. * @param string $text Text to translate.
* @param string $domain Text domain. Unique identifier for retrieving translated strings. * @param string $domain Text domain. Unique identifier for retrieving translated strings.
*/ */
return apply_filters( 'gettext', $translations, $text, $domain ); return apply_filters( 'gettext', $translation, $text, $domain );
} }
/** /**
@ -143,18 +143,18 @@ function before_last_bar( $string ) {
*/ */
function translate_with_gettext_context( $text, $context, $domain = 'default' ) { function translate_with_gettext_context( $text, $context, $domain = 'default' ) {
$translations = get_translations_for_domain( $domain ); $translations = get_translations_for_domain( $domain );
$translations = $translations->translate( $text, $context ); $translation = $translations->translate( $text, $context );
/** /**
* Filters text with its translation based on context information. * Filters text with its translation based on context information.
* *
* @since 2.8.0 * @since 2.8.0
* *
* @param string $translations Translated text. * @param string $translation Translated text.
* @param string $text Text to translate. * @param string $text Text to translate.
* @param string $context Context information for the translators. * @param string $context Context information for the translators.
* @param string $domain Text domain. Unique identifier for retrieving translated strings. * @param string $domain Text domain. Unique identifier for retrieving translated strings.
*/ */
return apply_filters( 'gettext_with_context', $translations, $text, $context, $domain ); return apply_filters( 'gettext_with_context', $translation, $text, $context, $domain );
} }
/** /**
@ -318,7 +318,7 @@ function esc_html_x( $text, $context, $domain = 'default' ) {
* *
* Example: * Example:
* *
* $people = sprintf( _n( '%s person', '%s people', $count, 'text-domain' ), number_format_i18n( $count ) ); * printf( _n( '%s person', '%s people', $count, 'text-domain' ), number_format_i18n( $count ) );
* *
* @since 2.8.0 * @since 2.8.0
* *
@ -331,7 +331,7 @@ function esc_html_x( $text, $context, $domain = 'default' ) {
*/ */
function _n( $single, $plural, $number, $domain = 'default' ) { function _n( $single, $plural, $number, $domain = 'default' ) {
$translations = get_translations_for_domain( $domain ); $translations = get_translations_for_domain( $domain );
$translation = $translations->translate_plural( $single, $plural, $number ); $translation = $translations->translate_plural( $single, $plural, $number );
/** /**
* Filters the singular or plural form of a string. * Filters the singular or plural form of a string.
@ -355,9 +355,10 @@ function _n( $single, $plural, $number, $domain = 'default' ) {
* Used when you want to use the appropriate form of a string with context based on whether a * Used when you want to use the appropriate form of a string with context based on whether a
* number is singular or plural. * number is singular or plural.
* *
* Example: * Example of a generic phrase which is disambiguated via the context parameter:
* *
* $people = sprintf( _n( '%s person', '%s people', $count, 'context', 'text-domain' ), number_format_i18n( $count ) ); * printf( _nx( '%s group', '%s groups', $people, 'group of people', 'text-domain' ), number_format_i18n( $people ) );
* printf( _nx( '%s group', '%s groups', $animals, 'group of animals', 'text-domain' ), number_format_i18n( $animals ) );
* *
* @since 2.8.0 * @since 2.8.0
* *
@ -371,7 +372,7 @@ function _n( $single, $plural, $number, $domain = 'default' ) {
*/ */
function _nx($single, $plural, $number, $context, $domain = 'default') { function _nx($single, $plural, $number, $context, $domain = 'default') {
$translations = get_translations_for_domain( $domain ); $translations = get_translations_for_domain( $domain );
$translation = $translations->translate_plural( $single, $plural, $number, $context ); $translation = $translations->translate_plural( $single, $plural, $number, $context );
/** /**
* Filters the singular or plural form of a string with gettext context. * Filters the singular or plural form of a string with gettext context.
@ -396,13 +397,9 @@ function _nx($single, $plural, $number, $context, $domain = 'default') {
* *
* Example: * Example:
* *
* $messages = array( * $message = _n_noop( '%s post', '%s posts', 'text-domain' );
* 'post' => _n_noop( '%s post', '%s posts', 'text-domain' ),
* 'page' => _n_noop( '%s pages', '%s pages', 'text-domain' ),
* );
* ... * ...
* $message = $messages[ $type ]; * printf( translate_nooped_plural( $message, $count, 'text-domain' ), number_format_i18n( $count ) );
* $usable_text = sprintf( translate_nooped_plural( $message, $count, 'text-domain' ), number_format_i18n( $count ) );
* *
* @since 2.5.0 * @since 2.5.0
* *
@ -431,15 +428,15 @@ function _n_noop( $singular, $plural, $domain = null ) {
* Used when you want to keep structures with translatable plural * Used when you want to keep structures with translatable plural
* strings and use them later when the number is known. * strings and use them later when the number is known.
* *
* Example: * Example of a generic phrase which is disambiguated via the context parameter:
* *
* $messages = array( * $messages = array(
* 'post' => _n_noop( '%s post', '%s posts', 'context', 'text-domain' ), * 'people' => _nx_noop( '%s group', '%s groups', 'people', 'text-domain' ),
* 'page' => _n_noop( '%s pages', '%s pages', 'context', 'text-domain' ), * 'animals' => _nx_noop( '%s group', '%s groups', 'animals', 'text-domain' ),
* ); * );
* ... * ...
* $message = $messages[ $type ]; * $message = $messages[ $type ];
* $usable_text = sprintf( translate_nooped_plural( $message, $count, 'text-domain' ), number_format_i18n( $count ) ); * printf( translate_nooped_plural( $message, $count, 'text-domain' ), number_format_i18n( $count ) );
* *
* @since 2.8.0 * @since 2.8.0
* *
@ -472,13 +469,9 @@ function _nx_noop( $singular, $plural, $context, $domain = null ) {
* *
* Example: * Example:
* *
* $messages = array( * $message = _n_noop( '%s post', '%s posts', 'text-domain' );
* 'post' => _n_noop( '%s post', '%s posts', 'text-domain' ),
* 'page' => _n_noop( '%s pages', '%s pages', 'text-domain' ),
* );
* ... * ...
* $message = $messages[ $type ]; * printf( translate_nooped_plural( $message, $count, 'text-domain' ), number_format_i18n( $count ) );
* $usable_text = sprintf( translate_nooped_plural( $message, $count, 'text-domain' ), number_format_i18n( $count ) );
* *
* @since 3.1.0 * @since 3.1.0
* *

2
wp-includes/version.php
View File

@ -4,7 +4,7 @@
* *
* @global string $wp_version * @global string $wp_version
*/ */
$wp_version = '4.7-alpha-38359'; $wp_version = '4.7-alpha-38360';
/** /**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema. * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.