8.7. 发布静态网站#
如果你想让别人看到你的项目文档, 你有两个选择:
放到 Read the Docs 进行托管;
建立你自己的网站.
这里介绍第二种方案.
8.7.1. Sphinx主题定制#
如何个性化网页图标(设置 favicon)
将目标图片 favicon.ico 放入 _static 文件夹内,然后 在该项目的 conf.py 下加入以下语句
html_favicon = '_static/favicon.ico'
8.7.2. 使用Apache建立自己的网站服务器#
Apache <http://httpd.apache.org/> 是世界使用排名第一的Web服务器软件. 它可以运行在几乎所有广泛使用的计算机平台上, 由于其跨平台和安全性被广泛使用, 是最流行的Web服务器端软件之一. 它快速、可靠并且可通过简单的API扩充, 将Perl/Python等解释器编译到服务器中.
备注
同时Apache音译为阿帕奇, 是北美印第安人的一个部落, 叫阿帕奇族, 在美国的西南部; 也是一个基金会的名称;一种武装直升机等等.
安装apache2#
以 Ubuntu 系统为例:
使用命令 sudo apt-get install apache2
,
安装完成后浏览器输入 http://127.0.0.1
测试显示 It works! 表明安装成功.
配置apache2#
修改主配置文件 /etc/apache2/apache2.conf
和 端口监听设置文件 /etc/apache2/port.conf
文件:
使用 sudo gedit /etc/apache2/apache2.conf
打开文件, 在文件末尾添加:
ServerName localhost
DirectoryIndex index.html index.htm index.php
使用 sudo gedit /etc/apache2/port.conf
打开文件, 在文件末尾添加:
Apache2相关代码
最后重启Apache2: sudo /etc/init.d/apache2 restart
.