chiark / gitweb /
blog.git
7 years agodoxygen: use single quotes for non-prose text.
Vladimír Vondruš [Mon, 11 Dec 2017 13:46:35 +0000 (14:46 +0100)]
doxygen: use single quotes for non-prose text.

7 years agodoxygen: split out tests that depend on unreleased Doxygen features.
Vladimír Vondruš [Mon, 11 Dec 2017 13:46:12 +0000 (14:46 +0100)]
doxygen: split out tests that depend on unreleased Doxygen features.

7 years agotheme: don't include the keywords meta tag if there are no tags.
Vladimír Vondruš [Mon, 11 Dec 2017 11:46:16 +0000 (12:46 +0100)]
theme: don't include the keywords meta tag if there are no tags.

7 years agotheme, plugins: make the tests working under Python 3.4.
Vladimír Vondruš [Mon, 11 Dec 2017 11:42:12 +0000 (12:42 +0100)]
theme, plugins: make the tests working under Python 3.4.

7 years agotheme: of course it's wrong.
Vladimír Vondruš [Mon, 11 Dec 2017 11:41:54 +0000 (12:41 +0100)]
theme: of course it's wrong.

7 years agom.htmlsanity: improve the test.
Vladimír Vondruš [Mon, 11 Dec 2017 11:41:19 +0000 (12:41 +0100)]
m.htmlsanity: improve the test.

In particular, hyphenation is used inside the theme itself, verify that
things are not wrongly escaped for example.

7 years agodoxygen: fix M_EXPAND_INNER_TYPES option.
Vladimír Vondruš [Mon, 11 Dec 2017 10:22:15 +0000 (11:22 +0100)]
doxygen: fix M_EXPAND_INNER_TYPES option.

7 years agodoxygen: make it possible to not display Doxygen version in output.
Vladimír Vondruš [Mon, 11 Dec 2017 10:15:08 +0000 (11:15 +0100)]
doxygen: make it possible to not display Doxygen version in output.

Makes testing on Other People Machines actually possible.

7 years agodoxygen: use native Doxyfile booleans instead of 0/1.
Vladimír Vondruš [Mon, 11 Dec 2017 10:13:37 +0000 (11:13 +0100)]
doxygen: use native Doxyfile booleans instead of 0/1.

7 years agom.images: initial test.
Vladimír Vondruš [Mon, 11 Dec 2017 02:24:22 +0000 (03:24 +0100)]
m.images: initial test.

7 years agom.math: initial test.
Vladimír Vondruš [Mon, 11 Dec 2017 02:23:59 +0000 (03:23 +0100)]
m.math: initial test.

7 years agom.gl: initial test.
Vladimír Vondruš [Mon, 11 Dec 2017 02:02:57 +0000 (03:02 +0100)]
m.gl: initial test.

7 years agom.gh: initial test.
Vladimír Vondruš [Mon, 11 Dec 2017 02:02:40 +0000 (03:02 +0100)]
m.gh: initial test.

7 years agom.dox: initial test.
Vladimír Vondruš [Mon, 11 Dec 2017 02:02:25 +0000 (03:02 +0100)]
m.dox: initial test.

7 years agom.filesize: initial test.
Vladimír Vondruš [Mon, 11 Dec 2017 01:39:52 +0000 (02:39 +0100)]
m.filesize: initial test.

7 years agom.code: initial test.
Vladimír Vondruš [Mon, 11 Dec 2017 01:22:53 +0000 (02:22 +0100)]
m.code: initial test.

7 years agom.components: initial test.
Vladimír Vondruš [Mon, 11 Dec 2017 01:22:33 +0000 (02:22 +0100)]
m.components: initial test.

7 years agom.abbr: fix case of empty title, test it.
Vladimír Vondruš [Mon, 11 Dec 2017 00:47:02 +0000 (01:47 +0100)]
m.abbr: fix case of empty title, test it.

7 years agom.htmlsanity: initial test.
Vladimír Vondruš [Mon, 11 Dec 2017 00:32:41 +0000 (01:32 +0100)]
m.htmlsanity: initial test.

