Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Use straight apostrophes and quotation marks in handbook pages about punctuation #1848

Open
sabernhardt opened this issue Feb 23, 2025 · 2 comments
Labels
[Status] To do Issue marked as Todo

Comments

@sabernhardt
Copy link

At least two punctuation pages run through a content filter (wptexturize?) that automatically replaces straight quotes with curly quote entities. However, these pages specifically say to use the straight apostrophes and quotation marks.

The first paragraph of the Apostrophes page replaces with a left quote: same character as a single quotation mark (‘)

Apostrophes page with wrong character

On the Quotation marks page, the Straight and curly quotation marks section replaces with right and left double quotes: use straight quotation marks (” “).

Quotation marks page with wrong characters

Suggested Fix

The characters probably could be wrapped in code tags, and I think the element could be inline instead of inline-block (to avoid a line break before or after when text wraps to the next line):
<code style="display:inline;">"</code>

  • The Apostrophes page has multiple curly apostrophes, but I think correcting only the one would be sufficient.
    Apostrophes page with straight apostrophe
  • For the Quotation marks page, both paragraphs under "Straight and curly quotation marks" need straight quotes, and the Recommended example needs the correct characters too. It might also be worth wrapping the curly quotes in the first paragraph (but I did not do that for the screenshot below).
    Quotation marks page with straight quotes
@sabernhardt sabernhardt added the [Status] To do Issue marked as Todo label Feb 23, 2025
Copy link

Heads up @WordPress/docs-issues-coordinators, we have a new issue open. Time to use 'em labels.

@sabernhardt
Copy link
Author

When the characters are in parentheses, you alternatively could use inline-block for everything that needs to stay on the same line:

  • <span style="display:inline-block;">(<code>'</code>).</span>
  • <span style="display:inline-block;">(<code>" "</code>)</span>

However, <code style="display:inline;">"</code> seems better for the Recommended example (shown above). Wrapping the entire quoted text in an inline-block element would push all of it to the next line:

quoted text with inline-block

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
[Status] To do Issue marked as Todo
Projects
None yet
Development

No branches or pull requests

1 participant