Template:News Timeline/doc: Difference between revisions
Created page with "<!-- Template:News Timeline/doc (transcluded into Global News, Domestic News and Character News) --> This is the shared documentation and TemplateData for the three news timeline templates. Each one adds a single table to an Era Nova year page. They are powered by Module:Timeline. == How to use == Put the template on a year page and give it the <code>Year</code>. Then fill in <b>only the days that had news</b>. Each day is one box; write one event per line: <pre..." |
mNo edit summary |
||
| Line 1: | Line 1: | ||
< | <includeonly><div class="aquila-feed-item"><div class="aquila-feed-title">[[{{{Page_Name}}}|{{#if:{{{Title|}}}|{{{Title}}}|{{#titleparts:{{{Page_Name}}}|1|-1}}}}]]</div><div class="aquila-feed-meta"><span class="aquila-feed-type">{{{Type|}}}</span> · <span class="aquila-feed-date" title="{{{RealDate|}}}">Era Nova, {{#invoke:Calendar|prettify|{{{Period|}}}}}, Year {{{YearNum|}}}</span></div></div></includeonly><noinclude>Row template used by [[Template:Character News List]]. Not meant to be used on its own.</noinclude> | ||
This is the shared documentation and TemplateData for the three news timeline templates. Each one | |||
=== PAGE: Template:News Timeline/doc === | |||
This is the shared documentation and TemplateData for the three news timeline templates ([[Template:Global News]], [[Template:Domestic News]], [[Template:Character News]]). Each adds one table to an Era Nova year page. They are powered by [[Module:Timeline]] and [[Module:Calendar]]. | |||
== How to use == | == How to use == | ||
<pre> | <pre> | ||
{{Global News | |||
| Year = 1 | |||
}} | |||
</pre> | </pre> | ||
That is all most year pages need: every post written with <code><nowiki>{{News Header}}</nowiki></code> appears here automatically, on the day its <code>RealDate</code> falls in, and days with nothing are merged into one row. | |||
=== Events that have no page of their own === | |||
For something staff-only (like "Era Nova Begins") fill in the day's box, one event per line: | |||
<pre> | |||
Post title; Character or nation; optional real-world date | |||
</pre> | |||
<pre> | <pre> | ||
{{Global News | {{Global News | ||
| Year = 1 | | Year = 1 | ||
| Day1 = | | Day1 = <span>Era Nova Begins</span> | ||
}} | }} | ||
</pre> | </pre> | ||
== | A plain name becomes a link automatically; wrap it in <code><nowiki><span>...</span></nowiki></code> to keep plain text. If a typed line is for a post that also has a page, the typed line is dropped so nothing appears twice. | ||
{ | |||
== Notes == | |||
* A post only appears if it uses <code><nowiki>{{News Header}}</nowiki></code> with a valid <code>RealDate</code>. | |||
* Year pages are cached: after a new post is saved, purge the year page to see it straight away. | |||
* <code>Auto=no</code> turns the automatic list off (handy for testing). | |||
<templatedata> | <templatedata> | ||
{ | { | ||
"description": "Adds one news section (Global, Domestic or Character) to an Era Nova year page. | "description": "Adds one news section (Global, Domestic or Character) to an Era Nova year page. Posts that use {{News Header}} are listed automatically; empty days are merged.", | ||
"params": { | "params": { | ||
"Year": { | "Year": { | ||
"label": "Lore year", | "label": "Lore year", | ||
"description": "The Era Nova year as a whole number (1, 2, 3...) | "description": "The Era Nova year as a whole number (1, 2, 3...).", | ||
"type": "number", | "type": "number", | ||
"required": true, | "required": true, | ||
| Line 84: | Line 47: | ||
}, | }, | ||
"Day1": { | "Day1": { | ||
"label": " | "label": "Extra events, day 1: Early January", | ||
"description": "One event per line | "description": "Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.", | ||
"type": "string", | "type": "string", | ||
"example": " | "example": "Era Nova Begins; High Council" | ||
}, | }, | ||
"Day2": { | "Day2": { | ||
"label": " | "label": "Extra events, day 2: January–February", | ||
"description": "One event per line | "description": "Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.", | ||
"type": "string", | "type": "string", | ||
"example": " | "example": "Era Nova Begins; High Council" | ||
}, | }, | ||
"Day3": { | "Day3": { | ||
"label": " | "label": "Extra events, day 3: February–March", | ||
"description": "One event per line | "description": "Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.", | ||
"type": "string", | "type": "string", | ||
"example": " | "example": "Era Nova Begins; High Council" | ||
}, | }, | ||
"Day4": { | "Day4": { | ||
"label": " | "label": "Extra events, day 4: March–April", | ||
"description": "One event per line | "description": "Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.", | ||
"type": "string", | "type": "string", | ||
"example": " | "example": "Era Nova Begins; High Council" | ||
}, | }, | ||
"Day5": { | "Day5": { | ||
"label": " | "label": "Extra events, day 5: April–May", | ||
"description": "One event per line | "description": "Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.", | ||
"type": "string", | "type": "string", | ||
"example": " | "example": "Era Nova Begins; High Council" | ||
}, | }, | ||
"Day6": { | "Day6": { | ||
"label": " | "label": "Extra events, day 6: May–June", | ||
"description": "One event per line | "description": "Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.", | ||
"type": "string", | "type": "string", | ||
"example": " | "example": "Era Nova Begins; High Council" | ||
}, | }, | ||
"Day7": { | "Day7": { | ||
"label": " | "label": "Extra events, day 7: June", | ||
"description": "One event per line | "description": "Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.", | ||
"type": "string", | "type": "string", | ||
"example": " | "example": "Era Nova Begins; High Council" | ||
}, | }, | ||
"Day8": { | "Day8": { | ||
"label": " | "label": "Extra events, day 8: June–July", | ||
"description": "One event per line | "description": "Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.", | ||
"type": "string", | "type": "string", | ||
"example": " | "example": "Era Nova Begins; High Council" | ||
}, | }, | ||
"Day9": { | "Day9": { | ||
"label": " | "label": "Extra events, day 9: July–August", | ||
"description": "One event per line | "description": "Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.", | ||
"type": "string", | "type": "string", | ||
"example": " | "example": "Era Nova Begins; High Council" | ||
}, | }, | ||
"Day10": { | "Day10": { | ||
"label": " | "label": "Extra events, day 10: August–September", | ||
"description": "One event per line | "description": "Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.", | ||
"type": "string", | "type": "string", | ||
"example": " | "example": "Era Nova Begins; High Council" | ||
}, | }, | ||
"Day11": { | "Day11": { | ||
"label": " | "label": "Extra events, day 11: September–October", | ||
"description": "One event per line | "description": "Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.", | ||
"type": "string", | "type": "string", | ||
"example": " | "example": "Era Nova Begins; High Council" | ||
}, | }, | ||
"Day12": { | "Day12": { | ||
"label": " | "label": "Extra events, day 12: October–November", | ||
"description": "One event per line | "description": "Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.", | ||
"type": "string", | "type": "string", | ||
"example": " | "example": "Era Nova Begins; High Council" | ||
}, | }, | ||
"Day13": { | "Day13": { | ||
"label": " | "label": "Extra events, day 13: November–December", | ||
"description": "One event per line | "description": "Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.", | ||
"type": "string", | "type": "string", | ||
"example": " | "example": "Era Nova Begins; High Council" | ||
}, | }, | ||
"Day14": { | "Day14": { | ||
"label": " | "label": "Extra events, day 14: Late December", | ||
"description": "One event per line | "description": "Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.", | ||
"type": "string", | |||
"example": "Era Nova Begins; High Council" | |||
}, | |||
"Auto": { | |||
"label": "Read posts automatically", | |||
"description": "Leave blank to list posts from the news database. Write 'no' to show only the lines typed here.", | |||
"type": "string", | "type": "string", | ||
" | "required": false, | ||
"suggestedvalues": [ | |||
"no" | |||
] | |||
} | } | ||
}, | }, | ||
| Line 183: | Line 155: | ||
"Day12", | "Day12", | ||
"Day13", | "Day13", | ||
"Day14" | "Day14", | ||
"Auto" | |||
] | ] | ||
} | } | ||
</templatedata> | </templatedata> | ||
Revision as of 09:43, 24 October 2026
Row template used by Template:Character News List. Not meant to be used on its own.
PAGE: Template:News Timeline/doc
This is the shared documentation and TemplateData for the three news timeline templates (Template:Global News, Template:Domestic News, Template:Character News). Each adds one table to an Era Nova year page. They are powered by Module:Timeline and Module:Calendar.
How to use
{{Global News
| Year = 1
}}
That is all most year pages need: every post written with {{News Header}} appears here automatically, on the day its RealDate falls in, and days with nothing are merged into one row.
Events that have no page of their own
For something staff-only (like "Era Nova Begins") fill in the day's box, one event per line:
Post title; Character or nation; optional real-world date
{{Global News
| Year = 1
| Day1 = <span>Era Nova Begins</span>
}}
A plain name becomes a link automatically; wrap it in <span>...</span> to keep plain text. If a typed line is for a post that also has a page, the typed line is dropped so nothing appears twice.
Notes
- A post only appears if it uses
{{News Header}}with a validRealDate. - Year pages are cached: after a new post is saved, purge the year page to see it straight away.
Auto=noturns the automatic list off (handy for testing).
Adds one news section (Global, Domestic or Character) to an Era Nova year page. Posts that use {{News Header}} are listed automatically; empty days are merged.
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| Lore year | Year | The Era Nova year as a whole number (1, 2, 3...).
| Number | required |
| Extra events, day 1: Early January | Day1 | Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.
| String | optional |
| Extra events, day 2: January–February | Day2 | Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.
| String | optional |
| Extra events, day 3: February–March | Day3 | Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.
| String | optional |
| Extra events, day 4: March–April | Day4 | Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.
| String | optional |
| Extra events, day 5: April–May | Day5 | Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.
| String | optional |
| Extra events, day 6: May–June | Day6 | Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.
| String | optional |
| Extra events, day 7: June | Day7 | Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.
| String | optional |
| Extra events, day 8: June–July | Day8 | Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.
| String | optional |
| Extra events, day 9: July–August | Day9 | Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.
| String | optional |
| Extra events, day 10: August–September | Day10 | Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.
| String | optional |
| Extra events, day 11: September–October | Day11 | Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.
| String | optional |
| Extra events, day 12: October–November | Day12 | Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.
| String | optional |
| Extra events, day 13: November–December | Day13 | Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.
| String | optional |
| Extra events, day 14: Late December | Day14 | Only for events that do NOT have their own page. Posts that use {{News Header}} appear automatically. One event per line: Post title; Character or nation; optional real-world date.
| String | optional |
| Read posts automatically | Auto | Leave blank to list posts from the news database. Write 'no' to show only the lines typed here.
| String | optional |