7 years agom.htmlsanity: remove more docutils cruft from the markup.
Vladimír Vondruš [Mon, 11 Dec 2017 00:35:26 +0000 (01:35 +0100)]
m.htmlsanity: remove more docutils cruft from the markup.

7 years agom.htmlsanity: properly use raw string literals.
Vladimír Vondruš [Sun, 10 Dec 2017 23:42:15 +0000 (00:42 +0100)]
m.htmlsanity: properly use raw string literals.

7 years agoMove the latex2svg code out of "m" plugins, as it is not a plugin.
Vladimír Vondruš [Mon, 11 Dec 2017 01:50:34 +0000 (02:50 +0100)]
Move the latex2svg code out of "m" plugins, as it is not a plugin.

7 years agoMove the ansilexer code out of the "m" plugins, as it's not a plugin.
Vladimír Vondruš [Mon, 11 Dec 2017 01:13:19 +0000 (02:13 +0100)]
Move the ansilexer code out of the "m" plugins, as it's not a plugin.

7 years agoUpdate testing docs, move all developer docs to CONTRIBUTING.rst.
Vladimír Vondruš [Mon, 11 Dec 2017 00:11:08 +0000 (01:11 +0100)]
Update testing docs, move all developer docs to CONTRIBUTING.rst.

So the first-time passerbys are not confused by it.

7 years agotheme: dehyphenate summary and description in <meta> tags.
Vladimír Vondruš [Mon, 11 Dec 2017 00:33:15 +0000 (01:33 +0100)]
theme: dehyphenate summary and description in <meta> tags.

3rd party websites and other tools might not expect that and it can
cause weird look in some cases.

7 years agotheme: properly HTML-escape all content and test the results.
Vladimír Vondruš [Sun, 10 Dec 2017 23:39:11 +0000 (00:39 +0100)]
theme: properly HTML-escape all content and test the results.

7 years agotheme: test page rendering.
Vladimír Vondruš [Sun, 10 Dec 2017 14:44:14 +0000 (15:44 +0100)]
theme: test page rendering.

7 years agotheme: test blog rendering.
Vladimír Vondruš [Sat, 9 Dec 2017 23:01:23 +0000 (00:01 +0100)]
theme: test blog rendering.

7 years agotheme: tests for the global layout.
Vladimír Vondruš [Sat, 9 Dec 2017 20:58:56 +0000 (21:58 +0100)]
theme: tests for the global layout.

Otherwise the things go over my head to an unmaintainable mess pretty
fast.

7 years agotheme: explicit hyphenation of hardcoded content.
Vladimír Vondruš [Sun, 10 Dec 2017 23:41:45 +0000 (00:41 +0100)]
theme: explicit hyphenation of hardcoded content.

7 years agotheme: superfluous whitespace.
Vladimír Vondruš [Sun, 10 Dec 2017 23:36:50 +0000 (00:36 +0100)]
theme: superfluous whitespace.

7 years agotheme: page header is not supported on landing pages.
Vladimír Vondruš [Sun, 10 Dec 2017 14:41:18 +0000 (15:41 +0100)]
theme: page header is not supported on landing pages.

7 years agotheme: group all the <link> elements together in <head>.
Vladimír Vondruš [Sun, 10 Dec 2017 14:40:56 +0000 (15:40 +0100)]
theme: group all the <link> elements together in <head>.

My OCD is happy.

7 years agotheme: more compact page markup.
Vladimír Vondruš [Sun, 10 Dec 2017 14:40:20 +0000 (15:40 +0100)]
theme: more compact page markup.

7 years agotheme: rename :navbar_brand_hidden: option to :hide_navbar_brand:.
Vladimír Vondruš [Sun, 10 Dec 2017 14:37:50 +0000 (15:37 +0100)]
theme: rename :navbar_brand_hidden: option to :hide_navbar_brand:.

Sorry about the breakage (again). For consistency with naming of all
other "do something" options (:collapse_first:, :hide_summary: etc.).

7 years agotheme: make the index and archives page completely equivalent.
Vladimír Vondruš [Sun, 10 Dec 2017 12:43:08 +0000 (13:43 +0100)]
theme: make the index and archives page completely equivalent.

