+++
title = "Configuration"
description = ""
weight = 2
+++
{{< lead >}}
Customize and tweak Ace using a number of configuration options.
{{< /lead >}}
## Page ordering
By default, pages are sorted on the weight assigned to them in their frontmatter
. This is set in config.toml
, using orderSectionsby = "weight"
. Change this to "title"
to sort pages alphabetically based on their title instead. Alternatively, do not assign a weight to any pages and it will also sort them alphabetically on their title.
## Table of contents
By default, a table of contents (ToC) is generated for each page in the right side menu. This can be disabled using:
{{< code >}}
toc = false
{{< /code >}}
in the config.toml
or the frontmatter
(a page's markdown file) for a page-wide or page-specific disabling of the ToC respectively.
## Logo
An optional site logo can be specified:
{{< code >}}
site_logo = /logo.svg
{{< /code >}}
## Google Analytics
Enable Google Analytics by adding your GA tracking ID to the config.toml
file, at:
{{< code >}}
googleAnalytics = "XX-XXXXXXXXX-X"
{{< /code >}}
Where XX-XXXXXXXXX-X
is your tracking ID.
## Read more navigation
In config.toml
or a page's frontmatter
, set disableReadmoreNav = true
to disable the prev/next buttons at the bottom of every page.
## Search
Disable search by setting disableSearch = true
in config.toml
.
The local search feature is based on the content of `index.json`, which is generated based on a configurable template.
Search results are presented as a drop-down list attached to the search input field while typing.
## Custom CSS
You can override the built-in css by using your own. Just put your own css files in the `static` directory of your website (the one in the theme directory also works but is not recommended) and modify the `custom_css` parameter in your config file. The path referenced in the parameter should be relative to the `static` folder. These css files will be added through the `header` partial after the built-in css file.
For example, if your css files are `static/css/custom.css` and `static/css/custom2.css` then add the following to the config file:
```
[params]
custom_css = ["css/custom.css","css/custom2.css"]
```