Difference between revisions of "Research/Web-to-print/WeasyPrint"
Line 152: | Line 152: | ||
Weasy Print does not support CSS's (<code>@font-face</code>) rule. | Weasy Print does not support CSS's (<code>@font-face</code>) rule. | ||
To use custom fonts it relies on Pango library | To use custom fonts it relies on [Pango library http://www.pango.org/] | ||
A discussion on the use of custom fonts can be followed on Weasy Print's [https://github.com/Kozea/WeasyPrint/issues/231 Github issue] | <ref name="fonts">A discussion on the use of custom fonts can be followed on Weasy Print's [https://github.com/Kozea/WeasyPrint/issues/231 Github issue]</ref>. | ||
== Imposition == | == Imposition == |
Revision as of 10:56, 27 November 2015
<slidy theme="a" />
Print in hybrid publishing workflows
Print products = bottleneck in hybrid publishing workflows
Screens in pages represent different paradigms
- Instead of reflowable text, continuous space, variable screen size
- Page: a fixed space
The translation of layouts for screen to page layouts, within is not trivial.
HTML-to-print Tools
- LaTex
- Browser built-in PDF rendering
- Desktop publishing software
- Weasy Print.
LaTex
A type-setting/document preparation language, focused on producing typographicaly correct PDFs.
positive aspects
- LaTex is a markup language;
- Pandoc converts seamlessly to LaTex.
- Supports page numbers, hyphenation, bibliography, references, hyperlinks, etc, etc...
- Can produce more experimental and generative outputs. [1].
negative aspects
- Outputs are by default look academic, although this can be changed
- Use is outmoded
- Styling is defined by packages imported into the document, which is very different and incompatible with CSS.
- A difficult tool to work with, let alone to teach.
Browser built-in pdf rendering
Current browsers have built-in pdf rendering engines. By using the browser function «Print to file» and CSS rules for print, print layouts can be created from HTML files.
positive aspects
- relies on the same set of technologies - HTML, CSS and JS - as other hybrid publishing formats: webpages, ePubs, apps
- it is simple, easily to teach
- CSS includes page specific options:
@media page
rule, and the pseudo-classes:first :left :right @bottom-left
negative aspects
- works poorly and inconsistently
- requires a lot of trial-and-error to achieve the desired output, with results differing widely across browsers and versions
OSP
OSP is making a lot of efforts in this area.
html2print tool (recently developed) http://lurk.org/groups/80c/messages/topic/4CIuW3jpiAFLwllZN3itFV/
Desktop publishing software
Software such as Scribus and inDesign can be incorporated into an HP workflow.
Scribus can import HTML files and inDesign ICML(XML)files. Both formats keep their structure when imported and can remain updatable.
positive aspects
- allows direct feedback between operations and their effects
- graphic designers are familiar their workflows
- can produce complex PDFs with impositions, hyphenation, page numbers. etc
- can intervene in almost all aspects of the document
negative aspects
- to keep the content updatable operations (in inDesign) interventions on content are not possible
- complex structures, like large tables, are difficult to handle, while keeping content updatable (in inDesign)
Weasy Print
Weasy Print (WP)[2] is a visual rendering engine for HTML to PDF, that uses CSS.
Its CSS layout engine is written in Python, but employs several libraries to render the PDF.
positive aspects
- Uses HTML and CSS to layout the PDF
- Supports features like page size, page numbering, hyphenation in several languages[3]
- Resulting PDFs can achieve high level of complexity, with simple instructions
- Simple and easy to use
- Can be used as a Python library or as a standalone program
- Free software (BSD license)
- Cleal documentation
negative aspects
- Can be difficult to install, due to its dependencies
- It does not support CSS custom fonts - uses Pango library to manage fonts
- No support for folded formats, such as booklets: no mechanism for imposition
Testing Weasy Print
At the first glance Weasy Print sounds promising, so why not try to see how well does it performs conversions from HTML to PDF?
The following PDF results from the conversion of the Beyond Social's article Eiland van Brienenoord onto a PDF using Weasy Print.
The CSS style-sheet that gave origin the PDF is located at the end of this page
Running
The standalone command weasyprint
can produce a PDF, simply with the instructions:
weasyprint EilandvanBrienenoord.html -s style.css ouput.pdf
Where:
EilandvanBrienenoord.html
- is the souce HTML file (could also be a URL)-s
- is the option for a CSS stylesheetouput.pdf
- the resulting PDF
@page
@page CSS rule that determines orientation and page size is successfully rendered in the PDF.
@page {
size: A5 portrait;
}
@page left @page right
Option for the left and right pages, such as the margin sizes, which have to alternate in order to produce a bound work, are correctly rendered.
@page:right {
margin-left: 3cm; /*inner margin*/
margin-right:1cm; /*outer margin*/
}
@page:left {
margin-right: 3cm; /*inner margin*/
margin-left:1cm; /*outer margin*/
}
@bottom
Weasy-print also applies consistently @bottom
rules, including page counting.
@bottom-right {
margin: 10pt 0 30pt 0;
border-top: .25pt solid #FF05F6;
content: "Testing WeasyPrint";
font-size: 6pt;
color: #00FFF2;
}
@bottom-center {
margin: 10pt 0 30pt 0;
content: counter(page);
font-size: 6pt;
}
CSS Custom Fonts
Weasy Print does not support CSS's (@font-face
) rule.
To use custom fonts it relies on [Pango library http://www.pango.org/]
[4].
Imposition
There appears to be no mechanism that performs page impositions.
Although it is possible to perform imposition over the Weasy Print-generated PDF with software such as BookletImposer, jPDF Tweak, pdftool, or PDFtk.
More is needed
These tests and prototypes are far from exhaustive.
It is still unclear weather Weasy Print, CSS and HTML can produce quality PDFs, ready to send to a printer in order to produce paper-bound publication.
The results are promising.
Yet more experimentation, prototypes, and feedback is needed in order to make a informed critique.
And contributions to Weasy Print, will only help.
CSS style-sheet
@page {
size: A5 portrait;
}
@page:right {
margin-left: 3cm; /*inner*/
margin-right:1cm; /*outer*/
@bottom-right {
margin: 10pt 0 30pt 0;
border-top: .25pt solid #FF05F6;
content: "Testing WeasyPrint";
font-size: 6pt;
color: #00FFF2;
}
@bottom-center {
margin: 10pt 0 30pt 0;
content: counter(page);
font-size: 6pt;
}
}
@page:left {
margin-right: 3cm; /*inner*/
margin-left:1cm; /*outer*/
@bottom-left {
margin: 10pt 0 30pt 0;
border-top: .25pt solid #00FFF2;
content: "Testing WeasyPrint";
font-size: 6pt;
color: #FF05F6;
}
@bottom-center {
margin: 10pt 0 30pt 0;
content: counter(page);
font-size: 6pt;
}
}
@page:first {
@bottom-center { content: ""; }
@bottom-right { content: ""; }
}
body{
font-size:8pt;
font-family: sans;
padding: 0.5cm;
}
a, a:visited, a:hover {color:#00FFF2;}
hr { color:#00FFF2;
border:solid 1px #00FFF2;
}
div.title-beyond h1 {font-size:4em;
margin-top:-40px;
} /*title*/
h1,h2,h3,h4,h5 {color:#FF05F6; }
figure {
margin-left:0px;
padding-top:0.5cm;
}
img{ width: 6cm; }
figcaption { font-size:0.8em;
width:6cm;
}
tutorials & posts on Weasy Print
http://diethardsteiner.github.io/reporting/2015/02/17/CSS-for-print.html
references
- ↑ See works by Lafkon studio for an idea of the possibilities
- ↑ “WeasyPrint Documentation” http://weasyprint.org/docs/.
- ↑ With the pyphen library
- ↑ A discussion on the use of custom fonts can be followed on Weasy Print's Github issue