Repository: kymatio/kymatio

Issue:
Enable texext in Sphinx
Enable the [texext](https://pypi.org/project/texext/) extension in Sphinx and convert all occurences of `` :math:`...` `` to `$...$`.


Discussion:

Resolving patch:
diff --git a/doc/source/conf.py b/doc/source/conf.py
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -14,6 +14,11 @@
 #
 import os
 import sys
+import kymatio
+from distutils.version import LooseVersion
+
+
+
 sys.path.insert(0, os.path.abspath('../../kymatio'))
 
 
@@ -25,9 +30,12 @@
 author = 'The Kymatio Developers'
 
 # The short X.Y version
-version = ''
+v = LooseVersion(kymatio.__version__).version
+
+version = ".".join(map(str, v[:2]))
+
 # The full version, including alpha/beta/rc tags
-release = ''
+release = kymatio.__version__
 
 
 # -- General configuration ---------------------------------------------------
@@ -49,8 +57,11 @@
     'sphinxcontrib.bibtex',
     'sphinx_gallery.gen_gallery',
     'sphinx.ext.napoleon',
+    'texext'
 ]
 
+html_favicon = '_static/kymatio.ico'
+
 # Add path to sphynx gallery
 sphinx_gallery_conf = {
     # path to your examples scripts
@@ -81,7 +92,7 @@
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = None
+language = 'en'
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
@@ -103,7 +114,21 @@
 # further.  For a list of options available for each theme, see the
 # documentation.
 #
-# html_theme_options = {}
+html_theme_options = {
+    'logo': 'kymatio.jpg',
+     'touch_icon': 'kymatio.jpg',
+    'logo_name':'Kymatio',
+    'description': 'Wavelet Scattering in PyTorch',
+    'github_button': True,
+    'github_type': 'star',
+    'travis_button': True,
+    'github_user': 'kymatio',
+    'github_repo': 'kymatio',
+    'github_banner': True,
+    'analytics_id': 'UA-130785726-1',
+    'font_family': '"Avenir Next", Avenir, "Helvetica Neue",Helvetica,Arial,sans-serif'
+
+}
 
 # 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,
@@ -173,7 +198,7 @@
 #  dir menu entry, description, category)
 texinfo_documents = [
     (master_doc, 'kymatio', 'kymatio Documentation',
-     author, 'kymatio', 'One line description of project.',
+     author, 'kymatio', 'Wavelet Scattering in PyTorch',
      'Miscellaneous'),
 ]
 
diff --git a/kymatio/scattering1d/scattering1d.py b/kymatio/scattering1d/scattering1d.py
--- a/kymatio/scattering1d/scattering1d.py
+++ b/kymatio/scattering1d/scattering1d.py
@@ -23,31 +23,28 @@ class Scattering1D(object):
     alternated with a complex modulus non-linearity. The scattering transform
     of a 1D signal :math:`x(t)` may be written as
 
-        :math:`S_J x = [S_J^{(0)} x, S_J^{(1)} x, S_J^{(2)} x]`
+        $S_J x = [S_J^{(0)} x, S_J^{(1)} x, S_J^{(2)} x]$
 
     where
 
-        :math:`S_J^{(0)} x(t) = x \\star \\phi_J(t)`,
+        $S_J^{(0)} x(t) = x \star \phi_J(t)$,
 
-        :math:`S_J^{(1)} x(t, \\lambda) =
-            |x \\star \\psi_\\lambda^{(1)}| \\star \\phi_J`, and
+        $S_J^{(1)} x(t, \lambda) =|x \star \psi_\lambda^{(1)}| \star \phi_J$, and
 
-        :math:`S_J^{(2)} x(t, \\lambda, \\mu) =
-            |\\,| x \\star \\psi_\\lambda^{(1)}|
-            \\star \\psi_\\mu^{(2)} | \\star \\phi_J`.
+        $S_J^{(2)} x(t, \lambda, \mu) = |\,| x \star \psi_\lambda^{(1)}| \star \psi_\mu^{(2)} | \star \phi_J$.
 
     In the above formulas, :math:`\\star` denotes convolution in time. The
-    filters :math:`\\psi_\\lambda^{(1)}(t)` and :math:`\\psi_\\mu^{(2)}(t)`
-    are analytic wavelets with center frequencies :math:`\\lambda` and
-    :math:`\\mu``, while :math:`\\phi_J(t)` is a real lowpass filter centered
+    filters $\psi_\lambda^{(1)}(t)$ and $\psi_\mu^{(2)}(t)$
+    are analytic wavelets with center frequencies $\lambda$ and
+    $\mu$, while $\phi_J(t)$ is a real lowpass filter centered
     at the zero frequency.
 
     The `Scattering1D` class implements the 1D scattering transform for a
     given set of filters whose parameters are specified at initialization.
     While the wavelets are fixed, other parameters may be changed after the
     object is created, such as whether to compute all of :math:`S_J^{(0)} x`,
-    :math:`S_J^{(1)} x`, and :math:`S_J^{(2)} x` or just :math:`S_J^{(0)} x`
-    and :math:`S_J^{(1)} x`.
+    $S_J^{(1)} x$, and $S_J^{(2)} x$ or just $S_J^{(0)} x$
+    and $S_J^{(1)} x$.
 
     The scattering transform may be computed on the CPU (the default) or a
     GPU, if available. A `Scattering1D` object may be transferred from one
diff --git a/kymatio/scattering3d/scattering3d.py b/kymatio/scattering3d/scattering3d.py
--- a/kymatio/scattering3d/scattering3d.py
+++ b/kymatio/scattering3d/scattering3d.py
@@ -200,7 +200,7 @@ def _rotation_covariant_convolution_and_modulus(self, input_array, l, j):
             tensor of the same size as input_array. It holds the output of
             the operation::
 
-            .. math::   \\sqrt{\\sum_m (\\text{input}_\\text{array} \\star \\psi_{j,l,m})^2)}
+            $\sqrt{\sum_m (\text{input}_\text{array} \star \psi_{j,l,m})^2)}$
 
             which is covariant to 3D translations and rotations
 
@@ -277,13 +277,13 @@ def forward(self, input_array, order_2=True, rotation_covariant=True,
             if set to False|True it also excludes|includes second order
             scattering coefficients (default: True).
         rotation_covariant: bool, optional
-            if set to True the first order moduli take the form::
+            if set to True the first order moduli take the form:
 
-            .. math:: \\sqrt(\\sum_m (input_array \\star \\psi_{j,l,m})^2))
+            $\sqrt{\sum_m (x \star \psi_{j,l,m})^2)}$
 
-            if set to False the first order moduli take the form::
+            if set to False the first order moduli take the form:
 
-            .. math:: input_array \\star \\psi_{j,l,m})
+            $x \star \psi_{j,l,m}$
 
             The second order moduli change analogously
             Defaut: True


Test patch: