Template:TissueDB Simulator Build Phase/doc
Overview
[edit source]{{TissueDB Simulator Build Phase}} generates one build instruction phase for TissueDB simulator pages. This template auto-formats step numbering, applies verb-first bold formatting to action text, manages image placement with automatic divider insertion, and enforces Appropedia platform conventions for build instruction layout.
This template is used within the {{TissueDB Simulator Layout}} template's build_instructions parameter to structure multi-phase construction procedures. Each simulator page may contain multiple phase instances, numbered sequentially (Phase 1, Phase 2, etc.).
The template ensures consistent formatting across all TissueDB simulator pages and encodes build instruction best practices from the SELF Developer Playbook directly into page rendering.
Placement
[edit source]This template is placed inside the build_instructions parameter of {{TissueDB Simulator Layout}}. Do NOT place it at the top level of a simulator page. Example parent structure:
{{TissueDB Simulator Layout
| build_instructions =
{{TissueDB Simulator Build Phase
| phase_number = 1
| phase_title = Base Assembly
| step_1 = ...
}}
{{TissueDB Simulator Build Phase
| phase_number = 2
| phase_title = Layer Construction
| step_1 = ...
}}
}}
Parameters
[edit source]| Parameter | Type | Required | Description | Source |
|---|---|---|---|---|
| phase_number | Integer | Yes | Sequential phase number (1, 2, 3, etc.) for the heading level | SELF Developer Playbook (Jan 2026), Section 9.2, p. 51 |
| phase_title | String | Yes | Name of the phase (e.g. "Base Assembly", "Tissue Layer Construction"). Used in the heading === Phase N: Title === | SELF Developer Playbook (Jan 2026), Section 9.2, p. 51 |
| step_1 through step_12 | String | No | Verb-first action text for each step. Must begin with an action verb (Prepare, Cut, Mix, Assemble, Secure, Verify, Inspect, etc.). Include dimensions with metric first format: "25 cm (10 in)". Include verification checkpoints where applicable. | SELF Developer Playbook (Jan 2026), Section 9.3, p. 51–52; Dr. Mohr editorial directive |
| step_1_detail through step_12_detail | String | No | Additional description or context for the step. Used when the action text alone is insufficient. Appears on the line following the step number and action. | SELF Developer Playbook (Jan 2026), Section 9.3, p. 51–52 |
| step_1_image through step_12_image | String | No | Image filename (without the "File:" prefix). When supplied, the image is embedded below the step text with automatic <br clear="all" /> divider. Example: "TissueDB_Base_Assembly.png" renders as [[File:TissueDB_Base_Assembly.png|...]]
|
Platform convention (Sophivorus) |
| step_1_image_size through step_12_image_size | String | No | Image width in pixels (e.g. "250px", "300px", "400px"). Default: 250px. Used with the thumb parameter per build instruction image anchoring conventions.
|
Build step image anchoring convention |
| step_1_image_position through step_12_image_position | String | No | Image alignment: "left" or "right". Default: "left". Controls whether the image floats to the left or right of subsequent text. | Platform convention (Sophivorus) |
| step_1_caption through step_12_caption | String | No | Caption text displayed below the image. Should describe what the image shows or highlight the key action. | SELF Developer Playbook (Jan 2026), Section 9.3, p. 51–52 |
Content Rules
[edit source]Step Action Text
[edit source]- Every step MUST begin with an action verb in bold: Prepare, Cut, Mix, Assemble, Secure, Verify, Inspect, Position, Apply, Attach, Insert, etc.
- Step text is automatically prefixed with "Step N: " by the template.
- All dimensions MUST use metric-first format: "X cm (Y in)", "X kg (Y lbs)", "X mm (Y in)"
- Steps SHOULD include verification checkpoints where applicable: "Verify that the layer is uniformly 5 mm thick across the entire surface."
Prohibited Content
[edit source]- Usage instructions, operation procedures, or "how to use the simulator" text MUST NOT appear in build steps. Usage content belongs in SELF Modules only.
- Learning objectives, assessment criteria, or pedagogical instructions MUST NOT appear in build steps.
- Antiskill warnings MUST NOT appear in build steps — these belong in a separate section if source-traced.
Image Anchoring
[edit source]When an image parameter is supplied for a step, the template automatically inserts a <br clear="all" /> divider after the step text and before the next step. This divider anchors the image to its corresponding step, preventing the image from floating into unrelated text.
Examples
[edit source]Minimal Example (Two Steps, No Images)
[edit source]{{TissueDB Simulator Build Phase
| phase_number = 1
| phase_title = Base Assembly
| step_1 = Cut the foam base to 25 cm × 15 cm (10 in × 6 in).
| step_2 = Secure the foam to the wooden platform using contact adhesive.
}}
This renders as:
=== Phase 1: Base Assembly ===
Step 1: Cut the foam base to 25 cm × 15 cm (10 in × 6 in).
Step 2: Secure the foam to the wooden platform using contact adhesive.
Full Example (Three Steps with Images and Details)
[edit source]{{TissueDB Simulator Build Phase
| phase_number = 2
| phase_title = Tissue Layer Construction
| step_1 = Prepare the skin layer from silicone sheet.
| step_1_detail = Cut a 20 cm × 15 cm (8 in × 6 in) rectangle from 3 mm silicone sheet. Smooth all edges with fine 220-grit sandpaper.
| step_1_image = TissueDB_Example_Skin_Layer.png
| step_1_image_size = 300px
| step_1_image_position = right
| step_1_caption = Silicone skin layer cut to size with smoothed edges
| step_2 = Layer the subcutaneous fat simulation beneath the skin.
| step_2_detail = Position the 5 mm foam layer between the skin and the muscle layer. Verify uniform thickness across the entire surface.
| step_3 = Secure all layers with surgical adhesive along the perimeter.
| step_3_detail = Apply a 5 mm bead of two-part polyurethane adhesive around the outer edges. Allow 24 hours for full cure before proceeding.
}}
This renders as:
=== Phase 2: Tissue Layer Construction ===
Step 1: Prepare the skin layer from silicone sheet.
Cut a 20 cm × 15 cm (8 in × 6 in) rectangle from 3 mm silicone sheet. Smooth all edges with fine 220-grit sandpaper.
[[File:TissueDB_Example_Skin_Layer.png|thumb|300px|right|Silicone skin layer cut to size with smoothed edges]]
<br clear="all" />
Step 2: Layer the subcutaneous fat simulation beneath the skin.
Position the 5 mm foam layer between the skin and the muscle layer. Verify uniform thickness across the entire surface.
Step 3: Secure all layers with surgical adhesive along the perimeter.
Apply a 5 mm bead of two-part polyurethane adhesive around the outer edges. Allow 24 hours for full cure before proceeding.
Technical Notes
[edit source]Step Numbering
[edit source]The template automatically prefixes each step with "Step N: " where N is the sequential step number (1, 2, 3, etc. up to 12). Do NOT include "Step 1:" in the step_1 parameter — the template adds this automatically.
Heading Format
[edit source]The phase heading is rendered as a level-3 wiki heading: === Phase N: Title === where N is the phase_number parameter value.
Image Rendering
[edit source]Images are rendered with the thumb parameter and the pixel width from step_X_image_size. The position parameter (left/right) is applied to the wiki syntax. The caption parameter is used as the final caption text element.
Divider Behavior
[edit source]The <br clear="all" /> divider is inserted ONLY when a step has an step_X_image parameter defined. If no image is supplied, no divider is rendered. This prevents unnecessary whitespace in steps without images.
Empty Steps
[edit source]Parameters for steps 1–12 are optional. You may define only the steps needed for your phase. For example, a phase with 5 steps uses step_1 through step_5 and leaves step_6 through step_12 blank.
Template Data
[edit source]Generates one build instruction phase for TissueDB simulator pages with auto-formatted step numbering, verb-first formatting, image placement, and divider insertion.
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| Phase number | phase_number | Sequential phase number (1, 2, 3, etc.) | String | required |
| Phase title | phase_title | Name of the phase (e.g. 'Base Assembly', 'Tissue Layer Construction') | String | required |
| Step 1 action | step_1 | Verb-first action text for step 1 | String | optional |
| Step 1 detail | step_1_detail | Additional description for step 1 | String | optional |
| Step 1 image | step_1_image | Image filename (without 'File:' prefix) | String | optional |
| Step 1 image size | step_1_image_size | Image width (e.g. '250px', '300px'). Default: 250px
| String | optional |
| Step 1 image position | step_1_image_position | Image alignment: 'left' or 'right'. Default: left
| String | optional |
| Step 1 caption | step_1_caption | Caption text for step 1 image | String | optional |
| Step 2 action | step_2 | Verb-first action text for step 2 | String | optional |
| Step 2 detail | step_2_detail | Additional description for step 2 | String | optional |
| Step 2 image | step_2_image | Image filename (without 'File:' prefix) | String | optional |
| Step 2 image size | step_2_image_size | Image width. Default: 250px
| String | optional |
| Step 2 image position | step_2_image_position | 'left' or 'right'. Default: left
| String | optional |
| Step 2 caption | step_2_caption | Caption text for step 2 image | String | optional |
| Step 3 action | step_3 | Verb-first action text for step 3 | String | optional |
| Step 3 detail | step_3_detail | Additional description for step 3 | String | optional |
| Step 3 image | step_3_image | Image filename (without 'File:' prefix) | String | optional |
| Step 3 image size | step_3_image_size | Image width. Default: 250px
| String | optional |
| Step 3 image position | step_3_image_position | 'left' or 'right'. Default: left
| String | optional |
| Step 3 caption | step_3_caption | Caption text for step 3 image | String | optional |
| Step 4 action | step_4 | Verb-first action text for step 4 | String | optional |
| Step 4 detail | step_4_detail | Additional description for step 4 | String | optional |
| Step 4 image | step_4_image | Image filename (without 'File:' prefix) | String | optional |
| Step 4 image size | step_4_image_size | Image width. Default: 250px
| String | optional |
| Step 4 image position | step_4_image_position | 'left' or 'right'. Default: left
| String | optional |
| Step 4 caption | step_4_caption | Caption text for step 4 image | String | optional |
| Step 5 action | step_5 | Verb-first action text for step 5 | String | optional |
| Step 5 detail | step_5_detail | Additional description for step 5 | String | optional |
| Step 5 image | step_5_image | Image filename (without 'File:' prefix) | String | optional |
| Step 5 image size | step_5_image_size | Image width. Default: 250px
| String | optional |
| Step 5 image position | step_5_image_position | 'left' or 'right'. Default: left
| String | optional |
| Step 5 caption | step_5_caption | Caption text for step 5 image | String | optional |
| Step 6 action | step_6 | Verb-first action text for step 6 | String | optional |
| Step 6 detail | step_6_detail | Additional description for step 6 | String | optional |
| Step 6 image | step_6_image | Image filename (without 'File:' prefix) | String | optional |
| Step 6 image size | step_6_image_size | Image width. Default: 250px
| String | optional |
| Step 6 image position | step_6_image_position | 'left' or 'right'. Default: left
| String | optional |
| Step 6 caption | step_6_caption | Caption text for step 6 image | String | optional |
| Step 7 action | step_7 | Verb-first action text for step 7 | String | optional |
| Step 7 detail | step_7_detail | Additional description for step 7 | String | optional |
| Step 7 image | step_7_image | Image filename (without 'File:' prefix) | String | optional |
| Step 7 image size | step_7_image_size | Image width. Default: 250px
| String | optional |
| Step 7 image position | step_7_image_position | 'left' or 'right'. Default: left
| String | optional |
| Step 7 caption | step_7_caption | Caption text for step 7 image | String | optional |
| Step 8 action | step_8 | Verb-first action text for step 8 | String | optional |
| Step 8 detail | step_8_detail | Additional description for step 8 | String | optional |
| Step 8 image | step_8_image | Image filename (without 'File:' prefix) | String | optional |
| Step 8 image size | step_8_image_size | Image width. Default: 250px
| String | optional |
| Step 8 image position | step_8_image_position | 'left' or 'right'. Default: left
| String | optional |
| Step 8 caption | step_8_caption | Caption text for step 8 image | String | optional |
| Step 9 action | step_9 | Verb-first action text for step 9 | String | optional |
| Step 9 detail | step_9_detail | Additional description for step 9 | String | optional |
| Step 9 image | step_9_image | Image filename (without 'File:' prefix) | String | optional |
| Step 9 image size | step_9_image_size | Image width. Default: 250px
| String | optional |
| Step 9 image position | step_9_image_position | 'left' or 'right'. Default: left
| String | optional |
| Step 9 caption | step_9_caption | Caption text for step 9 image | String | optional |
| Step 10 action | step_10 | Verb-first action text for step 10 | String | optional |
| Step 10 detail | step_10_detail | Additional description for step 10 | String | optional |
| Step 10 image | step_10_image | Image filename (without 'File:' prefix) | String | optional |
| Step 10 image size | step_10_image_size | Image width. Default: 250px
| String | optional |
| Step 10 image position | step_10_image_position | 'left' or 'right'. Default: left
| String | optional |
| Step 10 caption | step_10_caption | Caption text for step 10 image | String | optional |
| Step 11 action | step_11 | Verb-first action text for step 11 | String | optional |
| Step 11 detail | step_11_detail | Additional description for step 11 | String | optional |
| Step 11 image | step_11_image | Image filename (without 'File:' prefix) | String | optional |
| Step 11 image size | step_11_image_size | Image width. Default: 250px
| String | optional |
| Step 11 image position | step_11_image_position | 'left' or 'right'. Default: left
| String | optional |
| Step 11 caption | step_11_caption | Caption text for step 11 image | String | optional |
| Step 12 action | step_12 | Verb-first action text for step 12 | String | optional |
| Step 12 detail | step_12_detail | Additional description for step 12 | String | optional |
| Step 12 image | step_12_image | Image filename (without 'File:' prefix) | String | optional |
| Step 12 image size | step_12_image_size | Image width. Default: 250px
| String | optional |
| Step 12 image position | step_12_image_position | 'left' or 'right'. Default: left
| String | optional |
| Step 12 caption | step_12_caption | Caption text for step 12 image | String | optional |