Replace :ref: and :math: markup syntax

Author: migueldvb

tutorials/UVES/UVES.ipynb

@@ -46,9 +46,8 @@
      "cell_type": "markdown",
      "metadata": {},
      "source": [
-      "Please download this tar file <../downloads/astropy_UVES.tar.gz> and extract\n",
-      "the content, either by clicking on the link or by executing this\n",
-      "python code"
+      "Please download the tar file and extract\n",
+      "the content by executing this python code"
      ]
     },
     {
@@ -132,8 +131,8 @@
      "metadata": {},
      "source": [
       "The previous astropy tutorial already covered\n",
-      ":ref:`handling-fits-files` and :ref:`wcs-transformations`, so the explanation here\n",
-      "is only very brief. Check the `astropy documentation <http://docs.astropy.org>`_\n",
+      "[handling FITS files](../FITS-header.html) and WCS transformations, so the explanation here\n",
+      "is only very brief. Check the [astropy documentation](http://docs.astropy.org)\n",
       "or the other two tutorials for more details::"
      ]
     },
@@ -276,8 +275,7 @@
       "with python (e.g. `glob`), external modules (e.g. `numpy` or `astropy`) and modules\n",
       "that you write yourself. The syntax to import those modules or functions\n",
       "is the same in all cases, provided that the directory where your module is\n",
-      "defined is in the search path (`more about python modules and the search path\n",
-      "<http://docs.python.org/2/tutorial/modules.html>`_)."
+      "defined is in the search path [more about python modules and the search path](http://docs.python.org/2/tutorial/modules.html)."
      ]
     },
     {
@@ -483,12 +481,12 @@
       "Often, one has to keep track of the units for certain values. Was the wavelength\n",
       "given in Angstrom or in nm? In X-ray observations, a common unit of wavelength is\n",
       "keV. How many nm is 0.65 keV?\n",
-      "`astropy.units <http://docs.astropy.org/en/v0.2.1/units/index.html>`_\n",
+      "[`astropy.units`](http://docs.astropy.org/en/v0.2.1/units/index.html)\n",
       "offers a framework that can take\n",
       "care of this book-keeping and propagate the units through many (but not all)\n",
       "mathematical operations (e.g. addition, division, multiplication).\n",
       "Furthermore,\n",
-      "`astropy.constants <http://docs.astropy.org/en/v0.2.1/constants/index.html>`_  supplies the values of\n",
+      "[`astropy.constants`](http://docs.astropy.org/en/v0.2.1/constants/index.html)  supplies the values of\n",
       "many physical and astronomical constants.\n",
       "The easiest way to attach a unit to a number is by multiplication"
      ]
