rpm-info to publican conversion

[Paul W. Frields]

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.

-- 
Paul W. Frields                                http://paul.frields.org/
  gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233  5906 ACDB C937 BD11 3717
  http://redhat.com/   -  -  -  -   http://pfrields.fedorapeople.org/
  irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug

[Karsten Wade]

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
-- 
Karsten 'quaid' Wade, Community Gardener
http://quaid.fedorapeople.org
AD0E0C41

[Basil Mohamed Gohar]

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?

[Paul W. Frields]

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.

-- 
Paul W. Frields                                http://paul.frields.org/
  gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233  5906 ACDB C937 BD11 3717
  http://redhat.com/   -  -  -  -   http://pfrields.fedorapeople.org/
  irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug