The Redis Labs Documentation Center is built with Hugo and is based on the DocDock theme.
To run the Redis Labs Documentation Center locally:
-
Install the latest Hugo:
-
On CentOS:
- Install the copr plugin for yum:
sudo yum install yum-plugin-copr
- Enable the Hugo repository:
sudo yum copr enable daftaupe/hugo
- Install Hugo:
sudo yum install hugo
- Install the copr plugin for yum:
-
On Ubuntu:
- Install Hugo:
sudo apt-get install hugo
- Install Hugo:
-
On Windows:
- Install chocolatey.
- Install Hugo:
choco install hugo -confirm
-
On MacOS:
- Install homebrew
- Install Hugo:
brew install hugo
-
-
Verify that Hugo is installed:
hugo version
-
Clone this repository to your local host.
-
Change directory to the redislabs-docs directory.
-
Start the hugo web server:
hugo server
To access the site, go to: http://localhost:1313
Whether you see a typo or you want to suggest a change to the technical content, we encourage you to fork this repository and submit a pull request.
The "Edit on GitHub" link that is in the upper-left corner of every page opens the source file of that page so you can easily submit a change.
Articles are organized in directories that present the articles in a heirarchy in the site sidebar. When you add a file to a directory, it is automatically listed in that section in the sidebar.
The metadata (front matter) of a page is used to:
- Order the articles in a section by the 'weight' parameter (Remember, lower weight = higher priority
- Mark articles as
draft: true
so that they are not published
To add a new section in the sidebar, you must add a directory and add an _index.md
file in that directory. The content of the _index.md file is shown when you click on the category in the sidebar, and the weight
of the _index.md file determines the order in which the category is listed in the sidebar.