72 lines
1.3 KiB
ReStructuredText
72 lines
1.3 KiB
ReStructuredText
|
: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
|