chiark / gitweb /
Vladimír Vondruš [Thu, 11 Oct 2018 10:48:04 +0000 (12:48 +0200)]
doxygen: remove redundancy from test names.
Vladimír Vondruš [Thu, 11 Oct 2018 10:47:32 +0000 (12:47 +0200)]
doxygen: support adding extra stuff to HTML <head>.
There's a new option for that: M_HTML_HEADER. Specify it as a multi-line
value for extra prettiness.
Vladimír Vondruš [Thu, 11 Oct 2018 11:23:29 +0000 (13:23 +0200)]
doxygen: concat string Doxyfile properties with a newline, not a space.
I need this for proper multi-line value support. This was quite a corner
case, so I don't expect any user code breaking. I'm now also properly
handling single quotes in Doxyfile, by accident the test data wasn't
really testing the behavior correctly.
Vladimír Vondruš [Sun, 7 Oct 2018 11:11:16 +0000 (13:11 +0200)]
doxygen: support specifying explicit image width/height.
Vladimír Vondruš [Fri, 28 Sep 2018 17:10:32 +0000 (19:10 +0200)]
doc: remove old and not-true-anymore statements.
Vladimír Vondruš [Wed, 19 Sep 2018 11:40:30 +0000 (13:40 +0200)]
package/ci: argh matplotlib is different now too.
Vladimír Vondruš [Wed, 19 Sep 2018 11:29:49 +0000 (13:29 +0200)]
math: work around a bug in latex xcolor package < 2.12.
Affects Ubuntu 16.04.
Vladimír Vondruš [Wed, 19 Sep 2018 11:04:06 +0000 (13:04 +0200)]
math: update tests for dvisvgm > 2.2.2.
This is not a welcome change, unfortunately. It only bloats the output.
Vladimír Vondruš [Thu, 13 Sep 2018 19:08:05 +0000 (21:08 +0200)]
doc: update Doxygen docs.
I wanted to deprecate \m_div, but nope. Not possible. Everything is
shit.
Vladimír Vondruš [Thu, 13 Sep 2018 18:55:33 +0000 (20:55 +0200)]
doxygen: make it possible to abuse \par for a bigger m.css block.
Vladimír Vondruš [Thu, 13 Sep 2018 18:54:04 +0000 (20:54 +0200)]
doxygen: support \parblock.
Uh, finally a <div>-like thing.
Vladimír Vondruš [Thu, 13 Sep 2018 18:46:29 +0000 (20:46 +0200)]
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.
Vladimír Vondruš [Thu, 13 Sep 2018 17:49:29 +0000 (19:49 +0200)]
doc: fix warnings coming from (the upcoming) Pelican 3.8.
Vladimír Vondruš [Thu, 13 Sep 2018 17:17:00 +0000 (19:17 +0200)]
css: style focused link/canvas/input outline.
Matches the current item color in top navbar.
Vladimír Vondruš [Thu, 13 Sep 2018 16:58:33 +0000 (18:58 +0200)]
doxygen: workarounds to make coverage.py happy :/
Vladimír Vondruš [Thu, 13 Sep 2018 16:47:34 +0000 (18:47 +0200)]
doxygen: support Qt signals and slots.
Vladimír Vondruš [Thu, 13 Sep 2018 16:44:43 +0000 (18:44 +0200)]
doxygen: ignore private non-virtual functions in user-defined groups.
Only documented virtual private functions are shown.
Vladimír Vondruš [Thu, 13 Sep 2018 15:05:05 +0000 (17:05 +0200)]
theme: properly fallback to FEED_ATOM if FEED_ATOM_URL is not set.
Vladimír Vondruš [Tue, 14 Aug 2018 21:20:28 +0000 (23:20 +0200)]
doxygen: support friend functions.
Not friend classes/structs/unions, in that case Doxygen provides way too
little info to be at all useful.
Vladimír Vondruš [Tue, 14 Aug 2018 19:51:11 +0000 (21:51 +0200)]
doxygen: don't silently ignore friend declarations.
Vladimír Vondruš [Thu, 13 Sep 2018 14:14:57 +0000 (16:14 +0200)]
doxygen: code coverage back to 100%.
Vladimír Vondruš [Thu, 13 Sep 2018 14:12:17 +0000 (16:12 +0200)]
doxygen: don't assert also for unexpected commands inside sections.
Vladimír Vondruš [Thu, 13 Sep 2018 13:56:12 +0000 (15:56 +0200)]
doxygen: page briefs are not available on 1.8.13.
And 1.8.14 binary is *still* not usable on Travis.
Vladimír Vondruš [Thu, 13 Sep 2018 12:59:19 +0000 (14:59 +0200)]
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).
Vladimír Vondruš [Thu, 13 Sep 2018 12:47:41 +0000 (14:47 +0200)]
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.
Vladimír Vondruš [Thu, 13 Sep 2018 11:27:14 +0000 (13:27 +0200)]
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.
Vladimír Vondruš [Thu, 13 Sep 2018 11:16:23 +0000 (13:16 +0200)]
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.
Vladimír Vondruš [Thu, 13 Sep 2018 10:29:31 +0000 (12:29 +0200)]
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.
Vladimír Vondruš [Thu, 13 Sep 2018 10:18:16 +0000 (12:18 +0200)]
doxygen: display the deprecation label next to the name, not after brief.
Vladimír Vondruš [Thu, 13 Sep 2018 09:55:49 +0000 (11:55 +0200)]
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.
Vladimír Vondruš [Wed, 12 Sep 2018 10:39:42 +0000 (12:39 +0200)]
m.plots: make it possible to hide particular extra labels.
Vladimír Vondruš [Sun, 26 Aug 2018 18:40:53 +0000 (20:40 +0200)]
css: added m-spacing-150.
Vladimír Vondruš [Sun, 26 Aug 2018 16:03:15 +0000 (18:03 +0200)]
plugins: new m.link plugin.
Vladimír Vondruš [Sun, 26 Aug 2018 15:52:34 +0000 (17:52 +0200)]
plugins: make it possible to specify classes on all link roles.
Vladimír Vondruš [Sun, 26 Aug 2018 14:46:00 +0000 (16:46 +0200)]
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.
Vladimír Vondruš [Sun, 26 Aug 2018 14:27:48 +0000 (16:27 +0200)]
css: add m-block-dot-* to have linear lists delimited by a center dot.
Vladimír Vondruš [Wed, 22 Aug 2018 16:29:39 +0000 (18:29 +0200)]
doxygen: parse the Doxyfile as UTF-8.
Otherwise it blows up on Doxyfiles with non-ASCII characters when system
locale is not UTF-8.
Vladimír Vondruš [Wed, 22 Aug 2018 16:29:11 +0000 (18:29 +0200)]
doc: improve docs for the Doxygen \m_keyword command.
Vladimír Vondruš [Tue, 14 Aug 2018 19:19:57 +0000 (21:19 +0200)]
css: correctly color inline math in doxygen brief descriptions.
Vladimír Vondruš [Tue, 14 Aug 2018 19:15:56 +0000 (21:15 +0200)]
doxygen: wrap long class / namespace <h1>s on semicolons.
Vladimír Vondruš [Tue, 14 Aug 2018 19:12:51 +0000 (21:12 +0200)]
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.
Vladimír Vondruš [Sun, 1 Jul 2018 12:40:45 +0000 (14:40 +0200)]
m.dot: compatibility with Graphviz < 2.40.
Ugh. This does not scale at all.
Vladimír Vondruš [Sun, 1 Jul 2018 14:07:07 +0000 (16:07 +0200)]
m.dot: support structs/records as well.
Vladimír Vondruš [Sun, 1 Jul 2018 13:08:03 +0000 (15:08 +0200)]
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).
Vladimír Vondruš [Mon, 18 Jun 2018 23:45:41 +0000 (01:45 +0200)]
doc: show where graph rendering is tested in build status.
Vladimír Vondruš [Mon, 18 Jun 2018 23:23:53 +0000 (01:23 +0200)]
m.dot: new highly experimental graph drawing plugin.
Vladimír Vondruš [Mon, 18 Jun 2018 23:26:19 +0000 (01:26 +0200)]
m.math: mark private variable as private.
Vladimír Vondruš [Mon, 18 Jun 2018 23:26:01 +0000 (01:26 +0200)]
m.math: escape more things in the regexp.
Vladimír Vondruš [Mon, 18 Jun 2018 23:24:14 +0000 (01:24 +0200)]
doc: it can be just apt install.
Vladimír Vondruš [Mon, 18 Jun 2018 13:13:16 +0000 (15:13 +0200)]
doc: mention that Doxygen math/code rendering is equivalent to Pelican.
I don't want to repeat all the features there :)
Vladimír Vondruš [Mon, 18 Jun 2018 13:11:58 +0000 (15:11 +0200)]
doc: update math docs with new features and behavior.
Vladimír Vondruš [Mon, 18 Jun 2018 13:20:25 +0000 (15:20 +0200)]
m.math: test also math following surrounding text size.
Vladimír Vondruš [Mon, 18 Jun 2018 13:09:13 +0000 (15:09 +0200)]
m.math: ability to color equation parts using m.css color classes.
Vladimír Vondruš [Mon, 18 Jun 2018 09:42:07 +0000 (11:42 +0200)]
m.math: properly escape formula sources in the output.
Vladimír Vondruš [Mon, 18 Jun 2018 09:21:09 +0000 (11:21 +0200)]
m.math: use em units instead of pt.
So it's possible to actually scale the formulas relative to surrounding
text.
Vladimír Vondruš [Mon, 18 Jun 2018 07:50:30 +0000 (09:50 +0200)]
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>.
Vladimír Vondruš [Mon, 18 Jun 2018 13:06:05 +0000 (15:06 +0200)]
css: make it possible to have colored *parts* of math equations.
Vladimír Vondruš [Mon, 18 Jun 2018 13:05:26 +0000 (15:05 +0200)]
css: make it possible to have math *in buttons*.
Yes, I'm crazy.
Vladimír Vondruš [Mon, 18 Jun 2018 07:54:23 +0000 (09:54 +0200)]
css: make it possible to disable component padding at the bottom.
Reusing the .m-nopadb class from the grid CSS.
Vladimír Vondruš [Mon, 18 Jun 2018 11:30:42 +0000 (13:30 +0200)]
doxygen: avoid having stale url_base when parsing defines.
I *knew* something would blow up here.
Vladimír Vondruš [Mon, 18 Jun 2018 09:29:00 +0000 (11:29 +0200)]
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).
Vladimír Vondruš [Sun, 17 Jun 2018 11:01:53 +0000 (13:01 +0200)]
css: make postprocess.py work on Python < 3.6.
Vladimír Vondruš [Sun, 17 Jun 2018 10:06:08 +0000 (12:06 +0200)]
package/ci: test that I didn't forget to update compiled CSS.
Vladimír Vondruš [Sun, 17 Jun 2018 10:54:37 +0000 (12:54 +0200)]
Doc++
Vladimír Vondruš [Sun, 17 Jun 2018 10:53:06 +0000 (12:53 +0200)]
doxygen: make it possible to hide m.css options from Doxygen.
Makes the output finally bearable.
Vladimír Vondruš [Sun, 17 Jun 2018 09:55:13 +0000 (11:55 +0200)]
site: avoid ugly wrapping on /admire/math/.
Soon it also won't be a Pelican plugin anymore.
Vladimír Vondruš [Sun, 17 Jun 2018 09:54:13 +0000 (11:54 +0200)]
css: use concrete font weight value.
I'm using semibold version of Source Sans Pro, which is 600, not 800.
Vladimír Vondruš [Sun, 17 Jun 2018 09:52:18 +0000 (11:52 +0200)]
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.
Vladimír Vondruš [Sun, 17 Jun 2018 09:50:01 +0000 (11:50 +0200)]
css: properly handle variable declarations with comments in postprocess.py.
Vladimír Vondruš [Sun, 17 Jun 2018 09:41:20 +0000 (11:41 +0200)]
doxygen: don't crash on anchors with IDs that don't match the compound.
Vladimír Vondruš [Thu, 14 Jun 2018 11:58:41 +0000 (13:58 +0200)]
m.components: provide roles for labels.
I got extremely tired of writing this myself *every time*.
Vladimír Vondruš [Wed, 13 Jun 2018 21:55:57 +0000 (23:55 +0200)]
css: strip trailing comments also for lines with variables.
I am back at 8.9 kB, yay!
Vladimír Vondruš [Wed, 13 Jun 2018 10:20:07 +0000 (12:20 +0200)]
Make the latex2svg caching fully optional.
Vladimír Vondruš [Wed, 13 Jun 2018 10:08:01 +0000 (12:08 +0200)]
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.
Vladimír Vondruš [Wed, 13 Jun 2018 09:50:06 +0000 (11:50 +0200)]
css: reduce excessive line length.
Vladimír Vondruš [Wed, 13 Jun 2018 09:17:06 +0000 (11:17 +0200)]
css: deduplicate parser code in the CSS preprocessor.
No change in the output (which was desired).
Vladimír Vondruš [Mon, 11 Jun 2018 13:42:31 +0000 (15:42 +0200)]
Exclude the third-party latex2svg.py from code coverage.
Vladimír Vondruš [Mon, 11 Jun 2018 13:35:07 +0000 (15:35 +0200)]
Include general symbols for math rendering.
I needed that for the \degree symbol.
Vladimír Vondruš [Mon, 11 Jun 2018 13:32:49 +0000 (15:32 +0200)]
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.
Vladimír Vondruš [Mon, 11 Jun 2018 13:28:57 +0000 (15:28 +0200)]
m.math: properly reset formula counter on page breaks.
Otherwise the output was not deterministic anymore.
Vladimír Vondruš [Sat, 9 Jun 2018 15:07:23 +0000 (17:07 +0200)]
doxygen: warn if included code snippet is empty.
Very useful since Doxygen stays silent in this case.
Vladimír Vondruš [Mon, 4 Jun 2018 07:21:40 +0000 (09:21 +0200)]
plugins: new m.vk plugin.
Vladimír Vondruš [Mon, 4 Jun 2018 07:04:47 +0000 (09:04 +0200)]
plugins: avoid dependency on __init__.py for simple link plugins.
Duplicated the common code over. It's fully covered, so it's okay.
Vladimír Vondruš [Mon, 4 Jun 2018 06:28:57 +0000 (08:28 +0200)]
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.
Vladimír Vondruš [Mon, 21 May 2018 20:20:41 +0000 (22:20 +0200)]
doxygen: <image> doesn't have to be always in <para>.
Vladimír Vondruš [Sat, 19 May 2018 11:31:02 +0000 (13:31 +0200)]
m.code: don't blow up if inline literal doesn't have language.
Vladimír Vondruš [Sat, 19 May 2018 11:24:24 +0000 (13:24 +0200)]
doxygen: implement <small>.
Vladimír Vondruš [Sat, 19 May 2018 11:23:21 +0000 (13:23 +0200)]
doxygen: implement <hruler/>.
Vladimír Vondruš [Sat, 19 May 2018 09:05:09 +0000 (11:05 +0200)]
doc: include client search tests in Build Status.
Vladimír Vondruš [Sat, 19 May 2018 08:54:00 +0000 (10:54 +0200)]
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.
Vladimír Vondruš [Sat, 19 May 2018 08:50:09 +0000 (10:50 +0200)]
doxygen: minor cleanup.
Vladimír Vondruš [Sat, 19 May 2018 08:29:16 +0000 (10:29 +0200)]
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.
Vladimír Vondruš [Wed, 16 May 2018 10:31:41 +0000 (12:31 +0200)]
m.plots: matplotlib otherwise keeps everything in memory.
Huh.
Vladimír Vondruš [Wed, 16 May 2018 10:12:48 +0000 (12:12 +0200)]
m.plots: work around test failure on Travis.
Only one ID is different, which is still okay to validate a separate
test case.
Vladimír Vondruš [Wed, 16 May 2018 09:49:40 +0000 (11:49 +0200)]
m.plots: make the font configurable so we can pass the CI.
Vladimír Vondruš [Wed, 16 May 2018 09:13:25 +0000 (11:13 +0200)]
m.plots: matplotlib uses X by default?!
Vladimír Vondruš [Wed, 16 May 2018 09:09:48 +0000 (11:09 +0200)]
package/ci: install matplotlib.
Vladimír Vondruš [Tue, 15 May 2018 21:52:58 +0000 (23:52 +0200)]
plugins: new m.plots plugin for rendering inline SVG plots.
Vladimír Vondruš [Wed, 16 May 2018 09:00:56 +0000 (11:00 +0200)]
doc: fix breadcrumb.
Vladimír Vondruš [Tue, 15 May 2018 16:54:01 +0000 (18:54 +0200)]
doxygen: be nicer to KDevelop syntax highlighter.
~cjwatson / blog.git / log