initial commit

README.txt

@@ -0,0 +1,17 @@
+This folder contains the source used to generate a static site using Nikola.
+
+Installation and documentation at https://getnikola.com/
+
+Configuration file for the site is ``conf.py``.
+
+To build the site::
+
+    nikola build
+
+To see it::
+
+    nikola serve -b
+
+To check all available commands::
+
+    nikola help

cache/.mako.tmp/archive.tmpl.py

@@ -0,0 +1,42 @@
+# -*- coding:utf-8 -*-
+from mako import runtime, filters, cache
+UNDEFINED = runtime.UNDEFINED
+STOP_RENDERING = runtime.STOP_RENDERING
+__M_dict_builtin = dict
+__M_locals_builtin = locals
+_magic_number = 10
+_modified_time = 1676236796.3475218
+_enable_loop = True
+_template_filename = '/home/thomas/.local/lib/python3.9/site-packages/nikola/data/themes/base/templates/archive.tmpl'
+_template_uri = 'archive.tmpl'
+_source_encoding = 'utf-8'
+_exports = []
+
+
+def _mako_get_namespace(context, name):
+    try:
+        return context.namespaces[(__name__, name)]
+    except KeyError:
+        _mako_generate_namespaces(context)
+        return context.namespaces[(__name__, name)]
+def _mako_generate_namespaces(context):
+    pass
+def _mako_inherit(template, context):
+    _mako_generate_namespaces(context)
+    return runtime._inherit_from(context, 'list_post.tmpl', _template_uri)
+def render_body(context,**pageargs):
+    __M_caller = context.caller_stack._push_frame()
+    try:
+        __M_locals = __M_dict_builtin(pageargs=pageargs)
+        __M_writer = context.writer()
+        __M_writer('\n')
+        return ''
+    finally:
+        context.caller_stack._pop_frame()
+
+
+"""
+__M_BEGIN_METADATA
+{"filename": "/home/thomas/.local/lib/python3.9/site-packages/nikola/data/themes/base/templates/archive.tmpl", "uri": "archive.tmpl", "source_encoding": "utf-8", "line_map": {"27": 0, "32": 1, "38": 32}}
+__M_END_METADATA
+"""

cache/.mako.tmp/comments_helper.tmpl.py

@@ -0,0 +1,84 @@
+# -*- coding:utf-8 -*-
+from mako import runtime, filters, cache
+UNDEFINED = runtime.UNDEFINED
+STOP_RENDERING = runtime.STOP_RENDERING
+__M_dict_builtin = dict
+__M_locals_builtin = locals
+_magic_number = 10
+_modified_time = 1676236796.1161768
+_enable_loop = True
+_template_filename = '/home/thomas/.local/lib/python3.9/site-packages/nikola/data/themes/base/templates/comments_helper.tmpl'
+_template_uri = 'comments_helper.tmpl'
+_source_encoding = 'utf-8'
+_exports = ['comment_form', 'comment_link', 'comment_link_script']
+
+
+def _mako_get_namespace(context, name):
+    try:
+        return context.namespaces[(__name__, name)]
+    except KeyError:
+        _mako_generate_namespaces(context)
+        return context.namespaces[(__name__, name)]
+def _mako_generate_namespaces(context):
+    ns = runtime.TemplateNamespace('comments_helper_impl', context._clean_inheritance_tokens(), templateuri='comments_helper_' + (context['comment_system']) + '.tmpl', callables=None,  calling_uri=_template_uri)
+    context.namespaces[(__name__, 'comments_helper_impl')] = ns
+
+def render_body(context,**pageargs):
+    __M_caller = context.caller_stack._push_frame()
+    try:
+        __M_locals = __M_dict_builtin(pageargs=pageargs)
+        __M_writer = context.writer()
+        __M_writer('\n')
+        __M_writer('\n\n')
+        __M_writer('\n\n')
+        __M_writer('\n\n')
+        __M_writer('\n')
+        return ''
+    finally:
+        context.caller_stack._pop_frame()
+
+
+def render_comment_form(context,url,title,identifier):
+    __M_caller = context.caller_stack._push_frame()
+    try:
+        comments_helper_impl = _mako_get_namespace(context, 'comments_helper_impl')
+        __M_writer = context.writer()
+        __M_writer('\n    ')
+        __M_writer(str(comments_helper_impl.comment_form(url, title, identifier)))
+        __M_writer('\n')
+        return ''
+    finally:
+        context.caller_stack._pop_frame()
+
+
+def render_comment_link(context,link,identifier):
+    __M_caller = context.caller_stack._push_frame()
+    try:
+        comments_helper_impl = _mako_get_namespace(context, 'comments_helper_impl')
+        __M_writer = context.writer()
+        __M_writer('\n    ')
+        __M_writer(str(comments_helper_impl.comment_link(link, identifier)))
+        __M_writer('\n')
+        return ''
+    finally:
+        context.caller_stack._pop_frame()
+
+
+def render_comment_link_script(context):
+    __M_caller = context.caller_stack._push_frame()
+    try:
+        comments_helper_impl = _mako_get_namespace(context, 'comments_helper_impl')
+        __M_writer = context.writer()
+        __M_writer('\n    ')
+        __M_writer(str(comments_helper_impl.comment_link_script()))
+        __M_writer('\n')
+        return ''
+    finally:
+        context.caller_stack._pop_frame()
+
+
+"""
+__M_BEGIN_METADATA
+{"filename": "/home/thomas/.local/lib/python3.9/site-packages/nikola/data/themes/base/templates/comments_helper.tmpl", "uri": "comments_helper.tmpl", "source_encoding": "utf-8", "line_map": {"23": 3, "26": 0, "31": 2, "32": 3, "33": 7, "34": 11, "35": 15, "41": 5, "46": 5, "47": 6, "48": 6, "54": 9, "59": 9, "60": 10, "61": 10, "67": 13, "72": 13, "73": 14, "74": 14, "80": 74}}
+__M_END_METADATA
+"""

cache/.mako.tmp/comments_helper_dummy.tmpl.py

@@ -0,0 +1,64 @@
+# -*- coding:utf-8 -*-
+from mako import runtime, filters, cache
+UNDEFINED = runtime.UNDEFINED
+STOP_RENDERING = runtime.STOP_RENDERING
+__M_dict_builtin = dict
+__M_locals_builtin = locals
+_magic_number = 10
+_modified_time = 1676236796.144974
+_enable_loop = True
+_template_filename = '/home/thomas/.local/lib/python3.9/site-packages/nikola/data/themes/base/templates/comments_helper_dummy.tmpl'
+_template_uri = 'comments_helper_dummy.tmpl'
+_source_encoding = 'utf-8'
+_exports = ['comment_form', 'comment_link', 'comment_link_script']
+
+
+def render_body(context,**pageargs):
+    __M_caller = context.caller_stack._push_frame()
+    try:
+        __M_locals = __M_dict_builtin(pageargs=pageargs)
+        __M_writer = context.writer()
+        __M_writer('\n')
+        __M_writer('\n\n')
+        __M_writer('\n\n')
+        __M_writer('\n')
+        return ''
+    finally:
+        context.caller_stack._pop_frame()
+
+
+def render_comment_form(context,url,title,identifier):
+    __M_caller = context.caller_stack._push_frame()
+    try:
+        __M_writer = context.writer()
+        __M_writer('\n')
+        return ''
+    finally:
+        context.caller_stack._pop_frame()
+
+
+def render_comment_link(context,link,identifier):
+    __M_caller = context.caller_stack._push_frame()
+    try:
+        __M_writer = context.writer()
+        __M_writer('\n')
+        return ''
+    finally:
+        context.caller_stack._pop_frame()
+
+
+def render_comment_link_script(context):
+    __M_caller = context.caller_stack._push_frame()
+    try:
+        __M_writer = context.writer()
+        __M_writer('\n')
+        return ''
+    finally:
+        context.caller_stack._pop_frame()
+
+
+"""
+__M_BEGIN_METADATA
+{"filename": "/home/thomas/.local/lib/python3.9/site-packages/nikola/data/themes/base/templates/comments_helper_dummy.tmpl", "uri": "comments_helper_dummy.tmpl", "source_encoding": "utf-8", "line_map": {"16": 0, "21": 2, "22": 4, "23": 7, "24": 10, "30": 3, "34": 3, "40": 6, "44": 6, "50": 9, "54": 9, "60": 54}}
+__M_END_METADATA
+"""

cache/.mako.tmp/crumbs.tmpl.py

@@ -0,0 +1,59 @@
+# -*- coding:utf-8 -*-
+from mako import runtime, filters, cache
+UNDEFINED = runtime.UNDEFINED
+STOP_RENDERING = runtime.STOP_RENDERING
+__M_dict_builtin = dict
+__M_locals_builtin = locals
+_magic_number = 10
+_modified_time = 1676236796.246071
+_enable_loop = True
+_template_filename = 'themes/bootstrap3/templates/crumbs.tmpl'
+_template_uri = 'crumbs.tmpl'
+_source_encoding = 'utf-8'
+_exports = ['bar']
+
+
+def _mako_get_namespace(context, name):
+    try:
+        return context.namespaces[(__name__, name)]
+    except KeyError:
+        _mako_generate_namespaces(context)
+        return context.namespaces[(__name__, name)]
+def _mako_generate_namespaces(context):
+    ns = runtime.TemplateNamespace('ui', context._clean_inheritance_tokens(), templateuri='ui_helper.tmpl', callables=None,  calling_uri=_template_uri)
+    context.namespaces[(__name__, 'ui')] = ns
+
+def render_body(context,**pageargs):
+    __M_caller = context.caller_stack._push_frame()
+    try:
+        __M_locals = __M_dict_builtin(pageargs=pageargs)
+        _import_ns = {}
+        _mako_get_namespace(context, 'ui')._populate(_import_ns, ['*'])
+        __M_writer = context.writer()
+        __M_writer('\n')
+        __M_writer('\n')
+        return ''
+    finally:
+        context.caller_stack._pop_frame()
+
+
+def render_bar(context,crumbs):
+    __M_caller = context.caller_stack._push_frame()
+    try:
+        _import_ns = {}
+        _mako_get_namespace(context, 'ui')._populate(_import_ns, ['*'])
+        ui = _mako_get_namespace(context, 'ui')
+        __M_writer = context.writer()
+        __M_writer('\n')
+        __M_writer(str(ui.breadcrumbs(crumbs)))
+        __M_writer('\n')
+        return ''
+    finally:
+        context.caller_stack._pop_frame()
+
+
+"""
+__M_BEGIN_METADATA
+{"filename": "themes/bootstrap3/templates/crumbs.tmpl", "uri": "crumbs.tmpl", "source_encoding": "utf-8", "line_map": {"23": 2, "26": 0, "33": 2, "34": 5, "40": 3, "47": 3, "48": 4, "49": 4, "55": 49}}
+__M_END_METADATA
+"""

cache/.mako.tmp/index_helper.tmpl.py

@@ -0,0 +1,84 @@
+# -*- coding:utf-8 -*-
+from mako import runtime, filters, cache
+UNDEFINED = runtime.UNDEFINED
+STOP_RENDERING = runtime.STOP_RENDERING
+__M_dict_builtin = dict
+__M_locals_builtin = locals
+_magic_number = 10
+_modified_time = 1676236796.405856
+_enable_loop = True
+_template_filename = '/home/thomas/.local/lib/python3.9/site-packages/nikola/data/themes/base/templates/index_helper.tmpl'
+_template_uri = 'index_helper.tmpl'
+_source_encoding = 'utf-8'
+_exports = ['html_pager', 'mathjax_script']
+
+
+def _mako_get_namespace(context, name):
+    try:
+        return context.namespaces[(__name__, name)]
+    except KeyError:
+        _mako_generate_namespaces(context)
+        return context.namespaces[(__name__, name)]
+def _mako_generate_namespaces(context):
+    ns = runtime.TemplateNamespace('math', context._clean_inheritance_tokens(), templateuri='math_helper.tmpl', callables=None,  calling_uri=_template_uri)
+    context.namespaces[(__name__, 'math')] = ns
+
+def render_body(context,**pageargs):
+    __M_caller = context.caller_stack._push_frame()
+    try:
+        __M_locals = __M_dict_builtin(pageargs=pageargs)
+        __M_writer = context.writer()
+        __M_writer('\n')
+        __M_writer('\n\n')
+        __M_writer('\n')
+        return ''
+    finally:
+        context.caller_stack._pop_frame()
+
+
+def render_html_pager(context):
+    __M_caller = context.caller_stack._push_frame()
+    try:
+        messages = context.get('messages', UNDEFINED)
+        prevlink = context.get('prevlink', UNDEFINED)
+        nextlink = context.get('nextlink', UNDEFINED)
+        __M_writer = context.writer()
+        __M_writer('\n')
+        if prevlink or nextlink:
+            __M_writer('        <nav class="postindexpager">\n        <ul class="pager">\n')
+            if prevlink:
+                __M_writer('            <li class="previous">\n                <a href="')
+                __M_writer(str(prevlink))
+                __M_writer('" rel="prev">')
+                __M_writer(str(messages("Newer posts")))
+                __M_writer('</a>\n            </li>\n')
+            if nextlink:
+                __M_writer('            <li class="next">\n                <a href="')
+                __M_writer(str(nextlink))
+                __M_writer('" rel="next">')
+                __M_writer(str(messages("Older posts")))
+                __M_writer('</a>\n            </li>\n')
+            __M_writer('        </ul>\n        </nav>\n')
+        return ''
+    finally:
+        context.caller_stack._pop_frame()
+
+
+def render_mathjax_script(context,posts):
+    __M_caller = context.caller_stack._push_frame()
+    try:
+        math = _mako_get_namespace(context, 'math')
+        __M_writer = context.writer()
+        __M_writer('\n    ')
+        __M_writer(str(math.math_scripts_ifposts(posts)))
+        __M_writer('\n')
+        return ''
+    finally:
+        context.caller_stack._pop_frame()
+
+
+"""
+__M_BEGIN_METADATA
+{"filename": "/home/thomas/.local/lib/python3.9/site-packages/nikola/data/themes/base/templates/index_helper.tmpl", "uri": "index_helper.tmpl", "source_encoding": "utf-8", "line_map": {"23": 2, "26": 0, "31": 2, "32": 20, "33": 25, "39": 3, "46": 3, "47": 4, "48": 5, "49": 7, "50": 8, "51": 9, "52": 9, "53": 9, "54": 9, "55": 12, "56": 13, "57": 14, "58": 14, "59": 14, "60": 14, "61": 17, "67": 23, "72": 23, "73": 24, "74": 24, "80": 74}}
+__M_END_METADATA
+"""

