Skip to content

Release 0.5.4 (2022-06-17)

Latest
Compare
Choose a tag to compare
@brechtm brechtm released this 18 Jun 12:55
· 97 commits to master since this release

Install from PyPI - documentation

A discussion board has been set up where you can connect with other rinohtype users and the developers!

New Features:

  • Support for sideways figures and tables; these are placed on a separate page,
    rotated 90 degrees. This is useful for figures/tables that do not fit within
    the page width. See the float style attribute.
  • The GroupedFlowables same_page style property forces all of a
    GroupedFlowables' content to be placed on the same page (if possible).
  • Support for OpenType fonts with non-BMP Unicode characters (PR #308 by James
    Robinson)
  • Heading labels (numbers) can be styled separately by means of the 'heading
    level X label' selectors for each heading level X.
  • Sphinx Graphviz extension (sphinx.ext.graphviz) support (PR #300 by
    Daniel Rapp)
  • The StyledText no_break_after style property accepts a list of words after
    which no line break is allowed. The default is to use a list of words
    specific to the language configured for the template (articles, prepositions,
    conjunctions - only provided for English and Czech for now).
  • Footnotes and citations can now optionally be rendered where they are located
    in the source document instead of as footnotes. This is controlled by the
    location style property for notes. (issue #269, PR #271 by Alex Fargus)
  • The before and after style properties are now supported on paragraphs too
  • The separator string between an inline admonition title and the admonition
    text is now specified in the style sheet (after property of the admonition
    inline title
    style), so it can be overridden (default: space character).
  • Warn about targets in rinoh_targets that are not defined in
    rinoh_documents.
  • UpDownExpandingContainer: a container that symmetrically expands both upwards
    and downwards.
  • Admonition: selectors for the first paragraph where the admonition title was
    prepended to (e.g. note title paragraph).
  • Support interlaced PNG images (#274). Note that this can slow down rendering
    significantly for many/large interlaced images.
  • rinoh now accepts the --versions argument, useful for bug reports

Changed:

  • Support for Python 3.6 was dropped (end-of-life in December 2021)
  • Provide a more informative exception message when Pillow cannot be imported.

Fixed:

  • Fix cross-referencing of citations defined in the master Sphinx document
  • ContainerOverflow when rendering (some) labeled flowables near the bottom of
    the page (issue #315)
  • rinoh crashes with an unhandled exception when the template is not found
    (issue #291)
  • rinoh --format option is broken (issue #284)
  • Unhandled exception on loading some JPEG images (issue #319)
  • Page breaks for sections following an empty section were not respected.
  • Compatibility with Sphinx 4.4 on Python <3.10 (AttributeError: 'DynamicRinohDistribution' object has no attribute '_normalized_name')
  • In some cases, footnotes referenced in a table were placed on the page
    preceding the footnote reference.
  • Handle output (PDF, style log and cache) filenames containing a dot in the
    stem (the final dot and characters following it were interpreted as an
    extension and dropped)
  • Compatibility with Sphinx 4.3 (crash on rendering object descriptions)
  • Regression in handling of unsupported docutils nodes
  • Crash due to floating point rounding error (PR #302 by Sam Hartman)
  • Setting 'number_format' to none caused a crash; now it causes the caption
    label to be omitted.
  • Handle citations and corresponding citation references that are not defined
    in the same source file.
  • Fix error message for --stylesheet argument with relative path (issue #253,
    PR #266 by Alex Fargus)
  • Descenders affect spacing between top border and content (issue #144)
  • The table of contents (outlines) displayed in PDF readers show garbled text
    when section titles contain non-ASCII characters.
  • Page templates with a page-filling background cause an infinite rendering
    loop when placing a footnote.
  • Crash on loading PNGs containing an iTXt chunk (PR #275 by Alex Fargus)
  • Line-wrapped section headings without hyphenation are missing from the page
    header.
  • Sphinx frontend: inline text marked with the :menuselection: role is not
    styled (now mapped to the menu cascade style).
  • Typos in code and documentation (PR #277 by Tim Gates, PR #281 by Filipe
    Tavares)
  • Handle deprecation of importlib SelectableGroups dict interface (Python 3.10
    and importlib_metadata 3.6)
  • Handle deprecation of distutils in Python 3.10 (use the packaging package)

Part of the work included in this release was kindly sponsored by Lekis and Railnova.