[Live-demo] Re: contributor and translator files

Cameron Shorter cameron.shorter at gmail.com
Tue Sep 21 19:04:04 EDT 2010


Thanks Jorge, that csv table directive makes things much easier.
I'll create a Makefile rule which builds the rst from csv along with 
some sed magic.

Hamish, I should be able to address all concerns noted, and I should be 
able to work this out without tapping into your programming expertise.

On 21/09/10 22:25, Jorge Gaspar Sanz Salinas wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> El 21/09/10 14:20, Cameron Shorter escribió:
>    
>> As Hamish has picked up, I've now moved contributors and translators
>> into rst format, which is not included into the {lang}/sponsors.rst wiki
>> page.
>>
>> Hamish, I did consider keeping files as csv and creating rst as you
>> suggest, but decided against it because:
>>
>> 1. I think our only target for our translators and contributors is for
>> our documentation.
>>
>> 2. It makes creating the target documentation very easy, and we can run
>> rst build using "make html" and not bin/install_main_docs.sh, which
>> makes it easier for translators. I'm actually hoping that we will be
>> able to have translators create their translations on windows computers
>> if they so desire.
>>
>> 3. Creating rst tables from csv is not as simple as I expected, as you
>> need to get each cell in a column to have the same number of chars. (so
>> you can't simply do: s/,/|/ )
>>
>> If you feel really strongly about this, and want to write such a script
>> instead, then go ahead.
>>
>> On 21/09/10 22:04, Hamish wrote:
>>      
>>>> please keep contributor and translator files as .csv so they are easy
>>>> to parse.
>>>>
>>>>          
>>> (write a script to automatically create .rst sources at build time if you
>>> like, but preserve originals. no need to push through emails and osgeo
>>> ids
>>> to the reST version)
>>>
>>>
>>> thanks,
>>> Hamish
>>>
>>> _______________________________________________
>>> Live-demo mailing list
>>> Live-demo at lists.osgeo.org
>>> http://lists.osgeo.org/mailman/listinfo/live-demo
>>> http://wiki.osgeo.org/wiki/Live_GIS_Disc
>>>
>>>        
>>
>>      
> Cameron, you can create tables in rst using CSV-like syntax
>
> Check: http://docutils.sourceforge.net/docs/ref/rst/directives.html#id1
>
> Example from above link:
>
> .. csv-table:: Frozen Delights!
>     :header: "Treat", "Quantity", "Description"
>     :widths: 15, 10, 30
>
>     "Albatross", 2.99, "On a stick!"
>     "Crunchy Frog", 1.49, "If we took the bones out"
>     "Gannet Ripple", 1.99, "On a stick!"
>
> Best
>
>
> - -- 
> Jorge Gaspar Sanz Salinas
> Ingeniero en Geodesia y Cartografía
> http://es.osgeo.org
> http://jorgesanz.net
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.4.10 (GNU/Linux)
> Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/
>
> iQEcBAEBAgAGBQJMmKQxAAoJEAOYD75lvHdBi5YIAKtThBrkpxfWF+d9L0XNpCWL
> 9mpANqVH72cnwtzziBCgOpUiqNDgOopj3BJTCLim9vmsJbwGiReE3aHUGsXXkDYT
> crwC85wb2YCOyM7gS8N7iyiA3kDac24H4l6yXgEcfUhKuY+JVWvxs/R0/QOJ37Gk
> JeK/cMocPfncngeVWzQKiyAFbhR99oy8Zij9K+81bdhi5YUwStLVSR8U1bZV63bV
> Xv2p/Nl6kf2nauVWW1xB1mF7012xbVChQT6ME1k7LN9AuL3PaTzYBxaeYdzgW/si
> dwrxqXF0L1fy/eBjjj3LkC8aEOpPkVcj+IP7ItP10wd36nsIfY2hF+kWk7/QnF4=
> =pR3k
> -----END PGP SIGNATURE-----
> _______________________________________________
> Live-demo mailing list
> Live-demo at lists.osgeo.org
> http://lists.osgeo.org/mailman/listinfo/live-demo
> http://wiki.osgeo.org/wiki/Live_GIS_Disc
>    


-- 
Cameron Shorter
Geospatial Solutions Manager
Tel: +61 (0)2 8570 5050
Mob: +61 (0)419 142 254

Think Globally, Fix Locally
Geospatial Solutions enhanced with Open Standards and Open Source
http://www.lisasoft.com



More information about the Live-demo mailing list