man/XML

SigmaX asdf fydernix at gmail.com
Wed Aug 30 07:57:26 UTC 2006


I discovered the following project availability on
http://fedoraproject.org/wiki/FedoraBounties (I'm not expecting an
official "bounty," just for the record):

> Publication of all man and info pages for each release
> We would like to have every man and info page for each release of Fedora Core and Extras to be available via a simple Web interface,
>
> One option would be a directory full of formatted ASCII files. Another would be a simple search interface or contents listing, with the directory on the back-end.
>
> One objective is to be able to browse manual pages of various releases.
>
> Another goal is to have permanent URIs for documentation and reference.
>
> Having a simple Web-based diff tool to see what was added/subtracted across versions would be cool too.
>
> This could be a relative or a tie-in to DocsRawhide. The man and info pages for Fedora rawhide could be made available through this method.
>
> In the future, I'd like to see this format extended to allow a Wiki-like ability to edit the man pages directly.
>
> See bug #179524:  https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=179524
>
> Contact: KarstenWade
>

Upon contacting Karsten Wade I was told:

> Community members have been asking for "all the system documentation"
> available online, outside of the actual install itself.
>
> I don't know of the man and info pages are translated, but by converting
> them to XML, we can make them available for the community to translate.
>
> There has been a project proposed to the Linux Doc Project for a while
> to convert man pages to XML, so this could be part of that idea, if we
> wanted to carry it that far.
>
> ...We'd be looking for something
> clever and automated; someone from the release team or docs team would
> "press a button" (run a script), a tree of RPM packages would be
> checked, and all the documentation extracted and converted into XML.
> Anyway, that's just a first pass at an idea.

So.  Here I am.  I admit a degree of ignorance, but claim spirit to
learn and take a shot at a solution.

First off: Is there already an XML template, or something related (ex.
used in the translation project), which I should refer to in order to
be sure things are done in Fedora style?

Besides that I'm ready to start tinkering with it, in between my full
class load and 23 work hours a week :-S.

Cheerio,
  SigmaX




More information about the fedora-docs-list mailing list