News

Customize and tweak Ace using a number of configuration options.

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:

toc = false

in the config.toml or the frontmatter (a page’s markdown file) for a page-wide or page-specific disabling of the ToC respectively.

An optional site logo can be specified:

site_logo = /logo.svg

Google Analytics

Enable Google Analytics by adding your GA tracking ID to the config.toml file, at:

googleAnalytics = "XX-XXXXXXXXX-X"
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.

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"]

Read more