Re: [Qgis-community-team] tex to rst conversion

2012/4/16 Otto Dassau <[hidden email]>:
> Hi Yves,
>
> is there a list of tex files that still have to be converted to rst? I would
> like to get some more practice :), but don't want to duplicate work.
>

Hi guys
one think that we should seriously consider, it is to write down (to
include in the readme.rst file), and
actually apply, some guidelines for the rst style we are using.
I would suggest to follow the rules that have been used for writing
the Python documentation, that are at some extent, specially for
sections, described here [1].
what do you think?
ciao
p

Re: [Qgis-community-team] tex to rst conversion

> 2012/4/16 Otto Dassau <[hidden email]>:
> > Hi Yves,
> >
> > is there a list of tex files that still have to be converted to rst? I
> > would like to get some more practice :), but don't want to duplicate
> > work.
> >
>
> Hi guys
> one think that we should seriously consider, it is to write down (to
> include in the readme.rst file), and
> actually apply, some guidelines for the rst style we are using.
> I would suggest to follow the rules that have been used for writing
> the Python documentation, that are at some extent, specially for
> sections, described here [1].
> what do you think?
> ciao
> p
>
> [1] http://sphinx.pocoo.org/rest.html

Hi,

yes, that would be a god idea. Can someone start a current list, maybe
Yves, because you have the best overview about the work done, I guess?

Re: [Qgis-community-team] tex to rst conversion

Le 16/04/2012 16:08, Otto Dassau a écrit :
> Hi Yves,
>
> is there a list of tex files that still have to be converted to rst? I would
> like to get some more practice :), but don't want to duplicate work.
>
> Regards
> Otto

I've created this page to ease the repartition of the work, these file
have been converted with latex2rst.py or pandoc and still need a lot of
work :

Re: [Qgis-community-team] tex to rst conversion

> 2012/4/16 Otto Dassau <[hidden email]>:
>> Hi Yves,
>>
>> is there a list of tex files that still have to be converted to rst? I would
>> like to get some more practice :), but don't want to duplicate work.
>>
>
> Hi guys
> one think that we should seriously consider, it is to write down (to
> include in the readme.rst file), and
> actually apply, some guidelines for the rst style we are using.
> I would suggest to follow the rules that have been used for writing
> the Python documentation, that are at some extent, specially for
> sections, described here [1].
> what do you think?
> ciao

Hi Yves
now that more and more people seems impacted in the tex to rst
migration process, we should really consider updating the
documentation style guide [1].
Are you ok, as suggested in previous email, to proceed with the Python
documentation style guide [2]?
Can I update [1] with a very evident link to [2] (and you upgrade your
export script for taking care of [2])?
Let me know
p

Re: [Qgis-community-team] tex to rst conversion

I would like to help with this task also. If I understand correctly it is a case of tidying up the .rst files which have been generated from tex by a converter program. I will put my name down on the wiki page against one or two files, but first could somebody post details of how to download the rst files from the repository (server name, user access details).

> Hi all,
>
> seems some tags are missed from list [0], for example in print composer
> section there are several
>
> \dropmenuopttwo{mActionNewComposer}{New Print Composer}
>
> for which there is no RST equivalent. What should I do with this?
>
> [0] https://github.com/qgis/QGIS-Documentation/tree/master/readme>
> Thanks
> --
> Alexander Bruy

Re: [Qgis-community-team] tex to rst conversion

> Also is there any guide ragarding directory layout, especially where
> to place images: in the top level img directory or in the img subdirectory
> inside section directory?
>
> 2012/4/21 Alexander Bruy<[hidden email]>:
>> Hi all,
>>
>> seems some tags are missed from list [0], for example in print composer
>> section there are several
>>
>> \dropmenuopttwo{mActionNewComposer}{New Print Composer}
>>
>> for which there is no RST equivalent. What should I do with this?
>>
>> [0] https://github.com/qgis/QGIS-Documentation/tree/master/readme>>
>> Thanks
>> --
>> Alexander Bruy

Re: [Qgis-community-team] tex to rst conversion

So the converted rst is now in github. Great! Should we start hacking
our way? Or there are more text to rst conversions coming?
I would like to focus on the English docs for now mainly on formatting
and maybe work my way towards the content.

> So the converted rst is now in github. Great! Should we start hacking
> our way? Or there are more text to rst conversions coming?
> I would like to focus on the English docs for now mainly on formatting
> and maybe work my way towards the content.
>
>
> On Sat, Apr 21, 2012 at 4:57 PM, Alexander Bruy
> <[hidden email]> wrote:
>> Hi all,
>>
>> seems some tags are missed from list [0], for example in print composer
>> section there are several
>>
>> \dropmenuopttwo{mActionNewComposer}{New Print Composer}
>>
>> for which there is no RST equivalent. What should I do with this?
>>
>> [0] https://github.com/qgis/QGIS-Documentation/tree/master/readme>>
>> Thanks
>> --
>> Alexander Bruy
>> _______________________________________________
>> Qgis-community-team mailing list
>> [hidden email]>> http://lists.osgeo.org/mailman/listinfo/qgis-community-team>
>
>
> --
> cheers,
> maning
> ------------------------------------------------------
> "Freedom is still the most radical idea of all" -N.Branden
> wiki: http://esambale.wikispaces.com/> blog: http://epsg4253.wordpress.com/> ------------------------------------------------------

Re: [Qgis-community-team] tex to rst conversion

Sorry to not answer to all of your question. I was on trip all last week and
have no enough time to follow all thread.

I am fine with all of your message :)

Go ahead!

Y.
Le jeudi 19 avril 2012 13:04:41, Paolo Corti a écrit :

> On Mon, Apr 16, 2012 at 11:27 PM, Paolo Corti <[hidden email]> wrote:
> > 2012/4/16 Otto Dassau <[hidden email]>:
> >> Hi Yves,
> >>
> >> is there a list of tex files that still have to be converted to rst? I
> >> would like to get some more practice :), but don't want to duplicate
> >> work.
> >
> > Hi guys
> > one think that we should seriously consider, it is to write down (to
> > include in the readme.rst file), and
> > actually apply, some guidelines for the rst style we are using.
> > I would suggest to follow the rules that have been used for writing
> > the Python documentation, that are at some extent, specially for
> > sections, described here [1].
> > what do you think?
> > ciao
>
> Hi Yves
> now that more and more people seems impacted in the tex to rst
> migration process, we should really consider updating the
> documentation style guide [1].
> Are you ok, as suggested in previous email, to proceed with the Python
> documentation style guide [2]?
> Can I update [1] with a very evident link to [2] (and you upgrade your
> export script for taking care of [2])?
> Let me know
> p
>
> [1] https://github.com/qgis/QGIS-Documentation/tree/master/readme> [2] http://docs.python.org/devguide/documenting.html