tree: c0613249cecad3e8862a76c42c012bf587031109 [path history] [tgz]
  1. docs/
  2. mkdocs.yml
  3. README.md
  4. requirements.txt
site/README.md

Apache Iceberg Site

This directory contains the source for the Iceberg site.

  • Site structure is maintained in mkdocs.yml
  • Pages are maintained in markdown in the docs/ folder
  • Links use bare page names: [link text](target-page)

Installation

The site is built using mkdocs. To install mkdocs and the theme, run:

pip install -r requirements.txt

Local Changes

To see changes locally before committing, use mkdocs to run a local server from this directory.

mkdocs serve

To see changes in Javadoc, run:

./gradlew refreshJavadoc

Publishing

After site changes are committed, you can publish the site with this command:

mkdocs gh-deploy

This assumes that the Apache remote is named apache and will push to the asf-site branch. To use a different remote add -r <remote-name>.