Changeset 45926 for trunk/src/wp-includes/comment-template.php

Timestamp:

09/01/2019 05:12:43 PM (5 years ago)

Author:

SergeyBiryukov

Message:

I18N: Improve translator comments.

• Add missing translator comments.
• Fix placement of some translator comments. Translator comments should be on the line directly above the line containing the translation function call for optimal compatibility with various .pot file generation tools. The CS auto-fixing, which changed some inconsistent function calls to multi-line function calls, is part of the reason why this was no longer the case for a select group of translator comments.

Includes minor code layout fixes.

Polyglots, rejoice! All WordPress core files now have translator comments for all strings with placeholders!

Props jrf, subrataemfluence, GaryJ, webdados, Dency, swissspidy, alvarogois, marcomartins, mihaiiceyro, vladwtz, niq1982, flipkeijzer, michielatyoast, chandrapatel, thrijith, joshuanoyce, FesoVik, tessak22, bhaktirajdev, cleancoded, dhavalkasvala, garrett-eclipse, bibliofille, socalchristina, priyankkpatel, 5hel2l2y, adamsilverstein, JeffPaul, pierlo, SergeyBiryukov.
Fixes #44360.

File:

• trunk/src/wp-includes/comment-template.php (modified) (6 diffs)

trunk/src/wp-includes/comment-template.php

@@ -1152 +1152 @@
             __FUNCTION__,
             '2.5.0',
-            /* translators: %s: get_trackback_url() */
             sprintf(
+                /* translators: %s: get_trackback_url() */
                 __( 'Use %s instead if you do not want the value echoed.' ),
                 '<code>get_trackback_url()</code>'
@@ -1935 +1935 @@
     }
     if ( false === $replytext ) {
+        /* translators: %s: author of the comment being replied to */
         $replytext = __( 'Leave a Reply to %s' );
     }
@@ -2293 +2294 @@
     }
 
-    $required_text = sprintf( ' ' . __( 'Required fields are marked %s' ), '<span class="required">*</span>' );
+    $required_text = sprintf(
+        /* translators: %s: an asterisk symbol (*) */
+        ' ' . __( 'Required fields are marked %s' ),
+        '<span class="required">*</span>'
+    );
 
     /**
@@ -2309 +2314 @@
         'must_log_in'          => '<p class="must-log-in">' . sprintf(
             /* translators: %s: login URL */
-                                    __( 'You must be <a href="%s">logged in</a> to post a comment.' ),
+            __( 'You must be <a href="%s">logged in</a> to post a comment.' ),
             wp_login_url( apply_filters( 'the_permalink', get_permalink( $post_id ), $post_id ) )
         ) . '</p>',
@@ -2315 +2320 @@
         'logged_in_as'         => '<p class="logged-in-as">' . sprintf(
             /* translators: 1: edit user link, 2: accessibility text, 3: user name, 4: logout URL */
-                                    __( '<a href="%1$s" aria-label="%2$s">Logged in as %3$s</a>. <a href="%4$s">Log out?</a>' ),
+            __( '<a href="%1$s" aria-label="%2$s">Logged in as %3$s</a>. <a href="%4$s">Log out?</a>' ),
             get_edit_user_link(),
             /* translators: %s: user name */
-                                    esc_attr( sprintf( __( 'Logged in as %s. Edit your profile.' ), $user_identity ) ),
+            esc_attr( sprintf( __( 'Logged in as %s. Edit your profile.' ), $user_identity ) ),
             $user_identity,
             wp_logout_url( apply_filters( 'the_permalink', get_permalink( $post_id ), $post_id ) )
@@ -2331 +2336 @@
         'name_submit'          => 'submit',
         'title_reply'          => __( 'Leave a Reply' ),
+        /* translators: %s: author of the comment being replied to */
         'title_reply_to'       => __( 'Leave a Reply to %s' ),
         'title_reply_before'   => '<h3 id="reply-title" class="comment-reply-title">',