Template:TissueDB Tissue Layout
Overview
[edit source]{{TissueDB Tissue Layout}} creates TissueDB Tissues pages for anatomical tissue types (skin, muscle, fascia, bone, blood vessels, connective tissue, organ tissues, and bodily fluids). It is part of the TissueDB project.
The layout template controls section ordering and headings. Content sections can use standalone section sub-templates ({{TissueDB Tissue Materials Table}}, {{TissueDB Tissue Simulation Requirements}}, etc.) or accept direct content.
Parameters
[edit source]Required
[edit source]| Parameter | Type | Description | Source |
|---|---|---|---|
| lead_paragraph | Wikitext | 100-150 words describing the tissue and its clinical significance. Metric-first format. | SELF Developer Playbook (Jan 2026) |
Hero Image
[edit source]| Parameter | Type | Description | Source |
|---|---|---|---|
| hero_image | String | Filename only (no "File:" prefix). Template assembles the full markup. | Platform convention (Sophivorus) |
| hero_image_caption | String | Caption displayed below the image. | Platform convention |
Content Sections
[edit source]| Parameter | Type | Section Heading | Sub-template | Source |
|---|---|---|---|---|
| materials | Wikitext/HTML | == Materials == | {{TissueDB Tissue Materials Table}} | SELF Playbook; DM-35; DM-TABLE-01 |
| antiskills | Wikitext | == Things to Look Out For == | {{TissueDB Tissue Antiskills}} | SELF Playbook; AP-0307-05; SIM-GATE-14 |
| related_structures | Wikitext | (no heading — inline prose) | None (direct content) | TEMPLATE_ARCHITECTURE_CANON.md |
| simulators | Wikitext | == Simulators == | {{TissueDB Tissue Simulators}} | SELF Playbook |
| simulation_requirements | Wikitext/HTML | == Simulation Requirements == | {{TissueDB Tissue Simulation Requirements}} | SELF Playbook; Dr. Mohr directive |
| overview | Wikitext | === Overview === (in At a Glance) | None | SELF Playbook |
| synonyms_text | Wikitext | === Synonyms === (in At a Glance) | None | SELF Playbook |
| clinical_context | Wikitext | === Clinical Context === (in Background) | {{TissueDB Tissue Clinical Context}} | SELF Playbook |
| related_structures_background | Wikitext | === Related Structures === (in Background) | None | TEMPLATE_ARCHITECTURE_CANON.md |
Section Order
[edit source]- Lead paragraph (no heading)
- == Materials == (via {{TissueDB Tissue Materials Table}})
- == Things to Look Out For == (via {{TissueDB Tissue Antiskills}})
- Related Structures (prose, no heading)
- == Simulators == (via {{TissueDB Tissue Simulators}})
- == Simulation Requirements == (via {{TissueDB Tissue Simulation Requirements}})
- == References ==
references is a real, declared parameter of this Layout. It defaults to <references />, so the reference list renders correctly whether or not a page passes it.
| Parameter | Description | Source |
|---|---|---|
| references | The reference list for the page. Optional. Defaults to <references />. Pass | references = <references /> to keep the page out of the hidden tracking category described below. |
Convention |
Why a page might pass it even though the default is identical. MediaWiki's Cite extension populates the hidden category Category:Pages with references but no references tag by scanning the page's own wikitext, before templates are expanded. A tag that comes from a template body — including this template's default — is invisible to that scan. So a page carrying <ref> tags but not passing this parameter renders perfectly and still appears in that category. Passing the literal tag is what removes it. An empty | references = does not work; the literal tag must be the value.
Both choices are valid and neither is a defect. Material pages generally pass it (38 of 100, per goal G-106). Tissue and Structure pages generally do not, and goal G-111 verified that their listing in the category is a false positive: each renders exactly one reference list with zero cite errors.
⚠ Do not delete this parameter from a page that has it. In May 2026 an editor removed it from TissueDB/Materials/Plastic Film with the summary "not a Material Layout param; dropped by template". That was true at the time — the parameter was undeclared and discarded. It is now declared, so removing it silently returns the page to the tracking category.
History (goal G-117). Until 20 July 2026 this parameter was undeclared on the Material, Tissue and Structure Layouts: the templates emitted <references /> from their own body and threw any passed value away. That made the same construct required on Material pages and forbidden on Tissue pages. Declaring it with the tag as its default removed the contradiction without changing any page's rendering — A/B verified on three cases (passes and cited, omits and cited, omits and uncited): byte-identical output.
References
[edit source]Any tissue page that contains a <ref> tag must also carry | references = <references /> inside the Layout call.
This is not a template parameter. The Layout does not declare {{{references}}} and never transcludes the value — it already emits == References == and <references /> unconditionally, so the reference list renders correctly whether or not the page passes anything.
It is still required, because MediaWiki's Cite extension decides the hidden tracking category Category:Pages with references but no references tag by scanning the page's own wikitext before templates are expanded. A tag emitted by a template does not satisfy it, so a template cannot clear this category on a page's behalf. The literal text has to appear in the page source, and passing it as an inert references parameter is how TissueDB does that. An empty | references = does not work — the literal tag must be the value.
Measured 19 July 2026: 21 of the 79 tissue pages carrying <ref> tags were sitting in that tracking category for exactly this reason. Readers were never shown a broken page — the list rendered fine on all of them — but the category is how the wiki surfaces citation problems, so leaving pages in it makes a real signal useless.
The identical rule applies to Template:TissueDB Material Layout and Template:TissueDB Structure Layout.
Content Rules
[edit source]- No emoji section headers. SC-0319-01 REJECTED.
- Visual/Tactile columns use only: Yes, Partial, No. No rating scales (AP-0308-01).
- Section "Materials" not "Materials Quick-Pick" (DM-35).
- Section "Things to Look Out For" not "Avoid Antiskills" per canonical spec.
- No License Plate on Tissues pages. License Plate is Materials-only.
- All antiskill content must be source-traced (AP-0307-05, SIM-GATE-14).
- No internal codes on published pages (AP-0314-04).
- Metric-first format on all measurements.
- {{Page data}} is called at page level, NOT inside the layout template (Layer 0 principle).
- The
referencesparameter is optional. It defaults to<references />; passing it also clears the Cite tracking category. See the References section.
Placement
[edit source]The Tissue Layout is called directly in the page source. {{Synonym data}} and {{Page data}} are placed at page level after the Layout template closes.
{{TissueDB Tissue Layout
| lead_paragraph = '''Skin''' is the outermost anatomical barrier...
| hero_image = Skin_cross_section.png
| hero_image_caption = Cross-section of human skin layers
| materials =
{{TissueDB Tissue Materials Table
| rows =
<tr>
<td>[[TissueDB/Materials/Silicone|Silicone]]</td>
<td>Yes</td>
<td>Partial</td>
<td>[[TissueDB/Simulators/Z-Plasty Simulator|Z-Plasty Simulator]]</td>
<td>Good colour match for incision training</td>
</tr>
}}
| antiskills =
{{TissueDB Tissue Antiskills
| content = Materials that are too rigid may train excessive force...
}}
| simulators =
{{TissueDB Tissue Simulators
| content =
* [[TissueDB/Simulators/Z-Plasty Simulator|Z-Plasty Simulator]]
* [[TissueDB/Simulators/Foley Catheter Insertion Simulator|Foley Catheter Insertion Simulator]]
}}
| simulation_requirements =
{{TissueDB Tissue Simulation Requirements
| rows =
<tr>
<td>Visual</td>
<td>Colour match within one Munsell step...</td>
</tr>
<tr>
<td>Tactile</td>
<td>Shore hardness within 10% of published values...</td>
</tr>
}}
| overview = Brief tissue overview...
| synonyms_text = Integument, dermis, epidermis
| clinical_context =
{{TissueDB Tissue Clinical Context
| content =
==== Why Skin Simulation Matters ====
Accurate skin simulation is critical...
==== Key Anatomical Features to Simulate ====
Multi-layer structure, elastic recovery...
}}
| references = <references />
}}
{{Synonym data
| case = Skin, skin, SKIN
| regional = Peau (French), Piel (Spanish)
}}
{{Page data
| keywords = skin, tissue, simulation
| description = Simulation materials for skin tissue
| hide = yes
}}
Technical Notes
[edit source]- The template renders {{TissueDB tissue notice}} at the top of every Tissues page (Layer 1).
- {{Page data}} is NOT inside the layout template — it is placed at page level (Layer 0 principle).
- Collapsible sections (At a Glance, Background) use
mw-collapsibleMediaWiki classes. - The template automatically adds categories: TissueDB, Tissues.
- All tables inside section sub-templates use HTML (SC-0311-01), not wikitext tables.
- No
|pipe escaping anywhere (SC-0311-02).
Creates TissueDB Tissue pages for anatomical tissue types. Enforces canonical section order, references section sub-templates for structured content. Part of the TissueDB Composable Template Architecture.
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| Lead Paragraph | lead_paragraph | 100-150 words describing the tissue and clinical significance | Content | required |
| Hero Image | hero_image | Filename only (no File: prefix) | File | optional |
| Hero Image Caption | hero_image_caption | Caption below the image | String | optional |
| Materials | materials | Materials table content — use {{TissueDB Tissue Materials Table}} sub-template | Content | optional |
| Things to Look Out For | antiskills | Source-traced warnings — use {{TissueDB Tissue Antiskills}} sub-template | Content | optional |
| Related Structures | related_structures | Prose with wiki links to TissueDB/Structures/ pages (no heading) | Content | optional |
| Simulators | simulators | Simulator list — use {{TissueDB Tissue Simulators}} sub-template | Content | optional |
| Simulation Requirements | simulation_requirements | 4-Domain table — use {{TissueDB Tissue Simulation Requirements}} sub-template | Content | optional |
| Overview | overview | Brief overview for At a Glance section | Content | optional |
| Synonyms | synonyms_text | Alternative names for At a Glance section | Content | optional |
| Clinical Context | clinical_context | Clinical Context section — use {{TissueDB Tissue Clinical Context}} sub-template | Content | optional |
| Related Structures (Background) | related_structures_background | Detailed related structures for Background section | Content | optional |