Showing posts with label DocBook XSL. Show all posts
Showing posts with label DocBook XSL. Show all posts

Wednesday, July 7, 2010

creating my 1st DocBook Website web-sites

I have the DocBook XSL book in front of me (opened at "Chapter 31. Website"), asking myself and the world (irc://irc.freenode.net#docbook) silly questions, like the ones, you can find as my recent articles on this blog.

I want to change a couple of pretty raw vanilla DocBook web sites to pretty raw but neat vanilla DocBook Website web sites during the next couple of hours. There is other work to complete pretty soon, so I rather complete this thing now.

I am using docbook-website-2.6.0/example from Sourceforge (look around here!! ((FIXME))) (of course as example-JH-0, so I can always diff to the origin).
Their Makefile-example.txt is now my Makefile, I just had to adapt DOCBOOK_WEBSITE and XSLT:
  • DOCBOOK_WEBSITE=/usr/local/docbook-website-2.6.0
  • XSLT=xsltproc
...
Try this:
$ make clean
$ make realclean
$ make depends
$ make

...

Update / 2010-07-14:
I have made pretty good progress during the last couple of days.
I converted a couple of plain DocBook web-sites (HTML!!) to DocBook Website, and I rather sense some satisfaction there. You can find those web-sites right here in the right column listed as my most exciting web-sites. Sorry for the bragging, but the Website guys did a rather good job, so even me cannot spoil that a lot.
Right, and a web-designer mate of mine will show up on Friday, and we are going to discuss the replacement logos for all the NDW-logos around there. And a very big "thank you!!!" here to Norman for all his good work!!!

DocBook Website - where to get the Relax-NG schema from?

I found it at SourceForge.
I really love editing XML in Emacs's nxml-mode. I did mention that at my DocBook Wiki home page already.

DocBook XSL, the book - where can I download the samples from?

I have a copy of that book (paper so far), and I am tempted to use certain smples. Other publishers supply you with TAR balls, that you can download from their web-sites, so that you can play with the samples. I didn't find that mentioned in that book, but to be honest with you: I haven't yet read this book all through, I rather assume I will only look up certain things occasionally, and actually this is just my "thank you!" to Bob Stayton, the brave DocBook warrior.

Looks like you can only copy+paste the code from the PDF (purchase it!)  or from the free HTML.

Tuesday, July 6, 2010

DocBook XSL, the book – incorrect IRC channel

DocBook XSL: The Complete Guide - 4th Edition, Chapter 1. Introduction,  Online resources for finding solutions to problems (the paper book and the online version as well) says, that the IRC channel of DocBook would be at irc://irc.openprojects.net#docbook, but it actually is at irc://irc.freenode.net#docbook.

http://www.docbook.org/help had the right information.

This is not on their Errata yet, and I told webmaster(AT)sagehill.net about this problem in the meantime. I only wondered for a very, very short time, whether anybody will ever come back to me.
Bob Stayton (himself) answered at 2010-07-06 22:12:18 (my time at Berlin, ie. only an hour or so later):

Apparently it changed since that was written.
I'll put the new address in the next edition and add to the Errata.
Thanks for the report.

As I said, I will update this here, once I will notice their update.