MRG: More doc cleanups (#5813)

* FIX: More doc cleanups

* FIX: No source

Author: larsoner

doc/_templates/class.rst renamed to doc/_templates/autosummary/class.rst

@@ -126,7 +126,7 @@
 
 # The reST default role (used for this markup: `text`) to use for all
 # documents.
-#default_role = None
+default_role = "autolink"
 
 # If true, '()' will be appended to :func: etc. cross-reference text.
 #add_function_parentheses = True
@@ -231,6 +231,7 @@
 
 # If true, links to the reST sources are added to the pages.
 html_show_sourcelink = False
+html_copy_source = False
 
 # If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
 html_show_sphinx = False

doc/_templates/function.rst renamed to doc/_templates/autosummary/function.rst

@@ -59,17 +59,17 @@ MNE-Python core terminology and general concepts
         stim channel.
 
     first_samp
-        The attribute of raw objects called `first_samp` is an integer that
+        The attribute of raw objects called ``first_samp`` is an integer that
         refers to the number of time samples passed between the onset of the
         acquisition system and the time when data started to be written
         on disk. This is a specificity of the Vectorview MEG systems (fif files)
         but for consistency it is available for all file formats in MNE.
         One benefit of this system is that croppping data only boils
-        down to a change of the `first_samp` attribute to know when cropped data
+        down to a change of the ``first_samp`` attribute to know when cropped data
         was acquired.
 
     info
-        Also called `measurements info`, it is a collection of metadata regarding
+        Also called ``measurement info``, it is a collection of metadata regarding
         a Raw, Epochs or Evoked object; e.g.,
         channel locations and types, sampling frequency,
         preprocessing history such as filters ...
@@ -82,7 +82,7 @@ MNE-Python core terminology and general concepts
 
     montage
         EEG channel names and the relative positions of the sensor w.r.t. the scalp.
-        See :class:`Montage <channels.Montage>` for the API of the corresponding object
+        See :class:`~channels.Montage` for the API of the corresponding object
         class.
 
     morphing
@@ -94,26 +94,26 @@ MNE-Python core terminology and general concepts
     pick
         An integer that is the index of a channel in the measurement info.
         It allows to obtain the information on a channel in the list of channels
-        available in `info['chs']`.
+        available in ``info['chs']``.
 
-    projector, (abbr. `proj`)
+    projector, (abbr. ``proj``)
         A projector, also referred to a Signal Suspace Projection (SSP), defines
         a linear operation applied spatially to EEG or MEG data. You can see
         this as a matrix multiplication that reduces the rank of the data by
         projecting it to a lower dimensional subspace. Such a projection
         operator is applied to both the data and the forward operator for
         source localization. Note that EEG average referencing can be done
         using such a projection operator. It is stored in the measurement
-        info in `info['projs']`.
+        info in ``info['projs']``.
 
     raw
         It corresponds to continuous data (preprocessed or not). One typically
         manipulates raw data when reading recordings in a file on disk.
-        See :class:`RawArray <io.RawArray>` for the API of the corresponding
+        See :class:`~io.RawArray` for the API of the corresponding
         object class, and :ref:`sphx_glr_auto_tutorials_plot_object_raw.py` for a
         narrative overview.
 
-    source space (abbr. `src`)
+    source space (abbr. ``src``)
         A source space specifies where in the brain one wants to estimate the
         source amplitudes. It corresponds to locations of a set of
         candidate equivalent current dipoles (ECD). MNE mostly works
@@ -124,7 +124,7 @@ MNE-Python core terminology and general concepts
         See :class:`SourceSpaces` for the API of the corresponding
         object class.
 
-    source estimates (abbr. `stc`)
+    source estimates (abbr. ``stc``)
         Source estimates, commonly referred to as STC (Source Time Courses),
         are obtained from source localization methods,
         such as dSPM, sLORETA, LCMV or MxNE.
@@ -144,7 +144,7 @@ MNE-Python core terminology and general concepts
         A stim channel, a.k.a. trigger channel, is a channel that encodes events
         during the recording. It is typically a channel that is always zero and that
         takes positive values when something happens such as the onset of a stimulus.
-        Classical names for stim channels is `STI 014` or `STI 101`.
+        Classical names for stim channels is ``STI 014`` or ``STI 101``.
         So-called events arrays are obtained from stim channels.
 
     trans