standardebooks/web
1
0
Fork 0
mirror of https://github.com/standardebooks/web.git synced 2025-07-08 15:50:29 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

Tweak toc in step by step guide

Browse source
This commit is contained in:
Alex Cabal 2022-12-31 22:45:04 -06:00
parent ed40d7ef0c
commit 6b32df03ab
2 changed files with 32 additions and 38 deletions
Download patch file Download diff file Expand all files Collapse all files

60
www/contribute/producing-an-ebook-step-by-step.php
View file

@ -18,34 +18,36 @@ require_once('Core.php');
<p>If you commingle editorial changes with other changes in your commits, we’ll be forced to ask you to rebase your repository to tease them out. This is very difficult and you’ll get frustrated—so please make sure to keep editorial commits separate!</p> <p>If you commingle editorial changes with other changes in your commits, we’ll be forced to ask you to rebase your repository to tease them out. This is very difficult and you’ll get frustrated—so please make sure to keep editorial commits separate!</p>
<p>If your working directory contains a mix of changes and you only want to commit some of them, <code class="bash"><b>git</b> add --patch</code> is a <a href="http://git-scm.com/docs/git-add#Documentation/git-add.txt--p">useful way to only commit parts of a file</a>.</p> <p>If your working directory contains a mix of changes and you only want to commit some of them, <code class="bash"><b>git</b> add --patch</code> is a <a href="http://git-scm.com/docs/git-add#Documentation/git-add.txt--p">useful way to only commit parts of a file</a>.</p>
</aside> </aside>
<details id="step-toc"> <details id="toc">
<summary title="Click to toggle">Table of Contents</summary> <summary>Table of Contents</summary>
<p><a href="#setup">Set up the Standard Ebooks toolset and make sure it’s up-to-date</a></p> <ol>
<p><a href="#select">Select an ebook to produce</a></p> <li><p><a href="#setup">Set up the Standard Ebooks toolset and make sure it’s up-to-date</a></p></li>
<p><a href="#locate">Locate page scans of your book online</a></p> <li><p><a href="#select">Select an ebook to produce</a></p></li>
<p><a href="#create">Create a Standard Ebooks epub skeleton</a></p> <li><p><a href="#locate">Locate page scans of your book online</a></p></li>
<p><a href="#rough">Do a rough cleanup of the source text and perform the first commit</a></p> <li><p><a href="#create">Create a Standard Ebooks epub skeleton</a></p></li>
<p><a href="#split">Split the source text at logical divisions</a></p> <li><p><a href="#rough">Do a rough cleanup of the source text and perform the first commit</a></p></li>
<p><a href="#clean">Clean up the source text and perform the second commit</a></p> <li><p><a href="#split">Split the source text at logical divisions</a></p></li>
<p><a href="#typogrify">Typogrify the source text and perform the corresponding commit(s)</a></p> <li><p><a href="#clean">Clean up the source text and perform the second commit</a></p></li>
<p><a href="#transcription">Check for transcription errors</a></p> <li><p><a href="#typogrify">Typogrify the source text and perform the corresponding commit(s)</a></p></li>
<p><a href="#footnotes">Convert footnotes to endnotes</a></p> <li><p><a href="#transcription">Check for transcription errors</a></p></li>
<p><a href="#illustrations">Add a list of illustrations</a></p> <li><p><a href="#footnotes">Convert footnotes to endnotes</a></p></li>
<p><a href="#quotation">Converting British quotation to American quotation</a></p> <li><p><a href="#illustrations">Add a list of illustrations</a></p></li>
<p><a href="#semantics">Add semantics</a></p> <li><p><a href="#quotation">Converting British quotation to American quotation</a></p></li>
<p><a href="#modernize">Modernize spelling and hyphenation</a></p> <li><p><a href="#semantics">Add semantics</a></p></li>
<p><a href="#diacritics">Check for consistent diacritics</a></p> <li><p><a href="#modernize">Modernize spelling and hyphenation</a></p></li>
<p><a href="#dashes">Check for consistent dashes</a></p> <li><p><a href="#diacritics">Check for consistent diacritics</a></p></li>
<p><a href="#titles">Set <code class="html"><span class="p">&lt;</span><span class="nt">title</span><span class="p">&gt;</span></code> elements</a></p> <li><p><a href="#dashes">Check for consistent dashes</a></p></li>
<p><a href="#manispine">Build the manifest and spine</a></p> <li><p><a href="#titles">Set <code class="html"><span class="p">&lt;</span><span class="nt">title</span><span class="p">&gt;</span></code> elements</a></p></li>
<p><a href="#toc">Build the table of contents</a></p> <li><p><a href="#manispine">Build the manifest and spine</a></p></li>
<p><a href="#lint">Clean and lint</a></p> <li><p><a href="#built-toc">Build the table of contents</a></p></li>
<p><a href="#proofread">Build and proofread, proofread, proofread!</a></p> <li><p><a href="#lint">Clean and lint</a></p></li>
<p><a href="#cover">Create the cover image</a></p> <li><p><a href="#proofread">Build and proofread, proofread, proofread!</a></p></li>
<p><a href="#content">Complete content.opf</a></p> <li><p><a href="#cover">Create the cover image</a></p></li>
<p><a href="#colophon">Complete the imprint and colophon</a></p> <li><p><a href="#content">Complete content.opf</a></p></li>
<p><a href="#checks">Final checks</a></p> <li><p><a href="#colophon">Complete the imprint and colophon</a></p></li>
<p><a href="#publication">Initial publication</a></p> <li><p><a href="#checks">Final checks</a></p></li>
<li><p><a href="#publication">Initial publication</a></p></li>
</ol>
</details> </details>
<ol> <ol>
<li> <li>
@ -541,7 +543,7 @@ proceed to seal up my confession, I bring the life of that unhappy Henry Jekyll
<p>The manifest is already in the correct order and doesn’t need to be edited. The spine, however, will have to be reordered to be in the correct reading order. Once you’ve done that, commit!</p><code class="terminal"><span><b>git</b> commit -am <i>"Add manifest and spine"</i></span></code> <p>The manifest is already in the correct order and doesn’t need to be edited. The spine, however, will have to be reordered to be in the correct reading order. Once you’ve done that, commit!</p><code class="terminal"><span><b>git</b> commit -am <i>"Add manifest and spine"</i></span></code>
</li> </li>
<li> <li>
<h2 id="toc">Build the table of contents</h2> <h2 id="build-toc">Build the table of contents</h2>
<p>With the spine in the right order, we can now build the table of contents.</p> <p>With the spine in the right order, we can now build the table of contents.</p>
<p>The table of contents is a structured document that lets the reader easily navigate the book. In a Standard Ebook, it’s stored outside of the readable text directory with the assumption that the reading system will parse it and display a navigable representation for the user.</p> <p>The table of contents is a structured document that lets the reader easily navigate the book. In a Standard Ebook, it’s stored outside of the readable text directory with the assumption that the reading system will parse it and display a navigable representation for the user.</p>
<p>Use <code class="bash"><b>se</b> build-toc</code> to generate a table of contents for this ebook.</p> <p>Use <code class="bash"><b>se</b> build-toc</code> to generate a table of contents for this ebook.</p>

10
www/css/manual.css
View file

@ -329,7 +329,7 @@ code.full .utf{
} }
.step-by-step-guide details{ .step-by-step-guide details{
padding: 1.0em 0; padding: 1rem 0;
list-style-type: none; list-style-type: none;
counter-reset: toc 0; counter-reset: toc 0;
} }
@ -346,14 +346,6 @@ code.full .utf{
list-style-position: outside; list-style-position: outside;
} }
.step-by-step-guide details p {
counter-increment: toc 1;
}
.step-by-step-guide details p::before{
content: counter(toc) ". ";
}
.alert p.warning{ .alert p.warning{
font-size: 2rem; font-size: 2rem;
font-weight: bold; font-weight: bold;