sphinx构建内部文档Wiki系统

sphinx介绍：http://www.sphinx-doc.org/en/stable/

文档编辑流程：

#pandoc -s "F:\svn\Doc\extmail.docx" -t markdown -o F:\svn\Doc\extmail.
md
#pandoc F:\svn\Doc\extmail.md --from markdown --to rst -s -o F:\svn\Doc
\extmail.rst
1、编辑build文件夹内容
2、修改build/index.rst内容
3、运行make html即可

效果：

index.rst源码：

.. ******Wiki documentation master file, created by
   sphinx-quickstart on Fri Mar  3 16:42:22 2017.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Welcome to ******Wiki's documentation!
============================================

.. toctree::
   :maxdepth: 3

   extmail
   rocketMQ安装
   SVN备份恢复日志管理
   ******发包流程文档

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`

 

转载于:https://blog.51cto.com/strongit/1905073