Accessibility: Audit usage of abbreviations.

Title attributes on abbreviations are only available to a minority of users. The
best option is to avoid unnecessary abbreviations when possible. In the other cases,
use an `<abbr>` element (which provides a hint to user agents on how to announce
and display the abbreviation) and provide an expansion in plain text on first use.

- `readme.html`: improves abbreviations and removes unnecessary `title` attributes
- options-general: removes unnecessary abbreviations and improves the remaining ones
- customizer schedule changeset date: removes unnecessary abbreviations and improves the remaining ones
- posts table date: uses a `span` element instead of an `abbr` element because this is not an abbreviation

Fixes #46980.

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


git-svn-id: http://core.svn.wordpress.org/trunk@45741 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Andrea Fercia 2019-09-02 21:44:58 +00:00
parent 4089fad5fb
commit fbc9dba70b
21 changed files with 54 additions and 52 deletions

View File

@ -26,7 +26,7 @@
<li>Open <span class="file"><a href="wp-admin/install.php">wp-admin/install.php</a></span> in your browser.</li> <li>Open <span class="file"><a href="wp-admin/install.php">wp-admin/install.php</a></span> in your browser.</li>
</ol> </ol>
</li> </li>
<li>Once the configuration file is set up, the installer will set up the tables needed for your site. If there is an error, double check your <code>wp-config.php</code> file, and try again. If it fails again, please go to the <a href="https://wordpress.org/support/forums/" title="WordPress support">support forums</a> with as much data as you can gather.</li> <li>Once the configuration file is set up, the installer will set up the tables needed for your site. If there is an error, double check your <code>wp-config.php</code> file, and try again. If it fails again, please go to the <a href="https://wordpress.org/support/forums/">WordPress support forums</a> with as much data as you can gather.</li>
<li><strong>If you did not enter a password, note the password given to you.</strong> If you did not provide a username, it will be <code>admin</code>.</li> <li><strong>If you did not enter a password, note the password given to you.</strong> If you did not provide a username, it will be <code>admin</code>.</li>
<li>The installer should then send you to the <a href="wp-login.php">login page</a>. Sign in with the username and password you chose during the installation. If a password was generated for you, you can then click on &#8220;Profile&#8221; to change the password.</li> <li>The installer should then send you to the <a href="wp-login.php">login page</a>. Sign in with the username and password you chose during the installation. If a password was generated for you, you can then click on &#8220;Profile&#8221; to change the password.</li>
</ol> </ol>
@ -48,7 +48,7 @@
</ol> </ol>
<h2>Migrating from other systems</h2> <h2>Migrating from other systems</h2>
<p>WordPress can <a href="https://wordpress.org/support/article/importing-content/">import from a number of systems</a>. First you need to get WordPress installed and working as described above, before using <a href="wp-admin/import.php" title="Import to WordPress">our import tools</a>.</p> <p>WordPress can <a href="https://wordpress.org/support/article/importing-content/">import from a number of systems</a>. First you need to get WordPress installed and working as described above, before using <a href="wp-admin/import.php">our import tools</a>.</p>
<h2>System Requirements</h2> <h2>System Requirements</h2>
<ul> <ul>
@ -76,23 +76,23 @@
<dd>The WordPress Planet is a news aggregator that brings together posts from WordPress blogs around the web.</dd> <dd>The WordPress Planet is a news aggregator that brings together posts from WordPress blogs around the web.</dd>
<dt><a href="https://wordpress.org/support/forums/">WordPress Support Forums</a></dt> <dt><a href="https://wordpress.org/support/forums/">WordPress Support Forums</a></dt>
<dd>If you&#8217;ve looked everywhere and still can&#8217;t find an answer, the support forums are very active and have a large community ready to help. To help them help you be sure to use a descriptive thread title and describe your question in as much detail as possible.</dd> <dd>If you&#8217;ve looked everywhere and still can&#8217;t find an answer, the support forums are very active and have a large community ready to help. To help them help you be sure to use a descriptive thread title and describe your question in as much detail as possible.</dd>
<dt><a href="https://codex.wordpress.org/IRC">WordPress <abbr title="Internet Relay Chat">IRC</abbr> Channel</a></dt> <dt><a href="https://codex.wordpress.org/IRC">WordPress <abbr>IRC</abbr> (Internet Relay Chat) Channel</a></dt>
<dd>There is an online chat channel that is used for discussion among people who use WordPress and occasionally support topics. The above wiki page should point you in the right direction. (<a href="irc://irc.freenode.net/wordpress">irc.freenode.net #wordpress</a>)</dd> <dd>There is an online chat channel that is used for discussion among people who use WordPress and occasionally support topics. The above wiki page should point you in the right direction. (<a href="irc://irc.freenode.net/wordpress">irc.freenode.net #wordpress</a>)</dd>
</dl> </dl>
<h2>Final Notes</h2> <h2>Final Notes</h2>
<ul> <ul>
<li>If you have any suggestions, ideas, or comments, or if you (gasp!) found a bug, join us in the <a href="https://wordpress.org/support/forums/">Support Forums</a>.</li> <li>If you have any suggestions, ideas, or comments, or if you (gasp!) found a bug, join us in the <a href="https://wordpress.org/support/forums/">Support Forums</a>.</li>
<li>WordPress has a robust plugin <abbr title="application programming interface">API</abbr> that makes extending the code easy. If you are a developer interested in utilizing this, see the <a href="https://developer.wordpress.org/plugins/">Plugin Developer Handbook</a>. You shouldn&#8217;t modify any of the core code.</li> <li>WordPress has a robust plugin <abbr>API</abbr> (Application Programming Interface) that makes extending the code easy. If you are a developer interested in utilizing this, see the <a href="https://developer.wordpress.org/plugins/">Plugin Developer Handbook</a>. You shouldn&#8217;t modify any of the core code.</li>
</ul> </ul>
<h2>Share the Love</h2> <h2>Share the Love</h2>
<p>WordPress has no multi-million dollar marketing campaign or celebrity sponsors, but we do have something even better&#8212;you. If you enjoy WordPress please consider telling a friend, setting it up for someone less knowledgable than yourself, or writing the author of a media article that overlooks us.</p> <p>WordPress has no multi-million dollar marketing campaign or celebrity sponsors, but we do have something even better&#8212;you. If you enjoy WordPress please consider telling a friend, setting it up for someone less knowledgable than yourself, or writing the author of a media article that overlooks us.</p>
<p>WordPress is the official continuation of <a href="http://cafelog.com/">b2/caf&#233;log</a>, which came from Michel V. The work has been continued by the <a href="https://wordpress.org/about/">WordPress developers</a>. If you would like to support WordPress, please consider <a href="https://wordpress.org/donate/" title="Donate to WordPress">donating</a>.</p> <p>WordPress is the official continuation of <a href="http://cafelog.com/">b2/caf&#233;log</a>, which came from Michel V. The work has been continued by the <a href="https://wordpress.org/about/">WordPress developers</a>. If you would like to support WordPress, please consider <a href="https://wordpress.org/donate/">donating</a>.</p>
<h2>License</h2> <h2>License</h2>
<p>WordPress is free software, and is released under the terms of the <abbr title="GNU General Public License">GPL</abbr> version 2 or (at your option) any later version. See <a href="license.txt">license.txt</a>.</p> <p>WordPress is free software, and is released under the terms of the <abbr>GPL</abbr> (GNU General Public License) version 2 or (at your option) any later version. See <a href="license.txt">license.txt</a>.</p>
</body> </body>
</html> </html>

View File

@ -3090,7 +3090,6 @@ img {
font-size: 13px; font-size: 13px;
background: #f9f9f9; background: #f9f9f9;
-moz-tab-size: 4; -moz-tab-size: 4;
-o-tab-size: 4;
tab-size: 4; tab-size: 4;
} }

