This repository is used to generate the Hop website
Tools used to generate the website:
contentdirectory and applies templates from
layoutsdirectory and together with any resources in
staticdirectory generates output in the
You can build the website locally using the tools
Make sure that you have Node.js (herein “
$ node --version
If this command fails with an error, you do not have Node installed.
This project requires the Node LTS version 12 (e.g., V12.19.0).
Please make sure to have a suitable version of Node installed. You have several options to install Node on your machine.
Note - If you have different Node version other than Node LTS version 12 you can use following command to make Node LTS version 12 as default Node version.
$ nvm alias default 12
Now that you have Node 12 installed, you can proceed with checking the Yarn installation.
Follow the documentation on installing Yarn for your Operating system.
Clone the hop-webiste git repository:
$ git clone https://github.com/apache/hincubator-op-website.git
First step is to build the Antora ui theme used for the Hop website. The theme sources are located inside Project root directory/antora-ui-hop. So first switch to that directory:
$ cd antora-ui-hop
In that directory execute:
$ yarn install # needed only once, or if dependencies change $ yarn build # to perform the ui theme build
You should see the Antora theme bundle generated in antora-ui-hop/build/ui-bundle.zip.
Before you are able to build the website content the ui bundle must be present.
To build the website go to the project root directory and run:
$ yarn install # needed only once, or if dependencies change $ yarn build # to perform the build
You should see the generated website in the
You can preview the the website on your local machine once you have the generated website available in the
Hugo can start a simple web server serving the generated site content so you can view it in your favorite browser.
$ yarn preview
$ yarn preview-local
preview will pull the latest docs version from github,
preview-local will use the (committed) documentation files from your local incubator-hop-docs clone.
preview-local assumes your docs repository is cloned to a folder
incubator-hop-docs next to
incubator-hop-webste (both repositories in the same parent folder).
and you will be provided with a web server running the site on http://localhost:1313/
Point your favorite browser to
http://localhost:1313/ and you will see the Hop website.
The website content is added under the
content directory, logical groups have been created to group website content. This repository will only be used for the more “static” types of information (blog/news/announcements). Software documentation will reside in a seperate repository or in the same repository as the code.
Asciidoc is used to write content for the website, more information about asciidoc syntax can be found here
Images and other resources should be added in the
This repository also contains a Jenkins hook, when you add a new branch or pull request with changed content the website is automatically build and a preview is available. When merged with master the site is redeployed
You can check your pull request and see if the site is correctly rendered by going to the Apache Builds website