math: work around a bug in latex xcolor package < 2.12.

Affects Ubuntu 16.04.

math: update tests for dvisvgm > 2.2.2.

This is not a welcome change, unfortunately. It only bloats the output.

doc: update Doxygen docs.

I wanted to deprecate \m_div, but nope. Not possible. Everything is
shit.

doxygen: make it possible to abuse \par for a bigger m.css block.

doxygen: support \parblock.

Uh, finally a <div>-like thing.

css: make .m-code-figure and .m-console-figure usable also on <div>s.

For better flexibility -- it's hard to hammer a <figure> out of Doxygen
XML.

doc: fix warnings coming from (the upcoming) Pelican 3.8.

css: style focused link/canvas/input outline.

Matches the current item color in top navbar.

doxygen: workarounds to make coverage.py happy :/

doxygen: support Qt signals and slots.

doxygen: ignore private non-virtual functions in user-defined groups.

Only documented virtual private functions are shown.

theme: properly fallback to FEED_ATOM if FEED_ATOM_URL is not set.

doxygen: support friend functions.

Not friend classes/structs/unions, in that case Doxygen provides way too
little info to be at all useful.

doxygen: don't silently ignore friend declarations.

doxygen: code coverage back to 100%.

doxygen: don't assert also for unexpected commands inside sections.

doxygen: page briefs are not available on 1.8.13.

And 1.8.14 binary is *still* not usable on Travis.

theme: make article date splitting more robust.

This could fail in case there are spaces in some of the generated
values. Still not ideal, should be made configurable (locale-dependent
order etc).

doxygen: don't assert on unexpected sections / commands.

Until now, putting a @param into a variable description (or similar
unexpected things) resulted in an assertion. Turns out this happens
quite often, so I made that into a warning instead. The contents are
simply ignored.

doxygen: fix a CASE_SENSE_NAMES omission.

In 1d7c689fd36b6952c0f6877ad9af562e3e10433a I fixed one broken part but
forgot about this one. This one affects the Pages tree and the test of
course didn't check it. Now it does.

doxygen: as usual, I found more Doxygen bugs while fixing other stuff.

This usual thing in Markdown files, for example:

    Hello world
    ###########

is parsed as a paragraph and a 11th level heading with no title.
UHHMAZING, isn't it. Because of that, I'm no longer asserting on too
large heading levels but instead trying to provide helpful warning
messages for the user.

doxygen: deprecation status also for pages.

Originally I didn't think this would ever be useful, but recently I
deprecated a whole library and thus also the overview pages for it
should be marked as deprecated.

doxygen: display the deprecation label next to the name, not after brief.

theme: display article draft status more prominently.

So I can submit clearly marked draft articles for review and I don't
accidentally leave the draft status enabled when publishing.

m.plots: make it possible to hide particular extra labels.

css: added m-spacing-150.

plugins: new m.link plugin.

plugins: make it possible to specify classes on all link roles.

css: ability to remove the underline from links.

This will be a bit harder to do for reST, will need to create a custom
role for it.

css: add m-block-dot-* to have linear lists delimited by a center dot.

doxygen: parse the Doxyfile as UTF-8.

Otherwise it blows up on Doxyfiles with non-ASCII characters when system
locale is not UTF-8.

doc: improve docs for the Doxygen \m_keyword command.

css: correctly color inline math in doxygen brief descriptions.

doxygen: wrap long class / namespace <h1>s on semicolons.

doxygen: support brief for enum values.

Turns out the enum values can be documented like this:

    //! A value
    enum Enum {
        Value, //!< A value
    };

and the /// or //! comments, unlike /** */, are treated as brief by
doxygen. This is a completely valid use case and I don't want to force
users to a different syntax here, so here ya go.

m.dot: compatibility with Graphviz < 2.40.

Ugh. This does not scale at all.

m.dot: support structs/records as well.

m.dot: explicitly specify font size of the SVG.

Otherwise it won't go well in combination with auto-scaling and font
sizes of the document relative to screen size (such as in presentation
mode).

doc: show where graph rendering is tested in build status.

m.dot: new highly experimental graph drawing plugin.

m.math: mark private variable as private.

m.math: escape more things in the regexp.

doc: it can be just apt install.

doc: mention that Doxygen math/code rendering is equivalent to Pelican.

I don't want to repeat all the features there :)

doc: update math docs with new features and behavior.

m.math: test also math following surrounding text size.

m.math: ability to color equation parts using m.css color classes.

m.math: properly escape formula sources in the output.

m.math: use em units instead of pt.

So it's possible to actually scale the formulas relative to surrounding
text.

m.math: having "LaTeX Math" in a hover title is as useless as it can get.

