Version 2.0.0 upload

Author: H0R5E

README.md

@@ -5,6 +5,11 @@ viewed online at [dtocean.github.io](https://dtocean.github.io/), read as pdf
 documentation or installed for offline use with the DTOcean graphical interface
 (see [dtocean](https://github.com/DTOcean/dtocean)).
 
+**Version 2.0.0 of the manuals is a rewrite of the original release, focussed 
+on the current version of the software, rather than the goals the original EU
+DTOcean project. This process is not not yet fully complete, so please refer to 
+version 1.0.0 when additional detail is required.**
+
 ## Offline Manuals 
 
 The DTOcean Manuals installation wizard can be downloaded from the [Releases](
@@ -41,6 +46,9 @@ and packaged by:
 It is now maintained by Mathew Topper at [Data Only Greater](
 https://www.dataonlygreater.com/).
 
+Gratitude is given to [Sandia Nation Labs](https://www.sandia.gov) for 
+supporting the ongoing rewrite of this documentation.
+
 ## License
 
 [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/)

conf.py

@@ -68,24 +68,24 @@
 
 # General information about the project.
 project = u'DTOcean'
-copyright = u'2016 The DTOcean Developers'
+copyright = u'2016-{} The DTOcean Developers'.format(now.year)
 author = u'unknown'
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
 # The short X.Y version.
-version = u'1.0'
+version = u'2.0'
 # The full version, including alpha/beta/rc tags.
-release = u'1.0.0'
+release = u'2.0.0'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = "en"
+language = None
 
 # There are two options for replacing |today|: either, you set today to some
 # non-false value, then it is used:
@@ -96,24 +96,10 @@
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
 exclude_patterns = ['_build',
+                    'data',
                     'contents.rst',
-                    'technical/hydrodynamics.rst',
-                    'technical/electrical.rst',
-                    'technical/moorings.rst',
-                    'technical/instalation.rst',
-                    'technical/operations.rst',
-                    'technical/economics.rst',
-                    'technical/reliability.rst',
-                    'technical/environment.rst',
-                    'user/hydrodynamics.rst',
-                    'user/electrical.rst',
-                    'user/moorings.rst',
-                    'user/installation.rst',
-                    'user/operations.rst',
-                    'user/economics.rst',
-                    'user/reliability.rst',
-                    'user/environment.rst']
-                    
+                    'user/database_tables.rst']
+
 # The reST default role (used for this markup: `text`) to use for all
 # documents.
 #default_role = None
@@ -250,6 +236,7 @@
 
 ADDITIONAL_PREAMBLE = """
 \setcounter{tocdepth}{4}
+\DeclareUnicodeCharacter{3003}{---"---}
 """
 
 latex_elements = {
@@ -264,9 +251,6 @@
 
     # Latex figure (float) alignment
     #'figure_align': 'htbp',
-    
-    # Use extended UTF8 character set
-    'inputenc': "\\usepackage[utf8x]{inputenc}"
     }
 
 # Grouping the document tree into LaTeX files. List of tuples

contents.rst

@@ -2,31 +2,13 @@ Contents
 ========
 
 .. toctree::
-    :maxdepth: 1
-    :numbered:
-    :caption: User's Manual
-    
-    user/abstract
-    user/sysreq
-    user/softinstall
-    user/overview
-    user/gui
-    user/modules
-    user/themes
-    user/preprocessing
-    user/references
+   :maxdepth: 1
+   :numbered:
+   :caption: User Guide
 
-.. toctree::
-    :maxdepth: 1
-    :numbered:
-    :caption: Technical Manual
-    
-    technical/introduction
-    technical/sysreq
-    technical/designreq
-    technical/datamanagement
-    technical/mainapp
-    technical/database
-    technical/modules
-    technical/themes
-    technical/datastructures
+   user/intro
+   user/install
+   user/getting_started_1
+   user/getting_started_2
+   user/gui
+   user/data_preparation

data/about_menu_table.csv

@@ -0,0 +1,4 @@
+Name,Purpose,Icon
+Index...,Open the user manual (if installed),|icon_manual|
+View Logs...,Open the directory containing the log files,
+About DTOcean...,Open the About dialogue,

data/about_menu_table.py

@@ -0,0 +1,14 @@
+# coding: utf-8
+
+# Usage:
+# > activate _pytablewriter
+# > cd E:\Programming\Sphinx\git\dtocean.github.io\data
+# > python about_menu_table.py > about_menu_table.rst
+
+import pytablewriter
+from pytablewriter import Align
+
+if __name__ == "__main__":
+    writer = pytablewriter.RstGridTableWriter()
+    writer.from_csv("about_menu_table.csv")
+    writer.write_table()

data/context_menu_table.csv

@@ -0,0 +1,4 @@
+Name,Sections,Branches,Purpose
+Inspect,"Configuration, Results",Modules,Update the output variable values to the state following execution of the selected module
+Reset,Configuration,Modules,"Reset modules and variables to the state prior to execution of the selected module. Note, this action is destructive and cannot be undone."
+Load test data...,Configuration,"Modules, Assessment",Load data from a specifically formatted python file into the variables of the selected branch

data/context_menu_table.py

@@ -0,0 +1,14 @@
+# coding: utf-8
+
+# Usage:
+# > activate _pytablewriter
+# > cd E:\Programming\Sphinx\git\dtocean.github.io\data
+# > python context_menu_table.py > context_menu_table.rst
+
+import pytablewriter
+from pytablewriter import Align
+
+if __name__ == "__main__":
+    writer = pytablewriter.RstGridTableWriter()
+    writer.from_csv("context_menu_table.csv")
+    writer.write_table()

data/data_menu_table.csv

@@ -0,0 +1,9 @@
+Name,Purpose,Icon
+Select Database...,Open the select database dialogue,|icon_select_db|
+Initiate Pipeline,Confirm chosen technology type and collect top level  information from the database (if selected),|icon_pipeline|
+Initiate Bathymetry,Allow selection of bathymetry from a site chosen from the database (if selected),|icon_bathymetry|
+Initiate Dataflow,Calculate required variables for technology and module selection and collect available data from database (if selected),|icon_dataflow|
+Export...,Export satisfied data to a datastate file,
+Export (mask outputs)...,Export satisfied data (excluding output variables) to a datastate file,
+Import...,Import a datastate file,
+Import (skip satisfied)...,Import a datastate file but do not overwrite satisfied variables,

data/data_menu_table.py

@@ -0,0 +1,14 @@
+# coding: utf-8
+
+# Usage:
+# > activate _pytablewriter
+# > cd E:\Programming\Sphinx\git\dtocean.github.io\data
+# > python data_menu_table.py > data_menu_table.rst
+
+import pytablewriter
+from pytablewriter import Align
+
+if __name__ == "__main__":
+    writer = pytablewriter.RstGridTableWriter()
+    writer.from_csv("data_menu_table.csv")
+    writer.write_table()

data/data_widget_table_table.csv

@@ -0,0 +1,4 @@
+Icon,Purpose
+|icon_table_edit|,Toggle the editing mode of the table
+|icon_add_row|,Appends a new row to the bottom of the table
+|icon_remove_row|,Removes the row containing the selected cell