.. -*- mode: rst -*-

.. default-role:: math

.. roles

.. role:: red
   :class: red

.. role:: green
   :class: green

.. role:: blue
   :class: blue

.. role:: var(literal)
   :class: variable

.. role:: opt(literal)
   :class: option

.. role:: config(literal)
   :class: config

.. substitutions

.. |petsc-min-version| replace:: 3.5

.. |pism-email| replace:: uaf-pism@alaska.edu
.. |pism-docs| replace:: http://www.pism-docs.org
.. |petsc-download| replace:: http://www.mcs.anl.gov/petsc/download/index.html

.. |pism-browser| replace:: PISM *Source Code Browser*

.. |config-cdl| replace:: ``src/pism_config.cdl``
.. |config-file| replace:: ``pism_config.nc``

.. |pism-regional-tools-url| replace:: https://github.com/pism/regional-tools

.. |mismip-url| replace:: http://homepages.ulb.ac.be/~fpattyn/mismip/
.. |mismip3d-url| replace:: http://homepages.ulb.ac.be/~fpattyn/mismip3d/
.. |eismint-url| replace:: http://homepages.vub.ac.be/~phuybrec/eismint.html
.. |ismip-url| replace:: http://homepages.vub.ac.be/~phuybrec/ismip.html

.. |sphinxcontrib-bibtex-url| replace:: http://sphinxcontrib-bibtex.readthedocs.io/en/latest/

.. external links

.. _Bash: http://www.gnu.org/software/bash/
.. _CalCalcs: http://meteora.ucsd.edu/~pierce/calcalcs/calendars.html
.. _CalCalcs-home: http://meteora.ucsd.edu/~pierce/calcalcs/index.html
.. _CDO: https://code.mpimet.mpg.de/projects/cdo
.. _CF-cell-boundaries: http://cfconventions.org/Data/cf-conventions/cf-conventions-1.7/cf-conventions.html#cell-boundaries
.. _CF Conventions: http://cfconventions.org/Data/cf-conventions/cf-conventions-1.7/cf-conventions.html
.. _CF-Calendars: http://cfconventions.org/Data/cf-conventions/cf-conventions-1.7/cf-conventions.html#calendar
.. _CF-standard-names: http://cfconventions.org/standard-names.html
.. _cf-names-for-glaciology: http://websrv.cs.umt.edu/isis/index.php/CF_standard_names_for_Glaciology_and_Ice-Sheet_Modeling
.. _cf-names-proposed: http://cfeditor.ceda.ac.uk/proposals/1
.. _CMake: https://cmake.org/
.. _CMake-cross-compiling: https://cmake.org/Wiki/CMake_Cross_Compiling
.. _Enthought: https://www.enthought.com/
.. _FFTW: http://www.fftw.org/
.. _Fink: http://www.finkproject.org/
.. _GSL: http://www.gnu.org/software/gsl/
.. _Git: https://git-scm.com/
.. _Homebrew: https://brew.sh/
.. _IDV: http://www.unidata.ucar.edu/software/idv/
.. _LaTeX: http://www.latex-project.org/
.. _latexmk: http://personal.psu.edu/jcc8//software/latexmk-jcc/
.. _MPI: http://www.mcs.anl.gov/research/projects/mpi/
.. _MacPorts: https://www.macports.org/
.. _measures-ross: http://nsidc.org/data/NSIDC-0484
.. _NSIDC: http://nsidc.org
.. _NCL: http://www.ncl.ucar.edu
.. _NCO: http://nco.sourceforge.net/
.. _NetCDF: http://www.unidata.ucar.edu/software/netcdf/
.. _netcdf-classic-format: http://www.unidata.ucar.edu/software/netcdf/docs/file_structure_and_performance.html#classic_file_parts
.. _NumPy: http://www.numpy.org/
.. _PETSc-installation: http://www.mcs.anl.gov/petsc/documentation/installation.html
.. _PETSc: http://www.mcs.anl.gov/petsc/
.. _PISM: http://www.pism-docs.org/wiki/doku.php
.. _PROJ.4: http://proj4.org/
.. _PnetCDF: http://trac.mcs.anl.gov/projects/parallel-netcdf
.. _Python: https://www.python.org
.. _Sphinx: http://www.sphinx-doc.org/en/stable/install.html
.. _sphinxcontrib.bibtex: http://sphinxcontrib-bibtex.readthedocs.io/en/latest/
.. _UDUNITS: http://www.unidata.ucar.edu/software/udunits/
.. _Ubuntu: https://www.ubuntu.com/desktop
.. _X: https://www.x.org/wiki/
.. _XCode: https://developer.apple.com/xcode/
.. _XQuartz: https://www.xquartz.org/
.. _doxygen: http://www.stack.nl/~dimitri/doxygen/
.. _graphviz: http://www.graphviz.org/
.. _matplotlib: http://matplotlib.org/
.. _ncview: http://meteora.ucsd.edu/~pierce/ncview_home_page.html
.. _netcdf4-python: https://pypi.python.org/pypi/netCDF4
.. _pyngl: http://www.pyngl.ucar.edu
.. _SeaRISE-Greenland: http://websrv.cs.umt.edu/isis/index.php/Model_Initialization#Greenland
.. _searise-greenland-data: http://websrv.cs.umt.edu/isis/index.php/Present_Day_Greenland
.. _searise: http://websrv.cs.umt.edu/isis/index.php/SeaRISE_Assessment
.. _mismip-code: http://homepages.ulb.ac.be/~fpattyn/mismip/MISMIP_distribution.tar
.. _VDT: https://github.com/dpiparo/vdt

.. PISM-related external links

.. _HPC-builds: https://github.com/pism/hpc-builds
.. _PISM: http://www.pism-docs.org/wiki/doku.php
.. _pism-browser: http://www.pism-docs.org/doxy/html/index.html
.. _pism-email: mailto:uaf-pism@alaska.edu
.. _pypismtools: https://github.com/pism/pypismtools
.. _regional-tools: https://github.com/pism/regional-tools
