Composer Plugin

Compatible with DokuWiki

Angua

Creates a single page from a chosen directory. All files are included, so that you are able to print it or save it as single page. (Previous author: Michael Grosser)

Last updated on: 2016-02-02
Provides: Syntax
Repository: Source

This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.

Similar to include

Tagged with export, include

Needed for betadoku

By Dennis Ploeger

Current status

I took over the plugin from Michael, created a github repository so that everybody can use the plugin manager now and cleared up this page.

~~However, the plugin code hasn't been changed and I found incompatibilites or bugs at least in Anteater. I'm planning on updating the code and fixing the bugs.~~

The code has been fixed and should at least be compatible with Angua (that's what I tested). If somebody could give more information about other (mostly prior) releases.

I have removed the bug notes from this document and encourage everyone, that uses this plugin and finds bugs to report them over in the github issue tracker.

Of course, I also encourage everybody to send me pull requests that fix bugs.

Credits

Michael Grosser for the original plugin code
The authors of the indexmenu-plugin for the search algorithm
The authors of the page plugin for page inclusion (combine all to one).

Syntax

{{compose>a:b:c#3|absolute nons numbers:numbers_depth print resort}}

a:b:c	namespace
#3	how much levels to include
absolute	Try to include the files at the fitting header level where the plugin is executed
nons	dont include namespace nodes
numbers	numbering infront of headers (1.2.1 bla, bla…)
numbers_depth	how deep (e.g. 3 → level 4+5 don't get numbering)
print	print optimization = on
resort	Resort found pages

Examples

Combine all subpages and namespaces within one namespace

  {{compose>doku:controller}}

will print the content of all pages in this tree of the DokuWiki, without the namespacenodes (doku:controller , doku:controller:c, doku:controller:d)

doku:controller:a
doku:controller:b
  doku:controller:c:a
  doku:controller:c:b
  doku:controller:d:a
    doku:controller:d:c:b
  doku:controller:d:e

Print optimization, output numbers and restrict ot level 3

  {{compose>doku:controller#3 | print numbers 3}}

will print contents of all pages in doku:controller up till level 3, optimized for printing, and with numbering from headings level 5 to 3

1   doku:controller:a
2   doku:controller:b
3.1   doku:controller:c:a
3.2   doku:controller:c:b
4.1   doku:controller:d:a
        doku:controller:d:c:b - not included since > 3 level
4.2   doku:controller:d:e

Resorting

The resort-option resorts the found pages based on the following idea:

Sort by level. Lowest level goes first.
Sort directories (if nons hasn't been specified) by id
Put start-pages in front of other pages
Finally, sort the pages by id

Installation Instructions

Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.

Table of Contents