From: Vladimír Vondruš <mosra@centrum.cz>
Date: Mon, 1 Jan 2018 17:47:02 +0000 (+0100)
Subject: dox: mention the include directive among essentials.
X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~cjwatson/git?a=commitdiff_plain;h=b0b197fc0d333d0062017e3a51b0545b3871416f;p=blog.git

dox: mention the include directive among essentials.
---

diff --git a/doc/pelican/writing-content.rst b/doc/pelican/writing-content.rst
index 3456d4b3..599878cb 100644
--- a/doc/pelican/writing-content.rst
+++ b/doc/pelican/writing-content.rst
@@ -436,6 +436,10 @@ info about `inline markup <http://docutils.sourceforge.net/docs/ref/rst/restruct
 -   Sometimes you need to put raw HTML code onto your page (for example to
     embed a third-party widget). Use the `raw <http://docutils.sourceforge.net/docs/ref/rst/directives.html#raw-data-pass-through>`_
     directive to achieve that.
+-   For including larger portions of raw HTML code or bigger code snippets
+    there's the `include <http://docutils.sourceforge.net/docs/ref/rst/directives.html#including-an-external-document-fragment>`_
+    directive, you can also specify just a portion of the file either by line
+    numbers or text match.
 -   The `contents <http://docutils.sourceforge.net/docs/ref/rst/directives.html#contents>`_
     directive will automatically make a Table of Contents list out of headings
     in your document. Very useful for navigation in large pages and articles.