Using the same theme for development and deployment.

CONTRIBUTING.rst

@@ -3,4 +3,5 @@ Jak přispívat?
 
 - `GitHub repozitář <https://github.com/pyvec/guide>`_
 - Příručka je napsána v `reStructuredText <https://en.wikipedia.org/wiki/ReStructuredText>`_ a postavená nad `Sphinx <http://sphinx-doc.org/>`_ a `Read the Docs <https://readthedocs.org/>`_.
-- Po naklonování repozitáře stačí nainstalovat závislosti z ``requirements.txt`` a potom lze dokumentaci vytvořit přes ``make html``.
+- Po naklonování repozitáře stačí nainstalovat závislosti z ``requirements.txt`` a potom lze HTML vytvořit přes ``make html``.
+- Prohlédnout si výsledek lze tak, že si nad vygenerovaným HTML spustíme server pomocí ``cd ./_build/html/ && python -m http.server`` a potom se v prohlížeči podíváme na adresu ``http://localhost:8000/``.

conf.py

@@ -111,7 +111,7 @@
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = 'default'
+# html_theme = 'default'
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
@@ -205,6 +205,14 @@
 # Output file base name for HTML help builder.
 htmlhelp_basename = 'guide-doc'
 
+# Using ReadTheDocs theme just for local development
+on_rtd = os.environ.get('READTHEDOCS', None) == 'True'
+if not on_rtd:  # only import and set the theme if we're building docs locally
+    import sphinx_rtd_theme
+    html_theme = 'sphinx_rtd_theme'
+    html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
+
+
 # -- Options for LaTeX output ---------------------------------------------
 
 latex_elements = {

guides/meetup.rst

@@ -217,8 +217,6 @@ Přicházím na místo konání
     - redukci pro Mac (záleží i na projektoru).
 
 **Domluva s obsluhou**
-    S obsluhou si předem domluv, jak bude vypadat průběh akce a placení.
-
     Pokud máte salonek se zavíracími dveřmi, je možné obsluze říct, aby chodila jen pokud jsou otevřené (o přestávkách mezi přednáškami). S tím jak si návštěvníci objednávají, tak je takové pravidlo docela těžké dodržet. Nejlepší je asi moc to neřešit a klidně nechat přednášku přerušit obsluhou - přece jenom jsme na Pyvu a ne na velevážném kongresu státníků.
 
     Pokud v salonku hraje hudba, je potřeba ji nechat na přednášky vypnout. I když je velice potichu, hodně to ruší. Stejně tak může být problematické některé osvětlení.

requirements.txt

@@ -1,2 +1,3 @@
 sphinx
 sphinx-autobuild
+sphinx_rtd_theme