commit | dbb5927b1182c3cfa15f5ceea4160a04e5d11804 | [log] [tgz] |
---|---|---|
author | Potato <tanxinyu@apache.org> | Wed Nov 13 18:24:16 2024 +0800 |
committer | GitHub <noreply@github.com> | Wed Nov 13 11:24:16 2024 +0100 |
tree | fbd1f1e205509caf53e8cfc114e21ecdcee626c0 | |
parent | c7f0eb501785fcfa95794f43d21eb93b2d248bd8 [diff] |
RATIS-2188. Update website with Ratis 3.1.2 release (#1176)
This is the source code of the website of Apache Ratis.
To render it you need hugo static site generator (https://gohugo.io/getting-started/installing) which is available for the most popular platforms as a single binary.
On OSX, this can be installed via HomeBrew: brew install hugo
. For other operating system, please refer to the aforementioned Hugo documentation for installation steps.
To render the final website, use the provided build.sh
script. This script will generate the website in the directory public/
and also perform a license check on the source files (prior to commit).
hugo
To iteratively develop the website, you can use the serve
command to start a local webserver with your content changes rendered in realtime:
hugo serve
Committers must ensure that the state of the asf-site-source
and asf-site
branches are in sync at all times. Committers must never manually edit content in the asf-site
branch.
Content pushed to the asf-site
branch is automatically published to the public website: https://ratis.apache.org
There is (presently) no automation to automatically keep these branches in sync, but a general guide is to do the following. These steps use two checkouts of the Git repo, one for asf-site
and another for asf-site-source
. Beware that these steps are destructive to any local modifications:
First time only!
$ git clone https://github.com/apache/ratis ratis-site.git $ cp -r ratis-site.git ratis-site-source.git $ pushd ratis-site.git && git checkout -t origin/asf-site && popd $ pushd ratis-site-source.git && git checkout -t origin/asf-site-source && popd
To modify the website:
$ pushd ratis-site.git && git pull && popd $ pushd ratis-site-source.git && git pull $ # hack hack hack $ ./build.sh ../ratis-site.git