| commit | d99daae878b0672a8d851d33b5d1bd8d087eae21 | [log] [tgz] |
|---|---|---|
| author | David Yozie <yozie@apache.org> | Mon Oct 31 12:16:54 2016 -0700 |
| committer | David Yozie <yozie@apache.org> | Mon Oct 31 12:16:54 2016 -0700 |
| tree | 00f383a8fe1ae13771780940788005791d1f338c | |
| parent | d98b06d3610878a8e45cdffeedac0b18fe7996c6 [diff] | |
| parent | eaf883c7fa88dabf6ad8c7a799c2b4cc4cf348b3 [diff] |
Merge branch 'feature/work_mem' of https://github.com/janebeckman/incubator-hawq-docs into develop
This repository provides the full source for Apache HAWQ (incubating) end-user documentation in MarkDown format. The source files can be built into HTML output using Bookbinder or other MarkDown tools.
Bookbinder is a gem that binds together a unified documentation web application from markdown, html, and/or DITA source material. The source material for bookbinder must be stored either in local directories or in GitHub repositories. Bookbinder runs middleman to produce a Rackup app that can be deployed locally or as a Web application.
This document contains instructions for building the local Apache HAWQ (incubating) documentation. It contains the sections:
Bookbinder is meant to be used from within a project called a book. The book includes a configuration file that describes which documentation repositories to use as source materials. Bookbinder provides a set of scripts to aggregate those repositories and publish them to various locations.
For Apache HAWQ (incubating), a preconfigured book is provided in a separate branch named book. You can use this configuration to build HTML for Apache HAWQ (incubating) on your local system.
Begin by cloning the book branch of this repository to a new directory that is parallel to asf/incubator-hawq-docs. For example:
$ cd /repos/asf/incubator-hawq-docs $ git clone --branch book http://git-wip-us.apache.org/repos/asf/incubator-hawq-docs.git ../hawq-book $ cd ../hawq-book
The GemFile in the book directory already defines the gem "bookbindery" dependency. Make sure you are in the relocated book directory and enter:
$ bundle install
The installed config.yml file configures the Apache HAWQ (incubating) book for building locally. Build the files with the command:
$ bundle exec bookbinder bind local
Bookbinder converts the XML source into HTML, putting the final output in the final_app directory.
Because the final_app directory contains the full output of the HTML conversion process, you can easily publish this directory as a hosted Web application. final_app contains a default configuration to serve the local files using the Rack web server:
$ cd final_app $ bundle install $ rackup
You can now view the local documentation at http://localhost:9292