zola/docs/content/documentation/getting-started/configuration.md

+++
title = "Configuration"
weight = 4
+++

The default configuration will be enough to get Gutenberg running locally but not more than that.
It follows the philosophy of only paying for what you need: almost everything is turned off by default.

To change the config, edit the `config.toml` file.
If you are not familiar with TOML, have a look at [the TOML Spec](https://github.com/toml-lang/toml)
to learn about it.

Only one variable - `base_url` - is mandatory, everything else is optional. You can find all variables
used by Gutenberg config as well as their default values below:


```toml
# Base URL of the site, the only required config argument
base_url = "mywebsite.com"

# Used in RSS by default
title = ""
description = ""
# the default language, used in RSS and coming i18n
default_language = "en"

# Theme name to use
theme = ""

# Highlight all code blocks found
highlight_code = false

# Which theme to use for the code highlighting.
# See below for list of accepted values
highlight_theme = "base16-ocean-dark"

# Whether to generate a RSS feed automatically
generate_rss = false

# The number of articles to include in the RSS feed
rss_limit = 20

# Whether to generate a tags page and individual
# tag pages for pages with tags
generate_tags_pages = false

# Whether to generate a categories page and individual
# category pages for pages with a category
generate_categories_pages = false

# Whether to compile the Sass files found in the `sass` directory
compile_sass = false

# Whether to build a search index out of the pages and section
# content for the `default_language`
build_search_index = false

# A list of glob patterns specifying asset files to ignore when
# processing the content directory. 
# Defaults to none, which means all asset files are copied over to the public folder.
# Example:
#     ignored_content = ["*.{graphml,xlsx}", "temp.*"]
ignored_content = []

# Optional translation object. The key if present should be a language code
[translations]

# You can put any kind of data in there and it
# will be accessible in all templates
[extra]
```

## Syntax highlighting

Gutenberg currently has the following highlight themes available:

- 1337: https://tmtheme-editor.herokuapp.com/#!/editor/theme/1337
- agola-dark: https://tmtheme-editor.herokuapp.com/#!/editor/theme/Agola%20Dark
- ascetic-white: https://tmtheme-editor.herokuapp.com/#!/editor/theme/Ascetic%20White
- axar: https://tmtheme-editor.herokuapp.com/#!/editor/theme/Axar
- base16-ocean-dark
- base16-ocean-light 
- bbedit: https://tmtheme-editor.herokuapp.com/#!/editor/theme/BBEdit
- boron: https://tmtheme-editor.herokuapp.com/#!/editor/theme/Boron
- charcoal: https://tmtheme-editor.herokuapp.com/#!/editor/theme/Charcoal
- cheerfully-light: https://tmtheme-editor.herokuapp.com/#!/editor/theme/Cheerfully%20Light
- classic-modified: https://tmtheme-editor.herokuapp.com/#!/editor/theme/Classic%20Modified
- demain: https://tmtheme-editor.herokuapp.com/#!/editor/theme/Demain
- dimmed-fluid: https://tmtheme-editor.herokuapp.com/#!/editor/theme/Dimmed%20Fluid
- gray-matter-dark: https://tmtheme-editor.herokuapp.com/#!/editor/theme/Gray%20Matter%20Dark
- gruvbox-dark: https://github.com/morhetz/gruvbox
- gruvbox-light: https://github.com/morhetz/gruvbox
- idle: https://tmtheme-editor.herokuapp.com/#!/editor/theme/IDLE
- inspired-github: https://tmtheme-editor.herokuapp.com/#!/editor/theme/Inspiredgithub
- ir-white: https://tmtheme-editor.herokuapp.com/#!/editor/theme/IR_White
- kronuz: https://tmtheme-editor.herokuapp.com/#!/editor/theme/Kronuz
- material-dark: https://tmtheme-editor.herokuapp.com/#!/editor/theme/Material%20Dark
- material-light: https://github.com/morhetz/gruvbox
- monokai: https://tmtheme-editor.herokuapp.com/#!/editor/theme/Monokai
- solarized-dark: https://tmtheme-editor.herokuapp.com/#!/editor/theme/Solarized%20(dark)
- solarized-light: https://tmtheme-editor.herokuapp.com/#!/editor/theme/Solarized%20(light)
- subway-madrid: https://github.com/idleberg/Subway.tmTheme
- subway-moscow: https://github.com/idleberg/Subway.tmTheme
- visual-studio-dark: https://tmtheme-editor.herokuapp.com/#!/editor/theme/Visual%20Studio%20Dark

Gutenberg uses the Sublime Text themes, making it very easy to add more.
If you want a theme not on that list, please open an issue or a pull request on the [Gutenberg repo](https://github.com/Keats/gutenberg).