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

Update manual for epub 3.2

Browse source
This commit is contained in:
Alex Cabal 2019-05-16 15:09:30 -05:00
parent 80e1ecc0d0
commit 732a5888f0
2 changed files with 11 additions and 12 deletions
Download patch file Download diff file Expand all files Collapse all files

5
www/contribute/metadata.php
View file

@ -97,11 +97,10 @@ require_once('Core.php');
<p>Arrange the <code class="html">&lt;dc:subject&gt;</code> elements sequentially in a block.</p> <p>Arrange the <code class="html">&lt;dc:subject&gt;</code> elements sequentially in a block.</p>
</li> </li>
<li> <li>
<p>After the block of <code class="html">&lt;dc:subject&gt;</code> elements, include a block of <code class="html">&lt;meta property="meta-auth"&gt;</code> elements with values representing the URL at which you found the categorizations for each individual subject.</p> <p>After the block of <code class="html">&lt;dc:subject&gt;</code> elements, include a block of <code class="html">&lt;meta property="authority"&gt;</code> and <code class="html">&lt;meta property="term"&gt;</code> elements with values representing the source and particular ID of the subject. <code class="html">authority</code> is almost always <code class="html">LCSH</code> (Library of Congress Subject Heading).</p>
<p>For example, if we found the Library of Congress categories for an ebook at the Project Gutenberg ebook’s “bibrec” tab, then you would use the URL of the Project Gutenberg ebook.</p>
</li> </li>
<li> <li>
<p>The <code class="html">&lt;meta property="meta-auth"&gt;</code> element must refine each individual <code class="html">&lt;dc:subject&gt;</code> element, even if the URL is the same for all of them.</p> <p>The <code class="html">&lt;meta property="authority"&gt;</code> element must refine each individual <code class="html">&lt;dc:subject&gt;</code> element.</p>
</li> </li>
</ul> </ul>
<p>This example shows how to mark up the subjects for <i><a href="/ebooks/david-lindsay/a-voyage-to-arcturus">A Voyage to Arcturus</a></i>:</p><code class="html full">&lt;dc:subject id="subject-1"&gt;Science fiction&lt;/dc:subject&gt; &lt;dc:subject id="subject-2"&gt;Psychological fiction&lt;/dc:subject&gt; &lt;dc:subject id="subject-3"&gt;Quests (Expeditions) -- Fiction&lt;/dc:subject&gt; &lt;dc:subject id="subject-4"&gt;Life on other planets -- Fiction&lt;/dc:subject&gt; &lt;meta property="meta-auth" refines="#subject-1"&gt;https://www.gutenberg.org/ebooks/1329&lt;/meta&gt; &lt;meta property="meta-auth" refines="#subject-2"&gt;https://www.gutenberg.org/ebooks/1329&lt;/meta&gt; &lt;meta property="meta-auth" refines="#subject-3"&gt;https://www.gutenberg.org/ebooks/1329&lt;/meta&gt; &lt;meta property="meta-auth" refines="#subject-4"&gt;https://www.gutenberg.org/ebooks/1329&lt;/meta&gt;</code> <p>This example shows how to mark up the subjects for <i><a href="/ebooks/david-lindsay/a-voyage-to-arcturus">A Voyage to Arcturus</a></i>:</p><code class="html full">&lt;dc:subject id="subject-1"&gt;Science fiction&lt;/dc:subject&gt; &lt;dc:subject id="subject-2"&gt;Psychological fiction&lt;/dc:subject&gt; &lt;dc:subject id="subject-3"&gt;Quests (Expeditions) -- Fiction&lt;/dc:subject&gt; &lt;dc:subject id="subject-4"&gt;Life on other planets -- Fiction&lt;/dc:subject&gt; &lt;meta property="meta-auth" refines="#subject-1"&gt;https://www.gutenberg.org/ebooks/1329&lt;/meta&gt; &lt;meta property="meta-auth" refines="#subject-2"&gt;https://www.gutenberg.org/ebooks/1329&lt;/meta&gt; &lt;meta property="meta-auth" refines="#subject-3"&gt;https://www.gutenberg.org/ebooks/1329&lt;/meta&gt; &lt;meta property="meta-auth" refines="#subject-4"&gt;https://www.gutenberg.org/ebooks/1329&lt;/meta&gt;</code>

18
www/contribute/semantics.php
View file

