From 68e10be9357dd23aaa4148266a43c2eaf7ec6b96 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Vladim=C3=ADr=20Vondru=C5=A1?= Date: Sat, 4 Nov 2017 14:04:44 +0100 Subject: [PATCH] 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. --- doc/css/components-test.rst | 3 +++ doc/css/components.rst | 5 +++++ doc/css/grid.rst | 2 ++ doc/css/page-layout.rst | 4 ++++ doc/css/typography.rst | 2 ++ doc/plugins/components.rst | 10 ++++------ doc/plugins/images.rst | 7 +++++++ doc/plugins/links.rst | 1 - 8 files changed, 27 insertions(+), 7 deletions(-) diff --git a/doc/css/components-test.rst b/doc/css/components-test.rst index 3ab65557..1badc589 100644 --- a/doc/css/components-test.rst +++ b/doc/css/components-test.rst @@ -29,6 +29,9 @@ Test :breadcrumb: {filename}/css.rst CSS {filename}/css/components.rst Components +.. role:: html(code) + :language: html + Blocks ====== diff --git a/doc/css/components.rst b/doc/css/components.rst index cc8f19aa..4fdabc12 100644 --- a/doc/css/components.rst +++ b/doc/css/components.rst @@ -32,6 +32,11 @@ Components `« Typography <{filename}/css/typography.rst>`_ | `CSS <{filename}/css.rst>`_ | `Page layout » <{filename}/css/page-layout.rst>`_ +.. role:: css(code) + :language: css +.. role:: html(code) + :language: html + m.css provides a set of basic components for further improving the layout and display of authored content. diff --git a/doc/css/grid.rst b/doc/css/grid.rst index 0e16ab52..a3ccbf75 100644 --- a/doc/css/grid.rst +++ b/doc/css/grid.rst @@ -34,6 +34,8 @@ Grid system .. role:: css(code) :language: css +.. role:: html(code) + :language: html Inspired by `Bootstrap `_, the grid system is the heart of a responsive website layout. The `m-grid.css <{filename}/css.rst>`_ diff --git a/doc/css/page-layout.rst b/doc/css/page-layout.rst index e8f3e351..4ef34d8f 100644 --- a/doc/css/page-layout.rst +++ b/doc/css/page-layout.rst @@ -35,6 +35,10 @@ Page layout .. role:: raw-html(raw) :format: html +.. role:: css(code) + :language: css +.. role:: html(code) + :language: html .. role:: sh(code) :language: sh diff --git a/doc/css/typography.rst b/doc/css/typography.rst index 001552fc..a1b1242d 100644 --- a/doc/css/typography.rst +++ b/doc/css/typography.rst @@ -34,6 +34,8 @@ Typography .. role:: css(code) :language: css +.. role:: html(code) + :language: html Right after being responsive, typography is the second most important thing in m.css and so the most often used HTML elements are styled to make them look diff --git a/doc/plugins/components.rst b/doc/plugins/components.rst index a8e2ecbb..1d34db6a 100644 --- a/doc/plugins/components.rst +++ b/doc/plugins/components.rst @@ -32,14 +32,12 @@ Components `« HTML sanity <{filename}/plugins/htmlsanity.rst>`_ | `Pelican plugins <{filename}/plugins.rst>`_ | `Images » <{filename}/plugins/images.rst>`_ -.. role:: rst(code) - :language: rst - .. role:: html(code) :language: html - -.. role:: css(code) - :language: css +.. role:: py(code) + :language: py +.. role:: rst(code) + :language: rst Most of m.css `CSS components <{filename}/css/components.rst>`_ are exposed to Pelican via custom :abbr:`reST ` directives. Unlike with pure diff --git a/doc/plugins/images.rst b/doc/plugins/images.rst index 7f25bc9c..9bd69b31 100644 --- a/doc/plugins/images.rst +++ b/doc/plugins/images.rst @@ -32,6 +32,13 @@ Images `« Components <{filename}/plugins/components.rst>`_ | `Pelican plugins <{filename}/plugins.rst>`_ | `Math and code » <{filename}/plugins/math-and-code.rst>`_ +.. role:: css(code) + :language: css +.. role:: py(code) + :language: py +.. role:: rst(code) + :language: rst + Gives sane defaults to images and figures and provides a way to present beautiful image galleries. diff --git a/doc/plugins/links.rst b/doc/plugins/links.rst index f1b30191..265d3199 100644 --- a/doc/plugins/links.rst +++ b/doc/plugins/links.rst @@ -34,7 +34,6 @@ Links .. role:: py(code) :language: py - .. role:: rst(code) :language: rst -- 2.30.2