I started a small project to simplify some of the metadata conversion process from our old-style, FDP toolchain-created docs into Publican:
http://pfrields.fedorapeople.org/projects/rpminfo-to-publican/
It's not a code repository, just a script and some XSL stylesheets I prepared. It's far from bulletproof (maybe a little tetchy, actually), so patches gratefully accepted.
The procedure:
1. Create a bare-bones Publican doc of the type you want, preferably matching the original (book, article, or set), with brand "fedora" and a name like "This_Guide_Name".
2. cd This_Guide_Name tar xzf /path/to/rpminfo-to-publican.tar.gz sh rpminfo-to-publican.sh /path/to/rpm-info.xml
3. Add YEAR and HOLDER entities to <LANG>/This_Guide_Name.ent as usual.
The XSL stylesheets properly import names of authors, revision history, and other document metadata to the appropriate files, and backup the old ones in an 'orig/' folder. You should run this procedure *before* you put additional data in these files.
On Sat, Jan 03, 2009 at 05:42:07PM -0500, Paul W. Frields wrote:
I started a small project to simplify some of the metadata conversion process from our old-style, FDP toolchain-created docs into Publican:
Thanks! I hadn't gotten this far with the Installation Guide, so this is well timed.
If anyone wants to do what Paul describes, the branch 'f11-publican-conversion' is in the fedorahosted.org/install-guide git repository. You don't need to have project access, you can do it with git-clone and git for patching.
- Karsten
On Sat, 2009-01-03 at 15:15 -0800, Karsten Wade wrote:
Thanks! I hadn't gotten this far with the Installation Guide, so this is well timed.
If anyone wants to do what Paul describes, the branch 'f11-publican-conversion' is in the fedorahosted.org/install-guide git repository. You don't need to have project access, you can do it with git-clone and git for patching.
- Karsten
Karsten,
I'm not too familiar with what's covered by rpm-info - would this relate at all to the man page coverage mini-project?
On Sun, Jan 04, 2009 at 06:34:59AM +0200, Basil Mohamed Gohar wrote:
On Sat, 2009-01-03 at 15:15 -0800, Karsten Wade wrote:
Thanks! I hadn't gotten this far with the Installation Guide, so this is well timed.
If anyone wants to do what Paul describes, the branch 'f11-publican-conversion' is in the fedorahosted.org/install-guide git repository. You don't need to have project access, you can do it with git-clone and git for patching.
- Karsten
Karsten,
I'm not too familiar with what's covered by rpm-info - would this relate at all to the man page coverage mini-project?
Not as far as I can tell.
The rpm-info.xml document is a metadata container we use in our legacy FDP toolchain. It holds information that is transformed for use in turning our DocBook XML documents into HTML, PDF, RPM, etc. Publican has mostly the same functionality but a completely different way of storing information, so I created this conversion stuff to help people who are moving documents from one to the other.
docs@lists.stg.fedoraproject.org
-
Basil Mohamed Gohar -
Karsten Wade -
Paul W. Frields