[publican-list] I'm quite lost...

[Misty Stanley-Jones]

Hi Chris,

First of all, thank you for volunteering!

Second, here are some good resources to get you started with Publican and Docbook:

Publican User Guide - http://rlandmann.fedorapeople.org/pug/ - This will guide you through installing Publican on your computer and starting to write Docbook. It includes some basic information about syntax, to get you started.

Docbook reference - http://www.docbook.org/tdg/en/html/ref-elements.html - I have linked you directly to the list of Docbook elements. You can click each element and see examples and usage guidelines. You can back out to read the entire book if you like, but you don't really need to read it to get started.

One of the first decisions to make is which editor to use. Since Docbook uses structured XML, you can use any text editor. Some of them offer extra features to make things go faster. I use Emacs to edit Docbook, but I am in the extreme minority. Most of my colleagues seem to use GEdit, kwrite, Kate, Jedit, or Geany. There are also some open source GUI editors, such as Serna (http://www.syntext.com/products/serna-free/), if that is your kind of thing.

This is definitely the right place to ask, so if you have more questions, please ask away!

Thanks,
Misty


----- Original Message -----
> From: "Chris Sederqvist" <c.sederqvist at gmail.com>
> To: publican-list at redhat.com
> Sent: Wednesday, August 3, 2011 2:49:55 AM
> Subject: [publican-list] I'm quite lost...
> Hello.
> 
> I've volunteered to write for fedora-docs, but I have no idea as in
> how
> to use the tools to actually produce the documentation!
> I understand that I must learn some Docbook, but what version, what
> parts and how much of it?
> Then it is the Publican tool. Does anybody know of a good screencast
> or
> something to get me going with this tool?
> 
> This might not be the right place to post this. If not, please guide
> me
> to the correct place.
> 
> All the best
> 
> Chris
> 
> _______________________________________________
> publican-list mailing list
> publican-list at redhat.com
> https://www.redhat.com/mailman/listinfo/publican-list
> Wiki: https://fedorahosted.org/publican

-- 


Misty Stanley-Jones, RHCE 
Content Author, ECS Brisbane 
☺: misty (Freenode IRC) ✉: misty at redhat.com