muse-compile.pl - format your muse document using Text::Amuse
muse-compile.pl [ options ] file1.muse [ file2.muse , .... ]
This program uses Text::Amuse to produce usable output in HTML, EPUB, LaTeX and PDF format.
By default, all formats will be generated. You can specify which format you want using one or more of the following options:
Full HTML output.
Full EPUB output.
HTML body alone (wrapped in a div tag)
div
LaTeX output
Pack the tex, the source and the html with the attachments in a zip file.
PDF output.
PDF output. Extension is .sl.pdf and it is a Beamer PDF. File .sl.tex is left in place.
Please note that the muse file must say that the slides are required. The header for that is #slides set to a value other than empty, 0, no, false.
#slides
0
no
false
Produce the beamer LaTeX file, using the same rule above.
PDF imposed on A4 paper, with a variable signature in the range of 40-80
As above, but on Letter paper.
The directory with the templates. Optional and somehow discouraged for normal usage.
Repeatable. Directory where to look for included files.
A specification JSON file with the list of fonts. This permits you to use arbitrary fonts. To create one with the default list, you can use the command muse-create-font-file.pl, generate one, then pass it to this script together with --extra mainfont="Font Name".
If not provided, the main/sans/mono font options will be used. Please note that you can't build epub with embedded fonts without the fontspec file (because the location of the fonts is unknown) and that you will be bypassing any font name validation, so there is no guarantee that they are valid. Here the script assumes that you know what you are doing when setting a font name.
Option to populated the above directory with the built-in templates.
A file where we can append the report failures
Prevent the removing of the status file. This is turned on if you use --recursive, to prevent multiple runs to compile everything again.
This option can be repeated at will. The key/value pairs will be passed to every template we process, regardless of the type, even if only the built-in LaTeX template support them.
The input is assumed to be UTF-8 (if you pass non-ascii characters). The values, before being passed to the templates, are interpreted as Text::Amuse strings. This normally doesn't have any side effects for simple strings, while for text this has the sane behaviour to escape special characters and to permit inline markup.
Example:
muse-compile.pl --extra site=http://anarhija.net \ --extra papersize=a6 --extra division=15 --extra twoside=true \ --extra bcor=10mm --extra mainfont="Charis SIL" \ --extra sitename="Testsite" \ --extra siteslogan="Anticopyright" \ --extra logo=mylogo \ --extra cover=mycover.pdf \ --extra opening=any \ file.muse
See muse-compile.pl --help --verbose for the full description of meaning of these options.
Using this options, the target directory and a recursive compiling is started, finding all the .muse files without a newer status file, and compiling them accordingly to the options.
No target files can be specified.
For recursive compile, you can pass this option to just list the files which would be compiled.
Use lualatex instead of xelatex.
Purge old files before compiling. Not supported for recursive compilation.
Create a coverpage only if there is a table of contents, otherwise use an article class.
To install Text::Amuse::Compile, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Text::Amuse::Compile
CPAN shell
perl -MCPAN -e shell install Text::Amuse::Compile
For more information on module installation, please visit the detailed CPAN module installation guide.