Migrating

From parasite ≤ 0.1, and its run.py.

parasite ≤ 0.1 (the package parasite, now para) was configured by a site’s run.py, a subclass of its Config. Every part of it has a place in parasite.toml:

run.py parasite.toml
site_url, blog_email, logo_url, default_lang, timezone [site] url, email, logo, lang, timezone
blog_title, blog_author, blog_description [site] title, author, description (a string, or a table by language)
copyright [site] copyright, with {years} and {author}
n_jumbotron, n_grid, index_include_jumbotron [listing] jumbotron, grid, include-jumbotron
write_rss, write_atom, write_sitemap, write_graph [feeds], [sitemap], [graph]
write_tipuesearch_json [search] (Pagefind; para.site makes the search page)
mathjax_config [mathjax], as a table
files_folders [files] (copied whole) and [media.folders] (copied by reference)
posts, pages [[sources]], with listed = true for posts
pretty_urls a profile’s url
pandoc_input_options(ext) [read] options, [read.EXT] options
panflute_input_filters(ext) [filters.NAME], with inputs
pandoc_output_options, panflute_output_filters, css, js, header_includes, include_before, include_after, script_include_after, nav_includes, content_footer, search_form (by extension) a profile’s options, filters, css, js, header-includes, include-before, include-after, script-include-after, nav, footer, search-form

The makefile then runs parasite instead of ./run.py.

Front matter

See front matter for the keys parasite ≤ 0.1 used and what replaces them. A teaser (<!-- more -->) becomes the description; tabs after a key’s colon, which pandoc accepts and PyYAML does not, become spaces.

A page and its slides

A talk kept as X.md (the page) and X.markdown (the slides) becomes one source with format: [html, slides], what only one of them had in .content-visible divs (see output profiles), and the slides’ own metadata under format: slides: metadata:.

Search

The search page (pages/search.md, and tipuesearch’s scripts) goes: para.site makes it.