@@ -534,12 +532,11 @@
      ]
     },
     {
-     "cell_type": "raw",
+     "cell_type": "markdown",
      "metadata": {},
      "source": [
-      "E_{kin}  =  E_{grav}\n",
-      "\n",
-      "\\frac{1}{2} m v^2  =  G \\frac{m M_*}{R_*}"
+      "$$E_{kin}  =  E_{grav}$$\n",
+      "$$\\frac{1}{2} m v^2  =  G \\frac{m M_*}{R_*}$$"
      ]
     },
     {
@@ -614,10 +611,10 @@
      ]
     },
     {
-     "cell_type": "raw",
+     "cell_type": "markdown",
      "metadata": {},
      "source": [
-      "\\lambda_{heliocentric} = \\lambda_{bariocentric} * (1 + \\frac{v_{helio}}{c})"
+      "$\\lambda_{heliocentric} = \\lambda_{bariocentric} * (1 + \\frac{v_{helio}}{c})$"
      ]
     },
     {
@@ -665,7 +662,7 @@
      "metadata": {},
      "source": [
       "I want to mention one more feature here (check out\n",
-      "`astropy.units <http://docs.astropy.org/en/v0.2.1/units/index.html>`_ for\n",
+      "[`astropy.units`](http://docs.astropy.org/en/v0.2.1/units/index.html) for\n",
       "more): The ability to convert the spectral axis to frequencies or energies.\n",
       "Normally, a unit of length is not equivalent to a unit of energy or to a\n",
       "frequency, but this conversion makes sense for the wavelength of a spectrum.\n",
@@ -854,7 +851,7 @@
      "cell_type": "markdown",
      "metadata": {},
      "source": [
-      "`astropy.time <http://docs.astropy.org/en/v0.2.1/time/index.html>`_\n",
+      "[`astropy.time`](http://docs.astropy.org/en/v0.2.1/time/index.html\n",
       "provides methods to convert times and dates between different\n",
       "systems and formats. Since the ESO fits headers already contain the time of the\n",
       "observation in different systems, we could just read the keyword in the time\n",
@@ -1082,8 +1079,8 @@
       "Now, we want to generate a LaTeX table of the observation times, period\n",
       "and equivalent width that we can directly paste into our manuscript. To do so,\n",
       "we first collect all the columns and make an ``astropy.table.Table`` object. (Please\n",
-      "check `astropy.table <http://docs.astropy.org/en/v0.2.1/table/index.html>`_\n",
-      "or :ref:`tabular-data` for more\n",
+      "check [`astropy.table`](http://docs.astropy.org/en/v0.2.1/table/index.html)\n",
+      "or `tabular-data` for more\n",
       "details on ``Table``). So, here is the code"
      ]
     },
@@ -1118,8 +1115,8 @@
      "metadata": {},
      "source": [
       "We will make two plots. The plotting is done with\n",
-      "`matplotlib <http://matplotlib.org>`_, and does not involve Astropy itself.\n",
-      "Plotting is introduced in :ref:`plotting-and-images` and more details on\n",
+      "[`matplotlib`](http://matplotlib.org), and does not involve Astropy itself.\n",
+      "Plotting is introduced in `plotting-and-images` and more details on\n",
       "plotting can be found there. When in doubt, use the search engine of your choice\n",
       "and ask the internet. Here, I mainly want to illustrate that Astropy can be\n",
       "used in real-live data analysis.\n",
@@ -1387,7 +1384,7 @@
      "metadata": {},
      "source": [
       "Clearly, I did not develop this code for scratch.\n",
-      "The `matplotlib gallery <http://matplotlib.org/gallery.html>`_ is my\n",
+      "The [matplotlib gallery](http://matplotlib.org/gallery.html) is my\n",
       "preferred place to look for plotting solutions."
      ]
     },
@@ -1403,7 +1400,7 @@
      "cell_type": "markdown",
      "metadata": {},
      "source": [
-      "`Astropy <http://astropy.org>`_ is an open-source and community-developed\n",
+      "[Astropy](http://astropy.org) is an open-source and community-developed\n",
       "Python package, which means that is only as good as the contribution of the\n",
       "astronomical community. Clearly, there will always people who have more fun writing\n",
       "code and others who have more fun using it. However, if you find a bug and do not\n",
@@ -1412,15 +1409,12 @@
       "request.\n",
       "\n",
       "If you want to get help or discuss issues with other Astropy users, you can\n",
-      "sign up for the `astropy mailing list\n",
-      "<http://mail.scipy.org/mailman/listinfo/astropy>`_.\n",
-      "Alternatively, the `astropy-dev\n",
-      "<http://groups.google.com/group/astropy-dev>`_ list is where you should go to\n",
+      "sign up for the [astropy mailing list](http://mail.scipy.org/mailman/listinfo/astropy).\n",
+      "Alternatively, the [astropy-dev](http://groups.google.com/group/astropy-dev) list is where you should go to\n",
       "discuss more technical aspects of Astropy with the developers.\n",
       "\n",
       "If you have come across something that you believe is a bug, please open a\n",
-      "ticket in the Astropy `issue tracker\n",
-      "<http://github.com/astropy/astropy/issues>`_, and we will look into it\n",
+      "ticket in the Astropy [issue tracker](http://github.com/astropy/astropy/issues), and we will look into it\n",
       "promptly.\n",
       "\n",
       "Please try to include an example that demonstrates the issue and will allow the\n",
@@ -1429,7 +1423,7 @@
       "information about your operating system (e.g. MacOSX version or Linux version).\n",
       "\n",
       "Here is a practical example.\n",
-      ":ref:`Above <formula-vaccr>` we calculated the free-fall\n",
+      "Above we calculated the free-fall\n",
       "velocity onto MN Lup like this"
      ]
     },
@@ -1466,8 +1460,7 @@
      "source": [
       "However, this raises a warning and automatically converts the quantity object\n",
       "to an numpy array and the unit is lost. If you believe that is a bug that should\n",
-      "be fixed, you might chose to report it in the `issue tracker\n",
-      "<http://github.com/astropy/astropy/issues>`_.\n",
+      "be fixed, you might chose to report it in the [issue tracker](http://github.com/astropy/astropy/issues).\n",
       "(But please check if somebody else has reported the same thing before, so we do\n",
       "not clutter the issue tracker needlessly.)"
      ]