| Author | DaveJarvis <email> |
|---|---|
| Date | 2024-10-09 17:24:15 GMT-0700 |
| Commit | 37580aabca8b01a9504dabb871a349bf238abbc5 |
| Parent | 1fae3e3 |
| See the source code for details. | ||
| +# Apostrophes | ||
| + | ||
| +In UNICODE, apostrophes have no semantic meaning. This unfortunate decision | ||
| +means that you have a choice in how straight apostrophes are converted to | ||
| +your typographic requirements. Using the `-a` option, you may provide one | ||
| +of the following values: | ||
| + | ||
| +* `regular` -- Keep the straight apostrophe (and curl using the font). | ||
| +* `modifier` -- Use UNICODE character 0x02BC. | ||
| +* `apos` -- Use `'`, which is not HTML4-compliant. | ||
| +* `aposhex` -- Use `'`, which works with HTML4. | ||
| +* `quote` -- Use `’`, which is semantically incorrect and will likely produce the desired typography. | ||
| +* `quotehex` -- Use `’`, which will likely produce the desired typography without embedding the semantically misleading "name" of "right single quote". | ||
| + | ||
| # Build | ||
| @CommandLine.Option( | ||
| names = {"-a", "--apostrophe"}, | ||
| - description = "Converted apostrophe entity (regular, modifier, hex, entity)" | ||
| + description = "Converted apostrophe entity (see docs)" | ||
| ) | ||
| private String mApostrophe; |
| CONVERT_MODIFIER( "ʼ", "modifier" ), | ||
| /** | ||
| + * Apostrophes become XML APOSTROPHE ({@code '}). | ||
| + */ | ||
| + CONVERT_APOS( "'", "apos" ), | ||
| + /** | ||
| * Apostrophes become APOSTROPHE ({@code '}). | ||
| */ | ||
| - CONVERT_APOS_HEX( "'", "hex" ), | ||
| + CONVERT_APOS_HEX( "'", "aposhex" ), | ||
| /** | ||
| - * Apostrophes become XML APOSTROPHE ({@code '}). | ||
| + * Apostrophes become RIGHT SINGLE QUOTATION MARK ({@code ’}). | ||
| */ | ||
| - CONVERT_APOS_ENTITY( "'", "entity" ); | ||
| + CONVERT_RSQUOTE( "’", "quote" ), | ||
| + /** | ||
| + * Apostrophes become RIGHT SINGLE QUOTATION MARK in hex ({@code ’}). | ||
| + */ | ||
| + CONVERT_RSQUOTE_HEX( "’", "quotehex" ); | ||
| private final String mCode; |
| Delta | 26 lines added, 4 lines removed, 22-line increase |
|---|