Pagination can be enabled/disabled for either of them.

7 years agotheme: fix layout for sites that don't use tags at all.
Vladimír Vondruš [Sun, 10 Dec 2017 12:40:36 +0000 (13:40 +0100)]
theme: fix layout for sites that don't use tags at all.

7 years agotheme: add a clearfix for consistency.
Vladimír Vondruš [Sat, 9 Dec 2017 23:03:46 +0000 (00:03 +0100)]
theme: add a clearfix for consistency.

The article header will include per-category avatar soon and this
clearfix is needed for that.

7 years agotheme: superfluous whitespace if no article author exists.
Vladimír Vondruš [Sat, 9 Dec 2017 23:03:23 +0000 (00:03 +0100)]
theme: superfluous whitespace if no article author exists.

7 years agotheme: simpler markup in minimal cases of articles.
Vladimír Vondruš [Sat, 9 Dec 2017 23:02:48 +0000 (00:02 +0100)]
theme: simpler markup in minimal cases of articles.

7 years agotheme: trim output coming from Pelican to avoid ugly empty lines.
Vladimír Vondruš [Sat, 9 Dec 2017 22:14:31 +0000 (23:14 +0100)]
theme: trim output coming from Pelican to avoid ugly empty lines.

7 years agotheme: better empty behavior in the blog.
Vladimír Vondruš [Sat, 9 Dec 2017 22:07:24 +0000 (23:07 +0100)]
theme: better empty behavior in the blog.

7 years agotheme: some welcome message for the First Run.
Vladimír Vondruš [Sat, 9 Dec 2017 22:06:32 +0000 (23:06 +0100)]
theme: some welcome message for the First Run.

7 years agotheme: make the archives page work without pagination set up.
Vladimír Vondruš [Sat, 9 Dec 2017 22:06:05 +0000 (23:06 +0100)]
theme: make the archives page work without pagination set up.

7 years agotheme: more compact markup for jumbo articles.
Vladimír Vondruš [Sat, 9 Dec 2017 22:04:48 +0000 (23:04 +0100)]
theme: more compact markup for jumbo articles.

7 years agotheme: if there are no navbar links, don't even show the hamburger.
Vladimír Vondruš [Sat, 9 Dec 2017 21:45:56 +0000 (22:45 +0100)]
theme: if there are no navbar links, don't even show the hamburger.

7 years agotheme: make single-column navbar full width.
Vladimír Vondruš [Sat, 9 Dec 2017 21:45:19 +0000 (22:45 +0100)]
theme: make single-column navbar full width.

So the items can have long names.

7 years agotheme: sane default fine print, ability to hide (parts of) the footer.
Vladimír Vondruš [Sat, 9 Dec 2017 21:43:01 +0000 (22:43 +0100)]
theme: sane default fine print, ability to hide (parts of) the footer.

7 years agotheme: nice defaults if M_BLOG_{NAME,URL} / M_SITE_LOGO_TEXT not defined.
Vladimír Vondruš [Sat, 9 Dec 2017 21:40:05 +0000 (22:40 +0100)]
theme: nice defaults if M_BLOG_{NAME,URL} / M_SITE_LOGO_TEXT not defined.

7 years agodoc: hint proper use of the `e` Jinja2 filter.
Vladimír Vondruš [Mon, 11 Dec 2017 00:34:49 +0000 (01:34 +0100)]
doc: hint proper use of the `e` Jinja2 filter.

7 years agodoc: mention how to make inverted jumbo article cover.
Vladimír Vondruš [Sun, 10 Dec 2017 23:41:14 +0000 (00:41 +0100)]
doc: mention how to make inverted jumbo article cover.

7 years agodoc: mention that the :description: field should be formatted.
Vladimír Vondruš [Sun, 10 Dec 2017 23:40:54 +0000 (00:40 +0100)]
doc: mention that the :description: field should be formatted.

