Jump to content

Template:TissueDB Tissues/doc

From Appropedia

TissueDB Tissue Template

[edit source]

This template structures tissue pages in the TissueDB namespace. It enforces consistent presentation of tissue properties, materials, simulation requirements, and clinical context across the knowledge base.

What This Template Does

[edit source]

The TissueDB Tissue template standardises the layout and required sections for all tissue pages. It:

  • Displays the lead paragraph with metric-first measurements and tissue properties
  • Organises the Materials table (5-column: Material | Visual | Tactile | Simulator | Notes)
  • Structures the "Things to Look Out For" section with source-traced clinical warnings
  • Manages Related Structures prose links
  • Displays the Simulation Requirements table (4-Domain: Visual | Tactile | Functional | Feedback)
  • Provides optional collapsed sections for Background information
  • Enforces metadata consistency via {{TissueDB Tissue}} and {{Page data}} templates
  • Integrates with Appropedia's VisualEditor via templatedata

Template must be used on all tissue pages. Failure to include it will cause page structure audits to fail.

Placement

[edit source]
  • Location: Always placed at the very top of the page, before the lead paragraph
  • Parent template: Pages do not nest inside other templates; this template is the page container
  • Example page structure: {{TissueDB Tissue|...}} → Lead paragraph → Materials table → Things to Look Out For → Related Structures → Simulation Requirements → Optional sections → Metadata templates → Categories

Parameters

[edit source]

All parameters must be supplied in the order shown below. Use wikitext markup within parameter values where needed (wiki links, tables, bold/italic formatting).

