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.

author

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 for HtmlFormatter

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 to false 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 and typogrify and only works in Django at this time.

ligatures

Defaults to False

deploy_dir

Defaults to deploy