7 years agodoc: clarify pagination etc. behavior in default Pelican setup.
Vladimír Vondruš [Sun, 10 Dec 2017 12:53:49 +0000 (13:53 +0100)]
doc: clarify pagination etc. behavior in default Pelican setup.

7 years agodoc++
Vladimír Vondruš [Thu, 7 Dec 2017 17:27:23 +0000 (18:27 +0100)]
doc++

7 years agodoxygen: symlink files instead of making copies.
Vladimír Vondruš [Sat, 9 Dec 2017 22:17:12 +0000 (23:17 +0100)]
doxygen: symlink files instead of making copies.

7 years agodoxygen: expected is *second* in the assertSomething() functions.
Vladimír Vondruš [Sat, 9 Dec 2017 21:44:06 +0000 (22:44 +0100)]
doxygen: expected is *second* in the assertSomething() functions.

7 years agosite: fix double-escaped URL.
Vladimír Vondruš [Thu, 7 Dec 2017 17:21:08 +0000 (18:21 +0100)]
site: fix double-escaped URL.

7 years agodoc: document the additional pain inflicted on macOS LaTeX users.
Vladimír Vondruš [Thu, 7 Dec 2017 10:34:03 +0000 (11:34 +0100)]
doc: document the additional pain inflicted on macOS LaTeX users.

7 years agodoc: fix pelicanconf.py parameters.
Bridouz [Thu, 7 Dec 2017 10:25:20 +0000 (11:25 +0100)]
doc: fix pelicanconf.py parameters.

This is probably the first thing anyone will do and so there isn't any
pre-existing PLUGIN_PATHS or PLUGINS variable that could be added to.

7 years agotheme: make the top navbar markup a bit more compact.
Vladimír Vondruš [Thu, 7 Dec 2017 10:21:58 +0000 (11:21 +0100)]
theme: make the top navbar markup a bit more compact.

7 years agodoxygen: no need for the .h.nostrip language.
Vladimír Vondruš [Thu, 7 Dec 2017 10:21:14 +0000 (11:21 +0100)]
doxygen: no need for the .h.nostrip language.

Doxygen actually has a STRIP_CODE_COMMENTS option, which does exactly
what's needed.

7 years agodoc: use the compiled CSS file in Doxygen test page.
Vladimír Vondruš [Thu, 7 Dec 2017 10:20:57 +0000 (11:20 +0100)]
doc: use the compiled CSS file in Doxygen test page.

7 years agocss: I *am* stupid.
Vladimír Vondruš [Thu, 7 Dec 2017 01:31:18 +0000 (02:31 +0100)]
css: I *am* stupid.

7 years agodoxygen: doc++
Vladimír Vondruš [Thu, 7 Dec 2017 01:14:09 +0000 (02:14 +0100)]
doxygen: doc++

7 years agodoxygen: rework image support.
Vladimír Vondruš [Thu, 7 Dec 2017 01:03:06 +0000 (02:03 +0100)]
doxygen: rework image support.

 * The text after is not an alt text, but rather a figure caption. So
   render a figure in that case.
 * That means it's also not an error if the caption is not present. So
   don't warn about it.
 * Doxygen, if it wouldn't be so broken, would copy the images to the
   XML output directory as well. So there's no need to juggle with
   IMAGE_PATH. I love the smell of burning code.

7 years agodoxygen: be consistent with spacing in non-paired HTML tags.
Vladimír Vondruš [Thu, 7 Dec 2017 01:01:51 +0000 (02:01 +0100)]
doxygen: be consistent with spacing in non-paired HTML tags.

There is a space before the slash everywhere else, so have it here also.

7 years agodoxygen: avoid useless warning.
Vladimír Vondruš [Wed, 6 Dec 2017 23:46:30 +0000 (00:46 +0100)]
doxygen: avoid useless warning.

7 years agodoxygen: parsing <linebreak> tags.
Vladimír Vondruš [Wed, 6 Dec 2017 23:24:39 +0000 (00:24 +0100)]
doxygen: parsing <linebreak> tags.

7 years agodoxygen: prevent add_wbr() from breaking HTML tags.
Vladimír Vondruš [Wed, 6 Dec 2017 22:50:37 +0000 (23:50 +0100)]
doxygen: prevent add_wbr() from breaking HTML tags.

