Small refactoring

Author: socketpair

about.rst

@@ -1,8 +1,14 @@
-==============
-О документации
-==============
+=================
+Об этом документе
+=================
 
-Эта документация собирает в себе опыт использования `Ceph <https://ceph.com>`_ несколькими специалистами.
-Вы можете улучшить её, задать вопрос `на GitHub <https://github.com/socketpair/ceph-docs>`_.
+Эта документация собирает в себе опыт использования
+`Ceph <https://ceph.com>`_ несколькими специалистами.
+Вы можете улучшить её, задав вопрос `на GitHub <https://github.com/socketpair/ceph-docs>`_,
+либо создав зull-request с исправлениями.
 
-Также, активное обсуждение вопросов о CEPH ведётся в `telegram-группе <https://t.me/ceph_ru>`_.
+Также, активное обсуждение вопросов о Ceph ведётся в
+`telegram-группе <https://t.me/ceph_ru>`_.
+
+Мэйнтенйнером проекта является Коренберг Марк
+`[email protected] <mailto: [email protected]>`_.

conf.py

@@ -1,32 +1,5 @@
 #!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-#
-# Ceph FAQ documentation build configuration file, created by
-# sphinx-quickstart on Tue Jan  9 00:19:55 2018.
-#
-# This file is execfile()d with the current directory set to its
-# containing dir.
-#
-# Note that not all possible configuration values are present in this
-# autogenerated file.
-#
-# All configuration values have a default; values that are commented out
-# serve to show the default.
-
-# If extensions (or modules to document with autodoc) are in another directory,
-# add these directories to sys.path here. If the directory is relative to the
-# documentation root, use os.path.abspath to make it absolute, like shown here.
-#
-# import os
-# import sys
-# sys.path.insert(0, os.path.abspath('.'))
-
-
-# -- General configuration ------------------------------------------------
-
-# If your documentation needs a minimal Sphinx version, state it here.
-#
-# needs_sphinx = '1.0'
+import datetime
 
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
@@ -38,20 +11,13 @@
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
-
-# The suffix(es) of source filenames.
-# You can specify multiple suffix as a list of string:
-#
-# source_suffix = ['.rst', '.md']
 source_suffix = '.rst'
-
-# The master toctree document.
 master_doc = 'index'
 
 # General information about the project.
-#project = 'Ceph FAQ'
-# copyright = '2018, Korenberg Mark'
+project = 'Заметки о Ceph'
 author = 'Коренберг Марк'
+copyright = '%d, %s' % (datetime.datetime.now().year, author)
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
@@ -61,21 +27,16 @@
 version = '1.0'
 # The full version, including alpha/beta/rc tags.
 release = '1.0'
-
-# The language for content autogenerated by Sphinx. Refer to documentation
-# for a list of supported languages.
-#
-# This is also used if you do content translation via gettext catalogs.
-# Usually you set "language" from the command line for these cases.
 language = 'ru'
 
 html_theme = "sphinx_rtd_theme"
 html_static_path = ['_static']
-# Output file base name for HTML help builder.
 htmlhelp_basename = 'CephFAQdoc'
-
-
-# -- Options for LaTeX output ---------------------------------------------
+# https://sphinx-rtd-theme.readthedocs.io/en/latest/
+html_show_sourcelink = False
+html_theme_options = {
+    'display_version': False,
+}
 
 latex_elements = {
     # The paper size ('letterpaper' or 'a4paper').
@@ -99,40 +60,5 @@
 # (source start file, target name, title,
 #  author, documentclass [howto, manual, or own class]).
 latex_documents = [
-    (master_doc, 'CephFAQ.tex', 'Ceph FAQ Documentation',
-     'Korenberg Mark', 'manual'),
-]
-
-
-# -- Options for manual page output ---------------------------------------
-
-# One entry per manual page. List of tuples
-# (source start file, name, description, authors, manual section).
-man_pages = [
-    (master_doc, 'cephfaq', 'Ceph FAQ Documentation',
-     [author], 1)
-]
-
-
-# -- Options for Texinfo output -------------------------------------------
-
-# Grouping the document tree into Texinfo files. List of tuples
-# (source start file, target name, title, author,
-#  dir menu entry, description, category)
-texinfo_documents = [
-    (master_doc, 'CephFAQ', 'Ceph FAQ Documentation',
-     author, 'CephFAQ', 'One line description of project.',
-     'Miscellaneous'),
+    (master_doc, 'CephFAQ.tex', project, author, 'manual'),
 ]
-
-
-
-
-# Example configuration for intersphinx: refer to the Python standard library.
-intersphinx_mapping = {'https://docs.python.org/': None}
-
-# https://sphinx-rtd-theme.readthedocs.io/en/latest/
-html_show_sourcelink = False
-html_theme_options = {
-    'display_version': False,
-}