Configuration

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.

Read more

Usage Shortcodes