Configuration¶
This is a reference for your blog’s main configuration file. Any values that you add in there will be made available in your templates’ context.
Blog author. Defaults to author.
-
site_name
¶
Site name. Defaults to Socrates site.
-
posts_per_page
¶
Number of posts displayed per page. Used for pagination. Defaults to 10. Setting this to 0 will display all posts on one page.
-
url
¶
Your site’s URL. Defaults to http://example.com.
-
date_format
¶
Python strftime formatted date format. Defaults to %B %d, %Y.
-
text_processor
¶
Which X to html processor to use; markdown, textile, rst, html, extension. Defaults to markdown. The ‘extension’ setting will decide on the processor to be used based on the post’s file extension:
- Markdown
- .md
- .markdown
- .mkdn
- reStructuredText
- .rst
- HTML
- .html
- .htm
- .txt
- Textile
- .textile
-
templates
¶
‘django’ or ‘jinja2’. Defaults to django.
-
append_slash
¶
Whether a slash should be appended to post urls. Defaults to true.
-
url_include_day
¶
Whether to include the day with the month and year in the generated directories and urls. Defaults to false.
-
initial_header_level
¶
By default, the first heading in your document will be
<h2>
. Only available for reStructuredText posts. Defaults to 2.
-
skip_archives
¶
If set to true, it won’t bother generating archives. Defaults to false.
-
skip_categories
¶
If set to true, it won’t bother generating categories. Defaults to false.
-
pygments
¶
Additional settings for the Pygments HTML Parser. It passes the arguments directly to the
HtmlFormatter
class when it’s instanciated, so these settings include all of the available settings forHtmlFormatter
sample:
pygments: linenos: true noclasses: false style: 'pastie'
-
style
¶
The style option has many default built in styles for your code blocks. The ones that ship with Pygments are:
monokai
,manni
,perldoc
,borland
,colorful
,default
,murphy
,vs
,trac
,tango
,fruity
,autumn
,bw
,emacs
,vim
,pastie
,friendly
,native
-
-
inline_css
¶
Whether or not you want pygments to output a
pygments.css
file in your build directory for css. If set tofalse
it will output the file.
-
punctuation
¶
Whether common punctuation characters should be replaced with proper HTML characters. Defaults to
False
. E.g.:- em dash
- en dash
- double quotes
- single quotes
- apostrophe
This functionality is provided by
smartypants
andtypogrify
and only works in Django at this time.
-
ligatures
¶
Defaults to
False
-
deploy_dir
¶
Defaults to
deploy