X-Git-Url: https://gerrit.fd.io/r/gitweb?a=blobdiff_plain;f=docs%2Fconf.py;h=6d8ed9ff0ac6d0a51dae2ae0236347612d532924;hb=0938eba153ed20b8a32b7278ed6301b45ce257cc;hp=17b4b786c3f5727a8e06ea254c0adb956dfac394;hpb=06dcd45ff81e06bc8cf40ed487c0b2652d346a5a;p=vpp.git diff --git a/docs/conf.py b/docs/conf.py index 17b4b786c3f..6d8ed9ff0ac 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -18,14 +18,14 @@ # -- Project information ----------------------------------------------------- -project = u'Vector Packet Processor' -copyright = u'2018, John DeNisco' +project = u'The Vector Packet Processor' +copyright = u'2018, Linux Foundation' author = u'John DeNisco' # The short X.Y version -version = u'' +version = u'master' # The full version, including alpha/beta/rc tags -release = u'0.1' +release = u'20.01' # -- General configuration --------------------------------------------------- @@ -40,18 +40,23 @@ release = u'0.1' extensions = [ 'sphinx.ext.autodoc', 'sphinx.ext.viewcode', -] + 'recommonmark'] + +# This is currently breaking the build +#### 'sphinxcontrib.spelling'] +spelling_word_list_filename = 'spelling_wordlist.txt' # 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_parsers = { - '.md': 'recommonmark.parser.CommonMarkParser', +source_suffix = { + '.rst': 'restructuredtext', + '.md': 'markdown' } + # The master toctree document. master_doc = 'index' @@ -104,6 +109,7 @@ html_logo = '_static/fd-io_red_white.png' # so a file named "default.css" will overwrite the builtin "default.css". html_static_path = ['_static'] + def setup(app): app.add_stylesheet('css/rules.css') @@ -148,7 +154,8 @@ latex_elements = { # (source start file, target name, title, # author, documentclass [howto, manual, or own class]). latex_documents = [ - (master_doc, 'Vector Packet Processor.tex', u'Vector Packet Processor Documentation', + (master_doc, 'Vector Packet Processor.tex', + u'Vector Packet Processor Documentation', u'John DeNisco', 'manual'), ] @@ -158,7 +165,8 @@ latex_documents = [ # One entry per manual page. List of tuples # (source start file, name, description, authors, manual section). man_pages = [ - (master_doc, 'Vector Packet Processor', u'Vector Packet Processor Documentation', + (master_doc, 'Vector Packet Processor', + u'Vector Packet Processor Documentation', [author], 1) ] @@ -169,7 +177,8 @@ man_pages = [ # (source start file, target name, title, author, # dir menu entry, description, category) texinfo_documents = [ - (master_doc, 'Vector Packet Processor', u'Vector Packet Processor Documentation', + (master_doc, 'Vector Packet Processor', + u'Vector Packet Processor Documentation', author, 'Vector Packet Processor', 'One line description of project.', 'Miscellaneous'), ]