Hi Jane, As Yamil explains it is a multistep process using xsltproc and fop to get the PDF output. The current documentation does not use a2x for the PDF content. There is an old repository of stylesheets here:
https://github.com/rsoulliere/Evergreen_Documentation_Tools/tree/master/stylesheets/evergreen_docbook_files There is some old but good documentation on customizing the output of the documentation: http://www.sagehill.net/docbookxsl/CustomizingPart.html One key tool you will need to install is FOP as explained in this chapter: http://www.sagehill.net/docbookxsl/InstallingAnFO.html n Not sure if this is still useful since it has been a long time since I have installed it on a server. Regards, Robert From: OPEN-ILS-DOCUMENTATION [mailto:[email protected]] On Behalf Of Yamil Suarez Sent: December-01-16 3:25 PM To: Documentation discussion for Evergreen software <[email protected]> Subject: Re: [OPEN-ILS-DOCUMENTATION] How do you make a2x PDF output stylish? Jane, As far as I know, the folks that set up the documentation server also created some templates that at some point in the conversion process get called when the HTML and PDF versions are created. Additionally, the complete process behinds the scenes is to take the AsciiDoc and convert it to DocBook XML. Then the DocBook XML is combined with the aforementioned header/footer templates created by the EG community. Somewhere I have a link to a Github page with copies of older versions of those templates. Let em know if you want to look at them, but remember they are in DocBook format. Later, Yamil -------------------------------- Yamil Suarez, MCS Associate Director of Library Systems & Web Development Stan Getz Library Berklee College of Music 1140 Boylston St Boston, MA 02215 [email protected]<mailto:[email protected]> 617-747-2617 On Thu, Dec 1, 2016 at 2:47 PM, Rogan Hamby <[email protected]<mailto:[email protected]>> wrote: Have you tried the --fop parameter? warning: I am not terribly familiar a2x but use it for basic documents and use that to generate the PDF On Thu, Dec 1, 2016 at 2:37 PM, Jane Sandberg <[email protected]<mailto:[email protected]>> wrote: Hi all, The official docs has a really lovely PDF version with Evergreen colors and a footer that asks folks to report doc bugs in launchpad. [1] However, when I run the a2x command, I just get the run-of-the-mill dblatex style. [2, 3] How can I get the lovely Evergreen formatting? Is that defined in a file somewhere? Or are there more arguments I should be passing to the a2x command? Thanks for your help! -Jane [1] http://docs.evergreen-ils.org/2.11/Evergreen_Documentation.pdf [2] http://docs-testing.evergreen-ils.org/docs/reorg/staffclient_sysadmin/Evergreen_Documentation.pdf [3] The command I'm running: a2x --verbose --format pdf -d book --destination-dir destination root.txt -- Jane Sandberg Electronic Resources Librarian Linn-Benton Community College [email protected]<mailto:[email protected]> / 541-917-4655<tel:541-917-4655> Pronouns: she/her/hers or they/them/theirs _______________________________________________ OPEN-ILS-DOCUMENTATION mailing list [email protected]<mailto:[email protected]> http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation -- -------------------------------------------------------------- Rogan R. Hamby, Data and Project Analyst Equinox - Open Your Library [email protected]<mailto:[email protected]> 1-877-OPEN-ILS | www.esilibrary.com<http://www.esilibrary.com> _______________________________________________ OPEN-ILS-DOCUMENTATION mailing list [email protected]<mailto:[email protected]> http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation ________________________________ This E-mail contains privileged and confidential information intended only for the individual or entity named in the message. If the reader of this message is not the intended recipient, or the agent responsible to deliver it to the intended recipient, you are hereby notified that any review, dissemination, distribution or copying of this communication is prohibited. If this communication was received in error, please notify the sender by reply E-mail immediately, and delete and destroy the original message.
_______________________________________________ OPEN-ILS-DOCUMENTATION mailing list [email protected] http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation
