----- Date:

Announcing: SNafuHall!

Waffled for several months over wether to embrace the nettle of publishing, again. Then Rhe needed a simple splash page site for http://showerdash.com and I had to look at how to do that.

Some exploration led to Pelican which has led (after some time spent whacking at it), to this site.

Links I have found useful:

Pelican plugins #

Markdown plugins #

STOCK:

my own local of:

Configuring Pelican Markdown Extensions #

This took me a bit to figure out. You instantate the extension and insert it into pelican's MARKDOWN config variable. Here's how I'm doing it:

# import markdown extensions from local directory
import markdowninclude, cell_row_span, mdx_custom_span_class
import mdx_superscript, mdx_del_ins
import mdx_urlize


# markdown extensions
md_markdown_include = markdowninclude.MarkdownInclude(
    configs={'base_path':'content/inc/', 'encoding': 'utf-8', 'headingOffset': '1', 'inheritHeadingDepth': True, }
    )

md_cellrow = cell_row_span.CellRowSpanExtension()
md_spanclass = mdx_custom_span_class.CustomSpanClassExtension()

md_urlize = mdx_urlize.UrlizeExtension()
md_super = mdx_superscript.SuperscriptExtension()
md_di = mdx_del_ins.DelInsExtension()


# Markdown extensions
MARKDOWN = {
    'extension_configs': {
        'markdown.extensions.extra': {},
        'markdown.extensions.meta': {},
        'markdown.extensions.abbr': {},
        'markdown.extensions.sane_lists': {},
        'markdown.extensions.tables': {},
        'markdown.extensions.footnotes': {},
        'markdown.extensions.wikilinks': {'base_url':'/', 'end_url':'', 'html_class':'wikilink'},
        md_cellrow: {},
        md_spanclass: {},
        md_markdown_include: {},
        md_urlize: {},
        md_di: {},
        md_super: {},
        'markdown.extensions.codehilite': {'css_class': 'highlight', 'guess_lang':False, },
        'markdown.extensions.toc':{'title':'Contents','permalink':' #','toc_depth':"1-4",'anchorlink':False,},

    },
    'output_format': 'html5',
    'tab_length': 4,
}