This is an old revision of the document!
Wiki markup
This is a reference for formatting topic pages in DokuWiki. Use this while uploading or editing a page. For writing standards and the editorial process, see the Editorial guide.
1. Page metadata
Every topic page opens with a category badge and a metadata block. The metadata block drives status display, author attribution, and version tracking.
<WRAP catbadge>General Topics</WRAP> ====== Topic title ====== <WRAP meta> lead-authors: Firstname Lastname contributors: Firstname Lastname reviewers: Firstname Lastname version: 1.0 updated: 25 March 2026 sensitivity: Low ai-use: Content creation · Drafting · Claude Sonnet 4 (Anthropic) · Reviewed by: Firstname Lastname status: in-review </WRAP>
Status values: published · approved · in-review · draft · planned · backlog
2. Intro and insight blocks
The intro panel defines the topic. The insight block is invisible on the page but feeds the start page topic card.
<WRAP intro> One paragraph. Every sentence must be specific to this topic. </WRAP> <WRAP insight> One sentence, 120–160 characters, plain text only. No links, no markup. </WRAP>
The insight block should read as a hook for a reader who has not yet decided to open the page, not as a summary of the intro. Plain text only: no wiki links, no footnotes, no markup.
3. Callout and box blocks
Use <WRAP callout> for a highlighted key insight within a section. Use <WRAP box> for supplementary information that sits alongside the main text.
<WRAP callout> One sentence capturing the most important takeaway. Maximum 30 words. </WRAP>
<WRAP box> **Box title** Supporting content, examples, or definitions that are useful but not essential to the main argument. </WRAP>
4. Figures
Caption goes below the image, separated by a line break. Figure numbers are assigned automatically; use any placeholder number in the markup.
<WRAP figure>
{{image.webp?700|Alt text describing the image}}
**Figure 1.** Caption title.\\
//Extended description. Source: Author (Year).((Full APA reference.))//
</WRAP>
Image format: upload at 1400px wide. Use WebP for photographs and diagrams, PNG for screenshots and transparent images.
5. Tables
Table captions go above the table. Use <WRAP tablecap> for the caption.
<WRAP tablecap> **Table 1.** Caption title.\\ //Source: Author (Year).((Full APA reference.))// </WRAP> ^ Column heading ^ Column heading ^ | data | data | | data | data |
Include a source line only where there is a single authoritative source for the table as a whole. Do not add source lines for tables that synthesise content already cited within the cells. Figure and table numbers are assigned independently and automatically; the number in the markup is a placeholder.
6. Case cards
Each perspective subsection should include one to three case examples. Use <WRAP case> for each.
<WRAP case> **Country or region · Timescale** Description of the case. Two to four sentences. Cite sources inline.((Full APA reference.)) </WRAP>
7. Distinctions
The Distinctions and overlaps section uses <WRAP distinction> for each entry.
<WRAP distinction> **Term vs. term** Explanation of how the two concepts differ, and where they overlap. </WRAP>
8. Footnotes and references
References are added as inline footnotes. The References section heading and list are generated automatically; do not add them manually.
This is a claim that needs a source.((Author, A. (Year). Title of work. Publisher. https://doi.org/xxxxx))
Use APA 7th edition. Include a DOI or stable URL where available. Verify all sources before submitting.
9. Related topics
Related topics are written as direct DokuWiki links, not tag plugin syntax. Include 3–12 topics where the connection is substantive.
[[topics:resilience|Resilience]] · [[topics:markets|Markets]] · [[topics:flexibility_markets|Flexibility Markets]]
The full list of topic slugs is available from the start page.
10. Images
Upload images via the media manager. Use descriptive filenames in lowercase with hyphens: smart-grid-overview.webp, not IMG_4521.jpg. Always confirm the image licence permits use before uploading, and record the source and licence in the Attributions page.