我刚刚用sphinx-quickstart.exe
和alabaster
主题创建了一个Sphinx文档。你知道吗
我想把文件的版本印在标题的某个地方。你知道吗
我在conf.py
中填充了version
和release
变量
# -*- coding: utf-8 -*-
#
# Configuration file for the Sphinx documentation builder.
# -- Project information -----------------------------------------------------
project = 'MWE'
copyright = '2019, and1er'
author = 'and1er'
# The short X.Y version
version = '2.4.12'
# The full version, including alpha/beta/rc tags
release = 'beta'
extensions = [
]
templates_path = ['_templates']
source_suffix = '.rst'
master_doc = 'index'
language = None
exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
pygments_style = 'sphinx'
html_theme = 'alabaster'
html_static_path = ['_static']
htmlhelp_basename = 'MWEdoc'
index.rst
.. MWE documentation master file, created by
sphinx-quickstart on Tue Feb 5 14:51:07 2019.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
Welcome to MWE's documentation!
===============================
.. toctree::
:maxdepth: 2
:caption: Contents:
Indices and tables
==================
* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`
结果文档没有2.4.12
或beta
字符串。你知道吗
|version|
substitution对你有用吗?你知道吗升级版 更新的MWE
index.rst
除了@Slam提到的替换之外,您还可以避免为项目的
conf.py
中的每个版本手动更新此设置。你知道吗然后
|release|
可以放在reST源文件中,或者{{ release }}
放在主题的模板中。你知道吗相关问题 更多 >
编程相关推荐