chiark / gitweb /
blog.git
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.

7 years agotheme: ability to add a spacer into the bottom navigation.
Vladimír Vondruš [Sun, 3 Dec 2017 11:40:06 +0000 (12:40 +0100)]
theme: ability to add a spacer into the bottom navigation.

7 years agodoc: make it clear that Python 3 is required by the theme and plugins.
Vladimír Vondruš [Mon, 4 Dec 2017 18:17:04 +0000 (19:17 +0100)]
doc: make it clear that Python 3 is required by the theme and plugins.

7 years agotheme: let every page have its language
Paolo Miotto [Sun, 3 Dec 2017 16:10:58 +0000 (17:10 +0100)]
theme: let every page have its language

7 years agom.images: don't freak out if there's no EXIF.
Vladimír Vondruš [Fri, 1 Dec 2017 10:33:07 +0000 (11:33 +0100)]
m.images: don't freak out if there's no EXIF.

Instead it just doesn't display anything as a caption.

7 years agom.images: simplify code.
Vladimír Vondruš [Fri, 1 Dec 2017 10:23:57 +0000 (11:23 +0100)]
m.images: simplify code.

7 years agocss: avoid ugly vertical scrollbar for math in latest Chrome.
Vladimír Vondruš [Fri, 1 Dec 2017 10:22:48 +0000 (11:22 +0100)]
css: avoid ugly vertical scrollbar for math in latest Chrome.

Not sure what's wrong there.

7 years agocss: fix uneven padding around the landing page cover image.
Vladimír Vondruš [Thu, 30 Nov 2017 17:54:35 +0000 (18:54 +0100)]
css: fix uneven padding around the landing page cover image.

It felt off.

7 years agodoc: improve docs about the include directive.
Vladimír Vondruš [Thu, 30 Nov 2017 17:47:58 +0000 (18:47 +0100)]
doc: improve docs about the include directive.

7 years agocss: updated postprocessed CSS files.
Vladimír Vondruš [Thu, 30 Nov 2017 17:47:33 +0000 (18:47 +0100)]
css: updated postprocessed CSS files.

7 years agocss: overlap page cover and content a bit.
Vladimír Vondruš [Thu, 30 Nov 2017 17:45:01 +0000 (18:45 +0100)]
css: overlap page cover and content a bit.

So the transition is not so clearly visible.

7 years agocss: fix text alignment once more.
Vladimír Vondruš [Thu, 30 Nov 2017 17:06:12 +0000 (18:06 +0100)]
css: fix text alignment once more.

7 years agocss: make text alignment work properly in <th> elements.
Vladimír Vondruš [Sun, 26 Nov 2017 01:58:48 +0000 (02:58 +0100)]
css: make text alignment work properly in <th> elements.

7 years agoSupport for colored terminal output highlighting.
Vladimír Vondruš [Sun, 26 Nov 2017 01:56:01 +0000 (02:56 +0100)]
Support for colored terminal output highlighting.

7 years agom.code: patch the builtin include directive for our code support.
Vladimír Vondruš [Sun, 26 Nov 2017 01:52:11 +0000 (02:52 +0100)]
m.code: patch the builtin include directive for our code support.

Uglyyyy.

7 years agocss: all <pre> tags should be treated equally for inflating.
Vladimír Vondruš [Thu, 23 Nov 2017 13:08:44 +0000 (14:08 +0100)]
css: all <pre> tags should be treated equally for inflating.

7 years agocss: copypaste error.
Vladimír Vondruš [Thu, 23 Nov 2017 13:07:45 +0000 (14:07 +0100)]
css: copypaste error.

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

7 years agom.htmlsanity: properly use DEFAULT_LANG and :lang: metadata.
Vladimír Vondruš [Wed, 29 Nov 2017 23:29:29 +0000 (00:29 +0100)]
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.

7 years agom.htmlsanity: use double quotes for text.
Vladimír Vondruš [Wed, 29 Nov 2017 23:25:01 +0000 (00:25 +0100)]
m.htmlsanity: use double quotes for text.

7 years agom.htmlsanity: don't fail so hard if Pyphen is not available.
Vladimír Vondruš [Wed, 29 Nov 2017 23:23:22 +0000 (00:23 +0100)]
m.htmlsanity: don't fail so hard if Pyphen is not available.

7 years agodoc: this won't work if the path does not exist yet.
Vladimír Vondruš [Wed, 29 Nov 2017 21:11:17 +0000 (22:11 +0100)]
doc: this won't work if the path does not exist yet.

7 years agoMinor README updates.
Vladimír Vondruš [Wed, 29 Nov 2017 21:11:02 +0000 (22:11 +0100)]
Minor README updates.

7 years agodox: fix latex2svg.py path.
Vladimír Vondruš [Sat, 18 Nov 2017 17:42:39 +0000 (18:42 +0100)]
dox: fix latex2svg.py path.

7 years agocss: update the compiled CSS files.
Vladimír Vondruš [Sat, 18 Nov 2017 17:19:32 +0000 (18:19 +0100)]
css: update the compiled CSS files.

7 years agodoc: use native reST anchors.
Vladimír Vondruš [Sat, 18 Nov 2017 17:17:12 +0000 (18:17 +0100)]
doc: use native reST anchors.

7 years agocss: code blocks are now darker instead of lighter.
Vladimír Vondruš [Sat, 18 Nov 2017 17:12:58 +0000 (18:12 +0100)]
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!

