Merge pull request #2 from gaelforget/readthedocs

Readthedocs

.gitignore

@@ -0,0 +1 @@
+docs/_build

docs/bibli.bib

@@ -0,0 +1,63 @@
+@string{angl    = {Ann.\ Glaciol.}}
+@string{arfm  = {Annu.~Rev.~Fluid Mech.}}
+@string{bams  = {Bull.~Am.~Met.~Soc.}}
+@string{blm = {Bound.~Layer~Meteorol.}}
+@string{climd = {Clim.~Dynamics}}
+@string{cch     = {Clim.\ Change}}
+@string{cup = {Cambridge University Press}}
+@string{dao     = {Dyn.~Atmos.~Oceans}}
+@string{dkrz  = {Deutsches Klimarechenzentrum (DKRZ)}}
+@string{dnmi  = {The Norwegian Meteorological Institute (DNMI)}}
+@string{dsr = {Deep Sea Res.}}
+@string{ecmwf = {ECMWF}}
+@string{eos     = {Eos~Trans.\ AGU}}
+@string{esa = {European Space Agency (ESA)}}
+@string{esapub  = {ESA Publications Division, ESTEC, Noordwijk (NL)}}
+@string{estec = {European Space Research and Technology Centre (ESTEC)}}
+@string{gaos  = {Global Atmos.~Ocean System}}
+@string{grl = {Geophys.~Res.~Lett.}}
+@string{ieee  = {IEEE Trans.~Geosci. Remote Sensing}}
+@string{ifremer = {IFREMER/CERSAT}}
+@string{igarss  = {IEEE Press, Piscataway, N.J., USA}}
+@string{jam = {J.~Appl.~Meteor.}}
+@string{jaot  = {J.~Atmos.~Ocean.~Technol.}}
+@string{jas = {J.~Atmos.~Sci.}}
+@string{jclim = {J.~Clim.}}
+@string{jcp = {J.~Comput.~Phys.}}
+@string{jfm = {J.~Fluid Mech.}}
+@string{jgr = {J.~Geophys.~Res.}}
+@string{ijrs  = {Int.~J.~Remote Sensing}}
+@string{jms = {J.~Mar.~Sys.}}
+@string{jpo = {J.~Phys.~Oceanogr.}}
+@string{mpi = {MPI f\"ur Meteorologie}}
+@string{mcp = {Meth. Comput. Phys.}}
+@string{mwr     = {Mon.~Wea.~Rev.}}
+@string{om  = {Ocean Modelling}}
+@string{pf = {Physics of Fluids}}
+@string{pd = {Physica D.}}
+@string{ptrsl   = {{Phil.~Trans.~R.~Soc.~Lond.}}}
+@string{rgsp = {{Rev.~Geophys.~Space~Phys.}}}
+@string{qjrms   = {{Q.~J.~R.~Meteorol.~Soc.}}}
+@string{siscicom= {SIAM J.\ Sci.\ Comput.}}
+@string{tel = {Tellus}}
+
+@Article{for-eta:15,
+ author         = {Forget, G. and Campin, J.-M. and Heimbach, P. and Hill, C. N. and Ponte, R. M and Wunsch, C.},
+ title          = {{ECCO} version 4: an integrated framework for non-linear inverse modeling and global ocean state estimation},
+ journal        = {Geoscientific Model Development},
+ volume         = {8},
+ year           = {2015},
+ number         = {10},
+ pages          = {3071--3104},
+ url            = {http://www.geosci-model-dev.net/8/3071/2015/},
+ doi            = {10.5194/gmd-8-3071-2015}
+}
+
+@Article{dspace-eccov4r2,
+ AUTHOR   = {Forget, G. and Campin, J.-M. and Heimbach, P. and Hill, C. N. and Ponte, R. M and Wunsch, C.},
+ TITLE    = {{ECCO} version 4: Second Release},
+ YEAR     = {2016},
+ journal  = {},
+ URL      = {http://hdl.handle.net/1721.1/102062}
+}
+

docs/biblirefs.rst

@@ -0,0 +1,10 @@
+.. _references:
+
+.. only:: html
+
+   References
+   **********
+
+.. bibliography:: bibli.bib
+   :all:
+

docs/conf.py

@@ -30,7 +30,10 @@
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
-extensions = []
+extensions = ['sphinx.ext.autodoc',
+    'sphinx.ext.mathjax',
+    'sphinx.ext.viewcode',
+    'sphinxcontrib.bibtex']
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
@@ -76,6 +79,21 @@
 # If true, `todo` and `todoList` produce output, else they produce nothing.
 todo_include_todos = False
 
+# number figures
+
+numfig_format = {'figure': 'Figure %s',
+                 'table': 'Table %s',
+                 'code-block': 'Code %s',
+                }
+
+numfig = True
+
+# number figures within section
+numfig_secnum_depth = 1
+
+#math_number_all = True
+
+numfig_format = {'figure': 'Figure %s', 'table': 'Table %s', 'code-block': 'Listing %s', 'section': 'Section %s'}
 
 # -- Options for HTML output ----------------------------------------------
 
@@ -95,7 +113,9 @@
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
+### gf: the following is commented to avoid warning 
+### gf: see https://github.com/terasolunaorg/guideline/issues/1358
+# html_static_path = ['_static']
 
 # Custom sidebar templates, must be a dictionary that maps document names
 # to template names.