trinity-devel@lists.pearsoncomputing.net

Message: previous - next
Month: November 2011

Re: [trinity-devel] Trinity User's Guide

From: "Timothy Pearson" <kb9vqf@...>
Date: Thu, 17 Nov 2011 11:30:36 -0600
> On Thursday 17 November 2011 12:17:00 pm Timothy Pearson wrote:
>> Overruled. :-)  The consensus here (which I agree with) is that no
>> markup
>> languages are needed or desired.  This documentation could potentially
>> grow to the size of a small book--can you seriously even imagine trying
>> to
>> edit that for clarity, let along grammatical errors, without a word
>> processor?  There is a right tool for the job, along with a bunch of
>> wrong, but workable, tools.  Let's use the right one!
>>
>> We will use the flat ODT format in GIT.  I will work on getting
>> automatic
>> builds both to "real" document formats (PDF, PostScript) and to HTML.
>> Help is welcome here; basically I just need the command line to pass to
>> LibreOffice to make it spit out such documents, especially on the HTML
>> end.
>
> As long as there's public read access on the web site, that shouldn't be a
> problem. There was a comment earlier that people won't want to learn (or
> won't understand) version control, so making it downloadable in a browser
> without a "git clone" is desirable. If that's possible, I'm all for using
> git
> for the manuals.
>

Quite easily done.  Example:
http://git.trinitydesktop.org/cgit/tde-packaging/tree/README.GIT

Tim