Vivliostyle Formatter 2016.4

Changes from 2016.1

Besides those changes, there are some features added/fixed in vivliostyle.js 2016.4, which is embedded in Vivliostyle Formatter.

Added

Changed

Fixed

Requirements

Installation

Windows

Use vivliostyle-formatter-2016.4-windws{32 or 64}/vivliostyle/vivliostyle-formatter.bat from command line. Use vivliostyle-formatter-2016.4-windws{32 or 64}/vivliostyle/vivliostyle_formatter_core.exe to call from your scripts and applications.

OS X

Run vivliostyle-formatter-2016.4-mac/install.sh to install. You can also use vivliostyle-formatter-2016.4-mac/vivliostyle/vivliostyle-formatter directly without installing.

Linux tar.gz

vivliostyle-formatter-2016.4-linux/vivliostyle/vivliostyle-formatter is the executable.

The archive contains an executable and some dependent libraries. You may need to install some other dependent shared libraries to run the executable. (You don't need to if you are using Ubuntu Desktop 14.04.3 LTS.)

Linux deb

To install type as following.

sudo dpkg -i vivliostyle-formatter-2016.4-deb/vivliostyle-formatter-2016.4-amd64.deb

If dependency problem occures, type the following:

sudo apt-get -f install

Linux rpm

To install type as following.

sudo yum install vivliostyle-formatter-2016.4-rpm/vivliostyle-formatter-2016.4.x86_64.rpm

Running Vivliostyle formatter

Run from command line.

Usage: vivliostyle-formatter source(file or URI) [options]

Source file is either a HTML file or an EPUB file. You can not use URL of an EPUB file.

Vivliostyle Formatter output these log files:

options

size, width and height are treated as values of the size property in the @page rule. When size property is already specified in the source document's style sheet, these options will be ignored.

–output=output
Specify output file path. Default value is vivliostyle-output.pdf in the current directory
–log-dir=log-dir
Specify log output directory. Default value is the current directory.
–page-size=size
Speficy the page size. One of the following: A3, A4, A5, B4, B5, JIS-B4, JIS-B5, letter, legal, ledger. Default value is A4. If width and height are specified, this option will be ignored.
–width=width
Specify the page width with length unit. Should be specified with height. e.g. 210mm
–height=height
Specify the page height with length unit. Should be specified with width. e.g. 297mm
–landscape
Set the page orientation as landscape. If width and height are specified, this option will be ignored.
–version
Display version information
–style=stylesheet
Apply a user stylesheet. Should be local file or URI.
–verbose
Log informative messages.
–license[=license file]
Import a license file or display the imported license.

Usage Example

vivliostyle-formatter http://vivliostyle.github.io/vivliostyle.js/samples/variable-page-size/ja-vertical/Takasebune/main.xhtml --page-size=B5 --landscape

X server (Linux)

Bug reports & feature requests

Please send them to