[OSGeo-Edu] Re: [Live-demo] Creating OSgeo training material as part of the OSGeo Live DVD

[Stefan Steiniger]

Hei,

i) what concerns the "one"-page description for the LiveDVD. I can do 
that for OpenJUMP if someone sends me a template (there is one?).

ii) OpenOffice is a good start. Another option may be ELML (E-Learning 
Markup Language, www.elml.ch). The stuff is written with XML and then it 
can be export to html and PDF if CSS styling templates are defined. As 
it is XML it can be handled as well pretty nicely with CVS/SVN - i.e. 
collaborative development/versioning.

Two examples of ELML-based generated e-learning material are for 
instance this GITTA lesson on suitabilty analysis:
http://gitta.info/Suitabilityi/en/html/index.html

and this Cartouche lesson on location based services:
http://www.e-cartouche.ch/content_reg/cartouche/LBSbasics/en/html/index.html 


though... working with ELML requires a small learning phase to get to 
know the tags and setting up a system [e.g. xml editor in Eclipse]  (not 
sure how far the firedocs editor works now)

stefan

Cameron Shorter schrieb:
> Alex Mandel wrote:
>> On 04/03/2010 03:52 AM, Frans Thamura wrote:
>>  
>>> can the material also online @ osgeo.org
>>>
>>> F
>>>     
>>
>> Of course they should be. I think this might highlight a slight
>> difference in how I'm thinking about the documentation. I was thinking a
>> one page short description of each project would be in html for the
>> live-dvd and the more detailed documentation written by the community
>> would be pdf generated from OpenOffice or whatever other format
>> educators are writing in and store in the educational inventory.
>>
>> This keeps the creation and management of in depth tutorials out of the
>> the Live DVD builders hands and ensures the documents are in a more
>> general repository like the educational inventory. At build time we can
>> download and link the relevant tutorials into the html docs structure of
>> the live-dvd.
>>
>> At least that's my idea on how to handle the issue.
>>
>> Thanks,
>> Alex
>>   
> 
> Alex,
> I'm happy to move some or all of the creation of documentation outside 
> the LiveDVD project, maybe in a sister project as part of the education 
> committee or similar.
> But I do want to see this material getting developed, and I think us 
> LiveDVD packages have a formula that we can share in order to faciliate 
> the creating of docs.
> 
> I probably should mention that I've been thinking about generating 
> documentation from many sources for many years, and have even written a 
> documentation generation framework [1] which aggregates documentation 
> from numerous sources into one deliverable. It used the Docbook XML 
> format, which has since lost favour, and was limited because images 
> can't be imbedded in the document.
> However, the scripts are xml based, and I understand that the OpenOffice 
> format is XML based, so there is a good chance we can resurect this 
> project for our documentation generation process:
> 
> [1] http://generguide.sourceforge.net/
>