I thought browsers would show the <desc> as well, but no. So putting the
math formula directly in the <title>.

css: make it possible to have colored *parts* of math equations.

css: make it possible to have math *in buttons*.

Yes, I'm crazy.

css: make it possible to disable component padding at the bottom.

Reusing the .m-nopadb class from the grid CSS.

doxygen: avoid having stale url_base when parsing defines.

I *knew* something would blow up here.

doxygen: put search icon size directly into the markup.

Fixes the problem with a giant magnifying glass when no style is present
and also should fix the random layout bugs with top navbar being twice
as high (which is probably caused by the browser not calculating the
floating etc. properly due to such a huge change after the style is
loaded).

css: make postprocess.py work on Python < 3.6.

package/ci: test that I didn't forget to update compiled CSS.

Doc++

doxygen: make it possible to hide m.css options from Doxygen.

Makes the output finally bearable.

site: avoid ugly wrapping on /admire/math/.

Soon it also won't be a Pelican plugin anymore.

css: use concrete font weight value.

I'm using semibold version of Source Sans Pro, which is 600, not 800.

css: make code font size configurable from the theme.

Not every combination of font and monospace font works with scaling the
code to 0.9 -- the light theme has base font size only 14px and there
the code would be too small. Also use `em` instead of `rem` so it
follows surrounding text size.

css: properly handle variable declarations with comments in postprocess.py.

doxygen: don't crash on anchors with IDs that don't match the compound.

m.components: provide roles for labels.

I got extremely tired of writing this myself *every time*.

css: strip trailing comments also for lines with variables.

I am back at 8.9 kB, yay!

Make the latex2svg caching fully optional.

css: separate page layout styling out from m-components.css.

For the presentation framework I need the responsiveness,
typography, components but definitely not popup menus or jumbo article
styling. So away it goes, into a new m-layout.css file.

This also means the theme setup is now in a separate m-theme-*.css file
and the m-dark.css / m-light.css is just a "driver file" that imports
everything else. There will be a m-dark-presentation.css /
m-light-presentation.css driver file as well.

css: reduce excessive line length.

css: deduplicate parser code in the CSS preprocessor.

No change in the output (which was desired).

Exclude the third-party latex2svg.py from code coverage.

Include general symbols for math rendering.

I needed that for the \degree symbol.

Implement caching of rendered math output.

Stores the output of divsvgm in a dict and (de)serializes that in the
filesystem to preserve it across runs. Rough speedup:

 * For the Magnum website, initial generation went down from 14 seconds
   to 9, with subsequent runs just 2.5 seconds.
 * For the Magnum docs, generation time went down from 1:33 to just 14
   seconds.

m.math: properly reset formula counter on page breaks.

Otherwise the output was not deterministic anymore.

doxygen: warn if included code snippet is empty.

Very useful since Doxygen stays silent in this case.

plugins: new m.vk plugin.

plugins: avoid dependency on __init__.py for simple link plugins.

Duplicated the common code over. It's fully covered, so it's okay.

doxygen: mention that block-level \m_class has to be separated by a
newline.

I *really tried* to make it work, but it was not worth the pain.

doxygen: <image> doesn't have to be always in <para>.

m.code: don't blow up if inline literal doesn't have language.

doxygen: implement <small>.

doxygen: implement <hruler/>.

doc: include client search tests in Build Status.

doxygen: support \section etc. in function documentation.

Not rendered into <section> tags as that breaks the style, it's just
basic <hX> tags. Also ensuring that \param, \return etc. are propagated
from there.

doxygen: minor cleanup.

doxygen: proper <hX> hierarchy for headings in non-top-level description.

Also don't emit the \section warning for these, it does not make sense.

m.plots: matplotlib otherwise keeps everything in memory.

Huh.

m.plots: work around test failure on Travis.

Only one ID is different, which is still okay to validate a separate
test case.

m.plots: make the font configurable so we can pass the CI.

m.plots: matplotlib uses X by default?!

package/ci: install matplotlib.

plugins: new m.plots plugin for rendering inline SVG plots.

doc: fix breadcrumb.

doxygen: be nicer to KDevelop syntax highlighter.

doxygen: verify that latex blow up is handled properly.

plugins: properly print error from latex2svg when something fails.

doxygen: don't crash during search building on too long function arguments.

In some very pathological cases the function parameter list might exceed
256 characters, which won't fit in the serialized data. But that also
won't fit in the search result list so there's no point in storing so
much. Truncating to 65 characters and adding an ellipsis after.

doxygen: make KDevelop higlighting happier.

doxygen: fix crash with class inheritance outside of a namespace.

Amazing that I didn't come across this until now.

doxygen: bundle a matching favicon by default.