[[:start]]
====== Wiki markup ======

<WRAP intro>
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 [[about:guidelines|Editorial guide]].
</WRAP>


===== 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.

<code>
<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 · Date
status: in-review
</WRAP>
</code>

Status values: ''published'' · ''approved'' · ''in-review'' · ''draft'' · ''planned'' · ''backlog''

===== 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.

<code>
<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>
</code>

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.

===== 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.

<code>
<WRAP callout>
One sentence capturing the most important takeaway. Maximum 30 words.
</WRAP>
</code>

<code>
<WRAP box>
**Box title**

Supporting content, examples, or definitions that are useful but not essential to the main argument.
</WRAP>
</code>

===== Figures =====

Caption goes below the image, separated by a line break. Figure numbers are assigned automatically; use any placeholder number in the markup.

<code>
<WRAP figure>
{{image.webp?700|Alt text describing the image}}

**Figure 1.** Caption title.\\
//Extended description. Source: Author (Year).((Full APA reference.))//
</WRAP>
</code>

Image format: upload at 1400px wide. Use WebP for photographs and diagrams, PNG for screenshots and transparent images.

===== Tables =====

Table captions go above the table. Use ''%%<WRAP tablecap>%%'' for the caption.

<code>
<WRAP tablecap>
**Table 1.** Caption title.\\
//Source: Author (Year).((Full APA reference.))//
</WRAP>

^ Column heading ^ Column heading ^
| data | data |
| data | data |
</code>

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.

===== Case cards =====

Each perspective subsection should include one to three case examples. Use ''%%<WRAP case>%%'' for each.

<code>
<WRAP case>
**Country or region · Timescale**

Description of the case. Two to four sentences. Cite sources inline.((Full APA reference.))
</WRAP>
</code>

===== Distinctions =====

The Distinctions and overlaps section uses ''%%<WRAP distinction>%%'' for each entry.

<code>
<WRAP distinction>
**Term vs. term**

Explanation of how the two concepts differ, and where they overlap.
</WRAP>
</code>

===== Footnotes and references =====

References are added as inline footnotes. The References section heading and list are generated automatically; do not add them manually.

<code>
This is a claim that needs a source.((Author, A. (Year). Title of work. Publisher. https://doi.org/xxxxx))
</code>

Use APA 7th edition. Include a DOI or stable URL where available. Verify all sources before submitting.

===== Related topics =====

Related topics are written as direct DokuWiki links, not tag plugin syntax. Include 3–12 topics where the connection is substantive.

<code>
[[topics:resilience|Resilience]] · [[topics:markets|Markets]] · [[topics:flexibility_markets|Flexibility Markets]]
</code>

The full list of topic slugs is available from the [[start|start page]].

===== 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 [[about:attributions|Attributions]] page.