Changes between Version 2 and Version 3 of the_docs_strikes_back

Timestamp:

04/10/18 12:17:18 (7 years ago)

Author:

cvvergara

Comment:

adding a sketch of the documentation for an overview part 1

the_docs_strikes_back

@@ -106 +106 @@
 
 Yes right before WPS ! {{{:doc:}}} are use to link to document in the documentation, but it is a link to the WPS webpage. So sphinx doesn't find the {{{WPS <http://www.opengeospatial.org/standards/wps>}}} file and gives an error.
+
+
+----
+
+= How to document the overview file
+
+
+The overview files are located at:
+
+https://github.com/OSGeo/OSGeoLive-doc/tree/master/doc/overview
+
+For this documentation:
+
+*  Words surrounded by `< >` are to be defined by the person documenting the project
+  * <slug> is the slug name defined on `projects_info.csv` file
+* The project overview file name is `<slug>_overview.rst` for example `udig_overview.rst`
+* Words surrounded by `@` are variables and will automatically get values, the purpose is to keep consistency through all the documentation
+
+||= Table Header =|| Example || Action ||
+|| @LOGO_<slug>@ || `@LOGO_udig@` || Gets the logo image of the project  if it exists ||
+|| @OSGEO_KIND_<slug>@ || `@OSGEO_KIND_udig@` || Gets the logo of the kind of project within OSGeo ||
+|| @NAME_udig@ || `@NAME_udig@` || Gets the name of the project as defined on the `projects_info.csv` ||
+|| @QUICKSTART_udig@ || `@QUICKSTART_udig@` || Will generate a link to the quickstart if it exists ||
+
+and has the following structure:
+
+{{{
+:Author: <author's name>
+:Reviewer: <reviewer name>
+:Version: <OSGeoLive version from which this documentation is valid>
+:License: Creative Commons Attribution 3.0 Unported (CC BY 3.0)
+
+
+@LOGO_<slug>@
+@OSGEO_KIND_<slug>@
+
+
+@NAME_<slug>@
+================================================================================
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Mauris eget dui vitae est
+sodales consequat eget vel risus. Fusce suscipit lorem sit amet elementum volutpat.
+Praesent pretium mauris id porta convallis. Integer suscipit, massa at tempor congue,
+lectus ipsum tempor eros, non elementum orci felis eget diam. Praesent vitae tortor
+finibus, bibendum orci vulputate, semper lectus. Morbi fringilla dignissim consectetur.
+
+Donec ac dictum nisi. Cras sed justo id augue lacinia tincidunt vel non purus.
+Doneceget ante blandit leo porta semper eu in sapien. Donec at nibh finibus,
+posuere eros eget, fringilla tortor. Morbi quam @NAME_<slug>@ ipsum, molestie et mi nec,
+bibendum feugiat ipsum. Fusce mauris ligula, iaculis id varius a, laoreet nec lectus.
+Phasellus rhoncus pulvinar purus.
+
+@NAME_<slug>@  Praesent quis sapien nibh. Integer dictum, augue sed semper tincidunt,
+lectus sem porttitor mauris, a porta magna est a orci.
+
+
+@SCREENSHOT_udig@
+
+Core Features
+--------------------------------------------------------------------------------
+
+* Vestibulum massa risus
+* sagittis eu ornare ut
+* dapibus sit amet risus
+
+Implemented Standards
+--------------------------------------------------------------------------------
+
+* OGC Web Map Server (WMS)
+* OGC Web Feature Server (WFS)
+
+
+Details
+--------------------------------------------------------------------------------
+
+**Website:** <wesite link>
+
+**Licence:** <license>
+
+**Software Version:** |version-udig|
+
+**Supported Platforms:** <List of platforms>
+
+**API Interfaces:** <list of API interfaces>
+
+**Support:** <support link>
+
+**Developers:** <developers link>
+
+
+@QUICKSTART_udig@
+
+.. presentation-note
+    Lorem ipsum dolor sit amet, consectetur adipiscing elit. Mauris eget dui vitae est
+    sodales consequat eget vel risus. Fusce suscipit lorem sit amet elementum volutpat.
+    Praesent pretium mauris id porta convallis. Integer suscipit, massa at tempor congue,
+    lectus ipsum tempor eros, non elementum orci felis eget diam. Praesent vitae tortor
+    finibus, bibendum orci vulputate, semper lectus. Morbi fringilla dignissim consectetur.
+ 
+}}}