docs→rtfd

rtfd/public/sphinx/configure.rst

@@ -0,0 +1,76 @@
+Configure documentation
+=======================
+
+* conf.py
+
+Sphinx
+------
+
+.. code:: python3
+
+ author = 'Author'
+ copyright = ''
+ extensions = [
+     'sphinx.ext.autodoc',
+     'sphinx.ext.doctest',
+     'sphinx.ext.todo',
+     'sphinx.ext.imgmath',
+     'sphinx.ext.ifconfig',
+     'sphinx.ext.viewcode',
+ ]
+ keep_warnings = False
+ language = 'en'
+ master_doc = 'index'
+ project = 'Project'
+ pygments_style = 'sphinx'
+ release = ''
+ show_authors = False
+ smartquotes = False
+ source_suffix = [
+     '.rst',
+ ]
+ todo_include_todos = True
+ version = ''
+
+HTML
+----
+
+.. code:: python3
+
+ html_show_copyright = False
+ html_show_sourcelink = True
+ html_show_sphinx = False
+ html_theme = 'sphinx_rtd_theme'
+ html_title = 'Title'
+
+MarkDown
+--------
+
+.. code:: python3
+
+ source_parsers = {
+     '.md': 'recommonmark.parser.CommonMarkParser',
+ }
+ source_suffix = ['.rst', '.md']
+
+LaTeX
+-----
+
+.. code:: python3
+
+ latex_elements = {
+     'fontenc': r'\usepackage{fontspec}',
+     'fontpkg': r'''
+ \setmainfont{DejaVu Serif}
+ \setsansfont{DejaVu Sans}
+ \setmonofont{DejaVu Sans Mono}
+ ''',
+     'papersize': 'a4paper',
+     'pointsize': '12pt',
+ }
+ latex_documents = [
+     (master_doc, 'FileName.tex', 'Title',
+      'Author', 'howto/manual'),
+ ]
+ latex_use_parts = False
+ latex_keep_old_macro_names = False