Parameter Required Type Description Example
tissue_description_lead Yes String Opening paragraph describing the tissue. Requirements: 100–150 words, metric-first measurements, tissue properties, clinically relevant context. Must be complete sentences, not bullet points. Important: This text flows directly into the body — do not include section headers. "Adipose tissue is a highly vascularised connective tissue composed of lipocyte clusters separated by fine collagen and elastic fibre networks. It is typically 2–8 cm thick in the peritoneal surface and appears yellow-orange to pale cream in colour. The texture is soft, compressible, and friable when handled roughly."
materials_table_rows Yes Wikitext Material Name | Yes/Partial/No | Yes/Partial/No | Simulator Name | Clinical use context. Column rules: Visual and Tactile accept only "Yes", "Partial", or "No" — no rating systems. "Simulator" is a wiki link to the TissueDB/Simulators/* page where this material is used. "Notes" describes clinical use context and practical guidance. Do NOT include a Recipe column — recipes belong on Materials pages, not Tissues. | Synthetic foam | Yes | Partial | [[TissueDB/Simulators/Abdominal_Exploration|Abdominal Exploration Simulator]] | Yellow foam for realistic texture match
things_to_look_out_for_section Yes String Source-traced clinical warnings. Requirements: Each warning must cite its source (published literature, expert review protocol, or documented clinical observation). Warnings without source attribution are prohibited. Bullet list format acceptable. Important: Use exact section title "Things to Look Out For" — not "Antiskills", "Avoid", or "Pitfalls". "* Fragility under tension: Adipose tissue tears easily if pulled, mimicking real peritoneal damage (ref: Surgical Anatomy Atlas, 4th ed, p. 52). * Colour variation: Fresh adipose appears paler than aged tissue; simulator should use yellowed foam to match intra-operative colour."
related_structures_links No String Prose paragraph with wiki links to related TissueDB/Structures/* pages. This is NOT a bulleted list, and it does NOT have a section header (== Related Structures ==). Write as flowing text. Example: "Adipose tissue surrounds and insulates several structures: the peritoneum, which contains it, and the blood vessels embedded within it." If no structures are relevant, omit this parameter. "This tissue surrounds the liver and interfaces with the peritoneal cavity."
visual_req Yes String Visual fidelity requirement (4-Domain Visual domain). Describe colour, surface texture, translucency, and visual distinctness from adjacent tissues. Example: "Pale to bright yellow, opaque, with fine granular surface. Must visually distinguish from muscle and peritoneum." "Pale to bright yellow, opaque, with fine granular surface texture. Must visually distinguish from muscle (red-pink) and peritoneum (shiny translucent)."
tactile_req Yes String Tactile fidelity requirement (4-Domain Tactile domain). Describe texture, firmness, compression behaviour, and handling properties. Example: "Soft, compressible, friable. Crumbles slightly when pinched firmly. Elastic recoil minimal (does not snap back)." "Soft, compressible, friable. Crumbles slightly when pinched firmly. Elastic recoil minimal — does not snap back after compression."
functional_req No String Functional fidelity requirement (4-Domain Functional domain). Describe mechanical properties relevant to surgical procedures: bleed behaviour, tear patterns, retraction, etc. Omit if tissue has minimal functional demand. Example: "Must bleed realistically when incised. Should tear in linear patterns, not ragged edges." "Must bleed realistically when incised (use red food colouring + glycerin). Should tear in linear patterns to mimic surgical scalpel cuts, not ragged edges."
feedback_req No String Feedback fidelity requirement (4-Domain Feedback domain). Describe haptic, auditory, or other sensory feedback during manipulation. Omit if not applicable. Example: "Should produce subtle crackling sound when compressed (mimics ice crystal formation in fatty tissue)." "Should produce subtle crackling sound when compressed (mimics cellular disruption in fatty tissue under trauma)."
at_a_glance_content No String Short summary for the collapsed "At a Glance" section. 50–75 words. Use bullet-point format. Example: "* Colour: pale yellow to orange * Texture: soft, friable, compressible * Density: low * Appearance: granular * Surgical significance: insulation, retraction" "* Colour: pale yellow to bright orange * Texture: soft, friable, compressible * Density: low * Appearance: granular surface * Surgical significance: insulation and tissue planes"
background_anatomical No String Anatomical description sub-section. Describe tissue structure, cellular composition, histology, location in body, and anatomical relationships. Metric-first. This appears in a collapsed Background section. Omit if not available. "Adipose tissue consists of lipocytes (fat cells) grouped in lobules, separated by fine collagen fibres (stroma) and blood vessels. Density ranges from 0.85–0.95 g/cm³. In the peritoneal cavity, it forms continuous networks 2–8 cm thick, interspersed with connective tissue septa."
background_clinical No String Clinical context sub-section. Describe tissue role in clinical procedures, surgical handling, pathology, and clinical significance. This appears in a collapsed Background section. Omit if not available. "During open abdominal surgery, adipose tissue serves as a natural retractor and insulator. Excessive manipulation or rough handling causes tissue fragmentation and increases infection risk. In obese patients, the tissue is thicker (10–15 cm) and more densely vascularised, increasing bleeding and complicating plane dissection."
background_biomechanical No String Biomechanical notes sub-section. Describe mechanical properties: elasticity, tensile strength, compression modulus, tear patterns, and structural behaviour under surgical stress. Omit if not available. "Adipose tissue exhibits non-linear viscoelasticity: elastic modulus approximately 0.1–0.2 MPa in compression (highly compressible). Tears along cellular boundaries rather than randomly. Experiences permanent deformation after heavy compression; does not fully rebound. Low tensile strength (ruptures easily if pulled)."
tissue_name No String Metadata: canonical tissue name for {{TissueDB Tissue}} template. Example: "Adipose Tissue" "Adipose Tissue"
clinical_role No String Metadata: clinical role and surgical significance. Example: "Insulation, retraction, tissue planes" "Insulation, retraction, tissue planes"
anatomical_location No String Metadata: body location(s) where tissue is found. Example: "Peritoneal surface, abdominal cavity, subcutaneous layer" "Peritoneal surface, abdominal cavity, subcutaneous layer"
related_structures_metadata No String Metadata: comma-separated list of related structure names (for search). Example: "Peritoneum, Blood Vessels, Liver, Intestines" "Peritoneum, Blood Vessels, Liver, Intestines"
page_keywords No String Metadata: comma-separated search keywords. Example: "adipose, fat tissue, peritoneal fat, insulation, simulator material" "adipose, fat tissue, peritoneal fat, insulation, simulator material, yellow foam"
page_description No String Metadata: one-sentence page summary for search results and metadata. Example: "A soft, compressible tissue that insulates organs and forms natural retraction planes in abdominal surgery." "A soft, compressible tissue that insulates organs and forms natural retraction planes in abdominal surgery."
page_hide No String Metadata: set to "yes" to hide stub pages from search results during development. Omit when page is publication-ready. Example: "yes" (during stub phase), omit entirely once content is complete. "yes"

Section Order

[edit source]

Pages using this template must follow this section order strictly:

  1. {{TissueDB Tissue|...}} — template invocation with all parameters
  2. Lead Paragraph — tissue_description_lead (no == header)
  3. == Materials ==
  4. == Things to Look Out For ==
  5. Related Structures prose (no == header)
  6. == Simulation Requirements ==
  7. At a Glance (optional, collapsed)
  8. Background (optional, collapsed parent with three sub-sections)
  9. {{TDB notice}}
  10. {{TissueDB Tissue}} metadata template
  11. {{Page data}} metadata template
  12. [[Category:...]] entries

Important: Do not add sections outside this list. Pedagogical content (learning objectives, assessment criteria, usage instructions) does NOT belong on tissue pages — that content belongs in separate learning modules.

Materials Table Column Rules

[edit source]

The Materials table uses a fixed 5-column structure:

  • Material — name of the material (can be a wiki link to TissueDB/Materials/*)
  • Visual — "Yes", "Partial", or "No" only. No rating systems, scales, or abbreviations.
  • Tactile — "Yes", "Partial", or "No" only. No rating systems, scales, or abbreviations.
  • Simulator — wiki link to TissueDB/Simulators/* page where this material is used; describes the specific simulator application context
  • Notes — human-readable description of clinical use context and practical guidance; sourced from published documentation, not invented

Prohibited columns: Recipe, Preparation, Instructions. These belong on Materials pages. Note: Reusable and Cost columns have been removed as they are not universal properties applicable to all tissue-simulating materials.

Fidelity rule: The "Visual" and "Tactile" columns reflect whether the material adequately simulates that sensory domain. "Partial" indicates the material simulates some but not all aspects (e.g., colour is correct but texture is not).

Simulation Requirements Table (4-Domain)

[edit source]

The Simulation Requirements table uses a 4-Domain format (mandatory columns: Visual, Tactile; optional columns: Functional, Feedback):

  • Visual — colour, opacity, surface texture, visual distinctness from adjacent tissues
  • Tactile — texture, firmness, compression behaviour, handling properties
  • Functional — (optional) mechanical behaviour: tear patterns, bleeding, retraction
  • Feedback — (optional) sensory feedback: sound, haptic response, resistance

All four domains need NOT be present. Tissues with weak functional or feedback demands can omit those columns. Always include Visual and Tactile.

Examples

[edit source]

Example 1: Minimal Stub

[edit source]
{{TissueDB Tissue
|tissue_description_lead=Muscle tissue (skeletal) is a contractile tissue composed of aligned myofibres. Colour ranges from pale red to deep crimson depending on fibre type and vascularisation. Texture is firm and elastic. In the peritoneal cavity, it appears as distinct muscle layers with visible connective tissue planes.
|materials_table_rows=
| Synthetic muscle (silicone sheet) | Yes | Yes | [[TissueDB/Simulators/Abdominal_Wall_Closure|Abdominal Wall Closure Simulator]] | Realistic tactile resistance and surgical feel
|-
| Pink/red sponge | Partial | Partial | [[TissueDB/Simulators/Basic_Incision|Basic Incision Trainer]] | Budget-friendly option for foundational training
|things_to_look_out_for_section=* '''Colour fading:''' synthetic muscle loses colour under prolonged UV exposure (store in opaque container). * '''Brittleness:''' aged silicone becomes brittle; replace if it cracks easily (ref: material safety data sheet).
|visual_req=Pale red to crimson, opaque, with visible fibre lines. Must visually distinguish from fat (yellow) and peritoneum (shiny).
|tactile_req=Firm, elastic, slight resistance to cutting. Recoils slightly after compression.
|tissue_name=Skeletal Muscle
|clinical_role=Contractile tissue, abdominal wall component
|anatomical_location=Abdominal wall layers, around organs
|page_keywords=muscle, skeletal muscle, myofibres, abdominal wall, resistance
|page_description=Firm, elastic tissue forming the abdominal wall and surrounding organs; critical for realistic surgical resistance.
|page_hide=yes
}}

Example 2: Full Entry (Adipose Tissue)

[edit source]
{{TissueDB Tissue
|tissue_description_lead=Adipose tissue is a highly vascularised connective tissue composed of lipocyte clusters separated by fine collagen and elastic fibre networks. It typically appears pale yellow to bright orange in colour and ranges from 2–8 cm thick in peritoneal locations. The texture is characteristically soft, compressible, and friable — it crumbles slightly when handled roughly and exhibits minimal elastic recoil. Adipose tissue serves critical functions in vivo: insulation, energy storage, and formation of natural tissue planes that surgeons use for blunt dissection. In simulator construction, the material choice directly impacts the fidelity of touch and visual feedback.
|materials_table_rows=
| Yellow polyurethane foam | Yes | Yes | [[TissueDB/Simulators/Abdominal_Exploration|Abdominal Exploration Simulator]] | Primary choice; realistic texture and colour match for peritoneal adipose
|-
| Synthetic foam (craft variety) | Partial | Partial | [[TissueDB/Simulators/Basic_Abdominal_Anatomy|Basic Abdominal Anatomy Trainer]] | Budget-friendly option; lower texture fidelity suitable for foundational training
|-
| Silicone sheets (pigmented yellow) | Yes | Partial | [[TissueDB/Simulators/Advanced_Dissection|Advanced Dissection Simulator]] | Excellent visual fidelity; less friable than foam, appropriate for advanced procedures
|-
| Packing peanuts | No | No | —— | Educational context only; inappropriate for surgical simulation due to poor tactile and visual fidelity
|things_to_look_out_for_section=* '''Fragility under tension:''' adipose tissue tears easily if pulled rather than bluntly dissected, accurately mimicking real peritoneal damage and the surgeon's need for careful handling (ref: Surgical Anatomy Atlas, 4th ed., p. 52). * '''Colour variation:''' fresh peritoneal adipose appears paler (cream to pale yellow) than aged tissue (bright yellow to orange); simulator colour should match the intended patient age and tissue state. * '''Friability and compression:''' adipose crumbles and compacts with rough handling, simulating real tissue fragmentation and the increased infection risk that results from excessive manipulation (ref: Open Surgery Manual, Section 4.3, "Tissue Handling Principles").
|related_structures_links=Adipose tissue surrounds and insulates several key structures: the [[TissueDB/Structures/Peritoneum|peritoneum]], which contains it, the [[TissueDB/Structures/Liver|liver]], around which it is abundant, and the [[TissueDB/Structures/Blood_Vessels|blood vessels]] embedded within its stroma. In obese patients, adipose tissue is significantly thicker and denser, affecting tissue plane dissection and blood vessel identification.
|visual_req=Pale yellow to bright orange, opaque, with fine granular surface texture. Must visually distinguish from muscle (red-pink, with visible fibres) and peritoneum (shiny, translucent, smooth). Colour varies with tissue age and patient metabolic state.
|tactile_req=Soft, compressible, friable. Crumbles slightly when pinched firmly. Elastic recoil is minimal — tissue does not snap back after compression. Should feel slippery to the touch (mimics peritoneal fluid coating).
|functional_req=Should bleed realistically when incised (synthetic adipose does not; use embedded food colouring + glycerin pocket or pre-soak foam in diluted red dye). Tears along tissue planes (natural cleavage lines) rather than in ragged edges, mimicking surgeon's expectation of linear incision paths. Provides minimal resistance to cutting — scalpel should pass through smoothly without drag.
|feedback_req=Subtle crackling or crunching sound when compressed heavily (mimics cellular disruption and ice crystal formation in fatty tissue under trauma). Slight resistance to blunt dissection, with clear "pop" sensation as tissue planes separate.
|at_a_glance_content=* '''Colour:''' pale yellow to bright orange, varies with age and metabolism * '''Texture:''' soft, friable, compressible * '''Density:''' low (0.85–0.95 g/cm³) * '''Appearance:''' granular surface with visible cell clusters * '''Surgical significance:''' insulation, tissue planes, retraction * '''Clinical challenge:''' excessive manipulation causes fragmentation and infection risk
|background_anatomical=Adipose tissue consists of lipocytes (mature fat cells) grouped in lobules, separated by fine collagen fibres (stroma) and abundant blood vessels. Density ranges from 0.85–0.95 g/cm³ depending on metabolic state. In the peritoneal cavity, adipose forms continuous networks 2–8 cm thick (measured in thin adults; up to 15 cm in obese patients), interspersed with connective tissue septa. Histologically, cells range from 50–100 µm in diameter; visible under low magnification as a "honeycomb" pattern.
|background_clinical=During open abdominal surgery, adipose tissue serves as a natural retractor and insulator, allowing surgeons to identify tissue planes using blunt dissection. Excessive manipulation or rough handling causes tissue fragmentation, increasing infection risk and complicating haemostasis. In obese patients, the tissue is thicker (10–15 cm) and more densely vascularised, increasing bleeding and complicating plane dissection. Adhesions (scar tissue) frequently form within adipose, especially after previous surgery; simulators should represent adhesions in repeat-surgery scenarios. The "mesentery" (fat and blood vessels surrounding bowel) is a distinct adipose structure with characteristic white striations; care must be taken not to confuse it with visceral peritoneum.
|background_biomechanical=Adipose tissue exhibits non-linear viscoelasticity with an elastic modulus of approximately 0.1–0.2 MPa in compression (highly compressible compared to muscle). Under tension, tissue tears along cellular boundaries rather than randomly; ultimate tensile strength is low (ruptures easily if pulled >10% beyond resting length). The tissue experiences permanent deformation after heavy compression and does not fully rebound (plastic deformation). Shear strength is very low, allowing blunt dissection; the tissue naturally separates along embryological planes defined by the stromal fibres. Hydration state affects properties: desiccated adipose becomes stiffer and more brittle; well-hydrated adipose remains soft and friable.
|tissue_name=Adipose Tissue
|clinical_role=Insulation, retraction, tissue planes, energy storage
|anatomical_location=Peritoneal surface, abdominal cavity, omentum, mesentery, subcutaneous layer
|related_structures_metadata=Peritoneum, Liver, Blood Vessels, Omentum, Mesentery, Intestines, Abdominal Wall
|page_keywords=adipose, fat tissue, peritoneal fat, insulation, tissue planes, retraction, lipocytes, omentum, mesentery, simulator material, yellow foam, polyurethane foam
|page_description=A soft, compressible tissue that insulates organs and forms natural dissection planes in abdominal surgery; critical fidelity requires attention to texture, colour, and fragility.
}}

Technical Notes

[edit source]
  • Metadata placement: All parameters prefixed with "page_" or "tissue_" or "clinical_" or "anatomical_" or "related_structures_metadata" are passed through to the underlying {{TissueDB Tissue}} and {{Page data}} templates. These do not appear directly on the rendered page but populate search indices and metadata.
  • Wiki links: Use standard wiki link syntax: display text. Always link tissue names to their TissueDB/Tissues/* pages when referenced in the lead paragraph or Background section.
  • Table formatting: The materials_table_rows use standard MediaWiki table syntax. Do not use HTML tags; use MediaWiki pipes (|) and vertical bars. Each row ends with |-.
    • Metric-first rule: All measurements must be metric-first (e.g., "2–8 cm (0.8–3.2 in)"). Omit imperial if measurement is not clinically relevant.
    • Source citations: All clinical warnings, anatomical claims, and biomechanical data must cite sources (literature, expert review protocols, or documented observation). Citations can be parenthetical (ref: Author, Year, p. XX) or superscript footnotes. Do NOT include unsourced claims.
    • VisualEditor support: The templatedata block enables this template to be edited in Appropedia's VisualEditor without needing to view raw wikitext. Parameters are grouped by section (Lead, Materials, Requirements, Background, Metadata) for easier navigation.

    Version History

    [edit source]
    • v1.2 (16 March 2026) — Added horizontal scroll wrappers around Materials and Simulation Requirements tables for mobile responsiveness. Wide tables scroll horizontally on narrow screens. No breaking changes.
    • v1.1 (14 March 2026) — Corrected Materials table from 6-column to 5-column: removed Reusable and Cost columns (not universal properties applicable to all tissue-simulating materials), added Simulator column (cross-references simulators using the material), renamed last column from "Best For" to "Notes" (describes clinical use context and practical guidance). Updated all examples and column documentation accordingly.
    • v1.0 (14 March 2026) — Initial template skeleton with 19 parameters, 6-column Materials table with Reusable and Cost columns, 4-Domain Simulation Requirements, three Background sub-sections, and complete /doc subpage. Follows Appropedia template documentation conventions. No Recipe column (recipes belong on Materials pages). Visual/Tactile columns accept only Yes/Partial/No. Enforces source-tracing for all clinical claims. Full metadata support via underlying templates.

    See Also

    [edit source]


Cookies help us deliver our services. By using our services, you agree to our use of cookies.