commit 832786

Commit `832786`

2026-08-30 15:05:30 Ralph Thesen: Add include example page

0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9

`/dev/null` .. `examples/include.md`
@@ 0,0 1,56 @@
+	# Include
+
+	[Include Documentation](/-/help/plugins#include)
+
+	The `{{include}}` embedding pulls another page, or a single section of it, into
+	the current page. The examples below all include
+	[[the sample page\|Examples/Include/Sample Page]].
+
+	## The whole page
+
+	```
+	{{include\|src=/Examples/Include/Sample Page}}
+	```
+
+	{{include\|src=/Examples/Include/Sample Page}}
+
+	## A single section
+
+	`section` is the heading anchor slug (lower case, spaces as dashes), matched
+	independently of the heading level. `children=true` (the default) pulls in the
+	subsections too, so this also brings along Sea Otters.
+
+	```
+	{{include\|src=/Examples/Include/Sample Page\|section=otters}}
+	```
+
+	{{include\|src=/Examples/Include/Sample Page\|section=otters}}
+
+	## A section, without its subsections or heading
+
+	`children=false` stops at the next subheading and `heading=false` drops the
+	section's own heading line, so this includes only the paragraph directly under
+	Otters.
+
+	```
+	{{include\|src=/Examples/Include/Sample Page\|section=otters\|children=false\|heading=false}}
+	```
+
+	{{include\|src=/Examples/Include/Sample Page\|section=otters\|children=false\|heading=false}}
+
+	## Things to watch out for
+
+	- Use absolute paths inside included content. Relative links and
+	attachments (`![](image.png)`) in the source resolve against the including
+	page, not the source page, so they break. Write `/Source/Page/image.png` in
+	anything meant to be included. That is why `src` above is written absolute as
+	well, though relative `src` (resolved against this page) also works.
+	- Headings from included content do not show up in this page's table of
+	contents.
+	- Do not combine a `{{DataTable}}` and an `{{include}}` on the same page; the
+	page's own DataTable can be left uninitialised. Keep them on separate pages.
+	- Includes nest at most 8 deep, and cycles (a page including itself, directly
+	or through a chain) are detected and reported rather than expanded.
+
+	See the [Include documentation](/-/help/plugins#include) for the full option
+	list.
`/dev/null` .. `examples/include/sample page.md`
@@ 0,0 1,19 @@
+	# Sample Page
+
+	This page has no purpose of its own. It exists so that [[Include]] can pull it
+	in, whole or one section at a time.
+
+	## Otters
+
+	Otters are semiaquatic mammals of the weasel family. They have dense fur,
+	webbed feet and spend much of their time in rivers, lakes and coastal waters.
+
+	### Sea Otters
+
+	Sea otters float on their backs and wrap themselves in kelp so they do not
+	drift apart while they sleep.
+
+	## Beavers
+
+	Beavers are large rodents that build dams and lodges, reshaping streams into
+	ponds. They are not otters, but they share the water.

Commit 832786

Commit `832786`