Repository: mne-tools/mne-python

Issue:
Problems with installation instructions
I was following the installation guides for MacOS and then at [point 2](https://martinos.org/mne/stable/install_mne_python.html#get-mne-and-its-dependencies) I get the following error:

```sh
(base) Biancas-MacBook-Pro:~ bt_neurospin$ curl -0 https://raw.githubusercontent.com/mne-tools/mne-python/master/environment.yml
name: mne
channels:
- defaults
dependencies:
- python>=3.6
- pip
- mkl
- numpy
- scipy
- matplotlib
- cython
- pyqt>=5.9
- vtk>=8
- pandas
- xlrd
- scikit-learn
- h5py
- pillow
- statsmodels
- jupyter
- pytest
- pytest-cov
- pytest-mock
- pytest-timeout
- joblib
- psutil
- numpydoc
- flake8
- spyder
- numexpr
- traits>=4.6.0
- pyface>=6
- traitsui>=6
- testpath<0.4
- pip:
  - mne
  - https://api.github.com/repos/enthought/mayavi/zipball/b3fc35218dda9776d8f1a407663bfb49783dca12
  - PySurfer[save_movie]
  - dipy --only-binary dipy
  - nibabel
  - nilearn
  - neo
  - pytest-faulthandler
  - pydocstyle
  - codespell
  - python-picard
(base) Biancas-MacBook-Pro:~ bt_neurospin$ conda env create -f environment.yml

EnvironmentFileNotFound: '/Users/bt_neurospin/environment.yml' file not found

(base) Biancas-MacBook-Pro:~ bt_neurospin$ 
```


Discussion:
The problem is a typo in your command. It should be `curl -O blabla` (minus capital '0') not `curl -0` (minus 'zero'). The problem is that `conda env create -f` requires the `environment.yml` file and this one is not there because `curl -0` does not create the file but rather spits out the file in the console (thats why you see all those package names).

Just make sure that you copy paste this:
```sh
curl -O https://raw.githubusercontent.com/mne-tools/mne-python/master/environment.yml
conda env create -f environment.yml
conda activate mne
```


Maybe we should update our documentaiton to make sure this does not happen. Maybe we should modify our sinpped so that it can be copy pasted without any problem. 

The other option is to pass the curl to conda, so that the file is not even saved in the disc.

we could use something like this:

https://predictablynoisy.com/sphinx-copy-buttons
https://clipboardjs.com/

>

And ideally something to strip the `$` chars not appear in the copy-paste. There must be some HTML magic for this, and it seems like a use case people would have for sphinx.

In SciPy I think it's solved by having a little button that allows hiding the `>>>` chars in Python code.
This happen to me as well 
![image](https://user-images.githubusercontent.com/47141515/51911869-2c4fa700-23d3-11e9-9e81-991c4ca4751b.png)

we definitely need to improve this. Ie make it easier to copy-paste
and/or add a warning note.


Resolving patch:
diff --git a/mne/simulation/raw.py b/mne/simulation/raw.py
--- a/mne/simulation/raw.py
+++ b/mne/simulation/raw.py
@@ -139,7 +139,7 @@ def simulate_raw(raw, stc, trans, src, bem, cov='simple',
         orientations. Only used when surf_ori and/or force_fixed are True.
     forward : instance of Forward | None
         The forward operator to use. If None (default) it will be computed
-        using `bem`, `trans`, and `src`.
+        using ``bem``, ``trans``, and ``src``.
 
         .. versionadded:: 0.17
     duration : float | None
diff --git a/tutorials/plot_object_source_estimate.py b/tutorials/plot_object_source_estimate.py
--- a/tutorials/plot_object_source_estimate.py
+++ b/tutorials/plot_object_source_estimate.py
@@ -19,7 +19,7 @@
 It only stores the amplitudes of activations but
 not the locations of the sources. To get access to the locations
 you need to have the :class:`source space <mne.SourceSpaces>`
-(often abbreviated `src`) used to compute the
+(often abbreviated ``src``) used to compute the
 :class:`forward operator <mne.Forward>` (often abbreviated `fwd`).
 
 See :ref:`tut_forward` for more details on forward modeling, and


Test patch: