支持多版本构建

.gitignore

-.idea/*
+.idea/
+*.pyc
+Pipfile
+test*
+build

baidu_verify_code-RTymycLNbm.html

+50d1eeccda5a29142f1203ab740b1df0
\ No newline at end of file

requirements.txt

@@ -39,3 +39,4 @@ sphinxcontrib-jsmath==1.0.1
 sphinxcontrib-qthelp==1.0.2
 sphinxcontrib-serializinghtml==1.1.3
 sphinx-sitemap==2.2.0
+sphinx-multiversion==0.2.4

source/_templates/versions.html

+{%- if current_version %}
+<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
+  <span class="rst-current-version" data-toggle="rst-current-version">
+    <span class="fa fa-book"> Other Versions</span>
+    v: {{ current_version.name }}
+    <span class="fa fa-caret-down"></span>
+  </span>
+  <div class="rst-other-versions">
+    {%- if versions.tags %}
+    <dl>
+      <dt>Tags</dt>
+      {%- for item in versions.tags %}
+      <dd><a href="{{ item.url }}">{{ item.name }}</a></dd>
+      {%- endfor %}
+    </dl>
+    {%- endif %}
+    {%- if versions.branches %}
+    <dl>
+      <dt>Branches</dt>
+      {%- for item in versions.branches %}
+      <dd><a href="{{ item.url }}">{{ item.name }}</a></dd>
+      {%- endfor %}
+    </dl>
+    {%- endif %}
+  </div>
+</div>
+{%- endif %}

source/conf.py

@@ -28,7 +28,7 @@ import os
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
-extensions = ['chinese_search','sphinx.ext.mathjax']
+extensions = ['chinese_search','sphinx.ext.mathjax','sphinx_sitemap', 'sphinx_multiversion']
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
@@ -151,3 +151,12 @@ version = '1.0'
 disqus_shortname = 'iswbm'  # Add this line to conf.py.
 html_baseurl = 'http://python.iswbm.com'
 html_extra_path = ["robots.txt"]
+
+html_sidebars = {
+    '**': [
+        'versioning.html',
+    ],
+}
+
+smv_latest_version = 'master'
+sitemap_url_scheme = "{link}"