wiki:include_plugin

include plugin

Include plugin page

This allows the contents of one page to be included in another. It is helpful here to ease the maintenance of sidebars and image maps by allowing changes to be made in one or two places rather than in every page they appear. This can also kludge pages for out-of-print works into other additional namespaces so that they can have the same sidebars, such as Quimen Keep.

One can simply write a page > link to the desired page to include its contents on the current page.

{{page>inclusions:core_works}}

Note that the results will vary depending on settings made on the Administration page. HârnWiki has several departures from plugin defaults with the aim of making the Works header icons entries brief. This means that, with current settings, a plugin-default display can be had with the following:

{{page>inclusions:core_works&header&footer&editbutton}}

Those and other flags may be set when including a page. Here are some that the present editor has found useful.

Sometimes it is desirable to show the first header from the included page, and sometimes not. The big difference apparent so far is what happens to the other headings on the page. For instance, this very page has itself been included on Editor plugins like so:

{{page>include_plugin&showheader&editbutton}}

For the positive case, either &header or &showheader may be used.

Note how what is Heading 1 on this standalone page becomes a Heading 2 on that page, and so on down the line. This effect is useful in this case, when a composite page is formed from several also-independent ones. It would not be desirable on a page like Atlas Keléstia IVAE-DX (Tavu), where—in addition to the main heading text being more tailored to one or the other atlas—the “Pages citing this work” heading needs to stay at h2 to match the general style.

This, as in the example above, shows a button allowing the user to edit the included page from the page on which it is included. It is very useful but does sometimes stack oddly with the other section-editing buttons.

The main thing is to remember that this otherwise-shown-by-default setting has been reversed in HârnWiki and that it saves a bit of hassle later to type it in now.

Abbreviated flags also work: &noeditbtn and &editbtn

The present editor doesn't have any use for the generated footer which includes things like the time modified, the user who modified it, etc. It's clutter that mars the invisibility of the inclusion that is often desired. So while this Administrator setting is unlikely to change, one can still include a &nofooter flag for insurance's sake. Indeed, several persist on the pages of the wiki from an earlier time.

This option is used in all of the Works: header icons so that they can all share a line rather than appear running down the page.

{{page>icons:cgi&inline}}
{{page>icons:kaldor&inline}}

Pages included inside Bootstrap Wrapper plugin tab controls utilize this flag as well. This can also be used in a table as a way of placing a multi-paragraph entry in a single cell. I don't think any examples persist in this wiki. Indeed, this section may have been the only one where that was in evidence, long ago.

  • wiki/include_plugin.txt
  • Last modified: 2023/02/18 06:44
  • by suedunham