@ -303,15 +303,15 @@ font-weight: normal;
&lt;link href="../css/local.css" rel="stylesheet" type="text/css"/&gt; &lt;link href="../css/local.css" rel="stylesheet" type="text/css"/&gt;
&lt;/head&gt; &lt;/head&gt;
&lt;body epub:type="backmatter z3998:fiction"&gt; &lt;body epub:type="backmatter z3998:fiction"&gt;
&lt;section id="endnotes" epub:type="rearnotes"&gt; &lt;section id="endnotes" epub:type="endnotes"&gt;
&lt;h2 epub:type="title"&gt;Endnotes&lt;/h2&gt; &lt;h2 epub:type="title"&gt;Endnotes&lt;/h2&gt;
&lt;ol&gt; &lt;ol&gt;
&lt;li id="note-1" epub:type="rearnote"&gt; &lt;li id="note-1" epub:type="endnote"&gt;
&lt;p&gt;The first endnote goes here.&lt;/p&gt; &lt;p&gt;The first endnote goes here.&lt;/p&gt;
&lt;p&gt;Here's another line for the first endnote. &lt;a href="chapter-1.xhtml#noteref-1" epub:type="se:referrer"&gt;↩&lt;/a&gt;&lt;/p&gt; &lt;p&gt;Here's another line for the first endnote. &lt;a href="chapter-1.xhtml#noteref-1" epub:type="backlink"&gt;↩&lt;/a&gt;&lt;/p&gt;
&lt;/li&gt; &lt;/li&gt;
&lt;li id="note-2" epub:type="rearnote"&gt; &lt;li id="note-2" epub:type="endnote"&gt;
&lt;p&gt;The second endnote goes here. &lt;a href="chapter-1.xhtml#noteref-2" epub:type="se:referrer"&gt;↩&lt;/a&gt;&lt;/p&gt; &lt;p&gt;The second endnote goes here. &lt;a href="chapter-1.xhtml#noteref-2" epub:type="backlink"&gt;↩&lt;/a&gt;&lt;/p&gt;
&lt;/li&gt; &lt;/li&gt;
&lt;/ol&gt; &lt;/ol&gt;
&lt;/section&gt; &lt;/section&gt;
@ -323,18 +323,18 @@ font-weight: normal;
<li><p>Each <code class="html">&lt;li&gt;</code> requires the following attributes:</p> <li><p>Each <code class="html">&lt;li&gt;</code> requires the following attributes:</p>
<ul> <ul>
<li><p><code class="html">id</code> is set to the string “note-” followed by the sequential endnote number, beginning with 1.</p></li> <li><p><code class="html">id</code> is set to the string “note-” followed by the sequential endnote number, beginning with 1.</p></li>
<li><p><code class="html">epub:type</code> is set to “rearnote”.</p></li> <li><p><code class="html">epub:type</code> is set to “endnote”.</p></li>
</ul> </ul>
<li><p>The <code class="html">href</code> attribute points to the direct anchor reference to the endnote. </p></li> <li><p>The <code class="html">href</code> attribute points to the direct anchor reference to the endnote. </p></li>
<li><p>If an endnote contains a citation offset with a dash (for example, “&mdash;Ed.”), separate the citation from the text with a single space and enclose it in the <code class="html">&lt;cite&gt;</code> tag:</p> <li><p>If an endnote contains a citation offset with a dash (for example, “&mdash;Ed.”), separate the citation from the text with a single space and enclose it in the <code class="html">&lt;cite&gt;</code> tag:</p>
<code class="html full">&lt;li id="note-1" epub:type="rearnote"&gt; <code class="html full">&lt;li id="note-1" epub:type="endnote"&gt;
&lt;p&gt;Here’s an endnote. &lt;cite&gt;&mdash;&lt;abbr class="eoc"&gt;Ed.&lt;/abbr&gt;&lt;/cite&gt; &lt;a href="chapter-1.xhtml#note-1" epub:type="se:referrer"&gt;↩&lt;/a&gt;&lt;/p&gt; &lt;p&gt;Here’s an endnote. &lt;cite&gt;&mdash;&lt;abbr class="eoc"&gt;Ed.&lt;/abbr&gt;&lt;/cite&gt; &lt;a href="chapter-1.xhtml#note-1" epub:type="backlink"&gt;↩&lt;/a&gt;&lt;/p&gt;
&lt;/li&gt;</code> &lt;/li&gt;</code>
</li> </li>
<li><p>The final <code class="html">&lt;p&gt;</code> element in an endnote contains a link back to the referring anchor. Don’t just point it to the file, make sure it points to the exact link that we came from. For example, <code class="path">chapter-1.xhtml#note-1</code>, <em>not</em> <code class="path">chapter-1.xhtml</code>. If the link is the last element in a longer <code class="html">&lt;p&gt;</code> tag, it must be preceded by one space character; if it is the only child of a <code class="html">&lt;p&gt;</code> tag (for example if the previous text was a <code class="html">&lt;blockquote&gt;</code>) then it can be on its own line. It must have the <code class="html">epub:type</code> set to <code class="html">se:referrer</code>. The text of the link is always the “↩” character.</p></li> <li><p>The final <code class="html">&lt;p&gt;</code> element in an endnote contains a link back to the referring anchor. Don’t just point it to the file, make sure it points to the exact link that we came from. For example, <code class="path">chapter-1.xhtml#note-1</code>, <em>not</em> <code class="path">chapter-1.xhtml</code>. If the link is the last element in a longer <code class="html">&lt;p&gt;</code> tag, it must be preceded by one space character; if it is the only child of a <code class="html">&lt;p&gt;</code> tag (for example if the previous text was a <code class="html">&lt;blockquote&gt;</code>) then it can be on its own line. It must have the <code class="html">epub:type</code> set to <code class="html">backlink</code>. The text of the link is always the “↩” character.</p></li>
</ul> </ul>
</section> </section>
<section id="thought-and-section-breaks"> <section id="thought-and-section-breaks">