[OPEN-ILS-DOCUMENTATION] How do you make a2x PDF output stylish?

[Jane Sandberg]

Thanks, Robert!  This is very very helpful.

On Thu, Dec 1, 2016 at 12:38 PM, Soulliere, Robert
<robert.soulliere at mohawkcollege.ca> wrote:
> 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:open-ils-documentation-bounces at list.georgialibraries.org] On Behalf
> Of Yamil Suarez
> Sent: December-01-16 3:25 PM
> To: Documentation discussion for Evergreen software
> <open-ils-documentation at list.georgialibraries.org>
> 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
>
>
>
> ysuarez at berklee.edu
>
> 617-747-2617
>
>
>
> On Thu, Dec 1, 2016 at 2:47 PM, Rogan Hamby <rhamby at esilibrary.com> 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 <sandbej at linnbenton.edu>
> 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
> sandbej at linnbenton.edu / 541-917-4655
> Pronouns: she/her/hers or they/them/theirs
> _______________________________________________
> OPEN-ILS-DOCUMENTATION mailing list
> OPEN-ILS-DOCUMENTATION at list.georgialibraries.org
> http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation
>
>
>
>
>
> --
>
> --------------------------------------------------------------
>
> Rogan R. Hamby, Data and Project Analyst
>
> Equinox - Open Your Library
>
> rogan at esilibrary.com
>
> 1-877-OPEN-ILS | www.esilibrary.com
>
>
>
>
> _______________________________________________
> OPEN-ILS-DOCUMENTATION mailing list
> OPEN-ILS-DOCUMENTATION at list.georgialibraries.org
> 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
> OPEN-ILS-DOCUMENTATION at list.georgialibraries.org
> http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation
>



-- 
Jane Sandberg
Electronic Resources Librarian
Linn-Benton Community College
sandbej at linnbenton.edu / 541-917-4655
Pronouns: she/her/hers or they/them/theirs