[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]

Re: User Guide status?

On Tue, Jan 06, 2009 at 12:44:41PM -0500, Betty Harvey wrote:
> As of Friday, I have converted the available pieces of the Users Guide to
> Docbook XML.  I don't know where to upload the files so I still have them.

In coordination with the rest of the User Guide team, you want to
upload them to the git repository.

To start, install git:

  sudo yum install git

Then, clone the repository:

  git clone ssh://<username>@git.fedorahosted.org/git/docs/userguide.git

The repository is entirely blank, save for an initiating file (I

From there you want to install Publican, create a blank book, put that
in the repository, and then start adding your XML files.

  cd userguide/
  sudo yum install publican
  create_book --name=User_Guide --brand=fedora --lang=en-US --type=Book
  cp /path/to/converted/*.xml User_Guide/en-US/

Using Publican is covered in the Publican guide:


Using git, there are a number of good tutorials.  You can start here:


> I created a PDF of the users guide and sent a copy out to the group on
> Friday (or Saturday).
> When other pieces are completed I will convert those as well.  The
> conversion process is pretty smooth now - only occasional minor
> tweaks.

Similarly to the XML, we want to get working code, configurations, and
usage READMEs in to the 'fedora-doc-utils' repository:


That way other people can do the conversions, etc.

> I used the standard Docbook XSLT's to create the PDF - it would probably
> be worthwhile to run the file through Publican (I don't know where a
> copy of that stylesheet resides).

  rpm -ql publican|grep xsl

- Karsten
Karsten 'quaid' Wade, Community Gardener

Attachment: pgpu2VvLQyADh.pgp
Description: PGP signature

[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]