151 lines
4.8 KiB
Python
151 lines
4.8 KiB
Python
# -*- coding: utf-8 -*-
|
||
import os
|
||
import sys
|
||
from datetime import date
|
||
import recommonmark
|
||
from recommonmark.transform import AutoStructify
|
||
from pygments.lexers.javascript import JavascriptLexer
|
||
from sphinx_scylladb_theme.utils import multiversion_regex_builder
|
||
|
||
sys.path.insert(0, os.path.abspath('..'))
|
||
|
||
# -- General configuration ------------------------------------------------
|
||
|
||
# Build documentation for the following tags and branches
|
||
TAGS = []
|
||
BRANCHES = ['branch-4.5', 'branch-4.6', 'master']
|
||
# Set the latest version.
|
||
LATEST_VERSION = 'branch-4.6'
|
||
# Set which versions are not released yet.
|
||
UNSTABLE_VERSIONS = ['master']
|
||
# Set which versions are deprecated
|
||
DEPRECATED_VERSIONS = ['']
|
||
|
||
# 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_sitemap',
|
||
'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 master toctree document.
|
||
master_doc = 'contents'
|
||
|
||
# General information about the project.
|
||
project = 'Scylla Dev'
|
||
copyright = str(date.today().year) + ', ScyllaDB. All rights reserved.'
|
||
author = u'Scylla Project Contributors'
|
||
|
||
# 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', 'README.md', '_utils']
|
||
|
||
# The name of the Pygments (syntax highlighting) style to use.
|
||
pygments_style = 'sphinx'
|
||
|
||
# -- 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
|
||
smv_tag_whitelist = multiversion_regex_builder(TAGS)
|
||
# Whitelist pattern for branches
|
||
smv_branch_whitelist = multiversion_regex_builder(BRANCHES)
|
||
# Defines which version is considered to be the latest stable version.
|
||
smv_latest_version = LATEST_VERSION
|
||
# Defines the new name for the latest version.
|
||
smv_rename_latest_version = 'stable'
|
||
# 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 sitemap extension ---------------------------------------
|
||
|
||
sitemap_url_scheme = 'stable/{link}'
|
||
|
||
# -- 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'
|
||
|
||
# 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 = {
|
||
'conf_py_path': 'docs/',
|
||
'default_branch': 'master',
|
||
'github_repository': 'scylladb/scylla',
|
||
'github_issues_repository': 'scylladb/scylla',
|
||
'hide_edit_this_page_button': 'false',
|
||
'hide_version_dropdown': ['master'],
|
||
'versions_unstable': UNSTABLE_VERSIONS,
|
||
'versions_deprecated': DEPRECATED_VERSIONS,
|
||
}
|
||
|
||
# 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}
|
||
|
||
|
||
class AssemblyScriptLexer(JavascriptLexer):
|
||
pass
|
||
|
||
# Setup Sphinx
|
||
def setup(sphinx):
|
||
# Add Markdown support
|
||
sphinx.add_config_value('recommonmark_config', {
|
||
'enable_eval_rst': True,
|
||
'enable_auto_toc_tree': False,
|
||
}, True)
|
||
sphinx.add_transform(AutoStructify)
|
||
|
||
# Custom lexers
|
||
sphinx.add_lexer('assemblyscript', AssemblyScriptLexer)
|
||
|