good latex editor depends on the operating system :)<br><br>on linux i still use Kile [1] (KDE) which suits for every situation<br>on Windows i mostly prefer TexMaker [2] because Kile is not available for Windows and TexMaker is a very fine tool too once it is configured correctly (especially on windows with ghostscript and ghostview and MikTeX and all other things to be installed also)<br>
Once ago i used TeXniccenter [3] too but I'm not very good in using windows at all and it seems to be not very actively developed any more ..<br>For MacOS youre on your own because I don't own a Mac myself.<br>good luck <br>
<br>[1]<a href="http://kile.sourceforge.net/">http://kile.sourceforge.net/</a><br>[2]<a href="http://www.xm1math.net/texmaker/">http://www.xm1math.net/texmaker/</a><br>[3]<a href="http://www.toolscenter.org/">http://www.toolscenter.org/</a><br>
<br><div class="gmail_quote">On Mon, May 5, 2008 at 5:12 PM, Otto Dassau <<a href="mailto:otto.dassau@gmx.de">otto.dassau@gmx.de</a>> wrote:<br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
Hi Tara,<br>
<br>
have you read the information at the DocumentationWritersCorner? For Windows<br>
there is a SVN-client named "Tortoise SVN". The download page is here:<br>
<br>
<a href="http://tortoisesvn.net/downloads" target="_blank">http://tortoisesvn.net/downloads</a><br>
<br>
I only don't know good latex editors, so here others can help, also give some<br>
hints to get into it:<br>
<br>
Step 1) checkout from svn:<br>
- install the tortoise svn tool and reboot<br>
- right mouse click on the desktop and select SVN checkout (popup window)<br>
- in the popup window enter repo URL to english master doc in head:<br>
<a href="https://svn.osgeo.org/qgis/docs/trunk/english_us/user_guide" target="_blank">https://svn.osgeo.org/qgis/docs/trunk/english_us/user_guide</a> and checkout dir:<br>
e.g. \xxx\xxx\Tara\Desktop\qgis-user_guide<br>
-> this checks out only the english userguide without translation branches<br>
at the moment, enogh for the beginning I think<br>
<br>
Step 2) edit latex files:<br>
- change into trunk: \xxx\Tara\Desktop\qgis-docs\user_guide\<br>
- latex text sources are in *.tex files<br>
- now you need a latex editor and I don't know what tool is nice to use for<br>
windows, so others need to help.<br>
<br>
Step 3) commit changes back to svn:<br>
- inside the user_guide folder with a right mouse -> TortoiseSVN you can<br>
commit, check for modifications etc.<br>
<br>
hope this helps for the beginning. Help for Tortoise SVN is availble here:<br>
<a href="http://tortoisesvn.net/docs/release/TortoiseSVN_en/index.html" target="_blank">http://tortoisesvn.net/docs/release/TortoiseSVN_en/index.html</a><br>
<br>
regards,<br>
<font color="#888888"> Otto<br>
</font><div><div></div><div class="Wj3C7c"><br>
<br>
On Mon, 05 May 2008 07:17:13 -0700<br>
Tara Athan <<a href="mailto:tara_athan@alt2is.com">tara_athan@alt2is.com</a>> wrote:<br>
<br>
> Well, OK I'll give it a try. Do we have a set of instructions for someone just<br>
> getting started contributing to documentation? I am finding it difficult to<br>
> get off the ground here. What I am looking for is:<br>
> 1. how to get a copy of the primary documentation, ie the latex source<br>
> 2. a template for the markup<br>
><br>
> Thanks, Tara<br>
><br>
><br>
> Otto Dassau wrote:Hi Tara,<br>
><br>
> I would also propose to work with latex, at least for the moment. As Gary and<br>
> Stephan said, everything is there and working, so you don't have to learn much<br>
> to get started, it is flexible and there are many people (incl. me), who<br>
> are willing and able to help and assist, if there are problems. We already<br>
> thought of changing to another tool, but always came back to latex.<br>
><br>
> If you like you can nominate Stephan, Otto and many other people in the<br>
project<br>
> as "latex admins", so you don't have to worry, if something doesn't work.<br>
><br>
> If the long run I agree, it might make sense to switch to another system,<br>
> especially when I think of a smooth and easy translation of the master<br>
> document. This is currently more difficult (labour-intensive) and not solved,<br>
> but we all will help you there as well and find the best solution together.<br>
><br>
> >From my point of view, you don't have to be a latex guru at all and all you<br>
need<br>
> to know about latex to contribute, coordinate and lead the documentation<br>
process<br>
> is really very limited - no need to worry about ;-)<br>
><br>
> regards,<br>
> Otto<br>
><br>
> On Mon, 5 May 2008 06:40:52 +0200<br>
> Stephan Holl <<a href="mailto:stephan.holl@intevation.de">stephan.holl@intevation.de</a>> wrote:<br>
><br>
> Hi,<br>
><br>
> Am Montag, 5. Mai 2008 02:20:53 schrieb Tara Athan:<br>
> Hello, all! In a moment of madness, I agreed to lead the QGIS<br>
> documentation team. Currently, the documentation is developed in latex<br>
> and then exported to html and pdf formats. I see a few problems with this:<br>
> 1. documentation contributors have to learn latex or someone has to be<br>
> the middle-man to convert their contributions to latex<br>
> 2. latex mixes presentation and structural markup- recommended practice<br>
> is to separate them<br>
> 3. I haven't used latex in over 20 years.<br>
> So I would like to propose that we change to a different format<br>
> (understanding full well and accepting the responsibility for converting<br>
> from the old format to the new)<br>
><br>
> In this reference<br>
><br>
> <<a href="http://en.tldp.org/HOWTO/Software-Release-Practice-HOWTO/documentation.htm" target="_blank">http://en.tldp.org/HOWTO/Software-Release-Practice-HOWTO/documentation.htm</a><br>
> l> Docbook is recommended. After a quick perusal of some introductory<br>
> material, such as<br>
> <<a href="http://docbook.org/tdg/en/html/ch01.html" target="_blank">http://docbook.org/tdg/en/html/ch01.html</a>><br>
> it is looking like a good choice to me.<br>
> There is an application for converting from laTex to DocBook<br>
> <<a href="http://www.cse.ohio-state.edu/%7Egurari/TeX4ht/" target="_blank">http://www.cse.ohio-state.edu/~gurari/TeX4ht/</a>><br>
><br>
> I would like to know if anyone on the team has experience in using this<br>
> format and can offer advice as to whether this would be a good idea.<br>
> I have worked with latex for documentation for several year now and I<br>
think<br>
> that it is worth learning it!<br>
><br>
> >From my point of view we should use our time to complete the docs in latex<br>
and<br>
><br>
> not waste time in converting from on to another format.<br>
><br>
> I can offer a hand to fix some latex-issues if needed since I am quite<br>
> familiar with the latex-code used in the docs.<br>
><br>
><br>
</div></div><div><div></div><div class="Wj3C7c">> Best regards<br>
><br>
> Stephan Holl<br>
><br>
><br>
><br>
><br>
><br>
_______________________________________________<br>
Qgis-community-team mailing list<br>
<a href="mailto:Qgis-community-team@lists.osgeo.org">Qgis-community-team@lists.osgeo.org</a><br>
<a href="http://lists.osgeo.org/mailman/listinfo/qgis-community-team" target="_blank">http://lists.osgeo.org/mailman/listinfo/qgis-community-team</a><br>
</div></div></blockquote></div><br>