7 years agodoxygen: add a test for add_wbr().
Vladimír Vondruš [Wed, 6 Dec 2017 22:47:51 +0000 (23:47 +0100)]
doxygen: add a test for add_wbr().

Doesn't do the right thing at all times. That's why I'm adding it, ha.

7 years agodoxygen: make the <p> stripper work with empty content.
Vladimír Vondruš [Wed, 6 Dec 2017 22:47:29 +0000 (23:47 +0100)]
doxygen: make the <p> stripper work with empty content.

7 years agodoxygen: verify that empty table cells work.
Vladimír Vondruš [Wed, 6 Dec 2017 22:46:59 +0000 (23:46 +0100)]
doxygen: verify that empty table cells work.

Nope. It asserts.

7 years agodoxygen: table parsing.
Vladimír Vondruš [Wed, 6 Dec 2017 21:48:37 +0000 (22:48 +0100)]
doxygen: table parsing.

7 years agodoxygen: assert more instead of ignoring things.
Vladimír Vondruš [Wed, 6 Dec 2017 21:47:10 +0000 (22:47 +0100)]
doxygen: assert more instead of ignoring things.

7 years agodoxygen: reduce recursion a bit.
Vladimír Vondruš [Wed, 6 Dec 2017 21:46:51 +0000 (22:46 +0100)]
doxygen: reduce recursion a bit.

7 years agodoxygen: don't overwrite stuff from included Doxyfiles.
Vladimír Vondruš [Wed, 6 Dec 2017 20:56:01 +0000 (21:56 +0100)]
doxygen: don't overwrite stuff from included Doxyfiles.

7 years agodoxygen: support one more level of Markdown headings.
Vladimír Vondruš [Wed, 6 Dec 2017 20:35:46 +0000 (21:35 +0100)]
doxygen: support one more level of Markdown headings.

7 years agodoxygen: test and document behavior with code blocks inside lists.
Vladimír Vondruš [Wed, 6 Dec 2017 20:22:43 +0000 (21:22 +0100)]
doxygen: test and document behavior with code blocks inside lists.

It was asserting when wrongly-delimited code block was inside a list.

7 years agodoxygen: rework of the <para> patching number 67.
Vladimír Vondruš [Wed, 6 Dec 2017 19:17:01 +0000 (20:17 +0100)]
doxygen: rework of the <para> patching number 67.

Argh!

 * No longer having <p> around markdown headings (what!), <ul>, <ol>
   and <image> elements.
 * If ba list item, parameter description or return value description
   has multiple paragraphs, they are preserved. Brief description is
   still strictly single paragraph.
 * A special casing of simple nested lists, where item containing a
   sublist shouldn't be wrapped in a <p>.
 * Documented list behavior, explained how to make inflated lists even
   out of single-paragraph items.

7 years agodoxygen: improve heuristics for inline code.
Vladimír Vondruš [Wed, 6 Dec 2017 13:10:28 +0000 (14:10 +0100)]
doxygen: improve heuristics for inline code.

Now it should be finally robust. The test passes again.

7 years agodoxygen: test case for problematic \snippet call.
Vladimír Vondruš [Wed, 6 Dec 2017 13:02:57 +0000 (14:02 +0100)]
doxygen: test case for problematic \snippet call.

Somehow Doxygen is not wrapping \snippet in a paragraph, which causes
the inline code detection to fail.

7 years agodoxygen: strip whitespace at the beginning of new inserted paragraph.
Vladimír Vondruš [Wed, 6 Dec 2017 12:57:57 +0000 (13:57 +0100)]
doxygen: strip whitespace at the beginning of new inserted paragraph.

7 years agodoxygen: fix another nested paragraph corner case.
Vladimír Vondruš [Wed, 6 Dec 2017 12:56:01 +0000 (13:56 +0100)]
doxygen: fix another nested paragraph corner case.

7 years agodoxygen: test data for yet another nested paragraph corner case.
Vladimír Vondruš [Wed, 6 Dec 2017 12:47:08 +0000 (13:47 +0100)]
doxygen: test data for yet another nested paragraph corner case.

