From b0b197fc0d333d0062017e3a51b0545b3871416f Mon Sep 17 00:00:00 2001
From: =?utf8?q?Vladim=C3=ADr=20Vondru=C5=A1?= <mosra@centrum.cz>
Date: Mon, 1 Jan 2018 18:47:02 +0100
Subject: [PATCH] dox: mention the include directive among essentials.

---
 doc/pelican/writing-content.rst | 4 ++++
 1 file changed, 4 insertions(+)

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.
-- 
2.30.2