Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
about:markup [2026/03/28 01:15] – adminabout:markup [2026/03/28 01:41] (current) – admin
Line 7: Line 7:
  
  
-===== 1. Page metadata =====+===== 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. Every topic page opens with a category badge and a metadata block. The metadata block drives status display, author attribution, and version tracking.
Line 23: Line 23:
 updated: 25 March 2026 updated: 25 March 2026
 sensitivity: Low sensitivity: Low
-ai-use: Content creation · Drafting · Claude Sonnet 4 (Anthropic) · Reviewed by: Firstname Lastname+ai-use: Content creation · Drafting · Claude Sonnet 4 (Anthropic) · Reviewed by: Firstname Lastname · Date
 status: in-review status: in-review
 </WRAP> </WRAP>
Line 30: Line 30:
 Status values: ''published'' · ''approved'' · ''in-review'' · ''draft'' · ''planned'' · ''backlog'' Status values: ''published'' · ''approved'' · ''in-review'' · ''draft'' · ''planned'' · ''backlog''
  
-===== 2. Intro and insight blocks =====+===== 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. The intro panel defines the topic. The insight block is invisible on the page but feeds the start page topic card.
Line 46: Line 46:
 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. 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 =====+===== 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. Use ''%%<WRAP callout>%%'' for a highlighted key insight within a section. Use ''%%<WRAP box>%%'' for supplementary information that sits alongside the main text.
Line 64: Line 64:
 </code> </code>
  
-===== 4. Figures =====+===== Figures =====
  
 Caption goes below the image, separated by a line break. Figure numbers are assigned automatically; use any placeholder number in the markup. Caption goes below the image, separated by a line break. Figure numbers are assigned automatically; use any placeholder number in the markup.
Line 79: Line 79:
 Image format: upload at 1400px wide. Use WebP for photographs and diagrams, PNG for screenshots and transparent images. Image format: upload at 1400px wide. Use WebP for photographs and diagrams, PNG for screenshots and transparent images.
  
-===== 5. Tables =====+===== Tables =====
  
 Table captions go above the table. Use ''%%<WRAP tablecap>%%'' for the caption. Table captions go above the table. Use ''%%<WRAP tablecap>%%'' for the caption.
Line 96: Line 96:
 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. 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 =====+===== Case cards =====
  
 Each perspective subsection should include one to three case examples. Use ''%%<WRAP case>%%'' for each. Each perspective subsection should include one to three case examples. Use ''%%<WRAP case>%%'' for each.
Line 108: Line 108:
 </code> </code>
  
-===== 7. Distinctions =====+===== Distinctions =====
  
 The Distinctions and overlaps section uses ''%%<WRAP distinction>%%'' for each entry. The Distinctions and overlaps section uses ''%%<WRAP distinction>%%'' for each entry.
Line 120: Line 120:
 </code> </code>
  
-===== 8. Footnotes and references =====+===== Footnotes and references =====
  
 References are added as inline footnotes. The References section heading and list are generated automatically; do not add them manually. References are added as inline footnotes. The References section heading and list are generated automatically; do not add them manually.
Line 130: Line 130:
 Use APA 7th edition. Include a DOI or stable URL where available. Verify all sources before submitting. Use APA 7th edition. Include a DOI or stable URL where available. Verify all sources before submitting.
  
-===== 9. Related topics =====+===== Related topics =====
  
 Related topics are written as direct DokuWiki links, not tag plugin syntax. Include 3–12 topics where the connection is substantive. Related topics are written as direct DokuWiki links, not tag plugin syntax. Include 3–12 topics where the connection is substantive.
Line 140: Line 140:
 The full list of topic slugs is available from the [[start|start page]]. The full list of topic slugs is available from the [[start|start page]].
  
-===== 10. Images =====+===== 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. 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.