With expected output that currently fails.

7 years agocss: batch file to postprocess all CSS files.
Vladimír Vondruš [Mon, 4 Dec 2017 11:14:09 +0000 (12:14 +0100)]
css: batch file to postprocess all CSS files.

7 years agoInitial implementation of the Doxygen theme generator.
Vladimír Vondruš [Sat, 18 Nov 2017 17:42:00 +0000 (18:42 +0100)]
Initial implementation of the Doxygen theme generator.

7 years agocss: make it possible and nice-looking to use <p> inside <li> and <td>.
Vladimír Vondruš [Wed, 6 Dec 2017 19:01:43 +0000 (20:01 +0100)]
css: make it possible and nice-looking to use <p> inside <li> and <td>.

Paragraphs inside list items and table cells are neither justified nor
indented, because it's often undesirable in such constrained spaces.
Also, in case of <li>, the padding after block elements is not removed
in order to have the spacing consistent.

7 years agocss: wtf.
Vladimír Vondruš [Wed, 6 Dec 2017 12:02:31 +0000 (13:02 +0100)]
css: wtf.

7 years agotheme: more flexibility for the footer navigation.
Vladimír Vondruš [Wed, 6 Dec 2017 11:41:01 +0000 (12:41 +0100)]
theme: more flexibility for the footer navigation.

7 years agotheme: ability to control article expansion and summary appearance.
Vladimír Vondruš [Wed, 6 Dec 2017 11:36:58 +0000 (12:36 +0100)]
theme: ability to control article expansion and summary appearance.

7 years agodoc: improve the article examples a bit.
Vladimír Vondruš [Wed, 6 Dec 2017 11:30:52 +0000 (12:30 +0100)]
doc: improve the article examples a bit.

7 years agotheme: expect Python-like boolean value for navbar_brand_hidden field.
Vladimír Vondruš [Wed, 6 Dec 2017 09:19:48 +0000 (10:19 +0100)]
theme: expect Python-like boolean value for navbar_brand_hidden field.

7 years agocss: ability to configure paragraph appearance from the theme.
Vladimír Vondruš [Wed, 6 Dec 2017 09:07:17 +0000 (10:07 +0100)]
css: ability to configure paragraph appearance from the theme.

Someone might hate the justification or indent, make their lives easier.

7 years agodoc: this is needless, it's not testing anything that's not elsewhere.
Vladimír Vondruš [Mon, 4 Dec 2017 11:05:37 +0000 (12:05 +0100)]
doc: this is needless, it's not testing anything that's not elsewhere.

7 years agocss: support <h4>, <h5> and <h6> inside .m-block, .m-note, .m-frame.
Vladimír Vondruš [Mon, 4 Dec 2017 11:04:47 +0000 (12:04 +0100)]
css: support <h4>, <h5> and <h6> inside .m-block, .m-note, .m-frame.

7 years agodoc: clean up the CSS style docs and make them consistent.
Vladimír Vondruš [Sun, 3 Dec 2017 13:39:29 +0000 (14:39 +0100)]
doc: clean up the CSS style docs and make them consistent.

7 years agocss: updated postprocessed files.
Vladimír Vondruš [Sun, 3 Dec 2017 13:32:49 +0000 (14:32 +0100)]
css: updated postprocessed files.

7 years agocss: ability to skip imports and redirect output of postprocess.py.
Vladimír Vondruš [Sun, 3 Dec 2017 13:32:08 +0000 (14:32 +0100)]
css: ability to skip imports and redirect output of postprocess.py.

7 years agocss: save the whole command-line in postprocess.py.
Vladimír Vondruš [Sun, 3 Dec 2017 13:31:32 +0000 (14:31 +0100)]
css: save the whole command-line in postprocess.py.

7 years agocss: strip trailing comments in postprocess.py.
Vladimír Vondruš [Sun, 3 Dec 2017 13:31:00 +0000 (14:31 +0100)]
css: strip trailing comments in postprocess.py.

Could get me back under 9 kB.