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