Support - Include Plugin

Undraw Icon Design Re 9web

Support - Include Plugin

About

The include plugin is a external plugin that permits to compose a page with the content of another page.

How to enable it with Combostrap?

By default, the include plugin (ie section syntax) will not work with ComboStrap.

You need to disable the combo wiki heading component to enable it.

Why?: It does not work because the include plugin uses the standard Dokuwiki heading to be able to extract the content.

Example: Section Syntax

The include plugin permits adding the content of a section with the following syntax. 

{{section>reference#section&nodate&inline&noeditbtn}}

where:

  • inline will not create a section (Mandatory to not messed up the layout)
  • nodate will not print the data
  • noeditbtn should not create any edit button.

Support

Why an included Heading 1 does not appear?

If your page has a template with a main header, the heading 1 is captured to not show the title twice.

If you need to include an heading 1 in a Combostrap page, see this comment

Why do I see a title in the current metadata?

It's because Dokuwiki store it when the heading is disabled. 

public function header($text, $level, $pos)
{
        if (!isset($this->meta['title'])) {
            $this->meta['title'] = $text;
        }
        ...
}

Why is the layout messed up?

The include plugin does not always return a clean HTML. The browser will then make a best guess and the included parts may land in another region of the template.

See the issue 91 for the whole explanation.

Task Runner