MediaPortal manual (1 Viewer)

[Anonymous]

Very cool. May I suggest :
- using XML (DocBook ?) or HTML as the source format
- issuing this documentation under the GNU FDL license

Thanks to the authors!

 

[Anonymous]

Hi Epoch,
At the present time the documentation is being distributed in PDF format, for regional reasons. It was created with A4 LTR size, then converted to US LTR, and then formatting got unwieldy. So for now, it is being created in OpenOffice [.swx], converted to PDF for present distribution, then later an A4 Ltr will probably be produced. Other formats are fine, but too much maintenance at the moment. Once MP is finalized, and a finished document is produced, then we may consider alternative formats.
I guess we just have too much time on our hands! :wink:

 

[Mr.Mitchell]

Actually XML/Docbook sounds like a good idea. That way more people can work on the manual at the same time (if it is in CVS) and if I am not mistaken you can generate documentation in all kinds of formats like PDF for easy printing or HTML to put the documentation online.

 

[Anonymous]

Thanks for your interest. Let me rephrase to make my intentions clearer :
a) 1st thing 1st: I think there is need for a licensing scheme that goes well w/ GPL to allow translators (and plugin authors, and....) contributing to the documentation.
b) Opening the doc requires :
- an open format, like HTML or XML to warrant easy access
- a strong structure to make a homogeneous final document from the input of a variety of contributors
c) The final output should be generated from the structured data, hopefully using proven tools. I personnaly like Pdf. I am sure others will want HTML, or RTF...

Hence my Docbook proposal : an XML scheme backed with good document generators (don't know the status on windows).

I could try looking into this if you'd like. I would need the OO source to play with it. Is it in the CVS tree ? Or could you post it on the website ?

Thx in advance.