From fe737a98c8e1f84a94abd5717d4dbe11f3c90c7e 2010-08-10 18:53:11 From: Fernando Perez Date: 2010-08-10 18:53:11 Subject: [PATCH] Added top-level links.rst file to keep useful links in one place that can be included from other files. --- diff --git a/docs/source/links.rst b/docs/source/links.rst new file mode 100644 index 0000000..abd5e7e --- /dev/null +++ b/docs/source/links.rst @@ -0,0 +1,72 @@ +.. This (-*- rst -*-) format file contains commonly used link targets + and name substitutions. It may be included in many files, + therefore it should only contain link targets and name + substitutions. Try grepping for "^\.\. _" to find plausible + candidates for this list. + + NOTE: this file must have an extension *opposite* to that of the main reST + files in the manuals, so that we can include it with ".. include::" + directives, but without triggering warnings from Sphinx for not being listed + in any toctree. Since IPython uses .txt for the main files, this wone will + use .rst. + + NOTE: reST targets are + __not_case_sensitive__, so only one target definition is needed for + ipython, IPython, etc. + + NOTE: Some of these were taken from the nipy links compendium. + +.. Main IPython links +.. _ipython: http://ipython.scipy.org +.. _`ipython manual`: http://ipython.scipy.org/doc/manual/html +.. _ipython_github: http://github.com/ipython/ipython/ +.. _ipython_github_repo: http://github.com/ipython/ipython/ +.. _ipython_downloads: http://ipython.scipy.org/dist +.. _ipython_pypi: http://pypi.python.org/pypi/ipython + +.. Documentation tools and related links +.. _graphviz: http://www.graphviz.org +.. _Sphinx: http://sphinx.pocoo.org +.. _`Sphinx reST`: http://sphinx.pocoo.org/rest.html +.. _sampledoc: http://matplotlib.sourceforge.net/sampledoc +.. _reST: http://docutils.sourceforge.net/rst.html +.. _docutils: http://docutils.sourceforge.net +.. _lyx: http://www.lyx.org +.. _pep8: http://www.python.org/dev/peps/pep-0008 +.. _numpy_coding_guide: http://projects.scipy.org/numpy/wiki/CodingStyleGuidelines + +.. Licenses +.. _GPL: http://www.gnu.org/licenses/gpl.html +.. _BSD: http://www.opensource.org/licenses/bsd-license.php +.. _LGPL: http://www.gnu.org/copyleft/lesser.html + +.. Other python projects +.. _numpy: http://numpy.scipy.org +.. _scipy: http://www.scipy.org +.. _scipy_conference: http://conference.scipy.org +.. _matplotlib: http://matplotlib.sourceforge.net +.. _pythonxy: http://www.pythonxy.com +.. _ETS: http://code.enthought.com/projects/tool-suite.php +.. _EPD: http://www.enthought.com/products/epd.php +.. _python: http://www.python.org +.. _mayavi: http://code.enthought.com/projects/mayavi +.. _sympy: http://code.google.com/p/sympy +.. _sage: http://sagemath.org +.. _pydy: http://code.google.com/p/pydy +.. _vpython: http://vpython.org +.. _cython: http://cython.org +.. _software carpentry: http://software-carpentry.org + +.. Not so python scientific computing tools +.. _matlab: http://www.mathworks.com +.. _VTK: http://vtk.org + +.. Other organizations +.. _enthought: http://www.enthought.com +.. _kitware: http://www.kitware.com +.. _netlib: http://netlib.org + +.. Other tools and projects +.. _indefero: http://www.indefero.net +.. _git: http://git-scm.com +.. _github: http://github.com