9.2 Publishing entries into a compilation

This publishing style is used to output “books” in LaTeX or PDF format.

Each page will become a separate chapter in the book, unless the style keyword :nochapters is used, in which case they are all run together as if one giant chapter.

One way of publishing a book is to make a project for it, add the project to muse-project-alist, and use the book-pdf style with a very specific :include value to specify some page whose contents will be checked for the values of #title and #date, and whose name will be used in the output file. Then to publish the book, visit the aforementioned page and use C-c C-t or C-c C-p to trigger the publishing process. An example muse-project-alist for this method follows.

     (setq muse-project-alist
           '(("MyNotes" (:nochapters t  ; do automatically add chapters
                         :book-chapter "Computer Science"
                         "~/Notes/cs"
                         :book-chapter "Mathematics"
                         "~/Notes/math"
                         :book-chapter "Emacs"
                         "~/Notes/emacs"
                         :book-end t ; the rest will not be placed in the book
                         "~/Notes"   ; so we can find the notes-anthology page
                         "~/Notes/private"
                         :force-publish ("index")
                         :default "index")
              (:base "book-pdf"
                     :include "/notes-anthology[^/]*$"
                     :path "~/public_html/notes")
              ;; other publishing styles for each directory go here,
              ;; if desired
              )))

In this example, there would be a file called ~/Notes/notes-anthology.muse, which would contain just the following. The resulting book would be published to ~/public_html/notes/notes-anthology.pdf.

     #title My Technology Ramblings

Another way is to call the muse-book-publish-project function manually, with a custom project entry. An example of this may be found in John Wiegley's configuration file at examples/johnw/muse-init.el, in the muse-publish-my-books function.

Styles provided

book-latex

Publish a book in LaTeX form. The header and footer are different than the normal LaTeX publishing mode.

book-pdf

Publish a book in PDF form. The header and footer are different than the normal PDF publishing mode.

Options provided

muse-book-before-publish-hook

A hook run in the book buffer before it is marked up.

muse-book-after-publish-hook

A hook run in the book buffer after it is marked up.

muse-book-latex-header

Header used for publishing books to LaTeX.

This may be text or a filename.

muse-book-latex-footer

Footer used for publishing books to LaTeX.

This may be text or a filename.