diff options
author | Unit 193 <unit193@ubuntu.com> | 2015-11-07 15:09:53 -0500 |
---|---|---|
committer | Unit 193 <unit193@ubuntu.com> | 2015-11-07 15:09:53 -0500 |
commit | 0e3a5075a99ebfc95eefca3ac41cf71eeaaa3eb9 (patch) | |
tree | 161cd512ff32515f1800fc1e556eebc10db2e7a3 | |
parent | 4156ab451c075fc309668894bd28ad98d5038da5 (diff) | |
download | unit193.net-0e3a5075a99ebfc95eefca3ac41cf71eeaaa3eb9.tar.bz2 unit193.net-0e3a5075a99ebfc95eefca3ac41cf71eeaaa3eb9.tar.xz unit193.net-0e3a5075a99ebfc95eefca3ac41cf71eeaaa3eb9.tar.zst |
Merge latest conf.py changes.
-rw-r--r-- | conf.py | 368 |
1 files changed, 297 insertions, 71 deletions
@@ -22,9 +22,9 @@ BLOG_TITLE = "Unit 193's corner of the internet" # (translatable) # This is the main URL for your site. It will be used # in a prominent link SITE_URL = "https://unit193.net/" -# This is the URL where nikola's output will be deployed. +# This is the URL where Nikola's output will be deployed. # If not set, defaults to SITE_URL -# BASE_URL = "https://unit193.net/icebox/" +# BASE_URL = "https://unit193.net/" BLOG_EMAIL = "unit193@unit193.net" #BLOG_DESCRIPTION = "" # (translatable) @@ -33,9 +33,12 @@ BLOG_EMAIL = "unit193@unit193.net" # Currently supported languages are: # # en English +# ar Arabic +# az Azerbaijani # bg Bulgarian # ca Catalan # cs Czech [ALTERNATIVELY cz] +# da Danish # de German # el Greek [NOT gr] # eo Esperanto @@ -47,8 +50,10 @@ BLOG_EMAIL = "unit193@unit193.net" # fr French # hi Hindi # hr Croatian +# id Indonesian # it Italian # ja Japanese [NOT jp] +# ko Korean # nb Norwegian Bokmål # nl Dutch # pl Polish @@ -56,7 +61,10 @@ BLOG_EMAIL = "unit193@unit193.net" # ru Russian # sk Slovak # sl Slovene +# sr Serbian (Cyrillic) +# sv Swedish # tr Turkish [NOT tr_TR] +# uk Ukrainian # ur Urdu # zh_cn Chinese (Simplified) # @@ -92,19 +100,26 @@ TRANSLATIONS_PATTERN = "{path}.{lang}.{ext}" # This is a dict. The keys are languages, and values are tuples. # # For regular links: -# ('http://example.com/', 'Text') +# ('https://getnikola.com/', 'Nikola Homepage') # # For submenus: -# (( -# ('Sub 1', 'http://example.com/'), -# ('Sub 2', 'http://example.org/'), -# ), 'Top') +# ( +# ( +# ('http://apple.com/', 'Apple'), +# ('http://orange.com/', 'Orange'), +# ), +# 'Fruits' +# ) # # WARNING: Support for submenus is theme-dependent. # Only one level of submenus is supported. # WARNING: Some themes, including the default Bootstrap 3 theme, # may present issues if the menu is too large. # (in bootstrap3, the navbar can grow too large and cover contents.) +# WARNING: If you link to directories, make sure to follow +# ``STRIP_INDEXES``. If it’s set to ``True``, end your links +# with a ``/``, otherwise end them with ``/index.html`` — or +# else they won’t be highlighted when active. NAVIGATION_LINKS = { DEFAULT_LANG: ( @@ -128,7 +143,6 @@ NAVIGATION_LINKS = { } # Name of the theme to use. -#THEME = "bootstrap3" THEME = "custom" # Below this point, everything is optional @@ -137,7 +151,7 @@ THEME = "custom" # 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') +# (e.g. '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 = "America/New_York" @@ -151,13 +165,26 @@ TIMEZONE = "America/New_York" # (str used by datetime.datetime.strftime) # DATE_FORMAT = '%Y-%m-%d %H:%M' -# While nikola can select a sensible locale for each language, +# Date format used to display post dates, if local dates are used. +# (str used by moment.js) +# JS_DATE_FORMAT = 'YYYY-MM-DD HH:mm' + +# Date fanciness. +# +# 0 = using DATE_FORMAT and TIMEZONE +# 1 = using JS_DATE_FORMAT and local user time (via moment.js) +# 2 = using a string like “2 days ago” +# +# Your theme must support it, bootstrap and bootstrap3 already do. +# DATE_FANCINESS = 0 + +# 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 # python's locales will accept in your OS, by example -# "en_US.utf8" in unix-like OS, "English_United States" in Windows. +# "en_US.utf8" in Unix-like OS, "English_United States" in Windows. # LOCALES = dict mapping language --> explicit locale for the languages -# in TRANSLATIONS. You can ommit one or more keys. +# in TRANSLATIONS. You can omit one or more keys. # LOCALE_FALLBACK = locale to use when an explicit locale is unavailable # LOCALE_DEFAULT = locale to use for languages not mentioned in LOCALES; if # not set the default Nikola mapping is used. @@ -168,7 +195,7 @@ TIMEZONE = "America/New_York" # (whatever/thing.txt). # # That fragment could have an associated metadata file (whatever/thing.meta), -# and optionally translated files (example for spanish, with code "es"): +# and optionally translated files (example for Spanish, with code "es"): # whatever/thing.es.txt and whatever/thing.es.meta # # This assumes you use the default TRANSLATIONS_PATTERN. @@ -176,7 +203,7 @@ TIMEZONE = "America/New_York" # From those files, a set of HTML fragment files will be generated: # cache/whatever/thing.html (and maybe cache/whatever/thing.html.es) # -# These files are combinated with the template to produce rendered +# These files are combined with the template to produce rendered # pages, which will be placed at # output / TRANSLATIONS[lang] / destination / pagename.html # @@ -197,18 +224,24 @@ PAGES = ( ) # One or more folders containing files to be copied as-is into the output. -# The format is a dictionary of "source" "relative destination". +# The format is a dictionary of {source: relative destination}. # Default is: -# FILES_FOLDERS = {'files': '' } +# FILES_FOLDERS = {'files': ''} # Which means copy 'files' into 'output' +# One or more folders containing listings to be processed and stored into +# the output. The format is a dictionary of {source: relative destination}. +# Default is: +# LISTINGS_FOLDERS = {'listings': 'listings'} +# Which means process listings from 'listings' into 'output/listings' + # A mapping of languages to file-extensions that represent that language. # Feel free to add or delete extensions to any list, but don't add any new # compilers unless you write the interface for it yourself. # # 'rest' is reStructuredText # 'markdown' is MarkDown -# 'html' assumes the file is html and just copies it +# 'html' assumes the file is HTML and just copies it COMPILERS = { "asciidoc": ('.asciidoc', '.txt'), "rest": ('.rst',), @@ -249,6 +282,10 @@ LOGO_URL = '/logo.png' # already contains the text), set this to False. SHOW_BLOG_TITLE = False +# Writes tag cloud data in form of tag_cloud_data.json. +# Warning: this option will change its default value to False in v8! +WRITE_TAG_CLOUD = True + # Paths for different autogenerated bits. These are combined with the # translation paths. @@ -262,6 +299,64 @@ SHOW_BLOG_TITLE = False # the posts themselves. If set to False, it will be just a list of links. # TAG_PAGES_ARE_INDEXES = False +# Set descriptions for tag pages to make them more interesting. The +# default is no description. The value is used in the meta description +# and displayed underneath the tag list or index page’s title. +# TAG_PAGES_DESCRIPTIONS = { +# DEFAULT_LANG: { +# "blogging": "Meta-blog posts about blogging about blogging.", +# "open source": "My contributions to my many, varied, ever-changing, and eternal libre software projects." +# }, +#} + + +# If you do not want to display a tag publicly, you can mark it as hidden. +# The tag will not be displayed on the tag list page, the tag cloud and posts. +# Tag pages will still be generated. +HIDDEN_TAGS = ['mathjax'] + +# Only include tags on the tag list/overview page if there are at least +# TAGLIST_MINIMUM_POSTS number of posts or more with every tag. Every tag +# page is still generated, linked from posts, and included in the sitemap. +# However, more obscure tags can be hidden from the tag index page. +# TAGLIST_MINIMUM_POSTS = 1 + +# Final locations are: +# output / TRANSLATION[lang] / CATEGORY_PATH / index.html (list of categories) +# output / TRANSLATION[lang] / CATEGORY_PATH / CATEGORY_PREFIX category.html (list of posts for a category) +# output / TRANSLATION[lang] / CATEGORY_PATH / CATEGORY_PREFIX category.xml (RSS feed for a category) +# CATEGORY_PATH = "categories" +# CATEGORY_PREFIX = "cat_" + +# If CATEGORY_ALLOW_HIERARCHIES is set to True, categories can be organized in +# hierarchies. For a post, the whole path in the hierarchy must be specified, +# using a forward slash ('/') to separate paths. Use a backslash ('\') to escape +# a forward slash or a backslash (i.e. '\//\\' is a path specifying the +# subcategory called '\' of the top-level category called '/'). +# CATEGORY_ALLOW_HIERARCHIES = False +# If CATEGORY_OUTPUT_FLAT_HIERARCHY is set to True, the output written to output +# contains only the name of the leaf category and not the whole path. +# CATEGORY_OUTPUT_FLAT_HIERARCHY = False + +# If CATEGORY_PAGES_ARE_INDEXES is set to True, each category's page will contain +# the posts themselves. If set to False, it will be just a list of links. +# CATEGORY_PAGES_ARE_INDEXES = False + +# Set descriptions for category pages to make them more interesting. The +# default is no description. The value is used in the meta description +# and displayed underneath the category list or index page’s title. +# CATEGORY_PAGES_DESCRIPTIONS = { +# DEFAULT_LANG: { +# "blogging": "Meta-blog posts about blogging about blogging.", +# "open source": "My contributions to my many, varied, ever-changing, and eternal libre software projects." +# }, +#} + +# If you do not want to display a category publicly, you can mark it as hidden. +# The category will not be displayed on the category list page. +# Category pages will still be generated. +HIDDEN_CATEGORIES = [] + # Final location for the main blog page and sibling paginated pages is # output / TRANSLATION[lang] / INDEX_PATH / index-*.html INDEX_PATH = "posts" @@ -270,13 +365,24 @@ INDEX_PATH = "posts" # CREATE_MONTHLY_ARCHIVE = False # Create one large archive instead of per-year # CREATE_SINGLE_ARCHIVE = False +# Create year, month, and day archives each with a (long) list of posts +# (overrides both CREATE_MONTHLY_ARCHIVE and CREATE_SINGLE_ARCHIVE) +# CREATE_FULL_ARCHIVES = False +# If monthly archives or full archives are created, adds also one archive per day +# CREATE_DAILY_ARCHIVE = False # Final locations for the archives are: # output / TRANSLATION[lang] / ARCHIVE_PATH / ARCHIVE_FILENAME # output / TRANSLATION[lang] / ARCHIVE_PATH / YEAR / index.html # output / TRANSLATION[lang] / ARCHIVE_PATH / YEAR / MONTH / index.html +# output / TRANSLATION[lang] / ARCHIVE_PATH / YEAR / MONTH / DAY / index.html # ARCHIVE_PATH = "" # ARCHIVE_FILENAME = "archive.html" +# If ARCHIVES_ARE_INDEXES is set to True, each archive page which contains a list +# of posts will contain the posts themselves. If set to False, it will be just a +# list of links. +# ARCHIVES_ARE_INDEXES = False + # URLs to other posts/pages can take 3 forms: # rel_path: a relative URL to the current page/post (default) # full_path: a URL with the full path from the root @@ -303,15 +409,23 @@ URL_TYPE = 'full_path' # If you don't need any of these, just set to [] REDIRECTIONS = [] -# Commands to execute to deploy. Can be anything, for example, -# you may use rsync: +# Presets of commands to execute to deploy. Can be anything, for +# example, you may use rsync: # "rsync -rav --delete output/ joe@my.site:/srv/www/site" # And then do a backup, or run `nikola ping` from the `ping` -# plugin (`nikola install_plugin ping`). -# To do manual deployment, set it to [] -# DEPLOY_COMMANDS = [] +# plugin (`nikola plugin -i ping`). Or run `nikola check -l`. +# You may also want to use github_deploy (see below). +# You can define multiple presets and specify them as arguments +# to `nikola deploy`. If no arguments are specified, a preset +# named `default` will be executed. You can use as many presets +# in a `nikola deploy` command as you like. +# DEPLOY_COMMANDS = { +# 'default': [ +# "rsync -rav --delete output/ joe@my.site:/srv/www/site", +# ] +# } -# For user.github.io/organization.github.io pages, the DEPLOY branch +# For user.github.io OR 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' @@ -349,7 +463,7 @@ REDIRECTIONS = [] # Nikola’s templates. All other filters must be enabled through FILTERS. # # Many filters are shipped with Nikola. A list is available in the manual: -# <http://getnikola.com/handbook.html#post-processing-filters> +# <https://getnikola.com/handbook.html#post-processing-filters> # # from nikola import filters # FILTERS = { @@ -362,7 +476,7 @@ REDIRECTIONS = [] # side optimization for very high traffic sites or low memory servers. # GZIP_FILES = False # File extensions that will be compressed -# GZIP_EXTENSIONS = ('.txt', '.htm', '.html', '.css', '.js', '.json', '.xml') +# GZIP_EXTENSIONS = ('.txt', '.htm', '.html', '.css', '.js', '.json', '.atom', '.xml') # Use an external gzip command? None means no. # Example: GZIP_COMMAND = "pigz -k {filename}" # GZIP_COMMAND = None @@ -389,9 +503,13 @@ REDIRECTIONS = [] # Image Gallery Options # ############################################################################# -# Galleries are folders in galleries/ -# Final location of galleries will be output / GALLERY_PATH / gallery_name -# GALLERY_PATH = "galleries" +# One or more folders containing galleries. The format is a dictionary of +# {"source": "relative_destination"}, where galleries are looked for in +# "source/" and the results will be located in +# "OUTPUT_PATH/relative_destination/gallery_name" +# Default is: +# GALLERY_FOLDERS = {"galleries": "galleries"} +# More gallery options: # THUMBNAIL_SIZE = 180 # MAX_IMAGE_SIZE = 1280 # USE_FILENAME_AS_TITLE = True @@ -399,23 +517,94 @@ REDIRECTIONS = [] # # If set to False, it will sort by filename instead. Defaults to True # GALLERY_SORT_BY_DATE = True +# +# Folders containing images to be used in normal posts or pages. Images will be +# scaled down according to IMAGE_THUMBNAIL_SIZE and MAX_IMAGE_SIZE options, but +# will have to be referenced manually to be visible on the site +# (the thumbnail has ``.thumbnail`` added before the file extension). +# The format is a dictionary of {source: relative destination}. + +IMAGE_FOLDERS = {'images': 'images'} +# IMAGE_THUMBNAIL_SIZE = 400 # ############################################################################# # HTML fragments and diverse things that are used by the templates # ############################################################################# # Data about post-per-page indexes. -# INDEXES_PAGES defaults to 'old posts, page %d' or 'page %d' (translated), +# INDEXES_PAGES defaults to ' old posts, page %d' or ' page %d' (translated), # depending on the value of INDEXES_PAGES_MAIN. -# 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) +# +# (translatable) If the following is empty, defaults to BLOG_TITLE: +# INDEXES_TITLE = "" +# +# (translatable) If the following is empty, defaults to ' [old posts,] page %d' (see above): +# INDEXES_PAGES = "" +# +# If the following is True, INDEXES_PAGES is also displayed on the main (the +# newest) index page (index.html): +# INDEXES_PAGES_MAIN = False +# +# If the following is True, index-1.html has the oldest posts, index-2.html the +# second-oldest posts, etc., and index.html has the newest posts. This ensures +# that all posts on index-x.html will forever stay on that page, now matter how +# many new posts are added. +# If False, index-1.html has the second-newest posts, index-2.html the third-newest, +# and index-n.html the oldest posts. When this is active, old posts can be moved +# to other index pages when new posts are added. +# INDEXES_STATIC = True +# +# (translatable) If PRETTY_URLS is set to True, this setting will be used to create +# prettier URLs for index pages, such as page/2/index.html instead of index-2.html. +# Valid values for this settings are: +# * False, +# * a list or tuple, specifying the path to be generated, +# * a dictionary mapping languages to lists or tuples. +# Every list or tuple must consist of strings which are used to combine the path; +# for example: +# ['page', '{number}', '{index_file}'] +# The replacements +# {number} --> (logical) page number; +# {old_number} --> the page number inserted into index-n.html before (zero for +# the main page); +# {index_file} --> value of option INDEX_FILE +# are made. +# Note that in case INDEXES_PAGES_MAIN is set to True, a redirection will be created +# for the full URL with the page number of the main page to the normal (shorter) main +# page URL. +# INDEXES_PRETTY_PAGE_URL = False # Color scheme to be used for code blocks. If your theme provides # "assets/css/code.css" this is ignored. -# Can be any of autumn borland bw colorful default emacs friendly fruity manni -# monokai murphy native pastie perldoc rrt tango trac vim vs +# Can be any of: +# algol +# algol_nu +# arduino +# autumn +# borland +# bw +# colorful +# default +# emacs +# friendly +# fruity +# igor +# lovelace +# manni +# monokai +# murphy +# native +# paraiso_dark +# paraiso_light +# pastie +# perldoc +# rrt +# tango +# trac +# vim +# vs +# xcode +# This list MAY be incomplete since pygments adds styles every now and then. # CODE_COLOR_SCHEME = 'default' # If you use 'site-reveal' theme you can select several subthemes @@ -428,12 +617,12 @@ REDIRECTIONS = [] # You can also use: page/concave/linear/none/default # FAVICONS contains (name, file, size) tuples. -# Used for create favicon link like this: +# Used to create favicon link like this: # <link rel="name" href="file" sizes="size"/> -# FAVICONS = { +# FAVICONS = ( # ("icon", "/favicon.ico", "16x16"), # ("icon", "/icon_128x128.png", "128x128"), -# } +# ) # Show only teasers in the index pages? Defaults to False. # INDEX_TEASERS = False @@ -455,6 +644,16 @@ INDEX_READ_MORE_LINK = '<p class="more"><a href="{link}">{read_more}…</a></p>' # 'Read more...' for the RSS_FEED, if RSS_TEASERS is True (translatable) RSS_READ_MORE_LINK = '<p><a href="{link}">{read_more}…</a> ({min_remaining_read})</p>' +# Append a URL query to the RSS_READ_MORE_LINK in Atom and RSS feeds. Advanced +# option used for traffic source tracking. +# Minimum example for use with Piwik: "pk_campaign=feed" +# The following tags exist and are replaced for you: +# {feedRelUri} A relative link to the feed. +# {feedFormat} The name of the syndication format. +# Example using replacement for use with Google Analytics: +# "utm_source={feedRelUri}&utm_medium=nikola_feed&utm_campaign={feedFormat}_feed" +RSS_LINKS_APPEND_QUERY = False + # A HTML fragment describing the license, for the sidebar. # (translatable) LICENSE = "" @@ -468,7 +667,7 @@ LICENSE = "" # 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 = 'Contents © {date} <a href="mailto:{email}">{author}</a> – Powered by <a href="https://getnikola.com" rel="nofollow">Nikola</a> {license}' # Things that will be passed to CONTENT_FOOTER.format(). This is done # for translatability, as dicts are not formattable. Nikola will @@ -511,8 +710,8 @@ COMMENT_SYSTEM_ID = "" # the "noannotations" metadata. # ANNOTATIONS = False -# Create index.html for story folders? -# WARNING: if a story would conflict with the index file (usually +# Create index.html for page (story) folders? +# WARNING: if a page would conflict with the index file (usually # caused by setting slug to `index`), the STORY_INDEX # will not be generated for that directory. # STORY_INDEX = False @@ -548,11 +747,11 @@ COMMENT_SYSTEM_ID = "" # /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 +# Instead of putting files in <slug>.html, put them in <slug>/index.html. +# No web server configuration is required. Also enables STRIP_INDEXES. # This can be disabled on a per-page/post basis by adding # .. pretty_url: False -# to the metadata +# to the metadata. PRETTY_URLS = True # If True, publish future dated posts right away instead of scheduling them. @@ -581,7 +780,8 @@ PRETTY_URLS = True # MathJax.Hub.Config({ # tex2jax: { # inlineMath: [ ['$','$'], ["\\\(","\\\)"] ], -# displayMath: [ ['$$','$$'], ["\\\[","\\\]"] ] +# displayMath: [ ['$$','$$'], ["\\\[","\\\]"] ], +# processEscapes: true # }, # displayAlign: 'left', // Change this to 'center' to center equations. # "HTML-CSS": { @@ -593,7 +793,7 @@ PRETTY_URLS = True # Do you want to customize the nbconversion of your IPython notebook? # IPYNB_CONFIG = {} -# With the following example configuracion you can use a custom jinja template +# With the following example configuration you can use a custom jinja template # called `toggle.tpl` which has to be located in your site/blog main folder: # IPYNB_CONFIG = {'Exporter':{'template_file': 'toggle'}} @@ -602,10 +802,17 @@ PRETTY_URLS = True # 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'] +# The default is ['fenced_code', 'codehilite'] +MARKDOWN_EXTENSIONS = ['fenced_code', 'codehilite', 'extra'] + +# Extra options to pass to the pandoc comand. +# by default, it's empty, is a list of strings, for example +# ['-F', 'pandoc-citeproc', '--bibliography=/Users/foo/references.bib'] +# PANDOC_OPTIONS = [] # 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. +# long time). Insert anything you want here, or even make it empty (which is +# the default right now) # (translatable) SOCIAL_BUTTONS_CODE = "" # <!-- Social buttons --> @@ -636,20 +843,29 @@ COPY_SOURCES = False # links to it. Set this to False to disable everything RSS-related. # GENERATE_RSS = True +# By default, Nikola does not generates Atom files for indexes and links to +# them. Generate Atom for tags by setting TAG_PAGES_ARE_INDEXES to True. +# Atom feeds are built based on INDEX_DISPLAY_POST_COUNT and not FEED_LENGTH +# Switch between plain-text summaries and full HTML content using the +# RSS_TEASER option. RSS_LINKS_APPEND_QUERY is also respected. Atom feeds +# are generated even for old indexes and have pagination link relations +# between each other. Old Atom feeds with no changes are marked as archived. +# GENERATE_ATOM = False + # 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. +# change it for a FeedBurner feed or something else. # RSS_LINK = None -# Show only teasers in the RSS feed? Default to True +# Show only teasers in the RSS and Atom feeds? 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 +# 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 +# Or a DuckDuckGo search: https://duckduckgo.com/search_box.html # Default is no search form. # (translatable) # SEARCH_FORM = "" @@ -672,9 +888,9 @@ COPY_SOURCES = False # <!-- End of custom search --> # """ % SITE_URL # -# If you prefer a google search form, here's an example that should just work: +# If you prefer a Google search form, here's an example that should just work: # SEARCH_FORM = """ -# <!-- Custom search with google--> +# <!-- 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"/> @@ -682,14 +898,20 @@ COPY_SOURCES = False # <!-- End of custom search --> #""" % SITE_URL -# Use content distribution networks for jquery, twitter-bootstrap css and js, +# 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 +# If this is True, jQuery and html5shiv are served from the Google CDN and +# Bootstrap is served from BootstrapCDN (provided by MaxCDN) # Set this to False if you want to host your site without requiring access to # external resources. # USE_CDN = False +# Check for USE_CDN compatibility. +# If you are using custom themes, have configured the CSS properly and are +# receiving warnings about incompatibility but believe they are incorrect, you +# can set this to False. +# USE_CDN_WARNING = True + # Extra things you want in the pages HEAD tag. This will be added right # before </head> # (translatable) @@ -726,29 +948,28 @@ ADDITIONAL_METADATA = {'hidetitle': 'True'} # 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. +# Nikola supports Twitter Card summaries, but they 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! -# To do this please visit -# https://dev.twitter.com/form/participate-twitter-cards +# To do this please visit https://cards-dev.twitter.com/validator # # Uncomment and modify to following lines to match your accounts. -# Specifying the id for either 'site' or 'creator' will be preferred -# over the cleartext username. Specifying an ID is not necessary. -# Displaying images is currently not supported. +# Images displayed come from the `previewimage` meta tag. +# You can specify the card type by using the `card` parameter in TWITTER_CARD. # TWITTER_CARD = { # # '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. -# # 'creator': '@username', # Username for the content creator / author. -# # 'creator:id': 654321, # Same as creator, but the Twitter user's ID. +# # 'card': 'summary', # Card type, you can also use 'summary_large_image', +# # see https://dev.twitter.com/cards/types +# # 'site': '@website', # twitter nick for the website +# # 'creator': '@username', # Username for the content creator / author. # } -# If webassets is installed, bundle JS and CSS to make site loading faster +# If webassets is installed, bundle JS and CSS into single files to make +# site loading faster in a HTTP/1.1 environment but is not recommended for +# HTTP/2.0 when caching is used. Defaults to True. # USE_BUNDLES = True # Plugins you don't want to use. Be careful :-) @@ -808,3 +1029,8 @@ LOGGING_HANDLERS = { # Put in global_context things you want available on all your templates. # It can be anything, data, functions, modules, etc. GLOBAL_CONTEXT = {} + +# Add functions here and they will be called with template +# GLOBAL_CONTEXT as parameter when the template is about to be +# rendered +GLOBAL_CONTEXT_FILLER = [] |