Fix several wrong linkages

A number of changes were done to fix issues arising in the build of the user guide.

Several links were broken or not updated.

A conda environment with the required set of packages was create to help out users.

source/conf.py

@@ -12,9 +12,11 @@ project = 'NEMO'
 author = 'NEMO System Team'
 
 # The short X.Y version
-version = '4.2'
+version = '4.2.0'
 # The full version, including alpha/beta/rc tags
-release = 'release-4.2.0'
+release = 'release-' + version
+# NEMO gitlab repository
+nemo_repo='https://forge.nemo-ocean.eu/nemo/nemo/-/'
 
 
 # -- General configuration ---------------------------------------------------
@@ -23,6 +25,9 @@ release = 'release-4.2.0'
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = ['sphinx.ext.extlinks', 'sphinx.ext.todo', 'sphinxcontrib.bibtex']
+# add pip extensions
+extensions += ['sphinxext.remoteliteralinclude']
+
 bibtex_bibfiles = ['refs.bib', 'cfgs.bib', 'tests.bib']
 
 # Add any paths that contain templates here, relative to this directory.
@@ -98,14 +103,17 @@ copyright = '2008-' + str( year ) + ', NEMO Consortium'
 
 # Link aliases
 extlinks = {
-	'doi'    : ('https://doi.org/%s'                       , None),
-	'forge'  : ('https://forge.ipsl.jussieu.fr/nemo/%s'    , None),
-	'github' : ('https://github.com/NEMO-ocean/%s'         , None),
-	'xios'   : ('https://forge.ipsl.jussieu.fr/ioserver/%s', None),
-	'website': ('https://www.nemo-ocean.eu/%s'             , None),
-	'gitlab' : ('https://forge.nemo-ocean.eu/nemo/core'    , None),
-	'zenodo' : ('https://zenodo.org/publication/%s'        , None)
+	'doi'     : ('https://doi.org/%s'                       , None),
+	'forge'   : ('https://forge.ipsl.jussieu.fr/nemo/%s'    , None),
+	'github'  : ('https://github.com/NEMO-ocean/%s'         , None),
+	'xios'    : ('https://forge.ipsl.jussieu.fr/ioserver/%s', None),
+	'website' : ('https://www.nemo-ocean.eu/%s'             , None),
+	'zenodo'  : ('https://zenodo.org/publication/%s'        , None),
+	'gitlab'  : (nemo_repo                                  , None),
+        'coderepo': (nemo_repo + '/tree/'+ version + '%s'       , None),
+        'tarrepo' : (nemo_repo + '/releases/'+ version + '%s'   , None),
 }
 
 # Include common directives for every rst file
 rst_epilog = open('global.rst', 'r').read()
+