9.8 Publishing LaTeX documents

This publishing style is capable of producing LaTeX or PDF documents.

If you wish to publish PDF documents, you will need to have a good LaTeX installation. For Debian and Ubuntu, this can be accomplished by installing the “tetex-bin” and “tetex-extra” packages. TeX fonts are also a must.

If your LaTeX installation has the file grffile.sty, which may be found in the texlive-latex-recommended package for Debian and Ubuntu, then consider using it by adding the following to your header file. This allows spaces in filenames to work.

     \usepackage{grffile}

Styles provided

latex

Publish a LaTeX document.

pdf

Publish a PDF document, using an external LaTeX document conversion tool.

latexcjk

Publish a LaTeX document with CJK (Chinese) encodings.

pdfcjk

Publish a PDF document with CJK (Chinese) encodings, using an external LaTeX document conversion tool.

slides

Publish a LaTeX document that uses the Beamer extension. This is suitable for producing slides.

Here is an example of a slide.

          <slide title="First Slide">
          Everything between the slide tags composes this slide.
          
          [[Some-sort-of-cute-image.png]]
          
           - A bullet point.
           - Another bullet point.
          </slide>

slides-pdf

Publish a PDF document of slides, using the Beamer extension.

lecture-notes

Publish a LaTeX document that uses the Beamer extension. This is suitable for producing lecture notes.

This can also use the <slide> tag.

lecture-notes-pdf

Publish a PDF document of lecture notes, using the Beamer extension.

Options provided

muse-latex-extension

Default file extension for publishing LaTeX files.

muse-latex-pdf-extension

Default file extension for publishing LaTeX files to PDF.

muse-latex-pdf-browser

The program to use when browsing a published PDF file.

This should be a format string.

muse-latex-pdf-program

The program that is called to generate PDF content from LaTeX content.

muse-latex-pdf-cruft

Extensions of files to remove after generating PDF output successfully.

muse-latex-header

Header used for publishing LaTeX files.

This may be text or a filename.

muse-latex-footer

Footer used for publishing LaTeX files.

This may be text or a filename.

muse-latexcjk-header

Header used for publishing LaTeX files (CJK).

This may be text or a filename.

muse-latexcjk-footer

Footer used for publishing LaTeX files (CJK).

This may be text or a filename.

muse-latex-slides-header

Header for publishing of slides using LaTeX.

This may be text or a filename.

You must have the Beamer extension for LaTeX installed for this to work.

muse-latex-lecture-notes-header

Header publishing of lecture notes using LaTeX.

This may be text or a filename.

You must have the Beamer extension for LaTeX installed for this to work.

muse-latex-markup-regexps

List of markup regexps for identifying regions in a Muse page.

For more on the structure of this list, See muse-publish-markup-regexps.

muse-latex-markup-functions

An alist of style types to custom functions for that kind of text.

For more on the structure of this list, See muse-publish-markup-functions.

muse-latex-markup-strings

Strings used for marking up text.

These cover the most basic kinds of markup, the handling of which differs little between the various styles.

muse-latex-slides-markup-tags

A list of tag specifications, for specially marking up LaTeX slides.

muse-latexcjk-encoding-map

An alist mapping emacs coding systems to appropriate CJK codings. Use the base name of the coding system (ie, without the -unix).

muse-latexcjk-encoding-default

The default Emacs buffer encoding to use in published files.

This will be used if no special characters are found.

muse-latex-markup-specials-document

A table of characters which must be represented specially. These are applied to the entire document, sans already-escaped regions.

muse-latex-markup-specials-example

A table of characters which must be represented specially. These are applied to example> regions.

With the default interpretation of <example> regions, no specials need to be escaped.

muse-latex-markup-specials-literal

A table of characters which must be represented specially. This applies to =monospaced text= and <code> regions.

muse-latex-markup-specials-url

A table of characters which must be represented specially. These are applied to URLs.

muse-latex-markup-specials-image

A table of characters which must be represented specially. These are applied to image filenames.

muse-latex-permit-contents-tag

If nil, ignore <contents> tags. Otherwise, insert table of contents.

Most of the time, it is best to have a table of contents on the first page, with a new page immediately following. To make this work with documents published in both HTML and LaTeX, we need to ignore the <contents> tag.

If you don't agree with this, then set this option to non-nil, and it will do what you expect.