doc: improve docs about the include directive.

css: updated postprocessed CSS files.

css: overlap page cover and content a bit.

So the transition is not so clearly visible.

css: fix text alignment once more.

css: make text alignment work properly in <th> elements.

Support for colored terminal output highlighting.

m.code: patch the builtin include directive for our code support.

Uglyyyy.

css: all <pre> tags should be treated equally for inflating.

css: copypaste error.

But a harmless one, as the default color is the, um, default color
anyway. In the builtin themes, at least.

m.htmlsanity: properly use DEFAULT_LANG and :lang: metadata.

There's a patch to Pelican at https://github.com/getpelican/pelican/pull/2256
which propagates DEFAULT_LANG to docutils, but until that's accepted
and released, I'm detecting its presence and falling back to
monkey-patched version that enables the same from within the
m.htmlsanity plugin.

Besides that, the per-page/per-article :lang: metadata are also taken
into account. The docs were updated to reflect this.

m.htmlsanity: use double quotes for text.

m.htmlsanity: don't fail so hard if Pyphen is not available.

doc: this won't work if the path does not exist yet.

Minor README updates.

dox: fix latex2svg.py path.

css: update the compiled CSS files.

doc: use native reST anchors.

css: code blocks are now darker instead of lighter.

I like it better now. Also a few other related fixes. Thanks to
@Squareys for the idea!

css: ability to disable the hover effect on tables.

css: new Badge component.

css: new Label component.

doc: push for better semantics of notes and blocks.

css: hint that two-column navbar should have successive numbering.

And apply that to the theme as well.

css: make it possible to add a thinner subtitle to navbar brand.

css: set the hamburger glyph in top navbar from CSS.

Instead of hardcoding it from the markup. This way when the CSS is not
present at all (broken site), the user is not present with confusing
hamburgers on the top.

Important: unless you are using the builtin Pelican theme, you need to
update your markup to remove the hamburger glyph, otherwise you'll have
two of them there.

doc: improve the Writing Content section with more info and links.

m.htmlsanity: apply hyphenation to everything in FORMATTED_FIELDS.

Instead of just the summary. Makes more sense.

theme: better behaving category/author/tag list on jumbo articles.

template: deduplicate article footer markup.

m.htmlsanity: use a single global variable to save settings.

css: make figure work with lengthy caption or large images.

Previously lengthy caption or description was extending beyond image
instead of being wrapped. Also large images didn't stop at 100% width,
leaking out of the page.

site: sane date formatting.

site: fix publication.

Better credits for latex2svg.

Sorry!

doc: document the author list in Page Layout section as well.

Revert "css: better behaving background on short pages."

Breaks figure and code figure borders, because they have z-index se to
-1, which causes them to get hidden behind the body background. Not sure
how to solve that better for now, so I'm just reverting to the lesser of
the two evils.

This reverts commit 7844e00a6f93d379104896bcd5500a2f0bc9afcc.

theme: make use of article.modified property.

theme: ability to optionally show also author list.

theme: remove unnecessary space.

theme: prefix also theme-related config with M_ to avoid confusion.

Sorry. A fully breaking change for the Pelican theme.

site: publish only what's needed from the theme.

Update bundled latex2svg from upstream.

Improve documentation about additional dependencies.

And also provide a short guide how to build the m.css website itself.

Missing libgs warning (latex2svg.py) and generation failing.

Problem was the the name looked for 'libgs' on linux platform it should
be 'gs'. On Ubuntu 16.04 find_library gives 'libgs.so.9'

Last, but not least, LaTeX packages... (not small ones indeed!)

```
sudo apt-get install texlive-base
sudo apt-get install texlive-latex-extra
sudo apt-get install texlive-fonts-extra
```

doc: explicitly put code roles into all files.

Even though Pelican doesn't complain now, as it depends heavily on the
order in which the files are parsed.

Better locale name for date formatting.

Correct text role error on pelican 3.7.1

site: minor conf updates.

doc: writing m.css in a typewriter font is *ugly*.

doc: this is not needed anymore.

css: better behaving background on short pages.

Previously, if the page was too short, the lighter footer background was
not all the way down, looking ugly. Now the <html> element has the
footer background color and that's overriden by <body> to the body
background.

Again, I hope this doesn't break anyone's site :)

site: huh.

