:title: Configuration
:date: 2022-09-22

=============
Configuration
=============

Dirs (``dirs``)
===============

build_dir
    Default: build

content_dir
    Default: content

templates_dir
    Default: layouts

static_dir
    Default: static

    .. note::

        Content of this diretory will be placed into site root. Use
        subdirectories for files here, e.g. css/, img/, etc.

Default settings for pages (``defaults``)
=========================================

template
    Default: template.jinja2

    Default page template.

type
    Default: page

    Default article type.

Custom site data (``site``)
===========================

datetime_format
    Default: %Y-%m-%d

    See `Format Codes`_.

Pygments (``pygments``)
=======================

theme
    Default: default

    Generate CSS style with following command::

        make css style_name

    See `Pygments Styles`_ and `pygmentize`_.

Docutils (``docutils``)
=======================

See `Docutils Configuration`_.

.. Links

.. _Format Codes: https://docs.python.org/3/library/datetime.html#strftime-and-strptime-format-codes
.. _Pygments Styles: https://pygments.org/styles/
.. _pygmentize: https://pygments.org/docs/cmdline/
.. _Docutils Configuration: https://docutils.sourceforge.io/docs/user/config.html