[OSGeo-Edu] Guidelines/Template for OSGeo HTML Documentation

[Helena Mitasova]

On Jul 7, 2008, at 6:41 PM, Landon Blake wrote:

> This topic deals with the preparation of educational material, but  
> I thought that it might be related to the work of the Marketing  
> Committee, and eventually the OSGeo Journal, so I added this  
> message to all three (3) lists.
>
> I’d like to start work soon on a simple converter that moves OSGeo  
> educational material from Docbook to HTML. I’d specifically like to  
> start testing a documentation tool chain with this converter for  
> the English Free GIS Book and the Starter Dictionary.
>
> I imagined using two (2) CSS files for the output HTML  
> documentation. One could be used for online viewing, and one for  
> hardcopy printing.

I think this is a good idea. It is what we have ended up using for  
the NCSU GIS program (at least for now).
> I’m fairly handy with CSS and HTML, but I was hoping to get some  
> direction for the creation of the style sheets. Do we have an OSGeo  
> color scheme somewhere? Does the OSGeo have a preferred font family  
> for online documentation?
>
> (I know that I can get a logo from here: http://www.osgeo.org/logos)
>
> Should I make the stylesheets follow the color palettes contained  
> in this document?: http://download.osgeo.org/osgeo/logos/ 
> OSGeo_logo_guide.pdf

I suggest yes.
> Even if I use those color palettes, I’ll likely need to add some  
> colors for things like visited and unvisited hyperlinks.
> I thought it would be good to set my style sheets up so they could  
> be used in other OSGeo online documentation, and especially for  
> other projects coming from the education committee. It would also  
> be great to see the same style sheets used for online versions of  
> OSGeo Journal articles, if we ever get around to building a web  
> presence for the Journal.
>
>
>
> I’m not too fussy about things like colors and fonts. I just want  
> to set the style sheets up to use what everyone else is using.
it would be nice if we have a graphic designer or at least somebody  
with graphics background help
out to give the documents a professional look and feel.

Helena
>
>
> I appreciate any comments or suggestions on this topic.
>
>
>
> Landon
>
>
>
>
>
>
>
> Warning:
> Information provided via electronic media is not guaranteed against  
> defects including translation and transmission errors. If the  
> reader is not the intended recipient, you are hereby notified that  
> any dissemination, distribution or copying of this communication is  
> strictly prohibited.  If you have received this information in  
> error, please notify the sender immediately.
> _______________________________________________
> Edu_discuss mailing list
> Edu_discuss at lists.osgeo.org
> http://lists.osgeo.org/mailman/listinfo/edu_discuss