site: put my e-mail to the footer.

Yay! More spam!

theme: apply format_siteurl to all navbar and feed links.

So all URLs are absolute.

doc: document the format_siteurl Jinja2 filter better.

theme: ability to override which menu item is highlighted.

theme: new :header: and :footer: page fields.

I'm putting the page-specific navigation there, because otherwise
highlighting the last page section would highlight the nav as well and
that is just wrong in so many ways.

css: m-container-inflatable is now a class instead of ID.

Because I realized that having multiple inflatable containers (one after
another) is a completely valid use case. Sorry for breaking your stuff
with this.

Doc++

m.htmlsanity: better consistency for collapsed <p>s in additional fields.

Previously (and that's also how stock Pelican behaves) article summaries
and other FORMATTED_FIELDS had <p> collapsing disabled completely. That
made some inconsistencies in the HTML markup (i.e., a m.css note in
article summary would look slightly differently compared to a note in
article content because of the additional <p>).

Now <p>s are collapsed for FORMATTED_FIELDS as well and the HTML writer
has an additional exception that it *does not* remove <p>s from nodes
that are directly inside field bodies.

I fail at reST.

Even after seven months of writing it. Kill me.

site: new landing page dedicated for math features.

themes: omitting bold italic font was a bad idea.

Some other not really matching (slightly bolder) font was chosen
instead, making things ugly.

doc: fix and improve docs about math.

css: make hiding brand link on landing pages opt-in.

Not all landing pages repeat it, probably just one does that -- the
index one.

css: add .m-strong and .m-em classes.

Meant to help work around reST limitation of not being able to have
strong emphasis.

doc: mention that m-grid.css can be used WITHOUT ALL THE OTHER CRUFT.

doc: make the hand-written SVG valid.

With no conflicting IDs and using proper tag names.

m.math: document the behavior better.

m.htmlsanity: figure legend shouldn't be wrapped in a <div>.

The <div> element is not allowed inside <figure> in the HTML5 standard.

css: document that code blocks overflow with a scrollbar.

Instead of the lines being wrapped.

doc: forgot to close a tag in raw HTML.

Ugh.

css: added .m-light class to make part of a heading thinner.

Also documented how headings behave.

m.math: it's <desc>, not <description>.

*Now* it's valid HTML5.

m.math: unique names for SVG paths and pages.

Makes the markup valid HTML5 and avoids strange issues with missing /
wrong paths due to conflicting IDs.

css: put scrollbars on large maths.

Properly credit latex2svg.

theme: article header date formatting should not depend on DATE_FORMATS.

It's affected only by the locale in it, but that's desired.

theme: charset meta tag should be first in head.

Huh. Makes sense. Reported by https://sonarwhal.com/scanner/.

This is just stupid :(

Tone down even more.

theme: treat CSS file links as possibly SITEURL-relative as well.

doc: don't use outdated CSS classes.

theme: standardize and document slug for blog-related pages.

doc: cover image for the website.

Remove all workarounds related to the old schizophrenic URL handling.

doc: this should be a warning.

doc: fix reference.

m.htmlsanity: introduce and use new format_siteurl filter.

I needed a way to prepend SITEURL to page, article, tag etc URLs that's
consistent with current (wrong) Pelican way of doing it:

    '/'.join([SITEURL, url])

That of course doesn't work when `url` is an absolute URL, so I'm using
urljoin (but still staying compatible with the above). This is now also
used throughout the template -- I mistakenly assumed that when SITEURL
is set, all page.url etc. properties already have it, but that's
apparently *not* the case, which caused me a bit of headache the past
months.

doc: properly document what BLOGURL and BLOGNAME do.

And also *use* them. Ugh.

doc: mention that even the Pelican theme itself needs m.htmlsanity.

Well. That makes it a bit harder to adopt now :/

css: updated postprocessed CSS files.

css: darker background for jumbo articles / landing pages.

m.images: make it possible to enforce alt text for all images and figures.

plugins: prefix config options by plugin name.

So it's clear what is what.

m.images: shuffle the code around a bit.

doc: mention server-side compression config for Apache.

theme: reduce indentation of the markup a bit.

theme: generated markup look update.

m.images: make image grid working on Py3.4.

https://stackoverflow.com/questions/12720450/unpacking-arguments-only-named-arguments-may-follow-expression