From a45ca9cfae5329125f1f37d101aa3585bcafc83d Mon Sep 17 00:00:00 2001 From: Alex Cabal Date: Wed, 23 Dec 2020 10:12:06 -0600 Subject: [PATCH] Typogrify initialisms and acronyms --- www/contribute/how-tos/shakespeare.php | 4 ++-- www/contribute/producing-an-ebook-step-by-step.php | 12 ++++++------ www/css/core.css | 4 ++++ www/donate/index.php | 8 ++++---- 4 files changed, 16 insertions(+), 12 deletions(-) diff --git a/www/contribute/how-tos/shakespeare.php b/www/contribute/how-tos/shakespeare.php index 7649f2c2..8dfe830a 100644 --- a/www/contribute/how-tos/shakespeare.php +++ b/www/contribute/how-tos/shakespeare.php @@ -11,11 +11,11 @@ require_once('Core.php');

  1. Transcriptions

    -

    SE’s productions of William Shakespeare’s plays are based on Massachusetts Institute of Technology’s transcriptions produced by Jeremy Hylton.

    +

    S.E.’s productions of William Shakespeare’s plays are based on Massachusetts Institute of Technology’s transcriptions produced by Jeremy Hylton.

  2. Page Scans

    -

    When it comes to Shakespeare’s plays, there are infinite page scans available, but each edition can differ in stage directions, stage direction formatting, punctuation, spelling, personas, and even dialogue. For SE’s productions, William George Clark and William Aldis Wright’s 1887 Victoria Edition is used as the gold standard.

    +

    When it comes to Shakespeare’s plays, there are infinite page scans available, but each edition can differ in stage directions, stage direction formatting, punctuation, spelling, personas, and even dialogue. For S.E.’s productions, William George Clark and William Aldis Wright’s 1887 Victoria Edition is used as the gold standard.

diff --git a/www/contribute/producing-an-ebook-step-by-step.php b/www/contribute/producing-an-ebook-step-by-step.php index bf8f6c1e..4671c763 100644 --- a/www/contribute/producing-an-ebook-step-by-step.php +++ b/www/contribute/producing-an-ebook-step-by-step.php @@ -165,7 +165,7 @@ proceed to seal up my confession, I bring the life of that unhappy Henry Jekyll

Normalizes spacing in em-, en-, and double-em-dashes, as well as between nested quotation marks, and adds word joiners.

-

While se typogrify does a lot of work for you, each ebook is totally different so there’s almost always more work to do that can only be done by hand. In Jekyll, you’ll notice that the chapter titles are in all caps. The SE standard requires chapter titles to be in title case, and se titlecase can do that for us.

+

While se typogrify does a lot of work for you, each ebook is totally different so there’s almost always more work to do that can only be done by hand. In Jekyll, you’ll notice that the chapter titles are in all caps. The S.E. standard requires chapter titles to be in title case, and se titlecase can do that for us.

se titlecase accepts a string as its argument, and outputs the string in title case. Many text editors allow you to configure external macros—perfect for creating a keyboard shortcut to run se titlecase on selected text.

Typography checklist

There are many things that se typogrify isn’t well suited to do automatically. Check our complete typography manual to see exactly how to format the work. Below is a brief, but incomplete, list of common issues that arise in ebooks:

@@ -225,7 +225,7 @@ proceed to seal up my confession, I bring the life of that unhappy Henry Jekyll

  • Using the epub3 semantic inflection language to add deeper meaning to tags.

    -

    Currently we use a mix of epub3 structural semantics, z3998 structural semantics for when the epub3 vocabulary isn’t enough, and our own SE semantics for when z3998 isn’t enough.

    +

    Currently we use a mix of epub3 structural semantics, z3998 structural semantics for when the epub3 vocabulary isn’t enough, and our own S.E. semantics for when z3998 isn’t enough.

    • Use se semanticate to do some common cases for you:

    se semanticate . @@ -255,7 +255,7 @@ proceed to seal up my confession, I bring the life of that unhappy Henry Jekyll

    Words or phrases in foreign languages should always be marked up with <i xml:lang="TAG">, where TAG is an IETF language tag. This app can help you look them up. If the text uses fictional or unspecific languages, use the “x-” prefix and make up a subtag yourself.

  • -

    Semantics for poetry, verse, and song: Many Gutenberg productions use the <pre> tag to format poetry, verse, and song. This is, of course, semantically incorrect. See the Poetry section of the SEMOS for templates on how to semantically format poetry, verse, and song.

    +

    Semantics for poetry, verse, and song: Many Gutenberg productions use the <pre> tag to format poetry, verse, and song. This is, of course, semantically incorrect. See the Poetry section of the SEMOS for templates on how to semantically format poetry, verse, and song.

    • After you’ve added semantics according to the Standard Ebooks Manual of Style, do another commit.

    git add -A git commit -m "Semanticate" @@ -293,7 +293,7 @@ proceed to seal up my confession, I bring the life of that unhappy Henry Jekyll

    se find-mismatched-diacritics lists these instances for you to review. Spelling should be normalized across the work so that all instances of the same word are spelled in the same way. Keep the following in mind as you review these instances: