216 lines
7.0 KiB
Python
216 lines
7.0 KiB
Python
# -*- coding: utf-8 -*-
|
||
import os
|
||
import sys
|
||
from datetime import date
|
||
from sphinx.util import logging
|
||
import recommonmark
|
||
from recommonmark.transform import AutoStructify
|
||
from sphinx_scylladb_theme.utils import multiversion_regex_builder
|
||
|
||
logger = logging.getLogger(__name__)
|
||
sys.path.insert(0, os.path.abspath('..'))
|
||
|
||
# -- General configuration ------------------------------------------------
|
||
|
||
# If your documentation needs a minimal Sphinx version, state it here.
|
||
#
|
||
needs_sphinx = '1.8'
|
||
|
||
# Add any Sphinx extension module names here, as strings. They can be
|
||
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
|
||
# ones.
|
||
extensions = [
|
||
'sphinx.ext.todo',
|
||
'sphinx.ext.mathjax',
|
||
'sphinx.ext.githubpages',
|
||
'sphinx.ext.extlinks',
|
||
'sphinx_scylladb_theme',
|
||
'sphinx_multiversion',
|
||
'recommonmark',
|
||
'sphinx_markdown_tables',
|
||
]
|
||
|
||
# The suffix(es) of source filenames.
|
||
# You can specify multiple suffix as a list of string:
|
||
#
|
||
source_suffix = ['.rst', '.md']
|
||
autosectionlabel_prefix_document = True
|
||
|
||
# The encoding of source files.
|
||
#
|
||
# source_encoding = 'utf-8-sig'
|
||
|
||
# The master toctree document.
|
||
master_doc = 'contents'
|
||
|
||
# General information about the project.
|
||
project = 'Scylla Documentation'
|
||
copyright = str(date.today().year) + ', ScyllaDB. All rights reserved.'
|
||
author = u'Scylla Project Contributors'
|
||
|
||
# The version info for the project you're documenting, acts as replacement for
|
||
# |version| and |release|, also used in various other places throughout the
|
||
# built documents.
|
||
#
|
||
# The short X.Y version.
|
||
version = u'4.3'
|
||
# The full version, including alpha/beta/rc tags.
|
||
release = u'4.3.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 = None
|
||
|
||
# List of patterns, relative to source directory, that match files and
|
||
# directories to ignore when looking for source files.
|
||
# This patterns also effect to html_static_path and html_extra_path
|
||
exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store', 'lib', 'lib64','**/_common/*', 'README.md', '.git', '.github', '_utils', '_templates', 'rst_include']
|
||
|
||
# The name of the Pygments (syntax highlighting) style to use.
|
||
pygments_style = 'sphinx'
|
||
|
||
# If true, `todo` and `todoList` produce output, else they produce nothing.
|
||
todo_include_todos = True
|
||
|
||
# Setup Sphinx
|
||
def setup(sphinx):
|
||
sphinx.add_config_value('recommonmark_config', {
|
||
'enable_eval_rst': True,
|
||
'enable_auto_toc_tree': False,
|
||
}, True)
|
||
sphinx.add_transform(AutoStructify)
|
||
|
||
# Custom lexer
|
||
from pygments.lexers.shell import BashLexer
|
||
from sphinx.highlighting import lexers
|
||
|
||
class CqlLexer(BashLexer):
|
||
pass
|
||
lexers['cql'] = CqlLexer(startinline=True)
|
||
|
||
# Inline substitutions
|
||
rst_prolog = """
|
||
.. |mon_version| replace:: 3.1
|
||
"""
|
||
|
||
# -- Options for HTML output ----------------------------------------------
|
||
|
||
# The theme to use for HTML and HTML Help pages. See the documentation for
|
||
# a list of builtin themes.
|
||
#
|
||
html_theme = 'sphinx_scylladb_theme'
|
||
html_theme_path = ["../.."]
|
||
html_style = ''
|
||
|
||
# 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
|
||
# documentation.
|
||
#
|
||
html_theme_options = {
|
||
'header_links': [
|
||
('Scylla Developer Notes', 'https://scylla.docs.scylladb.com'),
|
||
('Scylla University', 'https://university.scylladb.com/'),
|
||
('ScyllaDB Home', 'https://www.scylladb.com/')],
|
||
'github_issues_repository': 'scylladb/scylla',
|
||
'hide_version_dropdown': ['master'],
|
||
'default_branch': 'stable',
|
||
'show_sidebar_index': True,
|
||
}
|
||
|
||
extlinks = {}
|
||
|
||
# If not None, a 'Last updated on:' timestamp is inserted at every page
|
||
# bottom, using the given strftime format.
|
||
# The empty string is equivalent to '%b %d, %Y'.
|
||
#
|
||
html_last_updated_fmt = '%d %B %Y'
|
||
|
||
# Custom sidebar templates, maps document names to template names.
|
||
#
|
||
html_sidebars = {'**': ['side-nav.html']}
|
||
|
||
# Output file base name for HTML help builder.
|
||
htmlhelp_basename = 'ScyllaDocumentationdoc'
|
||
|
||
# URL which points to the root of the HTML documentation.
|
||
html_baseurl = 'https://scylla.docs.scylladb.com'
|
||
|
||
# Dictionary of values to pass into the template engine’s context for all pages
|
||
html_context = {'html_baseurl': html_baseurl}
|
||
|
||
# -- Options for not found extension -------------------------------------------
|
||
|
||
# Template used to render the 404.html generated by this extension.
|
||
notfound_template = '404.html'
|
||
|
||
# Prefix added to all the URLs generated in the 404 page.
|
||
notfound_urls_prefix = ''
|
||
|
||
# -- Options for redirect extension ---------------------------------------
|
||
|
||
# Read a YAML dictionary of redirections and generate an HTML file for each
|
||
redirects_file = "_utils/redirections.yaml"
|
||
|
||
# -- Options for multiversion extension ----------------------------------
|
||
# Whitelist pattern for tags (set to None to ignore all tags)
|
||
TAGS = []
|
||
smv_tag_whitelist = multiversion_regex_builder(TAGS)
|
||
# Whitelist pattern for branches (set to None to ignore all branches)
|
||
BRANCHES = ['branch-4.4', 'branch-4.5', 'master']
|
||
smv_branch_whitelist = multiversion_regex_builder(BRANCHES)
|
||
# Defines which version is considered to be the latest stable version.
|
||
smv_latest_version = 'branch-4.4'
|
||
smv_rename_latest_version = 'stable'
|
||
# Must be listed in smv_tag_whitelist or smv_branch_whitelist.
|
||
# Whitelist pattern for remotes (set to None to use local branches only)
|
||
smv_remote_whitelist = r"^origin$"
|
||
# Pattern for released versions
|
||
smv_released_pattern = r'^tags/.*$'
|
||
# Format for versioned output directories inside the build directory
|
||
smv_outputdir_format = '{ref.name}'
|
||
|
||
|
||
# -- Options for LaTeX page output ---------------------------------------
|
||
|
||
# Grouping the document tree into LaTeX files. List of tuples
|
||
# (source start file, target name, title,
|
||
# author, documentclass [howto, manual, or own class]).
|
||
latex_documents = [
|
||
(master_doc, 'ScyllaDocumentation.tex', u'Scylla Documentation',
|
||
u'Scylla Project Contributors', '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, 'scylladocumentation', u'Scylla 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, 'ScyllaDocumentation', u'Scylla Documentation',
|
||
author, 'ScyllaDocumentation', 'One line description of project.',
|
||
'Miscellaneous'),
|
||
]
|
||
|
||
# -- Options for Epub output ----------------------------------------------
|
||
|
||
# Bibliographic Dublin Core info.
|
||
epub_title = project
|
||
epub_author = author
|
||
epub_publisher = author
|
||
epub_copyright = copyright
|
||
|
||
# A list of files that should not be packed into the epub file.
|
||
epub_exclude_files = ['search.html']
|