Weasy Print - Revision history

Andre: /* Install dependencies */

2019-05-21T12:11:32Z

Install dependencies

← Older revision		Revision as of 12:11, 21 May 2019
Line 13:		Line 13:

	===Install dependencies===		===Install dependencies===
	'''On Mac:''' You need to have [https://brew.sh/ brew] installed.		'''On Mac:'''
			You need to have [https://brew.sh/ brew] installed.

			Then run

	echo -e "export LC_ALL=en_US.UTF-8\nexport LANG=en_US.UTF-8" >> ~/.bash_profile		echo -e "export LC_ALL=en_US.UTF-8\nexport LANG=en_US.UTF-8" >> ~/.bash_profile

Andre: /* Installing weasyprint */

2019-05-21T12:09:57Z

Installing weasyprint

← Older revision		Revision as of 12:09, 21 May 2019
Line 11:		Line 11:

	Follow the installation instructions in https://weasyprint.readthedocs.io/en/stable/install.html		Follow the installation instructions in https://weasyprint.readthedocs.io/en/stable/install.html

			===Install dependencies===
			'''On Mac:''' You need to have [https://brew.sh/ brew] installed.

			echo -e "export LC_ALL=en_US.UTF-8\nexport LANG=en_US.UTF-8" >> ~/.bash_profile

			brew install cairo pango gdk-pixbuf libxml2 libxslt libffi


			'''On Debian/Ubuntu:'''
			sudo apt-get install libxml2-dev libxslt-dev libffi-dev libcairo2-dev libpango1.0-dev


	After installing Weasyprint dependencies, for your operating system		After installing Weasyprint dependencies, for your operating system

	Install Weasyprint using Python package installed: pip		===Install WeasyPrint===
	pip ~~install Weasyprint~~ --~~user~~		Install Weasyprint using Python package installed: pip ([https://pip.pypa.io/en/stable/installing/#installing-with-get-pip-py how to install pip])

	or
	pip3 install WeasyPrint		pip3 install WeasyPrint

Andre: /* Installing weasyprint */

2019-05-21T07:46:42Z

Installing weasyprint

← Older revision		Revision as of 07:46, 21 May 2019
Line 17:		Line 17:
	pip install Weasyprint --user		pip install Weasyprint --user

			or
			pip3 install WeasyPrint

	==Testing Weasy Print==		==Testing Weasy Print==

Andre at 11:59, 14 May 2019

2019-05-14T11:59:21Z

← Older revision		Revision as of 11:59, 14 May 2019
Line 1:		Line 1:
			Weasyprint is a python library, for creating PDF documents from HTML + CSS documents.

			It supports [https://www.w3.org/TR/CSS21/ CSS 2.1 Specification], including the [https://www.w3.org/TR/CSS21/page.html Paged media] properties, making one the best tools around to produce PDF documents from HTML + CCS.

			== Documentation ==
	http://weasyprint.org/		http://weasyprint.org/

			https://weasyprint.readthedocs.io

			== Installing weasyprint==

			Follow the installation instructions in https://weasyprint.readthedocs.io/en/stable/install.html

			After installing Weasyprint dependencies, for your operating system

			Install Weasyprint using Python package installed: pip
			pip install Weasyprint --user



	==Testing Weasy Print==		==Testing Weasy Print==

Andre: Created page with "http://weasyprint.org/ ==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..."

2016-04-17T16:20:16Z

Created page with "http://weasyprint.org/ ==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..."

New page

http://weasyprint.org/

==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 [http://beyond-social.org/ Beyond Social's] article [http://beyond-social.org/articles/Eiland_van_Brienenoord.html ''Eiland van Brienenoord''] onto a PDF using Weasy Print.

The CSS style-sheet that gave origin the PDF is [[#CSS style-sheet|located at the end of this page]]

[[File:web2print-BS07.pdf]]

==Running==
The standalone command <code>weasyprint</code> can produce a PDF, simply with the instructions:
weasyprint EilandvanBrienenoord.html -s style.css ouput.pdf

Where:
* <code>EilandvanBrienenoord.html</code> - is the souce HTML file (could also be a URL)
* <code>-s</code> - is the option for a CSS stylesheet
* <code>ouput.pdf</code> - the resulting PDF

== @page ==
@page CSS rule that determines orientation and page size is successfully rendered in the PDF.

<source lang="css">
@page {
size: A5 portrait;
}
</source>

== @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.

<source lang="css">
@page:right {
margin-left: 3cm; /*inner margin*/
margin-right:1cm; /*outer margin*/
}

@page:left {
margin-right: 3cm; /*inner margin*/
margin-left:1cm; /*outer margin*/
}
</source>

[[File:weasyprint-margins.png|600px]]

== @bottom ==
Weasy-print also applies consistently <code>@bottom</code> rules, including page counting.

<source lang="css">
@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;
}
</source>

== CSS Custom Fonts ==
Weasy Print does not support CSS's (<code>@font-face</code>) rule.

Yet it can use fonts available in your system.

On Linux `fc-list` will give you a list of fonts installed in your system

== Imposition ==
There is no mechanism to performs page impositions.

However, it is possible to perform imposition over the Weasy Print-generated PDF with software such as [http://kjo.herbesfolles.org/bookletimposer/ BookletImposer], [http://jpdftweak.sourceforge.net/ jPDF Tweak], [https://github.com/raffamaiden/pdftools pdftool], or [https://www.pdflabs.com/tools/pdftk-the-pdf-toolkit/ PDFtk].

[[File:web2print-BS07-booklet.pdf|Booklet produced with BookletImposer, having Weasy Print generated PDF as source]]

== More is needed ==
These tests and prototypes are far from exhaustive.

It is still unclear whether Weasy Print, CSS and HTML can produce quality PDFs, ready to be sent to a printer in order to produce paper-bound publication.
Yet the results seem promising.

More experimentation, prototypes, and feedback is needed in order to make a informed critique.

And contributions to [https://github.com/Kozea/WeasyPrint/ Weasy Print], can only help.

==CSS style-sheet==
<source lang="css">
@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;
}
</source>

==tutorials & posts on Weasy Print==
http://diethardsteiner.github.io/reporting/2015/02/17/CSS-for-print.html

==references==
<references/>

[[Category:Research]]