summaryrefslogtreecommitdiff
path: root/macros/luatex/latex/novel/doc/novel.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/luatex/latex/novel/doc/novel.tex')
-rw-r--r--macros/luatex/latex/novel/doc/novel.tex120
1 files changed, 29 insertions, 91 deletions
diff --git a/macros/luatex/latex/novel/doc/novel.tex b/macros/luatex/latex/novel/doc/novel.tex
index 42ce289628..e61e9c0226 100644
--- a/macros/luatex/latex/novel/doc/novel.tex
+++ b/macros/luatex/latex/novel/doc/novel.tex
@@ -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.
-
-But if you are writing a detective novel, or science fiction, or a collection of short stories, then read on!
-
-\QuickChapter{1. Features}
-
-Throughout, it is assumed that the purpose of your writing is a commercially printed book of fiction.
-
-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}
+\scenebreak
-\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}
+\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.
-\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}
+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.
-\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}
+But if you are writing a detective novel, or science fiction, or a collection
+of short stories, then you are in the right place.
+\makeatletter\nocle@rtoendtrue\makeatother % For developer only.
\end{document}