cache/.mako.tmp/page.tmpl.py

@@ -0,0 +1,42 @@
+# -*- coding:utf-8 -*-
+from mako import runtime, filters, cache
+UNDEFINED = runtime.UNDEFINED
+STOP_RENDERING = runtime.STOP_RENDERING
+__M_dict_builtin = dict
+__M_locals_builtin = locals
+_magic_number = 10
+_modified_time = 1676236796.0620935
+_enable_loop = True
+_template_filename = '/home/thomas/.local/lib/python3.9/site-packages/nikola/data/themes/base/templates/page.tmpl'
+_template_uri = 'page.tmpl'
+_source_encoding = 'utf-8'
+_exports = []
+
+
+def _mako_get_namespace(context, name):
+    try:
+        return context.namespaces[(__name__, name)]
+    except KeyError:
+        _mako_generate_namespaces(context)
+        return context.namespaces[(__name__, name)]
+def _mako_generate_namespaces(context):
+    pass
+def _mako_inherit(template, context):
+    _mako_generate_namespaces(context)
+    return runtime._inherit_from(context, 'story.tmpl', _template_uri)
+def render_body(context,**pageargs):
+    __M_caller = context.caller_stack._push_frame()
+    try:
+        __M_locals = __M_dict_builtin(pageargs=pageargs)
+        __M_writer = context.writer()
+        __M_writer('\n')
+        return ''
+    finally:
+        context.caller_stack._pop_frame()
+
+
+"""
+__M_BEGIN_METADATA
+{"filename": "/home/thomas/.local/lib/python3.9/site-packages/nikola/data/themes/base/templates/page.tmpl", "uri": "page.tmpl", "source_encoding": "utf-8", "line_map": {"27": 0, "32": 1, "38": 32}}
+__M_END_METADATA
+"""

cache/.mako.tmp/story.tmpl.py

@@ -0,0 +1,107 @@
+# -*- coding:utf-8 -*-
+from mako import runtime, filters, cache
+UNDEFINED = runtime.UNDEFINED
+STOP_RENDERING = runtime.STOP_RENDERING
+__M_dict_builtin = dict
+__M_locals_builtin = locals
+_magic_number = 10
+_modified_time = 1676236796.0727968
+_enable_loop = True
+_template_filename = '/home/thomas/.local/lib/python3.9/site-packages/nikola/data/themes/base/templates/story.tmpl'
+_template_uri = 'story.tmpl'
+_source_encoding = 'utf-8'
+_exports = ['content']
+
+
+def _mako_get_namespace(context, name):
+    try:
+        return context.namespaces[(__name__, name)]
+    except KeyError:
+        _mako_generate_namespaces(context)
+        return context.namespaces[(__name__, name)]
+def _mako_generate_namespaces(context):
+    ns = runtime.TemplateNamespace('helper', context._clean_inheritance_tokens(), templateuri='post_helper.tmpl', callables=None,  calling_uri=_template_uri)
+    context.namespaces[(__name__, 'helper')] = ns
+
+    ns = runtime.TemplateNamespace('pheader', context._clean_inheritance_tokens(), templateuri='post_header.tmpl', callables=None,  calling_uri=_template_uri)
+    context.namespaces[(__name__, 'pheader')] = ns
+
+    ns = runtime.TemplateNamespace('comments', context._clean_inheritance_tokens(), templateuri='comments_helper.tmpl', callables=None,  calling_uri=_template_uri)
+    context.namespaces[(__name__, 'comments')] = ns
+
+    ns = runtime.TemplateNamespace('math', context._clean_inheritance_tokens(), templateuri='math_helper.tmpl', callables=None,  calling_uri=_template_uri)
+    context.namespaces[(__name__, 'math')] = ns
+
+def _mako_inherit(template, context):
+    _mako_generate_namespaces(context)
+    return runtime._inherit_from(context, 'post.tmpl', _template_uri)
+def render_body(context,**pageargs):
+    __M_caller = context.caller_stack._push_frame()
+    try:
+        __M_locals = __M_dict_builtin(pageargs=pageargs)
+        math = _mako_get_namespace(context, 'math')
+        enable_comments = context.get('enable_comments', UNDEFINED)
+        messages = context.get('messages', UNDEFINED)
+        comments = _mako_get_namespace(context, 'comments')
+        post = context.get('post', UNDEFINED)
+        site_has_comments = context.get('site_has_comments', UNDEFINED)
+        pheader = _mako_get_namespace(context, 'pheader')
+        def content():
+            return render_content(context._locals(__M_locals))
+        __M_writer = context.writer()
+        __M_writer('\n')
+        __M_writer('\n')
+        __M_writer('\n')
+        __M_writer('\n')
+        __M_writer('\n\n')
+        if 'parent' not in context._data or not hasattr(context._data['parent'], 'content'):
+            context['self'].content(**pageargs)
+        
+
+        __M_writer('\n')
+        return ''
+    finally:
+        context.caller_stack._pop_frame()
+
+
+def render_content(context,**pageargs):
+    __M_caller = context.caller_stack._push_frame()
+    try:
+        math = _mako_get_namespace(context, 'math')
+        enable_comments = context.get('enable_comments', UNDEFINED)
+        messages = context.get('messages', UNDEFINED)
+        comments = _mako_get_namespace(context, 'comments')
+        post = context.get('post', UNDEFINED)
+        site_has_comments = context.get('site_has_comments', UNDEFINED)
+        pheader = _mako_get_namespace(context, 'pheader')
+        def content():
+            return render_content(context)
+        __M_writer = context.writer()
+        __M_writer('\n<article class="post-')
+        __M_writer(str(post.meta('type')))
+        __M_writer(' storypage" itemscope="itemscope" itemtype="http://schema.org/Article">\n    <header>\n        ')
+        __M_writer(str(pheader.html_title()))
+        __M_writer('\n        ')
+        __M_writer(str(pheader.html_translations(post)))
+        __M_writer('\n    </header>\n    <div class="e-content entry-content" itemprop="articleBody text">\n    ')
+        __M_writer(str(post.text()))
+        __M_writer('\n    </div>\n')
+        if site_has_comments and enable_comments and not post.meta('nocomments'):
+            __M_writer('        <section class="comments">\n        <h2>')
+            __M_writer(str(messages("Comments")))
+            __M_writer('</h2>\n        ')
+            __M_writer(str(comments.comment_form(post.permalink(absolute=True), post.title(), post.base_path)))
+            __M_writer('\n        </section>\n')
+        __M_writer('    ')
+        __M_writer(str(math.math_scripts_ifpost(post)))
+        __M_writer('\n</article>\n')
+        return ''
+    finally:
+        context.caller_stack._pop_frame()
+
+
+"""
+__M_BEGIN_METADATA
+{"filename": "/home/thomas/.local/lib/python3.9/site-packages/nikola/data/themes/base/templates/story.tmpl", "uri": "story.tmpl", "source_encoding": "utf-8", "line_map": {"23": 2, "26": 3, "29": 4, "32": 5, "38": 0, "52": 2, "53": 3, "54": 4, "55": 5, "56": 6, "61": 25, "67": 8, "80": 8, "81": 9, "82": 9, "83": 11, "84": 11, "85": 12, "86": 12, "87": 15, "88": 15, "89": 17, "90": 18, "91": 19, "92": 19, "93": 20, "94": 20, "95": 23, "96": 23, "97": 23, "103": 97}}
+__M_END_METADATA
+"""

cache/.mako.tmp/ui_helper.tmpl.py

@@ -0,0 +1,57 @@
+# -*- coding:utf-8 -*-
+from mako import runtime, filters, cache
+UNDEFINED = runtime.UNDEFINED
+STOP_RENDERING = runtime.STOP_RENDERING
+__M_dict_builtin = dict
+__M_locals_builtin = locals
+_magic_number = 10
+_modified_time = 1676236796.2577004
+_enable_loop = True
+_template_filename = 'themes/bootstrap3/templates/ui_helper.tmpl'
+_template_uri = 'ui_helper.tmpl'
+_source_encoding = 'utf-8'
+_exports = ['breadcrumbs']
+
+
+def render_body(context,**pageargs):
+    __M_caller = context.caller_stack._push_frame()
+    try:
+        __M_locals = __M_dict_builtin(pageargs=pageargs)
+        __M_writer = context.writer()
+        __M_writer('\n')
+        return ''
+    finally:
+        context.caller_stack._pop_frame()
+
+
+def render_breadcrumbs(context,crumbs):
+    __M_caller = context.caller_stack._push_frame()
+    try:
+        index_file = context.get('index_file', UNDEFINED)
+        __M_writer = context.writer()
+        __M_writer('\n')
+        if crumbs:
+            __M_writer('<nav class="breadcrumbs">\n<ul class="breadcrumb">\n')
+            for link, text in crumbs:
+                if text != index_file:
+                    if link == '#':
+                        __M_writer('                <li>')
+                        __M_writer(str(text.rsplit('.html', 1)[0]))
+                        __M_writer('</li>\n')
+                    else:
+                        __M_writer('                <li><a href="')
+                        __M_writer(str(link))
+                        __M_writer('">')
+                        __M_writer(str(text))
+                        __M_writer('</a></li>\n')
+            __M_writer('</ul>\n</nav>\n')
+        return ''
+    finally:
+        context.caller_stack._pop_frame()
+
+
+"""
+__M_BEGIN_METADATA
+{"filename": "themes/bootstrap3/templates/ui_helper.tmpl", "uri": "ui_helper.tmpl", "source_encoding": "utf-8", "line_map": {"16": 0, "21": 18, "27": 2, "32": 2, "33": 3, "34": 4, "35": 6, "36": 7, "37": 8, "38": 9, "39": 9, "40": 9, "41": 10, "42": 11, "43": 11, "44": 11, "45": 11, "46": 11, "47": 15, "53": 47}}
+__M_END_METADATA
+"""

cache/galleries/demo/index.html

@@ -0,0 +1,2 @@
+<p>Some public domain pictures of Nikola Tesla
+(copied from <a class="reference external" href="https://kerryr.net/pioneers/gallery/tesla.htm">here</a>)</p>

cache/pages/1.html

@@ -0,0 +1,5 @@
+<p>Hope you enjoy this software!</p>
+<ul class="simple">
+<li><p>Home page at <a class="reference external" href="https://getnikola.com/">https://getnikola.com/</a></p></li>
+<li><p>Author's blog (and reason why Nikola exists): <a class="reference external" href="https://ralsina.me/">https://ralsina.me/</a></p></li>
+</ul>

cache/pages/dr-nikolas-vendetta.html

