在Ubuntu 14.04 64bit上使用Sphinx转换MonaServer项目文档

柔光的暖阳◎ 2022-08-08 05:19 6阅读 0赞

这几天看到网上出了个Cumulus的后继项目MonaServer, 官网是

[http://www.monaserver.ovh/][http_www.monaserver.ovh]

看介绍相当强悍, 包括支持RTMP, RTMFP, RTSP, HTTP, WebSocket等等, 妈呀, 简单在流媒体领域大一统了, 所以, 我是有相当的兴趣去业余研究它的. 我粗略过了一篇源码目录, 然后就想通过文档来进一步了解,但是发现国外的官网相当慢, 没有办法, 就想搞个本地版本看看. 在源码目录doc中, 所有的文档都是dst格式, 可以通过sphinx来生成html, 这样本地就可以看了.感谢该大牛Thomas Jammet的无私分享,膜拜一下

![Center][]

另外Cumulus项目的开发者Mathieu Poux也是MonaSever项目的coauther，下面是我的折腾笔记.

首先需要需要安装sphinx和bootstrap主题, 它们当前版本分别为sphinx 1.3.1和sphinx\_bootstrap \_theme 0.4.5.

sudo pip install sphinx

sudo pip install sphinx\_bootstrap\_theme

![Center 1][]

![Center 2][]

然后下载源码

git clone https://github.com/MonaSolutions/MonaServer.git

新建一个目录sphinx\_mano, 将源码中的doc目录复制过来

mkdir  ~/program\_develop/python\_dev/sphinx\_mona

cp -f doc/\*  ~/program\_develop/python\_dev/sphinx\_mona

切换到sphinx\_mona目录下面

cd  ~/program\_develop/python\_dev/sphinx\_mona

检查conf.py, Makefile这些文件是否有异常, 特别注意, 使用sphinx\_bootstrap\_theme主题时, conf.py中的如下对应配置

import sphinx\_bootstrap\_theme  
html\_theme = 'bootstrap'  
html\_theme\_path = sphinx\_bootstrap\_theme.get\_html\_theme\_path()

![Center 3][]

然后执行

make html

如果生成过程有异常, 就执行下面的命令清除

make clean

排除错误, 然后重新生成就可以了

make html

生成成功之后, 就可以进入生成目录\_build/html中使用浏览器查看index.html了

![Center 4][]

说明:

这里没有使用通常的步骤, 执行sphinx-quickstart来得到一个目录框架, 里面做一些配置, 记录在conf.py中, 同时还要\_\_build和\_\_static目录等, 比如

![Center 5][]

这是因为MonaServer的doc目录下面已经存在这些文件和目录, 并且已经配置好了, 不需要我们这么做, 我们只需要将dst文件转换为html观看就可以了.

后记

这两天测试发现这种读文档的方法突然不好使, 研究了一下index.html源码发现, 里面的css来自google域名, 万恶的GFW现在越来越疯狂了,估计我前段时间的翻墙设置不好使了.无奈之下, 我只有从MonaServer的官网主页看文档了.

参考文献

\[1\].[http://www.ibm.com/developerworks/cn/opensource/os-sphinx-documentation/][http_www.ibm.com_developerworks_cn_opensource_os-sphinx-documentation]

\[2\].[https://pypi.python.org/pypi/sphinx-bootstrap-theme/][https_pypi.python.org_pypi_sphinx-bootstrap-theme]

[http_www.monaserver.ovh]: http://www.monaserver.ovh/
[Center]: /images/20220805/a7eaaf5a1fed48edaa50fe0b292384a9.png
[Center 1]: /images/20220805/c2896f222c664ccdae5059e83290f0c2.png
[Center 2]: /images/20220805/2fd2b0d47fc947e29d10e59cbd72abda.png
[Center 3]: /images/20220805/5235f1fa02a64d248c195b605152dab9.png
[Center 4]: /images/20220805/a2305edc5dea463aa2de5c46d254b2d4.png
[Center 5]: /images/20220805/54afb77fb45d4e31b90c45836975c908.png
[http_www.ibm.com_developerworks_cn_opensource_os-sphinx-documentation]: http://www.ibm.com/developerworks/cn/opensource/os-sphinx-documentation/
[https_pypi.python.org_pypi_sphinx-bootstrap-theme]: https://pypi.python.org/pypi/sphinx-bootstrap-theme/