write on the train?

Karsten 'quaid' Wade kwade at redhat.com
Tue Apr 29 06:12:34 UTC 2008


An answer for a question from IRC:

18:18 < subdivisions> hey all... anyone here know the best way to do editing/authoring
                      offline?  I have approx 2.5 hours a day on the train and I can't
                      really get a cell signal.
18:18 < subdivisions> I can cut-andpaste from and back to the wiwki, but that seems a bit
                      crude.

Keith, let me introduce you to DocBook XML.

http://fedoraproject.org/wiki/DocsProject/Tools#DocBook_XML
http://fedoraproject.org/wiki/DocsProject/WorkFlow#Wiki_to_DocBook_XML

What you need for the train is the following:

* Checkout one or more guides to work on:
  Installation Guide
  Software Management Guide
  Security Guide (needs conversion)
  or ...
* Obtain XML output from the wiki ready for conversion
* Check out the build system/toolchain for Fedora Docs, and/or
* Install 'publican' (candidate for inclusion in toolchain)
* Optional virtualization instance to do install testing or other
technical edits/writing

You have everything you need in a Fedora install with the "Authoring and
Publishing" group installed.

While you are offline, keep notes about any troubles you have.  Maybe
write them as a blog entry to post when you get to your destination.
Writing about your learning process and experience as a new contributor
could bring some value and definitely interest.

Just a few ideas off the top of my head. :)

- Karsten
-- 
Karsten Wade, Sr. Developer Community Mgr.
Dev Fu : http://developer.redhatmagazine.com
Fedora : http://quaid.fedorapeople.org
gpg key : AD0E0C41
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
URL: <http://listman.redhat.com/archives/fedora-docs-list/attachments/20080428/0add7902/attachment.sig>


More information about the fedora-docs-list mailing list