Enable the theme in your `config.toml` in the site derectory:
```toml
theme = "adidoks"
```
Or copy the `config.toml.example` from the theme directory to your project's
root directory:
```bash
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:
```bash
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:
```bash
zola serve
```
AdiDoks will start the Zola development web server accessible by default at
`http://127.0.0.1:1111`. Saved changes will live reload in the browser.
## Customisation
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.
```toml
taxonomies = [
{name = "authors"},
]
```
Use search function for the content.
```toml
build_search_index = true
```
#### Configuration options under the `extra`
The following options should be under the `[extra]` in `config.toml`
-`alanguage_code` - set HTML file language (default to `en-US`)
-`theme_color` - your site's HTML color (default to `#fff`)
-`title_separator` - the separator to your site title, like `|` and `-` (defaults to `|`)
-`title_addition` - the additon content for the title of the homepage
-`timeformat` - the timeformat for the blog article published date
-`timezone` - the timezone for the blog article published date
-`edit_page` (and `docs_repo`, `repo_branch`) - whether to show the edit page in the github repo for your docs
-`math` (and `library`) - set KaTeX or MathJax library
-`[extra.open]` - Open Graph + Twitter Cards for the site
-`[extra.schema]` - set JSON-LD for the site
-`[[extra.menu.main]]` - the header navigations for the site
-`[[extra.menu.social]]` - the social links on the header of the page
-`[extra.footer]` - the footer content on the left
-`[[extra.footer.nav]]` - the footer navigations on the right
-`[extra.home]` - the main content of the homepage
-`[[extra.home.list]]` - the lists' content of the homepage
### Templates
All pages are extend to the `base.html`, and you can customize for as need.
### Content
#### Homepage
Go to the `config.toml` to set your own homepage content.
#### Sections
Each section includes a `_index.md`, and you can customize it.
#### Pages
There are three types of pages in the site.
-`blog` - blog article
-`docs` - documentation article
-`authors` - authors page if you need to add some information for a new author
## Reporting Issues
We use GitHub Issues as the official bug tracker for the **AdiDoks**. Please
