步骤 1: 安装必要的软件
确保你已经安装了Git和Python 3.6、3.7或3.8之一。
步骤 2: 克隆 Odoo 文档存储库
打开终端，然后使用Git克隆Odoo的文档存储库。
git clone https://github.com/odoo/documentation.git
cd documentation
步骤 3: 安装 Python 依赖项
进入文档目录后，安装requirements.txt文件中列出的Python依赖项。
开启虚拟环境：
source ~/anaconda3/bin/activate base
安装requirements.txt
pip install -r requirements.txt
步骤 4: 构建文档
在文档的根目录中，使用make命令来构建文档。
make html
如果你想查看可用的make命令和选项，可以运行：
make help
步骤 5: 在 Web 浏览器中打开文档
一旦文档构建完成，你可以在Web浏览器中打开生成的HTML文件来查看它们。通常，这些文件位于_build/html/目录下。
在终端中打开文件（取决于你的操作系统和终端模拟器）
例如，在Linux或macOS上，你可以使用xdg-open或open命令
xdg-open _build/html/index.html
或者
open _build/html/index.html
在Windows上，你可能需要手动打开文件或文件夹
或者，你可以直接在文件浏览器中导航到_build/html/目录，并双击index.html文件来打开它。
可选步骤：使用 Python 文档字符串
Odoo的文档存储库odoo/documentation通常不包含Odoo代码库中的Python文档字符串。但是，如果你正在为Odoo开发模块或应用程序，并且想在文档中包括这些文档字符串，你应该：
克隆odoo/odoo存储库。
在你的开发环境中编写或更新Python文档字符串。
使用Odoo的文档生成工具（如果有的话）或Sphinx（如果Odoo文档是用Sphinx构建的）来提取这些文档字符串并包括在你的文档中。
但请注意，这通常不是直接在odoo/documentation存储库中完成的，而是在你的Odoo模块或应用程序的代码中完成的。
最后，odoo/upgrade-util存储库通常与Odoo的升级工具相关，而不是与文档构建直接相关，所以除非你有特定的需求，否则在构建文档时通常不需要它。
- 使用Python的HTTP服务器（不推荐用于生产环境）
你可以使用Python的内置HTTP服务器来快速启动一个HTTP服务。不过请注意，这种方法不应用于生产环境，因为它没有安全或性能优化。
在终端中，切换到你的HTML目录并执行以下命令：
cd ~/documentation/_build/html
nohup sudo python3 -m http.server 8000 &
查找进程：
pgrep -f ‘python3 -m http.server’
现在，你可以通过http://:8000/来访问你的index.html文件。
- 配置Nginx（推荐）
server { # … 其他配置 …
修改/etc/nginx：ngin.conf文件并保存：
server {
listen 8011; # 监听8011端口
server_name ; # 绑定到这个IP地址
location /b8water_docs/ {
alias /var/www/html/documentation/_build/html/; # 指向您的文件目录
try_files $uri $uri/ =404; # 如果文件不存在，返回404
}
}
配置后，重新加载Nginx配置：
bash复制代码
sudo nginx -s reload
现在，你可以通过http://:8011/documentation/index.html来访问你的index.html文件。
)
)
