在Ubuntu 14.04 64bit上使用Sphinx转换MonaServer项目文档
这几天看到网上出了个Cumulus的后继项目MonaServer, 官网是
http://www.monaserver.ovh/
看介绍相当强悍, 包括支持RTMP, RTMFP, RTSP, HTTP, WebSocket等等, 妈呀, 简单在流媒体领域大一统了, 所以, 我是有相当的兴趣去业余研究它的. 我粗略过了一篇源码目录, 然后就想通过文档来进一步了解,但是发现国外的官网相当慢, 没有办法, 就想搞个本地版本看看. 在源码目录doc中, 所有的文档都是dst格式, 可以通过sphinx来生成html, 这样本地就可以看了.感谢该大牛Thomas Jammet的无私分享,膜拜一下
另外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
然后下载源码
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()
然后执行
make html
如果生成过程有异常, 就执行下面的命令清除
make clean
排除错误, 然后重新生成就可以了
make html
生成成功之后, 就可以进入生成目录_build/html中使用浏览器查看index.html了
说明:
这里没有使用通常的步骤, 执行sphinx-quickstart来得到一个目录框架, 里面做一些配置, 记录在conf.py中, 同时还要__build和__static目录等, 比如
这是因为MonaServer的doc目录下面已经存在这些文件和目录, 并且已经配置好了, 不需要我们这么做, 我们只需要将dst文件转换为html观看就可以了.
后记
这两天测试发现这种读文档的方法突然不好使, 研究了一下index.html源码发现, 里面的css来自google域名, 万恶的GFW现在越来越疯狂了,估计我前段时间的翻墙设置不好使了.无奈之下, 我只有从MonaServer的官网主页看文档了.
参考文献
[1].http://www.ibm.com/developerworks/cn/opensource/os-sphinx-documentation/
[2].https://pypi.python.org/pypi/sphinx-bootstrap-theme/
在Ubuntu 14.04 64bit上使用Sphinx转换MonaServer项目文档相关推荐
- 在Ubuntu 14.04 64bit上生成ATS本地离线文档
下面是在Ubuntu 14.04 64bit上生成ats本地离线文档的方法 首先请安装配置好sphinx环境,参见我前面的博文 http://blog.csdn.net/tao_627/article ...
- 在Ubuntu 14.04 64bit上安装Markdown和绘图软件Haroopad
简介 Haroopad:一款让你欲罢不能的Markdown编辑器 身为大程序员,我本来是不需要 Markdown 编辑器的,但是 Haroopad 让我简直欲罢不能,不能再爱更多.跨平台,代码高亮,V ...
- 在Ubuntu 14.04 64bit上安装StarUML 2.5版本
StarUML是来自韩国的一个优秀的UML绘图软件, 原来是免费软件, 现在需要付费购买.当然免费使用功能会有诸多限制. 它支持Windows, Linux和Mac OS等平台. 下面是我在Ubunt ...
- 在Ubuntu 14.04 64bit上编译并研究State Threads网络线程库源码
State Threads是一个广受关注的高性能网络线程库,winlin在SRS中做了比较充分的应用,我很遗憾直到现在才精心研究它.下面是我的研究实录,以作备忘. 一.源码编译 下面是在Ubuntu ...
- 在Ubuntu 14.04 64bit上安装Markdown编辑器Remarkble
目前Markdown已经是非常流行和高效的文档整理和书写工具语言, 我以前接触过, 但是一直没有坚持下来, 这次五一假期期间我强迫自己去熟悉它的语法格式和编辑器, 原来我在Ubuntu 14.04 6 ...
- 在Ubuntu 14.04 64bit上安装百度云Linux客户端BCloud
百度云是一个不错的网盘,Bcloud 是一个 Linux 下超赞的客户端, 官网 github: https://github.com/LiuLang/bcloud-packages 和kwplaye ...
- 在ubuntu 14.04 64bit上安装酷我音乐盒Linux客户端kwplayer
kwplayer 是linux桌面下的轻量级的音乐播放软件, 由LiuLang同学开发, 使用的是Python3+gtk3, 开源的(GPLv3). 它的主要特点有: • 使用了kuwo.cn(酷我音 ...
- 在Ubuntu 14.04 64bit上安装numpy和matplotlib库
机器学习是数据挖掘的一种实现形式,在学习<机器学习实战>过程中,需要python环境中安装好numpy和matplotlib库,特此将我在Ubuntu 14.04 64bit上的摸索过程总 ...
- 在Ubuntu 14.04 64bit上进行md5加密编程
计算指定字符串的md5值是一项很常见的操作,包括使用命令行md5sum,或者在C/C++编程中调用openssl提供的接口函数来进行.下面我们分别阐述如下: 一.在命令行中使用md5校验 计算某个文件 ...
最新文章
- 5款让Web前端开发人员更轻松的实用工具
- 判断C#中的字符串是否是数字,如果是转换成int类型
- OpenStack-Mitaka 一键安装测试环境脚本
- mysql 常用存储引擎InnoDBMyISAM表格对比
- E WORD 0410
- 中国大学MOOC行为金融学及答案
- 计算机对金融学的帮助,计算机在金融业中的作用
- java前进后退代码_提供前进、后退功能及其他JAVASCRIPT速成秘诀
- 【LAS】IJK中las 的自适应配置没有给出?
- 计算机基础白板课件,白板教学最流行的6种教学模式-交互式电子白板课件制作心得...
- 黑莓9810JAVA,振奋!黑莓9810/9860/9900发布现场热图鉴赏
- 湖南省湘潭市谷歌高清卫星地图下载
- matplotlib绘制线性回归y=kx+b参数的损失函数等高线图
- ZK和EureKa的区别(CAP理论)
- win10系统自带查询电池健康命令
- 开源模式让木马软件更疯狂
- ARM汇编之跳转指令
- wordpress新增一个列表页
- 计算机信息系统保密管理暂行规定心得体会,保密心得体会
- 优优云验证码识别积累一二
热门文章
- 2022-2028年中国B2C电子商务市场投资分析及前景预测报告
- 机器学习三要素之数据、模型、算法
- oracle pl/sql 程序设计 历史笔记整理
- GIT入门笔记(4)- GIT 安装
- BZOJ1922: [Sdoi2010]大陆争霸
- UML for Java Programmers之dx实战
- [讨论]你的女朋友值多少钱?
- ELFhash - 优秀的字符串哈希算法
- macos 全局快捷键 打开 iterm_MouseInc – 完全免费的全局鼠标手势增强工具 | 马小帮...
- c语言解析xml字符串_Python XML解析