Configuration 🔗

Site Configuration 🔗

For global site config you edit the _config.yaml in the root folder:

name: My Cool Blog                      # website name
description: My Cool Blog Description   # website description
base_url: https://mydomain.com/subpath  # URL where website will be deployed

theme:
  source: my_theme                      # website theme

categories:
  blog:                 # content/blog/ folder
    label: Blog
  docs:                 # content/docs/ folder
    label: Documentation


lang: en                # default language
timezone: Europe/Sarajevo
...

The base_url can also be specified as an environment variable FLATMARK_BASE_URL.

Page Configuration 🔗

Put the configuration at the top of your page file, in YAML format, like this:

---
title: Hello
tags: [scala, java]
publish_date: 2025-01-01 11:11  # in timezone specified in the _config.yaml
publish: yes | no | hide        # hide means published but not listed/searched/google-indexed, default is yes
---

# Hello Configuration
This is my first post!

The page configuration section is optional.
The file needs to start with --- and the config ends with another ---.
This type of config is called "YAML front matter".