z3c.rml 2.4.0

An alternative implementation of RML

z3c.rml – An alternative implementation of RML

This is an alternative implementation of ReportLab’s RML PDF generation XML format. Like the original implementation, it is based on ReportLab’s reportlab library.

You can read all about z3c.rml and see many examples on how to use it, see the RML Reference

Travis:

CHANGES

2.4.0 (2013-12-05)

• Switch from pyPdf to the newer, maintained PyPDF2 library.

2.3.1 (2013-12-03)

• Report correct element during error reporting.

• registerFontFamily never worked until now, since the directive was not properly registered.

2.3.0 (2013-09-03)

• Added title, subject, author, and creator attributes to document element. Those are set as PDF annotations, which are now commonly used to hint viewers window titles, etc. (Those fields are not available in RML2PDF.)

2.2.1 (2013-08-06)

• Make the number of max rendering passes configurable by exposing the setting in the API.

• Added align attribute to img tag.

2.2.0 (2013-07-08)

• Added a new console script “rml2pdf” that renders an RML file to PDF.

• Added preserveAspectRatio to img tag flowable. The attribute was already supported for the image tag.

2.1.0 (2013-03-07)

• 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.

2.0.0 (2012-12-21)

• 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.

1.1.0 (2012-12-18)

• Upgrade to ReportLab 2.6. This required some font changes and several generated PDFs did not match, since some default fonts changed to sans-serif.

• Added pdfInclude directive from Alex Garel. (LP #969399).

• Switched to Pillow (from PIL).

• Switched RML highlighting in RML Reference from SilverCity to Pygments.

• Bug: Addressed a bug in ReportLab 2.6 that disallowed 3-D pie charts from rendering.

• Bug: Properly reset pdfform before rendering a document.

• Bug: Reset fonts properly before a rendering.

1.0.0 (2012-04-02)

• Using Python’s doctest module instead of depreacted zope.testing.doctest.

0.9.1 (2010-07-22)

• I found a more complete paragraph border patch from Yuan Hong. Now the DTD is updated, the border supports a border radius and the tag-para.rml sample has been updated.

0.9.0 (2010-07-22)

• Upgraded to ReportLab 2.4. This required some font changes and several generated PDFs did not match, since some default fonts changed.

• Upgraded to latest lxml. This only required a trivial change. Patch by Felix Schwarz.

• Implemented linePlot3D directive. Patch by Faisal Puthuparackat.

• Added paragraph border support. Patch by Yuan Hong.

• Bug: Fixed version number in reference.pt. Patch by Felix Schwarz.

• Bug: Write PDF documents in binary mode. Patch by Felix Schwarz.

0.8.0 (2009-02-18)

• Bug: Use python executable as a part of the subprocess command.

• Add support for RML’s pageNumber element.

0.7.3 (2007-11-10)

• Make sure that the output dir is included in the distribution.

0.7.2 (2007-11-10)

• Upgraded to work with ReportLab 2.1 and lxml 1.3.6.

• Fix sub-process tests for a pure egg setup.

0.7.1 (2007-07-31)

• Bug: When the specified page size (within the pageInfo element) was a word or set thereof, the processing would fail. Thanks to Chris Zelenak for reporting the bug and providing a patch.

0.7.0 (2007-06-19)

• 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.

0.6.0 (2007-06-19)

• Bug: Fixed setup.py to include all dependencies.

• Bug: Added test to show that a blocktable style can be applied multiple times. A user reported that this is not working, but I could not replicate the problem.

• Update: Updated the expected renderings to ReportLab 2.1. There were some good layout fixes that broke the image comparison.

0.5.0 (2007-04-01)

• Initial Release