Zola Theme AdiDoks

AdiDoks is a modern documentation theme, which is a port of the Hugo theme Doks for Zola.


Live Preview.


Before using the theme, you need to install the Zola ≥ 0.15.0.

Quick Start

git clone https://github.com/aaranxu/adidoks.git
cd adidoks
zola serve
# open in the browser

Read more from the document of the AdiDoks.


Just earlier we showed you how to run the theme directly. Now we start to install the theme in an existing site step by step.

Step 1: Create a new zola site

zola init mysite

Step 2: Install AdiDoks

Download this theme to your themes directory:

cd mysite/themes
git clone https://github.com/aaranxu/adidoks.git

Or install as a submodule:

cd mysite
git init  # if your project is a git repository already, ignore this command
git submodule add https://github.com/aaranxu/adidoks.git themes/adidoks

Step 3: Configuration

Enable the theme in your config.toml in the site directory:

theme = "adidoks"

Or copy the config.toml.example from the theme directory to your project's root directory:

cp themes/adidoks/config.toml.example config.toml

Step 4: Add new content

You can copy the content from the theme directory to your project:

cp -r themes/adidoks/content .

You can modify or add new posts in the content/blog, content/docs or other content directories as needed.

Step 5: Run the project

Just run zola serve in the root path of the project:

zola serve

AdiDoks will start the Zola development web server accessible by default at Saved changes will live reload in the browser.


You can customize your configurations, templates and content for yourself. Look at the config.toml, theme.toml, content files and templates files in this repo for an idea.

Global Configuration

There are some configuration options that you can customize in config.toml.

Configuration options before extra options

Set the authors's taxonomies for the site.

taxonomies = [
  {name = "authors"},

Use search function for the content.

build_search_index = true

Configuration options under the extra

The following options should be under the [extra] in config.toml


All pages are extend to the base.html, and you can customize them as need.



Go to the content/_index.md file to add your own homepage content.


Each section includes a _index.md, and you can customize it or add your new section under the content folder.


There are mainly three types of pages in the site.

Reporting Issues

We use GitHub Issues as the official bug tracker for the AdiDoks. Please search existing issues. It’s possible someone has already reported the same problem.

If your problem or idea is not addressed yet, open a new issue.


We'd love your help! Please see CONTRIBUTING.md to learn about the kinds of contributions we're looking for.


AdiDoks is distributed under the terms of the MIT license.