diff options
Diffstat (limited to 'Master/texmf-dist/doc/lualatex/novel/noveldocs-09-chapters-displays.html')
-rw-r--r-- | Master/texmf-dist/doc/lualatex/novel/noveldocs-09-chapters-displays.html | 472 |
1 files changed, 238 insertions, 234 deletions
diff --git a/Master/texmf-dist/doc/lualatex/novel/noveldocs-09-chapters-displays.html b/Master/texmf-dist/doc/lualatex/novel/noveldocs-09-chapters-displays.html index 96cb3aa35ea..a5ff7f9ceb0 100644 --- a/Master/texmf-dist/doc/lualatex/novel/noveldocs-09-chapters-displays.html +++ b/Master/texmf-dist/doc/lualatex/novel/noveldocs-09-chapters-displays.html @@ -1,9 +1,9 @@ <!DOCTYPE html> <html lang="en"> <head> -<meta http-equiv="content-type" content="text/html; charset=UTF-8"/> +<meta http-equiv="content-type" content="text/html; charset=UTF-8"> <title>Novel class documentation - Display, Start, Continued Pages, Footnotes, Endnotes</title> -<link rel="stylesheet" type="text/css" href="html-resources/novel-doc.css"/> +<link rel="stylesheet" type="text/css" href="html-resources/novel-doc.css"> </head> <body> @@ -14,12 +14,12 @@ <p>Document class "novel"</p> -<p><a href="#a9">Display, Start, and Continued Pages;<br/> +<p><a href="#a9">Display, Start, and Continued Pages;<br> Footnotes and Endnotes</a></p> <ul> - <li><a href="#a9.1">9.1 Display Pages</a><br/> + <li><a href="#a9.1">9.1 Display Pages</a><br> <span style="visibility:hidden">9.1 </span> including blank <ul> <li><a href="#a9.1.1">9.1.1 Half-Title</a></li> @@ -41,17 +41,17 @@ Footnotes and Endnotes</a></p> <li><a href="#a9.2">9.2 Start Pages: General</a> <ul> <li><a href="#a9.2.1">9.2.1 \thispagestyle{}</a></li> - <li><a href="#a9.2.2">9.2.2 \SetVersoHeadText{}<br/> + <li><a href="#a9.2.2">9.2.2 \SetVersoHeadText{}<br> <span style="visibility:hidden">9.2.2 </span>\SetRectoHeadText{}</a> </li> </ul> </li><!-- end 9.2 --> - <li><a href="#a9.3">9.3 Start Pages in Front Matter</a><br/> + <li><a href="#a9.3">9.3 Start Pages in Front Matter</a><br> <span style="visibility:hidden">9.3 </span>Foreword, Preface, etc. </li><!-- end 9.3 --> - <li><a href="#a9.4">9.4 Start Pages in Main Matter</a><br/> + <li><a href="#a9.4">9.4 Start Pages in Main Matter</a><br> <span style="visibility:hidden">9.3 </span>New Chapters <ul> <li><a href="#a9.4.1">9.4.1 \SetChapterStart{}</a></li> @@ -73,7 +73,7 @@ Footnotes and Endnotes</a></p> </ul> </li><!-- end 9.4 --> - <li><a href="#a9.5">9.5 Continued Pages</a><br/> + <li><a href="#a9.5">9.5 Continued Pages</a><br> <ul> <li><a href="#a9.5.1">9.5.1 \QuickChapter[]{}</a></li> <li><a href="#a9.5.2">9.5.2 Scene Breaks</a> @@ -90,15 +90,15 @@ Footnotes and Endnotes</a></p> <li><a href="#a9.6">9.6 Footnotes</a> <ul> <li><a href="#a9.6.1">9.6.1 \SetMarkers[]{}</a></li> - <li><a href="#a9.6.2">9.6.2 \realmarker \fakemarker</li> - <li><a href="#a9.6.3">9.6.3 \footnote[]{}</li> + <li><a href="#a9.6.2">9.6.2 \realmarker \fakemarker</a></li> + <li><a href="#a9.6.3">9.6.3 \footnote[]{}</a></li> </ul> </li><!-- end 9.6 --> <li><a href="#a9.7">9.7 Endnotes</a> <ul> <li><a href="#a9.7.1">9.7.1 \endnote</a></li> - <li><a href="#a9.7.2">9.7.2 \endnotetext{}{}</li> + <li><a href="#a9.7.2">9.7.2 \endnotetext{}{}</a></li> </ul> </li><!-- end 9.7 --> @@ -112,7 +112,7 @@ Footnotes and Endnotes</a></p> <div id="main"> <a id="a9"></a> <h1>Documentation for <code>novel</code> document class</h1> -<p>Documentation version: 1.0.8.</p> +<p>Documentation version: 1.0.9.</p> <div class="pagetopage"> @@ -122,17 +122,17 @@ Footnotes and Endnotes</a></p> <p><a href="noveldocs-03-metadata-pdfx.html">3. Metadata, PDF/X</a></p> <p><a href="noveldocs-04-layout.html">4. Page Layout</a></p> <p><a href="noveldocs-05-fonts.html">5. Choosing Fonts</a></p> -<p><a href="noveldocs-06-header-footer.html">6. Headers, Footers</a><br/> +<p><a href="noveldocs-06-header-footer.html">6. Headers, Footers</a><br> <p><a href="noveldocs-07-text-size-style.html">7. Text Sizes, Styles</a></p> <p><a href="noveldocs-08-images.html">8. Using Images</a></p> -<p>9. Display, Start Pages;<br/> -<span style="visibility:hidden">9. </span>Chapters; Continued Pages;<br/> +<p>9. Display, Start Pages;<br> +<span style="visibility:hidden">9. </span>Chapters; Continued Pages;<br> <span style="visibility:hidden">9. </span>Footnotes, Endotes.</p> </div> -<h2 style="clear:none">Display, Start, and Continued Pages;<br/> +<h2 style="clear:none">Display, Start, and Continued Pages;<br> Footnotes and Endnotes</h2> <p>A <em>display page</em> stands by itself, has a unique purpose, and is never continued to another page. A blank page is considered to be a display, even when there are several blanks.</p> @@ -160,7 +160,11 @@ Footnotes and Endnotes</h2> <p>If the preceding material ended with <code>\clearpage</code> or the following material begins with it, no problem. TeX wisely assumes that consecutive <code>\clearpage</code> commands are a mistake, and does not automatically skip a page between them. The <code>\null</code> command is the most effective way to show that you really did mean to create a page there.</p> -<p>A novel, or collection of stories, may contain these display pages: Half-Title, Frontispiece, Title, Copyright, Dedication, Epigraph, Map, Acknowledgements, Separator.</p> +<p>A novel, or collection of stories, may contain these display pages: Half-Title, Frontispiece, Title, Copyright, Dedication, Epigraph, Map, Acknowledgements, Separator. Almost all of them, if used, are in front matter.</p> + +<p>Note that a book's front matter does not have to be complicated. Here is an imitation of the entire front matter, from a detective novel written by a very famous author of such things. In order: Half-Title, Blank, Title, Copyright, duplicate Half-Title, Blank. A very decorative font is used for the book's title and the author's name.</p> + +<p class="centerimg"><img src="html-resources/fmsimple.png" width="716" height="177" alt="simple front matter"></p> @@ -169,17 +173,17 @@ Footnotes and Endnotes</h2> <p>Historically, the purpose of a Half-Title was to protect the title page during transportation and storage. This purpose has been obsolete for a long time, bcause modern books are printed and bound at once. But the tradition lives on. Use a Half-Title unless you absolutely must reduce the page count of your book.</p> -<p>The Half-Title is the first page of front matter. It is lowercase roman page <cide>i</code>, even though the number is not printed. The only material on the page is the book's title (not author) and usually not even a subtitle. If the title is artistically designed, then the Half-Title may be designed the same way, but is usually at smaller size. Place the Half-Title wherever it looks good on the page (certainly not at top left). For example:</p> +<p>The Half-Title is the first page of front matter. It is lowercase roman page <code>i</code>, even though the number is not printed. The only material on the page is the book's title (not author) and usually not even a subtitle. If the title is artistically designed, then the Half-Title may be designed the same way, but is usually at smaller size. Place the Half-Title wherever it looks good on the page (certainly not at top left). For example:</p> -<p class="code"><code><img class="floatright" src="html-resources/htss.png" width="174" height="269" alt="sample half title"/> -<small>\frontmatter <span class="ap">% Sets page numbers to lowercase roman.</span><br/> -\thispagestyle{empty} <span class="ap">% No header or footer.</span><br/> -\vspace*{6\nbs} <span class="ap">% Note asterisk. Skips 6 lines.</span><br/> -<span class="ap">% Right-aligns half-title at 2x normal font size:</span><br/> - <span class="ap">% \orbitron is defined as the non-TeX font Orbitron-Medium.otf</span><br/> +<p class="code"><code><img class="floatright" src="html-resources/htss.png" width="174" height="269" alt="sample half title"> +<small>\frontmatter <span class="ap">% Sets page numbers to lowercase roman.</span><br> +\thispagestyle{empty} <span class="ap">% No header or footer.</span><br> +\vspace*{6\nbs} <span class="ap">% Note asterisk. Skips 6 lines.</span><br> +<span class="ap">% Right-aligns half-title at 2x normal font size:</span><br> + <span class="ap">% \orbitron is defined as the non-TeX font Orbitron-Medium.otf</span><br> \stake\hfill{\orbitron\charscale[2]{Star Smash}}\par \vspace{0.4\nbs} -<span class="ap">% Decorative portion of half-title:</span><br/> +<span class="ap">% Decorative portion of half-title:</span><br> \noindent\hspace{12em}\charscale[1.6]{\decoglyph{r10059}} \bigemdash[2,2]\stake\par \clearpage <span class="ap">% Ends the page.</span> @@ -191,7 +195,7 @@ Footnotes and Endnotes</h2> <a id="a9.1.2"></a> <h4 style="clear:both">9.1.2 Frontispiece (usually blank)</h4> -<p><img class="floatright" src="html-resources/blakemilt.png" width="200" height="309" alt="sample artwork frontispiece" title="Frontispiece to William Blake's poem about Milton. Public Domain in U.S.A. and artist's home nation. Source Library of Congress via Wikimedia Commons."/> The verso of the Half-Title has page number <code>ii</code>, number not printed. Normally, this page is blank.</p> +<p><img class="floatright" src="html-resources/blakemilt.png" width="200" height="309" alt="sample artwork frontispiece" title="Frontispiece to William Blake's poem about Milton. Public Domain in U.S.A. and artist's home nation. Source Library of Congress via Wikimedia Commons."> The verso of the Half-Title has page number <code>ii</code>, number not printed. Normally, this page is blank.</p> <p>In the good old days (looong ago), this page might show an illustration. Search the Internet for "frontispiece" to see examples. At right is the frontispiece by William Blake for his poetry regarding Milton. In the original, it was in color (spectacularly expensive, back then).</p> @@ -201,13 +205,13 @@ Footnotes and Endnotes</h2> <p>The preparation and placement of images is described on another documentation page.</p> -<p class="clear:both"><img class="floatright" style="margin-top:40px" src="html-resources/blfr.png" width="134" height="207" alt="sample blank frontispiece"/> Some publishers put a centered list of “Books by the Same Author” here. Or, if the particular book is part of a set (“Splork Chronicles, Volume VI”) that can be mentioned. However, in the print-on-demand market, your printing and distribution service may not permit you to do that, unless they carry all of the books.</p> +<p class="clear:both"><img class="floatright" style="margin-top:40px" src="html-resources/blfr.png" width="134" height="207" alt="sample blank frontispiece"> Some publishers put a centered list of “Books by the Same Author” here. Or, if the particular book is part of a set (“Splork Chronicles, Volume VI”) that can be mentioned. However, in the print-on-demand market, your printing and distribution service may not permit you to do that, unless they carry all of the books.</p> <p>So, it is best to leave this page blank:</p> -<p class="code"><code><small>\clearpage<br/> -\thispagestyle{empty}<br/> -\null<br/> +<p class="code"><code><small>\clearpage<br> +\thispagestyle{empty}<br> +\null<br> \clearpage</small></code></p> @@ -225,37 +229,37 @@ Footnotes and Endnotes</h2> <p>Here are some commands that may be helpful for building your Title Page:</p> <p class="code"><code> -\thispagestyle{empty} <span class="ap">% no header or footer</span><br/> -\vspace*{<em>length</em>} <span class="ap">% puts space at top</span><br/> -\charscale[<em>scale, position</em>]{<em>text</em>} <span class="ap">% changes text size and position</span><br/> -{\centering <em>one line of text</em>\par} <span class="ap">% centers text</span><br/> -\stake\hfill <em>text</em>\par <span class="ap">% pushes text to right</span><br/> -\InlineImage[<em>options</em>]{<em>file</em>} <span class="ap">% see separate docs page</span><br/> -\BlockImage[<em>options</em>]{<em>file</em>} <span class="ap">% see separate docs page</span><br/> +\thispagestyle{empty} <span class="ap">% no header or footer</span><br> +\vspace*{<em>length</em>} <span class="ap">% puts space at top</span><br> +\charscale[<em>scale, position</em>]{<em>text</em>} <span class="ap">% changes text size and position</span><br> +{\centering <em>one line of text</em>\par} <span class="ap">% centers text</span><br> +\stake\hfill <em>text</em>\par <span class="ap">% pushes text to right</span><br> +\InlineImage[<em>options</em>]{<em>file</em>} <span class="ap">% see separate docs page</span><br> +\BlockImage[<em>options</em>]{<em>file</em>} <span class="ap">% see separate docs page</span><br> \vfill <span class="ap">% pushes following text to bottom of textblock</span> </code></p> <p>Below is a sample Title Page. The <code>\orbitron</code> command calls for the font Orbitron-Medium.otf, which is not part of the TeX distribution. The <code>\decoglyph</code> command calls fo a decorative element from the NovelDeco.otf font, which comes with the <code>novel</code> class. The length <code>\nbs</code> is the normal baseline skip of the book's main font. The <code>\stake</code> commands place an invisible zero-width reference point, for the use of adjacent commands. Here is the code:</p> -<p class="code"><img class="floatright" src="html-resources/starsmash.png" width="263" height="410" alt="sample title page"/> +<p class="code"><img class="floatright" src="html-resources/starsmash.png" width="263" height="410" alt="sample title page"> <code><small> -\clearpage<br/> -\thispagestyle{empty}<br/> -\vspace*{6\nbs}<br/> -\stake\hfill{\orbitron\charscale[3]{Star Smash}}\par<br/> -\vspace{0.4\nbs}<br/> -\noindent\charscale[3]{\decoglyph{r10059}}<br/> -\bigemdash[3.4,3]\stake\par<br/> -\vspace{0.4\nbs}<br/> -\stake\hfill{\orbitron\charscale[1.42]{A Sci-Fi Murder Mystery}}\par<br/> -\vspace{9\nbs}<br/> -\begin{center}<br/> -\charscale[4]{Dirk Hardcase}<br/> -\vfill<br/> -Meaningless Press\par<br/> -Eschwege • Merthyr Tydfil • Lethbridge\par<br/> -\end{center}<br/> +\clearpage<br> +\thispagestyle{empty}<br> +\vspace*{6\nbs}<br> +\stake\hfill{\orbitron\charscale[3]{Star Smash}}\par<br> +\vspace{0.4\nbs}<br> +\noindent\charscale[3]{\decoglyph{r10059}}<br> +\bigemdash[3.4,3]\stake\par<br> +\vspace{0.4\nbs}<br> +\stake\hfill{\orbitron\charscale[1.42]{A Sci-Fi Murder Mystery}}\par<br> +\vspace{9\nbs}<br> +\begin{center}<br> +\charscale[4]{Dirk Hardcase}<br> +\vfill<br> +Meaningless Press\par<br> +Eschwege • Merthyr Tydfil • Lethbridge\par<br> +\end{center}<br> \clearpage </small></code></p> @@ -274,58 +278,58 @@ Eschwege • Merthyr Tydfil • Lethbridge\par<br/> <p>Some commands useful on a Copyright Page:</p> <p class="code"><code> -\thispagestyle{empty} <span class="ap">% no header or footer</span><br/> -\vspace*{<em>length</em>} <span class="ap">% creates vertical space</span><br/> -<span class="ap">% legalese: ragged lines, no hyphenation, no indent.</span><br/> -\begin{legalese} ... \end{legalese}<br/> -\begin{adjustwidth}{<em>left</em>}{<em>right</em>} ... \end{adjustwidth} <span class="ap">% reduces width</span><br/> -\begin{center} ... \end{center} <span class="ap">% if desired</span><br/> -\begin{parascale} ... \end{parascale} <span class="ap">% shrinks text</span><br/> -\itshape{<em>text</em>} <span class="ap">% italics, and can span paragraphs</span><br/> -\textsc{<em>text</em>} <span class="ap">% lowercase to small caps (uppercase still uppercase)</span><br/> -\allsmcp{<em>text</em>} <span class="ap">% uppercase and lowercase to small caps</span><br/> -\acronym{<em>text</em>} <span class="ap">% uppercase to medium caps</span><br/> -\lnum{<em>number</em>} <span class="ap">% lining numbers instead of old style</span><br/> -\_ <span class="ap">% when underscore is in a URL</span><br/> -\% <span class="ap">% when % is in a URL</span><br/> -\& <span class="ap">% when & is in a URL</span><br/> +\thispagestyle{empty} <span class="ap">% no header or footer</span><br> +\vspace*{<em>length</em>} <span class="ap">% creates vertical space</span><br> +<span class="ap">% legalese: ragged lines, no hyphenation, no indent.</span><br> +\begin{legalese} ... \end{legalese}<br> +\begin{adjustwidth}{<em>left</em>}{<em>right</em>} ... \end{adjustwidth} <span class="ap">% reduces width</span><br> +\begin{center} ... \end{center} <span class="ap">% if desired</span><br> +\begin{parascale} ... \end{parascale} <span class="ap">% shrinks text</span><br> +\itshape{<em>text</em>} <span class="ap">% italics, and can span paragraphs</span><br> +\textsc{<em>text</em>} <span class="ap">% lowercase to small caps (uppercase still uppercase)</span><br> +\allsmcp{<em>text</em>} <span class="ap">% uppercase and lowercase to small caps</span><br> +\acronym{<em>text</em>} <span class="ap">% uppercase to medium caps</span><br> +\lnum{<em>number</em>} <span class="ap">% lining numbers instead of old style</span><br> +\_ <span class="ap">% when underscore is in a URL</span><br> +\% <span class="ap">% when % is in a URL</span><br> +\& <span class="ap">% when & is in a URL</span><br> </code></p> <p>You normally do not need to write a lot of things on a Copyright Page. But if your novel has a lot of real-world material, some of it may require acknowledgements and permissions. They may be placed on the Copyright Page. If everything almost fits, but not quite, you can shrink it using the <code>parascale</code> environment. However, do not shrink it too much, and don't fill the whole page like it was ordinary story text. When you have a lot of acknowledgements and permissions, move them to a separate section. If your book has a Preface (uncommon in fiction), perhaps put them there. Or, create a separate Acknowledgements section (also uncommon in fiction).</p> <p>Here is a sample abbreviated Copyright Page, centered style. Note that in the image, the text is displaced slightly to the left, because this is a verso page, and the right margin includes an allowance for gutter.</p> -<p class="code"><img class="floatright" style="padding-top:2em" src="html-resources/coprcen.png" width="265" height="406" alt="sample copyright page"/> +<p class="code"><img class="floatright" style="padding-top:2em" src="html-resources/coprcen.png" width="265" height="406" alt="sample copyright page"> <code><small> -\clearpage<br/> -\thispagestyle{empty}<br/> -\vspace*{5\nbs}<br/> -\begin{center}<br/> -\itshape{<br/> -Copyright ©2017 Dirk Hardcase.\\<br/> -All Rights Reserved.\par<br/> -\null<br/> -This is a work of fiction.\\<br/> -All persons and events are imaginary.\\<br/> -Resemblance to any real persons or events\\<br/> -is entirely coincidental.\par<br/> -\null<br/> -Printed in the United States of America\\<br/> -on acid-free paper.\par<br/> -\null<br/> -\allsmcp{FIRST EDITION}, March 2017.\par<br/> -\null<br/> -\allsmcp{ISBN} 9-876-54321-0\par<br/> -\null<br/> -Published by Dirk Hardcase,\\<br/> -Anytown, U.S.A.\par<br/> -\null<br/> -Inquiries for Cataloging-in-Publication data\\<br/> -should be directed to the author's web site:\par<br/> -\null<br/> -http://example.com/bigdealauthor.html\par<br/> -} % end \itshape<br/> -\end{center}<br/> +\clearpage<br> +\thispagestyle{empty}<br> +\vspace*{5\nbs}<br> +\begin{center}<br> +\itshape{<br> +Copyright ©2017 Dirk Hardcase.\\<br> +All Rights Reserved.\par<br> +\null<br> +This is a work of fiction.\\<br> +All persons and events are imaginary.\\<br> +Resemblance to any real persons or events\\<br> +is entirely coincidental.\par<br> +\null<br> +Printed in the United States of America\\<br> +on acid-free paper.\par<br> +\null<br> +\allsmcp{FIRST EDITION}, March 2017.\par<br> +\null<br> +\allsmcp{ISBN} 9-876-54321-0\par<br> +\null<br> +Published by Dirk Hardcase,\\<br> +Anytown, U.S.A.\par<br> +\null<br> +Inquiries for Cataloging-in-Publication data\\<br> +should be directed to the author's web site:\par<br> +\null<br> +http://example.com/bigdealauthor.html\par<br> +} % end \itshape<br> +\end{center}<br> \clearpage </small></code></p> @@ -333,36 +337,36 @@ http://example.com/bigdealauthor.html\par<br/> <p style="clear:both">Sample abbreviated Copyright Page, alternative style. This style is more effective when there are more details, particularly if there is a complete Cataloging-in-Publication data block:</p> -<p class="code"><img class="floatright" style="padding-top:2em" src="html-resources/coprbot.png" width="266" height="411" alt="sample copyright page"/> +<p class="code"><img class="floatright" style="padding-top:2em" src="html-resources/coprbot.png" width="266" height="411" alt="sample copyright page"> <code><small> -\clearpage<br/> -\thispagestyle{empty}<br/> -\null\vfill<br/> -\begin{adjustwidth}{0em}{8em}<br/> -\begin{legalese}<br/> -Copyright ©2017 Dirk Hardcase.\\<br/> -All Rights Reserved.\par<br/> -\null<br/> -This is a work of fiction.\\<br/> -All persons and events are imaginary.\\<br/> -Resemblance to any real persons or events\\<br/> -is entirely coincidental.\par<br/> -\null<br/> -Printed in the United States of America\\<br/> -on acid-free paper.\par<br/> -\null<br/> -\allsmcp{FIRST EDITION}, March 2017.\par<br/> -\null<br/> -\allsmcp{ISBN} 9-876-54321-0\par<br/> -\null<br/> -Published by Dirk Hardcase,\\<br/> -Anytown, U.S.A.\par<br/> -\null<br/> -Inquiries for Cataloging-in-Publication data\\<br/> -should be directed to the author's web site:\par<br/> -http://example.com/bigdealauthor.html\par<br/> -\end{legalese}<br/> -\end{adjustwidth}<br/> +\clearpage<br> +\thispagestyle{empty}<br> +\null\vfill<br> +\begin{adjustwidth}{0em}{8em}<br> +\begin{legalese}<br> +Copyright ©2017 Dirk Hardcase.\\<br> +All Rights Reserved.\par<br> +\null<br> +This is a work of fiction.\\<br> +All persons and events are imaginary.\\<br> +Resemblance to any real persons or events\\<br> +is entirely coincidental.\par<br> +\null<br> +Printed in the United States of America\\<br> +on acid-free paper.\par<br> +\null<br> +\allsmcp{FIRST EDITION}, March 2017.\par<br> +\null<br> +\allsmcp{ISBN} 9-876-54321-0\par<br> +\null<br> +Published by Dirk Hardcase,\\<br> +Anytown, U.S.A.\par<br> +\null<br> +Inquiries for Cataloging-in-Publication data\\<br> +should be directed to the author's web site:\par<br> +http://example.com/bigdealauthor.html\par<br> +\end{legalese}<br> +\end{adjustwidth}<br> \clearpage </small></code></p> @@ -378,15 +382,15 @@ http://example.com/bigdealauthor.html\par<br/> <p>If used, a Dedication is normally on page <code>v</code>, immediately following the Copyright Page. An exception might be if your work is a reprint of someone else's work, in which case you do not want the original author's Dedication to be interpreted as being your own.</p> -<p><img class="floatright" src="html-resources/dedic.png" width="133" height="205" alt="sample dedication page"/> Keep it simple. If your book is combat fiction, it might be:</p> +<p><img class="floatright" src="html-resources/dedic.png" width="133" height="205" alt="sample dedication page"> Keep it simple. If your book is combat fiction, it might be:</p> <p class="code"><code><small> -\clearpage<br/> -\thispagestyle{empty}<br/> -\vspace*{12\nbs}<br/> -\begin{center}<br/> -\charscale[1.25]{\textsc{To Those Who Served}}\par<br/> -\end{center}<br/> +\clearpage<br> +\thispagestyle{empty}<br> +\vspace*{12\nbs}<br> +\begin{center}<br> +\charscale[1.25]{\textsc{To Those Who Served}}\par<br> +\end{center}<br> \clearpage </small></code></p> @@ -402,15 +406,15 @@ http://example.com/bigdealauthor.html\par<br/> <p>Here is a sample Epigraph, in which the fictional speaker appears as a character in the book. A glance at this, and you know where the story is headed:</p> -<p class="code"><img class="floatright" src="html-resources/dorfmcnorf.png" width="131" height="208" alt="sample epigraph"/> +<p class="code"><img class="floatright" src="html-resources/dorfmcnorf.png" width="131" height="208" alt="sample epigraph"> <code><small> -\clearpage<br/> -\thispagestyle{empty}<br/> -\vspace*{10\nbs}<br/> -\begin{adjustwidth}{7em}{7em}<br/> -Let me tell you, there's nothing more exciting than the brouhaha at Mickey's Pub each Saturday night in April.\par<br/> -\stake\hfill---Dorf McNorf\par<br/> -\end{adjustwidth}<br/> +\clearpage<br> +\thispagestyle{empty}<br> +\vspace*{10\nbs}<br> +\begin{adjustwidth}{7em}{7em}<br> +Let me tell you, there's nothing more exciting than the brouhaha at Mickey's Pub each Saturday night in April.\par<br> +\stake\hfill---Dorf McNorf\par<br> +\end{adjustwidth}<br> \clearpage </small></code></p> @@ -434,16 +438,16 @@ Let me tell you, there's nothing more exciting than the brouhaha at Mickey's Pub <p>Note that I subsequently added the black border during image editing; it is not part of the Epigraph.</p> -<p class="code"><img class="floatright" src="html-resources/epigrcom.png" width="131" height="204" alt="Epigraph page"/> +<p class="code"><img class="floatright" src="html-resources/epigrcom.png" width="131" height="204" alt="Epigraph page"> <code><small> -\thispagestyle{empty} % no header or footer<br/> -\vspace*{10\nbs} % for vertical position<br/> -<img class="floatright" src="html-resources/epibjorn.png" width="265" height="91" alt="Epigraph text"/> -\Epigraph[c]{% percent prevents newline</span><br/> -When sacred swallows sound at dawn,\\<br/> -And eager eagles eye their prey,\\<br/> -Then shall Shan-Sun wreak revenge.\\<br/> -\hfill---Book of Bjorn\par<br/> +\thispagestyle{empty} % no header or footer<br> +\vspace*{10\nbs} % for vertical position<br> +<img class="floatright" src="html-resources/epibjorn.png" width="265" height="91" alt="Epigraph text"> +\Epigraph[c]{<span class="ap">% percent prevents newline</span><br> +When sacred swallows sound at dawn,\\<br> +And eager eagles eye their prey,\\<br> +Then shall Shan-Sun wreak revenge.\\<br> +\hfill---Book of Bjorn\par<br> } % end of Epigraph </small></code></p> @@ -493,29 +497,29 @@ Then shall Shan-Sun wreak revenge.\\<br/> <p><b>Example of toc:</b> The use of the <code>toc</code> environment, and the <code>\tocitem</code> commands, are easily understood by looking at an example. The border of the image is where the normal page margins would be (the actual page is larger). The little explanation at top happens to exactly fit the table width, because I tweaked the text and the width until it fit!</p> -<p class="code" style="text-indent:0px; font-size:small"><img class="floatright" src="html-resources/toc.png" width="317" height="490" alt="toc example"/> +<p class="code" style="text-indent:0px; font-size:small"><img class="floatright" src="html-resources/toc.png" width="317" height="490" alt="toc example"> <code> -\clearpage<br/> -\thispagestyle{empty}<br/> -\begin{toc}[0.25]{3em}<br/> -\vspace*{4\nbs}<br/> -{\centering\charscale[1.25]{The Withens Retaliation}\par}<br/> -\null<br/> -In which Lord Withens, fresh from a program in horticulture, unleashes secret desires on the garden.\par<br/> -\null\null<br/> -\tocitem*[1]{The Evil Weeds}{1}<br/> -\tocitem*[2]{A Plan of Attack}{14}<br/> -\tocitem*[3]{Lady Withens Objects}{35}<br/> -\tocitem*[4]{Back-Hoe to the Rescue}{48}<br/> -\tocitem[5]{Invasion of the Dandelions}{}<br/> -\tocitem*[~]{\emph{Interlude}}{63}<br/> -\tocitem*[6]{Army of the Gardeners}{94}<br/> -\tocitem*[7]{Too Much Rain}{113}<br/> -\tocitem*[8]{To Nuke, or Not to Nuke?}{145}<br/> -\tocitem*[9]{Revenge of the Zucchini}{162}<br/> -\tocitem*[10]{Lady Withens Sneezes}{180}<br/> -\tocitem*[11]{The Concrete Lawn}{206}<br/> -\end{toc}<br/> +\clearpage<br> +\thispagestyle{empty}<br> +\begin{toc}[0.25]{3em}<br> +\vspace*{4\nbs}<br> +{\centering\charscale[1.25]{The Withens Retaliation}\par}<br> +\null<br> +In which Lord Withens, fresh from a program in horticulture, unleashes secret desires on the garden.\par<br> +\null\null<br> +\tocitem*[1]{The Evil Weeds}{1}<br> +\tocitem*[2]{A Plan of Attack}{14}<br> +\tocitem*[3]{Lady Withens Objects}{35}<br> +\tocitem*[4]{Back-Hoe to the Rescue}{48}<br> +\tocitem[5]{Invasion of the Dandelions}{}<br> +\tocitem*[~]{\emph{Interlude}}{63}<br> +\tocitem*[6]{Army of the Gardeners}{94}<br> +\tocitem*[7]{Too Much Rain}{113}<br> +\tocitem*[8]{To Nuke, or Not to Nuke?}{145}<br> +\tocitem*[9]{Revenge of the Zucchini}{162}<br> +\tocitem*[10]{Lady Withens Sneezes}{180}<br> +\tocitem*[11]{The Concrete Lawn}{206}<br> +\end{toc}<br> \clearpage </code> </p> @@ -531,14 +535,14 @@ In which Lord Withens, fresh from a program in horticulture, unleashes secret de <p>A Part Separator is part of main matter, and has an arabic page number. However, the page number is not printed (possible exception if the separator also contains substantial text, by way of introduction). Thus, the first Part Separator would be page <code>1</code>, and its story would begin on page <code>3</code>. Wihout a Part Separator, the story would begin on page <code>1</code>. -<p class="code"><img class="floatright" src="html-resources/partsep.png" width="134" height="202" alt="part separator"/> +<p class="code"><img class="floatright" src="html-resources/partsep.png" width="134" height="202" alt="part separator"> <code><small> -\clearpage<br/> -<span class="ap">% \mainmatter % if needed to begin at page 1</span><br/> -\thispagestyle{empty}<br/> -\vspace*{10\nbs}<br/> -% the tilde provides better separation:<br/> -{\centering\charscale[2]{PART~ I}\par}<br/> +\clearpage<br> +<span class="ap">% \mainmatter % if needed to begin at page 1</span><br> +\thispagestyle{empty}<br> +\vspace*{10\nbs}<br> +% the tilde provides better separation:<br> +{\centering\charscale[2]{PART~ I}\par}<br> \clearpage </small></code></p> @@ -580,7 +584,7 @@ In which Lord Withens, fresh from a program in horticulture, unleashes secret de <p>The following image shows three pages of a Foreword, from a book that uses header but no footer. On its start page, the folio has been dropped inside. Color added for illustration.</p> -<p class="centerimg"><img src="html-resources/dfi.png" width="534" height="267" alt="example of inside drop folio"/></p> +<p class="centerimg"><img src="html-resources/dfi.png" width="534" height="267" alt="example of inside drop folio"></p> <p class="code"><code>\thispagestyle{dropfoliobeneath}</code></p> @@ -610,28 +614,28 @@ In which Lord Withens, fresh from a program in horticulture, unleashes secret de <p>The header text will appear in the font chosen as <code>headerfont</code>. You may over-ride that with a local font command. The text may be styled with commands such as <code>\textsc</code> or <code>\textls</code> or <code>\emph</code> if desired. Do not use underline or bold.</p> -<p><img class="floatright" src="html-resources/preface.png" width="259" height="820" alt="example preface"/> Here is an example, where the author wrote a Preface several pages long, and the book layout uses a header. The <code>ChapterStart</code> environment is used, but this is not a requirement. The <code>lipsum</code> package was used for text fill:</p> +<p><img class="floatright" src="html-resources/preface.png" width="259" height="820" alt="example preface"> Here is an example, where the author wrote a Preface several pages long, and the book layout uses a header. The <code>ChapterStart</code> environment is used, but this is not a requirement. The <code>lipsum</code> package was used for text fill:</p> <p class="code"><code><small> -\clearpage<br/> -\thispagestyle{footer} <span class="ap">% or dropfolioinside or dropfoliobeneath</span><br/> -\SetVersoHeadText{\textsc{Preface}}<br/> -\SetRectoHeadText{\textsc{Preface}}<br/> -\begin{ChapterStart}<br/> -\vspace*{2\nbs}<br/> -\ChapterTitle{Preface}<br/> -\end{ChapterStart}<br/> -The inspiration for this book...\par<br/> -\lipsum<br/> -But while I was held captive...\par<br/> -\lipsum<br/> -Clawing my way to the sunlight...\par<br/> -\lipsum<br/> -... And I hope you will enjoy it.\par<br/> -\null<br/> -\stake\hfill Dirk Hardcase.\par<br/> -\stake\hfill Springfield, March 14, 2017\par<br/> -\clearpage<br/> +\clearpage<br> +\thispagestyle{footer} <span class="ap">% or dropfolioinside or dropfoliobeneath</span><br> +\SetVersoHeadText{\textsc{Preface}}<br> +\SetRectoHeadText{\textsc{Preface}}<br> +\begin{ChapterStart}<br> +\vspace*{2\nbs}<br> +\ChapterTitle{Preface}<br> +\end{ChapterStart}<br> +The inspiration for this book...\par<br> +\lipsum<br> +But while I was held captive...\par<br> +\lipsum<br> +Clawing my way to the sunlight...\par<br> +\lipsum<br> +... And I hope you will enjoy it.\par<br> +\null<br> +\stake\hfill Dirk Hardcase.\par<br> +\stake\hfill Springfield, March 14, 2017\par<br> +\clearpage<br> <span class="ap">% Be sure to re-set the head texts now!</span> </small></code></p> @@ -696,7 +700,7 @@ Clawing my way to the sunlight...\par<br/> <p>Each of these commands may only be used for a single line of contents. If the contents cannot fit on a single line, then you must manually break and issue the command twice. The commands may be used in any order, may be used more than once, or not at all.</p> <a id="a9.4.3.1"></a> -<p class="h5"><img class="floatright" style="margin-top:40px;" src="html-resources/chapst.png" width="263" height="409" alt="example chapter start"/> +<p class="h5"><img class="floatright" style="margin-top:40px;" src="html-resources/chapst.png" width="263" height="409" alt="example chapter start"> <b>9.4.3.1\ChapterTitle{<em>text</em>}</b> sets its text using <code>chapterfont</code>. The default is the main font scaled 1.6, with lining numbers.</p> <a id="a9.4.3.2"></a> @@ -708,13 +712,13 @@ Clawing my way to the sunlight...\par<br/> <p style="margin-top:20px">Example, where <code>\clearpage</code> and <code>\mainmatter</code> were already issued:</p> <p class="code"><code><small> -\thispagestyle{dropfolioinside}<br/> -\begin{ChapterStart} <span class="ap">% default 10 lines</span><br/> - \null <span class="ap">% for positioning title</span><br/> - \ChapterTitle{Prologue}<br/> - \ChapterDeco[4]{\decoglyph{r9548}}<br/> - \ChapterSubtitle{The Finding of the Manuscript}<br/> -\end{ChapterStart}<br/> +\thispagestyle{dropfolioinside}<br> +\begin{ChapterStart} <span class="ap">% default 10 lines</span><br> + \null <span class="ap">% for positioning title</span><br> + \ChapterTitle{Prologue}<br> + \ChapterDeco[4]{\decoglyph{r9548}}<br> + \ChapterSubtitle{The Finding of the Manuscript}<br> +\end{ChapterStart}<br> <span class="ap">% then the main text</span> </small></code></p> @@ -728,21 +732,21 @@ Clawing my way to the sunlight...\par<br/> <a id="a9.4.4.1"></a> -<p class="h5"><img class="floatright" src="html-resources/ctimg35.png" width="79" height="196" alt="example of chapter title image, text over"/><b>9.4.4.1 Text Over Image:</b> You may position text over an image. Be aware that overlapping text and graphics may be interpreted as a mistake, by human reviewers. It is best to use black text, or grayscale text that is much darker than the underlying image. Results are uncertain if you try to place light text over a dark image.</p> +<p class="h5"><img class="floatright" src="html-resources/ctimg35.png" width="79" height="196" alt="example of chapter title image, text over"><b>9.4.4.1 Text Over Image:</b> You may position text over an image. Be aware that overlapping text and graphics may be interpreted as a mistake, by human reviewers. It is best to use black text, or grayscale text that is much darker than the underlying image. Results are uncertain if you try to place light text over a dark image.</p> <p>Example, where the command <code>\unifrac</code> calls for the font UnifrakturMaguntia.ttf. Note that the font command is <em>outside</em> <code>\charscale</code>:</p> -<p class="code"><code><small>\begin{ChapterStart}<br/> -\BlockImage{sword.png} <span class="ap">% centered by default</span><br/> -{\unifrak\centering\charscale[3,0pt,4\nbs]{35}\par}<br/> +<p class="code"><code><small>\begin{ChapterStart}<br> +\BlockImage{sword.png} <span class="ap">% centered by default</span><br> +{\unifrak\centering\charscale[3,0pt,4\nbs]{35}\par}<br> </small>\end{ChapterStart}</code></p> <a id="a9.4.4.2"></a> <p class="h5"><b>9.4.4.2 Text as Part of Image:</b> If the text is not ordinary black, or not much darker than the background image, then it is better to include the text as part of the raster image. The reason is that there is no "white ink." Although light text over a dark image will appear correctly in PDF, and print that way on most printers, there are exceptions. If in doubt, ask your print service. In this example, the number is built into the image itself:</p> -<p class="code"><img class="floatright" src="html-resources/smfingerprint8.png" width="86" height="70" alt="example of chapter title image, raster text"/><code><small>\begin{ChapterStart}<br/> -\BlockImage[l]{smfingerprint8.png}<br/> +<p class="code"><img class="floatright" src="html-resources/smfingerprint8.png" width="86" height="70" alt="example of chapter title image, raster text"><code><small>\begin{ChapterStart}<br> +\BlockImage[l]{smfingerprint8.png}<br> \end{ChapterStart}</small></code></p> @@ -766,12 +770,12 @@ Clawing my way to the sunlight...\par<br/> <p>Example:</p> -<p class="code"><code><small>Then he looked at me with a sneer, and barked, ``You better haul your can over to Vinny's joint, before the Boss finds out.''\par<br/> -\QuickChapter[3em]{16. At Vinny's}<br/> -So I took his advice, and hauled my can over to Vinny's. It was everything I had expected, and worse.\par<br/> +<p class="code"><code><small>Then he looked at me with a sneer, and barked, ``You better haul your can over to Vinny's joint, before the Boss finds out.''\par<br> +\QuickChapter[3em]{16. At Vinny's}<br> +So I took his advice, and hauled my can over to Vinny's. It was everything I had expected, and worse.\par<br> The bouncer wasn't the biggest one I'd ever seen, but he was the ugliest. ...</small></code></p> -<p class="centerimg"><img src="html-resources/quickchapter.png" width="629" height="240" alt="quick chapter"/></p> +<p class="centerimg"><img src="html-resources/quickchapter.png" width="629" height="240" alt="quick chapter"></p> <a id="a9.5.2"></a> @@ -790,18 +794,18 @@ The bouncer wasn't the biggest one I'd ever seen, but he was the ugliest. ...</s <p style="margin-top:20px">Examples:</p> -<p class="code"><img style="float:right; margin-left:16px;" src="html-resources/scenebreaks.png" width="331" height="236" alt="scene breaks" /> +<p class="code"><img style="float:right; margin-left:16px;" src="html-resources/scenebreaks.png" width="331" height="236" alt="scene breaks" > <code><small> -\noindent It was a dark and stormy night.\par<br/> -Lord Withens, the last of his line, hurried through the gloom to Castle McWhistle, where Lady McWhistle awaited.\par<br/> -\scenebreak<br/> -Well, maybe it was not very dark.\par<br/> -But to Lord Withens, it seemed dark enough. Or rather, he hoped it was dark enough. Lord McWhistle was suspicious.\par<br/> -\sceneline<br/> -Actually, it was not all that stormy, either. But the Withens clan never tolerated drizzle, much less a storm.\par<br/> -Who could blame them? It's not like they lived in Italy.\par<br/> -\scenestars<br/> -Ah, such ill fortune haunted the Withens!\par<br/> +\noindent It was a dark and stormy night.\par<br> +Lord Withens, the last of his line, hurried through the gloom to Castle McWhistle, where Lady McWhistle awaited.\par<br> +\scenebreak<br> +Well, maybe it was not very dark.\par<br> +But to Lord Withens, it seemed dark enough. Or rather, he hoped it was dark enough. Lord McWhistle was suspicious.\par<br> +\sceneline<br> +Actually, it was not all that stormy, either. But the Withens clan never tolerated drizzle, much less a storm.\par<br> +Who could blame them? It's not like they lived in Italy.\par<br> +\scenestars<br> +Ah, such ill fortune haunted the Withens!\par<br> Unfortunately, novelists of that era had so little to write about, or they would have chosen another family to pursue.\par </small></code></p> @@ -887,12 +891,12 @@ Unfortunately, novelists of that era had so little to write about, or they would <p class="code"> <code><small> -\endnotetext{9}{Yang Sho-Nuff was the twelfth son of the elder god of the ancient Who-Zit Clan, with power over the forces of rust.\par}<br/> -\endnotetext{}{\indent However, since this was not yet the Iron Age, the terible might of Yang Sho-Nuff was largely unrecognized.\par}<br/> +\endnotetext{9}{Yang Sho-Nuff was the twelfth son of the elder god of the ancient Who-Zit Clan, with power over the forces of rust.\par}<br> +\endnotetext{}{\indent However, since this was not yet the Iron Age, the terrible might of Yang Sho-Nuff was largely unrecognized.\par}<br> \endnotetext{10}{As Professor Withens notes in his treatise, \emph{When Sho-Nuff Was Not Enough}, the ceremony of daily human sacrifice had a devastating effect on the tribal population.\par} </small></code></p> -<p class="centerimg"><img src="html-resources/endnotetext.png" width="637" height="219" alt="using endnotetext"/></p> +<p class="centerimg"><img src="html-resources/endnotetext.png" width="447" height="151" alt="using endnotetext"></p> |