File diff suppressed because one or more lines are too long

View File

@ -3090,7 +3090,6 @@ img {
font-size: 13px; font-size: 13px;
background: #f9f9f9; background: #f9f9f9;
-moz-tab-size: 4; -moz-tab-size: 4;
-o-tab-size: 4;
tab-size: 4; tab-size: 4;
} }

File diff suppressed because one or more lines are too long

View File

@ -359,11 +359,6 @@ body.trashing #publish-settings {
margin-top: 12px; margin-top: 12px;
} }
.date-time-fields .date-timezone {
line-height: 2.2;
text-decoration: none;
}
#customize-control-changeset_preview_link { #customize-control-changeset_preview_link {
margin-top: 6px; margin-top: 6px;
} }
@ -1589,7 +1584,6 @@ p.customize-section-description {
font-size: 12px; font-size: 12px;
padding: 6px 8px; padding: 6px 8px;
-moz-tab-size: 2; -moz-tab-size: 2;
-o-tab-size: 2;
tab-size: 2; tab-size: 2;
} }
.customize-control-code_editor textarea, .customize-control-code_editor textarea,
@ -2784,10 +2778,6 @@ body.adding-widget .add-new-widget:before,
width: 80px; width: 80px;
} }
.date-time-fields .date-timezone {
line-height: 3.2;
}
#customize-control-changeset_preview_link a { #customize-control-changeset_preview_link a {
bottom: 16px; bottom: 16px;
} }

