aboutsummaryrefslogtreecommitdiffstats
path: root/nikola/conf.py.in
diff options
context:
space:
mode:
Diffstat (limited to 'nikola/conf.py.in')
-rw-r--r--nikola/conf.py.in22
1 files changed, 16 insertions, 6 deletions
diff --git a/nikola/conf.py.in b/nikola/conf.py.in
index 4546460..fcb2d28 100644
--- a/nikola/conf.py.in
+++ b/nikola/conf.py.in
@@ -195,7 +195,7 @@ TIMEZONE = ${TIMEZONE}
# FORCE_ISO8601 = False
# Date format used to display post dates. (translatable)
-# Used by babel.dates, CLDR style: http://cldr.unicode.org/translation/date-time
+# Used by babel.dates, CLDR style: http://cldr.unicode.org/translation/date-time-1/date-time
# You can also use 'full', 'long', 'medium', or 'short'
# DATE_FORMAT = 'yyyy-MM-dd HH:mm'
@@ -244,7 +244,7 @@ COMPILERS = ${COMPILERS}
# Enable reST directives that insert the contents of external files such
# as "include" and "raw." This maps directly to the docutils file_insertion_enabled
-# config. See: http://docutils.sourceforge.net/docs/user/config.html#file-insertion-enabled
+# config. See: https://docutils.sourceforge.io/docs/user/config.html#file-insertion-enabled
# REST_FILE_INSERTION_ENABLED = True
# Create by default posts in one file format?
@@ -288,6 +288,8 @@ COMPILERS = ${COMPILERS}
# If you want to hide the title of your website (for example, if your logo
# already contains the text), set this to False.
+# Note: if your logo is a SVG image, and you set SHOW_BLOG_TITLE = False,
+# you should explicitly set a height for #logo in CSS.
# SHOW_BLOG_TITLE = True
# Paths for different autogenerated bits. These are combined with the
@@ -981,7 +983,7 @@ PRETTY_URLS = ${PRETTY_URLS}
# DEPLOY_DRAFTS = True
# Allows scheduling of posts using the rule specified here (new_post -s)
-# Specify an iCal Recurrence Rule: http://www.kanzaki.com/docs/ical/rrule.html
+# Specify an iCal Recurrence Rule: https://www.kanzaki.com/docs/ical/rrule.html
# SCHEDULE_RULE = ''
# If True, use the scheduling rule to all posts (not pages!) by default
# SCHEDULE_ALL = False
@@ -1043,9 +1045,17 @@ MARKDOWN_EXTENSIONS = ['markdown.extensions.fenced_code', 'markdown.extensions.c
# MARKDOWN_EXTENSION_CONFIGS = {}
-# Extra options to pass to the pandoc command.
-# by default, it's empty, is a list of strings, for example
-# ['-F', 'pandoc-citeproc', '--bibliography=/Users/foo/references.bib']
+# Extra options to pass to the pandoc command, empty by default.
+# It can be a list of strings or a dict (keys are file extensions).
+# Example for a list of strings (used for all extensions):
+# PANDOC_OPTIONS = ['-F', 'pandoc-citeproc', '--bibliography=/Users/foo/references.bib']
+# Example for a dict, where the keys are the extensions in COMPILERS['pandoc']:
+# COMPILERS['pandoc'] = ['.rst', '.md', '.txt']
+# PANDOC_OPTIONS = {
+# '.rst': ['-t', 'rst'],
+# '.md': ['-t', 'markdown'],
+# '.txt': ['-t', 'markdown-raw_html'],
+# }
# Pandoc does not demote headers by default. To enable this, you can use, for example
# ['--base-header-level=2']
# PANDOC_OPTIONS = []