chiark / gitweb /
Vladimír Vondruš [Wed, 6 Dec 2017 21:47:10 +0000 (22:47 +0100)]
doxygen: assert more instead of ignoring things.
Vladimír Vondruš [Wed, 6 Dec 2017 21:46:51 +0000 (22:46 +0100)]
doxygen: reduce recursion a bit.
Vladimír Vondruš [Wed, 6 Dec 2017 20:56:01 +0000 (21:56 +0100)]
doxygen: don't overwrite stuff from included Doxyfiles.
Vladimír Vondruš [Wed, 6 Dec 2017 20:35:46 +0000 (21:35 +0100)]
doxygen: support one more level of Markdown headings.
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.
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.
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.
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.
Vladimír Vondruš [Wed, 6 Dec 2017 12:57:57 +0000 (13:57 +0100)]
doxygen: strip whitespace at the beginning of new inserted paragraph.
Vladimír Vondruš [Wed, 6 Dec 2017 12:56:01 +0000 (13:56 +0100)]
doxygen: fix 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.
Vladimír Vondruš [Mon, 4 Dec 2017 11:14:09 +0000 (12:14 +0100)]
css: batch file to postprocess all CSS files.
Vladimír Vondruš [Sat, 18 Nov 2017 17:42:00 +0000 (18:42 +0100)]
Initial implementation of the Doxygen theme generator.
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.
Vladimír Vondruš [Wed, 6 Dec 2017 12:02:31 +0000 (13:02 +0100)]
css: wtf.
Vladimír Vondruš [Wed, 6 Dec 2017 11:41:01 +0000 (12:41 +0100)]
theme: more flexibility for the footer navigation.
Vladimír Vondruš [Wed, 6 Dec 2017 11:36:58 +0000 (12:36 +0100)]
theme: ability to control article expansion and summary appearance.
Vladimír Vondruš [Wed, 6 Dec 2017 11:30:52 +0000 (12:30 +0100)]
doc: improve the article examples a bit.
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.
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.
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.
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.
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.
Vladimír Vondruš [Sun, 3 Dec 2017 13:32:49 +0000 (14:32 +0100)]
css: updated postprocessed files.
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.
Vladimír Vondruš [Sun, 3 Dec 2017 13:31:32 +0000 (14:31 +0100)]
css: save the whole command-line 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.
Vladimír Vondruš [Sun, 3 Dec 2017 11:40:06 +0000 (12:40 +0100)]
theme: ability to add a spacer into the bottom navigation.
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.
Paolo Miotto [Sun, 3 Dec 2017 16:10:58 +0000 (17:10 +0100)]
theme: let every page have its language
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.
Vladimír Vondruš [Fri, 1 Dec 2017 10:23:57 +0000 (11:23 +0100)]
m.images: simplify code.
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.
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.
Vladimír Vondruš [Thu, 30 Nov 2017 17:47:58 +0000 (18:47 +0100)]
doc: improve docs about the include directive.
Vladimír Vondruš [Thu, 30 Nov 2017 17:47:33 +0000 (18:47 +0100)]
css: updated postprocessed CSS files.
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.
Vladimír Vondruš [Thu, 30 Nov 2017 17:06:12 +0000 (18:06 +0100)]
css: fix text alignment once more.
Vladimír Vondruš [Sun, 26 Nov 2017 01:58:48 +0000 (02:58 +0100)]
css: make text alignment work properly in <th> elements.
Vladimír Vondruš [Sun, 26 Nov 2017 01:56:01 +0000 (02:56 +0100)]
Support for colored terminal output highlighting.
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.
Vladimír Vondruš [Thu, 23 Nov 2017 13:08:44 +0000 (14:08 +0100)]
css: all <pre> tags should be treated equally for inflating.
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.
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.
Vladimír Vondruš [Wed, 29 Nov 2017 23:25:01 +0000 (00:25 +0100)]
m.htmlsanity: use double quotes for text.
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.
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.
Vladimír Vondruš [Wed, 29 Nov 2017 21:11:02 +0000 (22:11 +0100)]
Minor README updates.
Vladimír Vondruš [Sat, 18 Nov 2017 17:42:39 +0000 (18:42 +0100)]
dox: fix latex2svg.py path.
Vladimír Vondruš [Sat, 18 Nov 2017 17:19:32 +0000 (18:19 +0100)]
css: update the compiled CSS files.
Vladimír Vondruš [Sat, 18 Nov 2017 17:17:12 +0000 (18:17 +0100)]
doc: use native reST anchors.
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!
Vladimír Vondruš [Sat, 18 Nov 2017 17:12:06 +0000 (18:12 +0100)]
css: ability to disable the hover effect on tables.
Vladimír Vondruš [Sat, 18 Nov 2017 17:11:12 +0000 (18:11 +0100)]
css: new Badge component.
Vladimír Vondruš [Sat, 18 Nov 2017 16:08:58 +0000 (17:08 +0100)]
css: new Label component.
Vladimír Vondruš [Sat, 18 Nov 2017 15:18:01 +0000 (16:18 +0100)]
doc: push for better semantics of notes and blocks.
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.
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.
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.
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.
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.
Vladimír Vondruš [Tue, 7 Nov 2017 17:14:51 +0000 (18:14 +0100)]
theme: better behaving category/author/tag list on jumbo articles.
Vladimír Vondruš [Tue, 7 Nov 2017 17:09:03 +0000 (18:09 +0100)]
template: deduplicate article footer markup.
Vladimír Vondruš [Tue, 7 Nov 2017 16:51:03 +0000 (17:51 +0100)]
m.htmlsanity: use a single global variable to save settings.
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.
Vladimír Vondruš [Tue, 7 Nov 2017 15:31:52 +0000 (16:31 +0100)]
site: sane date formatting.
Vladimír Vondruš [Mon, 6 Nov 2017 20:21:42 +0000 (21:21 +0100)]
site: fix publication.
Vladimír Vondruš [Mon, 6 Nov 2017 20:21:20 +0000 (21:21 +0100)]
Better credits for latex2svg.
Sorry!
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.
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.
Vladimír Vondruš [Mon, 6 Nov 2017 17:09:13 +0000 (18:09 +0100)]
theme: make use of article.modified property.
Vladimír Vondruš [Mon, 6 Nov 2017 16:55:44 +0000 (17:55 +0100)]
theme: ability to optionally show also author list.
Vladimír Vondruš [Mon, 6 Nov 2017 16:55:20 +0000 (17:55 +0100)]
theme: remove unnecessary space.
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.
Vladimír Vondruš [Sun, 5 Nov 2017 17:21:58 +0000 (18:21 +0100)]
site: publish only what's needed from the theme.
Vladimír Vondruš [Sun, 5 Nov 2017 17:19:05 +0000 (18:19 +0100)]
Update bundled latex2svg from upstream.
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.
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
```
Vladimír Vondruš [Sat, 4 Nov 2017 13:04:44 +0000 (14:04 +0100)]
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.
gotchafr [Sat, 4 Nov 2017 12:58:54 +0000 (13:58 +0100)]
Better locale name for date formatting.
gotchafr [Sat, 4 Nov 2017 12:58:15 +0000 (13:58 +0100)]
Correct text role error on pelican 3.7.1
Vladimír Vondruš [Thu, 2 Nov 2017 20:22:20 +0000 (21:22 +0100)]
site: minor conf updates.
Vladimír Vondruš [Thu, 2 Nov 2017 20:21:50 +0000 (21:21 +0100)]
doc: writing m.css in a typewriter font is *ugly*.
Vladimír Vondruš [Thu, 2 Nov 2017 20:21:03 +0000 (21:21 +0100)]
doc: this is not needed anymore.
Vladimír Vondruš [Thu, 2 Nov 2017 19:48:16 +0000 (20:48 +0100)]
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 :)
Vladimír Vondruš [Thu, 2 Nov 2017 19:44:38 +0000 (20:44 +0100)]
site: huh.
Vladimír Vondruš [Thu, 2 Nov 2017 19:44:21 +0000 (20:44 +0100)]
site: put my e-mail to the footer.
Yay! More spam!
Vladimír Vondruš [Thu, 2 Nov 2017 19:43:41 +0000 (20:43 +0100)]
theme: apply format_siteurl to all navbar and feed links.
So all URLs are absolute.
Vladimír Vondruš [Thu, 2 Nov 2017 19:42:43 +0000 (20:42 +0100)]
doc: document the format_siteurl Jinja2 filter better.
Vladimír Vondruš [Thu, 2 Nov 2017 19:23:32 +0000 (20:23 +0100)]
theme: ability to override which menu item is highlighted.
Vladimír Vondruš [Thu, 2 Nov 2017 19:13:54 +0000 (20:13 +0100)]
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.
Vladimír Vondruš [Thu, 2 Nov 2017 18:19:41 +0000 (19:19 +0100)]
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.
Vladimír Vondruš [Thu, 2 Nov 2017 17:57:10 +0000 (18:57 +0100)]
Doc++
Vladimír Vondruš [Thu, 2 Nov 2017 17:51:47 +0000 (18:51 +0100)]
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.
Vladimír Vondruš [Thu, 2 Nov 2017 16:33:36 +0000 (17:33 +0100)]
I fail at reST.
Even after seven months of writing it. Kill me.
Vladimír Vondruš [Wed, 1 Nov 2017 23:01:37 +0000 (00:01 +0100)]
site: new landing page dedicated for math features.
Vladimír Vondruš [Wed, 1 Nov 2017 22:56:44 +0000 (23:56 +0100)]
themes: omitting bold italic font was a bad idea.
Some other not really matching (slightly bolder) font was chosen
instead, making things ugly.
Vladimír Vondruš [Wed, 1 Nov 2017 22:55:18 +0000 (23:55 +0100)]
doc: fix and improve docs about math.
Vladimír Vondruš [Wed, 1 Nov 2017 22:53:17 +0000 (23:53 +0100)]
css: make hiding brand link on landing pages opt-in.
Not all landing pages repeat it, probably just one does that -- the
index one.
Vladimír Vondruš [Wed, 1 Nov 2017 22:44:44 +0000 (23:44 +0100)]
css: add .m-strong and .m-em classes.
Meant to help work around reST limitation of not being able to have
strong emphasis.