File diff suppressed because one or more lines are too long

View File

@ -359,11 +359,6 @@ body.trashing #publish-settings {
margin-top: 12px; margin-top: 12px;
} }
.date-time-fields .date-timezone {
line-height: 2.2;
text-decoration: none;
}
#customize-control-changeset_preview_link { #customize-control-changeset_preview_link {
margin-top: 6px; margin-top: 6px;
} }
@ -1589,7 +1584,6 @@ p.customize-section-description {
font-size: 12px; font-size: 12px;
padding: 6px 8px; padding: 6px 8px;
-moz-tab-size: 2; -moz-tab-size: 2;
-o-tab-size: 2;
tab-size: 2; tab-size: 2;
} }
.customize-control-code_editor textarea, .customize-control-code_editor textarea,
@ -2784,10 +2778,6 @@ body.adding-widget .add-new-widget:before,
width: 80px; width: 80px;
} }
.date-time-fields .date-timezone {
line-height: 3.2;
}
#customize-control-changeset_preview_link a { #customize-control-changeset_preview_link a {
bottom: 16px; bottom: 16px;
} }

File diff suppressed because one or more lines are too long

View File

@ -310,6 +310,11 @@ table.fixed {
width: 10%; width: 10%;
} }
.column-date span[title] {
-webkit-text-decoration: dotted underline;
text-decoration: dotted underline;
}
.fixed .column-posts { .fixed .column-posts {
width: 74px; width: 74px;
} }

File diff suppressed because one or more lines are too long

View File

@ -310,6 +310,11 @@ table.fixed {
width: 10%; width: 10%;
} }
.column-date span[title] {
-webkit-text-decoration: dotted underline;
text-decoration: dotted underline;
}
.fixed .column-posts { .fixed .column-posts {
width: 74px; width: 74px;
} }

File diff suppressed because one or more lines are too long

View File

@ -1127,7 +1127,7 @@ class WP_Posts_List_Table extends WP_List_Table {
} else { } else {
/** This filter is documented in wp-admin/includes/class-wp-posts-list-table.php */ /** This filter is documented in wp-admin/includes/class-wp-posts-list-table.php */
echo '<abbr title="' . $t_time . '">' . apply_filters( 'post_date_column_time', $h_time, $post, 'date', $mode ) . '</abbr>'; echo '<span title="' . $t_time . '">' . apply_filters( 'post_date_column_time', $h_time, $post, 'date', $mode ) . '</span>';
} }
} }

View File

@ -228,15 +228,22 @@ if ( empty( $tzstring ) ) { // Create a UTC+- zone if no timezone string exists
<?php echo wp_timezone_choice( $tzstring, get_user_locale() ); ?> <?php echo wp_timezone_choice( $tzstring, get_user_locale() ); ?>
</select> </select>
<p class="description" id="timezone-description"><?php _e( 'Choose either a city in the same timezone as you or a UTC timezone offset.' ); ?></p> <p class="description" id="timezone-description">
<?php
printf(
/* translators: %s: UTC abbreviation */
__( 'Choose either a city in the same timezone as you or a %s (Coordinated Universal Time) time offset.' ),
'<abbr>UTC</abbr>'
);
?>
</p>
<p class="timezone-info"> <p class="timezone-info">
<span id="utc-time"> <span id="utc-time">
<?php <?php
printf( printf(
/* translators: 1: UTC abbreviation, 2: UTC time */ /* translators: 1: UTC time */
__( 'Universal time (%1$s) is %2$s.' ), __( 'Universal time is %1$s.' ),
'<abbr>' . __( 'UTC' ) . '</abbr>',
'<code>' . date_i18n( $timezone_format, false, true ) . '</code>' '<code>' . date_i18n( $timezone_format, false, true ) . '</code>'
); );
?> ?>

View File

@ -1065,7 +1065,6 @@ html:lang(he-il) .rtl #wpadminbar * {
to 100% viewport width at responsive sizes. */ to 100% viewport width at responsive sizes. */
#wpadminbar .ab-top-menu > .menupop > .ab-sub-wrapper { #wpadminbar .ab-top-menu > .menupop > .ab-sub-wrapper {
min-width: -webkit-fit-content; min-width: -webkit-fit-content;
min-width: -moz-fit-content;
min-width: fit-content; min-width: fit-content;
} }

