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

man/XML



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


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