Re: [docbook-apps] Show off what you've done with Docbook

2015-09-12 Thread John W. Shipman
On 09/11/2015 12:56 PM, Katie Welles wrote: +-- | Have any of you PDF + HTML output with Docbook? If anyone has | such a project and will be willing to show it off, send some URLs! +-- I've been using DocBook as a vehicle for literate programming for well over ten years now. Here are several

Re: [docbook-apps] Restrictive Docbook XML editor which enforces Docbook schema?

2015-01-15 Thread John W. Shipman
On Thu, 15 Jan 2015, Dan Shelton wrote: +-- | Is there a Docbook XML editor which enforces the Docbook | schema during editing? | | I am looking for an editor which loads the Docbook XML schema and then | only allows the creation of tags which are allowed at the current | position in the XML

[docbook-apps] Literate customization layer

2013-03-08 Thread John W. Shipman
Here at the New Mexico Tech Computer Center, we've been using DocBook for all our official publications for over ten years now. I thought some of you might like to see our customization layer. It is literate in the Don Knuth sense---the actual XSLT is embedded in the documentation explaining

[docbook-apps] XSL-FO generation tool available

2012-05-08 Thread John W. Shipman
I've just put the finishing touches on a Python module to assist in the programmatic construction of XSL-FO files. It's built on top of lxml: http://www.nmt.edu/tcc/projects/fohelpers If you find this useful or have any comments, I'd like to hear about it. I realize XSL-FO is a dead

[docbook-apps] Python to PDF via XSL-FO

2012-05-07 Thread John W. Shipman
As much as I love XSLT (half-kidding here), I have several applications to generate PDFs from databases, and from other sources that XSLT can't reach directly. Since I discovered SQLAlchemy (http://www.sqlalchemy.org), life is much nicer: In Python, I can pull data from SQL databases without

Re: [docbook-apps] Indexing.

2012-05-06 Thread John W. Shipman
I've indexed three 500-page books, but never in DocBook. However, I'd like to reinforce Thomas Schraitle's point that it is both important and nontrivial. The first thing I'd recommend is to read up on indexing. The Wikipedia page is a good starting point.

Re: [docbook-apps] How to remove extra newline in programlisting

2010-10-13 Thread John W. Shipman
On Wed, 13 Oct 2010, Jason Gilmore wrote: +-- | I am however running into a strange issue involving programlisting | elements in which the enclosed text is delimited by ![CDATA[...]]. | When I convert from Docbook to PDF using oXygen (using the Saxon 6.5 | transformer), my program listing's

Re: [docbook-apps] Docbook for industrial usage

2010-09-07 Thread John W. Shipman
+-- | Hi, yesterday I talked with Camille on IRC about getting | docbook used more in industry. I am searching for companies | that already use it and that could give a good example about | what they do with docbook and why they use it. And I also got | one first contact I am going to write to.

Re: [docbook-apps] Compact DocBook ?

2010-07-12 Thread John W. Shipman
+-- | I'm hoping to embed DocBook within some Java code (as | comments). Along with some support utilities, this should | allow embedding of documentation next to the code it describes. | This is somewhat similar to JavaDoc, but: | | a. using DocBook vocabulary, | | b. to be included

Re: [docbook-apps] DocBook Customization -- Subsets

2009-06-04 Thread John W. Shipman
+-- | We've looked at the simplified version of DocBook and it's TOO simple. | We have a couple of examples of local style manuals (thank you!). If | anyone else wants to share their tag subsets, that would be gratefully | received. We appreciate the goal of reducing complexity and |

Re: [docbook-apps] documenting code

2009-01-05 Thread John W. Shipman
+-- Dave Pawson: | Yet again, quote | | A small Python script extracts one or more source files from | the document, and these are the executable form of the program. | /quote | | That seems wrong John? +-- What exactly is wrong with that? I have a Makefile set up so I type: make code

Re: [docbook-apps] documenting code

2009-01-05 Thread John W. Shipman
On Mon, 5 Jan 2009, Dave Pawson wrote: +-- | I've seen Norm using docbook to tangle and weave XML. | I'm wondering how well docbook would work for code? +-- Been doing it for years. Have a look at: http://www.nmt.edu/~shipman/soft/litprog/ This pages has links to lots of Python examples,

Re: [docbook-apps] suppressing table captions

2008-02-22 Thread John W. Shipman
Is there some reason you can't use informaltable? It has the same content model as table, except no caption element. Best regards, John Shipman ([EMAIL PROTECTED]), Applications Specialist, NM Tech Computer Center, Speare 119, Socorro, NM 87801, (505) 835-5950, http://www.nmt.edu/~john

Re: [docbook-apps] Tools for generating Docbook programlisting fragments?

2007-08-25 Thread John W. Shipman
On Sat, 25 Aug 2007, Tommy Nordgren wrote: +-- | Do anyone know of a library for generating DocBook | programlisting fragments from source code listings marked up | with special comments. The purpose is to generate the Docbook | source and program language source, from a common | specification.

Re: [docbook-apps] Tools for generating Docbook programlisting fragments?

2007-08-25 Thread John W. Shipman
Oops, I made a cut and paste error! The fragment should be: +-- | para | This next section...blah blah blah | /para | programlisting role='outFile:myscript.py' | Line 1 | Line 2 | Line 3 | /programlisting | para | Etc. | /para +-- John Shipman ([EMAIL

[docbook-apps] TeX math in DocBook

2007-06-01 Thread John W. Shipman
On Thu, 10 May 2007, Stefano Sabatini wrote: +-- | Stefano Sabatini [EMAIL PROTECTED] wrote on Wed, 9 May | 2007 11:38:19 +0200: | | I would like to avoid to use MathML, due to its need for a graphical | editor, so using the compact tex notation +-- I've been trying for some time to find a way