gh-12 Табы с разными вариантами получения исходников

README.md

@@ -30,6 +30,9 @@ pip install -r requirements.txt
 
 cd ./docs
 make html
-
-your-browser ./build/html/index.html
 ```
+
+#### Откройте документацию в браузере
+GNU/linux ``` $ xdg-open ./build/html/index.html```  
+macOS ```$ open ./build/html/index.html```  
+Windows - откройте `./build/html/index.html` в вашем браузере

docs/source/conf.py

@@ -35,7 +35,9 @@
               'sphinx.ext.todo',
               'sphinx.ext.mathjax',
               'sphinx.ext.ifconfig',
-              'sphinx.ext.viewcode']
+              'sphinx.ext.viewcode',
+              'sphinx_tabs.tabs',
+              ]
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']

docs/source/development/install.rst

@@ -23,10 +23,24 @@
    mkdir ./the-tale-project
    cd ./the-tale-project
 
-   git clone https://github.com/Tiendil/the-tale.git
-   git clone https://github.com/Tiendil/deworld.git
-   git clone https://github.com/Tiendil/dext.git
-   git clone https://github.com/Tiendil/questgen.git
+.. tabs::
+
+   .. code-tab:: Bash Clone with HTTPS
+
+      git clone https://github.com/Tiendil/the-tale.git
+      git clone https://github.com/Tiendil/deworld.git
+      git clone https://github.com/Tiendil/dext.git
+      git clone https://github.com/Tiendil/questgen.git
+
+
+   .. code-tab:: Bash Clone with SSH
+
+      git clone git@github.com:the-tale/the-tale.git
+      git clone git@github.com:the-tale/deworld.git
+      git clone git@github.com:Tiendil/dext.git
+      git clone git@github.com:the-tale/questgen.git
+
+.. code-block:: bash
 
    # при необходимости переключаем репозитории в ветки develop
 

requirements.txt

@@ -1,3 +1,4 @@
 sphinx==1.6.5
 sphinx-autobuild==0.7.1
 sphinx-rtd-theme==0.2.4
+sphinx-tabs==1.1.11