Newbie tutorial anywhere?

Post by **Djelibeybi** » Tue May 04, 2004 9:47 am

Hi guys,

I've been meaning to get into learning about DocBook for a while and I finally have a project that requires it. However, I'm finding it quite tough starting out. All the options are quite overwhelming, and I seem to be getting lost a lot.

Does anyone know of a good beginners tutorial for starting out with DocBook and some help creating transformations (e.g. into PDF or multi-page HTML?)

Many thanks!

Post by **Dan** » Wed May 05, 2004 5:21 pm

In the Articles section you may find a short tutorial about using Oxygen for generating PDF from Docbook documents:

http://www.oxygenxml.com/doc/HowToCreat ... Oxygen.pdf

A general docbook tutorial is:

http://opensource.bureau-cornavin.com/crash-course/

Post by **Djelibeybi** » Thu May 06, 2004 1:04 am

Thanks Dan. That's just what I was looking for.

Post by **Djelibeybi** » Thu May 06, 2004 4:08 am

Two more (real newbie) questions:

1. When I transform my XML, I get a whole bunch of Ã‚ characters in the HTML output and I can't understand why.

2. I have given my chapters id= attributes but the individual chapter HTML files are still being named ch01.html, etc.

Post by **Dan** » Thu May 06, 2004 10:03 am

1. I cannot explain the strange characters. In what context they appear? In front of some list items?

2. You can set this parameter to 1:
use.id.as.filename

For more info, see:

http://www.sagehill.net/docbookxsl/HtmlOutput.html

Post by **Djelibeybi** » Thu May 06, 2004 10:18 am

Thanks for that link -- very useful! I seem to have fixed the strange character bug by using the HTML XSL instead of the XHTML one. I'll look into that one more a little later.

Post by **george** » Thu May 06, 2004 7:35 pm

Hi,

Djelibeybi wrote:I seem to have fixed the strange character bug by using the HTML XSL instead of the XHTML one. I'll look into that one more a little later.

This seems to be an encoding related problem. Try setting your browser encoding to Unicode (UTF-8) and the document should be rendered correctly.

Best Regards,
George

Post by **Djelibeybi** » Fri May 07, 2004 1:47 am

Thanks George. I figured it had to be something like that, but I didn't really have the time for all the necessary testing. I'm now trying to convince the boss to replace our manuals with DocBooks, so I have a different battle on my hands.

Post by **goa103** » Sat Nov 06, 2004 2:42 pm

Hi,

Djelibeybi wrote:Thanks George. I figured it had to be something like that, but I didn't really have the time for all the necessary testing. I'm now trying to convince the boss to replace our manuals with DocBooks, so I have a different battle on my hands.

My advice would be to write the new ones using DocBook, not to replace the old one. For example I used to write my docs using Microsoft Office XP, then I switched to OpenOffice.org, now I'm more interested by DocBook to write user guides and manuals... But I never thought about rewriting all my Microsoft Office XP documents

. I simply converted them to OpenOffice.org documents, now I can even convert them to DocBook documents, because OpenOffice.org documents are just plain XML documents, so you can edit them using oXygen

.

JM