7 years agocss: ability to disable the hover effect on tables.
Vladimír Vondruš [Sat, 18 Nov 2017 17:12:06 +0000 (18:12 +0100)]
css: ability to disable the hover effect on tables.

7 years agocss: new Badge component.
Vladimír Vondruš [Sat, 18 Nov 2017 17:11:12 +0000 (18:11 +0100)]
css: new Badge component.

7 years agocss: new Label component.
Vladimír Vondruš [Sat, 18 Nov 2017 16:08:58 +0000 (17:08 +0100)]
css: new Label component.

7 years agodoc: push for better semantics of notes and blocks.
Vladimír Vondruš [Sat, 18 Nov 2017 15:18:01 +0000 (16:18 +0100)]
doc: push for better semantics of notes and blocks.

7 years agocss: hint that two-column navbar should have successive numbering.
Vladimír Vondruš [Sat, 18 Nov 2017 14:17:44 +0000 (15:17 +0100)]
css: hint that two-column navbar should have successive numbering.

And apply that to the theme as well.

7 years agocss: make it possible to add a thinner subtitle to navbar brand.
Vladimír Vondruš [Sat, 18 Nov 2017 14:17:03 +0000 (15:17 +0100)]
css: make it possible to add a thinner subtitle to navbar brand.

7 years agocss: set the hamburger glyph in top navbar from CSS.
Vladimír Vondruš [Sat, 18 Nov 2017 14:10:44 +0000 (15:10 +0100)]
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.

7 years agodoc: improve the Writing Content section with more info and links.
Vladimír Vondruš [Fri, 10 Nov 2017 09:22:31 +0000 (10:22 +0100)]
doc: improve the Writing Content section with more info and links.

7 years agom.htmlsanity: apply hyphenation to everything in FORMATTED_FIELDS.
Vladimír Vondruš [Tue, 7 Nov 2017 17:16:21 +0000 (18:16 +0100)]
m.htmlsanity: apply hyphenation to everything in FORMATTED_FIELDS.

Instead of just the summary. Makes more sense.

7 years agotheme: better behaving category/author/tag list on jumbo articles.
Vladimír Vondruš [Tue, 7 Nov 2017 17:14:51 +0000 (18:14 +0100)]
theme: better behaving category/author/tag list on jumbo articles.

7 years agotemplate: deduplicate article footer markup.
Vladimír Vondruš [Tue, 7 Nov 2017 17:09:03 +0000 (18:09 +0100)]
template: deduplicate article footer markup.

7 years agom.htmlsanity: use a single global variable to save settings.
Vladimír Vondruš [Tue, 7 Nov 2017 16:51:03 +0000 (17:51 +0100)]
m.htmlsanity: use a single global variable to save settings.

7 years agocss: make figure work with lengthy caption or large images.
Vladimír Vondruš [Tue, 7 Nov 2017 15:35:40 +0000 (16:35 +0100)]
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.

7 years agosite: sane date formatting.
Vladimír Vondruš [Tue, 7 Nov 2017 15:31:52 +0000 (16:31 +0100)]
site: sane date formatting.

7 years agosite: fix publication.
Vladimír Vondruš [Mon, 6 Nov 2017 20:21:42 +0000 (21:21 +0100)]
site: fix publication.

7 years agoBetter credits for latex2svg.
Vladimír Vondruš [Mon, 6 Nov 2017 20:21:20 +0000 (21:21 +0100)]
Better credits for latex2svg.

Sorry!

7 years agodoc: document the author list in Page Layout section as well.
Vladimír Vondruš [Mon, 6 Nov 2017 17:24:33 +0000 (18:24 +0100)]
doc: document the author list in Page Layout section as well.

7 years agoRevert "css: better behaving background on short pages."
Vladimír Vondruš [Mon, 6 Nov 2017 17:22:25 +0000 (18:22 +0100)]
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.

7 years agotheme: make use of article.modified property.
Vladimír Vondruš [Mon, 6 Nov 2017 17:09:13 +0000 (18:09 +0100)]
theme: make use of article.modified property.

7 years agotheme: ability to optionally show also author list.
Vladimír Vondruš [Mon, 6 Nov 2017 16:55:44 +0000 (17:55 +0100)]
theme: ability to optionally show also author list.

7 years agotheme: remove unnecessary space.
Vladimír Vondruš [Mon, 6 Nov 2017 16:55:20 +0000 (17:55 +0100)]
theme: remove unnecessary space.

7 years agotheme: prefix also theme-related config with M_ to avoid confusion.
Vladimír Vondruš [Mon, 6 Nov 2017 16:53:15 +0000 (17:53 +0100)]
theme: prefix also theme-related config with M_ to avoid confusion.

Sorry. A fully breaking change for the Pelican theme.

7 years agosite: publish only what's needed from the theme.
Vladimír Vondruš [Sun, 5 Nov 2017 17:21:58 +0000 (18:21 +0100)]
site: publish only what's needed from the theme.

7 years agoUpdate bundled latex2svg from upstream.
Vladimír Vondruš [Sun, 5 Nov 2017 17:19:05 +0000 (18:19 +0100)]
Update bundled latex2svg from upstream.

7 years agoImprove documentation about additional dependencies.
Vladimír Vondruš [Sun, 5 Nov 2017 15:58:26 +0000 (16:58 +0100)]
Improve documentation about additional dependencies.

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

7 years agoMissing libgs warning (latex2svg.py) and generation failing.
gotchafr [Sat, 4 Nov 2017 13:05:23 +0000 (14:05 +0100)]
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
```