spacepaste

  1.  
  2. '''
  3. | conf.py
  4. |
  5. +---output
  6. | | archive.html
  7. | | robots.txt
  8. | | sitemap.xml
  9. | | sitemapindex.xml
  10. | |
  11. | |
  12. | |
  13. | +---pages
  14. | | \---the-test
  15. | | index.html
  16. | | index.md
  17. | |
  18. | \---posts
  19. | | index.html
  20. | |
  21. | \---starting
  22. | index.html
  23. | index.md
  24. |
  25. +---pages
  26. | the-test.md
  27. |
  28. \---posts
  29. starting.md
  30. '''
  31. # -*- coding: utf-8 -*-
  32. from __future__ import unicode_literals
  33. import time
  34. # !! This is the configuration of Nikola. !! #
  35. # !! You should edit it to your liking. !! #
  36. # ! Some settings can be different in different languages.
  37. # ! A comment stating (translatable) is used to denote those.
  38. # ! There are two ways to specify a translatable setting:
  39. # ! (a) BLOG_TITLE = "My Blog"
  40. # ! (b) BLOG_TITLE = {"en": "My Blog", "es": "Mi Blog"}
  41. # ! Option (a) is used when you don't want that setting translated.
  42. # ! Option (b) is used for settings that are different in different languages.
  43. # Data about this site
  44. BLOG_AUTHOR = "elnuno" # (translatable)
  45. BLOG_TITLE = "The Corf" # (translatable)
  46. # This is the main URL for your site. It will be used
  47. # in a prominent link. Don't forget the protocol (http/https)!
  48. SITE_URL = "http://127.0.0.1:8000/"
  49. # This is the URL where Nikola's output will be deployed.
  50. # If not set, defaults to SITE_URL
  51. # BASE_URL = "https://127.0.0.1/"
  52. BLOG_EMAIL = "elnuno@nonya.bizz"
  53. BLOG_DESCRIPTION = "Test site for storing spam/abuse reports." # (translatable)
  54. # Nikola is multilingual!
  55. #
  56. # What is the default language?
  57. DEFAULT_LANG = "en"
  58. # What other languages do you have?
  59. # The format is {"translationcode" : "path/to/translation" }
  60. # the path will be used as a prefix for the generated pages location
  61. TRANSLATIONS = {
  62. DEFAULT_LANG: "",
  63. # Example for another language:
  64. # "es": "./es",
  65. }
  66. TRANSLATIONS_PATTERN = "{path}.{lang}.{ext}"
  67. # Links for the sidebar / navigation bar. (translatable)
  68. # This is a dict. The keys are languages, and values are tuples.
  69. #
  70. # For regular links:
  71. # ('https://getnikola.com/', 'Nikola Homepage')
  72. #
  73. # For submenus:
  74. # (
  75. # (
  76. # ('https://apple.com/', 'Apple'),
  77. # ('https://orange.com/', 'Orange'),
  78. # ),
  79. # 'Fruits'
  80. # )
  81. #
  82. # WARNING: Support for submenus is theme-dependent.
  83. # Only one level of submenus is supported.
  84. # WARNING: Some themes, including the default Bootstrap 3 theme,
  85. # may present issues if the menu is too large.
  86. # (in bootstrap3, the navbar can grow too large and cover contents.)
  87. # WARNING: If you link to directories, make sure to follow
  88. # ``STRIP_INDEXES``. If it’s set to ``True``, end your links
  89. # with a ``/``, otherwise end them with ``/index.html`` — or
  90. # else they won’t be highlighted when active.
  91. NAVIGATION_LINKS = {
  92. DEFAULT_LANG: (
  93. ("/archive.html", "Archive"),
  94. ("/pages/", "Pages"),
  95. ("/posts/", "Cases"),
  96. ("/categories/", "Tags"),
  97. ),
  98. }
  99. # Name of the theme to use.
  100. THEME = "bootstrap3"
  101. # Primary color of your theme. This will be used to customize your theme and
  102. # auto-generate related colors in POSTS_SECTION_COLORS. Must be a HEX value.
  103. THEME_COLOR = '#5670d4'
  104. # POSTS and PAGES contains (wildcard, destination, template) tuples.
  105. # (translatable)
  106. #
  107. # The wildcard is used to generate a list of source files
  108. # (whatever/thing.rst, for example).
  109. #
  110. # That fragment could have an associated metadata file (whatever/thing.meta),
  111. # and optionally translated files (example for Spanish, with code "es"):
  112. # whatever/thing.es.rst and whatever/thing.es.meta
  113. #
  114. # This assumes you use the default TRANSLATIONS_PATTERN.
  115. #
  116. # From those files, a set of HTML fragment files will be generated:
  117. # cache/whatever/thing.html (and maybe cache/whatever/thing.html.es)
  118. #
  119. # These files are combined with the template to produce rendered
  120. # pages, which will be placed at
  121. # output/TRANSLATIONS[lang]/destination/pagename.html
  122. #
  123. # where "pagename" is the "slug" specified in the metadata file.
  124. # The page might also be placed in /destination/pagename/index.html
  125. # if PRETTY_URLS are enabled.
  126. #
  127. # The difference between POSTS and PAGES is that POSTS are added
  128. # to feeds, indexes, tag lists and archives and are considered part
  129. # of a blog, while PAGES are just independent HTML pages.
  130. #
  131. # Finally, note that destination can be translated, i.e. you can
  132. # specify a different translation folder per language. Example:
  133. # PAGES = (
  134. # ("pages/*.rst", {"en": "pages", "de": "seiten"}, "story.tmpl"),
  135. # ("pages/*.md", {"en": "pages", "de": "seiten"}, "story.tmpl"),
  136. # )
  137. POSTS = (
  138. ("posts/*.md", "posts", "post.tmpl"),
  139. ("posts/*.txt", "posts", "post.tmpl"),
  140. ("posts/*.html", "posts", "post.tmpl"),
  141. )
  142. PAGES = (
  143. ("pages/*.md", "pages", "story.tmpl"),
  144. ("pages/*.txt", "pages", "story.tmpl"),
  145. ("pages/*.html", "pages", "story.tmpl"),
  146. )
  147. # Paths (permalink) that should be processed by navstories plugin (path starting with /<variable>/, <variable> can contain /, e.g.: stories/b
  148. NAVSTORIES_PATHS = {
  149. DEFAULT_LANG: (
  150. 'pages',
  151. '/pages',
  152. ),
  153. }
  154. # Mapping "Toplevel in permalink" to "Visible text"
  155. # The order is as listed here, entries not listed here are included in the end, with the top level of the permalink as text
  156. NAVSTORIES_MAPPING = {
  157. DEFAULT_LANG: (
  158. # example (remove initial #):
  159. #("b", "Boo"),
  160. #("f", "Foo"),
  161. ),
  162. }
  163. # Indention for each level deeper in a submenu, than the highest level in that submenu, the submenu is flat, so it is only the menu text there are indented
  164. NAVSTORIES_SUBMENU_INDENTION = '* '
  165. # Static menu after dynamic navstories menu entries
  166. # Format just as NAVIGATION_LINKS, but content included after navstories entries
  167. NAVIGATION_LINKS_POST_NAVSTORIES = {
  168. DEFAULT_LANG: (
  169. ),
  170. }
  171. # Below this point, everything is optional
  172. # Post's dates are considered in UTC by default, if you want to use
  173. # another time zone, please set TIMEZONE to match. Check the available
  174. # list from Wikipedia:
  175. # https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
  176. # (e.g. 'Europe/Zurich')
  177. # Also, if you want to use a different time zone in some of your posts,
  178. # you can use the ISO 8601/RFC 3339 format (ex. 2012-03-30T23:00:00+02:00)
  179. TIMEZONE = "UTC"
  180. # If you want to use ISO 8601 (also valid RFC 3339) throughout Nikola
  181. # (especially in new_post), set this to True.
  182. # Note that this does not affect DATE_FORMAT.
  183. FORCE_ISO8601 = True
  184. # Date format used to display post dates. (translatable)
  185. # (str used by datetime.datetime.strftime)
  186. # DATE_FORMAT = '%Y-%m-%d %H:%M'
  187. # Date format used to display post dates, if local dates are used. (translatable)
  188. # (str used by moment.js)
  189. # JS_DATE_FORMAT = 'YYYY-MM-DD HH:mm'
  190. # Date fanciness.
  191. #
  192. # 0 = using DATE_FORMAT and TIMEZONE
  193. # 1 = using JS_DATE_FORMAT and local user time (via moment.js)
  194. # 2 = using a string like “2 days ago”
  195. #
  196. # Your theme must support it, bootstrap and bootstrap3 already do.
  197. # DATE_FANCINESS = 0
  198. # While Nikola can select a sensible locale for each language,
  199. # sometimes explicit control can come handy.
  200. # In this file we express locales in the string form that
  201. # python's locales will accept in your OS, by example
  202. # "en_US.utf8" in Unix-like OS, "English_United States" in Windows.
  203. # LOCALES = dict mapping language --> explicit locale for the languages
  204. # in TRANSLATIONS. You can omit one or more keys.
  205. # LOCALE_FALLBACK = locale to use when an explicit locale is unavailable
  206. # LOCALE_DEFAULT = locale to use for languages not mentioned in LOCALES; if
  207. # not set the default Nikola mapping is used.
  208. # LOCALES = {}
  209. # LOCALE_FALLBACK = None
  210. # LOCALE_DEFAULT = None
  211. # One or more folders containing files to be copied as-is into the output.
  212. # The format is a dictionary of {source: relative destination}.
  213. # Default is:
  214. # FILES_FOLDERS = {'files': ''}
  215. # Which means copy 'files' into 'output'
  216. # One or more folders containing code listings to be processed and published on
  217. # the site. The format is a dictionary of {source: relative destination}.
  218. # Default is:
  219. # LISTINGS_FOLDERS = {'listings': 'listings'}
  220. # Which means process listings from 'listings' into 'output/listings'
  221. # A mapping of languages to file-extensions that represent that language.
  222. # Feel free to add or delete extensions to any list, but don't add any new
  223. # compilers unless you write the interface for it yourself.
  224. #
  225. # 'rest' is reStructuredText
  226. # 'markdown' is MarkDown
  227. # 'html' assumes the file is HTML and just copies it
  228. COMPILERS = {
  229. # "rest": ('.rst', '.txt'),
  230. "markdown": ('.md', '.mdown', '.markdown'),
  231. # "txt2tags": ('.t2t',),
  232. # "wiki": ('.wiki',),
  233. # "ipynb": ('.ipynb',),
  234. # "html": ('.html', '.htm'),
  235. # Pandoc detects the input from the source filename
  236. # but is disabled by default as it would conflict
  237. # with many of the others.
  238. # "pandoc": ('.rst', '.md', '.txt'),
  239. }
  240. # Create by default posts in one file format?
  241. # Set to False for two-file posts, with separate metadata.
  242. ONE_FILE_POSTS = True
  243. # Use date-based path when creating posts?
  244. # Can be enabled on a per-post basis with `nikola new_post -d`.
  245. # The setting is ignored when creating pages (`-d` still works).
  246. # NEW_POST_DATE_PATH = False
  247. # What format to use when creating posts with date paths?
  248. # Default is '%Y/%m/%d', other possibilities include '%Y' or '%Y/%m'.
  249. # NEW_POST_DATE_PATH_FORMAT = '%Y/%m/%d'
  250. # If this is set to True, the DEFAULT_LANG version will be displayed for
  251. # untranslated posts.
  252. # If this is set to False, then posts that are not translated to a language
  253. # LANG will not be visible at all in the pages in that language.
  254. # Formerly known as HIDE_UNTRANSLATED_POSTS (inverse)
  255. # SHOW_UNTRANSLATED_POSTS = True
  256. # Nikola supports logo display. If you have one, you can put the URL here.
  257. # Final output is <img src="LOGO_URL" id="logo" alt="BLOG_TITLE">.
  258. # The URL may be relative to the site root.
  259. # LOGO_URL = ''
  260. # If you want to hide the title of your website (for example, if your logo
  261. # already contains the text), set this to False.
  262. # SHOW_BLOG_TITLE = True
  263. # Writes tag cloud data in form of tag_cloud_data.json.
  264. # Warning: this option will change its default value to False in v8!
  265. WRITE_TAG_CLOUD = True
  266. # Generate pages for each section. The site must have at least two sections
  267. # for this option to take effect. It wouldn't build for just one section.
  268. POSTS_SECTIONS = True
  269. # Setting this to False generates a list page instead of an index. Indexes
  270. # are the default and will apply GENERATE_ATOM if set.
  271. # POSTS_SECTIONS_ARE_INDEXES = True
  272. # Each post and section page will have an associated color that can be used
  273. # to style them with a recognizable color detail across your site. A color
  274. # is assigned to each section based on shifting the hue of your THEME_COLOR
  275. # at least 7.5 % while leaving the lightness and saturation untouched in the
  276. # HUSL colorspace. You can overwrite colors by assigning them colors in HEX.
  277. # POSTS_SECTION_COLORS = {
  278. # DEFAULT_LANG: {
  279. # 'posts': '#49b11bf',
  280. # 'reviews': '#ffe200',
  281. # },
  282. # }
  283. # Associate a description with a section. For use in meta description on
  284. # section index pages or elsewhere in themes.
  285. # POSTS_SECTION_DESCRIPTIONS = {
  286. # DEFAULT_LANG: {
  287. # 'how-to': 'Learn how-to things properly with these amazing tutorials.',
  288. # },
  289. # }
  290. # Sections are determined by their output directory as set in POSTS by default,
  291. # but can alternatively be determined from file metadata instead.
  292. # POSTS_SECTION_FROM_META = False
  293. # Names are determined from the output directory name automatically or the
  294. # metadata label. Unless overwritten below, names will use title cased and
  295. # hyphens replaced by spaces.
  296. # POSTS_SECTION_NAME = {
  297. # DEFAULT_LANG: {
  298. # 'posts': 'Blog Posts',
  299. # 'uncategorized': 'Odds and Ends',
  300. # },
  301. # }
  302. # Titles for per-section index pages. Can be either one string where "{name}"
  303. # is substituted or the POSTS_SECTION_NAME, or a dict of sections. Note
  304. # that the INDEX_PAGES option is also applied to section page titles.
  305. # POSTS_SECTION_TITLE = {
  306. # DEFAULT_LANG: {
  307. # 'how-to': 'How-to and Tutorials',
  308. # },
  309. # }
  310. # Paths for different autogenerated bits. These are combined with the
  311. # translation paths.
  312. # Final locations are:
  313. # output / TRANSLATION[lang] / TAG_PATH / index.html (list of tags)
  314. # output / TRANSLATION[lang] / TAG_PATH / tag.html (list of posts for a tag)
  315. # output / TRANSLATION[lang] / TAG_PATH / tag.xml (RSS feed for a tag)
  316. # (translatable)
  317. # TAG_PATH = "categories"
  318. # By default, the list of tags is stored in
  319. # output / TRANSLATION[lang] / TAG_PATH / index.html
  320. # (see explanation for TAG_PATH). This location can be changed to
  321. # output / TRANSLATION[lang] / TAGS_INDEX_PATH
  322. # with an arbitrary relative path TAGS_INDEX_PATH.
  323. # (translatable)
  324. # TAGS_INDEX_PATH = "tags.html"
  325. # If TAG_PAGES_ARE_INDEXES is set to True, each tag's page will contain
  326. # the posts themselves. If set to False, it will be just a list of links.
  327. # TAG_PAGES_ARE_INDEXES = False
  328. # Set descriptions for tag pages to make them more interesting. The
  329. # default is no description. The value is used in the meta description
  330. # and displayed underneath the tag list or index page’s title.
  331. # TAG_PAGES_DESCRIPTIONS = {
  332. # DEFAULT_LANG: {
  333. # "blogging": "Meta-blog posts about blogging about blogging.",
  334. # "open source": "My contributions to my many, varied, ever-changing, and eternal libre software projects."
  335. # },
  336. # }
  337. # Set special titles for tag pages. The default is "Posts about TAG".
  338. # TAG_PAGES_TITLES = {
  339. # DEFAULT_LANG: {
  340. # "blogging": "Meta-posts about blogging",
  341. # "open source": "Posts about open source software"
  342. # },
  343. # }
  344. # If you do not want to display a tag publicly, you can mark it as hidden.
  345. # The tag will not be displayed on the tag list page, the tag cloud and posts.
  346. # Tag pages will still be generated.
  347. HIDDEN_TAGS = ['mathjax']
  348. # Only include tags on the tag list/overview page if there are at least
  349. # TAGLIST_MINIMUM_POSTS number of posts or more with every tag. Every tag
  350. # page is still generated, linked from posts, and included in the sitemap.
  351. # However, more obscure tags can be hidden from the tag index page.
  352. # TAGLIST_MINIMUM_POSTS = 1
  353. # Final locations are:
  354. # output / TRANSLATION[lang] / CATEGORY_PATH / index.html (list of categories)
  355. # output / TRANSLATION[lang] / CATEGORY_PATH / CATEGORY_PREFIX category.html (list of posts for a category)
  356. # output / TRANSLATION[lang] / CATEGORY_PATH / CATEGORY_PREFIX category.xml (RSS feed for a category)
  357. # (translatable)
  358. # CATEGORY_PATH = "categories"
  359. # CATEGORY_PREFIX = "cat_"
  360. # By default, the list of categories is stored in
  361. # output / TRANSLATION[lang] / CATEGORY_PATH / index.html
  362. # (see explanation for CATEGORY_PATH). This location can be changed to
  363. # output / TRANSLATION[lang] / CATEGORIES_INDEX_PATH
  364. # with an arbitrary relative path CATEGORIES_INDEX_PATH.
  365. # (translatable)
  366. # CATEGORIES_INDEX_PATH = "categories.html"
  367. # If CATEGORY_ALLOW_HIERARCHIES is set to True, categories can be organized in
  368. # hierarchies. For a post, the whole path in the hierarchy must be specified,
  369. # using a forward slash ('/') to separate paths. Use a backslash ('\') to escape
  370. # a forward slash or a backslash (i.e. '\//\\' is a path specifying the
  371. # subcategory called '\' of the top-level category called '/').
  372. CATEGORY_ALLOW_HIERARCHIES = False
  373. # If CATEGORY_OUTPUT_FLAT_HIERARCHY is set to True, the output written to output
  374. # contains only the name of the leaf category and not the whole path.
  375. CATEGORY_OUTPUT_FLAT_HIERARCHY = False
  376. # If CATEGORY_PAGES_ARE_INDEXES is set to True, each category's page will contain
  377. # the posts themselves. If set to False, it will be just a list of links.
  378. # CATEGORY_PAGES_ARE_INDEXES = False
  379. # Set descriptions for category pages to make them more interesting. The
  380. # default is no description. The value is used in the meta description
  381. # and displayed underneath the category list or index page’s title.
  382. # CATEGORY_PAGES_DESCRIPTIONS = {
  383. # DEFAULT_LANG: {
  384. # "blogging": "Meta-blog posts about blogging about blogging.",
  385. # "open source": "My contributions to my many, varied, ever-changing, and eternal libre software projects."
  386. # },
  387. # }
  388. # Set special titles for category pages. The default is "Posts about CATEGORY".
  389. # CATEGORY_PAGES_TITLES = {
  390. # DEFAULT_LANG: {
  391. # "blogging": "Meta-posts about blogging",
  392. # "open source": "Posts about open source software"
  393. # },
  394. # }
  395. # If you do not want to display a category publicly, you can mark it as hidden.
  396. # The category will not be displayed on the category list page.
  397. # Category pages will still be generated.
  398. HIDDEN_CATEGORIES = []
  399. # If ENABLE_AUTHOR_PAGES is set to True and there is more than one
  400. # author, author pages are generated.
  401. # ENABLE_AUTHOR_PAGES = True
  402. # Path to author pages. Final locations are:
  403. # output / TRANSLATION[lang] / AUTHOR_PATH / index.html (list of authors)
  404. # output / TRANSLATION[lang] / AUTHOR_PATH / author.html (list of posts by an author)
  405. # output / TRANSLATION[lang] / AUTHOR_PATH / author.xml (RSS feed for an author)
  406. # (translatable)
  407. # AUTHOR_PATH = "authors"
  408. # If AUTHOR_PAGES_ARE_INDEXES is set to True, each author's page will contain
  409. # the posts themselves. If set to False, it will be just a list of links.
  410. # AUTHOR_PAGES_ARE_INDEXES = False
  411. # Set descriptions for author pages to make them more interesting. The
  412. # default is no description. The value is used in the meta description
  413. # and displayed underneath the author list or index page’s title.
  414. # AUTHOR_PAGES_DESCRIPTIONS = {
  415. # DEFAULT_LANG: {
  416. # "Juanjo Conti": "Python coder and writer.",
  417. # "Roberto Alsina": "Nikola father."
  418. # },
  419. # }
  420. # If you do not want to display an author publicly, you can mark it as hidden.
  421. # The author will not be displayed on the author list page and posts.
  422. # Tag pages will still be generated.
  423. HIDDEN_AUTHORS = ['Guest']
  424. # Final location for the main blog page and sibling paginated pages is
  425. # output / TRANSLATION[lang] / INDEX_PATH / index-*.html
  426. # (translatable)
  427. INDEX_PATH = "posts/"
  428. # Optional HTML that displayed on “main” blog index.html files.
  429. # May be used for a greeting. (translatable)
  430. FRONT_INDEX_HEADER = {
  431. DEFAULT_LANG: 'Main greetings!'
  432. }
  433. # Create per-month archives instead of per-year
  434. # CREATE_MONTHLY_ARCHIVE = False
  435. # Create one large archive instead of per-year
  436. # CREATE_SINGLE_ARCHIVE = False
  437. # Create year, month, and day archives each with a (long) list of posts
  438. # (overrides both CREATE_MONTHLY_ARCHIVE and CREATE_SINGLE_ARCHIVE)
  439. # CREATE_FULL_ARCHIVES = False
  440. # If monthly archives or full archives are created, adds also one archive per day
  441. # CREATE_DAILY_ARCHIVE = False
  442. # Create previous, up, next navigation links for archives
  443. # CREATE_ARCHIVE_NAVIGATION = False
  444. # Final locations for the archives are:
  445. # output / TRANSLATION[lang] / ARCHIVE_PATH / ARCHIVE_FILENAME
  446. # output / TRANSLATION[lang] / ARCHIVE_PATH / YEAR / index.html
  447. # output / TRANSLATION[lang] / ARCHIVE_PATH / YEAR / MONTH / index.html
  448. # output / TRANSLATION[lang] / ARCHIVE_PATH / YEAR / MONTH / DAY / index.html
  449. # ARCHIVE_PATH = ""
  450. # ARCHIVE_FILENAME = "archive.html"
  451. # If ARCHIVES_ARE_INDEXES is set to True, each archive page which contains a list
  452. # of posts will contain the posts themselves. If set to False, it will be just a
  453. # list of links.
  454. # ARCHIVES_ARE_INDEXES = False
  455. # URLs to other posts/pages can take 3 forms:
  456. # rel_path: a relative URL to the current page/post (default)
  457. # full_path: a URL with the full path from the root
  458. # absolute: a complete URL (that includes the SITE_URL)
  459. # URL_TYPE = 'rel_path'
  460. # If USE_BASE_TAG is True, then all HTML files will include
  461. # something like <base href=http://foo.var.com/baz/bat> to help
  462. # the browser resolve relative links.
  463. # Most people don’t need this tag; major websites don’t use it. Use
  464. # only if you know what you’re doing. If this is True, your website
  465. # will not be fully usable by manually opening .html files in your web
  466. # browser (`nikola serve` or `nikola auto` is mandatory). Also, if you
  467. # have mirrors of your site, they will point to SITE_URL everywhere.
  468. USE_BASE_TAG = False
  469. # Final location for the blog main RSS feed is:
  470. # output / TRANSLATION[lang] / RSS_PATH / rss.xml
  471. # (translatable)
  472. # RSS_PATH = ""
  473. # Slug the Tag URL. Easier for users to type, special characters are
  474. # often removed or replaced as well.
  475. # SLUG_TAG_PATH = True
  476. # Slug the Author URL. Easier for users to type, special characters are
  477. # often removed or replaced as well.
  478. # SLUG_AUTHOR_PATH = True
  479. # A list of redirection tuples, [("foo/from.html", "/bar/to.html")].
  480. #
  481. # A HTML file will be created in output/foo/from.html that redirects
  482. # to the "/bar/to.html" URL. notice that the "from" side MUST be a
  483. # relative URL.
  484. #
  485. # If you don't need any of these, just set to []
  486. REDIRECTIONS = []
  487. # Presets of commands to execute to deploy. Can be anything, for
  488. # example, you may use rsync:
  489. # "rsync -rav --delete output/ joe@my.site:/srv/www/site"
  490. # And then do a backup, or run `nikola ping` from the `ping`
  491. # plugin (`nikola plugin -i ping`). Or run `nikola check -l`.
  492. # You may also want to use github_deploy (see below).
  493. # You can define multiple presets and specify them as arguments
  494. # to `nikola deploy`. If no arguments are specified, a preset
  495. # named `default` will be executed. You can use as many presets
  496. # in a `nikola deploy` command as you like.
  497. # DEPLOY_COMMANDS = {
  498. # 'default': [
  499. # "rsync -rav --delete output/ joe@my.site:/srv/www/site",
  500. # ]
  501. # }
  502. # github_deploy configuration
  503. # For more details, read the manual:
  504. # https://getnikola.com/handbook.html#deploying-to-github
  505. # You will need to configure the deployment branch on GitHub.
  506. GITHUB_SOURCE_BRANCH = 'src'
  507. GITHUB_DEPLOY_BRANCH = 'master'
  508. # The name of the remote where you wish to push to, using github_deploy.
  509. GITHUB_REMOTE_NAME = 'origin'
  510. # Whether or not github_deploy should commit to the source branch automatically
  511. # before deploying.
  512. GITHUB_COMMIT_SOURCE = True
  513. # Where the output site should be located
  514. # If you don't use an absolute path, it will be considered as relative
  515. # to the location of conf.py
  516. # OUTPUT_FOLDER = 'output'
  517. # where the "cache" of partial generated content should be located
  518. # default: 'cache'
  519. # CACHE_FOLDER = 'cache'
  520. # Filters to apply to the output.
  521. # A directory where the keys are either: a file extensions, or
  522. # a tuple of file extensions.
  523. #
  524. # And the value is a list of commands to be applied in order.
  525. #
  526. # Each command must be either:
  527. #
  528. # A string containing a '%s' which will
  529. # be replaced with a filename. The command *must* produce output
  530. # in place.
  531. #
  532. # Or:
  533. #
  534. # A python callable, which will be called with the filename as
  535. # argument.
  536. #
  537. # By default, only .php files uses filters to inject PHP into
  538. # Nikola’s templates. All other filters must be enabled through FILTERS.
  539. #
  540. # Many filters are shipped with Nikola. A list is available in the manual:
  541. # <https://getnikola.com/handbook.html#post-processing-filters>
  542. #
  543. # from nikola import filters
  544. # FILTERS = {
  545. # ".html": [filters.typogrify],
  546. # ".js": [filters.closure_compiler],
  547. # ".jpg": ["jpegoptim --strip-all -m75 -v %s"],
  548. # }
  549. # Executable for the "yui_compressor" filter (defaults to 'yui-compressor').
  550. # YUI_COMPRESSOR_EXECUTABLE = 'yui-compressor'
  551. # Executable for the "closure_compiler" filter (defaults to 'closure-compiler').
  552. # CLOSURE_COMPILER_EXECUTABLE = 'closure-compiler'
  553. # Executable for the "optipng" filter (defaults to 'optipng').
  554. # OPTIPNG_EXECUTABLE = 'optipng'
  555. # Executable for the "jpegoptim" filter (defaults to 'jpegoptim').
  556. # JPEGOPTIM_EXECUTABLE = 'jpegoptim'
  557. # Executable for the "html_tidy_withconfig", "html_tidy_nowrap",
  558. # "html_tidy_wrap", "html_tidy_wrap_attr" and "html_tidy_mini" filters
  559. # (defaults to 'tidy5').
  560. # HTML_TIDY_EXECUTABLE = 'tidy5'
  561. # Expert setting! Create a gzipped copy of each generated file. Cheap server-
  562. # side optimization for very high traffic sites or low memory servers.
  563. # GZIP_FILES = False
  564. # File extensions that will be compressed
  565. # GZIP_EXTENSIONS = ('.txt', '.htm', '.html', '.css', '.js', '.json', '.atom', '.xml')
  566. # Use an external gzip command? None means no.
  567. # Example: GZIP_COMMAND = "pigz -k {filename}"
  568. # GZIP_COMMAND = None
  569. # Make sure the server does not return a "Accept-Ranges: bytes" header for
  570. # files compressed by this option! OR make sure that a ranged request does not
  571. # return partial content of another representation for these resources. Do not
  572. # use this feature if you do not understand what this means.
  573. # Compiler to process LESS files.
  574. # LESS_COMPILER = 'lessc'
  575. # A list of options to pass to the LESS compiler.
  576. # Final command is: LESS_COMPILER LESS_OPTIONS file.less
  577. # LESS_OPTIONS = []
  578. # Compiler to process Sass files.
  579. # SASS_COMPILER = 'sass'
  580. # A list of options to pass to the Sass compiler.
  581. # Final command is: SASS_COMPILER SASS_OPTIONS file.s(a|c)ss
  582. # SASS_OPTIONS = []
  583. # #############################################################################
  584. # Image Gallery Options
  585. # #############################################################################
  586. # One or more folders containing galleries. The format is a dictionary of
  587. # {"source": "relative_destination"}, where galleries are looked for in
  588. # "source/" and the results will be located in
  589. # "OUTPUT_PATH/relative_destination/gallery_name"
  590. # Default is:
  591. # GALLERY_FOLDERS = {"galleries": "galleries"}
  592. # More gallery options:
  593. # THUMBNAIL_SIZE = 180
  594. # MAX_IMAGE_SIZE = 1280
  595. # USE_FILENAME_AS_TITLE = True
  596. # EXTRA_IMAGE_EXTENSIONS = []
  597. #
  598. # If set to False, it will sort by filename instead. Defaults to True
  599. # GALLERY_SORT_BY_DATE = True
  600. # If set to True, EXIF data will be copied when an image is thumbnailed or
  601. # resized. (See also EXIF_WHITELIST)
  602. # PRESERVE_EXIF_DATA = False
  603. # If you have enabled PRESERVE_EXIF_DATA, this option lets you choose EXIF
  604. # fields you want to keep in images. (See also PRESERVE_EXIF_DATA)
  605. #
  606. # For a full list of field names, please see here:
  607. # http://www.cipa.jp/std/documents/e/DC-008-2012_E.pdf
  608. #
  609. # This is a dictionary of lists. Each key in the dictionary is the
  610. # name of a IDF, and each list item is a field you want to preserve.
  611. # If you have a IDF with only a '*' item, *EVERY* item in it will be
  612. # preserved. If you don't want to preserve anything in a IDF, remove it
  613. # from the setting. By default, no EXIF information is kept.
  614. # Setting the whitelist to anything other than {} implies
  615. # PRESERVE_EXIF_DATA is set to True
  616. # To preserve ALL EXIF data, set EXIF_WHITELIST to {"*": "*"}
  617. # EXIF_WHITELIST = {}
  618. # Some examples of EXIF_WHITELIST settings:
  619. # Basic image information:
  620. # EXIF_WHITELIST['0th'] = [
  621. # "Orientation",
  622. # "XResolution",
  623. # "YResolution",
  624. # ]
  625. # If you want to keep GPS data in the images:
  626. # EXIF_WHITELIST['GPS'] = ["*"]
  627. # Embedded thumbnail information:
  628. # EXIF_WHITELIST['1st'] = ["*"]
  629. # Folders containing images to be used in normal posts or pages.
  630. # IMAGE_FOLDERS is a dictionary of the form {"source": "destination"},
  631. # where "source" is the folder containing the images to be published, and
  632. # "destination" is the folder under OUTPUT_PATH containing the images copied
  633. # to the site. Thumbnail images will be created there as well.
  634. # To reference the images in your posts, include a leading slash in the path.
  635. # For example, if IMAGE_FOLDERS = {'images': 'images'}, write
  636. #
  637. # .. image:: /images/tesla.jpg
  638. #
  639. # See the Nikola Handbook for details (in the “Embedding Images” and
  640. # “Thumbnails” sections)
  641. # Images will be scaled down according to IMAGE_THUMBNAIL_SIZE and MAX_IMAGE_SIZE
  642. # options, but will have to be referenced manually to be visible on the site
  643. # (the thumbnail has ``.thumbnail`` added before the file extension by default,
  644. # but a different naming template can be configured with IMAGE_THUMBNAIL_FORMAT).
  645. IMAGE_FOLDERS = {'images': 'images'}
  646. # IMAGE_THUMBNAIL_SIZE = 400
  647. # IMAGE_THUMBNAIL_FORMAT = '{name}.thumbnail{ext}'
  648. # #############################################################################
  649. # HTML fragments and diverse things that are used by the templates
  650. # #############################################################################
  651. # Data about post-per-page indexes.
  652. # INDEXES_PAGES defaults to ' old posts, page %d' or ' page %d' (translated),
  653. # depending on the value of INDEXES_PAGES_MAIN.
  654. #
  655. # (translatable) If the following is empty, defaults to BLOG_TITLE:
  656. INDEXES_TITLE = "Cases"
  657. #
  658. # (translatable) If the following is empty, defaults to ' [old posts,] page %d' (see above):
  659. # INDEXES_PAGES = ""
  660. #
  661. # If the following is True, INDEXES_PAGES is also displayed on the main (the
  662. # newest) index page (index.html):
  663. # INDEXES_PAGES_MAIN = True
  664. #
  665. # If the following is True, index-1.html has the oldest posts, index-2.html the
  666. # second-oldest posts, etc., and index.html has the newest posts. This ensures
  667. # that all posts on index-x.html will forever stay on that page, now matter how
  668. # many new posts are added.
  669. # If False, index-1.html has the second-newest posts, index-2.html the third-newest,
  670. # and index-n.html the oldest posts. When this is active, old posts can be moved
  671. # to other index pages when new posts are added.
  672. # INDEXES_STATIC = True
  673. #
  674. # (translatable) If PRETTY_URLS is set to True, this setting will be used to create
  675. # prettier URLs for index pages, such as page/2/index.html instead of index-2.html.
  676. # Valid values for this settings are:
  677. # * False,
  678. # * a list or tuple, specifying the path to be generated,
  679. # * a dictionary mapping languages to lists or tuples.
  680. # Every list or tuple must consist of strings which are used to combine the path;
  681. # for example:
  682. # ['page', '{number}', '{index_file}']
  683. # The replacements
  684. # {number} --> (logical) page number;
  685. # {old_number} --> the page number inserted into index-n.html before (zero for
  686. # the main page);
  687. # {index_file} --> value of option INDEX_FILE
  688. # are made.
  689. # Note that in case INDEXES_PAGES_MAIN is set to True, a redirection will be created
  690. # for the full URL with the page number of the main page to the normal (shorter) main
  691. # page URL.
  692. # INDEXES_PRETTY_PAGE_URL = False
  693. #
  694. # If the following is true, a page range navigation will be inserted to indices.
  695. # Please note that this will undo the effect of INDEXES_STATIC, as all index pages
  696. # must be recreated whenever the number of pages changes.
  697. # SHOW_INDEX_PAGE_NAVIGATION = False
  698. # If the following is True, a meta name="generator" tag is added to pages. The
  699. # generator tag is used to specify the software used to generate the page
  700. # (it promotes Nikola).
  701. # META_GENERATOR_TAG = True
  702. # Color scheme to be used for code blocks. If your theme provides
  703. # "assets/css/code.css" this is ignored. Leave empty to disable.
  704. # Can be any of:
  705. # algol
  706. # algol_nu
  707. # arduino
  708. # autumn
  709. # borland
  710. # bw
  711. # colorful
  712. # default
  713. # emacs
  714. # friendly
  715. # fruity
  716. # igor
  717. # lovelace
  718. # manni
  719. # monokai
  720. # murphy
  721. # native
  722. # paraiso_dark
  723. # paraiso_light
  724. # pastie
  725. # perldoc
  726. # rrt
  727. # tango
  728. # trac
  729. # vim
  730. # vs
  731. # xcode
  732. # This list MAY be incomplete since pygments adds styles every now and then.
  733. # CODE_COLOR_SCHEME = 'default'
  734. # If you use 'site-reveal' theme you can select several subthemes
  735. # THEME_REVEAL_CONFIG_SUBTHEME = 'sky'
  736. # You can also use: beige/serif/simple/night/default
  737. # Again, if you use 'site-reveal' theme you can select several transitions
  738. # between the slides
  739. # THEME_REVEAL_CONFIG_TRANSITION = 'cube'
  740. # You can also use: page/concave/linear/none/default
  741. # FAVICONS contains (name, file, size) tuples.
  742. # Used to create favicon link like this:
  743. # <link rel="name" href="file" sizes="size"/>
  744. # FAVICONS = (
  745. # ("icon", "/favicon.ico", "16x16"),
  746. # ("icon", "/icon_128x128.png", "128x128"),
  747. # )
  748. # Show teasers (instead of full posts) in indexes? Defaults to False.
  749. # INDEX_TEASERS = False
  750. # HTML fragments with the Read more... links.
  751. # The following tags exist and are replaced for you:
  752. # {link} A link to the full post page.
  753. # {read_more} The string “Read more” in the current language.
  754. # {reading_time} An estimate of how long it will take to read the post.
  755. # {remaining_reading_time} An estimate of how long it will take to read the post, sans the teaser.
  756. # {min_remaining_read} The string “{remaining_reading_time} min remaining to read” in the current language.
  757. # {paragraph_count} The amount of paragraphs in the post.
  758. # {remaining_paragraph_count} The amount of paragraphs in the post, sans the teaser.
  759. # {{ A literal { (U+007B LEFT CURLY BRACKET)
  760. # }} A literal } (U+007D RIGHT CURLY BRACKET)
  761. # 'Read more...' for the index page, if INDEX_TEASERS is True (translatable)
  762. INDEX_READ_MORE_LINK = '<p class="more"><a href="{link}">{read_more}…</a></p>'
  763. # 'Read more...' for the feeds, if FEED_TEASERS is True (translatable)
  764. FEED_READ_MORE_LINK = '<p><a href="{link}">{read_more}…</a> ({min_remaining_read})</p>'
  765. # Append a URL query to the FEED_READ_MORE_LINK in Atom and RSS feeds. Advanced
  766. # option used for traffic source tracking.
  767. # Minimum example for use with Piwik: "pk_campaign=feed"
  768. # The following tags exist and are replaced for you:
  769. # {feedRelUri} A relative link to the feed.
  770. # {feedFormat} The name of the syndication format.
  771. # Example using replacement for use with Google Analytics:
  772. # "utm_source={feedRelUri}&utm_medium=nikola_feed&utm_campaign={feedFormat}_feed"
  773. FEED_LINKS_APPEND_QUERY = False
  774. # A HTML fragment describing the license, for the sidebar.
  775. # (translatable)
  776. LICENSE = ""
  777. # I recommend using the Creative Commons' wizard:
  778. # https://creativecommons.org/choose/
  779. # LICENSE = """
  780. # <a rel="license" href="https://creativecommons.org/licenses/by-nc-sa/4.0/">
  781. # <img alt="Creative Commons License BY-NC-SA"
  782. # style="border-width:0; margin-bottom:12px;"
  783. # src="https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png"></a>"""
  784. # A small copyright notice for the page footer (in HTML).
  785. # (translatable)
  786. CONTENT_FOOTER = 'Contents &copy; {date} {author} - Powered by <a href="https://getnikola.com" rel="nofollow">Nikola</a> {license}'
  787. # Things that will be passed to CONTENT_FOOTER.format(). This is done
  788. # for translatability, as dicts are not formattable. Nikola will
  789. # intelligently format the setting properly.
  790. # The setting takes a dict. The keys are languages. The values are
  791. # tuples of tuples of positional arguments and dicts of keyword arguments
  792. # to format(). For example, {'en': (('Hello'), {'target': 'World'})}
  793. # results in CONTENT_FOOTER['en'].format('Hello', target='World').
  794. # WARNING: If you do not use multiple languages with CONTENT_FOOTER, this
  795. # still needs to be a dict of this format. (it can be empty if you
  796. # do not need formatting)
  797. # (translatable)
  798. CONTENT_FOOTER_FORMATS = {
  799. DEFAULT_LANG: (
  800. (),
  801. {
  802. "author": BLOG_AUTHOR,
  803. "date": time.gmtime().tm_year,
  804. "license": LICENSE
  805. }
  806. )
  807. }
  808. # A simple copyright tag for inclusion in RSS feeds that works just
  809. # like CONTENT_FOOTER and CONTENT_FOOTER_FORMATS
  810. RSS_COPYRIGHT_PLAIN = 'Contents © {date} {author} {license}'
  811. RSS_COPYRIGHT_FORMATS = CONTENT_FOOTER_FORMATS
  812. # To use comments, you can choose between different third party comment
  813. # systems. The following comment systems are supported by Nikola:
  814. # disqus, facebook, googleplus, intensedebate, isso, livefyre, muut
  815. # You can leave this option blank to disable comments.
  816. COMMENT_SYSTEM = ""
  817. # And you also need to add your COMMENT_SYSTEM_ID which
  818. # depends on what comment system you use. The default is
  819. # "nikolademo" which is a test account for Disqus. More information
  820. # is in the manual.
  821. COMMENT_SYSTEM_ID = ""
  822. # Enable annotations using annotateit.org?
  823. # If set to False, you can still enable them for individual posts and pages
  824. # setting the "annotations" metadata.
  825. # If set to True, you can disable them for individual posts and pages using
  826. # the "noannotations" metadata.
  827. # ANNOTATIONS = False
  828. # Create index.html for page folders?
  829. # WARNING: if a page would conflict with the index file (usually
  830. # caused by setting slug to `index`), the PAGE_INDEX
  831. # will not be generated for that directory.
  832. PAGE_INDEX = True
  833. # Enable comments on pages (i.e. not posts)?
  834. # COMMENTS_IN_PAGES = False
  835. # Enable comments on picture gallery pages?
  836. # COMMENTS_IN_GALLERIES = False
  837. # What file should be used for directory indexes?
  838. # Defaults to index.html
  839. # Common other alternatives: default.html for IIS, index.php
  840. # INDEX_FILE = "index.html"
  841. # If a link ends in /index.html, drop the index.html part.
  842. # http://mysite/foo/bar/index.html => http://mysite/foo/bar/
  843. # (Uses the INDEX_FILE setting, so if that is, say, default.html,
  844. # it will instead /foo/default.html => /foo)
  845. # (Note: This was briefly STRIP_INDEX_HTML in v 5.4.3 and 5.4.4)
  846. STRIP_INDEXES = True
  847. # Should the sitemap list directories which only include other directories
  848. # and no files.
  849. # Default to True
  850. # If this is False
  851. # e.g. /2012 includes only /01, /02, /03, /04, ...: don't add it to the sitemap
  852. # if /2012 includes any files (including index.html)... add it to the sitemap
  853. # SITEMAP_INCLUDE_FILELESS_DIRS = True
  854. # List of files relative to the server root (!) that will be asked to be excluded
  855. # from indexing and other robotic spidering. * is supported. Will only be effective
  856. # if SITE_URL points to server root. The list is used to exclude resources from
  857. # /robots.txt and /sitemap.xml, and to inform search engines about /sitemapindex.xml.
  858. # ROBOTS_EXCLUSIONS = ["/archive.html", "/category/*.html"]
  859. # Instead of putting files in <slug>.html, put them in <slug>/index.html.
  860. # No web server configuration is required. Also enables STRIP_INDEXES.
  861. # This can be disabled on a per-page/post basis by adding
  862. # .. pretty_url: False
  863. # to the metadata.
  864. PRETTY_URLS = True
  865. # If True, publish future dated posts right away instead of scheduling them.
  866. # Defaults to False.
  867. # FUTURE_IS_NOW = False
  868. # If True, future dated posts are allowed in deployed output
  869. # Only the individual posts are published/deployed; not in indexes/sitemap
  870. # Generally, you want FUTURE_IS_NOW and DEPLOY_FUTURE to be the same value.
  871. # DEPLOY_FUTURE = False
  872. # If False, draft posts will not be deployed
  873. # DEPLOY_DRAFTS = True
  874. # Allows scheduling of posts using the rule specified here (new_post -s)
  875. # Specify an iCal Recurrence Rule: http://www.kanzaki.com/docs/ical/rrule.html
  876. # SCHEDULE_RULE = ''
  877. # If True, use the scheduling rule to all posts by default
  878. # SCHEDULE_ALL = False
  879. # Do you want a add a Mathjax config file?
  880. # MATHJAX_CONFIG = ""
  881. # If you are using the compile-ipynb plugin, just add this one:
  882. # MATHJAX_CONFIG = """
  883. # <script type="text/x-mathjax-config">
  884. # MathJax.Hub.Config({
  885. # tex2jax: {
  886. # inlineMath: [ ['$','$'], ["\\\(","\\\)"] ],
  887. # displayMath: [ ['$$','$$'], ["\\\[","\\\]"] ],
  888. # processEscapes: true
  889. # },
  890. # displayAlign: 'left', // Change this to 'center' to center equations.
  891. # "HTML-CSS": {
  892. # styles: {'.MathJax_Display': {"margin": 0}}
  893. # }
  894. # });
  895. # </script>
  896. # """
  897. # Want to use KaTeX instead of MathJax? While KaTeX is less featureful,
  898. # it's faster and the output looks better.
  899. # If you set USE_KATEX to True, you also need to add an extra CSS file
  900. # like this:
  901. # EXTRA_HEAD_DATA = """<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.6.0/katex.min.css">"""
  902. # USE_KATEX = False
  903. # If you want to use the old (buggy) inline math $.$ with KaTeX, then
  904. # you might want to use this feature.
  905. # KATEX_AUTO_RENDER = """
  906. # delimiters: [
  907. # {left: "$$", right: "$$", display: true},
  908. # {left: "\\\[", right: "\\\]", display: true},
  909. # {left: "$", right: "$", display: false},
  910. # {left: "\\\(", right: "\\\)", display: false}
  911. # ]
  912. # """
  913. # Do you want to customize the nbconversion of your IPython notebook?
  914. # IPYNB_CONFIG = {}
  915. # With the following example configuration you can use a custom jinja template
  916. # called `toggle.tpl` which has to be located in your site/blog main folder:
  917. # IPYNB_CONFIG = {'Exporter':{'template_file': 'toggle'}}
  918. # What Markdown extensions to enable?
  919. # You will also get gist, nikola and podcast because those are
  920. # done in the code, hope you don't mind ;-)
  921. # Note: most Nikola-specific extensions are done via the Nikola plugin system,
  922. # with the MarkdownExtension class and should not be added here.
  923. # The default is ['fenced_code', 'codehilite']
  924. MARKDOWN_EXTENSIONS = ['fenced_code', 'codehilite', 'extra']
  925. # Extra options to pass to the pandoc comand.
  926. # by default, it's empty, is a list of strings, for example
  927. # ['-F', 'pandoc-citeproc', '--bibliography=/Users/foo/references.bib']
  928. # Pandoc does not demote headers by default. To enable this, you can use, for example
  929. # ['--base-header-level=2']
  930. # PANDOC_OPTIONS = []
  931. # Social buttons. This is sample code for AddThis (which was the default for a
  932. # long time). Insert anything you want here, or even make it empty (which is
  933. # the default right now)
  934. # (translatable)
  935. # SOCIAL_BUTTONS_CODE = """
  936. # <!-- Social buttons -->
  937. # <div id="addthisbox" class="addthis_toolbox addthis_peekaboo_style addthis_default_style addthis_label_style addthis_32x32_style">
  938. # <a class="addthis_button_more">Share</a>
  939. # <ul><li><a class="addthis_button_facebook"></a>
  940. # <li><a class="addthis_button_google_plusone_share"></a>
  941. # <li><a class="addthis_button_linkedin"></a>
  942. # <li><a class="addthis_button_twitter"></a>
  943. # </ul>
  944. # </div>
  945. # <script src="https://s7.addthis.com/js/300/addthis_widget.js#pubid=ra-4f7088a56bb93798"></script>
  946. # <!-- End of social buttons -->
  947. # """
  948. # Show link to source for the posts?
  949. # Formerly known as HIDE_SOURCELINK (inverse)
  950. # SHOW_SOURCELINK = True
  951. # Copy the source files for your pages?
  952. # Setting it to False implies SHOW_SOURCELINK = False
  953. # COPY_SOURCES = True
  954. # Modify the number of Post per Index Page
  955. # Defaults to 10
  956. # INDEX_DISPLAY_POST_COUNT = 10
  957. # By default, Nikola generates RSS files for the website and for tags, and
  958. # links to it. Set this to False to disable everything RSS-related.
  959. GENERATE_RSS = False
  960. # By default, Nikola does not generates Atom files for indexes and links to
  961. # them. Generate Atom for tags by setting TAG_PAGES_ARE_INDEXES to True.
  962. # Atom feeds are built based on INDEX_DISPLAY_POST_COUNT and not FEED_LENGTH
  963. # Switch between plain-text summaries and full HTML content using the
  964. # FEED_TEASER option. FEED_LINKS_APPEND_QUERY is also respected. Atom feeds
  965. # are generated even for old indexes and have pagination link relations
  966. # between each other. Old Atom feeds with no changes are marked as archived.
  967. # GENERATE_ATOM = False
  968. # Only inlclude teasers in Atom and RSS feeds. Disabling include the full
  969. # content. Defaults to True.
  970. # FEED_TEASERS = True
  971. # Strip HTML from Atom annd RSS feed summaries and content. Defaults to False.
  972. # FEED_PLAIN = False
  973. # Number of posts in Atom and RSS feeds.
  974. # FEED_LENGTH = 10
  975. # Include preview image as a <figure><img></figure> at the top of the entry.
  976. # Requires FEED_PLAIN = False. If the preview image is found in the content,
  977. # it will not be included again. Image will be included as-is, aim to optmize
  978. # the image source for Feedly, Apple News, Flipboard, and other popular clients.
  979. # FEED_PREVIEWIMAGE = True
  980. # RSS_LINK is a HTML fragment to link the RSS or Atom feeds. If set to None,
  981. # the base.tmpl will use the feed Nikola generates. However, you may want to
  982. # change it for a FeedBurner feed or something else.
  983. # RSS_LINK = None
  984. # A search form to search this site, for the sidebar. You can use a Google
  985. # custom search (https://www.google.com/cse/)
  986. # Or a DuckDuckGo search: https://duckduckgo.com/search_box.html
  987. # Default is no search form.
  988. # (translatable)
  989. # SEARCH_FORM = ""
  990. #
  991. # This search form works for any site and looks good in the "site" theme where
  992. # it appears on the navigation bar:
  993. #
  994. # SEARCH_FORM = """
  995. # <!-- DuckDuckGo custom search -->
  996. # <form method="get" id="search" action="https://duckduckgo.com/"
  997. # class="navbar-form pull-left">
  998. # <input type="hidden" name="sites" value="%s">
  999. # <input type="hidden" name="k8" value="#444444">
  1000. # <input type="hidden" name="k9" value="#D51920">
  1001. # <input type="hidden" name="kt" value="h">
  1002. # <input type="text" name="q" maxlength="255"
  1003. # placeholder="Search&hellip;" class="span2" style="margin-top: 4px;">
  1004. # <input type="submit" value="DuckDuckGo Search" style="visibility: hidden;">
  1005. # </form>
  1006. # <!-- End of custom search -->
  1007. # """ % SITE_URL
  1008. #
  1009. # If you prefer a Google search form, here's an example that should just work:
  1010. # SEARCH_FORM = """
  1011. # <!-- Google custom search -->
  1012. # <form method="get" action="https://www.google.com/search" class="navbar-form navbar-right" role="search">
  1013. # <div class="form-group">
  1014. # <input type="text" name="q" class="form-control" placeholder="Search">
  1015. # </div>
  1016. # <button type="submit" class="btn btn-primary">
  1017. # <span class="glyphicon glyphicon-search"></span>
  1018. # </button>
  1019. # <input type="hidden" name="sitesearch" value="%s">
  1020. # </form>
  1021. # <!-- End of custom search -->
  1022. # """ % SITE_URL
  1023. # Use content distribution networks for jQuery, twitter-bootstrap css and js,
  1024. # and html5shiv (for older versions of Internet Explorer)
  1025. # If this is True, jQuery and html5shiv are served from the Google CDN and
  1026. # Bootstrap is served from BootstrapCDN (provided by MaxCDN)
  1027. # Set this to False if you want to host your site without requiring access to
  1028. # external resources.
  1029. # USE_CDN = False
  1030. # Check for USE_CDN compatibility.
  1031. # If you are using custom themes, have configured the CSS properly and are
  1032. # receiving warnings about incompatibility but believe they are incorrect, you
  1033. # can set this to False.
  1034. # USE_CDN_WARNING = True
  1035. # Extra things you want in the pages HEAD tag. This will be added right
  1036. # before </head>
  1037. # (translatable)
  1038. # EXTRA_HEAD_DATA = ""
  1039. # Google Analytics or whatever else you use. Added to the bottom of <body>
  1040. # in the default template (base.tmpl).
  1041. # (translatable)
  1042. # BODY_END = ""
  1043. # The possibility to extract metadata from the filename by using a
  1044. # regular expression.
  1045. # To make it work you need to name parts of your regular expression.
  1046. # The following names will be used to extract metadata:
  1047. # - title
  1048. # - slug
  1049. # - date
  1050. # - tags
  1051. # - link
  1052. # - description
  1053. #
  1054. # An example re is the following:
  1055. # '.*\/(?P<date>\d{4}-\d{2}-\d{2})-(?P<slug>.*)-(?P<title>.*)\.rst'
  1056. # (Note the '.*\/' in the beginning -- matches source paths relative to conf.py)
  1057. # FILE_METADATA_REGEXP = None
  1058. # If you hate "Filenames with Capital Letters and Spaces.md", you should
  1059. # set this to true.
  1060. UNSLUGIFY_TITLES = True
  1061. # Additional metadata that is added to a post when creating a new_post
  1062. # ADDITIONAL_METADATA = {}
  1063. # Nikola supports Open Graph Protocol data for enhancing link sharing and
  1064. # discoverability of your site on Facebook, Google+, and other services.
  1065. # Open Graph is enabled by default.
  1066. # USE_OPEN_GRAPH = True
  1067. # Nikola supports Twitter Card summaries, but they are disabled by default.
  1068. # They make it possible for you to attach media to Tweets that link
  1069. # to your content.
  1070. #
  1071. # IMPORTANT:
  1072. # Please note, that you need to opt-in for using Twitter Cards!
  1073. # To do this please visit https://cards-dev.twitter.com/validator
  1074. #
  1075. # Uncomment and modify to following lines to match your accounts.
  1076. # Images displayed come from the `previewimage` meta tag.
  1077. # You can specify the card type by using the `card` parameter in TWITTER_CARD.
  1078. # TWITTER_CARD = {
  1079. # # 'use_twitter_cards': True, # enable Twitter Cards
  1080. # # 'card': 'summary', # Card type, you can also use 'summary_large_image',
  1081. # # see https://dev.twitter.com/cards/types
  1082. # # 'site': '@website', # twitter nick for the website
  1083. # # 'creator': '@username', # Username for the content creator / author.
  1084. # }
  1085. # If webassets is installed, bundle JS and CSS into single files to make
  1086. # site loading faster in a HTTP/1.1 environment but is not recommended for
  1087. # HTTP/2.0 when caching is used. Defaults to True.
  1088. # USE_BUNDLES = True
  1089. # Plugins you don't want to use. Be careful :-)
  1090. # DISABLED_PLUGINS = ["render_galleries"]
  1091. # Special settings to disable only parts of the indexes plugin (to allow RSS
  1092. # but no blog indexes, or to allow blog indexes and Atom but no site-wide RSS).
  1093. # Use with care.
  1094. # DISABLE_INDEXES_PLUGIN_INDEX_AND_ATOM_FEED = False
  1095. # DISABLE_INDEXES_PLUGIN_RSS_FEED = False
  1096. # Add the absolute paths to directories containing plugins to use them.
  1097. # For example, the `plugins` directory of your clone of the Nikola plugins
  1098. # repository.
  1099. # EXTRA_PLUGINS_DIRS = []
  1100. # Add the absolute paths to directories containing themes to use them.
  1101. # For example, the `v7` directory of your clone of the Nikola themes
  1102. # repository.
  1103. # EXTRA_THEMES_DIRS = []
  1104. # List of regular expressions, links matching them will always be considered
  1105. # valid by "nikola check -l"
  1106. # LINK_CHECK_WHITELIST = []
  1107. # If set to True, enable optional hyphenation in your posts (requires pyphen)
  1108. # Enabling hyphenation has been shown to break math support in some cases,
  1109. # use with caution.
  1110. # HYPHENATE = False
  1111. # The <hN> tags in HTML generated by certain compilers (reST/Markdown)
  1112. # will be demoted by that much (1 → h1 will become h2 and so on)
  1113. # This was a hidden feature of the Markdown and reST compilers in the
  1114. # past. Useful especially if your post titles are in <h1> tags too, for
  1115. # example.
  1116. # (defaults to 1.)
  1117. # DEMOTE_HEADERS = 1
  1118. # Docutils, by default, will perform a transform in your documents
  1119. # extracting unique titles at the top of your document and turning
  1120. # them into metadata. This surprises a lot of people, and setting
  1121. # this option to True will prevent it.
  1122. # NO_DOCUTILS_TITLE_TRANSFORM = False
  1123. # If you don’t like slugified file names ([a-z0-9] and a literal dash),
  1124. # and would prefer to use all the characters your file system allows.
  1125. # USE WITH CARE! This is also not guaranteed to be perfect, and may
  1126. # sometimes crash Nikola, your web server, or eat your cat.
  1127. # USE_SLUGIFY = True
  1128. # Templates will use those filters, along with the defaults.
  1129. # Consult your engine's documentation on filters if you need help defining
  1130. # those.
  1131. # TEMPLATE_FILTERS = {}
  1132. # Put in global_context things you want available on all your templates.
  1133. # It can be anything, data, functions, modules, etc.
  1134. GLOBAL_CONTEXT = {}
  1135. # Add functions here and they will be called with template
  1136. # GLOBAL_CONTEXT as parameter when the template is about to be
  1137. # rendered
  1138. GLOBAL_CONTEXT_FILLER = []
  1139.