texlive[69658] Master/texmf-dist: novel (1feb24)
commits+karl at tug.org
commits+karl at tug.org
Thu Feb 1 22:06:11 CET 2024
Revision: 69658
https://tug.org/svn/texlive?view=revision&revision=69658
Author: karl
Date: 2024-02-01 22:06:11 +0100 (Thu, 01 Feb 2024)
Log Message:
-----------
novel (1feb24)
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/lualatex/novel/README.md
trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-example.tex
trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-extras-README.html
trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-scripts.zip
trunk/Master/texmf-dist/doc/lualatex/novel/novel-documentation.html
trunk/Master/texmf-dist/doc/lualatex/novel/novel.pdf
trunk/Master/texmf-dist/doc/lualatex/novel/novel.tex
trunk/Master/texmf-dist/tex/lualatex/novel/novel-CGATSTR001.clo
trunk/Master/texmf-dist/tex/lualatex/novel/novel-CalculateLayout.sty
trunk/Master/texmf-dist/tex/lualatex/novel/novel-ChapterScene.sty
trunk/Master/texmf-dist/tex/lualatex/novel/novel-DropCap.sty
trunk/Master/texmf-dist/tex/lualatex/novel/novel-FOGRA39.clo
trunk/Master/texmf-dist/tex/lualatex/novel/novel-FileData.sty
trunk/Master/texmf-dist/tex/lualatex/novel/novel-Fonts.sty
trunk/Master/texmf-dist/tex/lualatex/novel/novel-Footnotes.sty
trunk/Master/texmf-dist/tex/lualatex/novel/novel-HeadFootStyles.sty
trunk/Master/texmf-dist/tex/lualatex/novel/novel-Images.sty
trunk/Master/texmf-dist/tex/lualatex/novel/novel-JC200103.clo
trunk/Master/texmf-dist/tex/lualatex/novel/novel-LayoutSettings.sty
trunk/Master/texmf-dist/tex/lualatex/novel/novel-PostLayout.sty
trunk/Master/texmf-dist/tex/lualatex/novel/novel-Sandbox.sty
trunk/Master/texmf-dist/tex/lualatex/novel/novel-TextMacros.sty
trunk/Master/texmf-dist/tex/lualatex/novel/novel-microtype.cfg
trunk/Master/texmf-dist/tex/lualatex/novel/novel-pdfx.sty
trunk/Master/texmf-dist/tex/lualatex/novel/novel-xmppacket.sty
trunk/Master/texmf-dist/tex/lualatex/novel/novel.cls
Removed Paths:
-------------
trunk/Master/texmf-dist/doc/lualatex/novel/extras/CPmodified.otf
trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-Gallery-ChapterStart.pdf
trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-example.pdf
trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-testimage.jpg
trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-testimage.png
trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-testscript.jpg
trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-testscript.png
trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-testsuite.pdf
trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-testsuite.tex
trunk/Master/texmf-dist/doc/lualatex/novel/needed-packages
Modified: trunk/Master/texmf-dist/doc/lualatex/novel/README.md
===================================================================
--- trunk/Master/texmf-dist/doc/lualatex/novel/README.md 2024-02-01 21:05:56 UTC (rev 69657)
+++ trunk/Master/texmf-dist/doc/lualatex/novel/README.md 2024-02-01 21:06:11 UTC (rev 69658)
@@ -2,14 +2,11 @@
The `novel` document class is intended for popular fiction books,
printed to paper: murder mystery, historical romance, etc.
-
Special attention to the needs of print-on-demand.
-Site github.com/rallg/novel is the canonical project page for the
-Novel document class, as seen in TeXlive and at CTAN. It is now
-in version 1.83, November 2023. Only change from 1.82 is a minor typo.
+Due to changes in print technology over the years, much of `novel` code
+is now unnecessary. Also, it offers many rarely-used features that bloat
+the code and its documentation. If you have not already used `novel`,
+the simpler `novelette` document class might be better for your
+purpose. Expected 2024.
-Also see the `novelette` document class, by the same developer.
-It is much simpler, yet does what it needs to do. Expected in
-late November, 2023. Site github.com/rallg/novelette but not yet
-at CTAN, since it is still Alpha stage.
Deleted: trunk/Master/texmf-dist/doc/lualatex/novel/extras/CPmodified.otf
===================================================================
(Binary files differ)
Deleted: trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-Gallery-ChapterStart.pdf
===================================================================
(Binary files differ)
Deleted: trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-example.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-example.tex
===================================================================
--- trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-example.tex 2024-02-01 21:05:56 UTC (rev 69657)
+++ trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-example.tex 2024-02-01 21:06:11 UTC (rev 69658)
@@ -11,7 +11,7 @@
% have read/write permissions for any user. If they don't, then
% compile will fail at the point where files are written.
-\documentclass{novel} % v. 1.83.
+\documentclass{novel} % v. 1.86.
\SetTitle{Dark and Stormy}
\SetSubtitle{A Tale of Nights}
\SetAuthor{Dirk Hardcase}
Modified: trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-extras-README.html
===================================================================
--- trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-extras-README.html 2024-02-01 21:05:56 UTC (rev 69657)
+++ trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-extras-README.html 2024-02-01 21:06:11 UTC (rev 69658)
@@ -9,21 +9,15 @@
<h2>README for novel extras</h2>
-<p>This folder contains items that may be helpful, but are not essential to operation of the <i>novel</i> document class. Version 1.83.</p>
+<p>This folder contains items that may be helpful, but are not essential to operation of the <i>novel</i> document class. Version 1.86.</p>
<p>File <i>novel-example.tex</i> is a fake short novel. If you wish to compile it, place a copy in your user home folder (or other place where you have read/write privilege) and compile it there.</p>
-<p>File <i>novel-testsuite.tex</i> exercises the various capabilities of the document class. You can look at the code, and see how it compiles. You may also change settings, to see what they do. It requires files <i>novel-testimage.png</i>, <i>novel-testimage.jpg</i>, <i>novel-testscript.png</i>, and <i>novel-testscript.jpg</i>. If you wish to compile it, place a copy (along with images) in your user home folder (or other place where you have read/write privilege) and compile it there.</p>
-
<p>File <i>novel-decoglyphs.pdf</i> shows the decorative characters in the <i>NovelDeco.otf</i> file, along with the codes needed to retrieve them.</p>
-<p>File <i>novel-Gallery-ChapterStart.pdf</i> shows a number of different ways to begin a chapter, making use of the ChapterStart environment and related commands. These are only suggestions.</p>
-
-<p>File <i>CPmodified.otf</i> is not (normally) for use in TeX. I use it when editing my work in a word processor, prior to TeX markup. To use it, install the font in your operating system (not in TeX) where a word processor can find it. This font is nearly-monospaced, with exaggerated punctuation marks. I have found that punctuation errors are most frequently overlooked during editing, since they are so small in many fonts, and the spell-check software doesn't find the errors.</p>
-
-
<div>
<h3>novel-scripts.zip</h3>
+<p>IMPORTANT: The techniques described in these scripts, are rarely needed nowadays (late 2023).</p>
<p>This zip archive contains Windows batch scripts, and Linux/OSX BASH scripts, for automatic image conversion.</p>
<p>The scripts are meant to ensure that your use of images complies with commercial printing standards. In particular, they provide a method for converting color cover artwork to CMYK at 240% ink limit, in a PDF/X-1a:2001 file.</p>
<p>Complete usage instructions are documented within the zip archive.</p>
Modified: trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-scripts.zip
===================================================================
(Binary files differ)
Deleted: trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-testimage.jpg
===================================================================
(Binary files differ)
Deleted: trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-testimage.png
===================================================================
(Binary files differ)
Deleted: trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-testscript.jpg
===================================================================
(Binary files differ)
Deleted: trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-testscript.png
===================================================================
(Binary files differ)
Deleted: trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-testsuite.pdf
===================================================================
(Binary files differ)
Deleted: trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-testsuite.tex
===================================================================
--- trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-testsuite.tex 2024-02-01 21:05:56 UTC (rev 69657)
+++ trunk/Master/texmf-dist/doc/lualatex/novel/extras/novel-testsuite.tex 2024-02-01 21:06:11 UTC (rev 69658)
@@ -1,318 +0,0 @@
-% !TeX TS-program = lualatex
-% !TeX encoding = UTF-8
-
-% Copyright 2023 Robert Allgeyer.
-% This file may be distributed and/or modified under the
-% conditions of the LaTeX Project Public License, version 1.3c.
-% License URL: https://www.latex-project.org/lppl/lppl-1-3c/
-
-% TEST SUITE FOR NOVEL DOCUMENT CLASS
-%
-% IF YOU COMPILE THIS DOCUMENT: Be sure that this file, and its generated PDF,
-% have read/write permissions for any user. If they don't, then
-% compile will fail at the point where files are written.
-%
-% This document tests the various capabilities of `novel' document class.
-% The Preamble settings are originally the defaults.
-% Change them to exercise the setting, and see the result.
-% In the document body, various commands are exercised.
-%
-% You need all fonts from the `libertinus' package,
-% all fonts from `lmodern' package,
-% and the included NovelDeco.otf.
-%
-% You also need the file` novel-testimage.png'
-% in the same folder as this document.
-% It is grayscale png, 150x150 pixels, with resolution 300pdi.
-%
-% The `test' class option is required. You may add others.
-
-\documentclass[test,shademargins,draft]{novel} % v. 1.83.
-\SetTitle{Test Suite}
-\SetSubtitle{Novel Document Class}
-\SetAuthor{Author Name}
-% Additional Preamble, if desired.
-
-
-\begin{document}
-
-\frontmatter % begins at page i.
-
-\thispagestyle{footer}
-\vspace*{5\nbs}
-\begin{center}
-\charscale[3.6]{\textbf{Test Suite}}\par
-\vspace{1.5\nbs}
-\charscale[1.6]{Novel Document Class}\par
-\vspace{4\nbs}
-\ChapterDeco[6]{\decoglyph{n9548}}
-\vspace{2\nbs}
-\charscale[1.5]{The following page will be blank!}\par
-\vfill
-If you choose a head/foot style with footer, then page number i (lowercase roman) will appear in the footer below.\par
-But if the head/foot style has no footer, then nothing below.\par
-\end{center}
-\clearpage
-
-
-% Now to begin at page 1:
-\mainmatter
-
-\begin{ChapterStart}[10]
-\vspace*{3\nbs}
-\ChapterTitle{Chapter One}
-\ChapterSubtitle{Dark and Stormy}
-\ChapterDeco[4]{\decoglyph{n9548}}
-\end{ChapterStart}
-
-This tests the ChapterStart environment, plus \string\ChapterTitle, \string\ChapterSubtitle, \string\ChapterDeco, and \string\decoglyph.
-
-In the TeX document, you can change the height of the environment, the alignment of its components, the decoglyph, and so forth.
-
-The first paragraph will not be indented, but all following paragraphs will be indented.
-
-Since this is a recto (odd-numbered) page at right side, the default margins will be a little larger at left, where there is an allowance for binding gutter.
-
-Unless you change the head/foot style, you should see no heading. Arabic page number 1 should be at the bottom.
-
-\clearpage
-
-
-% NEXT PAGE:
-
-This page tests the \string\charscale\space command, and \string\rotatebox. The combined effect is shown below:\par
-\vspace{1.5\nbs} % trial and error
-\charscale[2,3em,-4em]{\rotatebox[origin=c]{45}{Random Test Items}}
-\vspace{7.5\nbs} % trial and error
-
-Above, you should see the phrase Random Test Items in larger than normal text, tilted 45 degrees, nicely fitting between the text above and this text. Offset has been used, so it is not quite centered.
-
-If you change the font size or number of lines per page, then the tilted phrase might not fit nicely. That can be fixed by changing the amount of \string\vspace\space above and below the rotated text.
-
-The amount of \string\vspace\space is not calculated automatically. You have to determine it by trial and error (or do some math). The total amount of \string\vspace, top and bottom, must be an integer.
-
-If you use \string\rotatebox\space without \string\charscale, then it will create its own vertical gap. Unfortunately, the height of this gap is very difficult for you to calculate, so you would not be able to easily restore the line grid by adding some amount of \string\vspace. So, don't use \string\rotatebox\space without \string\charscale.
-
-\clearpage
-
-
-% NEXT PAGE:
-
-This page tests \string\FloatImage\space effects. Remember that \textit{novel} uses its own methods of placing images.
-
-There will be a gap before the image appears. In the tex code, find \string\vspace\space there, and change the space. At some point, the image will float to the top of the following page.
-
-\vspace{7\nbs}
-
-\FloatImage[ht]{novel-testimage.png}
-
-Above, the top of the image sits where the baseline of text would be. If the image fits where placed, then this paragraph comfortably clears the bottom of the image. If the gap is increased so that the image flats to the top of the next page, then this paragraph will be directly beneath the preceding paragraph.
-
-
-
-\clearpage
-
-% NEXT PAGE:
-
-This page tests \string\InlineImage\space effects. Note that the command also has a starred version. The difference: Unstarred, the width of the image is taken into account. Starred, the width of the image is ignored.
-
-\null
-
-\noindent\InlineImage*[0,\normalXheight]{novel-testimage.png}This paragraph is not indented. The starred command places an image, offset so that its top sits at the X-height of the text. The image underlies the following text. If you use this effect, then be sure that the image is much lighter, or the text will be hard to read.
-
-\null\null\null
-
-\noindent\InlineImage[0,b-\normaldescender]{novel-testimage.jpg}This paragraph is not indented. The unstarred command places an image, offset so that its bottom sits at the descender of the text. It was necessary to insert previous blank lines, or the image would overlie (and obscure) the preceding paragraph.
-
-\null\null
-
-\noindent\InlineImage[0,1.5em]{novel-testscript.png}This paragraph is not indented. The unstarred command places an image, offset so that it rises above the paragraph, and also descends beneath the following text.
-
-\null\null
-
-In all of the above, the alignments will change, if you change the text size or lines per page.
-
-\clearpage
-
-
-% NEXT PAGE:
-
-This page tests \string\WrapImage. The command is written following the paragraph you are now reading.
-
-\WrapImage[r]{novel-testscript.jpg}
-
-The image will appear at right, with this text flowing around it. the first few lines will be at the left of the image. Then, as the paragraph continues, it eventually is restored to full text width, once it gets past the bottom of the image. Note that the top of the image is aligned to the X-height of the first line of text.
-
-\null
-\null
-
-\clearpage
-
-% NEXT 2 PAGES:
-
-This page, combined with the following page, test the detection mechanism for \string\scenebreak, \string\sceneline, and \string\scenestars.
-
-In the source document, there is \string\vspace\space following this paragraph. To detect the effects, vary the \string\vspace.
-
-% Change this to see the effects:
-\vspace{20\nbs} % originally 20\nbs
-
-Following this paragraph is the \string\scenestars\space command. It prints a few asterisks centered in a gap. It is one way to indicate that a scenbreak is present, when the break occurs at the very top or bottom of a page (because a blank line might not be noticed there).
-
-\scenestars
-
-If you change the above \string\vspace\space to 25\string\nbs, you will get a Warning about the line being too close to the bottom. Change to 28\string\nbs, and the Warning will say that it is too close to the top (of the following page. Note that \string\scenestars\space is allowed to be at the very bottom or very top, or somewhere in the middle of the page. The same applies to \string\sceneline.
-
-If you wish, you can always use \string\scenestars\space or \string\sceneline\space to indicate a scene break. But more common practice is to use a blank line, \string\scenebreak, except for those cases where you ``must'' use one of the others.
-
-\scenebreak
-
-Above this paragraph is \string\scenebreak, which appears as a blank line. A \string\scenebreak\space cannot be located close to the top or bottom of a page. Unlike \string\sceneline\space or \string\scenestars, you cannot place \string\scenebreak\space at the very top or bottom, either. So, changing the \string\vspace\space to any of 14\string\nbs\space through 17\string\nbs\space will generate a Warning.
-
-\clearpage
-
-
-% NEXT PAGE:
-
-This page tests the footnote and endnote capabilities.\footnote{This is the first sample footnote. Unless you change the marker style, it will be marked with an asterisk.} Two footnotes have been placed.\footnote{This is the second footnote. Unless you change the marker style, it will be marked by a dagger.}
-
-\null
-
-Test of \string\QuickChapter:
-
-
-\QuickChapter[3em]{Just Before Midnight}
-
-Above, \string\QuickChapter\space inserted two blank lines, in which a phrase is followed by a short line. The text is slightly larger than normal, and sits slightly above the normal baseline.
-
-\null
-
-There is a \string\bigemdash\space between here\makebox[2.5em]{\bigemdash}and here. Its length is set at 2.5em, using \string\makebox. Compare to normal—emdash. Thickness and yoffset is adjustable.
-
-\null
-
-This tests the endnote capability.\endnote You will see marker 1 after the last sentence, and marker 2 after this one.\endnote\memo{This text does not print.} But no actual endnotes are created. You may manually place them wherever you wish. For that, you may use the \string\endnotetext\space command (if its style works for you), or any other method.
-
-\null
-
-\endnotetext{1}{This tests the \string\endnotetext\space command, although you would not normally place the text of an endnote here. It is only a test.\par}
-
-\endnotetext{2}{Text for a second endnote.\par}
-
-\clearpage
-
-
-% NEXT PAGE:
-
-The following tests the \textit{parascale} environment:
-
-\begin{parascale}[0.8]
-But this text has a different scale than normal. Both the font size and the baseline skip have been proportionately changed. As a result, the lines are not on the normal line grid.\par
-If the following normal text needs to be back on grid (usually the case), here is what you must do: Compile, and note the number of lines occupied by the scaled text. Calculate the discrepancy, and fix with \string\vspace. Or let \textit{novel} do the thinking for you; there will be a Warning message with advice.\par
-\vspace{0.2\nbs} % based on result of Warning.
-\end{parascale}
-
-Back to normal text. At the dimensions originally used for this test, there are 9 lines of scaled text. Not counting the first scaled line, the remaining 8 scaled lines each introduce a deficit of 0.2\string\nbs. So, the cumulative deficit is 1.6\string\nbs. The integer part doesn't matter. So, \string\vspace{0.6\string\nbs} must be added prior to \string\end\{parascale\}, to restore the normal line grid.
-
-It is also possible to split the \string\vspace, prior to \string\begin\{parascale\} and \string\end\{parascale\}, as long as the total is correct.
-
-If the \string\vspace\space is not added, then there will be a Warning message.
-
-If the parascale spans more than one page, then the correct amount to add will depend on the lines present on the final page, not the total number of lines.
-
-\clearpage
-
-
-% NEXT PAGE
-
-This page tests the \textit{adjustwidth} environment. Changing textwidth is a useful way to create block indents, occasionally used for long quotations, or for other special text that must be visually distinguished from normal.
-
-\begin{adjustwidth}{2\normalparindent}{\normalparindent}
-\forceindent This text uses the \textit{adjustwidth} environment. It is set to block indent 2\string\normalparindent\space at left, and indent 1\string\normalparindent\space at right. The \string\forceindent\space command precedes the text, so that (within the block) it indents like an ordinary paragraph.\par
-\end{adjustwidth}
-
-This text is after the environment, so it occupies the normal amount of text width.
-
-\clearpage
-
-
-% NEXT PAGE:
-
-This tests various text effects:
-
-\null
-
-\FirstLine{\noindent\charscale[2]{T}\hspace{-2pt}his line has its first letter enlarged, and sets the first line in small caps. After the first line, text continues as usual. Note that space must be provided prior to this paragraph, so that the first letter does not intrude on text (or margin) above it.}
-
-The \string\charscale\space command scales the letter, and \string\FirstLine\space performs the small caps. Also, some kerning was applied so that the large T has the following \textsc{h} resting beneath its top. The \string\noindent\space command goes inside \string\FirstLine.
-
-\null\null
-
-\dropcap{H}ere is placed is a drop cap, using \textit{novel's} \string\dropcap\space command. Alternatively, the \textit{lettrine} package could be used. There are differences in how the drop caps are specified, depending on what you do. So, be sure to read the documentation, or you will be surprised.\par
-In general, it is difficult to style drop caps so that they look good for many different letters. An alternative is to use images for the drop caps. If you use images, please read the \textit{novel} documentation, as the method is not the same as the usual methods from the \textsc{lettrine} package.\par
-Note that there is no automated way to combine a drop cap with a first line in small caps. This is discussed in \textsc{novel} documentation.
-
-\null
-This line is in the main font.\par
-\textsf{This line is in the sans font.}\par
-\texttt{This line is in the mono font.}\par
-{\mustbelibertinus This line is in Libertinus Serif.}\par % specific to testsuite
-{\mustbelmodern This line is in Latin Modern Roman.}\par % specific to testsuite
-
-
-\clearpage
-
-
-% NEXT PAGE:
-
-\thispagestyle{dropfoliobeneath} % compare to dropfolioinside
-
-This page tests drop folio. There will be no page header. If your head/foot style normally has a footer, then you will see it as usual.
-
-If you choose a head/foot style without footer, you will still see a page number centered below. Exactly where it appears will depend on which kind of drop folio is used.
-
-If using \string\thispagestyle\{dropfoliobeneath\} then the page number will appear within the lower margin.
-
-If using \string\thispagestyle\{dropfolioinside\} then the page number will appear just above the lower margin, where the final line of text would otherwise be placed.
-
-Use class options [draft,shademargins] to see the position.
-
-The initial choice is \textit{dropfoliobeneath}.
-
-\clearpage
-
-% NEXT PAGE:
-
-This tests the \string\cleartoend\space command. If this page is recto (odd), then exactly one blank page will follow. If this page is verso (even), then exactly two blank pages will follow.
-
-\null\null
-
-
-When you request PDF/X (default), whether or not you are in draft mode, each image placed in your document is inspected. This is one of those things that require Lua code, which is one reason why the \textit{novel} class requires LuaLaTeX only.
-
-When an image is inspected, it is added to one of two lists, either good or unknown. Each time an image is requested, the lists are examined, so the same image file is not inspected twice. This saves time.
-
-The lists are saved in the \textit{aux} file. Then, if you re-compile, images already inspected won't be re-inspected. To re-initialize the lists, discard the \textit{aux} file.
-
-\null
-
-Two of the images were pre-processed via \textit{novel-scripts}. These will be detected as good. They are:
-
-\makeatletter\@AllGoodImages\makeatother
-
-\null
-
-Two of the images were not pre-processed, so their compliance is unknown. They might be good or bad. They are:
-
- \makeatletter\@UnknownImages\makeatother
-
-\null
-
-Note: If you change the document settings to \string\SetPDFX\{off\} then you will not see either of the image lists, and will not get the Warning message.
-
-Also, using \string\SetPDFX\{off\} will re-initialize the lists.
-
-
-
-\end{document}
-
Deleted: trunk/Master/texmf-dist/doc/lualatex/novel/needed-packages
===================================================================
--- trunk/Master/texmf-dist/doc/lualatex/novel/needed-packages 2024-02-01 21:05:56 UTC (rev 69657)
+++ trunk/Master/texmf-dist/doc/lualatex/novel/needed-packages 2024-02-01 21:06:11 UTC (rev 69658)
@@ -1,11 +0,0 @@
-
-To use `novel' you need LaTeX with lualatex.
-
-In addition to the minimal setup, you will need these packages:
-
-textpos magaz xcolor adjustbox eso-pic pdfpages unicode-math fp iftex
-libertinus-fonts makecmds xkeyval lm-math xstring xifthen silence
-collectbox pgf lipsum wrapfig pdflscape polyglossia microtype hyperref
-
-You will need language support, for your language(s).
-If using lipsum, you will need hyphen-latin.
\ No newline at end of file
Modified: trunk/Master/texmf-dist/doc/lualatex/novel/novel-documentation.html
===================================================================
--- trunk/Master/texmf-dist/doc/lualatex/novel/novel-documentation.html 2024-02-01 21:05:56 UTC (rev 69657)
+++ trunk/Master/texmf-dist/doc/lualatex/novel/novel-documentation.html 2024-02-01 21:06:11 UTC (rev 69658)
@@ -14,7 +14,10 @@
<style>
-body {font-family:sans-serif; line-height:150%; font-size:14pt; color:#000000; background:#ffffff none;}
+body {font-family:sans-serif; color:#203310; background:#cccccc none;}
+#master {position:relative;}
+#toc {position:fixed; width:30%; background:#ffffff none; overflow:scroll; height:98%; float:left;}
+#main {width:68%; float:right; background:#ffffff none;}
p {font-family:sans-serif,sans-serif; font-size:1em; margin:0px 16px 0px 16px; text-indent:16px;}
ol, ul {list-style-type:none; margin:0px; padding:0px;}
li {margin:3px 8px 3px 16px; padding:0px;}
@@ -32,13 +35,19 @@
img.openclose {display:none; height:1em;}
*.noimg {padding-left:1.5em;}
div.d1 {margin:0px 16px 16px 16px;}
-div.d2 {margin:0px 0px 16px 16px; padding-bottom:1em; border-top:0; border-right: 0px; border-bottom:1px dotted #666666; border-left:1px dotted #666666;}
-div.d3 {margin:0px 0px 16px 16px; padding-bottom:1em; border-top:0; border-right: 0px; border-bottom:1px dotted #666666; border-left:1px dotted #666666;}
-div.d4 {margin:0px 0px 16px 16px; padding-bottom:1em; border-top:0; border-right: 0px; border-bottom:1px dotted #666666; border-left:1px dotted #666666;}
-div.d5 {margin:0px 0px 16px 16px; padding-bottom:1em; border-top:0; border-right: 0px; border-bottom:1px dotted #666666; border-left:1px dotted #666666;}
-div.d6 {margin:0px 0px 16px 16px; padding-bottom:1em; border-top:0; border-right: 0px; border-bottom:1px dotted #666666; border-left:1px dotted #666666;}
+div.d2 {margin:0px 0px 16px 16px; padding-bottom:1em; border-top:0; border-right: 0px;
+border-bottom:1px dotted #666666; border-left:1px dotted #666666;}
+div.d3 {margin:0px 0px 16px 16px; padding-bottom:1em; border-top:0; border-right: 0px;
+border-bottom:1px dotted #666666; border-left:1px dotted #666666;}
+div.d4 {margin:0px 0px 16px 16px; padding-bottom:1em; border-top:0; border-right: 0px;
+border-bottom:1px dotted #666666; border-left:1px dotted #666666;}
+div.d5 {margin:0px 0px 16px 16px; padding-bottom:1em; border-top:0; border-right: 0px;
+border-bottom:1px dotted #666666; border-left:1px dotted #666666;}
+div.d6 {margin:0px 0px 16px 16px; padding-bottom:1em; border-top:0; border-right: 0px;
+border-bottom:1px dotted #666666; border-left:1px dotted #666666;}
div.page {padding:16px 0px 16px 0px; border-top:4px solid #505050;}
div.codeblock {overflow:auto; margin:16px; padding: 8px; border: 1px solid #000000;}
+div.codeblock p {text-indent:0px; white-space:nowrap;}
code {font-size:1em; font-family:monospace,monospace; color:#200050; background:transparent none; padding:0px 3px 0px 3px;}
*.smaller {font-weight:normal; font-size:88%;}
*.noindent {text-indent:0px;}
@@ -47,7 +56,8 @@
*.noindentcmd {text-indent:0px; margin-top:16px;}
*.isolate {padding-left:10px;margin-top:10px; margin-bottom:10px; text-indent:0px;}
*.dbloc {padding-left:1.8em; visibility:hidden}
-table.preconf {margin-left:auto; margin-right:auto; margin-top:20px; margin-bottom:20px; border:1px solid #000000}
+table.preconf {margin-left:auto; margin-right:auto; margin-top:20px; margin-bottom:20px;
+border:1px solid #000000}
table.preconf caption {font-weight:bold;}
table.preconf th {text-align:left; padding:6px; font-weight:normal; border-bottom:1px solid #000000;}
table.preconf td {text-align:left; padding:6px;}
@@ -58,7 +68,6 @@
small {line-height:50%;}
span.ap {color: #996633;} /* percent comment in code */
*.floatright {float:right; margin-left:1em; margin-right:16px;}
-*.n {display:none; border:1px solid #990000; font-family:monospace,monospace; font-size:0.92em; font-weight:bold; padding: 0 0.3em 0 0.3em; color:#990000; background: #ffdddd none; margin-right:0.5em;}
p.centerimg {text-indent:0px; text-align:center; margin-top:0.5em; margin-bottom:0.5em;}
p.code {text-indent:0px; margin: 4px 16px 4px 16px; padding-left:32px;}
p.item {text-indent:0px; padding-top:8px;}
@@ -67,115 +76,22 @@
p.overhang {margin-left:32px; text-indent:-16px;}
*.sampledoc {margin:1em}
*.sampledoc em {font-size:92%; color:#666666}
-#master {position:relative;}
-#finish {clear:both;}
-#toc {display:block;}
-#toc li ul li {display:none;}
-#main {width:auto; float:none; background:#ffffff none;}
-*.noshowprint {display:none;}
-div.codeblock p {text-indent:0px;}
-*.screennoscript {display:none;}
</style>
-<style id="screenstyle">
- at media screen {
- body {color:#203310; background:#cccccc none;}
- #toc {display:block; font-size:14pt; width:30%; background:#ffffff none; position:fixed; overflow:scroll; height:98%;}
- #toc li ul li {display:block;}
- #main {float:right; background:#ffffff none; width:68%; padding-bottom:40px;}
- div.codeblock p {text-indent:0px; white-space:nowrap;}
- *.screennoscript {display:inline;}
- *.toptitle {display:none;}
-}
-</style>
-<script>var doprint=false;</script>
-
-
-<!-- Trouble Printing? Remove the following line, and another one below: -->
-<!-- REMOVE ME
-
-<style>
- body {color:#000000; background:#ffffff none;}
- #toc {display:block; font-size:1em; width:auto; background:#ffffff none; position:static; overflow:auto; height:auto;}
- #toc li ul li {display:none;}
- #main {float:none; background:#ffffff none; width:auto; padding-bottom:0;}
- div.codeblock p {text-indent:0px; white-space:auto;}
- *.screennoscript {display:none;}
- *.toptitle {display:block;}
- *.notprinted {display:none;}
-</style>
-<script>doprint=true;</script>
-
-REMOVE ME TOO -->
-<!-- Also remove the above line, if trouble printing. Then load with JavaScript off. -->
-
-
-<script>
-if(!doprint) {window.onload = loadnav;}
-function loadnav() {
- nspans = document.getElementsByClassName("n");
- placenav();
-}
-function placenav(){
- for(var n=0; nspans.length>n; n++){
- nspans[n].style.display="inline";
- nspans[n].style.cursor="pointer";
- nspans[n].title="open";
- nspans[n].setAttribute("data-state",0);
- nspans[n].innerHTML="+";
- nspans[n].onclick=openclose;
- lstartclose(n);
- }
-}
-function lstartclose(whichn) {
- whichparid = nspans[whichn].parentElement.id;
- whichdiv = document.getElementById("u" + whichparid.substring(1));
- if(whichdiv) whichdiv.style.display="none";
-}
-function openclose(){
- thisparid = this.parentElement.id;
- thisdiv = document.getElementById("u" + thisparid.substring(1));
- if(this.title=="close") {thisdiv.style.display="none";}
- if(this.title=="open") {thisdiv.style.display="block";}
- thisstate = this.getAttribute("data-state");
- thisval = 1 - thisstate;
- this.setAttribute("data-state",thisval);
- if(this.getAttribute("data-state")=="1") {this.title="close"; this.innerHTML="–";}
- if(this.getAttribute("data-state")=="0") {this.title="open"; this.innerHTML="+";}
-}
-function openall() {
- for(var n=0; nspans.length>n; n++){
- nspans[n].setAttribute("data-state",1);
- nspans[n].title="close";
- nspans[n].innerHTML="–";
- thisparid = nspans[n].parentElement.id;
- thisdiv = document.getElementById("u" + thisparid.substring(1));
- thisdiv.style.display="block";
- }
-}
-function closeall() {
- placenav();
-}
-</script>
-
</head>
<body>
<div id="master">
-
<div id="toc" class="toc">
-<h1 class="toptitle">Document class <em>novel</em> - Documentation</h1>
-<h3 class="noshowprint"><a href="#main">Contents</a> <span class="smaller"><a href="javascript:openall();">(open all)</a> <a href="javascript:closeall();">(close all)</a></span></h3>
+<h3><a href="#main">Contents</a></h3>
<ul><!-- master toc ul -->
- <li id="l0"><a href="#h0"><b>“Novel” Document Class</b></a></li>
-
- <li id="l1"><span class="n"></span><a href="#h1"><b>1. Before You Begin</b></a>
+ <li id="l1"><a href="#h1"><b>1. Before You Begin</b></a>
<ul id="u1">
- <li id="l1.1"><span class="n"></span><a href="#h1.1">1.1 Do These Things</a>
+ <li id="l1.1"><a href="#h1.1">1.1 Do These Things</a>
<ul id="u1.1">
<li><a href="#h1.1.1">1.1.1 LuaLateX Compiler</a></li>
<li><a href="#h1.1.2">1.1.2 UTF-8 Encoding</a></li>
@@ -184,7 +100,7 @@
<li><a href="#h1.1.5">1.1.5 Book Design</a></li>
</ul>
</li><!-- end 1.1 -->
- <li id="l1.2"><span class="n"></span><a href="#h1.2">1.2 Avoid These Things</a>
+ <li id="l1.2"><a href="#h1.2">1.2 Avoid These Things</a>
<ul id="u1.2">
<li><a href="#h1.2.1">1.2.1 Non-Fontspec Font Loader</a></li>
<li><a href="#h1.2.2">1.2.2 TeX Font Sizes</a></li>
@@ -192,7 +108,7 @@
<li><a href="#h1.2.4">1.2.4 TeX Editors and IDEs</a></li>
</ul>
</li><!-- end 1.2 -->
- <li id="l1.3"><span class="n"></span><a href="#h1.3">1.3 Beware of These Things</a>
+ <li id="l1.3"><a href="#h1.3">1.3 Beware of These Things</a>
<ul id="u1.3">
<li><a href="#h1.3.1">1.3.1 TeX Special Characters</a></li>
<li><a href="#h1.3.2">1.3.2 Layout Surprises</a></li>
@@ -201,7 +117,7 @@
</ul>
</li><!-- end 1 -->
- <li id="l2"><span class="n"></span><a href="#h2"><b>2. Document Class Options</b></a>
+ <li id="l2"><a href="#h2"><b>2. Document Class Options</b></a>
<ul id="u2">
<li><a href="#h2.1">2.1 draft</a></li>
<li><a href="#h2.2">2.2 sandbox</a></li>
@@ -210,15 +126,15 @@
<li><a href="#h2.5">2.5 cropview</a></li>
<li><a href="#h2.6">2.6 closecrop</a></li>
<li><a href="#h2.7">2.7 xml</a></li>
- <li><a href="#h2.8">2.8 coverart</a></li>
+ <li><a href="#h2.8">2.8 coverart (deprecated)</a></li>
<li><a href="#h2.9">2.9 developer options</a></li>
<li><a href="#h2.10">2.10 revert</a></li>
</ul>
</li><!-- end 2 -->
- <li id="l3"><span class="n"></span><a href="#h3"><b>3. Metadata, File Data, PDF/X</b></a>
+ <li id="l3"><a href="#h3"><b>3. Metadata, File Data, PDF/X</b></a>
<ul id="u3">
- <li id="l3.1"><span class="n"></span><a href="#h3.1">3.1 Definitions of Terms</a>
+ <li id="l3.1"><a href="#h3.1">3.1 Definitions of Terms</a>
<ul id="u3.1">
<li><a href="#h3.1.1">3.1.1 ISBN Metadata</a></li>
<li><a href="#h3.1.2">3.1.2 Printed Metadata</a></li>
@@ -225,7 +141,7 @@
<li><a href="#h3.1.3">3.1.3 File (PDF) Metadata</a></li>
</ul>
</li><!-- end 3.1 -->
- <li id="l3.2"><span class="n"></span><a href="#h3.2">3.2 Rules for File Data</a>
+ <li id="l3.2"><a href="#h3.2">3.2 Rules for File Data</a>
<ul id="u3.2">
<li><a href="#h3.2.1">3.2.1 Required, Prohibited?</a></li>
<li><a href="#h3.2.2">3.2.2 Limited to Latin-1?</a></li>
@@ -233,7 +149,7 @@
<li><a href="#h3.2.4">3.2.4 Forbidden Characters</a></li>
</ul>
</li><!-- end 3.2 -->
- <li id="l3.3"><span class="n"></span><a href="#h3.3">3.3 File Data Commands</a>
+ <li id="l3.3"><a href="#h3.3">3.3 File Data Commands</a>
<ul id="u3.3">
<li><a href="#h3.3.1">3.3.1 \SetTitle</a></li>
<li><a href="#h3.3.2">3.3.2 \SetAuthor</a></li>
@@ -241,7 +157,7 @@
<li><a href="#h3.3.4">3.3.4 \SetApplication, \SetProducer</a></li>
</ul>
</li><!-- end 3.3 -->
- <li id="l3.4"><span class="n"></span><a href="#h3.4">3.4 PDF/X</a>
+ <li id="l3.4"><a href="#h3.4">3.4 PDF/X</a>
<ul id="u3.4">
<li><a href="#h3.4.1">3.4.1 Compliance Standards</a></li>
<li><a href="#h3.4.2">3.4.2 Output Intents</a></li>
@@ -254,15 +170,15 @@
</ul>
</li><!-- end 3 -->
- <li id="l4"><span class="n"></span><a href="#h4"><b>4. Book Size, Page Layout, Fonts</b></a>
+ <li id="l4"><a href="#h4"><b>4. Book Size, Page Layout, Fonts</b></a>
<ul id="u4">
- <li id="l4.1"><span class="n"></span><a href="#h4.1">4.1 Book Dimensions</a>
+ <li id="l4.1"><a href="#h4.1">4.1 Book Dimensions</a>
<ul id="u4.1">
<li><a href="#h4.1.1">4.1.1 Trim Size, TrimBox</a></li>
<li><a href="#h4.1.2">4.1.2 Media Size, MediaBox</a></li>
</ul>
</li><!-- end 4.1 -->
- <li id="l4.2"><span class="n"></span><a href="#h4.2">4.2 Fonts, Normal Font Size</a>
+ <li id="l4.2"><a href="#h4.2">4.2 Fonts, Normal Font Size</a>
<ul id="u4.2">
<li><a href="#h4.2.1">4.2.1 Parent (Main) Font, Size</a>
<ul id="u4.2.1">
@@ -276,7 +192,7 @@
<li><a href="#h4.2.5">4.2.5 Advanced: New Fonts</a></li>
</ul>
</li><!-- end 4.2 -->
- <li id="l4.3"><span class="n"></span><a href="#h4.3">4.3 Interior Page Layout</a>
+ <li id="l4.3"><a href="#h4.3">4.3 Interior Page Layout</a>
<ul id="u4.3">
<li><a href="#h4.3.1">4.3.1 Margins</a>
<ul id="u4.3.1">
@@ -312,9 +228,9 @@
</ul>
</li><!-- end 4 -->
- <li id="l5"><span class="n"></span><a href="#h5"><b>5. Chapter Structure</b></a>
+ <li id="l5"><a href="#h5"><b>5. Chapter Structure</b></a>
<ul id="u5">
- <li id="l5.1"><span class="n"></span><a href="#h5.1">5.1 Starting a Chapter</a>
+ <li id="l5.1"><a href="#h5.1">5.1 Starting a Chapter</a>
<ul id="u5.1">
<li><a href="#h5.1.1">5.1.1 \clearpage, \cleartorecto</a></li>
<li><a href="#h5.1.2">5.1.2 ChapterStart Environment</a>
@@ -340,20 +256,20 @@
</li>
</ul>
</li><!-- end 5.1 -->
- <li id="l5.2"><span class="n"></span><a href="#h5.2">5.2 Continuous Chapters</a>
+ <li id="l5.2"><a href="#h5.2">5.2 Continuous Chapters</a>
<ul id="u5.2">
<li><a href="#h5.2.1">5.2.1 Short ChapterStart</a></li>
<li><a href="#h5.2.2">5.2.2 \QuickChapter</a></li>
</ul>
</li><!-- end 5.2 -->
- <li id="l5.3"><span class="n"></span><a href="#h5.3">5.3 Scene Breaks</a>
+ <li id="l5.3"><a href="#h5.3">5.3 Scene Breaks</a>
<ul id="u5.3">
<li><a href="#h5.3.1">5.3.1 \SetScenebreakIndent</a></li>
</ul>
</li><!-- end 5.3 -->
- <li id="l5.4"><span class="n" style="visibility:hidden"></span><a href="#h5.4">5.4 Chapter Numbering</a>
+ <li id="l5.4"><a href="#h5.4">5.4 Chapter Numbering</a>
</li><!-- end 5.4 -->
- <li id="l5.5"><span class="n"></span><a href="#h5.5">5.5 First Lines</a>
+ <li id="l5.5"><a href="#h5.5">5.5 First Lines</a>
<ul id="u5.5">
<li><a href="#h5.5.1">5.5.1 First Character Special</a></li>
<li><a href="#h5.5.2">5.5.2 First Line Small Caps</a></li>
@@ -363,9 +279,9 @@
</ul>
</li><!-- end 5 -->
- <li id="l6"><span class="n"></span><a href="#h6"><b>6. Text Size, Style, Position</b></a>
+ <li id="l6"><a href="#h6"><b>6. Text Size, Style, Position</b></a>
<ul id="u6">
- <li id="l6.1"><span class="n"></span><a href="#h6.1">6.1 Text Sizes</a>
+ <li id="l6.1"><a href="#h6.1">6.1 Text Sizes</a>
<ul id="u6.1">
<li><a href="#h6.1.1">6.1.1 Standard Sizes: Disabled!</a></li>
<li><a href="#h6.1.2">6.1.2 Local sizing: \charscale</a></li>
@@ -373,7 +289,7 @@
<li><a href="#h6.1.4">6.1.4 Open Type Scale</a></li>
</ul>
</li><!-- end 6.1 -->
- <li id="l6.2"><span class="n"></span><a href="#h6.2">6.2 General Styling</a>
+ <li id="l6.2"><a href="#h6.2">6.2 General Styling</a>
<ul id="u6.2">
<li><a href="#h6.2.1">6.2.1 Italics and Emphasis</a></li>
<li><a href="#h6.2.2">6.2.2 Bold and Semibold</a></li>
@@ -385,13 +301,13 @@
<li><a href="#h6.2.8">6.2.8 Grayscale Text</a></li>
</ul>
</li><!-- end 6.2 -->
- <li id="l6.3"><span class="n"></span><a href="#h6.3">6.3 Positioning and Alignment</a>
+ <li id="l6.3"><a href="#h6.3">6.3 Positioning and Alignment</a>
<ul id="u6.3">
<li><a href="#h6.3.1">6.3.1 What to Avoid</a></li>
<li><a href="#h6.3.2">6.3.2 Some Useful Commands</a></li>
</ul>
</li><!-- end 6.3 -->
- <li id="l6.4"><span class="n"></span><a href="#h6.4">6.4 Superscripts, Subscripts</a>
+ <li id="l6.4"><a href="#h6.4">6.4 Superscripts, Subscripts</a>
<ul id="u6.4">
<li><a href="#h6.4.1">6.4.1 Global Marker Style</a></li>
<li><a href="#h6.4.2">6.4.2 Local Real or Fake</a></li>
@@ -400,15 +316,15 @@
</ul>
</li><!-- end 6 -->
- <li id="l7"><span class="n"></span><a href="#h7"><b>7. Images, Pictures, Drawings</b></a>
+ <li id="l7"><a href="#h7"><b>7. Images, Pictures, Drawings</b></a>
<ul id="u7">
- <li id="l7.1"><span class="n"></span><a href="#h7.1">7.1 Technical Requirements</a>
+ <li id="l7.1"><a href="#h7.1">7.1 Technical Requirements</a>
<ul id="u7.1">
<li><a href="#h7.1.1">7.1.1 Interior B/W, Grayscale</a></li>
<li><a href="#h7.1.2">7.1.2 Color Cover</a></li>
</ul>
</li><!-- end 7.1 -->
- <li id="l7.2"><span class="n"></span><a href="#h7.2">7.2 Placing Interior Images</a>
+ <li id="l7.2"><a href="#h7.2">7.2 Placing Interior Images</a>
<ul id="u7.2">
<li><a href="#h7.2.1">7.2.1 Image-Like Text</a></li>
<li><a href="#h7.2.2">7.2.2 \InlineImage</a></li>
@@ -420,9 +336,9 @@
</ul>
</li><!-- end 7 -->
- <li id="l8"><span class="n"></span><a href="#h8"><b>8. Tables, Lists</b></a>
+ <li id="l8"><a href="#h8"><b>8. Tables, Lists</b></a>
<ul id="u8">
- <li id="l8.1"><span class="n"></span><a href="#h8.1">8.1 The toc Environment</a>
+ <li id="l8.1"><a href="#h8.1">8.1 The toc Environment</a>
<ul id="u8.1">
<li><a href="#h8.1.1">8.1.1 Entries Using \tocitem</a></li>
<li><a href="#h8.1.2">8.1.2 Example Table</a></li>
@@ -431,10 +347,10 @@
</ul>
</li>
- <li id="l9"><span class="n"></span><a href="#h9"><b>9. Footnotes, Endnotes</b></a>
+ <li id="l9"><a href="#h9"><b>9. Footnotes, Endnotes</b></a>
<ul id="u9">
- <li id="l9.1"><span class="n" style="visibility:hidden"></span><a href="#h9.1">9.1 Footnotes</a></li>
- <li id="l9.2"><span class="n"></span><a href="#h9.2">9.2 Endnotes</a>
+ <li id="l9.1"><a href="#h9.1">9.1 Footnotes</a></li>
+ <li id="l9.2"><a href="#h9.2">9.2 Endnotes</a>
<ul id="u9.2">
<li><a href="#h9.2.1">9.2.1 Placing: \endnote</a></li>
<li><a href="#h9.2.2">9.2.2 Writing: \endnotetext</a></li>
@@ -447,10 +363,10 @@
<li><i>Appendices:</i></li>
- <li id="lA"><span class="n" style="visibility:hidden"></span><a href="#hA"><b>A. Sample Document</b></a>
+ <li id="lA"><a href="#hA"><b>A. Sample Document</b></a>
</li><!-- end A -->
- <li id="lB"><span class="n"></span><a href="#hB"><b>B. Six-Page Front Matter</b></a>
+ <li id="lB"><a href="#hB"><b>B. Six-Page Front Matter</b></a>
<ul id="uB">
<li><a href="#hB.1">B.1 Half-Title to Copyright</a></li>
<li><a href="#hB.2">B.2 Post-Copyright</a></li>
@@ -457,7 +373,7 @@
</ul>
</li><!-- end B -->
- <li id="lC"><span class="n"></span><a href="#hC"><b>C. Shopping for Fonts</b></a>
+ <li id="lC"><a href="#hC"><b>C. Shopping for Fonts</b></a>
<ul id="uC">
<li><a href="#hC.1">C.1 Licensing Issues</a></li>
<li><a href="#hC.2">C.2 Technical Issues</a></li>
@@ -465,9 +381,9 @@
</ul>
</li><!-- end C -->
- <li id="lD"><span class="n"></span><a href="#hD"><b>D. Book Design</b></a>
+ <li id="lD"><a href="#hD"><b>D. Book Design</b></a>
<ul id="uD">
- <li id="lD.1"><span class="n"></span><a href="#hD.1">D.1 Terminology</a>
+ <li id="lD.1"><a href="#hD.1">D.1 Terminology</a>
<ul id="uD.1">
<li><a href="#hD.1.1">D.1.1 Sheet, Page, Leaf</a></li>
<li><a href="#hD.1.2">D.1.2 Folio, Spine</a></li>
@@ -474,7 +390,7 @@
<li><a href="#hD.1.3">D.1.3 Signature, Imposition</a></li>
</ul>
</li><!-- end D.1 -->
- <li id="lD.2"><span class="n"></span><a href="#hD.2">D.2 Book Manufacture</a>
+ <li id="lD.2"><a href="#hD.2">D.2 Book Manufacture</a>
<ul id="uD.2">
<li><a href="#hD.2.1">D.2.1 Perfect Binding</a></li>
<li><a href="#hD.2.2">D.2.2 Library Binding</a></li>
@@ -482,15 +398,15 @@
<li><a href="#hD.2.4">D.2.4 Paper, Cover Materials</a></li>
</ul>
</li><!-- end D.2 -->
- <li id="lD.3"><span class="n"></span><a href="#hD.3">D.3 Interior Structure</a>
+ <li id="lD.3"><a href="#hD.3">D.3 Interior Structure</a>
<ul id="uD.3">
- <li id="lD.3.1"><span class="n"></span><a href="#hD.3.1">D.3.1 Display, Chapter-Like</a>
+ <li id="lD.3.1"><a href="#hD.3.1">D.3.1 Display, Chapter-Like</a>
<ul id="uD.3.1">
<li><a href="#hD.3.1.1">D.3.1.1 Display Pages</a></li>
<li><a href="#hD.3.1.2">D.3.1.2 Chapter-Like Sections</a></li>
</ul>
</li>
- <li id="lD.3.2"><span class="n"></span><a href="#hD.3.2">D.3.2 Front Matter</a>
+ <li id="lD.3.2"><a href="#hD.3.2">D.3.2 Front Matter</a>
<ul id="uD.3.2">
<li><a href="#hD.3.2.1">D.3.2.1 Half-Title, i</a></li>
<li><a href="#hD.3.2.2">D.3.2.2 Blank, ii</a></li>
@@ -507,7 +423,7 @@
<li><a href="#hD.3.2.13">D.3.2.13 End of Front Matter</a></li>
</ul>
</li>
- <li id="lD.3.3"><span class="n"></span><a href="#hD.3.3">D.3.3 Main Matter</a>
+ <li id="lD.3.3"><a href="#hD.3.3">D.3.3 Main Matter</a>
<ul id="uD.3.3">
<li><a href="#hD.3.3.1">D.3.3.1 Half-Title in Main</a></li>
<li><a href="#hD.3.3.2">D.3.3.2 Part Separator</a></li>
@@ -518,7 +434,7 @@
<li><a href="#hD.3.3.7">D.3.3.7 End Notes, Appendix</a></li>
</ul>
</li>
- <li id="lD.3.4"><span class="n"></span><a href="#hD.3.4">D.3.4 At the End</a>
+ <li id="lD.3.4"><a href="#hD.3.4">D.3.4 At the End</a>
<ul id="uD.3.4">
<li><a href="#hD.3.4.1">D.3.4.1 Back Matter? Not!</a></li>
<li><a href="#hD.3.4.2">D.3.4.2 About the Author</a></li>
@@ -529,14 +445,14 @@
</ul>
</li><!-- end D -->
- <li id="lE"><span class="n"></span><a href="#hE"><b>E. Fontspec Syntax</b></a>
+ <li id="lE"><a href="#hE"><b>E. Fontspec Syntax</b></a>
<ul id="uE">
- <li id="lE.1"><span class="n"></span><a href="#hE.1">E.1 Family vs. File Name</a>
+ <li id="lE.1"><a href="#hE.1">E.1 Family vs. File Name</a>
<ul id="uE.1">
<li><a href="#hE.1.1">E.1.1 Set/New by Name</a></li>
</ul>
</li>
- <li id="lE.2"><span class="n"></span><a href="#hE.2">E.2 Open Type Features</a>
+ <li id="lE.2"><a href="#hE.2">E.2 Open Type Features</a>
<ul id="uE.2">
<li><a href="#hE.2.1">E.2.1 Scale Pseudo-Feature</a></li>
<li><a href="#hE.2.2">E.2.2 Color and Opacity</a></li>
@@ -547,7 +463,7 @@
</ul>
</li><!-- end E -->
- <li id="lF"><span class="n"></span><a href="#hF"><b>F. Drop Caps</b></a>
+ <li id="lF"><a href="#hF"><b>F. Drop Caps</b></a>
<ul id="uF">
<li><a href="#hF.1">F.1 Built-In vs Lettrine</a></li>
<li><a href="#hF.2">F.2 \dropcap[]{}</a></li>
@@ -557,10 +473,10 @@
</ul>
</li><!-- end F -->
- <li id="lY"><span class="n" style="visibility:hidden"></span><a href="#hY"><b>Y. Licensing and Credits</b></a>
+ <li id="lY"><a href="#hY"><b>Y. Licensing and Credits</b></a>
</li><!-- end Y -->
- <li id="lZ"><span class="n" style="visibility:hidden"></span><a href="#hZ"><b>Z. Important Changes</b></a>
+ <li id="lZ"><a href="#hZ"><b>Z. Important Changes</b></a>
</li><!-- end Z -->
</ul><!-- end master toc ul -->
@@ -575,13 +491,14 @@
<div id="main">
<!-- **************************************************************************************** -->
-<h1 id="h0" style="padding-top:16px">Document class <i>novel</i> - documentation. <span style="font-size:75%">V. 1.83, 2023/11/09</span></h1>
-<p class="noindent"><span id="screennoscript" class="screennoscript"><b>For enhanced navigation of this file, turn on JavaScript.</b></span></p>
-<div><script>if(document.getElementById("screennoscript")){document.getElementById("screennoscript").style.display="none";}</script></div>
+<h1 id="h0" style="padding-top:16px">Document class <i>novel</i> - documentation.</h1>
+<p>V. 1.86, 2024/01/31</p>
-<p class="item">ALERT: If you have been using this document class prior to version 1.80 (February 2023), see <a href="#hZ">Appendix Z</a>.</p>
+<p class="item">ALERT: If you have been using this document class prior to version 1.80 (February 2023),
+see <a href="#hZ">Appendix Z</a>.</p>
-<p class="item">ALERT: New user? Little knowledge of LaTeX? Try the simpler "novelette" document class. Expected in March, 2023.</p>
+<p class="item">ALERT: New user? Little knowledge of LaTeX? Try the simpler "novelette" document class.
+Expected in early 2024.</p>
<!-- ********************************************************************** -->
<div id="page01" class="page">
@@ -588,10 +505,8 @@
<p class="noindent">The <i>novel</i> document class is for authors of text-intensive original fiction, such as detective novels, murder mysteries, romance, sci-fi, and collections of short stories. Academic works and graphic novels are excluded.</p>
<p>The resulting PDF uses built-in technology to produce PDF/X compliant files for print-on-demand (P.O.D.) services. There is no capability for E-books, and never will be.</p>
-<p>To use <i>novel</i>, you need TeXLive 2016 or later, or recent MikTeX. Open your TeX package manager, and install both <i>novel</i> and <i>libertinus-fonts</i>.</p>
+<p>To use <i>novel</i>, you need TeXLive 2020 or later, or recent MikTeX. Open your TeX package manager, and install both <i>novel</i> and <i>libertinus-fonts</i>.</p>
-<p><b>New in version 1.82:</b> Preamble command <code>\myparindent{length}</code>
-will over-ride the default 1.5em as normal indent. Version 1.83: Minor typo corrected.</p>
<h2 id="h1">1. Before You Begin</h2>
<div class="d2" id="d1">
@@ -621,17 +536,9 @@
<p class="item"><b>C.</b> If you are on Windows, <i>do not</i> use Notepad! The free <a class="external" rel="external" target="new" href="https://notepad-plus-plus.org">Notepad++</a> (also <a class="external" rel="external" target="new" href="https://portableapps.com/apps/development/notepadpp_portable">Portable</a> version) is a suitable plain text editor. Configure it as specified, with utf-8 but without BOM. Does not matter whether UNIX or DOS line endings, as long as you are consistent.</p>
</div><!-- end 1.1.2 -->
-<h4 id="h1.1.3">1.1.3. Language Support</h4>
+<h4 id="h1.1.3">1.1.3. News (changed in version 1.86)</h4>
<div class="d4" id="d1.1.3">
-<p class="item"><b>A.</b> The <i>polyglossia</i> package is loaded automatically. Do not load it yourself.</p>
-<p class="item"><b>B.</b> Language is loaded like this default:</p>
-<p class="code"><code>\setdefaultlanguage[variant=american]{english}</code></p>
-<p class="item"><b>C.</b> For other possibilities, see polyglossia documentation.</p>
-<p class="item"><b>D.</b> Polyglossia does not always load language hyphenation patterns.
-If it does not, be sure that your system has the hyphenation patterns for your language or languages.
-For example, <code>hyphen-latin</code> is used when you insert <code>lipsum</code> text.
-And, you may need to use the polyglossia <code>\setotherlanguage</code> if extended text
-is not your default.</p>
+<p class="item">The package PDF has been updated.</p>
</div><!-- end 1.1.3 -->
<h4 id="h1.1.4">1.1.4. Use Open Type Fonts</h4>
@@ -798,9 +705,12 @@
<p class="item" style="position:relative"><b>D.</b> <img src="html-resources/info18.png" width="18" height="18" style="position:relative; bottom:-3px" title="tech info" alt="tech info"/> Technical Info: XMP packet may be isolated by editing the *.xml file, in a plain text editor (requires utf-8). Necessary edits are obvious.</p>
</div><!-- end 2.7 -->
-<h3 id="h2.8">2.8. coverart</h3>
+<h3 id="h2.8">2.8. coverart (deprecated)</h3>
<div class="d3" id="d2.8">
-<p class="item">This option is only used for cover artwork. See <a href="#h7.1.2">section 7.1.2</a>.</p>
+<p class="item">This option is only used for cover artwork. However, in the intervening time
+since <i>novel</i> was first introduced, the printing technology has evolved.
+Now (late 2023) using <i>novel</i> technology is not the best way to produce
+your book cover file, although it still works. See <a href="#h7.1.2">section 7.1.2</a>.</p>
</div><!-- end 2.8 -->
<h3 id="h2.9">2.9. Developer Options</h3>
@@ -994,7 +904,8 @@
<p class="item"><b>C.</b> The second is widely used in Europe, the third in Japan.</p>
</div><!-- end 3.4.3 -->
-<h4 id="h3.4.4">3.4.4. Other Output Intents</h4><div class="d4" id="d3.4.4">
+<h4 id="h3.4.4">3.4.4. Other Output Intents</h4>
+<div class="d4" id="d3.4.4">
<p class="item"><b>A.</b> If you are required to use an Output Intent that is not one of the above three, then you have to code it yourself.</p>
<p class="item"><b>B.</b> In a place where TeX can find it, create a plain text file with its file name in the following format:</p>
<p class="code">File name begins with <code>novel-</code> (note the hyphen).</p>
@@ -1015,7 +926,8 @@
<p class="item"><b>G.</b> Another place to look for Output Intent data is in your (texmf)/tex/latex/pdfx folder. This will be in your TeX system if package <i>pdfx</i> is installed (but do not load this package into <i>novel</i> class). Files <i>AdobeColorProfiles.tex</i> and <i>AdobeExternalProfiles.tex</i> contain code prepared by the author of the <i>pdfx</i> package. The macro names are not the same, but they are easy to decode: <code>\@OIidentifer</code> is <i>/OutputConditionIdentifier</i>; <code>\@OIcondition</code> is <i>/ProfileName</i>; <code>\@OIinfo</code> is <i>/OutputCondition</i>; <code>\@OIregistry</code> is <i>/RegistryName</i>; and <code>\@OIprofile</code> follows <i>\setCMYKcolorprofile</i>.</p>
</div><!-- end 3.4.4 -->
-<h4 id="h3.4.5">3.4.5. Whether or Not to Embed *.icc</h4><div class="d4" id="d3.4.5">
+<h4 id="h3.4.5">3.4.5. Whether or Not to Embed *.icc</h4>
+<div class="d4" id="d3.4.5">
<p class="item"><b>A.</b> Each Output Intent has a color profile, in the form of a file with extension <i>*.icc</i>.</p>
<p class="item"><b>B.</b> You usually do not need the color profile, because the printer knows which profile corresponds with which standard Output Intent code.</p>
<p class="item"><b>C.</b> When you use <code>\SetPDFX</code> in its un-starred form, the *.icc color profile will not be embedded in the PDF. This is the normal situation.</p>
@@ -1024,7 +936,8 @@
<p class="item" style="position:relative"><b>F.</b> <img src="html-resources/info18.png" width="18" height="18" style="position:relative; bottom:-3px" title="tech info" alt="tech info"/> If your printer requests "US Web Coated SWOP v2" and, as usual, requests that you <em>not</em> embed the corresponding *.icc color profile, then some software will read the Output Intent as "CGATS TR 001" instead of "US Web Coated SWOP v2". They are identical.</p>
</div><!-- end 3.4.5 -->
-<h4 id="h3.4.6">3.4.6. Where to Find *.icc Files</h4><div class="d4" id="d3.4.6">
+<h4 id="h3.4.6">3.4.6. Where to Find *.icc Files</h4>
+<div class="d4" id="d3.4.6">
<p class="item"><b>A.</b> You do not need an *.icc color profile unless you choose to embed it.</p>
<p class="item"><b>B.</b> Although many *.icc color profiles are freely available, they usually cannot be distributed within an open-source project. You might already have them in your system, wherever such files are stored. Note that TeX uses forward slash in file paths, not backslash, even if the platform is Windows:</p>
<p class="isolate">
@@ -1244,7 +1157,7 @@
<p class="item"><b>E.</b> You do not need to set the unsafe zone. Whether or not you do, and regardless of any values you choose, the result does not affect the finished, final PDF. The zones are not enforced. Margins are unaffected.</p>
<p class="item"><b>F.</b> If you set unsafe zone, then the unsafe area will have a dark gray background, when you use <code>[draft,shademargins]</code> as class options. This allows you to visualize whether anything intrudes into the unsafe zone.</p>
<div style="clear:both"></div>
-</div><!-- end 4.3.1.1 -->
+</div><!-- end 4.3.1.2 -->
</div><!-- end 4.3.1 -->
<h4 id="h4.3.2">4.3.2. Lines Per Page</h4>
@@ -1960,7 +1873,7 @@
<p>Images have built-in positioning arguments.</p>
<p class="item"><b>F.</b> Do not use floats (except in <a href="#h2.2">sandbox</a>). Use <i>novel's</i> own <code>\FloatImage</code>.</p>
<p class="item"><b>G.</b> Do not use tables (except in <a href="#h2.2">sandbox</a>). But <i>novel</i> has its <a href="#hD.3.2.7">own provision</a> for a Table of Contents, and the code may be used for other purposes as well.</p>
-<p class="item"><b>H.</b> Do not use picture environment (except in <a href="#h2.2">sandbox</a>). Use only the image commands provided by novel: <code><a href="#h7.2.2">\InlineImage</a></code>, <code><a href="#h7.2.4">\FloatImage</a></code>, and <code><a href="#h7.2.5">\WrapImage</a></code>. There is also a special provision for <a href="#h7.1.2">color cover artwork</a>.</p>
+<p class="item"><b>H.</b> Do not use picture environment (except in <a href="#h2.2">sandbox</a>). Use only the image commands provided by novel: <code><a href="#h7.2.2">\InlineImage</a></code>, <code><a href="#h7.2.4">\FloatImage</a></code>, and <code><a href="#h7.2.5">\WrapImage</a></code>. There is also a special provision for <a href="#h7.1.2">color cover artwork</a> (deprecated).</p>
</div><!-- end 6.3.1 -->
<h4 id="h6.3.2">6.3.2. Some Useful Commands</h4>
@@ -2006,7 +1919,7 @@
</div><!-- end 6.3 -->
<h3 id="h6.4">6.4 Superscripts, Subscripts</h3>
-<div class="d3" id="d6,4">
+<div class="d3" id="d6.4">
<p class="item"><b>A.</b> In <i>novel</i>, superscripts and subscripts are called "markers." Most book-quality Open Type fonts have markers in style sets (<i>sups</i>, <i>sinf</i>, <i>subs</i>).</p>
<p class="item"><b>B.</b> In professional fonts, marker glyph weights are adjusted for consistent appearance compared to ordinary glyphs. However, many free fonts do not adjust marker glyph weights, so the markers may appear too small, or too light. You may choose whether to use a font's own markers, or allow <i>novel</i> to generate markers, depending on whichever you think looks better.</p>
<p class="item"><b>C.</b> <i>real</i> markers attempt to use the Open Type feature <i>sups</i> for superscripts, and the feature <i>sinf</i> (preferred) or <i>subs</i> (alternate) for subscripts. Real markers are the best choice for professional fonts. If the requested feature is not available for the font, then it will be automatically faked, by scaling/raising/lowering ordinary characters from the basefont (lining numerals will be used).</p>
@@ -2070,8 +1983,11 @@
<p class="code"><code>\SetKnownGoodImages{somefile.png anotherfile.jpg}</code></p>
</div><!-- end 7.1.1 -->
-<h4 id="h7.1.2">7.1.2. Color Cover</h4>
+<h4 id="h7.1.2">7.1.2. Color Cover (deprecated)</h4>
<div class="d4" id="d7.1.2">
+<p>As of late 2023, most print services no longer have the same requirements as they once did,
+regarding color cover artwork. Although the method provided by <i>novel</i> still works,
+it is the hard way to do something that (nowadays) does not have to be hard.</p>
<p class="item"><b>A.</b> The book cover may be (usually is) in color. Bleed is required.</p>
<p class="item"><b>B.</b> If your print service allows you to submit cover artwork as an ordinary RGB image file, that's the easiest way to do it. Then, <i>novel</i> is not used.</p>
<p class="item" style="position:relative"><b>C.</b> <img src="html-resources/info18.png" width="18" height="18" style="position:relative; bottom:-3px" title="tech info" alt="tech info"/> Complete support for creating a PDF/X-1a:2001 (or other) color cover, with image in CMYK at 240% ink limit, is provided in <i>novel-scripts.zip</i>. This format is required by some American print-on-demand services.</p>
@@ -2235,7 +2151,7 @@
</p>
<div style="clear:both"></div>
</div><!-- end 8.1.2 -->
-</div><!-- end 8.2 -->
+</div><!-- end 8.1 -->
</div><!-- end 8 -->
</div><!-- end page08 -->
@@ -2665,7 +2581,7 @@
<p>The source of the quotation should be right-justified within the block, and may be preceded by an emdash. Typically, names of people are not italicized, but titles of books are. It is not necessary to give elaborate details; this is not a bibliography.</p>
<p>It is not necessary to load the <i>epigraph</i> package. Simply construct your own style of epigraph using other methods. But if you do load <i>epigraph</i>: Only use <code>\epigraph</code>, or the <code>epigraphs</code> environment, within the ChapterStart environment, or on a display page. Commands <code>\epigraphhead</code>, <code>\dropchapter</code>, <code>\undocrop</code> do not work in <i>novel</i>. The <code>\cleartoevenpage[<i>option</i>]</code> command does work. Ignore the material regarding epigraphs on part pages or in bibliographies.</p>
-<h6 id="hD.3.2.6.1"><span class="n"></span>D.3.2.6.1. Example Epigraph: Real Quotation</h6>
+<h6 id="hD.3.2.6.1">D.3.2.6.1. Example Epigraph: Real Quotation</h6>
<div class="d6" id="uD.3.2.6.1">
<p class="noindent">This might be used for an action adventure:</p>
<p class="code"><img class="floatright" src="html-resources/shakepi.png" width="131" height="208" alt="sample epigraph: Shakespeare"/>
@@ -2683,7 +2599,7 @@
<div style="clear:both"></div>
</div><!-- end D.3.2.6.1 -->
-<h6 id="hD.3.2.6.2"><span class="n"></span>D.3.2.6.2. Example Epigraph: Imaginary Quotation</h6>
+<h6 id="hD.3.2.6.2">D.3.2.6.2. Example Epigraph: Imaginary Quotation</h6>
<div class="d6" id="uD.3.2.6.2">
<p class="noindent">This might be used for contemporary fiction with a humorous style. The fictional speaker will appear as a character in the book:</p>
<p class="code"><img class="floatright" src="html-resources/dorfmcnorf.png" width="131" height="208" alt="sample epigraph: imaginary"/>
@@ -2739,7 +2655,7 @@
<p>If an Author's Note is two pages long, then on the second page use the same page style that you would ordinary use to start a chapter. Normally, this is <code>\thispagestyle{footer}</code>.</p>
<p>If an Author's Note is three or more pages long, then a header is permitted (if the book's main style has header). You may allow author and title to appear in header text, but it is better to indicate that this is <em>not</em> the main story, using <code>\SetVersoHeadText{Author's Note}</code> and <code>\SetRectoHeadText{Author's Note}</code>.</p>
-<h6 id="hD.3.2.10.1"><span class="n"></span>D.3.2.10.1. Example Author's Note</h6>
+<h6 id="hD.3.2.10.1">D.3.2.10.1. Example Author's Note</h6>
<div class="d6" id="uD.3.2.10.1">
<p class="noindent">In a book of historical fiction, based on the author's own travels and expertise:</p>
<p class="code"><code><small>
@@ -2774,7 +2690,7 @@
<p>A single map, or maybe two, need not be mentioned in a table of contents or illustrations. If you have a lot of them strewn around the book, then they should be listed in such a table; but this is very rare in fiction.</p>
<p>As with all images, a map must be placed using <i>novel's</i> own <a href="#h7">image placement methods</a>.</p>
-<h6 id="hD.3.2.11.1"><span class="n"></span>D.3.2.11.1. Example Map</h6>
+<h6 id="hD.3.2.11.1">D.3.2.11.1. Example Map</h6>
<div class="d6" id="uD.3.2.11.1">
<p class="noindent">Typically, there will be nothing but the single image on a Map page, with all text self-contained. But in this example, the image only occupies part of the page. It is followed by ordinary text for the numbered locations:
<p class="code"><img class="floatright" src="html-resources/map.png" width="178" height="274" alt="sample map"/>
@@ -2834,7 +2750,7 @@
<p>Some books are partitioned into distinct sub-books. A sub-book is of substantial length, not individual chapters or short stories.</p>
<p>If your book has distinct sub-books, then each of them has its own recto cover page, known as a Part Separator. Its verso is blank or an Epigraph. Then the accompanying story begins recto.</p>
<p>A Part Separator is <i>always</i> main matter. So, the first Part Separator is <i>always</i> page 1 (number not printed). Then its text begins on page 3. Do not re-initialize the page count when you get to the next Part Separator.</p>
-<p>Part separators could be simply <i>Part I</i>, <i>Part II</i>, and so forth. They could be <i>Book I</i>, <i>Book II</i>. Or, they could have distinctive titles, such as <i>The Northern Front</i> and <i>The Southern Front</i>. If your book is two novelettes in one, then the Part Separators would be the title (and subtitle, if any) of the individual novelettes. Sometimes a Part Separator has a brief description of its purpose, as in <i>Book I. On Earth</i> followed by <i>Book II. On Mars</i>.</p>
+<p>Part separators could be simply <i>Part I</i>, <i>Part II</i>, and so forth. They could be <i>Book I</i>, <i>Book II</i>. Or, they could have distinctive titles, such as <i>The Northern Front</i> and <i>The Southern Front</i>. If your book is "two in one" then the Part Separators would be the title (and subtitle, if any) of the individual parts. Sometimes a Part Separator has a brief description of its purpose, as in <i>Book I. On Earth</i> followed by <i>Book II. On Mars</i>.</p>
<p>Unless your book has a very complex structure, do <i>not</i> use both a second Half-Title (whether in front matter or main matter) and a Part Separator. Combine them as the recto main matter page 1: <i>The Withens Chronicles. Part I</i>, or simply <i>Part I</i>. Then the next Part Separator would be <i>Part II</i>.</p>
<p>In one book I recently noticed, there were five parts, each of which corresponded to one calendar day. The Part Separator showed the day, as in <i>Monday, September 25</i>. Then within each part there were several chapters, each of which took us to some different event in a different setting, all on that same day. I also note that this book had no Table of Contents; the progress of the novel was therefore a surprise, by its author's intent.</p>
</div><!-- end D.3.3.2 -->
@@ -3183,7 +3099,7 @@
<h2 id="hY">Appendix Y. Licensing and Credits</h2>
<div class="d2" id="dY">
-<p class="item"><b>A. Licensing:</b> The <i>novel</i> document class, including software, examples, documentation and supporting images, is distributed under the terms of the <a class="external" rel="external" target="new" href="https://www.latex-project.org/lppl/lppl-1-3c/">LaTeX Project Public License, version 1.3c only</a>. Exception: The included fonts <i>NovelDeco.otf</i> and <i>CPmodified.otf</i> are distributed under terms of the <a class="external" rel="external" target="new" href="http://scripts.sil.org/cms/scripts/page.php?item_id=OFL_web">SIL Open Font License, v.1.1.</a></p>
+<p class="item"><b>A. Licensing:</b> The <i>novel</i> document class, including software, examples, documentation and supporting images, is distributed under the terms of the <a class="external" rel="external" target="new" href="https://www.latex-project.org/lppl/lppl-1-3c/">LaTeX Project Public License, version 1.3c only</a>. Exception: The included font <i>NovelDeco.otf</i> is distributed under terms of the <a class="external" rel="external" target="new" href="http://scripts.sil.org/cms/scripts/page.php?item_id=OFL_web">SIL Open Font License, v.1.1.</a></p>
<p>To ensure that your book may be sold commercially, be careful to use only fonts that allow commercial usage. That may exclude some of the fonts in the LaTeX font catalog. See <a href="#hC">Appendix C</a>.</p>
<p class="item"><b>B. Credits:</b> Within the TeX code files, you will find places where small or large pieces of code are the work of someone else. Names or organizations are credited in-place within the TeX code, according to license.</p>
@@ -3199,11 +3115,13 @@
<div id="pageZ" class="page">
-<h2 id="hZ">Appendix Z. Changes in v.1.80.</h2>
+<h2 id="hZ">Appendix Z. Changes in v.1.86.</h2>
<div class="d2" id="dZ">
<h4>Important Changes</h4>
<div class="d3">
+<p>Version 1.86 (2024) docs edited..</p>
+<p>Version 1.84 (2023) docs edited. Probably final update.</p>
<p>Version 1.83 (2023) corrected minor typo. Will not affect most users.</p>
<p>Version 1.82 (2023) adds a user setting, to change the default indent.</p>
<p>Version 1.80 (2023) tweaks some internal code, for faster compiling.
@@ -3213,7 +3131,9 @@
to line breaks and pagination. Due to various adjustments in component
packages and fonts, a document built in the past may look slightly different
if re-built now.</p>
+</div>
+
</div><!-- end Z -->
</div><!-- end Appendix Z -->
<!-- ************************************************************ -->
@@ -3221,7 +3141,7 @@
</div><!-- end main -->
-<div id="finish"></div>
+<div style="clear:both"></div>
</div><!-- end master -->
</body>
</html>
Modified: trunk/Master/texmf-dist/doc/lualatex/novel/novel.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/lualatex/novel/novel.tex
===================================================================
--- trunk/Master/texmf-dist/doc/lualatex/novel/novel.tex 2024-02-01 21:05:56 UTC (rev 69657)
+++ trunk/Master/texmf-dist/doc/lualatex/novel/novel.tex 2024-02-01 21:06:11 UTC (rev 69658)
@@ -12,7 +12,7 @@
% novel.pdf (if present) have read/write permissions for any user.
% Otherwise, compile may fail at the point where files are written.
-\documentclass{novel} % v. 1.83.
+\documentclass{novel} % v. 1.86.
% Almost all settings are defaults.
\SetHeadFootStyle{3}
\SetTitle{Novel Document Class} % only footer, with page number
@@ -20,111 +20,49 @@
% However, not every P.O.D. service needs PDF/X these days.
\SetPDFX[CGATSTR001]{X-1a:2001}
\begin{document}
+\thispagestyle{empty}
\begin{ChapterStart}[8]
\vspace{\nbs} % \nbs is normal baselineskip
\ChapterTitle{NOVEL}
\vspace{\nbs}
\ChapterSubtitle{A Document Class for the Rest of Us}
-\ChapterDeco[4]{\decoglyph{n9548}}
+{\centering Version 1.86 (January 2024)\par}
\end{ChapterStart}
-\textbf{Where is the documentation??} It is in HTML format, and cannot be retrieved via \textit{texdoc}. If you have this package installed, look for (texroot)/doc/lualatex/novel/novel-documentation.html. If you are online, go to the CTAN page at https://ctan.org/pkg/novel and click ``Package Documentation (HTML).''
+\textbf{Where is the documentation??} It is HTML.\\
+(texroot)/doc/lualatex/novel/novel-documentation.html.
\scenebreak
-\textbf{Description:} The \emph{novel} document class is for writers of original fiction, to be printed to paper, with attention to the requirements of the print-on-demand market. Non-color interiors and color covers are supported. Images are supported, but only as they might be used in fiction, not picture books.
+\textbf{News:} This document class was first privately used in 2014.
+Then, in 2018, it was improved, documented, and released. It has been
+maintained through TeXlive 2023. It is expected to work in the future, but is
+no longer maintained by its original creator.\par
+Changes in print-on-demand technology have made many parts of this code
+irrelevant. There are also a few commands that require graphic design
+experience for proper usage. And a few settings, which should be simple and
+obvious, are complex and arcane.\par
+If \emph{novel} works for you, good. But if you are simply writing a fiction
+novel, nothing fancy, then see if CTAN and TeXlive have a package named
+\emph{novelette}. As of late January 2024, the package is in beta test
+(not released yet). If the package exists and can be installed, then you
+should prefer \emph{novelette}.
-If your work is an E-book, or uses interior color other than gray, or is academic, then this document class is not for you.
+\scenebreak
-But if you are writing a detective novel, or science fiction, or a collection of short stories, then read on!
+\textbf{Description:} The \emph{novel} document class is for writers of
+original fiction, to be printed to paper, with attention to the requirements
+of the print-on-demand market. Non-color interiors and color covers are
+supported. Images are supported, but only as they might be used in fiction,
+not picture books.
-\QuickChapter{1. Features}
+If your work is an E-book, or uses interior color other than gray, or is
+academic, then this document class is not for you.
-Throughout, it is assumed that the purpose of your writing is a commercially printed book of fiction.
+But if you are writing a detective novel, or science fiction, or a collection
+of short stories, then you are in the right place.
-A new \emph{novel} is pre-configured to produce a standard trade book size of 5.5in W x 8.5in H, with layout margins that are likely to be acceptable to the most widely-used print services. The file you are now reading is in this format. But if that is not the size or layout you want, then there are commands that configure just about anything, using standard terminology and understandable purpose. Best of all, the HTML documentation comes with images and examples, so you know what you are doing.
-
-Almost everything is pre-configured to “just work,” even the choice of fonts. The chosen compiler is LuaLaTeX, and Open Type fonts are loaded using \textit{fontspec} technology. If you prefer to use a professional font, it will be easy to load and use in utf-8.
-
-Many standard LaTeX commands are disabled. This will be surprising at first. But \emph{novel} is focused on one thing only. Anything that might interfere with that purpose may have been tossed aside. So, be sure that you read the documentation! If you take an existing LaTeX document and just change the class to \emph{novel,} it is very unlikely to work as expected.
-
-Many new commands are provided. They are focused on the needs of print fiction writers, period. And, \emph{novel} has built-in PDF/X technology that exceeds the capabilities currently available via other LaTeX packages.
-
-\QuickChapter{2. Complete Documentation}
-
-What you are reading now, is only an introduction. The complete documentation is in HTML format, directly written in HTML rather than extracted from code. There are numerous examples and images, too detailed to be presented as PDF.
-
-\QuickChapter{3. License}
-
-The LaTeX code, and accompanying documentation, is released under the LateX Project Public License, version 1.3c.
-
-The companion font(s) is(are) licensed under the SIL Open Font License, version 1.1.
-
-
-
-\QuickChapter{4. Version}
-
-\noindent 1.83, 2023-11-09: Minor typo corrected.
-
-\noindent 1.82, 2023-08-26: Added user setting for default indent.
-
-\noindent 1.81, 2023-03-25: Bug fixes. Also 1.81a, 1.81b.
-
-\noindent 1.80, 2023-02-08: Class option ``rev'' for new documents.
-
-\noindent 1.52, 2018-04-26: Enhanced detection and warning using Lua code.
-
-\noindent 1.50.5, 2018-04-11: Minor bug fixes (docs and code disagreed).
-
-\noindent 1.50, 2018-03-28: Improved image handling commands, sandbox.
-
-\clearpage
-
-\QuickChapter{5. FAQs}
-
-\begin{adjustwidth}{\parindent}{0pt}
-\backindent\makebox[\parindent][l]{Q. }Can this document class be used for E-books?
-\end{adjustwidth}
-\begin{adjustwidth}{\parindent}{0pt}
-\backindent\makebox[\parindent][l]{A. }No. And, that feature will never be added, as the technology is inherently incompatible. A word processor is your friend.
-\end{adjustwidth}
-
-\begin{adjustwidth}{\parindent}{0pt}
-\backindent\makebox[\parindent][l]{Q. }What happened to floats and lists?
-\end{adjustwidth}
-\begin{adjustwidth}{\parindent}{0pt}
-\backindent\makebox[\parindent][l]{A. }Use the new image commands, or sandbox mode.
-\end{adjustwidth}
-
-\begin{adjustwidth}{\parindent}{0pt}
-\backindent\makebox[\parindent][l]{Q. }My thesis advisor told me---
-\end{adjustwidth}
-\begin{adjustwidth}{\parindent}{0pt}
-\backindent\makebox[\parindent][l]{A. }Stop right there. This document class is very different from anything used for theses and other academic publications.
-\end{adjustwidth}
-
-\begin{adjustwidth}{\parindent}{0pt}
-\backindent\makebox[\parindent][l]{Q. }If I use TikZ for Feynman diagrams, then---
-\end{adjustwidth}
-\begin{adjustwidth}{\parindent}{0pt}
-\backindent\makebox[\parindent][l]{A. }Go away.
-\end{adjustwidth}
-
-\begin{adjustwidth}{\parindent}{0pt}
-\backindent\makebox[\parindent][l]{Q. }Has this document class ever been used for an actual novel?
-\end{adjustwidth}
-\begin{adjustwidth}{\parindent}{0pt}
-\backindent\makebox[\parindent][l]{A. }Yes indeed! In August 2017 the author published a complete novel, including its cover, using this document class. Almost all of the setup used defaults. The files (textblock and cover) were submitted to a major American P.O.D. service in \lnum{PDF/X-1a:2001} format, then electronically reviewed and accepted \textit{on the first attempt.} A printed copy was in the author's hands within a week. Just like that. Took months to write, of course.\par
-Update: Several other authors report success.
-\end{adjustwidth}
-
-\begin{adjustwidth}{\parindent}{0pt}
-\backindent\makebox[\parindent][l]{Q. }When I woke up this morning, my head felt like a toddler had been pounding it in a sandbox. I rolled over and looked at the mug shot on the wall. It was a woman in her forties with a drug habit that was bad, and an attitude that was even worse. She had seen better days, like the time I took her to the eighth grade sock hop. Then I got up, washed, and dragged my lonely butt down to the one-man detective agency that I jokingly called my means of living. You know what I mean?
-\end{adjustwidth}
-\begin{adjustwidth}{\parindent}{0pt}
-\backindent\makebox[\parindent][l]{A. }Yeah. Stick with me, kid. This document class is for you.
-\end{adjustwidth}
-
+\makeatletter\nocle at rtoendtrue\makeatother % For developer only.
\end{document}
Modified: trunk/Master/texmf-dist/tex/lualatex/novel/novel-CGATSTR001.clo
===================================================================
--- trunk/Master/texmf-dist/tex/lualatex/novel/novel-CGATSTR001.clo 2024-02-01 21:05:56 UTC (rev 69657)
+++ trunk/Master/texmf-dist/tex/lualatex/novel/novel-CGATSTR001.clo 2024-02-01 21:06:11 UTC (rev 69658)
@@ -2,7 +2,7 @@
%% The values of the arguments are public industry standards.
%%
\ProvidesFile{novel-CGATSTR001.clo}%
-[2023/11/09 any version. (novel Output Intent CGATS TR 001)]
+[2024/01/31 any version. (novel Output Intent CGATS TR 001)]
%%
% Typically used in the USA.
Modified: trunk/Master/texmf-dist/tex/lualatex/novel/novel-CalculateLayout.sty
===================================================================
--- trunk/Master/texmf-dist/tex/lualatex/novel/novel-CalculateLayout.sty 2024-02-01 21:05:56 UTC (rev 69657)
+++ trunk/Master/texmf-dist/tex/lualatex/novel/novel-CalculateLayout.sty 2024-02-01 21:06:11 UTC (rev 69658)
@@ -6,7 +6,7 @@
%% License URL: https://www.latex-project.org/lppl/lppl-1-3c/
%%
\ProvidesFile{novel-CalculateLayout.sty}%
-[2023/11/09 v1.83 LaTeX file (layout calculations)]
+[2024/01/31 v1.86 LaTeX file (layout calculations)]
%%
%%
Modified: trunk/Master/texmf-dist/tex/lualatex/novel/novel-ChapterScene.sty
===================================================================
--- trunk/Master/texmf-dist/tex/lualatex/novel/novel-ChapterScene.sty 2024-02-01 21:05:56 UTC (rev 69657)
+++ trunk/Master/texmf-dist/tex/lualatex/novel/novel-ChapterScene.sty 2024-02-01 21:06:11 UTC (rev 69658)
@@ -6,7 +6,7 @@
%% License URL: https://www.latex-project.org/lppl/lppl-1-3c/
%%
\ProvidesFile{novel-ChapterScene.sty}%
-[2023/11/09 v1.83 LaTeX file (chapter and scene macros)]
+[2024/01/31 v1.86 LaTeX file (chapter and scene macros)]
%%
Modified: trunk/Master/texmf-dist/tex/lualatex/novel/novel-DropCap.sty
===================================================================
--- trunk/Master/texmf-dist/tex/lualatex/novel/novel-DropCap.sty 2024-02-01 21:05:56 UTC (rev 69657)
+++ trunk/Master/texmf-dist/tex/lualatex/novel/novel-DropCap.sty 2024-02-01 21:06:11 UTC (rev 69658)
@@ -9,7 +9,7 @@
%% License URL: https://www.latex-project.org/lppl/lppl-1-3c/
%%
\ProvidesFile{novel-DropCap.sty}%
-[2023/11/09 v1.83 (Drop Caps)]
+[2024/01/31 v1.86 (Drop Caps)]
\NeedsTeXFormat{LaTeX2e}[1999/12/01]
%
%
Modified: trunk/Master/texmf-dist/tex/lualatex/novel/novel-FOGRA39.clo
===================================================================
--- trunk/Master/texmf-dist/tex/lualatex/novel/novel-FOGRA39.clo 2024-02-01 21:05:56 UTC (rev 69657)
+++ trunk/Master/texmf-dist/tex/lualatex/novel/novel-FOGRA39.clo 2024-02-01 21:06:11 UTC (rev 69658)
@@ -1,7 +1,7 @@
%% This is file `novel-FOGRA39.clo', part of `novel' document class.
%% The values of the arguments are public industry standards.
\ProvidesFile{novel-FOGRA39.clo}%
-[2023/11/09 any version. (novel Output Intent FOGRA39)]
+[2024/01/31 any version. (novel Output Intent FOGRA39)]
%%
Modified: trunk/Master/texmf-dist/tex/lualatex/novel/novel-FileData.sty
===================================================================
--- trunk/Master/texmf-dist/tex/lualatex/novel/novel-FileData.sty 2024-02-01 21:05:56 UTC (rev 69657)
+++ trunk/Master/texmf-dist/tex/lualatex/novel/novel-FileData.sty 2024-02-01 21:06:11 UTC (rev 69658)
@@ -6,7 +6,7 @@
%% License URL: https://www.latex-project.org/lppl/lppl-1-3c/
%%
\ProvidesFile{novel-FileData.sty}%
-[2023/11/09 v1.83 LaTeX file (File Data settings)]
+[2024/01/31 v1.86 LaTeX file (File Data settings)]
%%
Modified: trunk/Master/texmf-dist/tex/lualatex/novel/novel-Fonts.sty
===================================================================
--- trunk/Master/texmf-dist/tex/lualatex/novel/novel-Fonts.sty 2024-02-01 21:05:56 UTC (rev 69657)
+++ trunk/Master/texmf-dist/tex/lualatex/novel/novel-Fonts.sty 2024-02-01 21:06:11 UTC (rev 69658)
@@ -6,7 +6,7 @@
%% License URL: https://www.latex-project.org/lppl/lppl-1-3c/
%%
\ProvidesFile{novel-Fonts.sty}%
-[2023/11/09 v1.83 LaTeX file (font settings and defaults)]
+[2024/01/31 v1.86 LaTeX file (font settings and defaults)]
%%
Modified: trunk/Master/texmf-dist/tex/lualatex/novel/novel-Footnotes.sty
===================================================================
--- trunk/Master/texmf-dist/tex/lualatex/novel/novel-Footnotes.sty 2024-02-01 21:05:56 UTC (rev 69657)
+++ trunk/Master/texmf-dist/tex/lualatex/novel/novel-Footnotes.sty 2024-02-01 21:06:11 UTC (rev 69658)
@@ -7,7 +7,7 @@
%% License URL: https://www.latex-project.org/lppl/lppl-1-3c/
%%
\ProvidesFile{novel-Footnotes.sty}%
-[2023/11/09 v1.83 LaTeX file (commands for footnotes and endnotes)]
+[2024/01/31 v1.86 LaTeX file (commands for footnotes and endnotes)]
%%
Modified: trunk/Master/texmf-dist/tex/lualatex/novel/novel-HeadFootStyles.sty
===================================================================
--- trunk/Master/texmf-dist/tex/lualatex/novel/novel-HeadFootStyles.sty 2024-02-01 21:05:56 UTC (rev 69657)
+++ trunk/Master/texmf-dist/tex/lualatex/novel/novel-HeadFootStyles.sty 2024-02-01 21:06:11 UTC (rev 69658)
@@ -6,7 +6,7 @@
%% License URL: https://www.latex-project.org/lppl/lppl-1-3c/
%%
\ProvidesFile{novel-HeadFootStyles.sty}%
-[2023/11/09 v1.83 LaTeX file (header and footer layouts and styles)]
+[2024/01/31 v1.86 LaTeX file (header and footer layouts and styles)]
%%
Modified: trunk/Master/texmf-dist/tex/lualatex/novel/novel-Images.sty
===================================================================
--- trunk/Master/texmf-dist/tex/lualatex/novel/novel-Images.sty 2024-02-01 21:05:56 UTC (rev 69657)
+++ trunk/Master/texmf-dist/tex/lualatex/novel/novel-Images.sty 2024-02-01 21:06:11 UTC (rev 69658)
@@ -6,7 +6,7 @@
%% License URL: https://www.latex-project.org/lppl/lppl-1-3c/
%%
\ProvidesFile{novel-Images.sty}%
-[2023/11/09 v1.83 LaTeX file (image placement)]
+[2024/01/31 v1.86 LaTeX file (image placement)]
%%
Modified: trunk/Master/texmf-dist/tex/lualatex/novel/novel-JC200103.clo
===================================================================
--- trunk/Master/texmf-dist/tex/lualatex/novel/novel-JC200103.clo 2024-02-01 21:05:56 UTC (rev 69657)
+++ trunk/Master/texmf-dist/tex/lualatex/novel/novel-JC200103.clo 2024-02-01 21:06:11 UTC (rev 69658)
@@ -2,7 +2,7 @@
%% The values of the arguments are public industry standards.
%%
\ProvidesFile{novel-JC200103.clo}%
-[2023/11/09 any version. (novel Output Intent JC200103)]
+[2024/01/31 any version. (novel Output Intent JC200103)]
%%
Modified: trunk/Master/texmf-dist/tex/lualatex/novel/novel-LayoutSettings.sty
===================================================================
--- trunk/Master/texmf-dist/tex/lualatex/novel/novel-LayoutSettings.sty 2024-02-01 21:05:56 UTC (rev 69657)
+++ trunk/Master/texmf-dist/tex/lualatex/novel/novel-LayoutSettings.sty 2024-02-01 21:06:11 UTC (rev 69658)
@@ -6,7 +6,7 @@
%% License URL: https://www.latex-project.org/lppl/lppl-1-3c/
%%
\ProvidesFile{novel-LayoutSettings.sty}%
-[2023/11/09 v1.83 LaTeX file (layout settings)]
+[2024/01/31 v1.86 LaTeX file (layout settings)]
%%
Modified: trunk/Master/texmf-dist/tex/lualatex/novel/novel-PostLayout.sty
===================================================================
--- trunk/Master/texmf-dist/tex/lualatex/novel/novel-PostLayout.sty 2024-02-01 21:05:56 UTC (rev 69657)
+++ trunk/Master/texmf-dist/tex/lualatex/novel/novel-PostLayout.sty 2024-02-01 21:06:11 UTC (rev 69658)
@@ -6,7 +6,7 @@
%% License URL: https://www.latex-project.org/lppl/lppl-1-3c/
%%
\ProvidesFile{novel-PostLayout.sty}%
-[2023/11/09 v1.83 LaTeX file (post-layout modifications)]
+[2024/01/31 v1.86 LaTeX file (post-layout modifications)]
%%
%%
Modified: trunk/Master/texmf-dist/tex/lualatex/novel/novel-Sandbox.sty
===================================================================
--- trunk/Master/texmf-dist/tex/lualatex/novel/novel-Sandbox.sty 2024-02-01 21:05:56 UTC (rev 69657)
+++ trunk/Master/texmf-dist/tex/lualatex/novel/novel-Sandbox.sty 2024-02-01 21:06:11 UTC (rev 69658)
@@ -11,7 +11,7 @@
%% License URL: https://www.latex-project.org/lppl/lppl-1-3c/
%%
\ProvidesFile{novel-Sandbox.sty}%
-[2023/11/09 v1.83 LaTeX file (used only with sandbox class option)]
+[2024/01/31 v1.86 LaTeX file (used only with sandbox class option)]
%%
%%
Modified: trunk/Master/texmf-dist/tex/lualatex/novel/novel-TextMacros.sty
===================================================================
--- trunk/Master/texmf-dist/tex/lualatex/novel/novel-TextMacros.sty 2024-02-01 21:05:56 UTC (rev 69657)
+++ trunk/Master/texmf-dist/tex/lualatex/novel/novel-TextMacros.sty 2024-02-01 21:06:11 UTC (rev 69658)
@@ -6,7 +6,7 @@
%% License URL: https://www.latex-project.org/lppl/lppl-1-3c/
%%
\ProvidesFile{novel-TextMacros.sty}%
-[2023/11/09 v1.83 LaTeX file (text macros usable within document body)]
+[2024/01/31 v1.86 LaTeX file (text macros usable within document body)]
%%
Modified: trunk/Master/texmf-dist/tex/lualatex/novel/novel-microtype.cfg
===================================================================
--- trunk/Master/texmf-dist/tex/lualatex/novel/novel-microtype.cfg 2024-02-01 21:05:56 UTC (rev 69657)
+++ trunk/Master/texmf-dist/tex/lualatex/novel/novel-microtype.cfg 2024-02-01 21:06:11 UTC (rev 69658)
@@ -10,7 +10,7 @@
%% ------------------------------------------------------------------------
%%
\ProvidesFile{novel-microtype.cfg}%
-[2023/11/09 any version. (default microtype configuration for novel class)]
+[2024/01/31 any version. (default microtype configuration for novel class)]
%%% ---------------------------------------------------------------------------
%%% FONT SETS
Modified: trunk/Master/texmf-dist/tex/lualatex/novel/novel-pdfx.sty
===================================================================
--- trunk/Master/texmf-dist/tex/lualatex/novel/novel-pdfx.sty 2024-02-01 21:05:56 UTC (rev 69657)
+++ trunk/Master/texmf-dist/tex/lualatex/novel/novel-pdfx.sty 2024-02-01 21:06:11 UTC (rev 69658)
@@ -16,7 +16,7 @@
%%
\NeedsTeXFormat{LaTeX2e}
\ProvidesFile{novel-pdfx.sty}%
-[2023/11/09 v1.83 LaTeX file (PDF/X support for novel class)]
+[2024/01/31 v1.86 LaTeX file (PDF/X support for novel class)]
% This package supports, and is part of, class `novel'.
% No support for anything but LuaLaTeX.
Modified: trunk/Master/texmf-dist/tex/lualatex/novel/novel-xmppacket.sty
===================================================================
--- trunk/Master/texmf-dist/tex/lualatex/novel/novel-xmppacket.sty 2024-02-01 21:05:56 UTC (rev 69657)
+++ trunk/Master/texmf-dist/tex/lualatex/novel/novel-xmppacket.sty 2024-02-01 21:06:11 UTC (rev 69658)
@@ -14,7 +14,7 @@
%% ----------------------------------------------------------------------------
%%
\ProvidesFile{novel-xmppacket.sty}%
-[2023/11/09 any version. (novel XMP packet template)]
+[2024/01/31 any version. (novel XMP packet template)]
%%
Modified: trunk/Master/texmf-dist/tex/lualatex/novel/novel.cls
===================================================================
--- trunk/Master/texmf-dist/tex/lualatex/novel/novel.cls 2024-02-01 21:05:56 UTC (rev 69657)
+++ trunk/Master/texmf-dist/tex/lualatex/novel/novel.cls 2024-02-01 21:06:11 UTC (rev 69658)
@@ -8,14 +8,21 @@
%%
\NeedsTeXFormat{LaTeX2e}[1995/12/01]
% Actually needs LuaLaTeX, at least version 0.95 from TeXLive 2016.
-\ProvidesClass{novel}[2023/11/09 v1.83 LaTeX document class]
+\ProvidesClass{novel}[2024/01/31 v1.86 LaTeX document class]
%%
-%% Version 1.83: Minor typo corrected.
+%% During the years since `novel' was introduced, there have been
+%% many changes in print-on-demand. Also, `novel` offers some
+%% features that are rarely used, bloating the code and documentation.
+%% Although `novel` still works (as of late 2023), it is more complicated
+%% than necessary for ordinary popular fiction. Unless you really need `novel',
+%% try `novelette' instead. Available early 2024. Easier to use.
+
+
%% In addition to a minimal LaTeX setup, with luatex, you will need these:
%% textpos magaz xcolor adjustbox eso-pic pdfpages unicode-math fp iftex
%% libertinus-fonts makecmds xkeyval lm-math xstring xifthen silence
-%% collectbox pgf lipsum wrapfig pdflscape polyglossia microtype hyperref
+%% collectbox pgf lipsum wrapfig pdflscape microtype hyperref polyglossia
%% You will need language support, for your language(s).
%% If using lipsum, you will need hyphen-latin.
@@ -26,6 +33,8 @@
%% It cannot be used for e-books or for journal publication.
%% It is not suitable for most non-fiction, because routine academic features
%% such as bibiography and automatic sectioning are defeated.
+%% Only use it for ORIGINAL works, where you can edit your text. If your
+%% purpose is a reprint of someone else's work, then `novel' is not for you.
%%
%% There are pre-configured layouts for the most commonly used choices of
%% trim size (finished book width and height), and internal layout consistent
@@ -100,8 +109,8 @@
\newlength\@tempLength % scratch length for local calculations
\newif \if at tempTF % scratch boolean for local tests
+\newif \ifnocle at rtoend % Only developer uses true.
-
%% Global lengths are often passed around in `novel'.
%% But \setlength is not always global in effect.
%% This code defines a global command.
@@ -327,11 +336,11 @@
%% Physical Layout Commands and Settings.
%% ----------------------------------------------------------------------------
%% Define user commands that over-ride class option pre-configured settings.
-%% Also sets a variety of miscellaneous lengths:s \parsep, \parindent, etc.
+%% Also sets a variety of miscellaneous lengths: \parsep, \parindent, etc.
\RequirePackage{novel-LayoutSettings}
-%% Language support.
+%% Use polyglossia:
%% ----------------------------------------------------------------------------
\RequirePackage{polyglossia}
\setdefaultlanguage[variant=american]{english} % may be changed by user
@@ -621,7 +630,7 @@
\string\xdef\string\@AllGoodImages{\@AllGoodImages}^^J%
\string\xdef\string\@UnknownImages{\@UnknownImages}^^J%
}%
- \cleartoend% adds 1 or 2 blanks, for final verso blank
+ \ifnocle at rtoend\else\cleartoend\fi%
\fi%
\fi%
}
More information about the tex-live-commits
mailing list.