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

[Soulliere, Robert]

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<mailto:ysuarez at berklee.edu>
617-747-2617

On Thu, Dec 1, 2016 at 2:47 PM, Rogan Hamby <rhamby at esilibrary.com<mailto: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<mailto: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<mailto:sandbej at linnbenton.edu> / 541-917-4655<tel:541-917-4655>
Pronouns: she/her/hers or they/them/theirs
_______________________________________________
OPEN-ILS-DOCUMENTATION mailing list
OPEN-ILS-DOCUMENTATION at list.georgialibraries.org<mailto: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<mailto:rogan at esilibrary.com>
1-877-OPEN-ILS | www.esilibrary.com<http://www.esilibrary.com>


_______________________________________________
OPEN-ILS-DOCUMENTATION mailing list
OPEN-ILS-DOCUMENTATION at list.georgialibraries.org<mailto: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.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://list.georgialibraries.org/pipermail/open-ils-documentation/attachments/20161201/8c496fb9/attachment-0001.html>