Substantial changes in this release, the more important one being
support for parts!
- Breaking changes: the API has undergone some breaking changes,
hoping they will be the last ones for a while. API should now be
more simple and consistent (?). This version contains also
substantial options renaming (see below). - Crowbook now supports parts (above the "chapter" level), using the
'@' character in the book configuration file. - Command-line interface:
- Behaviour of
--to
should now be consistent for all output
formats. - If
--output
is set to-
, prints to stdout. - Conversely, if
<BOOK>
is set to-
, reads from stdin. - Path specified by
--output
is now interpreted relatively to
current directory (and not depending on where<BOOK>
is or its
options).
- Behaviour of
- Rendering:
- Chapters with no titles now have an empty title added (so it can
at least display e.g. "Chapter X"). - EPUB:
- The
toc.ncx
file now displays links to "title" and (if set)
"cover" (can be deactivated, see below). - The
toc.ncx
file now displays toc levels below chapter. - The table of contents is now displayed inline if
rendering.inline_toc
is set totrue
.
- The
- Chapters with no titles now have an empty title added (so it can
- New options:
epub.toc.extras
, set totrue
by default, will add links to the
title and the cover (if it is set) in the table of contents.epub.escape_nb_spaces
, similar tohtml.escape_nb_spaces
and
set to false by default since at least Kobo reader don't seem to
be able to understand the CSS to escape those nb spaces...rendering.chapter.roman_numerals
, if set totrue
, will display chapter
numbers using roman numerals.rendering.part.roman_numerals
, if set totrue
(it is by
default) will display part numbers using roman numerals.rendering.part.template
specifies the numbering scheme of parts.rendering.part.reset_counter
, if set totrue
(it is by
default), resets chapter number to zero after a part.
- Renamed options:
import_config
renamed toimport
.rendering.chapter_template
renamed torendering.chapter.template
.html_single.html
renamed tohtml.standalone.template
.html_single.js
renamed tohtml.standalone.js
.html_single.one_chapter
renamed tohtml.standalone.one_chapter
.output.html_dir
renamed tooutput.html.dir
.output.proofread.html_dir
renamed tooutput.proofread.html.dir
.html_dir.index.html
andhtml.dir.chapter.html
have been merged
and both renamed tohtml.dir.template
.tex.font_size
renamed totex.font.size
.
- Bugfixes:
- EPUB:
- Fix duplicate HTML escaping (resulting in e.g. "&" instead
of "&").
- Fix duplicate HTML escaping (resulting in e.g. "&" instead
- HTML directory:
- Fix panic when trying to generate html directory in "../xxx"
(#23). - Fix "previous chapter" links that were not displayed when
"html.header" was set.
- Fix panic when trying to generate html directory in "../xxx"
- HTML:
- Fix the way initial letter is displayed if
rendering.initials
is true.
- Fix the way initial letter is displayed if
- EPUB:
- Internationalization:
- Strings in generated Crowbook documents (such as "Table of
contents", "Title", "Cover" and such) are now translated in spanish.
- Strings in generated Crowbook documents (such as "Table of