Re: [udig-devel] doc conversion to Sphinx and RST

[Frank Gasdorf <fgdrf@xxxxxxxxxxxxxxxxxxxxx>]

Agree, external images are not supported right now. Created a bug for
it : https://bitbucket.org/cdevienne/odt2sphinx/issue/1/odt2sphinx-cant-handle-external-images

GeoServerInsall worked fine. Have you setup sphinx build and created
html out of it?

Started with sphinx-quickstart and created a project in the udig-docs
root. Properly we should create a branch to share results of our
experiences and steps.

ideas so far:
* create a single language documentations to start with
* use the odt2sphinx script to convert odts, lets temp. save odts like
Jody suggested
* fix the images
* create a pretty udig Style, properly we can start with css from
http://udig.refractions.net/

structure:

udig-docs/
  + user/
     + WalkThrough1
     + WalkThrough2
     [...]
     + GeoServerInstall (obsolete ??)
  + developer/
  + Makefile / win bat for sphinx
  + themes

but wait. If we like to include source like Jody did for geotools docs
we should move the docs to the udigPlatform repository. Opinions?

Cheers,
Franl


2012/5/7 Jody Garnett <jody.garnett@xxxxxxxxx>:
> 1) https://bitbucket.org/cdevienne/odt2sphinx
>
> This may be able to convert out walkthroughs and other assorted open office
> docs.
>
> I have had mixed success with this.
>
> It *is* able to produce some sort of RST files; and extract images out of
> the open office documents resulting in friendly text like the following:
>
> * Unzip the download to create your
>   data
>   directory. The
>   7-Zip
>   application is recommended.
>
> * Create an empty Map by slecting
>   File > New > New Map
>   from the menubar.
>
> * Drag and Drop the file
>   10m_land.shp
>   onto your open
>   Map
>   |100000000000040100000303FBBE0454_png|
>
> Unfortunately it was not able to handle our "relative" links to images -
> this is really to bad as we have decent file names for the images in
> walkthrough1 and walkthrough 2.
>
> Is there any interest in me committing this work?
>
> If you would like to go through the steps:
> 1) open the file
> 2) choose links
> 3) select all the links and click the "break" button
> 4) save as --> docs/en/user
> 5) odt2sphinx uDigWalkthrough1.odt walktrhough1
>
> Jody
>
>
> _______________________________________________
> User-friendly Desktop Internet GIS (uDig)
> http://udig.refractions.net
> http://lists.refractions.net/mailman/listinfo/udig-devel
>