z3c.rml 3.6.1

Improve IntegerSequence field to return ranges using lists of two numbers instead of listing them all out.

Extended IntegerSequence to allow specification of first number and lower/upper bound inclusion.

Updated ConcatenationPostProcessor to handle the new integer sequence data structure. Since this is so much more efficient for the merging library, there was a 5x improvement when including PDFs with page ranges.

Implemented a PdfTk-based concatenation post-processor. PdfTk is very fast, but unfortunatelya lot of the gain is lost, since the outline must be merged in manually. The PdfTk post-processor can be enabled by:

from z3c.rml import pdfinclude
pdfinclude.IncludePdfPages.ConcatenationPostProcessorFactory = \
    pdfinclude.PdfTkConcatenationPostProcessor

Fix initial blank page when PDF inclusion is first flowable. [Kyle MacFarlane]

Support for Python 3.5 [Kyle MacFarlane]

attr.getFileInfo() crashed if the context element wasn’t parsed.

Implemented all PDF viewer preferences. [Kyle MacFarlane]

• HideToolbar

• HideMenubar

• HideWindowUI

• FitWindow

• CenterWindow

• DisplayDocTitle

• NonFullScreenPageMode

• Direction

• ViewArea

• ViewClip

• PrintArea

• PrintClip

• PrintScaling

They are all available via the docinit tag.

Added SVG support to the image and imageAndFlowables tags. [Kyle MacFarlane]

Approach: Convert the drawing to a PIL Image instance and pass that around just like a regular image. The big problem is that in the conversion from Drawing to Image stroke width can often get messed up and become too thick. I think this is maybe down to how scaling is done but you can avoid it by editing the SVGs you want to insert. You also lose any transparency and get a white background. Basically you no longer really have a vector graphic but instead a 300 DPI bitmap that is automatically scaled to the correct size with little quality loss.

Added ability to look for font files in packages using the standard “[package.path]/dir/filename” notation. [Kyle MacFarlane]

Documented the pageSize versus pagesize attribute difference on template and pageTemplate elements compared to RML2PDF. [Kyle MacFarlane]

namedString element now evaluates its contents so you can use things like pageNumber inside of it. [Kyle MacFarlane]

Implemented evalString using Python’s eval() with builtins disabled. [Kyle MacFarlane]

getName element now checks if it has a default attribute. This is used as a width measurement for a first pass or as the actual value if the reference isn’t resolved after the second pass. [Kyle MacFarlane]

getName element now supports forward references. This means you can now do things like “Page X of Y”. This only works in the drawString and para elements. [Kyle MacFarlane]

General performance improvements. [Kyle MacFarlane]

Improved performance by not applying a copy of the default style to every table cell and also by not even trying to initialise the attributes if lxml says they don’t exist. [Kyle MacFarlane]

MergePostProcessor class did not copy document info and table of contents (aka Outlines) of inputFile1. That meant that if you used any includePdfPages or mergePage directives you lost any outlineAdd directive effect. [Alex Garel]

Fixed any failing tests, including the ones failing on Windows. [Kyle MacFarlane]

Fixed the table borders not printing or even appearing in some viewers. [Kyle MacFarlane]

Updated bootstrap.py and buildout.cfg to work with the latest version of zc.buildout.

Updated build to use latest version of lxml.

Implemented saveState and restoreState directives. (LP #666194)

Implemented storyPlace directive. (LP #665941)

Implemented clip attribute of path directive. See RML example 041.

Added h4, h5, and h6 directives.

Implemented codesnippet directive.

Implemented pageBreakBefore, frameBreakBefore, textTransform, and endDots attributes for paragraph styles.

Added maxLineLength and newLineChars attributes to the pre directive.

Implemented pageNumber element for all draw*String elements.

Implemented NamedString directive.

Implemented startIndex and showIndex directive. Also hooked up index in paragraphs properly. You can now create real book indexes.

Implemented ol, ul, and li directives, which allow highly flexible lists to be created. Also implemented a complimentary listStyle directive.

Implemented the following doc-programming directives:

• docAssert

• docAssign

• docElse

• docIf

• docExec

• docPara

• docWhile

Added encName attribute to registerCidFont directive.

Renamed bookmark to bookmarkPage.

Created a new canvas directive called bookmark.

Added img directive, which is a simple image flowable.

Implemented crop marks support fully.

Added pageLayout and pageMode to docInit directive.

Implemented all logging related directives.

Implemented color directive inside the initialize directive.

Renamed pdfInclude to documented includePdfPages and added pages attribute, so that you can only include specific pages.

Don’t show “doc” namespace in reference snippets.

Create a list of RML2PDF and z3c.rml differences.

Implemented the ABORT_ON_INVALID_DIRECTIVE flag, that when set True will raise a ValueError error on the first occurence of a bad tag.

Implemented setFontSize directive for page drawings.

Implemented plugInGraphic which allows inserting graphics rendered in Python.

Added href and destination to table cells and rectangles.

Bug: Due to a logic error, bad directives were never properly detected and logged about.

Bug: Overwriting the default paragraph styles did not work properly.

Bug: Specifying a color in any tag inside the paragraph would fail, if the color was a referenced name.

Bug: Moved premature getName evaluation into runtime to properly handle synamic content now. This is now properly done for any paragraph and draw string variant.

Bug: Fixed DTD generator to properly ignore Text Nodes as attributes. Also text nodes were not properly documented as element PCDATA.

Feature: Added a Chinese PDF sample file to tests/expected under the name sample-shipment-chinese.pdf.

Feature: Added another tag that is commonly needed in projects. The <keepTogether> tag will keep the child flowables in the same frame. When necessary, the frame break will be automatic. Patch by Yuan Hong.

Feature: Added the “alignment” attribute to the blockTable directive. This attribute defines the horizontal alignment for a table that is not 100% in width of the containing flowable. Patch by Yuan Hong.

Feature: When creating Chinese PDF documents, the normal TTF for Chinese printing is ‘simsun’. However, when bold text is neeed, we switch to ‘simhei’. To properly register this, we need the reportlab.lib.fonts.addMapping function. This is missing in the reportlab RML specification, so a new directive has been defined:

<addMapping faceName="simsun" bold="1" italic="0" psName="simhei" />

Patch by Yuan Hong.

Feature: The para and paraStyle directive now support the “wordWrap” attribute, which allows for selecting a different wrod wrapping algorithm. This is needed because some far-East Asian languages do not use white space to separate words. Patch by Yuan Hong.

Bug: Handle Windows drive letters correctly. Report and fix by Yuan Hong.