metanorma / mn-native-pdf

Development repository for mn2pdf with Metanorma document samples
3 stars 2 forks source link

= Metanorma Native PDF

image:https://github.com/metanorma/mn-native-pdf/workflows/ubuntu/badge.svg["Build Status", link="https://github.com/metanorma/mn-native-pdf/actions?workflow=ubuntu"] image:https://github.com/metanorma/mn-native-pdf/workflows/macos/badge.svg["Build Status", link="https://github.com/metanorma/mn-native-pdf/actions?workflow=macos"] image:https://github.com/metanorma/mn-native-pdf/workflows/windows/badge.svg["Build Status", link="https://github.com/metanorma/mn-native-pdf/actions?workflow=windows"]

The experimental PDFs are available here:

== Purpose

This repository pilots native PDF capabilities of Metanorma using XML-FO via Apache FOP.

== Installing Build Tools

You will need mn2pdf, envsubst, make and a number of fonts.

=== On macOS

[source,sh]

Install envsubst

brew install gettext brew link --force gettext

Install cabextract

brew install cabextract

[source,sh]

Install Microsoft Vista fonts

export RENAME_FONTS=false curl -Ls https://raw.githubusercontent.com/metanorma/vista-fonts-installer/master/vista-fonts-installer.sh | bash


Generating XSLT layouts (will be created under xslt/):

[source,sh]

make xslts

Building the document is then easy:

[source,sh]

make all

PDFs will be generated as documents/*.pdf


=== On Ubuntu Linux

[source,sh]

sudo apt-get -y install gettext-base cabextract wget

Install fontforge

sudo apt-get -y install software-properties-common

Install MS system fonts

echo ttf-mscorefonts-installer msttcorefonts/accepted-mscorefonts-eula select true | sudo debconf-set-selections sudo apt-get install ttf-mscorefonts-installer

Setup Cambria fonts

curl -Ls https://raw.githubusercontent.com/metanorma/vista-fonts-installer/master/vista-fonts-installer.sh | sudo bash

Generating XSLT layouts (will be created under xslt/):

[source,sh]

make xslts

Building the document is then easy:

[source,sh]

Pull submodules

make update-init update-modules

PDFs will be generated as documents/*.pdf

make all

== Copyright

Ribose Inc.