@@ -0,0 +1,348 @@
+<!DOCTYPE html>
+<div><p class="subtitle">By <a class="reference external" href="https://www.gutenberg.org/ebooks/author/3587"><span class="caps">GUY</span>&nbsp;<span class="caps">BOOTHBY</span></a></p>
+<p>Author of &#8220;Dr. Nikola,&#8221; &#8220;The Beautiful White Devil,&#8221; etc.,&nbsp;etc.</p>
+<figure>
+<img alt="/images/frontispiece.jpg" class="bookfig" src="/images/frontispiece.jpg">
+</figure>
+<aside class="topic">
+<p class="topic-title">The Project Gutenberg EBook of A Bid for Fortune, by Guy&nbsp;Boothby</p>
+<p>This eBook is for the use of anyone anywhere at no cost and with
+almost no restrictions whatsoever.  You may copy it, give it away or
+re-use it under the terms of the Project Gutenberg License included
+with this eBook or online at&nbsp;www.gutenberg.org</p>
+<p>Title: A Bid for Fortune
+or Dr. Nikola&#8217;s&nbsp;Vendetta</p>
+<p>Author: <a class="reference external" href="https://www.gutenberg.org/ebooks/author/3587">Guy&nbsp;Boothby</a></p>
+<p>Release Date: May 29, 2007 [EBook&nbsp;#21640]</p>
+<p>Language:&nbsp;English</p>
+<p>Produced by Marilynda Fraser-Cunliffe, Mary Meehan and the
+Online Distributed Proofreading Team at <a class="reference external" href="https://www.pgdp.net">https://www.pgdp.net</a></p>
+<p>Originally published&nbsp;by:</p>
+<p><span class="caps">WARD</span>, <span class="caps">LOCK</span> <span class="amp">&amp;</span> <span class="caps">CO</span>., <span class="caps">LIMITED</span>
+<span class="caps">LONDON</span>, <span class="caps">MELBOURNE</span> <span class="caps">AND</span> <span class="caps">TORONTO</span>&nbsp;1918</p>
+</aside>
+<figure>
+<img alt="/images/illus_001.jpg" class="bookfig" src="/images/illus_001.jpg">
+</figure>
+<section id="part-i">
+<h1><span class="caps">PART</span>&nbsp;I</h1>
+<section id="prologue">
+<h2><span class="caps">PROLOGUE</span></h2>
+<p><span class="smallcaps">The</span> manager of the new Imperial Restaurant on the Thames Embankment went
+into his luxurious private office and shut the door. Having done so, he
+first scratched his chin reflectively, and then took a letter from the
+drawer in which it had reposed for more than two months and perused it
+carefully. Though he was not aware of it, this was the thirtieth time he
+had read it since breakfast that morning. And yet he was not a whit
+nearer understanding it than he had been at the beginning. He turned it
+over and scrutinized the back, where not a sign of writing was to be
+seen; he held it up to the window, as if he might hope to discover
+something from the water-mark; but there was nothing in either of these
+places of a nature calculated to set his troubled mind at rest. Then he
+took a magnificent repeater watch from his waistcoat pocket and glanced
+at the dial; the hands stood at half-past seven. He immediately threw
+the letter on the table, and as he did so his anxiety found relief in&nbsp;words.</p>
+<p><span class="dquo">&#8220;</span>It&#8217;s really the most extraordinary affair I ever had to do with,&#8221; he
+remarked. &#8220;And as I&#8217;ve been in the business just three-and-thirty years
+at eleven a.m. next Monday morning, I ought to know something about it.
+I only hope I&#8217;ve done right, that&#8217;s&nbsp;all.&#8221;</p>
+<p>As he spoke, the chief bookkeeper, who had the treble advantage of being
+tall, pretty, and just eight-and-twenty years of age, entered the room.
+She noticed the open letter and the look upon her chief&#8217;s face, and her
+curiosity was proportionately&nbsp;excited.</p>
+<p><span class="dquo">&#8220;</span>You seem worried, Mr. McPherson,&#8221; she said tenderly, as she put down
+the papers she had brought in for his&nbsp;signature.</p>
+<p><span class="dquo">&#8220;</span>You have just hit it, Miss O&#8217;Sullivan,&#8221; he answered, pushing them
+farther on to the table. &#8220;I am worried about many things, but
+particularly about this&nbsp;letter.&#8221;</p>
+<p>He handed the epistle to her, and she, being desirous of impressing him
+with her business capabilities, read it with ostentatious care. But it
+was noticeable that when she reached the signature she too turned back
+to the beginning, and then deliberately read it over again. The manager
+rose, crossed to the mantelpiece, and rang for the head waiter. Having
+relieved his feelings in this way, he seated himself again at his
+writing-table, put on his glasses, and stared at his companion, while
+waiting for her to&nbsp;speak.</p>
+<p><span class="dquo">&#8220;</span>It&#8217;s very funny,&#8221; she said. &#8220;Very funny&nbsp;indeed!&#8221;</p>
+<p><span class="dquo">&#8220;</span>It&#8217;s the most extraordinary communication I have ever received,&#8221; he
+replied with conviction. &#8220;You see it is written from Cuyaba, Brazil. The
+date is three months ago to a day. Now I have taken the trouble to find
+out where and what Cuyaba&nbsp;is.&#8221;</p>
+<p>He made this confession with an air of conscious pride, and having done
+so, laid himself back in his chair, stuck his thumbs into the armholes
+of his waistcoat, and looked at his fair subordinate for approval. Nor
+was he destined to be disappointed. He was a bachelor in possession of a
+snug income, and she, besides being pretty, was a lady with a keen eye
+to the main&nbsp;chance.</p>
+<p><span class="dquo">&#8220;</span>And where <em>is</em> Cuyaba?&#8221; she asked&nbsp;humbly.</p>
+<p><span class="dquo">&#8220;</span>Cuyaba,&#8221; he replied, rolling his tongue with considerable relish round
+his unconscious mispronunciation of the name, &#8220;is a town almost on the
+western or Bolivian border of Brazil. It is of moderate size, is
+situated on the banks of the river Cuyaba, and is considerably connected
+with the famous Brazilian Diamond&nbsp;Fields.&#8221;</p>
+<p><span class="dquo">&#8220;</span>And does the writer of this letter live&nbsp;there?&#8221;</p>
+<p><span class="dquo">&#8220;</span>I cannot say. He writes from there&#8212;that is enough for&nbsp;us.&#8221;</p>
+<p><span class="dquo">&#8220;</span>And he orders dinner for four&#8212;here, in a private room overlooking the
+river, three months ahead&#8212;punctually at eight o&#8217;clock, gives you a list
+of the things he wants, and even arranges the decoration of the table.
+Says he has never seen either of his three friends before; that one of
+them hails from (here she consulted the letter again) Hang-chow, another
+from Bloemfontein, while the third resides, at present, in England. Each
+one is to present an ordinary visiting card with a red dot on it to the
+porter in the hall, and to be shown to the room at once. I don&#8217;t
+understand it at&nbsp;all.&#8221;</p>
+<p>The manager paused for a moment, and then said deliberately,&#8212;&#8221;Hang-chow
+is in China, Bloemfontein is in South&nbsp;Africa.&#8221;</p>
+<p><span class="dquo">&#8220;</span>What a wonderful man you are, to be sure, Mr. McPherson! I never can
+<em>think</em> how you manage to carry so much in your&nbsp;head.&#8221;</p>
+<p>There spoke the true woman. And it was a move in the right direction,
+for the manager was susceptible to her gentle influence, as she had
+occasion to&nbsp;know.</p>
+<p>At this juncture the head waiter appeared upon the scene, and took up a
+position just inside the doorway, as if he were afraid of injuring the
+carpet by coming&nbsp;farther.</p>
+<p><span class="dquo">&#8220;</span>Is No. 22 ready,&nbsp;Williams?&#8221;</p>
+<p><span class="dquo">&#8220;</span>Quite ready, sir. The wine is on the ice, and cook tells me he&#8217;ll be
+ready to dish punctual to the&nbsp;moment.&#8221;</p>
+<p><span class="dquo">&#8220;</span>The letter says, &#8216;no electric light; candles with red shades.&#8217; Have you
+put on those shades I got this&nbsp;morning?&#8221;</p>
+<p><span class="dquo">&#8220;</span>Just seen it done this very minute,&nbsp;sir.&#8221;</p>
+<p><span class="dquo">&#8220;</span>And let me see, there was one other thing.&#8221; He took the letter from the
+chief bookkeeper&#8217;s hand and glanced at it. &#8220;Ah, yes, a porcelain saucer,
+and a small jug of new milk upon the mantelpiece. An extraordinary
+request, but has it been attended&nbsp;to?&#8221;</p>
+<p><span class="dquo">&#8220;</span>I put it there myself,&nbsp;sir.&#8221;</p>
+<p><span class="dquo">&#8220;</span>Who&nbsp;wait?&#8221;</p>
+<p><span class="dquo">&#8220;</span>Jones, Edmunds, Brooks, and&nbsp;Tomkins.&#8221;</p>
+<p><span class="dquo">&#8220;</span>Very good. Then I think that will do. Stay! You had better tell the
+hall porter to look out for three gentlemen presenting plain visiting
+cards with a little red spot on them. Let Brooks wait in the hall, and
+when they arrive tell him to show them straight up to the&nbsp;room.&#8221;</p>
+<p><span class="dquo">&#8220;</span>It shall be done,&nbsp;sir.&#8221;</p>
+<p>The head waiter left the room, and the manager stretched himself in his
+chair, yawned by way of showing his importance, and then said&nbsp;solemnly,&#8212;</p>
+<p><span class="dquo">&#8220;</span>I don&#8217;t believe they&#8217;ll any of them turn up; but if they do, this Dr.
+Nikola, whoever he may be, won&#8217;t be able to find fault with my&nbsp;arrangements.&#8221;</p>
+<p>Then, leaving the dusty high road of Business, he and his companion
+wandered in the shady bridle-paths of Love&#8212;to the end that when the
+chief bookkeeper returned to her own department she had forgotten the
+strange dinner party about to take place upstairs, and was busily
+engaged upon a calculation as to how she would look in white satin and
+orange blossoms, and, that settled, fell to wondering whether it was
+true, as Miss Joyce, a subordinate, had been heard to declare, that the
+manager had once shown himself partial to a certain widow with reputed
+savings and a share in an extensive egg and dairy&nbsp;business.</p>
+<p>At ten minutes to eight precisely a hansom drew up at the steps of the
+hotel. As soon as it stopped, an undersized gentleman, with a clean
+shaven countenance, a canonical corporation, and bow legs, dressed in a
+decidedly clerical garb, alighted. He paid and discharged his cabman,
+and then took from his ticket pocket an ordinary white visiting card,
+which he presented to the gold-laced individual who had opened the
+apron. The latter, having noted the red spot, called a waiter, and the
+reverend gentleman was immediately escorted&nbsp;upstairs.</p>
+<p>Hardly had the attendant time to return to his station in the hall,
+before a second cab made its appearance, closely followed by a third.
+Out of the second jumped a tall, active, well-built man of about thirty
+years of age. He was dressed in evening dress of the latest fashion, and
+to conceal it from the vulgar gaze, wore a large Inverness cape of heavy
+texture. He also in his turn handed a white card to the porter, and,
+having done so, proceeded into the hall, followed by the occupant of the
+last cab, who had closely copied his example. This individual was also
+in evening dress, but it was of a different stamp. It was old-fashioned
+and had seen much use. The wearer, too, was taller than the ordinary run
+of men, while it was noticeable that his hair was snow-white, and that
+his face was deeply pitted with smallpox. After disposing of their hats
+and coats in an ante-room, they reached room No. 22, where they found
+the gentleman in clerical costume pacing impatiently up and&nbsp;down.</p>
+<p>Left alone, the tallest of the trio, who for want of a better title we
+may call the Best Dressed Man, took out his watch, and having glanced at
+it, looked at his companions. &#8220;Gentlemen,&#8221; he said, with a slight
+American accent, &#8220;it is three minutes to eight o&#8217;clock. My name is&nbsp;Eastover!&#8221;</p>
+<p><span class="dquo">&#8220;</span>I&#8217;m glad to hear it, for I&#8217;m most uncommonly hungry,&#8221; said the next
+tallest, whom I have already described as being so marked by disease.
+&#8220;My name is&nbsp;Prendergast!&#8221;</p>
+<p><span class="dquo">&#8220;</span>We only wait for our friend and host,&#8221; remarked the clerical gentleman,
+as if he felt he ought to take a share in the conversation, and then, as
+an afterthought, he continued, &#8220;My name is&nbsp;Baxter!&#8221;</p>
+<p>They shook hands all round with marked cordiality, seated themselves
+again, and took it in turns to examine the&nbsp;clock.</p>
+<p><span class="dquo">&#8220;</span>Have you ever had the pleasure of meeting our host before?&#8221; asked Mr.
+Baxter of Mr.&nbsp;Prendergast.</p>
+<p><span class="dquo">&#8220;</span>Never,&#8221; replied that gentleman, with a shake of his head. &#8220;Perhaps Mr.
+Eastover has been more&nbsp;fortunate?&#8221;</p>
+<p><span class="dquo">&#8220;</span>Not I,&#8221; was the brief rejoinder. &#8220;I&#8217;ve had to do with him off and on
+for longer than I care to reckon, but I&#8217;ve never set eyes on him up to&nbsp;date.&#8221;</p>
+<p><span class="dquo">&#8220;</span>And where may he have been the first time you heard from&nbsp;him?&#8221;</p>
+<p><span class="dquo">&#8220;</span>In Nashville, Tennessee,&#8221; said Eastover. &#8220;After that, Tahupapa, New
+Zealand; after that, Papeete, in the Society Islands; then Pekin, China.
+And&nbsp;you?&#8221;</p>
+<p><span class="dquo">&#8220;</span>First time, Brussels; second, Monte Video; third, Mandalay, and then
+the Gold Coast, Africa. It&#8217;s your turn, Mr.&nbsp;Baxter.&#8221;</p>
+<p>The clergyman glanced at the timepiece. It was exactly eight o&#8217;clock.
+&#8220;First time, Cabul, Afghanistan; second, Nijni Novgorod, Russia; third,
+Wilcannia, Darling River, Australia; fourth, Valparaiso, Chili; fifth,
+Nagasaki,&nbsp;Japan.&#8221;</p>
+<p><span class="dquo">&#8220;</span>He is evidently a great traveller and a most mysterious&nbsp;person.&#8221;</p>
+<p><span class="dquo">&#8220;</span>He is more than that,&#8221; said Eastover with conviction; &#8220;he is late for&nbsp;dinner!&#8221;</p>
+<p>Prendergast looked at his&nbsp;watch.</p>
+<p><span class="dquo">&#8220;</span>That clock is two minutes fast. Hark, there goes Big Ben! Eight&nbsp;exactly.&#8221;</p>
+<p>As he spoke the door was thrown open and a voice announced &#8220;Dr.&nbsp;Nikola.&#8221;</p>
+<p>The three men sprang to their feet simultaneously, with exclamations of
+astonishment, as the man they had been discussing made his&nbsp;appearance.</p>
+<p>It would take more time than I can spare the subject to give you an
+adequate and inclusive description of the person who entered the room at
+that moment. In stature he was slightly above the ordinary, his
+shoulders were broad, his limbs perfectly shaped and plainly muscular,
+but very slim. His head, which was magnificently set upon his shoulders,
+was adorned with a profusion of glossy black hair; his face was
+destitute of beard or moustache, and was of oval shape and handsome
+moulding; while his skin was of a dark olive hue, a colour which
+harmonized well with his piercing black eyes and pearly teeth. His hands
+and feet were small, and the greatest dandy must have admitted that he
+was irreproachably dressed, with a neatness that bordered on the
+puritanical. In age he might have been anything from eight-and-twenty to
+forty; in reality he was thirty-three. He advanced into the room and
+walked with out-stretched hand directly across to where Eastover was
+standing by the&nbsp;fireplace.</p>
+<p><span class="dquo">&#8220;</span>Mr. Eastover, I feel certain,&#8221; he said, fixing his glittering eyes upon
+the man he addressed, and allowing a curious smile to play upon his&nbsp;face.</p>
+<p><span class="dquo">&#8220;</span>That is my name, Dr. Nikola,&#8221; the other answered with evident surprise.
+&#8220;But how on earth can you distinguish me from your other&nbsp;guests?&#8221;</p>
+<p><span class="dquo">&#8220;</span>Ah! it would surprise you if you knew. And Mr. Prendergast, and Mr.
+Baxter. This is delightful; I hope I am not late. We had a collision in
+the Channel this morning, and I was almost afraid I might not be up to
+time. Dinner seems ready; shall we sit down to it?&#8221; They seated
+themselves, and the meal commenced. The Imperial Restaurant has earned
+an enviable reputation for doing things well, and the dinner that night
+did not in any way detract from its lustre. But, delightful as it all
+was, it was noticeable that the three guests paid more attention to
+their host than to his excellent <em>menu</em>. As they had said before his
+arrival, they had all had dealings with him for several years, but what
+those dealings were they were careful not to describe. It was more than
+possible that they hardly liked to remember them&nbsp;themselves.</p>
+<p>When coffee had been served and the servants had withdrawn, Dr. Nikola
+rose from the table, and went across to the massive sideboard. On it
+stood a basket of very curious shape and workmanship. This he opened,
+and as he did so, to the astonishment of his guests, an enormous cat, as
+black as his master&#8217;s coat, leaped out on to the floor. The reason for
+the saucer and jug of milk became&nbsp;evident.</p>
+<p>Seating himself at the table again, the host followed the example of his
+guests and lit a cigar, blowing a cloud of smoke luxuriously through his
+delicately chiselled nostrils. His eyes wandered round the cornice of
+the room, took in the pictures and decorations, and then came down to
+meet the faces of his companions. As they did so, the black cat, having
+finished its meal, sprang on to his shoulder to crouch there, watching
+the three men through the curling smoke drift with its green blinking,
+fiendish eyes. Dr. Nikola smiled as he noticed the effect the animal had
+upon his&nbsp;guests.</p>
+<p><span class="dquo">&#8220;</span>Now shall we get to business?&#8221; he said&nbsp;briskly.</p>
+<p>The others almost simultaneously knocked the ashes off their cigars and
+brought themselves to attention. Dr. Nikola&#8217;s dainty, languid manner
+seemed to drop from him like a cloak, his eyes brightened, and his
+voice, when he spoke, was clean cut as chiselled&nbsp;silver.</p>
+<p><span class="dquo">&#8220;</span>You are doubtless anxious to be informed why I summoned you from all
+parts of the globe to meet me here to-night? And it is very natural you
+should be. But then, from what you know of me, you should not be
+surprised at anything I&nbsp;do.&#8221;</p>
+<p>His voice dropped back into its old tone of gentle languor. He drew in a
+great breath of smoke and then sent it slowly out from his lips again.
+His eyes were half closed, and he drummed with one finger on the table
+edge. The cat looked through the smoke at the three men, and it seemed
+to them that he grew every moment larger and more ferocious. Presently
+his owner took him from his perch, and seating him on his knee fell to
+stroking his fur, from head to tail, with his long slim fingers. It was
+as if he were drawing inspiration for some deadly mischief from the
+uncanny&nbsp;beast.</p>
+<p><span class="dquo">&#8220;</span>To preface what I have to say to you, let me tell you that this is by
+far the most important business for which I have ever required your
+help. (Three slow strokes down the centre of the back, and one round
+each ear.) When it first came into my mind I was at a loss who to trust
+in the matter. I thought of Vendon, but I found Vendon was dead. I
+thought of Brownlow, but Brownlow was no longer faithful. (Two strokes
+down the back and two on the throat.) Then bit by bit I remembered you.
+I was in Brazil at the time. So I sent for you. You came. So far so&nbsp;good.&#8221;</p>
+<p>He rose, and crossed over to the fireplace. As he went the cat crawled
+back to its original position on his shoulder. Then his voice changed
+once more to its former business-like&nbsp;tone.</p>
+<p><span class="dquo">&#8220;</span>I am not going to tell you very much about it. But from what I do tell
+you, you will be able to gather a great deal and imagine the rest. To
+begin with, there is a man living in this world to-day who has done me a
+great and lasting injury. What that injury is is no concern of yours.
+You would not understand if I told you. So we&#8217;ll leave that out of the
+question. He is immensely rich. His cheque for £300,000 would be
+honoured by his bank at any minute. Obviously he is a power. He has had
+reason to know that I am pitting my wits against his, and he flatters
+himself that so far he has got the better of me. That is because I am
+drawing him on. I am maturing a plan which will make him a poor and a
+very miserable man at one and the same time. If that scheme succeeds,
+and I am satisfied with the way you three men have performed the parts I
+shall call on you to play in it, I shall pay to each of you the sum of
+£10,000. If it doesn&#8217;t succeed, then you will each receive a thousand
+and your expenses. Do you follow&nbsp;me?&#8221;</p>
+<p>It was evident from their faces that they hung upon his every&nbsp;word.</p>
+<p><span class="dquo">&#8220;</span>But, remember, I demand from you your whole and entire labour. While
+you are serving me you are mine body and soul. I know you are
+trustworthy. I have had good proof that you are&#8212;pardon the
+expression&#8212;unscrupulous, and I flatter myself you are silent. What is
+more, I shall tell you nothing beyond what is necessary for the carrying
+out of my scheme, so that you could not betray me if you would. Now for
+my&nbsp;plans!&#8221;</p>
+<p>He sat down again and took a paper from his pocket. Having perused it,
+he turned to&nbsp;Eastover.</p>
+<p><span class="dquo">&#8220;</span>You will leave at once&#8212;that is to say, by the boat on Wednesday&#8212;for
+Sydney. You will book your passage to-morrow morning, first thing, and
+join her in Plymouth. You will meet me to-morrow evening at an address I
+will send you, and receive your final instructions.&nbsp;Good-night.&#8221;</p>
+<p>Seeing that he was expected to go, Eastover rose, shook hands, and left
+the room without a word. He was too astonished to hesitate or to say&nbsp;anything.</p>
+<p>Nikola took another letter from his pocket and turned to Prendergast.
+&#8220;<em>You</em> will go down to Dover to-night, cross to Paris to-morrow morning,
+and leave this letter personally at the address you will find written on
+it. On Thursday, at half-past two precisely, you will deliver me an
+answer in the porch at Charing Cross. You will find sufficient money in
+that envelope to pay all your expenses. Now&nbsp;go!&#8221;</p>
+<p><span class="dquo">&#8220;</span>At half-past two you shall have your answer.&nbsp;Good-night.&#8221;</p>
+<p><span class="dquo">&#8220;</span>Good-night.&#8221;</p>
+<p>When Prendergast had left the room, Dr. Nikola lit another cigar and
+turned his attentions to Mr.&nbsp;Baxter.</p>
+<p><span class="dquo">&#8220;</span>Six months ago, Mr. Baxter, I found for you a situation as tutor to the
+young Marquis of Beckenham. You still hold it, I&nbsp;suppose?&#8221;</p>
+<p><span class="dquo">&#8220;</span>I&nbsp;do.&#8221;</p>
+<p><span class="dquo">&#8220;</span>Is the father well disposed towards&nbsp;you?&#8221;</p>
+<p><span class="dquo">&#8220;</span>In every way. I have done my best to ingratiate myself with him. That
+was one of your&nbsp;instructions.&#8221;</p>
+<p><span class="dquo">&#8220;</span>Yes, yes! But I was not certain that you would succeed. If the old man
+is anything like what he was when I last met him he must still be a
+difficult person to deal with. Does the boy like&nbsp;you?&#8221;</p>
+<p><span class="dquo">&#8220;</span>I hope&nbsp;so.&#8221;</p>
+<p><span class="dquo">&#8220;</span>Have you brought me his photograph as I&nbsp;directed?&#8221;</p>
+<p><span class="dquo">&#8220;</span>I have. Here it&nbsp;is.&#8221;</p>
+<p>Baxter took a photograph from his pocket and handed it across the&nbsp;table.</p>
+<p><span class="dquo">&#8220;</span>Good. You have done very well, Mr. Baxter. I am pleased with you.
+To-morrow morning you will go back to&nbsp;Yorkshire&#8212;&#8212;&#8221;</p>
+<p><span class="dquo">&#8220;</span>I beg your pardon, Bournemouth. His Grace owns a house near
+Bournemouth, which he occupies during the summer&nbsp;months.&#8221;</p>
+<p><span class="dquo">&#8220;</span>Very well&#8212;then to-morrow morning you will go back to Bournemouth and
+continue to ingratiate yourself with father and son. You will also begin
+to implant in the boy&#8217;s mind a desire for travel. Don&#8217;t let him become
+aware that his desire has its source in you&#8212;but do not fail to foster
+it all you can. I will communicate with you further in a day or two. Now&nbsp;go.&#8221;</p>
+<p>Baxter in his turn left the room. The door closed. Dr. Nikola picked up
+the photograph and studied&nbsp;it.</p>
+<p><span class="dquo">&#8220;</span>The likeness is unmistakable&#8212;or it ought to be. My friend, my very
+dear friend, Wetherell, my toils are closing on you. My arrangements are
+perfecting themselves admirably. Presently, when all is complete, I
+shall press the lever, the machinery will be set in motion, and you will
+find yourself being slowly but surely ground into powder. Then you will
+hand over what I want, and be sorry you thought fit to baulk Dr.&nbsp;Nikola!&#8221;</p>
+<p>He rang the bell and ordered his bill. This duty discharged, he placed
+the cat back in its prison, shut the lid, descended with the basket to
+the hall, and called a hansom. The porter inquired to what address he
+should order the cabman to drive. Dr. Nikola did not reply for a moment,
+then he said, as if he had been thinking something out: &#8220;The <em>Green
+Sailor</em> public-house, East India Dock&nbsp;Road.&#8221;</p>
+<hr class="docutils">
+<p>You can read the rest of &#8220;A Bid For Fortune; Or, Dr. Nikola&#8217;s Vendetta&#8221; at <a class="reference external" href="https://archive.org/stream/bidforfortunenov00bootiala#page/12/mode/2up">Open&nbsp;Library</a></p>
+</section>
+</section>
+</div>

cache/pages/extending.html.dep

@@ -0,0 +1,6 @@
+/home/thomas/.local/lib/python3.9/site-packages/nikola/data/shortcodes/mako/raw.tmpl
+/home/thomas/.local/lib/python3.9/site-packages/nikola/data/shortcodes/mako/raw.tmpl
+/home/thomas/.local/lib/python3.9/site-packages/nikola/data/shortcodes/mako/raw.tmpl
+/home/thomas/.local/lib/python3.9/site-packages/nikola/data/shortcodes/mako/raw.tmpl
+/home/thomas/.local/lib/python3.9/site-packages/nikola/data/shortcodes/mako/raw.tmpl
+/home/thomas/.local/lib/python3.9/site-packages/nikola/data/shortcodes/mako/raw.tmpl

cache/pages/internals.html

@@ -0,0 +1,125 @@
+<p class="lead">When trying to guide someone into adding a feature in Nikola, it hit me that
+while the way it's structured makes sense <strong>to me</strong> it is far from obvious.</p>
+<p>So, this is a short document explaining what each piece of Nikola does and
+how it all fits together.</p>
+<dl>
+<dt>Nikola is a Pile of Plugins</dt>
+<dd><p>Most of Nikola is implemented as plugins using <a class="reference external" href="http://yapsy.sourceforge.net/">Yapsy</a>.
+You can ignore that they are plugins and just think of them as regular python
+modules and packages with a funny little <code class="docutils literal">.plugin</code> file next to them.</p>
+<p>So, 90% of the time, what you want to do is either write a new plugin or extend
+an existing one.</p>
+<p>There are several kinds of plugins, all implementing interfaces defined in
+<code class="docutils literal">nikola/plugin_categories.py</code> and documented in
+<a class="reference external" href="https://getnikola.com/extending.html">Extending Nikola</a></p>
+<p>If your plugin has a dependency, please make sure it doesn't make Nikola
+throw an exception when the dependency is missing. Try to fail gracefully
+with an informative message.</p>
+</dd>
+<dt>Commands are plugins</dt>
+<dd><p>When you use <code class="docutils literal">nikola foo</code> you are using the plugin <code class="docutils literal">command/foo</code>. Those are
+used to extend Nikola's command line. Their interface is defined in the <code class="docutils literal">Command</code>
+class. They take options and arguments and do whatever you want, so go wild.</p>
+</dd>
+<dt>The <code class="docutils literal">build</code> command is special</dt>
+<dd><p>The <code class="docutils literal">build</code> command triggers a whole lot of things, and is the core of Nikola
+because it's the one that you use to build sites. So it deserves its own section.</p>
+</dd>
+</dl>
+<section id="the-build-command">
+<h1>The Build Command</h1>
+<p>Nikola's goal is similar, deep at heart, to a Makefile. Take sources, compile them
+into something, in this case a website. Instead of a Makefile, Nikola uses
+<a class="reference external" href="https://pydoit.org">doit</a>.</p>
+<p>Doit has the concept of &quot;tasks&quot;. The 1 minute summary of tasks is that they have:</p>
+<dl class="simple">
+<dt>actions</dt>
+<dd><p>What the task <strong>does</strong>. For example, convert a markdown document into HTML.</p>
+</dd>
+<dt>dependencies</dt>
+<dd><p>If this file changes, then we need to redo the actions. If this configuration
+option changes, redo it, etc.</p>
+</dd>
+<dt>targets</dt>
+<dd><p>Files that the action generates. No two actions can have the same targets.</p>
+</dd>
+<dt>basename:name</dt>
+<dd><p>Each task is identified by either a name or a basename:name pair.</p>
+</dd>
+</dl>
+<aside class="sidebar">
+<p class="sidebar-title">More about tasks</p>
+<p>If you ever want to do your own tasks, you really should read the doit
+<a class="reference external" href="https://pydoit.org/tasks.html">documentation on tasks</a>.</p>
+<p>Notably, by default doit redirects <code class="docutils literal">stdout</code> and <code class="docutils literal">stderr</code>. To get a
+proper PDB debugging shell, you need to use doit's own
+<a class="reference external" href="https://pydoit.org/tools.html#set-trace">set_trace</a> function.</p>
+</aside>
+<p>So, what Nikola does, when you use the build command, is to read the
+configuration <code class="docutils literal">conf.py</code> from the current folder, instantiate
+the <code class="docutils literal">Nikola</code> class, and have it generate a whole list of tasks for doit
+to process. Then doit will decide which tasks need doing, and do them, in
+the right order.</p>
+<p>The place where the tasks are generated is in <code class="docutils literal">Nikola.gen_tasks</code>, which collects tasks
+from all the plugins inheriting <code class="docutils literal">BaseTask</code>, massages them a bit, then passes them
+to doit.</p>
+<p>So, if you want things to happen on <code class="docutils literal">build</code> you want to create a Task plugin, or extend
+one of the existing ones.</p>
+<aside class="sidebar">
+<p class="sidebar-title">Tests</p>
+<p>While Nikola is not a hardcore TDD project, we like tests. So, please add them if you can.
+You can write unit tests or integration tests. (Doctests are not supported
+anymore due to fragility.)</p>
+</aside>
+</section>
+<section id="posts-and-pages">
+<h1>Posts and Pages</h1>
+<p>Nikola has a concept of posts and pages. Both are more or less the same thing, except
+posts are added into RSS feeds and pages are not. All of them are in a list called
+&quot;the timeline&quot; formed by objects of class <code class="docutils literal">Post</code>.</p>
+<p>When you are creating a task that needs the list of posts and/or pages (for example,
+the RSS creation plugin) on task execution time, your plugin should call <code class="docutils literal">self.site.scan_posts()</code>
+in <code class="docutils literal">gen_tasks</code> to ensure the timeline is created and available in
+<code class="docutils literal">self.site.timeline</code>. You should not modify the timeline, because it will cause consistency issues.</p>
+<aside class="sidebar">
+<p class="sidebar-title">scan_posts</p>
+<p>The <code class="docutils literal">Nikola.scan_posts</code> function can be used in plugins to force the
+timeline creation, for example, while creating the tasks.</p>
+</aside>
+<p>Your plugin can use the timeline to generate &quot;stuff&quot; (technical term). For example,
+Nikola comes with plugins that use the timeline to create a website (surprised?).</p>
+<p>The workflow included with nikola is as follows (incomplete!):</p>
+<ol class="arabic simple">
+<li><p>The post is assigned a compiler based on its extension and the <code class="docutils literal">COMPILERS</code> option.</p></li>
+<li><p>The compiler is applied to the post data and a &quot;HTML fragment&quot; is produced. That
+fragment is stored in a cache (the <code class="docutils literal">posts</code> plugin).</p></li>
+<li><p>The configured theme has templates (and a template engine), which are applied to the post's
+HTML fragment and metadata (the <code class="docutils literal">pages</code> plugin).</p></li>
+<li><p>The original sources for the post are copied to some accessible place (the <code class="docutils literal">sources</code> plugin).</p></li>
+<li><p>If the post is tagged, some pages and RSS feeds for each tag are updated (the <code class="docutils literal">tags</code> plugin).</p></li>
+<li><p>If the post is new, it's included in the blog's RSS feed (the <code class="docutils literal">rss</code> plugin).</p></li>
+<li><p>The post is added in the right place in the index pages for the blog (the <code class="docutils literal">indexes</code> plugin).</p></li>
+<li><p>CSS/JS/Images for the theme are put in the right places (the <code class="docutils literal">copy_assets</code> and <code class="docutils literal">bundles</code> plugins).</p></li>
+<li><p>A File describing the whole site is created (the <code class="docutils literal">sitemap</code> plugin).</p></li>
+</ol>
+<p>You can add whatever you want to that list: just create a plugin for it.</p>
+<p>You can also expand Nikola's capabilities at several points:</p>
+<dl class="simple">
+<dt>compilers</dt>
+<dd><p>Nikola supports a variety of markups. If you want to add another one, you need to create
+a <code class="docutils literal">Compiler</code> plugin.</p>
+</dd>
+<dt>templates</dt>
+<dd><p>Nikola's themes can use Jinja2 or Mako templates. If you prefer another template system,
+you have to create a <code class="docutils literal">TemplateSystem</code> plugin.</p>
+</dd>
+<dt>themes</dt>
+<dd><p>To change how the generated site looks, you can create custom themes.</p>
+</dd>
+</dl>
+<p>And of course, you can also replace or extend each of the existing plugins.</p>
+<section id="nikola-architecture">
+<h2>Nikola Architecture</h2>
+<a class="reference external image-reference" href="https://getnikola.com/images/architecture.png"><img alt="https://getnikola.com/images/architecture.thumbnail.png" src="https://getnikola.com/images/architecture.thumbnail.png" /></a>
+</section>
+</section>

cache/pages/listings-demo.html

@@ -0,0 +1,15 @@
+<p>Nikola intends to let you show code easily via listings:</p>
+<p><a class="reference external" href="link://listing/listings/hello.py">hello.py</a>  <a class="reference external" href="link://listing_source/listings/hello.py">(Source)</a></p>
+<pre class="code python"><a name="rest_code_39d324261d5b4eb2910076b264d3954a-1"></a><span class="ch">#!/usr/bin/python</span>
+<a name="rest_code_39d324261d5b4eb2910076b264d3954a-2"></a>
+<a name="rest_code_39d324261d5b4eb2910076b264d3954a-3"></a><span class="kn">import</span> <span class="nn">sys</span>
+<a name="rest_code_39d324261d5b4eb2910076b264d3954a-4"></a>
+<a name="rest_code_39d324261d5b4eb2910076b264d3954a-5"></a>
+<a name="rest_code_39d324261d5b4eb2910076b264d3954a-6"></a><span class="k">def</span> <span class="nf">hello</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="s1">&#39;world&#39;</span><span class="p">):</span>
+<a name="rest_code_39d324261d5b4eb2910076b264d3954a-7"></a>    <span class="n">greeting</span> <span class="o">=</span> <span class="s2">&quot;hello &quot;</span> <span class="o">+</span> <span class="n">name</span>
+<a name="rest_code_39d324261d5b4eb2910076b264d3954a-8"></a>    <span class="nb">print</span><span class="p">(</span><span class="n">greeting</span><span class="p">)</span>
+<a name="rest_code_39d324261d5b4eb2910076b264d3954a-9"></a>
+<a name="rest_code_39d324261d5b4eb2910076b264d3954a-10"></a>
+<a name="rest_code_39d324261d5b4eb2910076b264d3954a-11"></a><span class="k">if</span> <span class="vm">__name__</span> <span class="o">==</span> <span class="s2">&quot;__main__&quot;</span><span class="p">:</span>
+<a name="rest_code_39d324261d5b4eb2910076b264d3954a-12"></a>    <span class="n">hello</span><span class="p">(</span><span class="o">*</span><span class="n">sys</span><span class="o">.</span><span class="n">argv</span><span class="p">[</span><span class="mi">1</span><span class="p">:])</span>
+</pre>

cache/pages/listings-demo.html.dep

@@ -0,0 +1 @@
+listings/hello.py

cache/pages/manual.html.dep

@@ -0,0 +1,18 @@
+/home/thomas/.local/lib/python3.9/site-packages/nikola/data/shortcodes/mako/raw.tmpl
+/home/thomas/.local/lib/python3.9/site-packages/nikola/data/shortcodes/mako/raw.tmpl
+/home/thomas/.local/lib/python3.9/site-packages/nikola/data/shortcodes/mako/raw.tmpl
+/home/thomas/.local/lib/python3.9/site-packages/nikola/data/shortcodes/mako/raw.tmpl
+/home/thomas/.local/lib/python3.9/site-packages/nikola/data/shortcodes/mako/raw.tmpl
+/home/thomas/.local/lib/python3.9/site-packages/nikola/data/shortcodes/mako/raw.tmpl
+/home/thomas/.local/lib/python3.9/site-packages/nikola/data/shortcodes/mako/raw.tmpl
+/home/thomas/.local/lib/python3.9/site-packages/nikola/data/shortcodes/mako/raw.tmpl
+/home/thomas/.local/lib/python3.9/site-packages/nikola/data/shortcodes/mako/raw.tmpl
+/home/thomas/.local/lib/python3.9/site-packages/nikola/data/shortcodes/mako/raw.tmpl
+/home/thomas/.local/lib/python3.9/site-packages/nikola/data/shortcodes/mako/raw.tmpl
+/home/thomas/.local/lib/python3.9/site-packages/nikola/data/shortcodes/mako/raw.tmpl
+/home/thomas/.local/lib/python3.9/site-packages/nikola/data/shortcodes/mako/raw.tmpl
+/home/thomas/.local/lib/python3.9/site-packages/nikola/data/shortcodes/mako/raw.tmpl
+/home/thomas/.local/lib/python3.9/site-packages/nikola/data/shortcodes/mako/raw.tmpl
+/home/thomas/.local/lib/python3.9/site-packages/nikola/data/shortcodes/mako/raw.tmpl
+/home/thomas/.local/lib/python3.9/site-packages/nikola/data/shortcodes/mako/raw.tmpl
+/home/thomas/.local/lib/python3.9/site-packages/nikola/data/shortcodes/mako/raw.tmpl

cache/pages/path_handlers.html

@@ -0,0 +1,150 @@
+<!-- DO NOT EDIT, this file is auto-generated by scripts/document_path_handlers.py -->
+<p>Nikola supports special links with the syntax <code class="docutils literal"><span class="pre">link://kind/name</span></code>. In
+templates you can also use <code class="docutils literal">_link(kind, name)</code>.  You can add query strings
+(<code class="docutils literal"><span class="pre">?key=value</span></code>) for extra arguments, or pass keyword arguments to <code class="docutils literal">_link</code> in
+templates (support and behavior depends on path handlers themselves). Fragments
+(<code class="docutils literal">#anchor</code>) will be appended to the transformed link.</p>
+<p>Here are the descriptions for all the supported kinds.</p>
+<dl class="dl-horizontal">
+<dt>archive</dt>
+<dd><p>Link to archive path, name is the year.</p>
+<p>Example:</p>
+<p>link://archive/2013 =&gt; /archives/2013/index.html</p>
+</dd>
+<dt>author</dt>
+<dd><p>Link to an author's page.</p>
+<p>Example:</p>
+<p>link://author/joe =&gt; /authors/joe.html</p>
+</dd>
+<dt>author_atom</dt>
+<dd><p>Link to an author's Atom feed.</p>
+<p>Example:</p>
+<p>link://author_atom/joe =&gt; /authors/joe.atom</p>
+</dd>
+<dt>author_index</dt>
+<dd><p>Link to the authors index.</p>
+<p>Example:</p>
+<p>link://authors/ =&gt; /authors/index.html</p>
+</dd>
+<dt>author_rss</dt>
+<dd><p>Link to an author's RSS feed.</p>
+<p>Example:</p>
+<p>link://author_rss/joe =&gt; /authors/joe.xml</p>
+</dd>
+<dt>category</dt>
+<dd><p>A link to a category. Takes page number as optional keyword argument.</p>
+<p>Example:</p>
+<p>link://category/dogs =&gt; /categories/dogs.html</p>
+</dd>
+<dt>category_atom</dt>
+<dd><p>A link to a category's Atom feed.</p>
+<p>Example:</p>
+<p>link://category_atom/dogs =&gt; /categories/dogs.atom</p>
+</dd>
+<dt>category_index</dt>
+<dd><p>A link to the category index.</p>
+<p>Example:</p>
+<p>link://category_index =&gt; /categories/index.html</p>
+</dd>
+<dt>category_rss</dt>
+<dd><p>A link to a category's RSS feed.</p>
+<p>Example:</p>
+<p>link://category_rss/dogs =&gt; /categories/dogs.xml</p>
+</dd>
+<dt>filename</dt>
+<dd><p>Link to post or page by source filename.</p>
+<p>Example:</p>
+<p>link://filename/manual.txt =&gt; /docs/handbook.html</p>
+</dd>
+<dt>gallery</dt>
+<dd><p>Link to an image gallery's path.</p>
+<p>It will try to find a gallery with that name if it's not ambiguous
+or with that path. For example:</p>
+<p>link://gallery/london =&gt; /galleries/trips/london/index.html</p>
+<p>link://gallery/trips/london =&gt; /galleries/trips/london/index.html</p>
+</dd>
+<dt>gallery_global</dt>
+<dd><p>Link to the global gallery path, which contains all the images in galleries.</p>
+<p>There is only one copy of an image on multilingual blogs, in the site root.</p>
+<p>link://gallery_global/london =&gt; /galleries/trips/london/index.html</p>
+<p>link://gallery_global/trips/london =&gt; /galleries/trips/london/index.html</p>
+<p>(a <code class="docutils literal">gallery</code> link could lead to eg. /en/galleries/trips/london/index.html)</p>
+</dd>
+<dt>gallery_rss</dt>
+<dd><p>Link to an image gallery's RSS feed.</p>
+<p>It will try to find a gallery with that name if it's not ambiguous
+or with that path. For example:</p>
+<p>link://gallery_rss/london =&gt; /galleries/trips/london/rss.xml</p>
+<p>link://gallery_rss/trips/london =&gt; /galleries/trips/london/rss.xml</p>
+</dd>
+<dt>index</dt>
+<dd><p>Link to a numbered index.</p>
+<p>Example:</p>
+<p>link://index/3 =&gt; /index-3.html</p>
+</dd>
+<dt>index_atom</dt>
+<dd><p>Link to a numbered Atom index.</p>
+<p>Example:</p>
+<p>link://index_atom/3 =&gt; /index-3.atom</p>
+</dd>
+<dt>index_rss</dt>
+<dd><p>A link to the RSS feed path.</p>
+<p>Example:</p>
+<p>link://rss =&gt; /blog/rss.xml</p>
+</dd>
+<dt>listing</dt>
+<dd><p>Return a link to a listing.</p>
+<p>It will try to use the file name if it's not ambiguous, or the file path.</p>
+<p>Example:</p>
+<p>link://listing/hello.py =&gt; /listings/tutorial/hello.py.html</p>
+<p>link://listing/tutorial/hello.py =&gt; /listings/tutorial/hello.py.html</p>
+</dd>
+<dt>listing_source</dt>
+<dd><p>Return a link to the source code for a listing.</p>
+<p>It will try to use the file name if it's not ambiguous, or the file path.</p>
+<p>Example:</p>
+<p>link://listing_source/hello.py =&gt; /listings/tutorial/hello.py</p>
+<p>link://listing_source/tutorial/hello.py =&gt; /listings/tutorial/hello.py</p>
+</dd>
+<dt>post_path</dt>
+<dd><p>Link to the destination of an element in the POSTS/PAGES settings.</p>
+<p>Example:</p>
+<p>link://post_path/posts =&gt; /blog</p>
+</dd>
+<dt>root</dt>
+<dd><p>Link to the current language's root.</p>
+<p>Example:</p>
+<p>link://root_path =&gt; /</p>
+<p>link://root_path =&gt; /translations/spanish/</p>
+</dd>
+<dt>rss</dt>
+<dd><p>A link to the RSS feed path.</p>
+<p>Example:</p>
+<p>link://rss =&gt; /blog/rss.xml</p>
+</dd>
+<dt>slug</dt>
+<dd><p>Return a link to a post with given slug, if not ambiguous.</p>
+<p>Example:</p>
+<p>link://slug/yellow-camaro =&gt; /posts/cars/awful/yellow-camaro/index.html</p>
+</dd>
+<dt>tag</dt>
+<dd><p>A link to a tag's page. Takes page number as optional keyword argument.</p>
+<p>Example:</p>
+<p>link://tag/cats =&gt; /tags/cats.html</p>
+</dd>
+<dt>tag_atom</dt>
+<dd><p>A link to a tag's Atom feed.</p>
+<p>Example:</p>
+<p>link://tag_atom/cats =&gt; /tags/cats.atom</p>
+</dd>
+<dt>tag_index</dt>
+<dd><p>A link to the tag index.</p>
+<p>Example:</p>
+<p>link://tag_index =&gt; /tags/index.html</p>
+</dd>
+<dt>tag_rss</dt>
+<dd><p>A link to a tag's RSS feed.</p>
+<p>Example:</p>
+<p>link://tag_rss/cats =&gt; /tags/cats.xml</p>
+</dd>
+</dl>

cache/pages/quickstart.html

@@ -0,0 +1,355 @@
+<dl class="docinfo simple">
+<dt class="author">Author<span class="colon">:</span></dt>
+<dd class="author"><p>Richard Jones</p></dd>
+<dt class="version">Version<span class="colon">:</span></dt>
+<dd class="version">5801</dd>
+<dt class="copyright">Copyright<span class="colon">:</span></dt>
+<dd class="copyright">This document has been placed in the public domain.</dd>
+</dl>
+<nav class="contents alert alert-info pull-left" id="contents" role="doc-toc">
+<p class="topic-title">Contents</p>
+<ul class="simple">
+<li><p><a class="reference internal" href="#structure" id="toc-entry-1">Structure</a></p></li>
+<li><p><a class="reference internal" href="#text-styles" id="toc-entry-2">Text styles</a></p></li>
+<li><p><a class="reference internal" href="#lists" id="toc-entry-3">Lists</a></p></li>
+<li><p><a class="reference internal" href="#preformatting-code-samples" id="toc-entry-4">Preformatting (code samples)</a></p></li>
+<li><p><a class="reference internal" href="#sections" id="toc-entry-5">Sections</a></p>
+<ul>
+<li><p><a class="reference internal" href="#document-title-subtitle" id="toc-entry-6">Document Title / Subtitle</a></p></li>
+</ul>
+</li>
+<li><p><a class="reference internal" href="#images" id="toc-entry-7">Images</a></p></li>
+<li><p><a class="reference internal" href="#what-next" id="toc-entry-8">What Next?</a></p></li>
+</ul>
+</nav>
+<p>The text below contains links that look like &quot;(<a class="reference external" href="../quickref/">quickref</a>)&quot;.  These
+are relative links that point to the <a class="reference external" href="../quickref/">Quick reStructuredText</a> user
+reference.  If these links don't work, please refer to the <a class="reference external" href="https://docutils.sourceforge.io/docs/user/rst/quickref.html">master
+quick reference</a> document.</p>
+<aside class="admonition note">
+<p class="admonition-title">Note</p>
+<p>This document is an informal introduction to
+reStructuredText.  The <a class="reference internal" href="#what-next">What Next?</a> section below has links to
+further resources, including a formal reference.</p>
+</aside>
+<section id="structure">
+<h1><a class="toc-backref" href="#toc-entry-1" role="doc-backlink">Structure</a></h1>
+<p>From the outset, let me say that &quot;Structured Text&quot; is probably a bit
+of a misnomer.  It's more like &quot;Relaxed Text&quot; that uses certain
+consistent patterns.  These patterns are interpreted by a HTML
+converter to produce &quot;Very Structured Text&quot; that can be used by a web
+browser.</p>
+<p>The most basic pattern recognised is a <strong>paragraph</strong> (<a class="reference external" href="../quickref/#paragraphs">quickref</a>).
+That's a chunk of text that is separated by blank lines (one is
+enough).  Paragraphs must have the same indentation -- that is, line
+up at their left edge.  Paragraphs that start indented will result in
+indented quote paragraphs. For example:</p>
+<pre class="literal-block">This is a paragraph.  It's quite
+short.
+
+   This paragraph will result in an indented block of
+   text, typically used for quoting other text.
+
+This is another one.</pre>
+<p>Results in:</p>
+<blockquote>
+<p>This is a paragraph.  It's quite
+short.</p>
+<blockquote>
+<p>This paragraph will result in an indented block of
+text, typically used for quoting other text.</p>
+</blockquote>
+<p>This is another one.</p>
+</blockquote>
+</section>
+<section id="text-styles">
+<h1><a class="toc-backref" href="#toc-entry-2" role="doc-backlink">Text styles</a></h1>
+<p>(<a class="reference external" href="../quickref/#inline-markup">quickref</a>)</p>
+<p>Inside paragraphs and other bodies of text, you may additionally mark
+text for <em>italics</em> with &quot;<code class="docutils literal">*italics*</code>&quot; or <strong>bold</strong> with
+&quot;<code class="docutils literal">**bold**</code>&quot;.  This is called &quot;inline markup&quot;.</p>
+<p>If you want something to appear as a fixed-space literal, use
+&quot;<code class="docutils literal">``double <span class="pre">back-quotes``</span></code>&quot;.  Note that no further fiddling is done
+inside the double back-quotes -- so asterisks &quot;<code class="docutils literal">*</code>&quot; etc. are left
+alone.</p>
+<p>If you find that you want to use one of the &quot;special&quot; characters in
+text, it will generally be OK -- reStructuredText is pretty smart.
+For example, this lone asterisk * is handled just fine, as is the
+asterisk in this equation: 5*6=30.  If you actually
+want text *surrounded by asterisks* to <strong>not</strong> be italicised, then
+you need to indicate that the asterisk is not special.  You do this by
+placing a backslash just before it, like so &quot;<code class="docutils literal">\*</code>&quot; (<a class="reference external" href="../quickref/#escaping">quickref</a>), or
+by enclosing it in double back-quotes (inline literals), like this:</p>
+<pre class="literal-block">``*``</pre>
+<aside class="admonition tip">
+<p class="admonition-title">Tip</p>
+<p>Think of inline markup as a form of (parentheses) and use it
+the same way: immediately before and after the text being marked
+up.  Inline markup by itself (surrounded by whitespace) or in the
+middle of a word won't be recognized.  See the <a class="reference external" href="https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#inline-markup">markup spec</a> for
+full details.</p>
+</aside>
+</section>
+<section id="lists">
+<h1><a class="toc-backref" href="#toc-entry-3" role="doc-backlink">Lists</a></h1>
+<p>Lists of items come in three main flavours: <strong>enumerated</strong>,
+<strong>bulleted</strong> and <strong>definitions</strong>.  In all list cases, you may have as
+many paragraphs, sublists, etc. as you want, as long as the left-hand
+side of the paragraph or whatever aligns with the first line of text
+in the list item.</p>
+<p>Lists must always start a new paragraph -- that is, they must appear
+after a blank line.</p>
+<dl>
+<dt><strong>enumerated</strong> lists (numbers, letters or roman numerals; <a class="reference external" href="../quickref/#enumerated-lists">quickref</a>)</dt>
+<dd><p>Start a line off with a number or letter followed by a period &quot;.&quot;,
+right bracket &quot;)&quot; or surrounded by brackets &quot;( )&quot; -- whatever you're
+comfortable with.  All of the following forms are recognised:</p>
+<pre class="literal-block">1. numbers
+
+A. upper-case letters
+   and it goes over many lines
+
+   with two paragraphs and all!
+
+a. lower-case letters
+
+   3. with a sub-list starting at a different number
+   4. make sure the numbers are in the correct sequence though!
+
+I. upper-case roman numerals
+
+i. lower-case roman numerals
+
+(1) numbers again
+
+1) and again</pre>
+<p>Results in (note: the different enumerated list styles are not
+always supported by every web browser, so you may not get the full
+effect here):</p>
+<ol class="arabic simple">
+<li><p>numbers</p></li>
+</ol>
+<ol class="upperalpha">
+<li><p>upper-case letters
+and it goes over many lines</p>
+<p>with two paragraphs and all!</p>
+</li>
+</ol>
+<ol class="loweralpha simple">
+<li><p>lower-case letters</p>
+<ol class="arabic simple" start="3">
+<li><p>with a sub-list starting at a different number</p></li>
+<li><p>make sure the numbers are in the correct sequence though!</p></li>
+</ol>
+</li>
+</ol>
+<ol class="upperroman simple">
+<li><p>upper-case roman numerals</p></li>
+</ol>
+<ol class="lowerroman simple">
+<li><p>lower-case roman numerals</p></li>
+</ol>
+<ol class="arabic simple">
+<li><p>numbers again</p></li>
+</ol>
+<ol class="arabic simple">
+<li><p>and again</p></li>
+</ol>
+</dd>
+<dt><strong>bulleted</strong> lists (<a class="reference external" href="../quickref/#bullet-lists">quickref</a>)</dt>
+<dd><p>Just like enumerated lists, start the line off with a bullet point
+character - either &quot;-&quot;, &quot;+&quot; or &quot;*&quot;:</p>
+<pre class="literal-block">* a bullet point using &quot;*&quot;
+
+  - a sub-list using &quot;-&quot;
+
+    + yet another sub-list
+
+  - another item</pre>
+<p>Results in:</p>
+<ul class="simple">
+<li><p>a bullet point using &quot;*&quot;</p>
+<ul>
+<li><p>a sub-list using &quot;-&quot;</p>
+<ul>
+<li><p>yet another sub-list</p></li>
+</ul>
+</li>
+<li><p>another item</p></li>
+</ul>
+</li>
+</ul>
+</dd>
+<dt><strong>definition</strong> lists (<a class="reference external" href="../quickref/#definition-lists">quickref</a>)</dt>
+<dd><p>Unlike the other two, the definition lists consist of a term, and
+the definition of that term.  The format of a definition list is:</p>
+<pre class="literal-block">what
+  Definition lists associate a term with a definition.
+
+*how*
+  The term is a one-line phrase, and the definition is one or more
+  paragraphs or body elements, indented relative to the term.
+  Blank lines are not allowed between term and definition.</pre>
+<p>Results in:</p>
+<dl class="simple">
+<dt>what</dt>
+<dd><p>Definition lists associate a term with a definition.</p>
+</dd>
+<dt><em>how</em></dt>
+<dd><p>The term is a one-line phrase, and the definition is one or more
+paragraphs or body elements, indented relative to the term.
+Blank lines are not allowed between term and definition.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+</section>
+<section id="preformatting-code-samples">
+<h1><a class="toc-backref" href="#toc-entry-4" role="doc-backlink">Preformatting (code samples)</a></h1>
+<p>(<a class="reference external" href="../quickref/#literal-blocks">quickref</a>)</p>
+<p>To just include a chunk of preformatted, never-to-be-fiddled-with
+text, finish the prior paragraph with &quot;<code class="docutils literal">::</code>&quot;.  The preformatted
+block is finished when the text falls back to the same indentation
+level as a paragraph prior to the preformatted block.  For example:</p>
+<pre class="literal-block">An example::
+
+    Whitespace, newlines, blank lines, and all kinds of markup
+      (like *this* or \this) is preserved by literal blocks.
+  Lookie here, I've dropped an indentation level
+  (but not far enough)
+
+no more example</pre>
+<p>Results in:</p>
+<blockquote>
+<p>An example:</p>
+<pre class="literal-block">  Whitespace, newlines, blank lines, and all kinds of markup
+    (like *this* or \this) is preserved by literal blocks.
+Lookie here, I've dropped an indentation level
+(but not far enough)</pre>
+<p>no more example</p>
+</blockquote>
+<p>Note that if a paragraph consists only of &quot;<code class="docutils literal">::</code>&quot;, then it's removed
+from the output:</p>
+<pre class="literal-block">::
+
+    This is preformatted text, and the
+    last &quot;::&quot; paragraph is removed</pre>
+<p>Results in:</p>
+<pre class="literal-block">This is preformatted text, and the
+last &quot;::&quot; paragraph is removed</pre>
+</section>
+<section id="sections">
+<h1><a class="toc-backref" href="#toc-entry-5" role="doc-backlink">Sections</a></h1>
+<p>(<a class="reference external" href="../quickref/#section-structure">quickref</a>)</p>
+<p>To break longer text up into sections, you use <strong>section headers</strong>.
+These are a single line of text (one or more words) with adornment: an
+underline alone, or an underline and an overline together, in dashes
+&quot;<code class="docutils literal"><span class="pre">-----</span></code>&quot;, equals &quot;<code class="docutils literal"><span class="pre">======</span></code>&quot;, tildes &quot;<code class="docutils literal"><span class="pre">~~~~~~</span></code>&quot; or any of the
+non-alphanumeric characters <code class="docutils literal">= - ` : ' &quot; ~ ^ _ * + # &lt; &gt;</code> that you
+feel comfortable with.  An underline-only adornment is distinct from
+an overline-and-underline adornment using the same character.  The
+underline/overline must be at least as long as the title text.  Be
+consistent, since all sections marked with the same adornment style
+are deemed to be at the same level:</p>
+<pre class="literal-block">Chapter 1 Title
+===============
+
+Section 1.1 Title
+-----------------
+
+Subsection 1.1.1 Title
+~~~~~~~~~~~~~~~~~~~~~~
+
+Section 1.2 Title
+-----------------
+
+Chapter 2 Title
+===============</pre>
+<p>This results in the following structure, illustrated by simplified
+pseudo-XML:</p>
+<pre class="literal-block">&lt;section&gt;
+    &lt;title&gt;
+        Chapter 1 Title
+    &lt;section&gt;
+        &lt;title&gt;
+            Section 1.1 Title
+        &lt;section&gt;
+            &lt;title&gt;
+                Subsection 1.1.1 Title
+    &lt;section&gt;
+        &lt;title&gt;
+            Section 1.2 Title
+&lt;section&gt;
+    &lt;title&gt;
+        Chapter 2 Title</pre>
+<p>(Pseudo-XML uses indentation for nesting and has no end-tags.  It's
+not possible to show actual processed output, as in the other
+examples, because sections cannot exist inside block quotes.  For a
+concrete example, compare the section structure of this document's
+source text and processed output.)</p>
+<p>Note that section headers are available as link targets, just using
+their name.  To link to the <a class="reference internal" href="#lists">Lists</a> heading, I write &quot;<code class="docutils literal">Lists_</code>&quot;.  If
+the heading has a space in it like <a class="reference internal" href="#text-styles">text styles</a>, we need to quote
+the heading &quot;<code class="docutils literal">`text styles`_</code>&quot;.</p>
+<section id="document-title-subtitle">
+<h2><a class="toc-backref" href="#toc-entry-6" role="doc-backlink">Document Title / Subtitle</a></h2>
+<p>The title of the whole document is distinct from section titles and
+may be formatted somewhat differently (e.g. the HTML writer by default
+shows it as a centered heading).</p>
+<p>To indicate the document title in reStructuredText, use a unique adornment
+style at the beginning of the document.  To indicate the document subtitle,
+use another unique adornment style immediately after the document title.  For
+example:</p>
+<pre class="literal-block">================
+ Document Title
+================
+----------
+ Subtitle
+----------
+
+Section Title
+=============
+
+...</pre>
+<p>Note that &quot;Document Title&quot; and &quot;Section Title&quot; above both use equals
+signs, but are distinct and unrelated styles.  The text of
+overline-and-underlined titles (but not underlined-only) may be inset
+for aesthetics.</p>
+</section>
+</section>
+<section id="images">
+<h1><a class="toc-backref" href="#toc-entry-7" role="doc-backlink">Images</a></h1>
+<p>(<a class="reference external" href="../quickref/#directives">quickref</a>)</p>
+<p>To include an image in your document, you use the <code class="docutils literal">image</code> <a class="reference external" href="https://docutils.sourceforge.io/docs/ref/rst/directives.html">directive</a>.
+For example:</p>
+<pre class="literal-block">.. image:: /images/nikola.png</pre>
+<p>results in:</p>
+<img alt="/images/nikola.png" src="/images/nikola.png" />
+<p>The <code class="docutils literal">/images/nikola.png</code> part indicates the filename of the image
+you wish to appear in the document. There's no restriction placed on
+the image (format, size etc).  If the image is to appear in HTML and
+you wish to supply additional information, you may:</p>
+<pre class="literal-block">.. image:: /images/nikola.png
+   :height: 100
+   :width: 200
+   :scale: 50
+   :alt: alternate text</pre>
+<p>See the full <a class="reference external" href="https://docutils.sourceforge.io/docs/ref/rst/directives.html#images">image directive documentation</a> for more info.</p>
+</section>
+<section id="what-next">
+<h1><a class="toc-backref" href="#toc-entry-8" role="doc-backlink">What Next?</a></h1>
+<p>This primer introduces the most common features of reStructuredText,
+but there are a lot more to explore.  The <a class="reference external" href="../quickref/">Quick reStructuredText</a>
+user reference is a good place to go next.  For complete details, the
+<a class="reference external" href="https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html">reStructuredText Markup Specification</a> is the place to go <a class="footnote-reference brackets" href="#footnote-1" id="footnote-reference-1" role="doc-noteref"><span class="fn-bracket">[</span>1<span class="fn-bracket">]</span></a>.</p>
+<p>Users who have questions or need assistance with Docutils or
+reStructuredText should post a message to the <a class="reference external" href="https://docutils.sourceforge.io/docs/user/mailing-lists.html#docutils-users">Docutils-users</a> mailing
+list.</p>
+<aside class="footnote-list brackets">
+<aside class="footnote brackets" id="footnote-1" role="note">
+<span class="label"><span class="fn-bracket">[</span><a role="doc-backlink" href="#footnote-reference-1">1</a><span class="fn-bracket">]</span></span>
+<p>If that relative link doesn't work, try the master document:
+<a class="reference external" href="https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html">https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html</a>.</p>
+</aside>
+</aside>
+</section>

cache/pages/social_buttons.html

@@ -0,0 +1,162 @@
+<dl class="docinfo simple">
+<dt class="version">Version<span class="colon">:</span></dt>
+<dd class="version">8.2.3</dd>
+</dl>
+<nav class="contents alert alert-primary float-md-right" id="contents" role="doc-toc">
+<p class="topic-title">Contents</p>
+<ul class="simple">
+<li><p><a class="reference internal" href="#the-default" id="toc-entry-1">The Default</a></p></li>
+<li><p><a class="reference internal" href="#sharenice" id="toc-entry-2">ShareNice</a></p></li>
+<li><p><a class="reference internal" href="#socialshareprivacy" id="toc-entry-3">SocialSharePrivacy</a></p>
+<ul>
+<li><p><a class="reference internal" href="#the-hard-way" id="toc-entry-4">The Hard Way</a></p></li>
+<li><p><a class="reference internal" href="#the-easy-way" id="toc-entry-5">The Easy Way</a></p></li>
+</ul>
+</li>
+</ul>
+</nav>
+<section id="the-default">
+<h1><a class="toc-backref" href="#toc-entry-1" role="doc-backlink">The Default</a></h1>
+<p>By Default, the themes provided with Nikola will add to your pages a &quot;slide in&quot; widget at
+the bottom right of the page, provided by Addthis. This is the HTML code for that:</p>
+<pre class="code html"><a name="rest_code_fdbd4b2582b34ec78f82fe9fab67f0d6-1"></a><span class="c">&lt;!-- Social buttons --&gt;</span>
+<a name="rest_code_fdbd4b2582b34ec78f82fe9fab67f0d6-2"></a><span class="p">&lt;</span><span class="nt">div</span> <span class="na">id</span><span class="o">=</span><span class="s">&quot;addthisbox&quot;</span> <span class="na">class</span><span class="o">=</span><span class="s">&quot;addthis_toolbox addthis_peekaboo_style</span>
+<a name="rest_code_fdbd4b2582b34ec78f82fe9fab67f0d6-3"></a><span class="s">    addthis_default_style addthis_label_style addthis_32x32_style&quot;</span><span class="p">&gt;</span>
+<a name="rest_code_fdbd4b2582b34ec78f82fe9fab67f0d6-4"></a><span class="p">&lt;</span><span class="nt">a</span> <span class="na">class</span><span class="o">=</span><span class="s">&quot;addthis_button_more&quot;</span><span class="p">&gt;</span>Share<span class="p">&lt;/</span><span class="nt">a</span><span class="p">&gt;</span>
+<a name="rest_code_fdbd4b2582b34ec78f82fe9fab67f0d6-5"></a><span class="p">&lt;</span><span class="nt">ul</span><span class="p">&gt;&lt;</span><span class="nt">li</span><span class="p">&gt;&lt;</span><span class="nt">a</span> <span class="na">class</span><span class="o">=</span><span class="s">&quot;addthis_button_facebook&quot;</span><span class="p">&gt;&lt;/</span><span class="nt">a</span><span class="p">&gt;</span>
+<a name="rest_code_fdbd4b2582b34ec78f82fe9fab67f0d6-6"></a><span class="p">&lt;</span><span class="nt">li</span><span class="p">&gt;&lt;</span><span class="nt">a</span> <span class="na">class</span><span class="o">=</span><span class="s">&quot;addthis_button_google_plusone_share&quot;</span><span class="p">&gt;&lt;/</span><span class="nt">a</span><span class="p">&gt;</span>
+<a name="rest_code_fdbd4b2582b34ec78f82fe9fab67f0d6-7"></a><span class="p">&lt;</span><span class="nt">li</span><span class="p">&gt;&lt;</span><span class="nt">a</span> <span class="na">class</span><span class="o">=</span><span class="s">&quot;addthis_button_linkedin&quot;</span><span class="p">&gt;&lt;/</span><span class="nt">a</span><span class="p">&gt;</span>
+<a name="rest_code_fdbd4b2582b34ec78f82fe9fab67f0d6-8"></a><span class="p">&lt;</span><span class="nt">li</span><span class="p">&gt;&lt;</span><span class="nt">a</span> <span class="na">class</span><span class="o">=</span><span class="s">&quot;addthis_button_twitter&quot;</span><span class="p">&gt;&lt;/</span><span class="nt">a</span><span class="p">&gt;</span>
+<a name="rest_code_fdbd4b2582b34ec78f82fe9fab67f0d6-9"></a><span class="p">&lt;/</span><span class="nt">ul</span><span class="p">&gt;</span>
+<a name="rest_code_fdbd4b2582b34ec78f82fe9fab67f0d6-10"></a><span class="p">&lt;/</span><span class="nt">div</span><span class="p">&gt;</span>
+<a name="rest_code_fdbd4b2582b34ec78f82fe9fab67f0d6-11"></a><span class="p">&lt;</span><span class="nt">script</span> <span class="na">src</span><span class="o">=</span><span class="s">&quot;//s7.addthis.com/js/300/addthis_widget.js#pubid=ra-4f7088a56bb93798&quot;</span><span class="p">&gt;&lt;/</span><span class="nt">script</span><span class="p">&gt;</span>
+<a name="rest_code_fdbd4b2582b34ec78f82fe9fab67f0d6-12"></a><span class="c">&lt;!-- End of social buttons --&gt;</span>
+<a name="rest_code_fdbd4b2582b34ec78f82fe9fab67f0d6-13"></a>&quot;&quot;&quot;
+</pre><p>You can change that using the <code class="docutils literal">SOCIAL_BUTTONS_CODE</code> option in your conf.py. In some cases, just
+doing that will be enough but in others, it won't. This document tries to describe all the bits
+involved in making this work correctly.</p>
+<dl>
+<dt>Part 1: <code class="docutils literal">SOCIAL_BUTTONS_CODE</code></dt>
+<dd><p>Social sharing services like addthis and others will provide you a HTML snippet.
+If it is self-contained, then just setting <code class="docutils literal">SOCIAL_BUTTONS_CODE</code> may be enough.
+Try :-)</p>
+</dd>
+<dt>Part 2: The theme</dt>
+<dd><p>The <code class="docutils literal">SOCIAL_BUTTONS_CODE</code> HTML fragment will be embedded <em>somewhere</em> by the theme. Whether that
+is the correct place or not is not something the theme author can truly know, so it is possible that
+you may have to tweak the <code class="docutils literal">base.html</code> template to make it look good.</p>
+</dd>
+<dt>Part 3: <code class="docutils literal">BODY_END</code> and <code class="docutils literal">EXTRA_HEAD_DATA</code></dt>
+<dd><p>Some social sharing code requires JS execution that depends on JQuery being available
+(example: <a class="reference external" href="https://github.com/panzi/SocialSharePrivacy">SocialSharePrivacy</a>). It's good
+practice (and often, the only way that will work) to put those at the end of <code class="docutils literal">&lt;BODY&gt;</code>,
+and one easy way to do that is to put them in <code class="docutils literal">BODY_END</code></p>
+<p>On the other hand, it's possible that it requires you to load some CSS files.
+The right place for that is in the document's <code class="docutils literal">&lt;HEAD&gt;</code> so they should be added
+in <code class="docutils literal">EXTRA_HEAD_DATA</code></p>
+</dd>
+<dt>Part 4: assets</dt>
+<dd><p>For sharing code that doesn't rely on a social sharing service, you may need to add CSS, Image, or JS
+files to your site</p>
+</dd>
+</dl>
+</section>
+<section id="sharenice">
+<h1><a class="toc-backref" href="#toc-entry-2" role="doc-backlink">ShareNice</a></h1>
+<p><a class="reference external" href="https://graingert.co.uk/shareNice/">ShareNice</a> is &quot;written in order to provide social sharing features to
+web developers and website administrators who wish to maintain and protect their users' privacy&quot;
+which sounds cool to me.</p>
+<p>Let's go step by step into integrating the hosted version of ShareNice into a Nikola site.</p>
+<p>For testing purposes, let's do it on a demo site:</p>
+<pre class="literal-block">$ nikola init --demo sharenice_test
+A new site with example data has been created at sharenice_test.
+See README.txt in that folder for more information.
+$ cd sharenice_test/</pre>
+<p>To see what's going on, let's start Nikola in &quot;auto mode&quot;. This should build the
+site and open a web browser showing the default configuration, with the AddThis widget:</p>
+<pre class="literal-block">$ nikola auto -b</pre>
+<p>First, let's add the HTML snippet that will show the sharing options. In your conf.py, set this, which
+is the HTML code suggested by ShareNice:</p>
+<pre class="code python"><a name="rest_code_d45bd5e47f254bfeb9aa565ed399def8-1"></a><span class="n">SOCIAL_BUTTONS_CODE</span> <span class="o">=</span> <span class="s2">&quot;&quot;&quot;&lt;div id=&quot;shareNice&quot; data-share-label=&quot;Share&quot;</span>
+<a name="rest_code_d45bd5e47f254bfeb9aa565ed399def8-2"></a><span class="s2">    data-color-scheme=&quot;black&quot; data-icon-size=&quot;32&quot; data-panel-bottom=&quot;plain&quot;</span>
+<a name="rest_code_d45bd5e47f254bfeb9aa565ed399def8-3"></a><span class="s2">    data-services=&quot;plus.google.com,facebook.com,digg.com,email,delicious.com,twitter.com&quot;</span>
+<a name="rest_code_d45bd5e47f254bfeb9aa565ed399def8-4"></a><span class="s2">    style=&quot;float:right&quot;&gt;&lt;/div&gt;&quot;&quot;&quot;</span>
+<a name="rest_code_d45bd5e47f254bfeb9aa565ed399def8-5"></a>
+<a name="rest_code_d45bd5e47f254bfeb9aa565ed399def8-6"></a><span class="n">BODY_END</span> <span class="o">=</span> <span class="s2">&quot;&quot;&quot;&lt;script src=&quot;https://graingert.co.uk/shareNice/code.js&quot;&gt;&lt;/script&gt;&quot;&quot;&quot;</span>
+</pre><p>And you should now see a sharing box at the bottom right of the page.</p>
+<p>Main problem remaining is that it doesn't really look good and integrated in the page layout.
+I suggest changing the code to this which looks nicer, but still has some placement issues:</p>
+<pre class="code python"><a name="rest_code_b749fc146e7e47cc8686e5aaf4c038f1-1"></a><span class="n">SOCIAL_BUTTONS_CODE</span> <span class="o">=</span> <span class="s2">&quot;&quot;&quot;&lt;div id=&quot;shareNice&quot; data-share-label=&quot;Share&quot;</span>
+<a name="rest_code_b749fc146e7e47cc8686e5aaf4c038f1-2"></a><span class="s2">    data-color-scheme=&quot;black&quot; data-icon-size=&quot;32&quot; data-panel-bottom=&quot;plain&quot;</span>
+<a name="rest_code_b749fc146e7e47cc8686e5aaf4c038f1-3"></a><span class="s2">    data-services=&quot;plus.google.com,facebook.com,email,twitter.com&quot;</span>
+<a name="rest_code_b749fc146e7e47cc8686e5aaf4c038f1-4"></a><span class="s2">    style=&quot;position: absolute; left: 20px; top: 60px;&quot;&gt;&lt;/div&gt;&quot;&quot;&quot;</span>
+</pre><p>If anyone comes up with a better idea of styling/placement, just let me know ;-)</p>
+<p>One bad bit of this so far is that you are now using a script from another site, and that
+doesn't let Nikola perform as many optimizations to your page as it could.
+So, if you really want to go the extra mile to save a few KB and round trips, you <em>could</em>
+install your own copy from the <a class="reference external" href="https://github.com/mischat/shareNice">github repo</a> and
+use that instead of the copy at <a class="reference external" href="https://graingert.co.uk/shareNice">ShareNice</a>.</p>
+<p>Then, you can create your own theme inheriting from the one you are using and add the CSS
+and JS files from ShareNice into your <code class="docutils literal">bundles</code> configuration so they are combined and
+minified.</p>
+</section>
+<section id="socialshareprivacy">
+<h1><a class="toc-backref" href="#toc-entry-3" role="doc-backlink">SocialSharePrivacy</a></h1>
+<section id="the-hard-way">
+<h2><a class="toc-backref" href="#toc-entry-4" role="doc-backlink">The Hard Way</a></h2>
+<p><a class="reference external" href="https://github.com/panzi/SocialSharePrivacy">SocialSharePrivacy</a> is &quot;a jQuery plugin that
+lets you add social share buttons to your website that don't allow the social sites to track
+your users.&quot; Nice!</p>
+<p>Let's go step-by-step into integrating SocialSharePrivacy into a Nikola site. To improve
+privacy, they recommend you not use the hosted service so we'll do it the hard way, by
+getting and distributing everything in our own site.</p>
+<p><a class="reference external" href="https://github.com/panzi/SocialSharePrivacy">https://github.com/panzi/SocialSharePrivacy</a></p>
+<p>For testing purposes, let's do it on a demo site:</p>
+<pre class="literal-block">$ nikola init --demo ssp_test
+A new site with example data has been created at ssp_test.
+See README.txt in that folder for more information.
+$ cd ssp_test/</pre>
+<p>To see what's going on, let's start Nikola in &quot;auto mode&quot;. This should build the
+site and open a web browser showing the default configuration, with the AddThis widget:</p>
+<pre class="literal-block">$ nikola auto -b</pre>
+<p>Now, download <a class="reference external" href="https://github.com/panzi/SocialSharePrivacy/archive/master.zip">the current version</a>
+and unzip it. You will have a <code class="docutils literal"><span class="pre">SocialSharePrivacy-master</span></code> folder with lots of stuff in it.</p>
+<p>First, we need to build it (this requires a working and modern uglifyjs, this may not be easy):</p>
+<pre class="literal-block">$ cd SocialSharePrivacy-master
+$ sh build.sh -m gplus,twitter,facebook,mail -s &quot;/assets/css/socialshareprivacy.css&quot; -a off</pre>
+<p>You will now have several files in a <code class="docutils literal">build</code> folder. We need to bring them into the site:</p>
+<pre class="literal-block">$ cp -Rv SocialSharePrivacy-master/build/* files/
+$ cp -R SocialSharePrivacy-master/images/ files/assets/</pre>
+<p>Edit your <code class="docutils literal">conf.py</code>:</p>
+<pre class="code python"><a name="rest_code_65b770dc716e498eb31cf1abee0d274c-1"></a><span class="n">BODY_END</span> <span class="o">=</span> <span class="s2">&quot;&quot;&quot;</span>
+<a name="rest_code_65b770dc716e498eb31cf1abee0d274c-2"></a><span class="s2">&lt;script src=&quot;/javascripts/jquery.socialshareprivacy.min.js&quot;&gt;&lt;/script&gt;</span>
+<a name="rest_code_65b770dc716e498eb31cf1abee0d274c-3"></a><span class="s2">&lt;script&gt;</span>
+<a name="rest_code_65b770dc716e498eb31cf1abee0d274c-4"></a><span class="s2">$(document).ready(function () {</span>
+<a name="rest_code_65b770dc716e498eb31cf1abee0d274c-5"></a><span class="s2">    $(&#39;.share&#39;).socialSharePrivacy();</span>
+<a name="rest_code_65b770dc716e498eb31cf1abee0d274c-6"></a><span class="s2">});</span>
+<a name="rest_code_65b770dc716e498eb31cf1abee0d274c-7"></a><span class="s2">&lt;/script&gt;</span>
+<a name="rest_code_65b770dc716e498eb31cf1abee0d274c-8"></a><span class="s2">&quot;&quot;&quot;</span>
+<a name="rest_code_65b770dc716e498eb31cf1abee0d274c-9"></a>
+<a name="rest_code_65b770dc716e498eb31cf1abee0d274c-10"></a><span class="n">SOCIAL_BUTTONS_CODE</span> <span class="o">=</span> <span class="s2">&quot;&quot;&quot;&lt;div class=&quot;share&quot;&gt;&lt;/div&gt;&quot;&quot;&quot;</span>
+</pre><p>In my experience this produces a broken, duplicate, semi-working thing. YMMV and if you make it work correctly, let me know how :-)</p>
+</section>
+<section id="the-easy-way">
+<h2><a class="toc-backref" href="#toc-entry-5" role="doc-backlink">The Easy Way</a></h2>
+<p>Go to <a class="reference external" href="https://panzi.github.io/SocialSharePrivacy/">https://panzi.github.io/SocialSharePrivacy/</a> and use the provided form to get the code. Make sure you check &quot;I already use JQuery&quot;
+if you are using one of the themes that require it, like site or default, select the services you want, and use your disqus name if
+you have one.</p>
+<p>It will give you 3 code snippets:</p>
+<dl class="simple">
+<dt>&quot;Insert this once in the head of your page&quot;</dt>
+<dd><p>Put it in <code class="docutils literal">BODY_END</code></p>
+</dd>
+<dt>&quot;Insert this wherever you want a share widget displayed&quot;</dt>
+<dd><p>Put it in <code class="docutils literal">SOCIAL_BUTTONS_CODE</code></p>
+</dd>
+<dt>&quot;Insert this once anywhere after the other code&quot;</dt>
+<dd><p>Put it in <code class="docutils literal">BODY_END</code></p>
+</dd>
+</dl>
+<p>That should give you a working integration (not tested)</p>
+</section>
+</section>

cache/posts/1.html

@@ -0,0 +1,14 @@
+<figure>
+<a class="reference external image-reference" href="https://farm1.staticflickr.com/138/352972944_4f9d568680_z.jpg?zz=1"><img alt="Nikola Tesla Corner by nicwest, on Flickr" class="thumbnail" src="https://farm1.staticflickr.com/138/352972944_4f9d568680.jpg" /></a>
+</figure>
+<p>If you can see this in a web browser, it means you managed to install Nikola,
+and build a site using it. Congratulations!</p>
+<p>Next steps:</p>
+<ul class="simple">
+<li><p><a class="reference external" href="/pages/handbook.html">Read the manual</a></p></li>
+<li><p><a class="reference external" href="https://getnikola.com">Visit the Nikola website to learn more</a></p></li>
+<li><p><a class="reference external" href="link://gallery/demo">See a demo photo gallery</a></p></li>
+<li><p><a class="reference external" href="/pages/listings-demo.html">See a demo listing</a></p></li>
+<li><p><a class="reference external" href="/pages/dr-nikolas-vendetta.html">See a demo of a longer text</a></p></li>
+</ul>
+<p>Send feedback to <a class="reference external" href="mailto:info&#64;getnikola.com">info&#64;getnikola.com</a>!</p>

files/refresh.js

@@ -0,0 +1,63 @@
+
+
+
+var seconds = 1;
+var divid = "shoutcastdiv";
+var url = "test.txt";
+
+////////////////////////////////
+//
+// Refreshing the DIV
+//
+////////////////////////////////
+
+function refreshdiv(){
+
+// The XMLHttpRequest object
+
+var xmlHttp;
+try{
+xmlHttp=new XMLHttpRequest(); // Firefox, Opera 8.0+, Safari
+}
+catch (e){
+try{
+xmlHttp=new ActiveXObject("Msxml2.XMLHTTP"); // Internet Explorer
+}
+catch (e){
+try{
+xmlHttp=new ActiveXObject("Microsoft.XMLHTTP");
+}
+catch (e){
+alert("Your browser does not support AJAX.");
+return false;
+}
+}
+}
+
+// Timestamp for preventing IE caching the GET request
+
+fetch_unix_timestamp = function()
+{
+return parseInt(new Date().getTime().toString().substring(0, 10))
+}
+
+var timestamp = fetch_unix_timestamp();
+var nocacheurl = url+"?t="+timestamp;
+
+// The code...
+
+xmlHttp.onreadystatechange=function(){
+if(xmlHttp.readyState==4){
+document.getElementById(divid).innerHTML=xmlHttp.responseText;
+setTimeout('refreshdiv()',seconds*1000);
+}
+}
+xmlHttp.open("GET",url,true);
+xmlHttp.send(null);
+}
+
+// Start the refreshing process
+
+window.onload = function startrefresh(){
+setTimeout('refreshdiv()',seconds*1000);
+}

files/refresh.js~

@@ -0,0 +1,60 @@
+var seconds = 10;
+var divid = "shoutcastdiv";
+var url = "/shoutcastajax/shoutcast_song_title.php";
+
+////////////////////////////////
+//
+// Refreshing the DIV
+//
+////////////////////////////////
+
+function refreshdiv(){
+
+// The XMLHttpRequest object
+
+var xmlHttp;
+try{
+xmlHttp=new XMLHttpRequest(); // Firefox, Opera 8.0+, Safari
+}
+catch (e){
+try{
+xmlHttp=new ActiveXObject("Msxml2.XMLHTTP"); // Internet Explorer
+}
+catch (e){
+try{
+xmlHttp=new ActiveXObject("Microsoft.XMLHTTP");
+}
+catch (e){
+alert("Your browser does not support AJAX.");
+return false;
+}
+}
+}
+
+// Timestamp for preventing IE caching the GET request
+
+fetch_unix_timestamp = function()
+{
+return parseInt(new Date().getTime().toString().substring(0, 10))
+}
+
+var timestamp = fetch_unix_timestamp();
+var nocacheurl = url+"?t="+timestamp;
+
+// The code...
+
+xmlHttp.onreadystatechange=function(){
+if(xmlHttp.readyState==4){
+document.getElementById(divid).innerHTML=xmlHttp.responseText;
+setTimeout('refreshdiv()',seconds*1000);
+}
+}
+xmlHttp.open("GET",nocacheurl,true);
+xmlHttp.send(null);
+}
+
+// Start the refreshing process
+
+window.onload = function startrefresh(){
+setTimeout('refreshdiv()',seconds*1000);
+}

files/test.txt

@@ -0,0 +1 @@
+Salut!

galleries/demo/exclude.meta

@@ -0,0 +1 @@
+tesla2_lg.jpg

galleries/demo/index.txt

@@ -0,0 +1,4 @@
+.. title: Nikola Tesla
+
+Some public domain pictures of Nikola Tesla
+(copied from `here <https://kerryr.net/pioneers/gallery/tesla.htm>`_)

galleries/demo/metadata.sample.yml

@@ -0,0 +1,13 @@
+---
+name: tesla_tower1_lg.jpg
+caption: Wardenclyffe Tower
+built_in: 1904
+order: 2
+---
+name: tesla4_lg.jpg
+order: 0
+---
+name: tesla_conducts_lg.jpg
+caption: Nikola Tesla conducts electricity
+order: 1
+---