Apache HAWQ（孵化中）用户文档构建指南

本文档将详细介绍如何使用Markdown格式源码构建Apache HAWQ（孵化中）的用户文档，并提供安装指南、使用说明以及API使用文档。

1. 安装指南

环境要求

• Ruby版本2.3.0或更高
• 安装Ruby的bundler用于管理gem包

安装步骤

1. 切换到本仓库的book目录。
2. 在book目录中安装bookbinder及其依赖的gems：

   $ bundle install
   

2. 项目使用说明

本项目中提供了一个预配置的book，位于仓库的/book目录中。你可以使用这个配置在本地系统上构建HAWQ的HTML文档。

构建文档

1. 切换到本仓库的book目录。

2. 使用以下命令安装bookbinder和其依赖的gems：

   $ bundle install
   

3. 执行以下命令构建输出HTML文件：

   $ bundle exec bookbinder bind local
   

   Bookbinder会将XML源文件转换为HTML，并将最终输出放置在final_app目录中。

4. 使用rack gem查看构建的文档。首先切换到final_app目录，然后执行以下命令：

   $ bundle install
   $ rackup
   

   现在可以在http://localhost:9292查看本地构建的文档。

3. 项目API使用文档

本项目的API使用文档暂时不包含在本次构建中，请参考Apache HAWQ官方文档以获取API使用详情。

4. 项目安装方式

本项目通过以下方式安装：

1. 下载或克隆本仓库。
2. 切换到book目录。
3. 使用bundle install命令安装所需的gems。
4. 使用bundle exec bookbinder bind local命令构建HTML文档。
5. 切换到final_app目录并使用rackup命令启动web服务。

以上步骤将帮助您成功构建并查看Apache HAWQ（孵化中）的用户文档。