From 510cf248fb688f787e35f0b9c1ed96f3ede549dc Mon Sep 17 00:00:00 2001 From: OpenTelekomCloud Proposal Bot Date: Mon, 5 Sep 2022 16:18:58 +0000 Subject: [PATCH] Update content --- api-ref/source/_static/.placeholder | 0 api-ref/source/conf.py | 110 +++++++++++++++++----------- api-ref/source/docutils.conf | 2 + api-ref/source/index.rst | 8 +- 4 files changed, 74 insertions(+), 46 deletions(-) create mode 100644 api-ref/source/_static/.placeholder mode change 100755 => 100644 api-ref/source/conf.py create mode 100644 api-ref/source/docutils.conf diff --git a/api-ref/source/_static/.placeholder b/api-ref/source/_static/.placeholder new file mode 100644 index 0000000..e69de29 diff --git a/api-ref/source/conf.py b/api-ref/source/conf.py old mode 100755 new mode 100644 index 6f07e52..f2d9eb0 --- a/api-ref/source/conf.py +++ b/api-ref/source/conf.py @@ -1,75 +1,99 @@ -# -*- coding: utf-8 -*- -# Licensed under the Apache License, Version 2.0 (the "License"); -# you may not use this file except in compliance with the License. -# You may obtain a copy of the License at +# Licensed under the Apache License, Version 2.0 (the "License"); you may +# not use this file except in compliance with the License. You may obtain +# a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software -# distributed under the License is distributed on an "AS IS" BASIS, -# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or -# implied. -# See the License for the specific language governing permissions and -# limitations under the License. +# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +# License for the specific language governing permissions and limitations +# under the License. +# +# !!! +# This file is generated out of template in doc-exports repository. +# Beware overwriting it locally. import os import sys -sys.path.insert(0, os.path.abspath('../..')) +extensions = [ + 'otcdocstheme' +] + +otcdocs_auto_name = False +otcdocs_auto_version = False + +project = 'GaussDB Enterprise-class Distributed Database compatible with MySQL +' +otcdocs_repo_name = 'docs/gaussdb-mysql' + +# 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. +sys.path.insert(0, os.path.abspath('../../')) +sys.path.insert(0, os.path.abspath('../')) +sys.path.insert(0, os.path.abspath('./')) + # -- General configuration ---------------------------------------------------- # 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.autodoc', - 'otcdocstheme', -] - -# autodoc generation is a bit aggressive and a nuisance when doing heavy -# text edit cycles. -# execute "export SPHINX_DEBUG=1" in your terminal to disable # The suffix of source filenames. source_suffix = '.rst' +# The encoding of source files. +# +source_encoding = 'utf-8' + # The master toctree document. master_doc = 'index' # General information about the project. -project = 'gaussdb-mysql' -copyright = '2022, Open Telekom Cloud Developers' +copyright = u'2022-present, Open Telekom Cloud' -# If true, '()' will be appended to :func: etc. cross-reference text. -add_function_parentheses = True +# The language for content autogenerated by Sphinx. Refer to documentation +# for a list of supported languages. +# +language = 'en' -# If true, the current module name will be prepended to all description -# unit titles (such as .. function::). -add_module_names = True - -# The name of the Pygments (syntax highlighting) style to use. -pygments_style = 'native' +# If true, sectionauthor and moduleauthor directives will be shown in the +# output. They are ignored by default. +show_authors = False # -- Options for HTML output -------------------------------------------------- # The theme to use for HTML and HTML Help pages. Major themes that come with # Sphinx are currently 'default' and 'sphinxdoc'. # html_theme_path = ["."] -# html_theme = '_theme' -# html_static_path = ['static'] html_theme = 'otcdocs' -# Output file base name for HTML help builder. -htmlhelp_basename = '%sdoc' % project +# 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 = { + 'disable_search': True, + 'site_name': 'Internal Documentation Portal' +} -# Grouping the document tree into LaTeX files. List of tuples -# (source start file, target name, title, author, documentclass -# [howto/manual]). +# The name for this set of Sphinx documents. If None, it defaults to +# " v documentation". + +html_title = "GaussDB Enterprise-class Distributed Database compatible with MySQL + - API Reference" + + +# Add any paths that contain custom static files (such as style sheets) here, +# relative to this directory. They are copied after the builtin static files, +# so a file named "default.css" will overwrite the builtin "default.css". +html_static_path = ['_static'] + +# -- Options for PDF output -------------------------------------------------- latex_documents = [ - ('index', - '%s.tex' % project, - '%s Documentation' % project, - 'Open Telekom Cloud Developers', 'manual'), -] - -# Example configuration for intersphinx: refer to the Python standard library. -#intersphinx_mapping = {'http://docs.python.org/': None} +('index', + 'gaussdb_mysql-api-ref.tex', + u'GaussDB Enterprise-class Distributed Database compatible with MySQL + - API Reference', + u'OpenTelekomCloud', 'manual'), +] \ No newline at end of file diff --git a/api-ref/source/docutils.conf b/api-ref/source/docutils.conf new file mode 100644 index 0000000..7cbe4c1 --- /dev/null +++ b/api-ref/source/docutils.conf @@ -0,0 +1,2 @@ +[html writers] +table-style: table, caption-top \ No newline at end of file diff --git a/api-ref/source/index.rst b/api-ref/source/index.rst index 44ca61e..8cc75b2 100644 --- a/api-ref/source/index.rst +++ b/api-ref/source/index.rst @@ -1,3 +1,5 @@ -============================================= -Welcome to the documentation of gaussdb-mysql -============================================= +==================================================================================== +GaussDB Enterprise-class Distributed Database compatible with MySQL + - API Reference +==================================================================================== +