From ae46a827762636210d21328b3c5a75b826924a1e Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 22 Mar 2017 21:56:20 +0000 Subject: novel (22mar17) git-svn-id: svn://tug.org/texlive/trunk@43575 c570f23f-e606-0410-a88d-b1316a301751 --- .../lualatex/novel/html-resources/endnotetext.png | Bin 39894 -> 25955 bytes .../doc/lualatex/novel/html-resources/fmsimple.png | Bin 0 -> 5063 bytes .../doc/lualatex/novel/novel-template.tex | 2 +- .../doc/lualatex/novel/noveldocs-01-overview.html | 127 +++--- .../lualatex/novel/noveldocs-02-class-options.html | 26 +- .../lualatex/novel/noveldocs-03-metadata-pdfx.html | 24 +- .../doc/lualatex/novel/noveldocs-04-layout.html | 62 +-- .../doc/lualatex/novel/noveldocs-05-fonts.html | 98 ++--- .../lualatex/novel/noveldocs-06-header-footer.html | 103 +++-- .../novel/noveldocs-07-text-size-style.html | 42 +- .../doc/lualatex/novel/noveldocs-08-images.html | 30 +- .../novel/noveldocs-09-chapters-displays.html | 472 +++++++++++---------- .../tex/lualatex/novel/novel-CalculateLayout.sty | 2 +- .../tex/lualatex/novel/novel-ChapterScene.sty | 2 +- .../tex/lualatex/novel/novel-FileData.sty | 4 +- .../tex/lualatex/novel/novel-FontDefaults.sty | 2 +- .../tex/lualatex/novel/novel-Footnotes.sty | 2 +- .../tex/lualatex/novel/novel-HeadFootStyles.sty | 4 +- .../texmf-dist/tex/lualatex/novel/novel-Images.sty | 2 +- .../tex/lualatex/novel/novel-LayoutSettings.sty | 2 +- .../tex/lualatex/novel/novel-TextMacros.sty | 2 +- .../tex/lualatex/novel/novel-glyphtounicode.tex | 2 +- .../tex/lualatex/novel/novel-microtype.cfg | 2 +- .../texmf-dist/tex/lualatex/novel/novel-pdfx.sty | 12 +- .../tex/lualatex/novel/novel-xmppacket.sty | 2 +- Master/texmf-dist/tex/lualatex/novel/novel.cls | 2 +- 26 files changed, 533 insertions(+), 495 deletions(-) create mode 100644 Master/texmf-dist/doc/lualatex/novel/html-resources/fmsimple.png (limited to 'Master') diff --git a/Master/texmf-dist/doc/lualatex/novel/html-resources/endnotetext.png b/Master/texmf-dist/doc/lualatex/novel/html-resources/endnotetext.png index 58067bee816..48bdc2563e4 100644 Binary files a/Master/texmf-dist/doc/lualatex/novel/html-resources/endnotetext.png and b/Master/texmf-dist/doc/lualatex/novel/html-resources/endnotetext.png differ diff --git a/Master/texmf-dist/doc/lualatex/novel/html-resources/fmsimple.png b/Master/texmf-dist/doc/lualatex/novel/html-resources/fmsimple.png new file mode 100644 index 00000000000..23318c56c5d Binary files /dev/null and b/Master/texmf-dist/doc/lualatex/novel/html-resources/fmsimple.png differ diff --git a/Master/texmf-dist/doc/lualatex/novel/novel-template.tex b/Master/texmf-dist/doc/lualatex/novel/novel-template.tex index 6456dee3e16..2c232c41b65 100644 --- a/Master/texmf-dist/doc/lualatex/novel/novel-template.tex +++ b/Master/texmf-dist/doc/lualatex/novel/novel-template.tex @@ -1,6 +1,6 @@ % !TeX program = LuaLaTeX % !TeX encoding = UTF-8 -\documentclass{novel} % v. 1.0.7 or later +\documentclass{novel} % v. 1.0.9 or later % You may put this wherever your installation keeps templates. % Many packages are pre-loaded. Nearly all settings are pre-configured. % Some popular user settings: diff --git a/Master/texmf-dist/doc/lualatex/novel/noveldocs-01-overview.html b/Master/texmf-dist/doc/lualatex/novel/noveldocs-01-overview.html index 9b8eb5d5ea7..0a994b5678b 100644 --- a/Master/texmf-dist/doc/lualatex/novel/noveldocs-01-overview.html +++ b/Master/texmf-dist/doc/lualatex/novel/noveldocs-01-overview.html @@ -1,9 +1,9 @@ - + Class novel - 1 - Overview - + @@ -22,12 +22,13 @@
  • 1.1.1 Licensing
  • 1.1.2 Installation
  • 1.1.3 Credits
  • +
  • 1.1.4 Useful Tools
  • 1.2 Differences. Important!
  • -

  • +

  • 1.5 Command Summary: Preamble
  • -
  • 1.6.2 Display Pages +
  • 1.6.2 Special Pages
  • 1.6.3 Block-Level Breaks and Styling @@ -138,7 +139,7 @@

    Documentation for novel document class

    -

    Documentation version: 1.0.7.

    +

    Documentation version: 1.0.9.

    @@ -178,27 +179,39 @@

    If you are ready to typeset your great detective novel, or your collection of sci-fi short stories, then novel is for you.

    - +

    1.1.1 Licensing

    The novel document class, including software, examples, documentation and supporting images, is distributed under the terms of the LaTeX Project Publc License, either version 1.3c of this license or (at your option) any later version. The exception is the included font NovelDeco.otf, which is distributed under terms of the SIL Open Font License, v.1.1. Small portions of the software use code placed on the Internet under terms of Creative Commons 3.0-by-sa license; attributions are provided at the places where such code is used.

    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.

    - +

    1.1.2 Installation

    -

    Unless and until novel becomes part of TeX distributions, it must be manually installed in a "local" or "home" TeX directory. If obtained as a single compressed archive, the internal folder tree is already in correct configuration.

    -

    Fonts from the libertinus package are required. They may be obtained through your TeX distribution. Note that neither \RequirePackage{libertinus} nor \usepackage{libertinus} will be effective. You must obtain and install the fonts yourself, or manually through your distribution's package manager.

    -

    Depending on how you obtain the files, you may need to update the file name database. In TeXlive, try command line mktexlsr. In MiKTeX, use the Options > Update FNDB button.

    -

    Since you will be using LuaTeX, the font cache will be updated to include the newly-installed fonts, the next time you run this software. However, I recommend that you force a full cache refresh, by locating the luatex-cache directory, and discard its contents. The cache may be anywhere (sadly), so you will have to hunt for it. If you have never used LuaTeX before, it may not exist. If there are any updates to the fonts, then a manual cache refresh is necessary.

    +

    Your TeX installation must be based on TeXLive 2016 or later. This is the case if you have manually installed TeXLive directly from its site, or if you are using MiKTeX. However, if you are on Linux and your distro is not the latest and greatest, the distribution may be based on TeXLive 2015 or earlier. Then, you will not be able to use novel. +

    The TeX code will be placed in (texroot)/tex/lualatex/novel/, the custom font will be placed in (texroot)/fonts/opentype/novel/, and the documentation will be placed in (texroot)/doc/lualatex/novel/.

    +

    The novel class can now be installed like any other TeX package, through your distribution's package manager. The installation will provide the code, documentation, and a custom font.

    + +

    Fonts from the libertinus package are required, and may be installed via your TeX package manager. Note that a novel document does not request the package! Instead, if you have not manually specified which fonts to use, it will automatically look for pre-installed libertinus fonts (or Linux Libertine O) as defaults.

    + +

    Since you will be using LuaTeX, the font cache will be updated to include the newly-installed fonts, the next time you run this software. However, I recommend that you force a full cache refresh, by locating the luatex-cache directory, and discard its contents. The cache may be anywhere (sadly), so you will have to hunt for it. If you have never used LuaTeX before, it may not exist. If there are any updates to the fonts, then a manual cache refresh is necessary.

    + +

    1.1.3 Credits

    My method of "programming" (note the scare quotes) largely involves looking for solutions on the Internet, then using or modifying code provided by others with allowable license terms. Thus, within the TeX code files, you will find places where small or large pieces of code are the work of someone else, released by them for LaTeX purposes. Names or organizations are credited where the code is used.

    Various clipart graphics were obtained from openclipart.org. The NovelDeco.otf font is partly derived from [Linux] Libertine O, using FontForge.

    + +

    1.1.4 Useful Tools

    + +

    Before sending your PDF file anywhere, you should always open it in Adobe Reader, and inspect it. If you are on a system that does not have that software, then find a friend who has it. The reason is that some other PDF readers will not object to problem files, but Adobe Reader will complain.

    + +

    In commercial printing, it is not necessary that your file be "optimized for fast web view" or "linearized." Nevertheless, some services do a lot of work with e-books, and may request that printer files be optimized or linearized, out of force of habit. The free qpdf command-line tool, available for Linux and Windows, is your friend.

    +

    Your PDF cannot be encrypted or password-protected for commercial printing. Only you and the printer are supposed to see it. So, it is always possible to extract the text, not as a TeX document, but as plain text. Adobe Reader probably will not do what you expect. Adobe Acrobat Pro does a good job, if you first "add tags" via its accessibility features. Otherwise, the free Okular PDF reader does a reasonable job, as does the pdftotext command-line program (part of xpdf. Be sure to request that layout be preserved. You may need to review the exported text for words that were broken by hyphenation, and re-assemble the words.

    @@ -207,11 +220,13 @@

    There are several ways that novel is very different from other TeX document classes. Before you wonder why your document doesn't work, you need to understand the differences. All of these are features, not bugs. They are done with the intent of making novel best for its intended purpose.

    +

    About TeX editors: If you usually use a TeX editor GUI, such as Lyx or TeXstudio, avoid using it with the novel class. Those editors are capable of inserting standard LaTeX code from menus. However, novel does not necessarily use that standard LaTeX code. The result may be unexpected. Instead, create your document in an ordinary ut-8 plain text editor, and compile with lualatex from the command line. Or, you can use the TeXWorks editor, as long as you turn off features such as automatic smart quotes.

    +

    1.2.1 LuaLaTeX, fontspec, utf-8, and Open Type fonts

    -

    Thou Shalt With novel, you will be using the LuaLaTeX engine, whether you like it or not. No pdfTeX, no XeTeX, no dvips. You do not have to understand Lua code, since the heavy lifting is already done for you.

    +

    Thou Shalt With novel, you will be using the LuaLaTeX engine, whether you like it or not. No pdfTeX, no XeTeX, no dvips. You do not have to understand Lua code, since the heavy lifting is already done for you.

    Forget about fontenc and OT1 and other TeX exotica that go so far back in time, most folks did not have a cell phone. The built-in fontspec package handles modern Open Type fonts, and is able to access their internal features. The syntax is easy to learn, and very powerful. And, you can directly include text with diacritical marks, Greek, Cyrillic, and most other utf-8 encoded characters in your document. All you need are the fonts. You will wonder why you never did this before. The method for loading fonts is described on Page 5.

    You must use utf-8 (Unicode) encoding in all parts of your code and document. No choice. Only utf-8, without BOM. Instead of typing TeX codes such as \`{e} you can simply paste è from a Unicode character map. Other alphabets such as Greek and Cyrillic are directly supported, if your fonts support those character sets.

    Be sure that your editor uses utf-8 encoding without BOM. If you are on Linux (and presumably OS/X) then this is the default for your system. If you are on Windows, do not use Notepad! The free Notepad++ program (also Portable version) does the job. Configure it as specified.

    @@ -220,7 +235,7 @@

    1.2.2 A dollar is a dollar, not math mode

    -

    a dollar is a dollar When you type $ in the document body, with or without a preceding backslash, you do not enter or leave math mode. What you get is the dollar symbol. This has no effect in the Preamble, where the dollar sign has its usual TeX special meaning.

    +

    a dollar is a dollar When you type $ in the document body, with or without a preceding backslash, you do not enter or leave math mode. What you get is the dollar symbol. This has no effect in the Preamble, where the dollar sign has its usual TeX special meaning.

    If you really need math mode, you can use \( ... \). But, why? You are writing a novel, yes? You shouldn't need math mode.

    @@ -241,7 +256,7 @@

    1.2.5 Numerous academic-purpose commands are disabled

    -

    flunked math Commands such as \section, \chapter, \abstract, \index, \tableofcontents, \maketitle, and many other structural commands will not work with novel. Those are for academic papers. The results they would produce (if enabled) would be inappropriate for fiction. If you attempt to use them, you will either get an error message, or they will simply be ignored.

    +

    flunked math Commands such as \section, \chapter, \abstract, \index, \tableofcontents, \maketitle, and many other structural commands will not work with novel. Those are for academic papers. The results they would produce (if enabled) would be inappropriate for fiction. If you attempt to use them, you will either get an error message, or they will simply be ignored.

    Novelists do not need many ways to distinguish chapters. With novel there are commands specifically created for the needs of fictional works. They are described on Page 9.

    Also, the float and table environments are ineffective.

    @@ -271,7 +286,7 @@

    A sheet of paper is a single, physical piece of paper, regardless of whether anything is printed on it, or where. Often, paper starts out as a large sheet that will subsequently be cut into smaller sheets. The size doesn't matter. A sheet of paper is, in ordinary understanding, a piece of paper.

    -

    page, leaf In a finished book, a page is one side of a leaf. Thus, there are always exacttly twice as many pages are there are leaves. From the manufacturer's point of view, a 240-page (double-sided printing) book has 120 leaves, regardless of whether or not anything is printed on the pages, or how they are numbered.

    +

    page, leaf In a finished book, a page is one side of a leaf. Thus, there are always exacttly twice as many pages are there are leaves. From the manufacturer's point of view, a 240-page (double-sided printing) book has 120 leaves, regardless of whether or not anything is printed on the pages, or how they are numbered.

    If you take a sheet of 8.5" x 11" paper, and fold it in half across its width, you create a folio, consisting of one sheet of paper (as before), two leaves (previously one), and four pages (previously two), sized 5.5" x 8.5". Now, think about how those four pages must be numbered. Page 1 and page 4 are printed on the same side of the sheet, with pages 2 and 3 on the opposite side of the sheet. This is not the order they would be printed, if you were merely shrinking the text so that twice as much fit on one side of the sheet. The process of re-arranging the pages, and placing them in the correct positions (often involving rotation) is called imposition. Your home printer can do it, for the simple example described. But in the case of commercial book preparation, the imposition process is much more involved, and uses advanced software.

    @@ -281,13 +296,13 @@

    1.3.2 Page Spread, Recto, Verso, Line Grid

    -

    line grid When a book is opened somewhere in its middle, you see a page spread. At right is the recto odd-numbered page, and at left is the verso even-numbered page. With continuous text, the lines of text on the verso must be in the same vertical position as the lines of text on the recto, and each line must be equally spaced. This is the line grid. Maintaining a proper line grid is essential to the novel class, and is why some novel commands differ from how they are used in academic works with other document classes.

    +

    line grid When a book is opened somewhere in its middle, you see a page spread. At right is the recto odd-numbered page, and at left is the verso even-numbered page. With continuous text, the lines of text on the verso must be in the same vertical position as the lines of text on the recto, and each line must be equally spaced. This is the line grid. Maintaining a proper line grid is essential to the novel class, and is why some novel commands differ from how they are used in academic works with other document classes.

    1.3.3 Perfect Binding, Spine, Signature

    -

    perfect binding Most modern softcover books (and some inexpensive hardcovers) are manufactured using a process named Perfect Binding. The finished book has individual foils, glued together at the spine. There are several stages to the process. First, the books is subdivided into a number of signatures, each of which is a group of folios (typically 6). The imposition software calculates which page goes at which position on each folio, and also tweaks the positions to allow for the slight displacement of each folio, due to paper thickness. In each signature, the folios are like nested V. The signatures are clamped together in a block. Then the folded area is removed by a machine, so that there are no longer any signatures or folios, just individual leaves. Finally they are glued together, possibly with a reinforcement, and the cover is attached.

    +

    perfect binding Most modern softcover books (and some inexpensive hardcovers) are manufactured using a process named Perfect Binding. The finished book has individual foils, glued together at the spine. There are several stages to the process. First, the books is subdivided into a number of signatures, each of which is a group of folios (typically 6). The imposition software calculates which page goes at which position on each folio, and also tweaks the positions to allow for the slight displacement of each folio, due to paper thickness. In each signature, the folios are like nested V. The signatures are clamped together in a block. Then the folded area is removed by a machine, so that there are no longer any signatures or folios, just individual leaves. Finally they are glued together, possibly with a reinforcement, and the cover is attached.

    If you order your book in hardcover, it is likely to use the same production method, but with harder covers. So, don't think that your hadcover book will be like the expensive reference books you see in the library. Those books use a different, and much more expensive, binding method.

    @@ -295,14 +310,14 @@

    1.3.4 Gutter

    -

    perfect binding To allow for the fact that most binding cannot be opened flat, the spine edge of each page must have an allowance for the loss of visible area there. The word gutter is used in this context.

    +

    perfect binding To allow for the fact that most binding cannot be opened flat, the spine edge of each page must have an allowance for the loss of visible area there. The word gutter is used in this context.

    Alas, some folks use gutter to mean the extra allowance for each page; others use it to mean the combined allowance for a two-page spread; and others use it to mean the full spine-side margin from the text, which is a larger value. So if you read about the gutter from different sources, the numbers may not make sense, because the word is being used with different meanings. It could be any of A, B, C, or D in the accompanying diagram. I won't be using the term, except indirectly.

    1.3.5 Trim Size

    -

    trim size recto Trim Size is the finished size of your book, width and height (but not thickness). In the case of hardcover books, where the cover is larger than the contents, it is (usually) the cover size that is measured, with the internal trim size being slightly smaller than nominal

    +

    trim size recto Trim Size is the finished size of your book, width and height (but not thickness). In the case of hardcover books, where the cover is larger than the contents, it is (usually) the cover size that is measured, with the internal trim size being slightly smaller than nominal

    In the USA, 5.5" x 8.5" is often used for softcover fiction. This is the default setting in novel. It seems to be the case that nonfiction prefers the slightly larger 6" x 9" trim size. Both of these are known as "trade" sizes.

    @@ -314,7 +329,7 @@

    1.3.6 Media Size, TrimBox

    -

    media size recto In a few cases, the commercial printer will request that the PDF page size be something larger than the Trim Size of your book. In PDF terminology, the larger dimensions are the Media Size. Typically, the Media Size will be U.S. Letter, or A4, and the Trim Size must be floated in the center, horizontally and vertically. As an alternative, the Trim Size will be at the edge. Something of the sort happens when you print a copy of your PDF at home, where your printer's paper tray has letter or A4, not the Trim Size.

    +

    media size recto In a few cases, the commercial printer will request that the PDF page size be something larger than the Trim Size of your book. In PDF terminology, the larger dimensions are the Media Size. Typically, the Media Size will be U.S. Letter, or A4, and the Trim Size must be floated in the center, horizontally and vertically. As an alternative, the Trim Size will be at the edge. Something of the sort happens when you print a copy of your PDF at home, where your printer's paper tray has letter or A4, not the Trim Size.

    Do not use a Media Size larger than the Trim Size, unless the commercial printer requests it.

    Since your PDF is being prepared for commercial print production, it will have an invisible TrimBox automatically encoded. This information tell the printer where the Trim Size is located. If (as usual) the Trim Size and Media Size are identical, then the TrimBox is the full size of the PDF page. But when the Trim Size is smaller than the Media Size, the TrimBox defines where the paper will be trimmed. Although it is not normally marked on the PDF page and never appears in print, some PDF viewers allow you make the TrimBox visible.

    In the accompanying diagram, the TrimBox is shown as a green line. The margins, shaded gray, are measured relative to the Trim Size, not relative to the Media Size. The excess area beyond the Trim Size is "wasted paper" that will not become part of the book.

    @@ -472,10 +487,10 @@

    Default: off (no compliance set)

    PDF/X describes a set of industry standards for print-ready PDF files. Your print service will probably require you to use it.

    -
    Advanced:
    \SetApplication{software that created the source document}
    +
    Advanced:
    \SetApplication{software that created the source document}

    Default: an identifying string, automatically inserted by TeX.

    -
    Advanced:
    \SetProducer{software that compiled the PDF}
    +
    Advanced:
    \SetProducer{software that compiled the PDF}

    Default: an identifying string, automatically inserted by TeX.

    @@ -514,19 +529,19 @@

    Default: Calculated automatically from other layout settings.

    Main text, not including header/footer. Note than baseline skip (leading) is always calculated, not set by user.

    -
    Advanced:
    \SetMediaSize[alignment]{width}{height}
    +
    Advanced:
    \SetMediaSize[alignment]{width}{height}

    Default: Identical to Trim Size.

    When Trim Size is on larger Media Size.

    -
    Advanced:
    \SetCropmarkGap{size of gap}
    +
    Advanced:
    \SetCropmarkGap{size of gap}

    Default: 0.125in (only effective with cropmarks class option)

    Sets gap between TrimBox and cropmarks, when cropmarks are used.

    -
    Advanced:
    \ReworkTrimSize{width}{height}
    +
    Advanced:
    \ReworkTrimSize{width}{height}

    For emergency use only.

    Re-sizes an already-finished layout.

    -
    Advanced:
    \ReworkMargins{top}{outside}{bottom}{inside}
    +
    Advanced:
    \ReworkMargins{top}{outside}{bottom}{inside}

    For emergency use only.

    Re-sizes an already-finished layout.

    @@ -558,21 +573,21 @@

    Default: [Numbers=Lining, Scale=1.2]{*}

    Used in \ChapterSubtitle{} command.

    -
    Advanced:
    \SetDecoFont[features]{font}
    +
    Advanced:
    \SetDecoFont[features]{font}

    Default: NovelDeco (any setting must used a derivative of NovelDeco)

    Automatically applied as {\decofont...} by certain other commands.

    -
    Advanced:
    \SetSansFont[features]{font family}
    +
    Advanced:
    \SetSansFont[features]{font family}

    Default: Libertinus Sans

    Alternate: Linux Biolinum O

    Rarely used in fiction.

    -
    Advanced:
    \SetMonoFont[features]{font family}
    +
    Advanced:
    \SetMonoFont[features]{font family}

    Default: Libertinus Mono

    Alternate: Linux Libertine Mono O

    Rarely used in fiction.

    -
    Advanced:
    \NewFontFamily\yourfontcommand[features]{font family}
    +
    Advanced:
    \NewFontFamily\yourfontcommand[features]{font family}
    \NewFontFace\yourfontcommand[features]{font}

    These use fontspec to define your own font commands.

    @@ -590,15 +605,15 @@

    Default: Adjusted author, in small caps

    The text appears in verso headers, if the page style has headers. This command may also be used from time to time in the document body.

    -
    Advanced:
    \SetEmblems{verso}{recto}
    +
    Advanced:
    \SetEmblems{verso}{recto}

    Default: both empty

    Applies a decoration (emblem) near the page number. Only for selected header/footer styles.

    -
    Advanced:
    \SetPageNumberStyle{code using \thepage}
    +
    Advanced:
    \SetPageNumberStyle{code using \thepage}

    Default: \thepage

    Allows page number to be styled (such as italics).

    -
    Advanced:
    \SetLooseHead{number}
    +
    Advanced:
    \SetLooseHead{number}

    Default: 50

    Tweaks tracking of header text, 0 to 200.

    @@ -606,19 +621,19 @@

    Default: footer (no header, footer only if used)

    Sets the default page style for the start of new chapters. May be locally changed.

    -
    Advanced:
    \SetIndentAfterScenebreak
    +
    Advanced:
    \SetIndentAfterScenebreak

    Default: unset (new scenes do not begin with indent)

    If set, new scenes start with paragraph indent.

    -
    Advanced:
    \SetMarkerStyle[real/fake]{asterisk/dagger/number}
    +
    Advanced:
    \SetMarkerStyle[real/fake]{asterisk/dagger/number}

    Default: [real]{asterisk}

    Used for superscripts, subscripts, footnote markers.

    -
    Advanced:
    \microtypesetup{see microtype package docs}
    +
    Advanced:
    \microtypesetup{see microtype package docs}

    Default: config=novel-microtype,stretch=20,shrink=20,final,tracking

    Defaults are set for moderate typography suited to fiction. Options final,tracking will always be in effect.

    -
    Advanced:
    \setmainlanguage{language} and related commands
    +
    Advanced:
    \setmainlanguage{language} and related commands

    Default: english

    Several commands from the polyglossia package may be used for language choices.

    @@ -646,9 +661,8 @@ -

    1.6.2 Display Pages

    +

    1.6.2 Special Pages

    -

    A display page is one that either stands by itself (such as the book's copyright page), or provides a distinctive opening to new content (such as a chapter title page). In other words, a display page is one that does not merely contain the continuation of flowing text.

    \begin{legalese} ... \end{legalese}

    Changes text alignment to left (ragged right), and disables hyphenation. Useful for copyright page. See also parascale environment.

    @@ -659,7 +673,7 @@
    \tocitem[number]{title}{page}

    Item, such as chapter, in the toc environment.

    -
    \begin{ChapterDisplay}[line count] ... \end{ChapterDisplay}
    +
    \begin{ChapterStart}[line count] ... \end{ChapterStart}

    Creates an area of fixed height, into which items such as \ChapterTitle may be placed.

    \ChapterTitle{text}
    @@ -711,14 +725,14 @@
    \endnotetext{number}{note text}

    Write the endnote text.

    -
    \realmarker
    \fakemarker
    +
    \realmarker
    \fakemarker

    Changes whether marker style is real or fake.

    1.6.5 Images

    -
    \InlineImage[hoffset][voffset]{filename.ext}
    \InlineImage*[hoffset][voffset]{filename.ext}
    +
    \InlineImage[hoffset][voffset]{filename.ext}
    \InlineImage*[hoffset][voffset]{filename.ext}

    Places an image that may be mingled in-line with text.

    \BlockImage[alignment,hoffset,voffset]{filename.ext}[accompanying text]
    @@ -737,7 +751,7 @@

    Applies the font defined as \somefontcommand to the included text.

    Example: {\headfont text} is automatically used for headers/footers.

    -
    \forceindent
    \backindent
    +
    \forceindent
    \backindent

    May be used in situations where ordinary \indent or \noindent fail.

    \hangindent{text}
    @@ -749,10 +763,10 @@
    \decoglyph{}

    Selects a decorative glyph from the decofont. Glyphs are chosen from a code table.

    -
    \squeeze{text}
    \crush{text}
    +
    \squeeze{text}
    \crush{text}

    Horizontally shrinks text by 1% or 2%, respectively.

    -
    \color[gray]{name or code} ... until group ends
    \textcolor[gray]{name or code}{text}
    +
    \color[gray]{name or code} ... until group ends
    \textcolor[gray]{name or code}{text}

    These commands from package xcolor have been modified so that they will only accept grayscale, and only when the graytext class option is used. Otherwise, K black is produced. Images are unaffected.

    \memo{text}
    @@ -761,7 +775,7 @@
    $ (dollar symbol)

    In document body: $ means dollar, not math mode.

    -
    \nfs
    \nbs
    +
    \nfs
    \nbs

    These are abbreviations for the lengths normal font size and normal baseline skip.

    @@ -770,6 +784,9 @@

    These commands are defined by LaTeX or by a package that is automatically loaded with novel, or are standard commands given an alias for convenience. There are many other LaTeX commands that may be used, but these are most likely to be useful. Most of these are not documented by novel, since their usage is well-known.

    +
    \textit{text}, \emph{text}, \itshape{text}
    +

    Various ways to implement italics.

    +
    \textsc{text}, \smcp{text}

    Lowercase to small caps. Novel uses the smcp Open Type feature, and does not fake small caps.

    @@ -843,7 +860,7 @@
    \maketitle

    Sorry, but you have to do it yourself.

    -
    bibliography, index, etc.
    part, chapter, section, etc.
    floats, captions, tables
    +
    bibliography, index, etc.
    part, chapter, section, etc.
    floats, captions, tables

    This ain't no stinking thesis. LaTeX "academic layout" commands don't work.

    @@ -853,7 +870,7 @@

    These commands may be used, but are likely to interfere with other commands defined by novel, or are likely to disturb the constant baseline grid. Only use them when you are willing to carefully inspect the output at magnification. These are less likely to be problematic when used on a display-only page, such as the book's title page.

    This is not a comprehensive list. It includes only popular commands.

    -
    \parbox
    \minipage
    +
    \parbox
    \minipage

    Perhaps the adjustwidth environment will sui your needs.

    center environment
    diff --git a/Master/texmf-dist/doc/lualatex/novel/noveldocs-02-class-options.html b/Master/texmf-dist/doc/lualatex/novel/noveldocs-02-class-options.html index aba89722db6..48b68571351 100644 --- a/Master/texmf-dist/doc/lualatex/novel/noveldocs-02-class-options.html +++ b/Master/texmf-dist/doc/lualatex/novel/noveldocs-02-class-options.html @@ -1,9 +1,9 @@ - + Class novel - 2 - Class Options - + @@ -37,7 +37,7 @@

    Documentation for novel document class

    -

    Documentation version: 1.0.7.

    +

    Documentation version: 1.0.9.

    @@ -78,7 +78,7 @@

    In draft mode, a little black bar will be placed at the right side of text that didn't quite fit on the line. These locations are reported in the log file as "overfull hbox" warnings. The black bar is called an "overflow rule".

    -

    overflow rule

    +

    overflow rule

    Some packages take note of whether or not the document is in draft mode, and change their behavior accordingly. However, the included microtype package will always be in final mode, and the included hyperref package will always be in draft mode.

    @@ -92,7 +92,7 @@

    The graytext option over-rides this restriction, and obeys grayscale color commands from the xcolor package, which is already loaded with the class. Non-grayscale colors will be converted to shades of gray. The color commands are discussed on Page 7.

    -

    graytext

    +

    graytext

    Your book will not be printed with "gray ink." Instead, anything other than pure black will be emulated by a pattern of black dots. This is known as "halftone." It causes a reduction in resolution, so your gray text will appear somewhat fuzzy. In addition, the halftone operation may extend to nearby text that is not gray. So: Unlike the example shown above, it is a bad idea to mingle gray with the ordinary flow of black text. The most appropriate use of gray text is for special items such as chapter titles.

    @@ -103,7 +103,7 @@

    2.3 shademargins

    This option is ignored unless using draft mode. It is not necessary to use the graytext option.

    -

    shademargins The shademargins option is simple: The margins will have a light gray background. Note that margins refers to the area between the live text area (including head/foot, if any) and the TrimBox, which is the finished size of your book. If you are using \SetMediaSize to request paper larger than your book's Trim Size, the excess area is not considered to be margins; it is discarded paper, so it is not gray.

    +

    shademargins The shademargins option is simple: The margins will have a light gray background. Note that margins refers to the area between the live text area (including head/foot, if any) and the TrimBox, which is the finished size of your book. If you are using \SetMediaSize to request paper larger than your book's Trim Size, the excess area is not considered to be margins; it is discarded paper, so it is not gray.

    Some commands (in particular, images) allow their content to overflow the textblock area. With shademargins you can see where such object intrude into the margins.

    Sometimes it is hard to see whether a centered object is really centered, because the left-right margins are not the same width. With shademargins you can more easily see centering.

    Note that headers and footers are not part of the margins.

    @@ -116,13 +116,13 @@

    2.4 cropmarks

    -

    cropmarks This option is ignored if the TrimSize is the same as the MediaSize (the usual situation). It works whether or not in draft mode.

    +

    cropmarks This option is ignored if the TrimSize is the same as the MediaSize (the usual situation). It works whether or not in draft mode.

    If the PDF Media Size is larger than its finished TrimSize, you can place crop marks (also known as trim marks) to indicate where the paper will be cut. The cropmarks option makes the marks visible. If this option is not used, then no marks are placed, regardless of any other commands.

    Note that most print-on-demand book printers do not want crop marks. The process flow is automated, and trim data is read from within the PDF. Crop marks may actually interfere with proper layout, if your PDF is re-formatted to share a large sheet of paper along with other pages. So, do not use cropmarks unless you must. For this reason, the built-in capability for cropmarks is very basic.

    -

    cropmark gap There is only one configurable setting, which may be used in the Preamble:

    +

    cropmark gap There is only one configurable setting, which may be used in the Preamble:

    \SetCropmarkGap{length}

    @@ -134,7 +134,7 @@

    2.5 cropview

    -

    cropview This option is ignored if the TrimSize is the same as the MediaSize (the usual situation), because it is unnecessary. Also, it is ignored unless using draft mode.

    +

    cropview This option is ignored if the TrimSize is the same as the MediaSize (the usual situation), because it is unnecessary. Also, it is ignored unless using draft mode.

    With cropview, there is an internal instruction to PDF viewers, requesting that only the Trim Size be displayed on the screen, rather than the whole Media Size. This is useful during the layout phase, because it is hard to visualize layout when you have a small finished size floating in a much larger paper size. Nothing else is changed.

    @@ -144,7 +144,7 @@

    2.6 closecrop

    -

    closecrop This option is only effective in draft mode. When used, the layout of your text is unchanged, but the surrounding margins are shrunk so that they just clear the live text area (which includes header and footer, if present). Also, the TrimSize is shrunk accordingly. Left and right margins are the same. The resulting PDF will be easier to read on a handheld device.

    +

    closecrop This option is only effective in draft mode. When used, the layout of your text is unchanged, but the surrounding margins are shrunk so that they just clear the live text area (which includes header and footer, if present). Also, the TrimSize is shrunk accordingly. Left and right margins are the same. The resulting PDF will be easier to read on a handheld device.

    This does not produce an E-book, since the file will be missing some things that an E-book ought to have. The sole purpose of this option is to create a conveniently-sized file that you can carry around while you are thinking about edits and revisions.

    diff --git a/Master/texmf-dist/doc/lualatex/novel/noveldocs-03-metadata-pdfx.html b/Master/texmf-dist/doc/lualatex/novel/noveldocs-03-metadata-pdfx.html index 81a494a90d9..274cf5d3c21 100644 --- a/Master/texmf-dist/doc/lualatex/novel/noveldocs-03-metadata-pdfx.html +++ b/Master/texmf-dist/doc/lualatex/novel/noveldocs-03-metadata-pdfx.html @@ -1,9 +1,9 @@ - + Class novel - 3 - Metadata, PDFX - + @@ -35,7 +35,7 @@
  • 3.3.1 \SetTitle{}
  • 3.3.2 \SetAuthor{}
  • 3.3.3 \SetSubtitle{}
  • -
  • 3.3.4 \SetApplication{}
    +
  • 3.3.4 \SetApplication{}
    3.3.4 \SetProducer{}
  • 3.4 \SetPDFX[]{} @@ -58,7 +58,7 @@

    Documentation for novel document class

    -

    Documentation version: 1.0.7.

    +

    Documentation version: 1.0.9.

    @@ -95,7 +95,7 @@

    3.1.1 ISBN Metadata

    -

    online form for ISBN metadata When you obtain the ISBN for your book, either directly through the issuing agency or via your chosen print service, you will enter ISBN Metadata in an online form. This metadata will go into a database, and identify your printed book in distribution and sales channels. It neither knows nor cares about PDF. (If you were marketing an e-book, instead of print, that would be a different story.)

    +

    online form for ISBN metadata When you obtain the ISBN for your book, either directly through the issuing agency or via your chosen print service, you will enter ISBN Metadata in an online form. This metadata will go into a database, and identify your printed book in distribution and sales channels. It neither knows nor cares about PDF. (If you were marketing an e-book, instead of print, that would be a different story.)

    ISBN Metadata includes title, author(s), subtitle if any, ISBN, other identifying information, and a description. The description is by way of advertising, and can usually be changed later; it need not appear anywhere in your book or PDF file, although some authors might use the description on the book's rear cover or cover flap.

    @@ -105,7 +105,7 @@

    3.1.2 Printed Metadata

    -

    printed metadata, cover page Printed Metadata refers to the information that can be seen on paper, in expected places: the book cover, the title page, and the copyright page. Whether your book was printed from a PDF file, or by some other method, is not relevant.

    +

    printed metadata, cover page Printed Metadata refers to the information that can be seen on paper, in expected places: the book cover, the title page, and the copyright page. Whether your book was printed from a PDF file, or by some other method, is not relevant.

    Your print service will insist that the title, subtitle (if any), author, and ISBN in these places exactly match what appears in the ISBN database. Of course, you can (and usually will) use styling or images to make the Printed Metadata more attractive than the plain-text ISBN Metadata.

    @@ -115,7 +115,7 @@

    3.1.3 File Data (PDF Metadata)

    -

    PDF metadata When your PDF file is produced, internal metadata will be automatically created for the benefit of PDF reader software. To avoid confusion, this documentation uses the term "File Data" to mean this internal PDF metadata. You can see some of the File Data when you open the PDF in any reader, and go to File>Properties. To see all of it, you need professional software (such as Adobe Acrobat Pro).

    +

    PDF metadata When your PDF file is produced, internal metadata will be automatically created for the benefit of PDF reader software. To avoid confusion, this documentation uses the term "File Data" to mean this internal PDF metadata. You can see some of the File Data when you open the PDF in any reader, and go to File>Properties. To see all of it, you need professional software (such as Adobe Acrobat Pro).

    Be sure to read the rules for File Data, below. Some of it is generic, and some is particular to TeX or to the novel class.

    @@ -269,8 +269,8 @@

    Although many *.icc files 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:

    -Windows: C:/Windows/System32/spool/drivers/color/   [older Windows: system32 instead of System32]
    -Linux: /usr/share/color or hidden ~/.local/share/icc/ or other places
    +Windows: C:/Windows/System32/spool/drivers/color/   [older Windows: system32 instead of System32]
    +Linux: /usr/share/color or hidden ~/.local/share/icc/ or other places
    OSX: /Library/Colorsync/Profiles/ or hidden (username)/Library/Colorsync/Profiles/

    If you do not have the files, look on the Internet here and here. These links also have many other profiles, beyond the basic three. In a few cases, your print service may provide the necessary file.

    diff --git a/Master/texmf-dist/doc/lualatex/novel/noveldocs-04-layout.html b/Master/texmf-dist/doc/lualatex/novel/noveldocs-04-layout.html index 2b276446e6c..41d258d37bf 100644 --- a/Master/texmf-dist/doc/lualatex/novel/noveldocs-04-layout.html +++ b/Master/texmf-dist/doc/lualatex/novel/noveldocs-04-layout.html @@ -1,9 +1,9 @@ - + Class novel - 4 - Book Size and Page Layout - + @@ -38,7 +38,7 @@
  • 4.2.3 \SetFontSize{}
  • 4.2.4 \SetLinesPerPage{}
  • 4.2.5 \SetHeadFootStyle{}
  • -
  • 4.2.6 \SetHeadJump{}
    4.2.6 \SetFootJump{}
  • +
  • 4.2.6 \SetHeadJump{}
    4.2.6 \SetFootJump{}
  • 4.2.7 \SetMediaSize[]{}{}
  • 4.2.8 \SetCropmarkGap{}
  • @@ -65,7 +65,7 @@

    Documentation for novel document class

    -

    Documentation version: 1.0.7.

    +

    Documentation version: 1.0.9.

    @@ -110,7 +110,7 @@

    A sheet of paper is a single, physical piece of paper, regardless of whether anything is printed on it, or where. Often, paper starts out as a large sheet that will subsequently be cut into smaller sheets. The size doesn't matter. A sheet of paper is, in ordinary understanding, a piece of paper.

    -

    page, leaf In a finished book, a page is one side of a leaf. Thus, there are always exactly twice as many pages are there are leaves. From the manufacturer's point of view, a 240-page (double-sided printing) book has 120 leaves, regardless of whether or not anything is printed on the pages, or how they are numbered.

    +

    page, leaf In a finished book, a page is one side of a leaf. Thus, there are always exactly twice as many pages are there are leaves. From the manufacturer's point of view, a 240-page (double-sided printing) book has 120 leaves, regardless of whether or not anything is printed on the pages, or how they are numbered.

    If you take a sheet of 8.5" x 11" paper, and fold it in half across its width, you create a folio, consisting of one sheet of paper (as before), two leaves (previously one), and four pages (previously two), sized 5.5" x 8.5". Now, think about how those four pages must be numbered. Page 1 and page 4 are printed on the same side of the sheet, with pages 2 and 3 on the opposite side of the sheet. This is not the order they would be printed, if you were merely shrinking the text so that twice as much fit on one side of the sheet. The process of re-arranging the pages, and placing them in the correct positions (often involving rotation) is called imposition. Your home printer can do it, for the simple example described. But in the case of commercial book preparation, the imposition process is much more involved, and uses advanced software.

    @@ -120,13 +120,13 @@

    4.1.2 Page Spread, Recto, Verso, Line Grid

    -

    line grid When a book is opened somewhere in its middle, you see a page spread. At right is the recto odd-numbered page, and at left is the verso even-numbered page. With continuous text, the lines of text on the verso must be in the same vertical position as the lines of text on the recto, and each line must be equally spaced. This is the line grid. Maintaining a proper line grid is essential to the novel class, and is why some novel commands differ from how they are used in academic works with other document classes.

    +

    line grid When a book is opened somewhere in its middle, you see a page spread. At right is the recto odd-numbered page, and at left is the verso even-numbered page. With continuous text, the lines of text on the verso must be in the same vertical position as the lines of text on the recto, and each line must be equally spaced. This is the line grid. Maintaining a proper line grid is essential to the novel class, and is why some novel commands differ from how they are used in academic works with other document classes.

    4.1.3 Perfect Binding, Spine, Signature

    -

    perfect binding Most modern softcover books (and some inexpensive hardcovers) are manufactured using a process named Perfect Binding. The finished book has individual foils, glued together at the spine. There are several stages to the process. First, the books is subdivided into a number of signatures, each of which is a group of folios (typically 1 or 6 folios per signature). The imposition software calculates which page goes at which position on each folio, and also tweaks the positions to allow for the slight displacement of each folio, due to paper thickness. In each signature, the folios are like nested V. The signatures are clamped together in a block. Then the folded area is removed by a machine, so that there are no longer any signatures or folios, just individual leaves. Finally they are glued together, possibly with a reinforcement, and the cover is attached.

    +

    perfect binding Most modern softcover books (and some inexpensive hardcovers) are manufactured using a process named Perfect Binding. The finished book has individual foils, glued together at the spine. There are several stages to the process. First, the books is subdivided into a number of signatures, each of which is a group of folios (typically 1 or 6 folios per signature). The imposition software calculates which page goes at which position on each folio, and also tweaks the positions to allow for the slight displacement of each folio, due to paper thickness. In each signature, the folios are like nested V. The signatures are clamped together in a block. Then the folded area is removed by a machine, so that there are no longer any signatures or folios, just individual leaves. Finally they are glued together, possibly with a reinforcement, and the cover is attached.

    If you order your book in hardcover, it is likely to use a similar production method, but with harder covers. So, don't think that your hadcover book will be like the expensive reference books you see in the library. Those books use a different, and much more expensive, binding method.

    @@ -134,14 +134,14 @@

    4.1.4 Gutter

    -

    Which gutter? To allow for the fact that most binding cannot be opened flat, the spine edge of each page must have an allowance for the loss of visible area there. The word gutter is used in this context.

    +

    Which gutter? To allow for the fact that most binding cannot be opened flat, the spine edge of each page must have an allowance for the loss of visible area there. The word gutter is used in this context.

    Alas, some folks use gutter to mean the extra allowance for each page; others use it to mean the combined allowance for a two-page spread; and others use it to mean the full spine-side margin from the text, which is a larger value. So if you read about the gutter from different sources, the numbers may not make sense, because the word is being used with different meanings. It could be any of A, B, C, or D in the accompanying diagram. I won't be using the term, except indirectly.

    4.1.5 Trim Size, Margins, Live Area

    -

    trim size recto Trim Size is the finished size of your book, width and height (but not thickness). In the case of hardcover books, where the cover is larger than the contents, it is (usually) the cover size that is measured, with the internal trim size being slightly smaller than nominal

    +

    trim size recto Trim Size is the finished size of your book, width and height (but not thickness). In the case of hardcover books, where the cover is larger than the contents, it is (usually) the cover size that is measured, with the internal trim size being slightly smaller than nominal

    In the USA, 5.5" x 8.5" is often used for softcover fiction. This is the default setting in novel. It seems to be the case that nonfiction prefers the slightly larger 6" x 9" trim size. Both of these are known as "trade" sizes.

    @@ -158,7 +158,7 @@

    4.1.6 Media Size, TrimBox

    -

    media size recto In a few cases, the commercial printer will request that the PDF page size be something larger than the Trim Size of your book. In PDF terminology, the larger dimensions are the Media Size. Typically, the Media Size will be U.S. Letter, or A4, and the Trim Size must be floated in the center, horizontally and vertically. As an alternative, the Trim Size will be at the edge. Something of the sort happens when you print a copy of your PDF at home, where your printer's paper tray has letter or A4, not the Trim Size.

    +

    media size recto In a few cases, the commercial printer will request that the PDF page size be something larger than the Trim Size of your book. In PDF terminology, the larger dimensions are the Media Size. Typically, the Media Size will be U.S. Letter, or A4, and the Trim Size must be floated in the center, horizontally and vertically. As an alternative, the Trim Size will be at the edge. Something of the sort happens when you print a copy of your PDF at home, where your printer's paper tray has letter or A4, not the Trim Size.

    Unless you explicitly set it to a different value, Media Size will automatically be set at Trim Size. Do not use a different Media Size, unless the commercial printer requests it.

    Since your PDF is being prepared for commercial print production, it will have an invisible TrimBox automatically encoded. This information tells the printer where the Trim Size is located. If (as usual) the Trim Size and Media Size are identical, then the TrimBox is the full size of the PDF page. But when the Trim Size is smaller than the Media Size, the TrimBox defines where the paper will be trimmed. Although it is not normally marked on the PDF page and never appears in print, some PDF viewers allow you make the TrimBox visible.

    In the accompanying diagram, the TrimBox is shown as a faint green line. The margins, shaded gray, are measured relative to the Trim Size, not relative to the Media Size. The excess area beyond the Trim Size is "wasted paper" that will not become part of the book.

    @@ -197,13 +197,13 @@

    4.2.2 \SetMargins{top}{outside}{bottom}{inside}

    -

    margins Mnemonic: "TOBI, or not TOBI, that is the question."

    +

    margins Mnemonic: "TOBI, or not TOBI, that is the question."

    When you choose your book's Trim Size, margins are pre-configured. In most cases, the top, outside, and bottom margins are 0.5", and the inside (spine) margin is 0.75" to allow 0.25" binding clearance. These values are acceptable to most American printers, unless your book is very thick. The largest Trim Sizes have slightly larger margins.

    Command \SetMargins lets you choose your own margins. If you use it, all four must be written, using units such as in or mm.

    -

    Which gutter? If your book has headers and/or footers, they sit inside the rectangle bounded by the margins. That is, they do not sit inside the peripheral areas cleared by the margins.

    +

    Which gutter? If your book has headers and/or footers, they sit inside the rectangle bounded by the margins. That is, they do not sit inside the peripheral areas cleared by the margins.

    Be aware that there is a lot of confusion regarding the word "gutter." In the accompanying diagram, it might mean any of A, B, C, or D, depending on who is doing the talking and which software is in use. The novel class uses inside margin, also known as spine margin, to mean C.

    @@ -230,7 +230,7 @@

    4.2.5 \SetHeadStyle{number}

    -

    head foot style 1 The use of this command is described on Page 6. It is mentioned here, because whether or not your book has headers and/or footers will affect the overall layout. The default is style 1, which has header but no footer (shown here).

    +

    head foot style 1 The use of this command is described on Page 6. It is mentioned here, because whether or not your book has headers and/or footers will affect the overall layout. The default is style 1, which has header but no footer (shown here).

    The pre-defined styles are comprehensive, for use in fiction. It is hard to imagine a header/footer style that is not identical to, or a variation from, one of those styles. But if you do wish to create your own style, you must use \SetHeadStyle to choose the closest available style, then use fancyhdr commands for your custom style. The reason is that \SetHeadStyle tells the layout engine how much space it needs to reserve.

    @@ -240,7 +240,7 @@

    Puzzled by TeX terms such as headsep and footskip? Me too! That's why I rewrote the way that the positions of headers and footers are calculated. Now, you can use easy-to-understand commands that do what you think they ought to be doing.

    -

    headjump 1
    footjump 2

    +

    headjump 1
    footjump 2

    The head and/or foot "jump" is a multiple of the normal baseline skip. When the jumps are set to 1, the header (if used) will be where the textblock would be, if it had one more line on top. The footer will be where the textblock would be, if it had one more line at the bottom. Values of 2 would skip a line at top and bottom. In other words, integer jumps maintain the line grid.

    Actually, the header and/or footer do not need to be on line grid. The defaults are 1.5 for each, which balances the need to separate the header/footer from the text, with the need to avoid wasting vertical space.

    @@ -265,11 +265,11 @@

    For PDF/X compliance, an invisible PDF TrimBox is automatically calculated and written into the PDF file.

    -

    media size larger than trim size The accompanying image shows how this works. Here is the code:

    +

    media size larger than trim size The accompanying image shows how this works. Here is the code:

    -

    \documentclass[draft,shademargins]{novel}
    -\SetTrimSize{5.5in}{8.5in}
    -\SetMediaSize{8.5in}{11in}
    +

    \documentclass[draft,shademargins]{novel}
    +\SetTrimSize{5.5in}{8.5in}
    +\SetMediaSize{8.5in}{11in}
    \SetMargins{0.5in}{0.5in}{0.5in}{0.75in}

    Trim Size 5.5"x8.5" is centered in Media Size 8.5"x11". The shademargins option was used, so that the page margins can be seen. Whether verso or recto, the Trim is centered in the Media. This image is a recto page, which has its slightly-larger inside margin at left of the text. For purposes of illustration, I have drawn the invisible TrimBox with a green line.

    @@ -278,13 +278,13 @@

    4.2.8 Advanced: \SetCropmarkGap{length}

    -

    media size larger than trim size This command is only effective if you use the cropmarks class option. Note that user-provided cropmarks are very unusual in the print-on demand market. Do not use them unless your print service specifically requests them. The built-in cropmark capability is very elementary, and cannot be easily enhanced by adding other LaTeX packages.

    +

    media size larger than trim size This command is only effective if you use the cropmarks class option. Note that user-provided cropmarks are very unusual in the print-on demand market. Do not use them unless your print service specifically requests them. The built-in cropmark capability is very elementary, and cannot be easily enhanced by adding other LaTeX packages.

    In the accompanying image with cropmarks, a corner of the Trim Size is at lower right. The invisible TrimBox has been drawn with a green line. The cropmark gap is G.

    -

    4.3 emergency icon Emergency Clinic: Rework

    +

    4.3 emergency icon Emergency Clinic: Rework

    Situation: Your book is designed for Trim Size 5.25x8, one of several widely-used American sizes. You have put many hours of work into getting just the right line breaks within paragraphs, and just the right pagination. It looks beautiful. But then you get an e-mail from a British distributor. Could you change to British size B novel format, essentially 5.06x7.81 Trim Size?

    Sure, you say. Just needs a little math. Knock 0.095" off each margin. What could be easier? So you try that, but the printer rejects your file. It seems that your original margins were as narrow as they could be, per the printer's specifications. You cannot make them any narrower.

    @@ -316,20 +316,20 @@

    In the following example, the original font size is 11pt, and the baselineskip (calculated based on other factors) is 14.377pt. After rework, the font size is automatically re-calculated to 10.468pt, with lineskip 13.883pt.

    -\documentclass{novel}
    -\SetTrimSize{5.25in}{8in} % Original. American.
    -\SetMargins{0.36in}{0.4in}{0.38in}{0.65in} % Original. American
    -\ReworkTrimSize{5.06in}{7.81in} % New. Equivalent to British 129mmW x 198mmH.
    +\documentclass{novel}
    +\SetTrimSize{5.25in}{8in} % Original. American.
    +\SetMargins{0.36in}{0.4in}{0.38in}{0.65in} % Original. American
    +\ReworkTrimSize{5.06in}{7.81in} % New. Equivalent to British 129mmW x 198mmH.
    \ReworkMargins{12mm}{12mm}{12mm}{15mm} % New. British.

    Result with original layout (above Rework commands commented out):

    -

    original spread, before rework

    +

    original spread, before rework

    Result after Rework:

    -

    spread after rework

    +

    spread after rework

    @@ -344,8 +344,8 @@

    • The biggest obstacle occurs when you specify some internal length in terms of absolute units (such as pt). It is always best to use relative units (such as em, or sometimes \nbs), so that they can be scaled along with the text:

    -Bad: \hspace{6pt}   Good: \hspace{0.5em}
    -Bad: \kern1pt   Good: \kern.08em
    +Bad: \hspace{6pt}   Good: \hspace{0.5em}
    +Bad: \kern1pt   Good: \kern.08em
    Bad: \vspace{0.5in}   Good: \vspace{2.4\nbs}

    diff --git a/Master/texmf-dist/doc/lualatex/novel/noveldocs-05-fonts.html b/Master/texmf-dist/doc/lualatex/novel/noveldocs-05-fonts.html index 4093a12f802..394eb63a993 100644 --- a/Master/texmf-dist/doc/lualatex/novel/noveldocs-05-fonts.html +++ b/Master/texmf-dist/doc/lualatex/novel/noveldocs-05-fonts.html @@ -1,9 +1,9 @@ - + Class novel - 5 - Fonts - + @@ -23,15 +23,15 @@
  • 5.1.1 Licensing
  • 5.1.2 Technical
  • 5.1.3 Appearance
  • -
  • 5.1.4 The Default Fonts
    +
  • 5.1.4 The Default Fonts
    5.1.4 Libertinus and NovelDeco
  • 5.2 Font Names, Files, Features
  • 5.3 Setting and Defining Fonts
      -
    • 5.3.1 General-Purpose Fonts
      +
    • 5.3.1 General-Purpose Fonts
      5.3.1 master, sans, mono
    • -
    • 5.3.2 Novel-Specific Fonts
      +
    • 5.3.2 Novel-Specific Fonts
      5.3.2 chapter, header, and others
    • 5.3.3 New Font Commands
    • 5.3.4 Which Font Features?
    • @@ -66,7 +66,7 @@

      Documentation for novel document class

      -

      Documentation version: 1.0.7.

      +

      Documentation version: 1.0.9.

      @@ -177,8 +177,8 @@

      -Windows 10 font viewer   -Ubuntu font viewer +Windows 10 font viewer   +Ubuntu font viewer

      @@ -189,7 +189,7 @@

      When you set an existing font, or create a new font command, you can use either the font (family) name, or the specific font file name. However, there may be a big difference in results!

      By family name:

      -

      font family defined When you use the font family name, you configure all of the Regular, Italic, Bold, and BoldItalic variants. The usual TeX commands will be applied:

      +

      font family defined When you use the font family name, you configure all of the Regular, Italic, Bold, and BoldItalic variants. The usual TeX commands will be applied:

      Preamble:

      \NewFontFamily\rway{Raleway}

      Document Body:

      @@ -197,7 +197,7 @@

      By file names:

      -

      font file defined However, if you specify the font file name, then only that font file will be used, regardless of requests for bold or italic. Small caps will be honored, if the specific file has them:

      +

      font file defined However, if you specify the font file name, then only that font file will be used, regardless of requests for bold or italic. Small caps will be honored, if the specific file has them:

      Preamble:

      \NewFontFamily\rwayi{Raleway-Regular-Italic.otf}

      Document Body:

      @@ -205,13 +205,13 @@

      File Name Combinations:

      -

      frankenfont What you write is what you get. You can customize a font family by individually selecting its members. Here is the syntax.

      +

      frankenfont What you write is what you get. You can customize a font family by individually selecting its members. Here is the syntax.

      Preamble:

      -

      \NewFontFamily\frankenfont[% note the % at linebreaks
      -  ItalicFont=BaskervilleF-Italic.otf,%
      -  BoldFont=libertinusserif-semibold.otf,%
      -  BoldItalicFont=texgyrepagella-bolditalic.otf,%
      +

      \NewFontFamily\frankenfont[% note the % at linebreaks
      +  ItalicFont=BaskervilleF-Italic.otf,%
      +  BoldFont=libertinusserif-semibold.otf,%
      +  BoldItalicFont=texgyrepagella-bolditalic.otf,%
      ]{Raleway-Medium.otf}

      Document Body:

      @@ -220,10 +220,10 @@

      Semibold, Light, etc.: The above syntax is especially useful when you wish to specify semibold (if available), rather than bold. It is also a way to select something such as light versions:

      -

      \NewFontFamily\rwlight[% note the % at linebreaks
      -  ItalicFont=Raleway-Light-Italic.otf,%
      -  BoldFont=Raleway-Medium.otf,%
      -  BoldItalicFont=Raleway-Medium-Italic.otf,%
      +

      \NewFontFamily\rwlight[% note the % at linebreaks
      +  ItalicFont=Raleway-Light-Italic.otf,%
      +  BoldFont=Raleway-Medium.otf,%
      +  BoldItalicFont=Raleway-Medium-Italic.otf,%
      ]{Raleway-Light.otf}

      Note that the font file in braces is the one used as the "regular" font, in this definition.

      @@ -252,17 +252,17 @@ Some Frequently-Used Open Type Features

      kerning

      kern

      -

      Kerning=On
      enabled by default

      +

      Kerning=On
      enabled by default

      common ligatures

      liga

      -

      Ligatures=Common
      enabled: mainfont, sansfont

      +

      Ligatures=Common
      enabled: mainfont, sansfont

      Tex ligatures

      tlig

      -

      Ligatures=TeX
      enabled by default

      +

      Ligatures=TeX
      enabled by default

      lowercase letters to small caps

      @@ -282,7 +282,7 @@ Some Frequently-Used Open Type Features

      oldstyle numerals

      onum

      -

      Numbers=OldStyle
      enabled: mainfont, sansfont

      +

      Numbers=OldStyle
      enabled: mainfont, sansfont

      @@ -293,16 +293,16 @@ Some Frequently-Used Open Type Features

      • The SmallCaps feature applies only to lowercase letters; ordinary capitals remain ordinary capitals. UppercaseSmallCaps deals only with converting ordinary capitals to small caps. If you want both, use both. In most fonts that have them, small caps are slightly taller than lowercase, and slightly more widely spaced. What distinguishes real small caps from fake ones (obtained by scaling ordinary capitals) is that the weight and spacing are more compatible with surrounding text.

      -

      real vs fake small caps

      +

      real vs fake small caps

      • Lining numerals are the ones most familiar to you, from math or accounting. They sit on the baseline and have the height of capital letters. That's just right for doing calculations, and doesn't look bad for things such as page numbers and chapter numbers.

      • When lining numerals are mingled with flowing text, they may stand out too much. OldStyle numerals are more like flowing text: Most of the numerals are at lowercase height, with ascenders and descenders. Compare the first number as OldStyle, the second as Lining:

      -

      oldstyle vs lining numerals

      +

      oldstyle vs lining numerals

      Most fonts use Lining numerals as their default. A few default to OldStyle numerals. Thus, you should explicitly call for the kind of numerals you wish to use.

      -

      • True OldStyle numerals have a flat top on one, and a very round zero: true oldstyle 10 This may be a bit distracting. Some fonts use a transitional form, where the one has a tilted top (like big 1) and the zero is not so round: transitional oldstyle 10 Others offer you a choice, via an Open Type "style set." See the fontspec manual for how to code style sets.

      +

      • True OldStyle numerals have a flat top on one, and a very round zero: true oldstyle 10 This may be a bit distracting. Some fonts use a transitional form, where the one has a tilted top (like big 1) and the zero is not so round: transitional oldstyle 10 Others offer you a choice, via an Open Type "style set." See the fontspec manual for how to code style sets.

      • There are many more Open Type features, most of which are not useful in ordinary fiction writing. Fonts rarely have more than a few features. Some features (such as the ones shown above) have a specific meaning. Other features, such as "style sets", have whatever meaning the font designer assigns them; Thus the "ss03" feature of one font may do something very different from "ss03" in a different font.

      @@ -320,7 +320,7 @@ Some Frequently-Used Open Type Features

      The message was brief: \textls{\orbitron DIE, EARTHLING.} Captain Withens smiled as he oiled his ray-gun. But ray-guns don't use oil.\par

      -

      charscale text +

      charscale text

      Scale is more often used for fonts that are pre-defined to have a special meaning and location, such as chapter titles or page headers. There, the font is not mingled with ordinary text, and it is OK to use a larger Scale. Then, it is not necessary to use local font scaling commands each time the font is used.

      @@ -412,7 +412,7 @@ Some Frequently-Used Open Type Features

      Class novel comes with a variety of pre-configured header/footer styles and chapter titles. These are described in detail on other documentation pages. You do not have to set these unless you wish to do so, because all of them (except decofont will default to variations on the main font.

      Each of these font commands has an "intended" usage, shown in the following map. When you allow novel to style your document, it will automatically choose the right font for the right place. But if you create custom styles, you will have to specify the fonts.

      -

      map of standard font locations

      +

      map of standard font locations

      chapterfont
      @@ -484,18 +484,18 @@ Some Frequently-Used Open Type Features

      You have a font. It has Open Type features. But which features does it have? There are several ways to find out, but the simplest and most reliable way is to request a feature, and see what happens. For example:

      -% !TeX program = LuaLaTeX
      -% !TeX encoding = UTF-8
      -\documentclass{novel}
      -\setlength\parindent{0pt}
      -%
      -\NewFontFace\testlibserit[VerticalPosition=Superior]{libertinusserif-italic.otf}
      -\NewFontFace\testcin[VerticalPosition=Superior]{Cinzel-Regular.otf}
      -%
      -\begin{document}
      -Libertinus Serif, Italic:\\{\testlibserit 0123456789 abcdefghijklmnopqrstuvwxyz \#‡}\par
      -\null
      -Cinzel, Regular:\\{\testcin 0123456789 abcdefghijklmnopqrstuvwxyz \#‡}\par
      +% !TeX program = LuaLaTeX
      +% !TeX encoding = UTF-8
      +\documentclass{novel}
      +\setlength\parindent{0pt}
      +%
      +\NewFontFace\testlibserit[VerticalPosition=Superior]{libertinusserif-italic.otf}
      +\NewFontFace\testcin[VerticalPosition=Superior]{Cinzel-Regular.otf}
      +%
      +\begin{document}
      +Libertinus Serif, Italic:\\{\testlibserit 0123456789 abcdefghijklmnopqrstuvwxyz \#‡}\par
      +\null
      +Cinzel, Regular:\\{\testcin 0123456789 abcdefghijklmnopqrstuvwxyz \#‡}\par
      \end{document}\par

      @@ -524,10 +524,10 @@ Cinzel, Regular:\\{\testcin 0123456789 abcdefghijklmnopqrstuvwxyz \#‡}\par
      Two ways to accomplish the same thing:

      -\NewFontFamily\baskf{BaskervilleF}
      -\NewFontFamily\baskftab[Numbers=Monospaced]{BaskervilleF} % tnum feature
      -\begin{document}
      -Some text {\baskftab hello 123} is here.
      +\NewFontFamily\baskf{BaskervilleF}
      +\NewFontFamily\baskftab[Numbers=Monospaced]{BaskervilleF} % tnum feature
      +\begin{document}
      +Some text {\baskftab hello 123} is here.
      Some text {\baskf\addfontfeature{Numbers=Monospaced} hello 123} is here.

      diff --git a/Master/texmf-dist/doc/lualatex/novel/noveldocs-06-header-footer.html b/Master/texmf-dist/doc/lualatex/novel/noveldocs-06-header-footer.html index 3e3d6ea9a07..b06fb19eb97 100644 --- a/Master/texmf-dist/doc/lualatex/novel/noveldocs-06-header-footer.html +++ b/Master/texmf-dist/doc/lualatex/novel/noveldocs-06-header-footer.html @@ -1,9 +1,9 @@ - + Class novel - 6 - Headers and Footers - + @@ -19,7 +19,7 @@
      • 6.1 Global Header/Footer Settings
          -
        • 6.1.1 \SetHeadJump{}
          6.1.1 \SetFootJump{}
        • +
        • 6.1.1 \SetHeadJump{}
          6.1.1 \SetFootJump{}
        • 6.1.2 \SetHeadFootStyle{}
        • 6.1.3 \SetEmblems{}{}
        • 6.1.4 \SetPageNumberStyle{}
        • @@ -30,7 +30,7 @@
        • 6.2 Local Header/Footer Settings
        • @@ -49,7 +49,7 @@

          Documentation for novel document class

          -

          Documentation version: 1.0.7.

          +

          Documentation version: 1.0.9.

          @@ -101,52 +101,69 @@

           

          - -
          style 1
          +style 1
          +
           \SetHeadFootStyle{1}
          -

          Only header.
          -Page number at outside (left verso, right recto).
          -Optional emblem adjacent to page number.
          -Text centered. Default author verso, title recto.
          +

          Only header.
          +Page number at outside (left verso, right recto).
          +Optional emblem adjacent to page number.
          +Text centered. Default author verso, title recto.
          This is the default for the novel document class.

          -
          style 2
          +
          + +style 2 +
           \SetHeadFootStyle{2}
          -

          Only footer.
          -Page number at outside (left verso, right recto).
          +

          Only footer.
          +Page number at outside (left verso, right recto).
          Optional emblem adjacent to page number.

          -
          style 3
          +
          + +style 3 +
           \SetHeadFootStyle{3}
          -

          Only footer.
          -Page number centered.
          +

          Only footer.
          +Page number centered.
          Disregards emblem, if coded.

          -
          style 4
          +
          + +style 4 +
           \SetHeadFootStyle{4}
          -

          Only header.
          -Page number at outside (left verso, right recto).
          -Optional emblem adjacent to page number.
          -Text towards outside, instead of centered.
          -Text begins or ends 1em from the emblem.
          +

          Only header.
          +Page number at outside (left verso, right recto).
          +Optional emblem adjacent to page number.
          +Text towards outside, instead of centered.
          +Text begins or ends 1em from the emblem.
          Default author verso, title recto.

          -
          style 5
          +
          + +style 5 +
           \SetHeadFootStyle{5}
          -

          Header and Footer.
          -Page number centered in footer.
          -Disregards emblem, if coded.
          -Text centered in header.
          +

          Header and Footer.
          +Page number centered in footer.
          +Disregards emblem, if coded.
          +Text centered in header.
          Default author verso, title recto.

          -
          style 6
          +
          + +style 6 +
           \SetHeadFootStyle{6}
          -

          Only header.
          -Page number at outside (left verso, right recto).
          -Optional emblem adjacent to page number.
          -Text towards inside, instead of centered.
          +

          Only header.
          +Page number at outside (left verso, right recto).
          +Optional emblem adjacent to page number.
          +Text towards inside, instead of centered.
          Default author verso, title recto.

          +
          +
          Custom Style

          Before you think about writing custom header/footer styles, be sure to try the pre-configured choices. I have looked through a lot of fiction of all kinds. The pre-configured choices include every style I have seen, with the exception of the most highly decorative.

          If none of the above are satisfactory, then you can write your own headers and footers using the syntax of the fancyhdr package.

          @@ -163,20 +180,20 @@ Default author verso, title recto.

          If the style supports it, you may place an "emblem" that appears at a fixed distance (2.5em} from the outer margin. Thus, it will appear to the right of the page number on verso pages, and to the left of the page number on recto pages. In the case of style 4, there will be a clearance of 1em between the emblem and the header text.

          The font used for emblems will be the same as the headfont, unless you code the emblem to use a different font (perhaps one you specified with the \NewFontFace command), or unless you use one of the built-in \decoglyph codes.

          An emblem is a minor decoration that should not distract the eye from the main text.

          -

          simple emblems using vertical bar• Most books do not use emblems. When they do, it is typically a vertical bar, or a bullet, like this:

          +

          simple emblems using vertical bar• Most books do not use emblems. When they do, it is typically a vertical bar, or a bullet, like this:

          \SetHeadFootStyle{4}

          \SetEmblems{|}{|}

          The verso and recto emblems may be different. Whether they are the same or not, you must set them both, if you use emblems. Blanks are allowed.

          -

          dingbat emblems• Emblems may be styled. For example:

          +

          dingbat emblems• Emblems may be styled. For example:

          The header emblems shown at right were produced using the code below. Dingbats from the NovelDeco font were specified, adjusted for size and position.

          \SetEmblems{\charscale{1.1}{\raisebox{-0.05em}{\decoglyph{l9825}}}}%

          {\charscale{1.1}{\raisebox{-0.05em}{\decoglyph{l9826}}}}

          • You may also use images, or combined images and text. If you use images, they must be at the exact resolution required by your print service (usually 300dpi for gray, 600dpi for b/w), and at exact size without scaling. The \InlineImage command must be used. See novel's image documentation details. You may find that a vertical offset of \nfs (normal font size) is useful, as this will place the top of the emblem image at the top margin.

          -

          emblem image -\SetHeadFootStyle{4}
          -\SetEmblems{\InlineImage[0pt,b]{spy.png}}%
          +

          emblem image +\SetHeadFootStyle{4}
          +\SetEmblems{\InlineImage[0pt,b]{spy.png}}%
          {\InlineImage[0pt,b]{spy.png}}

          @@ -189,7 +206,7 @@ Default author verso, title recto.

          6.1.4 \SetPageNumberStyle{code using \thepage}

          By default, the page number is simply \thepage. In most cases, leave it that way. But if you wish to change how the page number is displayed, you can use this command to style how \thepage is displayed. Examples:

          -

          \SetPageNumberStyle{\emph{thepage}} % Page number in italics.
          +

          \SetPageNumberStyle{\emph{thepage}} % Page number in italics.
          \SetPageNumberStyle{-- \thepage --} % En-dash on each side of number, for headstyle 3 or 5.

          The headfont is applied automatically, unless you over-ride it in your code.

          You could also get more involved, using a different font or size. Avoid over-doing it. If you are tempted to use a macro that counts page numbers backwards, be aware that your print service will likely reject it. Anyway, it has already been done in fiction.

          @@ -205,7 +222,7 @@ Default author verso, title recto.

          6.1.6 \SetLooseHead{number}

          This command applies to both headers and footers.

          If you are using a style that has header text, then for best appearance the characters should appear with a little extra space between them, so that they are more easily distinguished from the main text. This is especially true if you are using small caps. The name for such adjustment is "tracking."

          -

          loosehead 50 and 100

          +

          loosehead 50 and 100

          The argument of \SetLooseHead is a number from 0 to 1000. At 0 there is no extra space between the letters. Values from 50 (default) to 200 are most useful. Higher values are unusual.

          Page number tracking will be clamped at a maximum of 50, even when a larger (looser) tracking is applied to text.

          diff --git a/Master/texmf-dist/doc/lualatex/novel/noveldocs-07-text-size-style.html b/Master/texmf-dist/doc/lualatex/novel/noveldocs-07-text-size-style.html index b9e2f6198f3..1ea6b810aab 100644 --- a/Master/texmf-dist/doc/lualatex/novel/noveldocs-07-text-size-style.html +++ b/Master/texmf-dist/doc/lualatex/novel/noveldocs-07-text-size-style.html @@ -1,9 +1,9 @@ - + Class novel - 7 - Text Sizes and Styling - + @@ -58,7 +58,7 @@

          Documentation for novel document class

          -

          Documentation version: 1.0.7.

          +

          Documentation version: 1.0.9.

          @@ -119,10 +119,10 @@

          Here is an example illustrating the command in all its glory:

          -

          badaboom -Bada \charscale*[1.25,5em,1.3\nbs]{Boom} Bam\par
          -Bada Bam\par
          -Bada\charscale[1.25,5em,1.3\nbs]{Bang} Bam\par
          +

          badaboom +Bada \charscale*[1.25,5em,1.3\nbs]{Boom} Bam\par
          +Bada Bam\par
          +Bada\charscale[1.25,5em,1.3\nbs]{Bang} Bam\par
          Bada \charscale[1.25]{Bang} Bam\par

          @@ -132,7 +132,7 @@ Bada \charscale[1.25]{Bang} Bam\par

          \FirstLine{\noindent\charscale[1.5]{I}t was a dark and stormy night. Lord Withens mounted his horse and rode through the gloom to Castle McDingle, where Baron von Feathering awaited. The pair had dirty deeds to do, but being members of the nobility, they commanded a high price.}

          -

          larger first letter

          +

          larger first letter

          In the above example, the initial I is 1.5x its normal size. It appears larger than that, by comparison to the adjacent small caps letters.

          @@ -198,17 +198,17 @@ Bada \charscale[1.25]{Bang} Bam\par

          \allsmcp{text} places both uppercase and lowercase letters in small caps. If the font has the c2sc feature, it will be used; if not, the letters will be converted to lowercase first. Then, smcp is applied.

          • If you require small caps, but your font does not have them, you can fake them by scaling uppercase. But this is usually unattractive. A better method is described in the fontspec package documentation: You may appoint a different font that will provide small caps.

          • If you insist on using old-fashioned TeX fonts, which do not have the smcp Open Type feature, then you may need to write this code in the Preamble:

          -

          \let\smcp\oldscshape\relax
          -\let\textsc\oldscshape\relax
          +

          \let\smcp\oldscshape\relax
          +\let\textsc\oldscshape\relax
          \let\scshape\oldscshape\relax

          The above code sends you in a time machine back to the Twentieth Century.

          \acronym{text} is special to novel. If the NovelDeco font is installed, uppercase letters in the text will be converted to "mid-size capitals," and lowercase will remain lowercase, but with ascenders slightly reduced. The purpose of this command is so that acronyms such as NASA and NATO blend well with surrounding text. I have found that whereas ordinary uppercase is too conspicuous, small caps also looks wrong. Example:

          -

          acronym +

          acronym -The NATO alliance...\par
          -The \acronym{NATO} alliance...\par
          +The NATO alliance...\par
          +The \acronym{NATO} alliance...\par
          The \allsmcp{NATO} alliance...\par

          @@ -265,16 +265,16 @@ The \allsmcp{NATO} alliance...\par

          \color{name} or \color[gray]{scale} is used within a group. All text will be in grayscale, from where the command is placed, until the group ends. If the command is not at the beginning of the group, it does not affect prior text. Example:

          -\begingroup
          -This text is unaffected by the following command.
          -\color{lightgray} % Alternative: \color[gray]{number 0 to 1}
          -This text is in lightgray, until the group ends.
          +\begingroup
          +This text is unaffected by the following command.
          +\color{lightgray} % Alternative: \color[gray]{number 0 to 1}
          +This text is in lightgray, until the group ends.
          \endgroup

          \textcolor{text} or \textcolor[gray]{scale}{text} affects only the included text.

          -

          \textcolor{gray7}{This text is in color gray7, a medium-light gray.}
          +

          \textcolor{gray7}{This text is in color gray7, a medium-light gray.}
          \textcolor[gray]{0.32}{This text is in 32 percent gray.}

          Whether you use \color or \textcolor, there are two ways to specify the color: by name, or by scale, using package xcolor syntax.

          diff --git a/Master/texmf-dist/doc/lualatex/novel/noveldocs-08-images.html b/Master/texmf-dist/doc/lualatex/novel/noveldocs-08-images.html index 681a603cce9..31b8a524b84 100644 --- a/Master/texmf-dist/doc/lualatex/novel/noveldocs-08-images.html +++ b/Master/texmf-dist/doc/lualatex/novel/noveldocs-08-images.html @@ -1,9 +1,9 @@ - + Class novel - 8 - Images - + @@ -48,7 +48,7 @@

          Documentation for novel document class

          -

          Documentation version: 1.0.7.

          +

          Documentation version: 1.0.9.

          @@ -127,7 +127,7 @@

          When you export your image, you may be asked whether or not to save the resolution. Be sure to save it.

          Example dialog boxes for grayscale png exported from GIMP:

          -

          png image with resolution

          +

          png image with resolution

          @@ -221,7 +221,7 @@

          After a few moments, the Terminal will show some information. It should say that the type is grayscale, at 8 bits per pixel. The resolution is 118.11 pixels per centimeter (which is 300dpi). The page geometry, divided by 300, will give you the image size in inches (thus, a page geometry of 900+1200+0+0 represents an image 3" wide x 4" high).

          -

          png color type
          jpg colorspace

          +

          png color type
          jpg colorspace

          Most important of all: Scroll through the information. Near its end, you should see a line like this. The exact wording will depend on your software:

          (For png images)   png: IHDR.color_type: 0 (grayscale)

          @@ -289,7 +289,7 @@

          Offsets may be written as combinations of lengths. If you use the baseline b as above, it must be the first character of voffset. If you use \widthof or \heightof, then its backslash must be the first character unless it is preceded by another length. Thus, an offset of -\heightof{X} is prohibited, but you can use 0pt-\heightof{X}.

          Here are some examples of allowable code:

          -\InlineImage[2.3em, -0.4em]{imageFile.png}
          +\InlineImage[2.3em, -0.4em]{imageFile.png}
          \InlineImage[0pt-\widthof{eee}, b+\heightof{X}-0.2em]{imageFile.jpg}

          The image occupies zero vertical space. So, it will not push apart baselines. The next line(s) of text may overlie the image. In some cases, this is desirable. If you do not want that effect, then you can either insert a suitable number of \null lines after the image, or use \BlockImage instead.

          @@ -318,11 +318,11 @@

          Example:

          -\noindent\InlineImage*[0pt,1.2\nbs]{gavel.png} Lord Withens took a seat at the rear of the courtroom, attempting to be inconspicuous. Yet his effort was in vain, as he was the only person there with a riding crop and spurs.\par
          +\noindent\InlineImage*[0pt,1.2\nbs]{gavel.png} Lord Withens took a seat at the rear of the courtroom, attempting to be inconspicuous. Yet his effort was in vain, as he was the only person there with a riding crop and spurs.\par
          He would have taken the car, had it not been stolen. But that was why he was here, at the arraignment of the person charged with the theft. It was most unfortunate that the accused was his own elderly father; but then, theft ran in the family line.\par

          -

          example of InlineImage*

          +

          example of InlineImage*

          @@ -344,13 +344,13 @@ He would have taken the car, had it not been stolen. But that was why he was her

          Example:

          -It was a dark and stormy night. Lord Withens mounted his horse and rode through the darkness, accidentally trampling some petunias in Her Ladyship's garden.\par
          -\BlockImage[l]{gnome.png}[\begin{adjustwidth}{8em}{0pt}\forceindent Suddenly he was confronted by an irate gnome, who expressed an opinion in the crudest of language, even for a gnome.\par
          -Lord Withens was taken aback. How dare this mere gnome speak to him in such a tone of voice? But then he remembered that the gnomes had gone to college, where swearing was routine.\par\end{adjustwidth}]
          +It was a dark and stormy night. Lord Withens mounted his horse and rode through the darkness, accidentally trampling some petunias in Her Ladyship's garden.\par
          +\BlockImage[l]{gnome.png}[\begin{adjustwidth}{8em}{0pt}\forceindent Suddenly he was confronted by an irate gnome, who expressed an opinion in the crudest of language, even for a gnome.\par
          +Lord Withens was taken aback. How dare this mere gnome speak to him in such a tone of voice? But then he remembered that the gnomes had gone to college, where swearing was routine.\par\end{adjustwidth}]
          \charscale[1, 5\nbs]{CENSORED}\forceindent Lord Withens shrugged, and rode on. There was nothing to do but remain silent, this time taking more care. He would speak with his wife about the gnome situation when he returned.\par

          -

          example of BlockImage with accompanying text

          +

          example of BlockImage with accompanying text

          In the above example, the text to the right of the image happens to have just the right number of lines to fill the available area. But that is only because I wrote it that way. If I had written less, then there would be one or more blank lines before the subsequent text ("Lord Withens shrugged..."). If I had written more, then the subsequent text would have been pushed down by the necessary number of lines, and there would have been more white area underneath the gnome.

          Thus, this technique requires careful inspection, particularly if there is the danger that the image or accompanying text may overflow the bottom of the page.

          diff --git a/Master/texmf-dist/doc/lualatex/novel/noveldocs-09-chapters-displays.html b/Master/texmf-dist/doc/lualatex/novel/noveldocs-09-chapters-displays.html index 96cb3aa35ea..a5ff7f9ceb0 100644 --- a/Master/texmf-dist/doc/lualatex/novel/noveldocs-09-chapters-displays.html +++ b/Master/texmf-dist/doc/lualatex/novel/noveldocs-09-chapters-displays.html @@ -1,9 +1,9 @@ - + Novel class documentation - Display, Start, Continued Pages, Footnotes, Endnotes - + @@ -14,12 +14,12 @@

          Document class "novel"

          -

          Display, Start, and Continued Pages;
          +

          Display, Start, and Continued Pages;
          Footnotes and Endnotes

            -
          • 9.1 Display Pages
            +
          • 9.1 Display Pages
            9.1 including blank
            • 9.1.1 Half-Title
            • @@ -41,17 +41,17 @@ Footnotes and Endnotes

            • 9.2 Start Pages: General
            • -
            • 9.3 Start Pages in Front Matter
              +
            • 9.3 Start Pages in Front Matter
              9.3 Foreword, Preface, etc.
            • -
            • 9.4 Start Pages in Main Matter
              +
            • 9.4 Start Pages in Main Matter
              9.3 New Chapters
            • -
            • 9.5 Continued Pages
              +
            • 9.5 Continued Pages
              • 9.5.1 \QuickChapter[]{}
              • 9.5.2 Scene Breaks @@ -90,15 +90,15 @@ Footnotes and Endnotes

              • 9.6 Footnotes
              • 9.7 Endnotes
              • @@ -112,7 +112,7 @@ Footnotes and Endnotes

                Documentation for novel document class

                -

                Documentation version: 1.0.8.

                +

                Documentation version: 1.0.9.

                @@ -122,17 +122,17 @@ Footnotes and Endnotes

                3. Metadata, PDF/X

                4. Page Layout

                5. Choosing Fonts

                -

                6. Headers, Footers
                +

                6. Headers, Footers

                7. Text Sizes, Styles

                8. Using Images

                -

                9. Display, Start Pages;
                -9. Chapters; Continued Pages;
                +

                9. Display, Start Pages;
                +9. Chapters; Continued Pages;
                9. Footnotes, Endotes.

                -

                Display, Start, and Continued Pages;
                +

                Display, Start, and Continued Pages;
                Footnotes and Endnotes

                A display page stands by itself, has a unique purpose, and is never continued to another page. A blank page is considered to be a display, even when there are several blanks.

                @@ -160,7 +160,11 @@ Footnotes and Endnotes

                If the preceding material ended with \clearpage or the following material begins with it, no problem. TeX wisely assumes that consecutive \clearpage commands are a mistake, and does not automatically skip a page between them. The \null command is the most effective way to show that you really did mean to create a page there.

                -

                A novel, or collection of stories, may contain these display pages: Half-Title, Frontispiece, Title, Copyright, Dedication, Epigraph, Map, Acknowledgements, Separator.

                +

                A novel, or collection of stories, may contain these display pages: Half-Title, Frontispiece, Title, Copyright, Dedication, Epigraph, Map, Acknowledgements, Separator. Almost all of them, if used, are in front matter.

                + +

                Note that a book's front matter does not have to be complicated. Here is an imitation of the entire front matter, from a detective novel written by a very famous author of such things. In order: Half-Title, Blank, Title, Copyright, duplicate Half-Title, Blank. A very decorative font is used for the book's title and the author's name.

                + +

                simple front matter

                @@ -169,17 +173,17 @@ Footnotes and Endnotes

                Historically, the purpose of a Half-Title was to protect the title page during transportation and storage. This purpose has been obsolete for a long time, bcause modern books are printed and bound at once. But the tradition lives on. Use a Half-Title unless you absolutely must reduce the page count of your book.

                -

                The Half-Title is the first page of front matter. It is lowercase roman page i, even though the number is not printed. The only material on the page is the book's title (not author) and usually not even a subtitle. If the title is artistically designed, then the Half-Title may be designed the same way, but is usually at smaller size. Place the Half-Title wherever it looks good on the page (certainly not at top left). For example:

                +

                The Half-Title is the first page of front matter. It is lowercase roman page i, even though the number is not printed. The only material on the page is the book's title (not author) and usually not even a subtitle. If the title is artistically designed, then the Half-Title may be designed the same way, but is usually at smaller size. Place the Half-Title wherever it looks good on the page (certainly not at top left). For example:

                -

                sample half title -\frontmatter % Sets page numbers to lowercase roman.
                -\thispagestyle{empty} % No header or footer.
                -\vspace*{6\nbs} % Note asterisk. Skips 6 lines.
                -% Right-aligns half-title at 2x normal font size:
                - % \orbitron is defined as the non-TeX font Orbitron-Medium.otf
                +

                sample half title +\frontmatter % Sets page numbers to lowercase roman.
                +\thispagestyle{empty} % No header or footer.
                +\vspace*{6\nbs} % Note asterisk. Skips 6 lines.
                +% Right-aligns half-title at 2x normal font size:
                + % \orbitron is defined as the non-TeX font Orbitron-Medium.otf
                \stake\hfill{\orbitron\charscale[2]{Star Smash}}\par \vspace{0.4\nbs} -% Decorative portion of half-title:
                +% Decorative portion of half-title:
                \noindent\hspace{12em}\charscale[1.6]{\decoglyph{r10059}} \bigemdash[2,2]\stake\par \clearpage % Ends the page. @@ -191,7 +195,7 @@ Footnotes and Endnotes

                9.1.2 Frontispiece (usually blank)

                -

                sample artwork frontispiece The verso of the Half-Title has page number ii, number not printed. Normally, this page is blank.

                +

                sample artwork frontispiece The verso of the Half-Title has page number ii, number not printed. Normally, this page is blank.

                In the good old days (looong ago), this page might show an illustration. Search the Internet for "frontispiece" to see examples. At right is the frontispiece by William Blake for his poetry regarding Milton. In the original, it was in color (spectacularly expensive, back then).

                @@ -201,13 +205,13 @@ Footnotes and Endnotes

                The preparation and placement of images is described on another documentation page.

                -

                sample blank frontispiece Some publishers put a centered list of “Books by the Same Author” here. Or, if the particular book is part of a set (“Splork Chronicles, Volume VI”) that can be mentioned. However, in the print-on-demand market, your printing and distribution service may not permit you to do that, unless they carry all of the books.

                +

                sample blank frontispiece Some publishers put a centered list of “Books by the Same Author” here. Or, if the particular book is part of a set (“Splork Chronicles, Volume VI”) that can be mentioned. However, in the print-on-demand market, your printing and distribution service may not permit you to do that, unless they carry all of the books.

                So, it is best to leave this page blank:

                -

                \clearpage
                -\thispagestyle{empty}
                -\null
                +

                \clearpage
                +\thispagestyle{empty}
                +\null
                \clearpage

                @@ -225,37 +229,37 @@ Footnotes and Endnotes

                Here are some commands that may be helpful for building your Title Page:

                -\thispagestyle{empty} % no header or footer
                -\vspace*{length} % puts space at top
                -\charscale[scale, position]{text} % changes text size and position
                -{\centering one line of text\par} % centers text
                -\stake\hfill text\par % pushes text to right
                -\InlineImage[options]{file} % see separate docs page
                -\BlockImage[options]{file} % see separate docs page
                +\thispagestyle{empty} % no header or footer
                +\vspace*{length} % puts space at top
                +\charscale[scale, position]{text} % changes text size and position
                +{\centering one line of text\par} % centers text
                +\stake\hfill text\par % pushes text to right
                +\InlineImage[options]{file} % see separate docs page
                +\BlockImage[options]{file} % see separate docs page
                \vfill % pushes following text to bottom of textblock

                Below is a sample Title Page. The \orbitron command calls for the font Orbitron-Medium.otf, which is not part of the TeX distribution. The \decoglyph command calls fo a decorative element from the NovelDeco.otf font, which comes with the novel class. The length \nbs is the normal baseline skip of the book's main font. The \stake commands place an invisible zero-width reference point, for the use of adjacent commands. Here is the code:

                -

                sample title page +

                sample title page -\clearpage
                -\thispagestyle{empty}
                -\vspace*{6\nbs}
                -\stake\hfill{\orbitron\charscale[3]{Star Smash}}\par
                -\vspace{0.4\nbs}
                -\noindent\charscale[3]{\decoglyph{r10059}}
                -\bigemdash[3.4,3]\stake\par
                -\vspace{0.4\nbs}
                -\stake\hfill{\orbitron\charscale[1.42]{A Sci-Fi Murder Mystery}}\par
                -\vspace{9\nbs}
                -\begin{center}
                -\charscale[4]{Dirk Hardcase}
                -\vfill
                -Meaningless Press\par
                -Eschwege • Merthyr Tydfil • Lethbridge\par
                -\end{center}
                +\clearpage
                +\thispagestyle{empty}
                +\vspace*{6\nbs}
                +\stake\hfill{\orbitron\charscale[3]{Star Smash}}\par
                +\vspace{0.4\nbs}
                +\noindent\charscale[3]{\decoglyph{r10059}}
                +\bigemdash[3.4,3]\stake\par
                +\vspace{0.4\nbs}
                +\stake\hfill{\orbitron\charscale[1.42]{A Sci-Fi Murder Mystery}}\par
                +\vspace{9\nbs}
                +\begin{center}
                +\charscale[4]{Dirk Hardcase}
                +\vfill
                +Meaningless Press\par
                +Eschwege • Merthyr Tydfil • Lethbridge\par
                +\end{center}
                \clearpage

                @@ -274,58 +278,58 @@ Eschwege • Merthyr Tydfil • Lethbridge\par

                Some commands useful on a Copyright Page:

                -\thispagestyle{empty} % no header or footer
                -\vspace*{length} % creates vertical space
                -% legalese: ragged lines, no hyphenation, no indent.
                -\begin{legalese} ... \end{legalese}
                -\begin{adjustwidth}{left}{right} ... \end{adjustwidth} % reduces width
                -\begin{center} ... \end{center} % if desired
                -\begin{parascale} ... \end{parascale} % shrinks text
                -\itshape{text} % italics, and can span paragraphs
                -\textsc{text} % lowercase to small caps (uppercase still uppercase)
                -\allsmcp{text} % uppercase and lowercase to small caps
                -\acronym{text} % uppercase to medium caps
                -\lnum{number} % lining numbers instead of old style
                -\_ % when underscore is in a URL
                -\% % when % is in a URL
                -\& % when & is in a URL
                +\thispagestyle{empty} % no header or footer
                +\vspace*{length} % creates vertical space
                +% legalese: ragged lines, no hyphenation, no indent.
                +\begin{legalese} ... \end{legalese}
                +\begin{adjustwidth}{left}{right} ... \end{adjustwidth} % reduces width
                +\begin{center} ... \end{center} % if desired
                +\begin{parascale} ... \end{parascale} % shrinks text
                +\itshape{text} % italics, and can span paragraphs
                +\textsc{text} % lowercase to small caps (uppercase still uppercase)
                +\allsmcp{text} % uppercase and lowercase to small caps
                +\acronym{text} % uppercase to medium caps
                +\lnum{number} % lining numbers instead of old style
                +\_ % when underscore is in a URL
                +\% % when % is in a URL
                +\& % when & is in a URL

                You normally do not need to write a lot of things on a Copyright Page. But if your novel has a lot of real-world material, some of it may require acknowledgements and permissions. They may be placed on the Copyright Page. If everything almost fits, but not quite, you can shrink it using the parascale environment. However, do not shrink it too much, and don't fill the whole page like it was ordinary story text. When you have a lot of acknowledgements and permissions, move them to a separate section. If your book has a Preface (uncommon in fiction), perhaps put them there. Or, create a separate Acknowledgements section (also uncommon in fiction).

                Here is a sample abbreviated Copyright Page, centered style. Note that in the image, the text is displaced slightly to the left, because this is a verso page, and the right margin includes an allowance for gutter.

                -

                sample copyright page +

                sample copyright page -\clearpage
                -\thispagestyle{empty}
                -\vspace*{5\nbs}
                -\begin{center}
                -\itshape{
                -Copyright ©2017 Dirk Hardcase.\\
                -All Rights Reserved.\par
                -\null
                -This is a work of fiction.\\
                -All persons and events are imaginary.\\
                -Resemblance to any real persons or events\\
                -is entirely coincidental.\par
                -\null
                -Printed in the United States of America\\
                -on acid-free paper.\par
                -\null
                -\allsmcp{FIRST EDITION}, March 2017.\par
                -\null
                -\allsmcp{ISBN} 9-876-54321-0\par
                -\null
                -Published by Dirk Hardcase,\\
                -Anytown, U.S.A.\par
                -\null
                -Inquiries for Cataloging-in-Publication data\\
                -should be directed to the author's web site:\par
                -\null
                -http://example.com/bigdealauthor.html\par
                -} % end \itshape
                -\end{center}
                +\clearpage
                +\thispagestyle{empty}
                +\vspace*{5\nbs}
                +\begin{center}
                +\itshape{
                +Copyright ©2017 Dirk Hardcase.\\
                +All Rights Reserved.\par
                +\null
                +This is a work of fiction.\\
                +All persons and events are imaginary.\\
                +Resemblance to any real persons or events\\
                +is entirely coincidental.\par
                +\null
                +Printed in the United States of America\\
                +on acid-free paper.\par
                +\null
                +\allsmcp{FIRST EDITION}, March 2017.\par
                +\null
                +\allsmcp{ISBN} 9-876-54321-0\par
                +\null
                +Published by Dirk Hardcase,\\
                +Anytown, U.S.A.\par
                +\null
                +Inquiries for Cataloging-in-Publication data\\
                +should be directed to the author's web site:\par
                +\null
                +http://example.com/bigdealauthor.html\par
                +} % end \itshape
                +\end{center}
                \clearpage

                @@ -333,36 +337,36 @@ http://example.com/bigdealauthor.html\par

                Sample abbreviated Copyright Page, alternative style. This style is more effective when there are more details, particularly if there is a complete Cataloging-in-Publication data block:

                -

                sample copyright page +

                sample copyright page -\clearpage
                -\thispagestyle{empty}
                -\null\vfill
                -\begin{adjustwidth}{0em}{8em}
                -\begin{legalese}
                -Copyright ©2017 Dirk Hardcase.\\
                -All Rights Reserved.\par
                -\null
                -This is a work of fiction.\\
                -All persons and events are imaginary.\\
                -Resemblance to any real persons or events\\
                -is entirely coincidental.\par
                -\null
                -Printed in the United States of America\\
                -on acid-free paper.\par
                -\null
                -\allsmcp{FIRST EDITION}, March 2017.\par
                -\null
                -\allsmcp{ISBN} 9-876-54321-0\par
                -\null
                -Published by Dirk Hardcase,\\
                -Anytown, U.S.A.\par
                -\null
                -Inquiries for Cataloging-in-Publication data\\
                -should be directed to the author's web site:\par
                -http://example.com/bigdealauthor.html\par
                -\end{legalese}
                -\end{adjustwidth}
                +\clearpage
                +\thispagestyle{empty}
                +\null\vfill
                +\begin{adjustwidth}{0em}{8em}
                +\begin{legalese}
                +Copyright ©2017 Dirk Hardcase.\\
                +All Rights Reserved.\par
                +\null
                +This is a work of fiction.\\
                +All persons and events are imaginary.\\
                +Resemblance to any real persons or events\\
                +is entirely coincidental.\par
                +\null
                +Printed in the United States of America\\
                +on acid-free paper.\par
                +\null
                +\allsmcp{FIRST EDITION}, March 2017.\par
                +\null
                +\allsmcp{ISBN} 9-876-54321-0\par
                +\null
                +Published by Dirk Hardcase,\\
                +Anytown, U.S.A.\par
                +\null
                +Inquiries for Cataloging-in-Publication data\\
                +should be directed to the author's web site:\par
                +http://example.com/bigdealauthor.html\par
                +\end{legalese}
                +\end{adjustwidth}
                \clearpage

                @@ -378,15 +382,15 @@ http://example.com/bigdealauthor.html\par

                If used, a Dedication is normally on page v, immediately following the Copyright Page. An exception might be if your work is a reprint of someone else's work, in which case you do not want the original author's Dedication to be interpreted as being your own.

                -

                sample dedication page Keep it simple. If your book is combat fiction, it might be:

                +

                sample dedication page Keep it simple. If your book is combat fiction, it might be:

                -\clearpage
                -\thispagestyle{empty}
                -\vspace*{12\nbs}
                -\begin{center}
                -\charscale[1.25]{\textsc{To Those Who Served}}\par
                -\end{center}
                +\clearpage
                +\thispagestyle{empty}
                +\vspace*{12\nbs}
                +\begin{center}
                +\charscale[1.25]{\textsc{To Those Who Served}}\par
                +\end{center}
                \clearpage

                @@ -402,15 +406,15 @@ http://example.com/bigdealauthor.html\par

                Here is a sample Epigraph, in which the fictional speaker appears as a character in the book. A glance at this, and you know where the story is headed:

                -

                sample epigraph +

                sample epigraph -\clearpage
                -\thispagestyle{empty}
                -\vspace*{10\nbs}
                -\begin{adjustwidth}{7em}{7em}
                -Let me tell you, there's nothing more exciting than the brouhaha at Mickey's Pub each Saturday night in April.\par
                -\stake\hfill---Dorf McNorf\par
                -\end{adjustwidth}
                +\clearpage
                +\thispagestyle{empty}
                +\vspace*{10\nbs}
                +\begin{adjustwidth}{7em}{7em}
                +Let me tell you, there's nothing more exciting than the brouhaha at Mickey's Pub each Saturday night in April.\par
                +\stake\hfill---Dorf McNorf\par
                +\end{adjustwidth}
                \clearpage

                @@ -434,16 +438,16 @@ Let me tell you, there's nothing more exciting than the brouhaha at Mickey's Pub

                Note that I subsequently added the black border during image editing; it is not part of the Epigraph.

                -

                Epigraph page +

                Epigraph page -\thispagestyle{empty} % no header or footer
                -\vspace*{10\nbs} % for vertical position
                -Epigraph text -\Epigraph[c]{% percent prevents newline
                -When sacred swallows sound at dawn,\\
                -And eager eagles eye their prey,\\
                -Then shall Shan-Sun wreak revenge.\\
                -\hfill---Book of Bjorn\par
                +\thispagestyle{empty} % no header or footer
                +\vspace*{10\nbs} % for vertical position
                +Epigraph text +\Epigraph[c]{% percent prevents newline
                +When sacred swallows sound at dawn,\\
                +And eager eagles eye their prey,\\
                +Then shall Shan-Sun wreak revenge.\\
                +\hfill---Book of Bjorn\par
                } % end of Epigraph

                @@ -493,29 +497,29 @@ Then shall Shan-Sun wreak revenge.\\

                Example of toc: The use of the toc environment, and the \tocitem commands, are easily understood by looking at an example. The border of the image is where the normal page margins would be (the actual page is larger). The little explanation at top happens to exactly fit the table width, because I tweaked the text and the width until it fit!

                -

                toc example +

                toc example -\clearpage
                -\thispagestyle{empty}
                -\begin{toc}[0.25]{3em}
                -\vspace*{4\nbs}
                -{\centering\charscale[1.25]{The Withens Retaliation}\par}
                -\null
                -In which Lord Withens, fresh from a program in horticulture, unleashes secret desires on the garden.\par
                -\null\null
                -\tocitem*[1]{The Evil Weeds}{1}
                -\tocitem*[2]{A Plan of Attack}{14}
                -\tocitem*[3]{Lady Withens Objects}{35}
                -\tocitem*[4]{Back-Hoe to the Rescue}{48}
                -\tocitem[5]{Invasion of the Dandelions}{}
                -\tocitem*[~]{\emph{Interlude}}{63}
                -\tocitem*[6]{Army of the Gardeners}{94}
                -\tocitem*[7]{Too Much Rain}{113}
                -\tocitem*[8]{To Nuke, or Not to Nuke?}{145}
                -\tocitem*[9]{Revenge of the Zucchini}{162}
                -\tocitem*[10]{Lady Withens Sneezes}{180}
                -\tocitem*[11]{The Concrete Lawn}{206}
                -\end{toc}
                +\clearpage
                +\thispagestyle{empty}
                +\begin{toc}[0.25]{3em}
                +\vspace*{4\nbs}
                +{\centering\charscale[1.25]{The Withens Retaliation}\par}
                +\null
                +In which Lord Withens, fresh from a program in horticulture, unleashes secret desires on the garden.\par
                +\null\null
                +\tocitem*[1]{The Evil Weeds}{1}
                +\tocitem*[2]{A Plan of Attack}{14}
                +\tocitem*[3]{Lady Withens Objects}{35}
                +\tocitem*[4]{Back-Hoe to the Rescue}{48}
                +\tocitem[5]{Invasion of the Dandelions}{}
                +\tocitem*[~]{\emph{Interlude}}{63}
                +\tocitem*[6]{Army of the Gardeners}{94}
                +\tocitem*[7]{Too Much Rain}{113}
                +\tocitem*[8]{To Nuke, or Not to Nuke?}{145}
                +\tocitem*[9]{Revenge of the Zucchini}{162}
                +\tocitem*[10]{Lady Withens Sneezes}{180}
                +\tocitem*[11]{The Concrete Lawn}{206}
                +\end{toc}
                \clearpage

                @@ -531,14 +535,14 @@ In which Lord Withens, fresh from a program in horticulture, unleashes secret de

                A Part Separator is part of main matter, and has an arabic page number. However, the page number is not printed (possible exception if the separator also contains substantial text, by way of introduction). Thus, the first Part Separator would be page 1, and its story would begin on page 3. Wihout a Part Separator, the story would begin on page 1. -

                part separator +

                part separator -\clearpage
                -% \mainmatter % if needed to begin at page 1
                -\thispagestyle{empty}
                -\vspace*{10\nbs}
                -% the tilde provides better separation:
                -{\centering\charscale[2]{PART~ I}\par}
                +\clearpage
                +% \mainmatter % if needed to begin at page 1
                +\thispagestyle{empty}
                +\vspace*{10\nbs}
                +% the tilde provides better separation:
                +{\centering\charscale[2]{PART~ I}\par}
                \clearpage

                @@ -580,7 +584,7 @@ In which Lord Withens, fresh from a program in horticulture, unleashes secret de

                The following image shows three pages of a Foreword, from a book that uses header but no footer. On its start page, the folio has been dropped inside. Color added for illustration.

                -

                example of inside drop folio

                +

                example of inside drop folio

                \thispagestyle{dropfoliobeneath}

                @@ -610,28 +614,28 @@ In which Lord Withens, fresh from a program in horticulture, unleashes secret de

                The header text will appear in the font chosen as headerfont. You may over-ride that with a local font command. The text may be styled with commands such as \textsc or \textls or \emph if desired. Do not use underline or bold.

                -

                example preface Here is an example, where the author wrote a Preface several pages long, and the book layout uses a header. The ChapterStart environment is used, but this is not a requirement. The lipsum package was used for text fill:

                +

                example preface Here is an example, where the author wrote a Preface several pages long, and the book layout uses a header. The ChapterStart environment is used, but this is not a requirement. The lipsum package was used for text fill:

                -\clearpage
                -\thispagestyle{footer} % or dropfolioinside or dropfoliobeneath
                -\SetVersoHeadText{\textsc{Preface}}
                -\SetRectoHeadText{\textsc{Preface}}
                -\begin{ChapterStart}
                -\vspace*{2\nbs}
                -\ChapterTitle{Preface}
                -\end{ChapterStart}
                -The inspiration for this book...\par
                -\lipsum
                -But while I was held captive...\par
                -\lipsum
                -Clawing my way to the sunlight...\par
                -\lipsum
                -... And I hope you will enjoy it.\par
                -\null
                -\stake\hfill Dirk Hardcase.\par
                -\stake\hfill Springfield, March 14, 2017\par
                -\clearpage
                +\clearpage
                +\thispagestyle{footer} % or dropfolioinside or dropfoliobeneath
                +\SetVersoHeadText{\textsc{Preface}}
                +\SetRectoHeadText{\textsc{Preface}}
                +\begin{ChapterStart}
                +\vspace*{2\nbs}
                +\ChapterTitle{Preface}
                +\end{ChapterStart}
                +The inspiration for this book...\par
                +\lipsum
                +But while I was held captive...\par
                +\lipsum
                +Clawing my way to the sunlight...\par
                +\lipsum
                +... And I hope you will enjoy it.\par
                +\null
                +\stake\hfill Dirk Hardcase.\par
                +\stake\hfill Springfield, March 14, 2017\par
                +\clearpage
                % Be sure to re-set the head texts now!

                @@ -696,7 +700,7 @@ Clawing my way to the sunlight...\par

                Each of these commands may only be used for a single line of contents. If the contents cannot fit on a single line, then you must manually break and issue the command twice. The commands may be used in any order, may be used more than once, or not at all.

                -

                example chapter start +

                example chapter start 9.4.3.1\ChapterTitle{text} sets its text using chapterfont. The default is the main font scaled 1.6, with lining numbers.

                @@ -708,13 +712,13 @@ Clawing my way to the sunlight...\par

                Example, where \clearpage and \mainmatter were already issued:

                -\thispagestyle{dropfolioinside}
                -\begin{ChapterStart} % default 10 lines
                - \null % for positioning title
                - \ChapterTitle{Prologue}
                - \ChapterDeco[4]{\decoglyph{r9548}}
                - \ChapterSubtitle{The Finding of the Manuscript}
                -\end{ChapterStart}
                +\thispagestyle{dropfolioinside}
                +\begin{ChapterStart} % default 10 lines
                + \null % for positioning title
                + \ChapterTitle{Prologue}
                + \ChapterDeco[4]{\decoglyph{r9548}}
                + \ChapterSubtitle{The Finding of the Manuscript}
                +\end{ChapterStart}
                % then the main text

                @@ -728,21 +732,21 @@ Clawing my way to the sunlight...\par
                -

                example of chapter title image, text over9.4.4.1 Text Over Image: You may position text over an image. Be aware that overlapping text and graphics may be interpreted as a mistake, by human reviewers. It is best to use black text, or grayscale text that is much darker than the underlying image. Results are uncertain if you try to place light text over a dark image.

                +

                example of chapter title image, text over9.4.4.1 Text Over Image: You may position text over an image. Be aware that overlapping text and graphics may be interpreted as a mistake, by human reviewers. It is best to use black text, or grayscale text that is much darker than the underlying image. Results are uncertain if you try to place light text over a dark image.

                Example, where the command \unifrac calls for the font UnifrakturMaguntia.ttf. Note that the font command is outside \charscale:

                -

                \begin{ChapterStart}
                -\BlockImage{sword.png} % centered by default
                -{\unifrak\centering\charscale[3,0pt,4\nbs]{35}\par}
                +

                \begin{ChapterStart}
                +\BlockImage{sword.png} % centered by default
                +{\unifrak\centering\charscale[3,0pt,4\nbs]{35}\par}
                \end{ChapterStart}

                9.4.4.2 Text as Part of Image: If the text is not ordinary black, or not much darker than the background image, then it is better to include the text as part of the raster image. The reason is that there is no "white ink." Although light text over a dark image will appear correctly in PDF, and print that way on most printers, there are exceptions. If in doubt, ask your print service. In this example, the number is built into the image itself:

                -

                example of chapter title image, raster text\begin{ChapterStart}
                -\BlockImage[l]{smfingerprint8.png}
                +

                example of chapter title image, raster text\begin{ChapterStart}
                +\BlockImage[l]{smfingerprint8.png}
                \end{ChapterStart}

                @@ -766,12 +770,12 @@ Clawing my way to the sunlight...\par

                Example:

                -

                Then he looked at me with a sneer, and barked, ``You better haul your can over to Vinny's joint, before the Boss finds out.''\par
                -\QuickChapter[3em]{16. At Vinny's}
                -So I took his advice, and hauled my can over to Vinny's. It was everything I had expected, and worse.\par
                +

                Then he looked at me with a sneer, and barked, ``You better haul your can over to Vinny's joint, before the Boss finds out.''\par
                +\QuickChapter[3em]{16. At Vinny's}
                +So I took his advice, and hauled my can over to Vinny's. It was everything I had expected, and worse.\par
                The bouncer wasn't the biggest one I'd ever seen, but he was the ugliest. ...

                -

                quick chapter

                +

                quick chapter

                @@ -790,18 +794,18 @@ The bouncer wasn't the biggest one I'd ever seen, but he was the ugliest. ...Examples:

                -

                scene breaks +

                scene breaks -\noindent It was a dark and stormy night.\par
                -Lord Withens, the last of his line, hurried through the gloom to Castle McWhistle, where Lady McWhistle awaited.\par
                -\scenebreak
                -Well, maybe it was not very dark.\par
                -But to Lord Withens, it seemed dark enough. Or rather, he hoped it was dark enough. Lord McWhistle was suspicious.\par
                -\sceneline
                -Actually, it was not all that stormy, either. But the Withens clan never tolerated drizzle, much less a storm.\par
                -Who could blame them? It's not like they lived in Italy.\par
                -\scenestars
                -Ah, such ill fortune haunted the Withens!\par
                +\noindent It was a dark and stormy night.\par
                +Lord Withens, the last of his line, hurried through the gloom to Castle McWhistle, where Lady McWhistle awaited.\par
                +\scenebreak
                +Well, maybe it was not very dark.\par
                +But to Lord Withens, it seemed dark enough. Or rather, he hoped it was dark enough. Lord McWhistle was suspicious.\par
                +\sceneline
                +Actually, it was not all that stormy, either. But the Withens clan never tolerated drizzle, much less a storm.\par
                +Who could blame them? It's not like they lived in Italy.\par
                +\scenestars
                +Ah, such ill fortune haunted the Withens!\par
                Unfortunately, novelists of that era had so little to write about, or they would have chosen another family to pursue.\par

                @@ -887,12 +891,12 @@ Unfortunately, novelists of that era had so little to write about, or they would

                -\endnotetext{9}{Yang Sho-Nuff was the twelfth son of the elder god of the ancient Who-Zit Clan, with power over the forces of rust.\par}
                -\endnotetext{}{\indent However, since this was not yet the Iron Age, the terible might of Yang Sho-Nuff was largely unrecognized.\par}
                +\endnotetext{9}{Yang Sho-Nuff was the twelfth son of the elder god of the ancient Who-Zit Clan, with power over the forces of rust.\par}
                +\endnotetext{}{\indent However, since this was not yet the Iron Age, the terrible might of Yang Sho-Nuff was largely unrecognized.\par}
                \endnotetext{10}{As Professor Withens notes in his treatise, \emph{When Sho-Nuff Was Not Enough}, the ceremony of daily human sacrifice had a devastating effect on the tribal population.\par}

                -

                using endnotetext

                +

                using endnotetext

                diff --git a/Master/texmf-dist/tex/lualatex/novel/novel-CalculateLayout.sty b/Master/texmf-dist/tex/lualatex/novel/novel-CalculateLayout.sty index ed715fc7161..e371850d70e 100644 --- a/Master/texmf-dist/tex/lualatex/novel/novel-CalculateLayout.sty +++ b/Master/texmf-dist/tex/lualatex/novel/novel-CalculateLayout.sty @@ -12,7 +12,7 @@ %% %% \ProvidesFile{novel-CalculateLayout.sty}% -[2017/03/09 v1.0.7 LaTeX file (layout calculations)] +[2017/03/21 v1.0.9 LaTeX file (layout calculations)] %% diff --git a/Master/texmf-dist/tex/lualatex/novel/novel-ChapterScene.sty b/Master/texmf-dist/tex/lualatex/novel/novel-ChapterScene.sty index bbecf3ce63a..5b1be49ca42 100644 --- a/Master/texmf-dist/tex/lualatex/novel/novel-ChapterScene.sty +++ b/Master/texmf-dist/tex/lualatex/novel/novel-ChapterScene.sty @@ -13,7 +13,7 @@ %% %% \ProvidesFile{novel-ChapterScene.sty}% -[2017/03/12 v1.0.8 LaTeX file (chapter and scene macros)] +[2017/03/21 v1.0.9 LaTeX file (chapter and scene macros)] %% diff --git a/Master/texmf-dist/tex/lualatex/novel/novel-FileData.sty b/Master/texmf-dist/tex/lualatex/novel/novel-FileData.sty index 0a4c81843b8..a88c1c042c9 100644 --- a/Master/texmf-dist/tex/lualatex/novel/novel-FileData.sty +++ b/Master/texmf-dist/tex/lualatex/novel/novel-FileData.sty @@ -13,8 +13,8 @@ %% %% \ProvidesFile{novel-FileData.sty}% -[2017/03/09 v1.0.7 LaTeX file (File Data settings)] -%% +[2017/03/21 v1.0.9 LaTeX file (File Data settings)] +%% %% FILE DATA (see class documentation for technical meaning of this term). diff --git a/Master/texmf-dist/tex/lualatex/novel/novel-FontDefaults.sty b/Master/texmf-dist/tex/lualatex/novel/novel-FontDefaults.sty index e1f113620b7..8c45a23898c 100644 --- a/Master/texmf-dist/tex/lualatex/novel/novel-FontDefaults.sty +++ b/Master/texmf-dist/tex/lualatex/novel/novel-FontDefaults.sty @@ -13,7 +13,7 @@ %% %% \ProvidesFile{novel-FontDefaults.sty}% -[2017/03/09 v1.0.7 LaTeX file (default fonts)] +[2017/03/21 v1.0.9 LaTeX file (default fonts)] %% diff --git a/Master/texmf-dist/tex/lualatex/novel/novel-Footnotes.sty b/Master/texmf-dist/tex/lualatex/novel/novel-Footnotes.sty index 3457596f0f8..8a394d90a9b 100644 --- a/Master/texmf-dist/tex/lualatex/novel/novel-Footnotes.sty +++ b/Master/texmf-dist/tex/lualatex/novel/novel-Footnotes.sty @@ -13,7 +13,7 @@ %% %% \ProvidesFile{novel-Footnotes.sty}% -[2017/03/09 v1.0.7 LaTeX file (commands for footnotes and endnotes)] +[2017/03/21 v1.0.9 LaTeX file (commands for footnotes and endnotes)] %% diff --git a/Master/texmf-dist/tex/lualatex/novel/novel-HeadFootStyles.sty b/Master/texmf-dist/tex/lualatex/novel/novel-HeadFootStyles.sty index 356733fcefa..04d88a9161b 100644 --- a/Master/texmf-dist/tex/lualatex/novel/novel-HeadFootStyles.sty +++ b/Master/texmf-dist/tex/lualatex/novel/novel-HeadFootStyles.sty @@ -13,8 +13,8 @@ %% %% \ProvidesFile{novel-HeadFootStyles.sty}% -[2017/03/12 v1.0.8 LaTeX file (header and footer styles)] -%% +[2017/03/21 v1.0.9 LaTeX file (header and footer styles)] +%% %% File `novel-LayoutSettings.sty' reserved space for header/footer, diff --git a/Master/texmf-dist/tex/lualatex/novel/novel-Images.sty b/Master/texmf-dist/tex/lualatex/novel/novel-Images.sty index 9fdfde2189c..076e968682e 100644 --- a/Master/texmf-dist/tex/lualatex/novel/novel-Images.sty +++ b/Master/texmf-dist/tex/lualatex/novel/novel-Images.sty @@ -13,7 +13,7 @@ %% %% \ProvidesFile{novel-Images.sty}% -[2017/03/09 v1.0.7 LaTeX file (image placement)] +[2017/03/21 v1.0.9 LaTeX file (image placement)] %% diff --git a/Master/texmf-dist/tex/lualatex/novel/novel-LayoutSettings.sty b/Master/texmf-dist/tex/lualatex/novel/novel-LayoutSettings.sty index 3536ba7cb6a..b05d11b721d 100644 --- a/Master/texmf-dist/tex/lualatex/novel/novel-LayoutSettings.sty +++ b/Master/texmf-dist/tex/lualatex/novel/novel-LayoutSettings.sty @@ -13,7 +13,7 @@ %% %% \ProvidesFile{novel-LayoutSettings.sty}% -[2017/03/09 v1.0.7 LaTeX file (layout settings)] +[2017/03/21 v1.0.9 LaTeX file (layout settings)] %% diff --git a/Master/texmf-dist/tex/lualatex/novel/novel-TextMacros.sty b/Master/texmf-dist/tex/lualatex/novel/novel-TextMacros.sty index 7f47c520063..1af2d46b374 100644 --- a/Master/texmf-dist/tex/lualatex/novel/novel-TextMacros.sty +++ b/Master/texmf-dist/tex/lualatex/novel/novel-TextMacros.sty @@ -13,7 +13,7 @@ %% %% \ProvidesFile{novel-TextMacros.sty}% -[2017/03/09 v1.0.7 LaTeX file (text macros usable within document body)] +[2017/03/21 v1.0.9 LaTeX file (text macros usable within document body)] %% diff --git a/Master/texmf-dist/tex/lualatex/novel/novel-glyphtounicode.tex b/Master/texmf-dist/tex/lualatex/novel/novel-glyphtounicode.tex index e1126bc28a2..973aad88451 100644 --- a/Master/texmf-dist/tex/lualatex/novel/novel-glyphtounicode.tex +++ b/Master/texmf-dist/tex/lualatex/novel/novel-glyphtounicode.tex @@ -14,7 +14,7 @@ %% %% \ProvidesFile{novel-gyphtounicode.tex}% -[2017/03/09 v1.0.7 LaTeX file (additional glyph to unicode)] +[2017/03/21 v1.0.9 LaTeX file (additional glyph to unicode)] %% diff --git a/Master/texmf-dist/tex/lualatex/novel/novel-microtype.cfg b/Master/texmf-dist/tex/lualatex/novel/novel-microtype.cfg index 5d42805753c..bc228ad31d4 100644 --- a/Master/texmf-dist/tex/lualatex/novel/novel-microtype.cfg +++ b/Master/texmf-dist/tex/lualatex/novel/novel-microtype.cfg @@ -19,7 +19,7 @@ %% \NeedsTeXFormat{LaTeX2e} \ProvidesFile{novel-microtype.cfg} - [2017/03/09 v1.0.7 LaTeX file (microtype configuration file for novel class)] + [2017/03/21 v1.0.9 LaTeX file (microtype configuration file for novel class)] %%% ----------------------------------------------------------------------- %%% FONT SETS diff --git a/Master/texmf-dist/tex/lualatex/novel/novel-pdfx.sty b/Master/texmf-dist/tex/lualatex/novel/novel-pdfx.sty index c21380800f1..e420d89bd34 100644 --- a/Master/texmf-dist/tex/lualatex/novel/novel-pdfx.sty +++ b/Master/texmf-dist/tex/lualatex/novel/novel-pdfx.sty @@ -24,7 +24,7 @@ %% \NeedsTeXFormat{LaTeX2e} \ProvidesFile{novel-pdfx.sty} - [2017/03/09 v1.0.7 LaTeX file (PDF/X support for novel class)] + [2017/03/21 v1.0.9 LaTeX file (PDF/X support for novel class)] % This package supports, and is part of, class `novel'. % No support for anything but LuaLaTeX. @@ -414,17 +414,17 @@ \edef\0{\string\0} % Not sure why, but it works. \edef\({\string\(} % PDF Catalog requires escaped parentheses. \edef\){\string\)} % PDF Catalog requires escaped parentheses. - \catcode`\_ 12 % The *.icc file name might contain underscores. + \catcode`\_ 12 % The icc file name might contain underscores. % \if@noembedicc\else \IfFileExists{\@OIprofile}{% \immediate\pdfobj stream attr{/N 4} file{\@OIprofile}% \edef\OBJ@OI{\the\pdflastobj\space 0 R}% }{% - \ClassError{novel}{Requested color profile *.icc not found}% - {Your Output Intent calls for a color profile *.icc file,^^J% - and you requested `embed-icc',^^J% - but the file could not be located.}% + \ClassError{novel}{Requested icc color profile not found}% + {You used the starred \string\SetPDFX*\space which embeds the^^J% + associated icc color profile. But the file could not be located.^^J% + If necessary, place it in the same folder as your *.tex document.}% } \fi \ifthenelse{\equal{\@OIcondition}{}}{ diff --git a/Master/texmf-dist/tex/lualatex/novel/novel-xmppacket.sty b/Master/texmf-dist/tex/lualatex/novel/novel-xmppacket.sty index 7b770bc92cf..23db81b88b7 100644 --- a/Master/texmf-dist/tex/lualatex/novel/novel-xmppacket.sty +++ b/Master/texmf-dist/tex/lualatex/novel/novel-xmppacket.sty @@ -22,7 +22,7 @@ %% %% \ProvidesFile{novel-xmppacket.sty}% -[2017/03/09 v1.0.7 LaTeX file (novel XMP packet template)] +[2017/03/21 v1.0.9 LaTeX file (novel XMP packet template)] %% diff --git a/Master/texmf-dist/tex/lualatex/novel/novel.cls b/Master/texmf-dist/tex/lualatex/novel/novel.cls index 89443fb1df3..2280294b626 100644 --- a/Master/texmf-dist/tex/lualatex/novel/novel.cls +++ b/Master/texmf-dist/tex/lualatex/novel/novel.cls @@ -14,7 +14,7 @@ %% \NeedsTeXFormat{LaTeX2e}[1995/12/01] % Actually needs LuaLaTeX, at least version 0.95 from TeXLive 2016. -\ProvidesClass{novel}[2017/03/09 v1.0.7 LaTeX document class] +\ProvidesClass{novel}[2017/03/21 v1.0.9 LaTeX document class] %% -- cgit v1.2.3