File diff suppressed because one or more lines are too long

View File

@ -1065,7 +1065,6 @@ html:lang(he-il) .rtl #wpadminbar * {
to 100% viewport width at responsive sizes. */ to 100% viewport width at responsive sizes. */
#wpadminbar .ab-top-menu > .menupop > .ab-sub-wrapper { #wpadminbar .ab-top-menu > .menupop > .ab-sub-wrapper {
min-width: -webkit-fit-content; min-width: -webkit-fit-content;
min-width: -moz-fit-content;
min-width: fit-content; min-width: fit-content;
} }

File diff suppressed because one or more lines are too long

View File

@ -173,7 +173,7 @@ class WP_Customize_Date_Time_Control extends WP_Customize_Control {
<option value="pm"><?php esc_html_e( 'PM' ); ?></option> <option value="pm"><?php esc_html_e( 'PM' ); ?></option>
</select> </select>
<# } #> <# } #>
<abbr class="date-timezone" aria-label="<?php esc_attr_e( 'Timezone' ); ?>" title="<?php echo esc_attr( $timezone_info['description'] ); ?>"><?php echo esc_html( $timezone_info['abbr'] ); ?></abbr> <p><?php echo $timezone_info['description']; ?></p>
</div> </div>
</fieldset> </fieldset>
<# } #> <# } #>
@ -228,21 +228,30 @@ class WP_Customize_Date_Time_Control extends WP_Customize_Control {
if ( $tz ) { if ( $tz ) {
$now = new DateTime( 'now', $tz ); $now = new DateTime( 'now', $tz );
$formatted_gmt_offset = sprintf( 'UTC%s', $this->format_gmt_offset( $tz->getOffset( $now ) / 3600 ) ); $formatted_gmt_offset = $this->format_gmt_offset( $tz->getOffset( $now ) / 3600 );
$tz_name = str_replace( '_', ' ', $tz->getName() ); $tz_name = str_replace( '_', ' ', $tz->getName() );
$timezone_info['abbr'] = $now->format( 'T' ); $timezone_info['abbr'] = $now->format( 'T' );
/* translators: 1: timezone name, 2: timezone abbreviation, 3: gmt offset */ $timezone_info['description'] = sprintf(
$timezone_info['description'] = sprintf( __( 'Timezone is %1$s (%2$s), currently %3$s.' ), $tz_name, $timezone_info['abbr'], $formatted_gmt_offset ); /* translators: 1: timezone name, 2: timezone abbreviation, 3: UTC abbreviation and offset, 4: UTC offset */
__( 'Your timezone is set to %1$s (%2$s), currently %3$s (Coordinated Universal Time %4$s).' ),
$tz_name,
'<abbr>' . $timezone_info['abbr'] . '</abbr>',
'<abbr>UTC</abbr>' . $formatted_gmt_offset,
$formatted_gmt_offset
);
} else { } else {
$timezone_info['description'] = ''; $timezone_info['description'] = '';
} }
} else { } else {
$formatted_gmt_offset = $this->format_gmt_offset( intval( get_option( 'gmt_offset', 0 ) ) ); $formatted_gmt_offset = $this->format_gmt_offset( intval( get_option( 'gmt_offset', 0 ) ) );
$timezone_info['abbr'] = sprintf( 'UTC%s', $formatted_gmt_offset );
/* translators: %s: UTC offset */ $timezone_info['description'] = sprintf(
$timezone_info['description'] = sprintf( __( 'Timezone is %s.' ), $timezone_info['abbr'] ); /* translators: 1: UTC abbreviation and offset, 2: UTC offset */
__( 'Your timezone is set to %1$s (Coordinated Universal Time %2$s).' ),
'<abbr>UTC</abbr>' . $formatted_gmt_offset,
$formatted_gmt_offset
);
} }
return $timezone_info; return $timezone_info;

View File

@ -13,7 +13,7 @@
* *
* @global string $wp_version * @global string $wp_version
*/ */
$wp_version = '5.3-alpha-45929'; $wp_version = '5.3-alpha-45930';
/** /**
* 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.