/ogc_school

Public repository for OGC training material.

Primary LanguagePython

OGC School

This is a public repository for OGC training material that can be improved by anyone. If you are a geo developer or an instructor of a Geospatial Web Course this repository is for you.

Folder Organization

  • Each standard has its own Folder
  • Each folder for each standard contains two folders: slides and img
  • The slides will be build as PDF under the folder build
  • The custom folder contains additional custom information. For example the cover of the presentation. You should customize this to fit your needs.

Files

  • Each file is written in rst.
  • Each file extension is .rst
  • Each file should contain language code at the end of the file name. For example for wms in protugese wms_pt.rst.
  • ISO 2 letter language codes should be used: http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes

Images References

  • The reference location of the images is relative to the slides folder. So to insert an image from the cat/img the following must be done:

    .. image:: ../img/metadataaboutdata.jpg

Configuring the Content

  • Edit in the custom folder the slides and images to be included in the beginning and end of the presentation

  • To test how the cover page looks you can run the following (See next topic):

    rst2pdf ./custom/cover.rst -s slides.style -o cover.pdf

  • Edit the list_of_slides_to_build.txt. Provide the link to the file you want to include in the presentation.

  • Only include the file name and not the fie type .rst. for example:
    • wms/slides/wms_en.rst

Building the Slides

  • To build the slides, Shpinx needs to be installed.
  • Run build.sh (Currently, only based unix systems are supported)
  • The script will:
    • Remove all the pdfs under the build root folder
    • Read the list_of_slides_to_build.txt
    • Under each standard/slides folder will remove a build folder
    • Under each standard/slides folder it will create a build folder
    • Temporary store the pdf file under standard/slides/build
    • Copy in the root build folder the pdfs created locally in each standard folder. They will be numbered following the order in the list_of_slides_to_build.txt.
    • Merge all the pdfs files under build as ogc-tutorial.pdf
  • The PDF will be created under the build folder and will appear as tutorial.pdf