chiark / gitweb /
Vladimír Vondruš [Thu, 7 Dec 2017 17:21:08 +0000 (18:21 +0100)]
site: fix double-escaped URL.
Vladimír Vondruš [Thu, 7 Dec 2017 10:34:03 +0000 (11:34 +0100)]
doc: document the additional pain inflicted on macOS LaTeX users.
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.
Vladimír Vondruš [Thu, 7 Dec 2017 10:21:58 +0000 (11:21 +0100)]
theme: make the top navbar markup a bit more compact.
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.
Vladimír Vondruš [Thu, 7 Dec 2017 10:20:57 +0000 (11:20 +0100)]
doc: use the compiled CSS file in Doxygen test page.
Vladimír Vondruš [Thu, 7 Dec 2017 01:31:18 +0000 (02:31 +0100)]
css: I *am* stupid.
Vladimír Vondruš [Thu, 7 Dec 2017 01:14:09 +0000 (02:14 +0100)]
doxygen: doc++
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.
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.
Vladimír Vondruš [Wed, 6 Dec 2017 23:46:30 +0000 (00:46 +0100)]
doxygen: avoid useless warning.
Vladimír Vondruš [Wed, 6 Dec 2017 23:24:39 +0000 (00:24 +0100)]
doxygen: parsing <linebreak> tags.
Vladimír Vondruš [Wed, 6 Dec 2017 22:50:37 +0000 (23:50 +0100)]
doxygen: prevent add_wbr() from breaking HTML tags.
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.
Vladimír Vondruš [Wed, 6 Dec 2017 22:47:29 +0000 (23:47 +0100)]
doxygen: make the <p> stripper work with empty content.
Vladimír Vondruš [Wed, 6 Dec 2017 22:46:59 +0000 (23:46 +0100)]
doxygen: verify that empty table cells work.
Nope. It asserts.
Vladimír Vondruš [Wed, 6 Dec 2017 21:48:37 +0000 (22:48 +0100)]
doxygen: table parsing.
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*.