We need our own automatic converter from docbook XML to dartlang.org HTML

[nicolasgarnier]

From [email protected] on November 01, 2012 17:19:14

We need our own XML -> HTML converter. O'Reilly's converter is pretty good, but I had to do a bunch of hand tweaking, and I didn't catch everything (as evinced by dartbug.com/5986).

Original issue: http://code.google.com/p/dart/issues/detail?id=6462

[nicolasgarnier]

From [email protected] on November 01, 2012 09:20:33

Blocking: dart:5986

[nicolasgarnier]

From [email protected] on December 19, 2012 12:44:43

Issue 5986 has been merged into this issue.

[nicolasgarnier]

From [email protected] on December 19, 2012 12:45:05

Status: Started
Labels: Milestone-M3

[nicolasgarnier]

From [email protected] on December 19, 2012 13:41:54

xsltproc --xinclude --stringparam base.dir htmlout/ --stringparam use.id.as.filename 1 ~/Downloads/docbook-xsl-1.78.0/html/chunkfast.xsl book.xml

[nicolasgarnier]

From [email protected] on December 19, 2012 14:24:35

Nice! Some tweaks:

• Would it be possible to get chapter 4 into separate pieces (one per tool) but leave the existing chapters as-is?
• Delete the colophon (last section).
• The HTML is very dense. Could you get it to have more newlines, at least between block tags. 80-character line length would be nice.

[nicolasgarnier]

From [email protected] on December 19, 2012 14:35:27

Thanks Kathy.

1. yes, easy
2. I will try, not sure how. is this a blocker?
3. assume I will apply our site style to it :)

[nicolasgarnier]

From [email protected] on December 19, 2012 14:41:23

Hi Kathy,

For #2, can you add a above the for pub? The default behavior is to keep the first inside the chapter's HTML page. If you can do this, the following will become their own HTML files.

[nicolasgarnier]

From [email protected] on December 19, 2012 17:03:36

The latest looks good! As for the colophon, no it's not essential to get rid of it, but since it's empty I don't know why it's even showing up.

[nicolasgarnier]

From [email protected] on December 20, 2012 12:02:33

The colophon is showing up because it's in the book.xml file. I don't know how to remove it and keep o'reilly happy. Unless we add some post processing.

[nicolasgarnier]

From [email protected] on December 20, 2012 12:18:40

Here is the new conversion command, which does put pub (the first section) into its own HTML page:

xsltproc --xinclude --stringparam base.dir htmlout/ --stringparam use.id.as.filename 1 --stringparam chunk.first.sections 1 ~/Downloads/docbook-xsl-1.78.0/html/chunkfast.xsl book.xml

[nicolasgarnier]

From [email protected] on December 20, 2012 19:38:28

Hi Kathy,

Can you please take a look? http://book-conversion.dart-lang.appspot.com/docs/newbook/

[nicolasgarnier]

From [email protected] on December 20, 2012 19:39:01

Oh, I know the images don't work. :) they just aren't in the right place.

[nicolasgarnier]

From [email protected] on January 03, 2013 10:34:39

Status: Fixed