odoo文档的安装

步骤 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的升级工具相关，而不是与文档构建直接相关，所以除非你有特定的需求，否则在构建文档时通常不需要它。

1. 使用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文件。

2. 配置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文件。