diff options
Diffstat (limited to 'nikola/conf.py.in')
| -rw-r--r-- | nikola/conf.py.in | 400 |
1 files changed, 207 insertions, 193 deletions
diff --git a/nikola/conf.py.in b/nikola/conf.py.in index b398ac3..2f40b59 100644 --- a/nikola/conf.py.in +++ b/nikola/conf.py.in @@ -4,13 +4,22 @@ from __future__ import unicode_literals import time -#!! This is the configuration of Nikola. !!# -#!! You should edit it to your liking. !!# +# !! This is the configuration of Nikola. !! # +# !! You should edit it to your liking. !! # + + +# ! Some settings can be different in different languages. +# ! A comment stating (translatable) is used to denote those. +# ! There are two ways to specify a translatable setting: +# ! (a) BLOG_TITLE = "My Blog" +# ! (b) BLOG_TITLE = {"en": "My Blog", "es": "Mi Blog"} +# ! Option (a) is used when you don't want that setting translated. +# ! Option (b) is used for settings that are different in different languages. # Data about this site -BLOG_AUTHOR = ${BLOG_AUTHOR} -BLOG_TITLE = ${BLOG_TITLE} +BLOG_AUTHOR = ${BLOG_AUTHOR} # (translatable) +BLOG_TITLE = ${BLOG_TITLE} # (translatable) # This is the main URL for your site. It will be used # in a prominent link SITE_URL = ${SITE_URL} @@ -18,37 +27,13 @@ SITE_URL = ${SITE_URL} # If not set, defaults to SITE_URL # BASE_URL = ${SITE_URL} BLOG_EMAIL = ${BLOG_EMAIL} -BLOG_DESCRIPTION = ${BLOG_DESCRIPTION} +BLOG_DESCRIPTION = ${BLOG_DESCRIPTION} # (translatable) # Nikola is multilingual! # # Currently supported languages are: -# bg Bulgarian -# ca Catalan -# cs Czech [ALTERNATIVELY cz] -# de German -# el Greek [NOT gr!] -# en English -# eo Esperanto -# es Spanish -# et Estonian -# eu Basque -# fa Persian -# fi Finnish -# fr French -# hi Hindi -# hr Croatian -# it Italian -# ja Japanese [NOT jp!] -# nb Norwegian Bokmål -# nl Dutch -# pt_br Portuguese (Brasil) -# pl Polish -# ru Russian -# sl Slovenian [NOT sl_si!] -# tr Turkish (Turkey) [NOT tr_tr!] -# ur Urdu -# zh_cn Chinese (Simplified) +# +${_SUPPORTED_LANGUAGES} # # If you want to use Nikola with a non-supported language you have to provide # a module containing the necessary translations @@ -62,40 +47,48 @@ DEFAULT_LANG = ${DEFAULT_LANG} # What other languages do you have? # The format is {"translationcode" : "path/to/translation" } # the path will be used as a prefix for the generated pages location -TRANSLATIONS = { - DEFAULT_LANG: "", - # Example for another language: - # "es": "./es", -} +TRANSLATIONS = ${TRANSLATIONS} # What will translated input files be named like? -# If you have a page something.rst, then something.rst.pl will be considered +# If you have a page something.rst, then something.pl.rst will be considered # its Polish translation. -# (in the above example: path == "something", lang == "pl", ext == "rst") +# (in the above example: path == "something", ext == "rst", lang == "pl") # this pattern is also used for metadata: -# something.meta -> something.meta.pl +# something.meta -> something.pl.meta TRANSLATIONS_PATTERN = ${TRANSLATIONS_PATTERN} -# If you don't want your Polish files to be considered Perl code, use this: -# TRANSLATIONS_PATTERN = "{path}.{lang}.{ext}" -# Note that this pattern will become the default in v7.0.0. - # Links for the sidebar / navigation bar. # You should provide a key-value pair for each used language. -NAVIGATION_LINKS = { - DEFAULT_LANG: ( - ('/archive.html', 'Archives'), - ('/categories/index.html', 'Tags'), - ('/rss.xml', 'RSS'), - ), -} +# (the same way you would do with a (translatable) setting.) +NAVIGATION_LINKS = ${NAVIGATION_LINKS} + +# Name of the theme to use. +THEME = ${THEME} ############################################## # Below this point, everything is optional ############################################## +# Post's dates are considered in UTC by default, if you want to use +# another time zone, please set TIMEZONE to match. Check the available +# list from Wikipedia: +# http://en.wikipedia.org/wiki/List_of_tz_database_time_zones +# (eg. 'Europe/Zurich') +# Also, if you want to use a different time zone in some of your posts, +# you can use the ISO 8601/RFC 3339 format (ex. 2012-03-30T23:00:00+02:00) +TIMEZONE = ${TIMEZONE} + +# If you want to use ISO 8601 (also valid RFC 3339) throughout Nikola +# (especially in new_post), set this to True. +# Note that this does not affect DATE_FORMAT. +# FORCE_ISO8601 = False + +# Date format used to display post dates. +# (str used by datetime.datetime.strftime) +# DATE_FORMAT = '%Y-%m-%d %H:%M' + # While nikola can select a sensible locale for each language, # sometimes explicit control can come handy. # In this file we express locales in the string form that @@ -114,7 +107,7 @@ NAVIGATION_LINKS = { # # That fragment could have an associated metadata file (whatever/thing.meta), # and optionally translated files (example for spanish, with code "es"): -# whatever/thing.txt.es and whatever/thing.meta.es +# whatever/thing.es.txt and whatever/thing.es.meta # # This assumes you use the default TRANSLATIONS_PATTERN. # @@ -154,11 +147,21 @@ COMPILERS = ${COMPILERS} # Set to False for two-file posts, with separate metadata. # ONE_FILE_POSTS = True -# If this is set to True, then posts that are not translated to a language -# LANG will not be visible at all in the pages in that language. -# If set to False, the DEFAULT_LANG version will be displayed for +# If this is set to True, the DEFAULT_LANG version will be displayed for # untranslated posts. -# HIDE_UNTRANSLATED_POSTS = False +# If this is set to False, then posts that are not translated to a language +# LANG will not be visible at all in the pages in that language. +# Formerly known as HIDE_UNTRANSLATED_POSTS (inverse) +# SHOW_UNTRANSLATED_POSTS = True + +# Nikola supports logo display. If you have one, you can put the URL here. +# Final output is <img src="LOGO_URL" id="logo" alt="BLOG_TITLE">. +# The URL may be relative to the site root. +# LOGO_URL = '' + +# If you want to hide the title of your website (for example, if your logo +# already contains the text), set this to False. +# SHOW_BLOG_TITLE = True # Paths for different autogenerated bits. These are combined with the # translation paths. @@ -171,7 +174,7 @@ COMPILERS = ${COMPILERS} # If TAG_PAGES_ARE_INDEXES is set to True, each tag's page will contain # the posts themselves. If set to False, it will be just a list of links. -# TAG_PAGES_ARE_INDEXES = True +# TAG_PAGES_ARE_INDEXES = False # Final location for the main blog page and sibling paginated pages is # output / TRANSLATION[lang] / INDEX_PATH / index-*.html @@ -212,7 +215,7 @@ COMPILERS = ${COMPILERS} # relative URL. # # If you don't need any of these, just set to [] -# REDIRECTIONS = ${REDIRECTIONS} +REDIRECTIONS = ${REDIRECTIONS} # Commands to execute to deploy. Can be anything, for example, # you may use rsync: @@ -222,6 +225,14 @@ COMPILERS = ${COMPILERS} # To do manual deployment, set it to [] # DEPLOY_COMMANDS = [] +# For user.github.io/organization.github.io pages, the DEPLOY branch +# MUST be 'master', and 'gh-pages' for other repositories. +# GITHUB_SOURCE_BRANCH = 'master' +# GITHUB_DEPLOY_BRANCH = 'gh-pages' + +# The name of the remote where you wish to push to, using github_deploy. +# GITHUB_REMOTE_NAME = 'origin' + # Where the output site should be located # If you don't use an absolute path, it will be considered as relative # to the location of conf.py @@ -308,10 +319,7 @@ COMPILERS = ${COMPILERS} # INDEXES_TITLE = "" # If this is empty, defaults to BLOG_TITLE # INDEXES_PAGES = "" # If this is empty, defaults to '[old posts,] page %d' (see above) # INDEXES_PAGES_MAIN = False # If True, INDEXES_PAGES is also displayed on - # the main (the newest) index page (index.html) - -# Name of the theme to use. -THEME = ${THEME} +# # the main (the newest) index page (index.html) # Color scheme to be used for code blocks. If your theme provides # "assets/css/code.css" this is ignored. @@ -328,15 +336,9 @@ THEME = ${THEME} # THEME_REVEAL_CONFIG_TRANSITION = 'cube' # You can also use: page/concave/linear/none/default -# date format used to display post dates. -# (str used by datetime.datetime.strftime) -# DATE_FORMAT = '%Y-%m-%d %H:%M' - # FAVICONS contains (name, file, size) tuples. # Used for create favicon link like this: # <link rel="name" href="file" sizes="size"/> -# For creating favicons, take a look at: -# http://www.netmagazine.com/features/create-perfect-favicon # FAVICONS = { # ("icon", "/favicon.ico", "16x16"), # ("icon", "/icon_128x128.png", "128x128"), @@ -345,15 +347,25 @@ THEME = ${THEME} # Show only teasers in the index pages? Defaults to False. # INDEX_TEASERS = False -# A HTML fragment with the Read more... link. +# HTML fragments with the Read more... links. # The following tags exist and are replaced for you: -# {link} A link to the full post page. -# {read_more} The string “Read more” in the current language. -# {{ A literal { (U+007B LEFT CURLY BRACKET) -# }} A literal } (U+007D RIGHT CURLY BRACKET) -# READ_MORE_LINK = '<p class="more"><a href="{link}">{read_more}…</a></p>' +# {link} A link to the full post page. +# {read_more} The string “Read more” in the current language. +# {reading_time} An estimate of how long it will take to read the post. +# {remaining_reading_time} An estimate of how long it will take to read the post, sans the teaser. +# {min_remaining_read} The string “{remaining_reading_time} min remaining to read” in the current language. +# {paragraph_count} The amount of paragraphs in the post. +# {remaining_paragraph_count} The amount of paragraphs in the post, sans the teaser. +# {{ A literal { (U+007B LEFT CURLY BRACKET) +# }} A literal } (U+007D RIGHT CURLY BRACKET) + +# 'Read more...' for the index page, if INDEX_TEASERS is True (translatable) +INDEX_READ_MORE_LINK = ${INDEX_READ_MORE_LINK} +# 'Read more...' for the RSS_FEED, if RSS_TEASERS is True (translatable) +RSS_READ_MORE_LINK = ${RSS_READ_MORE_LINK} # A HTML fragment describing the license, for the sidebar. +# (translatable) LICENSE = "" # I recommend using the Creative Commons' wizard: # http://creativecommons.org/choose/ @@ -364,24 +376,45 @@ LICENSE = "" # src="http://i.creativecommons.org/l/by-nc-sa/2.5/ar/88x31.png"></a>""" # A small copyright notice for the page footer (in HTML). +# (translatable) CONTENT_FOOTER = 'Contents © {date} \ <a href="mailto:{email}">{author}</a> - Powered by \ <a href="http://getnikola.com" rel="nofollow">Nikola</a> \ {license}' -CONTENT_FOOTER = CONTENT_FOOTER.format(email=BLOG_EMAIL, - author=BLOG_AUTHOR, - date=time.gmtime().tm_year, - license=LICENSE) + +# Things that will be passed to CONTENT_FOOTER.format(). This is done +# for translatability, as dicts are not formattable. Nikola will +# intelligently format the setting properly. +# The setting takes a dict. The keys are languages. The values are +# tuples of tuples of positional arguments and dicts of keyword arguments +# to format(). For example, {'en': (('Hello'), {'target': 'World'})} +# results in CONTENT_FOOTER['en'].format('Hello', target='World'). +# WARNING: If you do not use multiple languages with CONTENT_FOOTER, this +# still needs to be a dict of this format. (it can be empty if you +# do not need formatting) +# (translatable) +CONTENT_FOOTER_FORMATS = { + DEFAULT_LANG: ( + (), + { + "email": BLOG_EMAIL, + "author": BLOG_AUTHOR, + "date": time.gmtime().tm_year, + "license": LICENSE + } + ) +} # To use comments, you can choose between different third party comment -# systems, one of "disqus", "livefyre", "intensedebate", "moot", -# "googleplus", "facebook" or "isso" -# COMMENT_SYSTEM = ${COMMENT_SYSTEM} +# systems. The following comment systems are supported by Nikola: +${_SUPPORTED_COMMENT_SYSTEMS} +# You can leave this option blank to disable comments. +COMMENT_SYSTEM = ${COMMENT_SYSTEM} # And you also need to add your COMMENT_SYSTEM_ID which # depends on what comment system you use. The default is # "nikolademo" which is a test account for Disqus. More information # is in the manual. -# COMMENT_SYSTEM_ID = ${COMMENT_SYSTEM_ID} +COMMENT_SYSTEM_ID = ${COMMENT_SYSTEM_ID} # Enable annotations using annotateit.org? # If set to False, you can still enable them for individual posts and pages @@ -418,6 +451,12 @@ CONTENT_FOOTER = CONTENT_FOOTER.format(email=BLOG_EMAIL, # if /2012 includes any files (including index.html)... add it to the sitemap # SITEMAP_INCLUDE_FILELESS_DIRS = True +# List of files relative to the server root (!) that will be asked to be excluded +# from indexing and other robotic spidering. * is supported. Will only be effective +# if SITE_URL points to server root. The list is used to exclude resources from +# /robots.txt and /sitemap.xml, and to inform search engines about /sitemapindex.xml. +# ROBOTS_EXCLUSIONS = ["/archive.html", "/category/*.html"] + # Instead of putting files in <slug>.html, put them in # <slug>/index.html. Also enables STRIP_INDEXES # This can be disabled on a per-page/post basis by adding @@ -441,27 +480,25 @@ CONTENT_FOOTER = CONTENT_FOOTER.format(email=BLOG_EMAIL, # SCHEDULE_RULE = '' # If True, use the scheduling rule to all posts by default # SCHEDULE_ALL = False -# If True, schedules post to today if possible, even if scheduled hour is over -# SCHEDULE_FORCE_TODAY = False # Do you want a add a Mathjax config file? # MATHJAX_CONFIG = "" # If you are using the compile-ipynb plugin, just add this one: -#MATHJAX_CONFIG = """ -#<script type="text/x-mathjax-config"> -#MathJax.Hub.Config({ -# tex2jax: { -# inlineMath: [ ['$','$'], ["\\\(","\\\)"] ], -# displayMath: [ ['$$','$$'], ["\\\[","\\\]"] ] -# }, -# displayAlign: 'left', // Change this to 'center' to center equations. -# "HTML-CSS": { -# styles: {'.MathJax_Display': {"margin": 0}} -# } -#}); -#</script> -#""" +# MATHJAX_CONFIG = """ +# <script type="text/x-mathjax-config"> +# MathJax.Hub.Config({ +# tex2jax: { +# inlineMath: [ ['$','$'], ["\\\(","\\\)"] ], +# displayMath: [ ['$$','$$'], ["\\\[","\\\]"] ] +# }, +# displayAlign: 'left', // Change this to 'center' to center equations. +# "HTML-CSS": { +# styles: {'.MathJax_Display': {"margin": 0}} +# } +# }); +# </script> +# """ # Do you want to customize the nbconversion of your IPython notebook? # IPYNB_CONFIG = {} @@ -469,13 +506,16 @@ CONTENT_FOOTER = CONTENT_FOOTER.format(email=BLOG_EMAIL, # called `toggle.tpl` which has to be located in your site/blog main folder: # IPYNB_CONFIG = {'Exporter':{'template_file': 'toggle'}} -# What MarkDown extensions to enable? +# What Markdown extensions to enable? # You will also get gist, nikola and podcast because those are # done in the code, hope you don't mind ;-) +# Note: most Nikola-specific extensions are done via the Nikola plugin system, +# with the MarkdownExtension class and should not be added here. # MARKDOWN_EXTENSIONS = ['fenced_code', 'codehilite'] # Social buttons. This is sample code for AddThis (which was the default for a # long time). Insert anything you want here, or even make it empty. +# (translatable) # SOCIAL_BUTTONS_CODE = """ # <!-- Social buttons --> # <div id="addthisbox" class="addthis_toolbox addthis_peekaboo_style addthis_default_style addthis_label_style addthis_32x32_style"> @@ -486,20 +526,25 @@ CONTENT_FOOTER = CONTENT_FOOTER.format(email=BLOG_EMAIL, # <li><a class="addthis_button_twitter"></a> # </ul> # </div> -# <script type="text/javascript" src="//s7.addthis.com/js/300/addthis_widget.js#pubid=ra-4f7088a56bb93798"></script> +# <script src="//s7.addthis.com/js/300/addthis_widget.js#pubid=ra-4f7088a56bb93798"></script> # <!-- End of social buttons --> # """ -# Hide link to source for the posts? -# HIDE_SOURCELINK = False +# Show link to source for the posts? +# Formerly known as HIDE_SOURCELINK (inverse) +# SHOW_SOURCELINK = True # Copy the source files for your pages? -# Setting it to False implies HIDE_SOURCELINK = True +# Setting it to False implies SHOW_SOURCELINK = False # COPY_SOURCES = True # Modify the number of Post per Index Page # Defaults to 10 # INDEX_DISPLAY_POST_COUNT = 10 +# By default, Nikola generates RSS files for the website and for tags, and +# links to it. Set this to False to disable everything RSS-related. +# GENERATE_RSS = True + # RSS_LINK is a HTML fragment to link the RSS or Atom feeds. If set to None, # the base.tmpl will use the feed Nikola generates. However, you may want to # change it for a feedburner feed or something else. @@ -508,83 +553,59 @@ CONTENT_FOOTER = CONTENT_FOOTER.format(email=BLOG_EMAIL, # Show only teasers in the RSS feed? Default to True # RSS_TEASERS = True +# Strip HTML in the RSS feed? Default to False +# RSS_PLAIN = False + # A search form to search this site, for the sidebar. You can use a google # custom search (http://www.google.com/cse/) # Or a duckduckgo search: https://duckduckgo.com/search_box.html # Default is no search form. +# (translatable) # SEARCH_FORM = "" # # This search form works for any site and looks good in the "site" theme where # it appears on the navigation bar: # -#SEARCH_FORM = """ -#<!-- Custom search --> -#<form method="get" id="search" action="http://duckduckgo.com/" -# class="navbar-form pull-left"> -#<input type="hidden" name="sites" value="%s"/> -#<input type="hidden" name="k8" value="#444444"/> -#<input type="hidden" name="k9" value="#D51920"/> -#<input type="hidden" name="kt" value="h"/> -#<input type="text" name="q" maxlength="255" -# placeholder="Search…" class="span2" style="margin-top: 4px;"/> -#<input type="submit" value="DuckDuckGo Search" style="visibility: hidden;" /> -#</form> -#<!-- End of custom search --> -#""" % SITE_URL +# SEARCH_FORM = """ +# <!-- Custom search --> +# <form method="get" id="search" action="//duckduckgo.com/" +# class="navbar-form pull-left"> +# <input type="hidden" name="sites" value="%s"/> +# <input type="hidden" name="k8" value="#444444"/> +# <input type="hidden" name="k9" value="#D51920"/> +# <input type="hidden" name="kt" value="h"/> +# <input type="text" name="q" maxlength="255" +# placeholder="Search…" class="span2" style="margin-top: 4px;"/> +# <input type="submit" value="DuckDuckGo Search" style="visibility: hidden;" /> +# </form> +# <!-- End of custom search --> +# """ % SITE_URL # # If you prefer a google search form, here's an example that should just work: -#SEARCH_FORM = """ -#<!-- Custom search with google--> -#<form id="search" action="http://google.com/search" method="get" class="navbar-form pull-left"> -#<input type="hidden" name="q" value="site:%s" /> -#<input type="text" name="q" maxlength="255" results="0" placeholder="Search"/> -#</form> -#<!-- End of custom search --> -#""" % SITE_URL - -# Also, there is a local search plugin you can use, based on Tipue, but it requires setting several -# options: - # SEARCH_FORM = """ -# <span class="navbar-form pull-left"> -# <input type="text" id="tipue_search_input"> -# </span>""" -# -# BODY_END = """ -# <script type="text/javascript" src="/assets/js/tipuesearch_set.js"></script> -# <script type="text/javascript" src="/assets/js/tipuesearch.js"></script> -# <script type="text/javascript"> -# $(document).ready(function() { - # $('#tipue_search_input').tipuesearch({ - # 'mode': 'json', - # 'contentLocation': '/assets/js/tipuesearch_content.json', - # 'showUrl': false - # }); -# }); -# </script> -# """ - -# EXTRA_HEAD_DATA = """ -# <link rel="stylesheet" type="text/css" href="/assets/css/tipuesearch.css"> -# <div id="tipue_search_content" style="margin-left: auto; margin-right: auto; padding: 20px;"></div> -# """ -# ENABLED_EXTRAS = ['local_search'] -# -###### End of local search example - +# <!-- Custom search with google--> +# <form id="search" action="//www.google.com/search" method="get" class="navbar-form pull-left"> +# <input type="hidden" name="q" value="site:%s" /> +# <input type="text" name="q" maxlength="255" results="0" placeholder="Search"/> +# </form> +# <!-- End of custom search --> +#""" % SITE_URL -# Use content distribution networks for jquery and twitter-bootstrap css and js -# If this is True, jquery is served from the Google CDN and twitter-bootstrap -# is served from the NetDNA CDN +# Use content distribution networks for jquery, twitter-bootstrap css and js, +# and html5shiv (for older versions of Internet Explorer) +# If this is True, jquery and html5shiv is served from the Google and twitter- +# bootstrap is served from the NetDNA CDN # Set this to False if you want to host your site without requiring access to # external resources. # USE_CDN = False # Extra things you want in the pages HEAD tag. This will be added right # before </head> +# (translatable) # EXTRA_HEAD_DATA = "" # Google Analytics or whatever else you use. Added to the bottom of <body> # in the default template (base.tmpl). +# (translatable) # BODY_END = "" # The possibility to extract metadata from the filename by using a @@ -602,12 +623,21 @@ CONTENT_FOOTER = CONTENT_FOOTER.format(email=BLOG_EMAIL, # '(?P<date>\d{4}-\d{2}-\d{2})-(?P<slug>.*)-(?P<title>.*)\.md' # FILE_METADATA_REGEXP = None +# If you hate "Filenames with Capital Letters and Spaces.md", you should +# set this to true. +UNSLUGIFY_TITLES = True + # Additional metadata that is added to a post when creating a new_post # ADDITIONAL_METADATA = {} -# Nikola supports Twitter Card summaries / Open Graph. -# Twitter cards make it possible for you to attach media to Tweets -# that link to your content. +# Nikola supports Open Graph Protocol data for enhancing link sharing and +# discoverability of your site on Facebook, Google+, and other services. +# Open Graph is enabled by default. +# USE_OPEN_GRAPH = True + +# Nikola supports Twitter Card summaries +# Twitter cards are disabled by default. They make it possible for you to +# attach media to Tweets that link to your content. # # IMPORTANT: # Please note, that you need to opt-in for using Twitter Cards! @@ -619,7 +649,7 @@ CONTENT_FOOTER = CONTENT_FOOTER.format(email=BLOG_EMAIL, # over the cleartext username. Specifying an ID is not necessary. # Displaying images is currently not supported. # TWITTER_CARD = { -# # 'use_twitter_cards': True, # enable Twitter Cards / Open Graph +# # 'use_twitter_cards': True, # enable Twitter Cards # # 'site': '@website', # twitter nick for the website # # 'site:id': 123456, # Same as site, but the website's Twitter user ID # # instead. @@ -627,17 +657,6 @@ CONTENT_FOOTER = CONTENT_FOOTER.format(email=BLOG_EMAIL, # # 'creator:id': 654321, # Same as creator, but the Twitter user's ID. # } - -# Post's dates are considered in UTC by default, if you want to use -# another time zone, please set TIMEZONE to match. Check the available -# list from Wikipedia: -# http://en.wikipedia.org/wiki/List_of_tz_database_time_zones -# (eg. 'Europe/Zurich') -# Also, if you want to use a different time zone in some of your posts, -# you can use W3C-DTF Format (ex. 2012-03-30T23:00:00+02:00) -# -# TIMEZONE = 'UTC' - # If webassets is installed, bundle JS and CSS to make site loading faster # USE_BUNDLES = True @@ -649,16 +668,6 @@ CONTENT_FOOTER = CONTENT_FOOTER.format(email=BLOG_EMAIL, # repository. # EXTRA_PLUGINS_DIRS = [] -# Experimental plugins - use at your own risk. -# They probably need some manual adjustments - please see their respective -# readme. -# ENABLED_EXTRAS = [ -# 'planetoid', -# 'ipynb', -# 'local_search', -# 'render_mustache', -# ] - # List of regular expressions, links matching them will always be considered # valid by "nikola check -l" # LINK_CHECK_WHITELIST = [] @@ -675,18 +684,23 @@ CONTENT_FOOTER = CONTENT_FOOTER.format(email=BLOG_EMAIL, # DEMOTE_HEADERS = 1 # You can configure the logging handlers installed as plugins or change the -# log level of the default stdout handler. +# log level of the default stderr handler. +# WARNING: The stderr handler allows only the loglevels of 'INFO' and 'DEBUG'. +# This is done for safety reasons, as blocking out anything other +# than 'DEBUG' may hide important information and break the user +# experience! + LOGGING_HANDLERS = { - 'stderr': {'loglevel': 'WARNING', 'bubble': True}, - #'smtp': { - # 'from_addr': 'test-errors@example.com', - # 'recipients': ('test@example.com'), - # 'credentials':('testusername', 'password'), - # 'server_addr': ('127.0.0.1', 25), - # 'secure': (), - # 'level': 'DEBUG', - # 'bubble': True - #} + 'stderr': {'loglevel': 'INFO', 'bubble': True}, + # 'smtp': { + # 'from_addr': 'test-errors@example.com', + # 'recipients': ('test@example.com'), + # 'credentials':('testusername', 'password'), + # 'server_addr': ('127.0.0.1', 25), + # 'secure': (), + # 'level': 'DEBUG', + # 'bubble': True + # } } # Templates will use those filters, along with the defaults. |