diff --git a/www/contribute/producing-an-ebook-step-by-step.php b/www/contribute/producing-an-ebook-step-by-step.php index be7c86e5..4a1d17b4 100644 --- a/www/contribute/producing-an-ebook-step-by-step.php +++ b/www/contribute/producing-an-ebook-step-by-step.php @@ -554,8 +554,8 @@ proceed to seal up my confession, I bring the life of that unhappy Henry Jekyll
Before you build the ebook for proofreading, it’s a good idea to check the ebook for some common problems you might have run in to during production.
-First, run se clean
one more time to both clean up the source files, and to alert you if there are XHTML parsing errors. Even though we ran se clean
before, it’s likely that in the course of production the ebook got in to less-than-perfect markup formatting. Remember you can run se clean
as many times as you want—it should always produce the same output.
Before you build the ebook for proofreading, it’s a good idea to check the ebook for some common problems you might have run into during production.
+First, run se clean
one more time to both clean up the source files, and to alert you if there are XHTML parsing errors. Even though we ran se clean
before, it’s likely that in the course of production the ebook got into less-than-perfect markup formatting. Remember you can run se clean
as many times as you want—it should always produce the same output.
se clean .
Now, run se lint
. If your ebook has any problems, you’ll see some output listing them. We’re expecting some errors, because we haven’t added a cover or completed the colophon or metadata. You can ignore those errors for now, because we’ll fix them in a later step. But, you do want to correct any fixable errors related to your previous work.
se lint .
@@ -598,7 +598,7 @@ proceed to seal up my confession, I bring the life of that unhappy Henry Jekyll
There are some things that you don’t have to worry much about when proofreading:
Spelling errors. Actual spelling errors are very rare. If a word appears to be misspelled, it’s worth it to check the page scans, but such cases are often done on purpose by the author, or using a older spelling, or are spelled differently in en-US vs. en-GB.
Spelling errors. Actual spelling errors are very rare. If a word appears to be misspelled, it’s worth it to check the page scans, but such cases are often done on purpose by the author, or using an older spelling, or are spelled differently in en-US vs. en-GB.
Changing from en-GB to en-US or vice versa. Spelling differences between the continents were not yet settled then, so it’s common for books to be set in a blend of spellings. We don’t convert from one style to the other, or try to ensure perfect consistency between styles. This includes en-GB differences like using “an” in front of a word starting in “h,” like “an hundred.”
Keeping a 100% faithful representation of a print page layout. Sometimes books have complicated page layouts in print. But ebooks are not the same as print books, with the most important distinction being that there is no “page” to align items to. So, we’re not so concerned with maintaining a pixel-perfect reproduction of print layouts; rather, we wish to adapt print layouts as best we can to the ebook medium.
It’s a good idea to run se typogrify
and se clean
one more time before running these final checks. Make sure to review the changes with git difftool
before accepting them—se typogrify
is usually right, but not always!
Now that our ebook is complete, let’s verify that there are no errors at the S.E. style level:
se lint .
- Once se lint
completes without errors, we’re ready to confirm that there are no errors at the epub level. We do this by invoking se build
with the --check-only
flag, which will run epubcheck
to verify that our final epub has no errors, but won’t output an ebook files, since we don’t need them right now.
Once se lint
completes without errors, we’re ready to confirm that there are no errors at the epub level. We do this by invoking se build
with the --check-only
flag, which will run epubcheck
to verify that our final epub has no errors, but won’t output ebook files, since we don’t need them right now.
se build --check-only .
Once that completes without errors, we’re ready to move on to the final step!