Jump to content

Template:TissueDB Simulator Build Phase/doc

From Appropedia

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.

Template parameters

ParameterDescriptionTypeStatus
Phase numberphase_number

Sequential phase number (1, 2, 3, etc.)

Stringrequired
Phase titlephase_title

Name of the phase (e.g. 'Base Assembly', 'Tissue Layer Construction')

Stringrequired
Step 1 actionstep_1

Verb-first action text for step 1

Stringoptional
Step 1 detailstep_1_detail

Additional description for step 1

Stringoptional
Step 1 imagestep_1_image

Image filename (without 'File:' prefix)

Stringoptional
Step 1 image sizestep_1_image_size

Image width (e.g. '250px', '300px'). Default: 250px

Default
250px
Stringoptional
Step 1 image positionstep_1_image_position

Image alignment: 'left' or 'right'. Default: left

Default
left
Stringoptional
Step 1 captionstep_1_caption

Caption text for step 1 image

Stringoptional
Step 2 actionstep_2

Verb-first action text for step 2

Stringoptional
Step 2 detailstep_2_detail

Additional description for step 2

Stringoptional
Step 2 imagestep_2_image

Image filename (without 'File:' prefix)

Stringoptional
Step 2 image sizestep_2_image_size

Image width. Default: 250px

Default
250px
Stringoptional
Step 2 image positionstep_2_image_position

'left' or 'right'. Default: left

Default
left
Stringoptional
Step 2 captionstep_2_caption

Caption text for step 2 image

Stringoptional
Step 3 actionstep_3

Verb-first action text for step 3

Stringoptional
Step 3 detailstep_3_detail

Additional description for step 3

Stringoptional
Step 3 imagestep_3_image

Image filename (without 'File:' prefix)

Stringoptional
Step 3 image sizestep_3_image_size

Image width. Default: 250px

Default
250px
Stringoptional
Step 3 image positionstep_3_image_position

'left' or 'right'. Default: left

Default
left
Stringoptional
Step 3 captionstep_3_caption

Caption text for step 3 image

Stringoptional
Step 4 actionstep_4

Verb-first action text for step 4

Stringoptional
Step 4 detailstep_4_detail

Additional description for step 4

Stringoptional
Step 4 imagestep_4_image

Image filename (without 'File:' prefix)

Stringoptional
Step 4 image sizestep_4_image_size

Image width. Default: 250px

Default
250px
Stringoptional
Step 4 image positionstep_4_image_position

'left' or 'right'. Default: left

Default
left
Stringoptional
Step 4 captionstep_4_caption

Caption text for step 4 image

Stringoptional
Step 5 actionstep_5

Verb-first action text for step 5

Stringoptional
Step 5 detailstep_5_detail

Additional description for step 5

Stringoptional
Step 5 imagestep_5_image

Image filename (without 'File:' prefix)

Stringoptional
Step 5 image sizestep_5_image_size

Image width. Default: 250px

Default
250px
Stringoptional
Step 5 image positionstep_5_image_position

'left' or 'right'. Default: left

Default
left
Stringoptional
Step 5 captionstep_5_caption

Caption text for step 5 image

Stringoptional
Step 6 actionstep_6

Verb-first action text for step 6

Stringoptional
Step 6 detailstep_6_detail

Additional description for step 6

Stringoptional
Step 6 imagestep_6_image

Image filename (without 'File:' prefix)

Stringoptional
Step 6 image sizestep_6_image_size

Image width. Default: 250px

Default
250px
Stringoptional
Step 6 image positionstep_6_image_position

'left' or 'right'. Default: left

Default
left
Stringoptional
Step 6 captionstep_6_caption

Caption text for step 6 image

Stringoptional
Step 7 actionstep_7

Verb-first action text for step 7

Stringoptional
Step 7 detailstep_7_detail

Additional description for step 7

Stringoptional
Step 7 imagestep_7_image

Image filename (without 'File:' prefix)

Stringoptional
Step 7 image sizestep_7_image_size

Image width. Default: 250px

Default
250px
Stringoptional
Step 7 image positionstep_7_image_position

'left' or 'right'. Default: left

Default
left
Stringoptional
Step 7 captionstep_7_caption

Caption text for step 7 image

Stringoptional
Step 8 actionstep_8

Verb-first action text for step 8

Stringoptional
Step 8 detailstep_8_detail

Additional description for step 8

Stringoptional
Step 8 imagestep_8_image

Image filename (without 'File:' prefix)

Stringoptional
Step 8 image sizestep_8_image_size

Image width. Default: 250px

Default
250px
Stringoptional
Step 8 image positionstep_8_image_position

'left' or 'right'. Default: left

Default
left
Stringoptional
Step 8 captionstep_8_caption

Caption text for step 8 image

Stringoptional
Step 9 actionstep_9

Verb-first action text for step 9

Stringoptional
Step 9 detailstep_9_detail

Additional description for step 9

Stringoptional
Step 9 imagestep_9_image

Image filename (without 'File:' prefix)

Stringoptional
Step 9 image sizestep_9_image_size

Image width. Default: 250px

Default
250px
Stringoptional
Step 9 image positionstep_9_image_position

'left' or 'right'. Default: left

Default
left
Stringoptional
Step 9 captionstep_9_caption

Caption text for step 9 image

Stringoptional
Step 10 actionstep_10

Verb-first action text for step 10

Stringoptional
Step 10 detailstep_10_detail

Additional description for step 10

Stringoptional
Step 10 imagestep_10_image

Image filename (without 'File:' prefix)

Stringoptional
Step 10 image sizestep_10_image_size

Image width. Default: 250px

Default
250px
Stringoptional
Step 10 image positionstep_10_image_position

'left' or 'right'. Default: left

Default
left
Stringoptional
Step 10 captionstep_10_caption

Caption text for step 10 image

Stringoptional
Step 11 actionstep_11

Verb-first action text for step 11

Stringoptional
Step 11 detailstep_11_detail

Additional description for step 11

Stringoptional
Step 11 imagestep_11_image

Image filename (without 'File:' prefix)

Stringoptional
Step 11 image sizestep_11_image_size

Image width. Default: 250px

Default
250px
Stringoptional
Step 11 image positionstep_11_image_position

'left' or 'right'. Default: left

Default
left
Stringoptional
Step 11 captionstep_11_caption

Caption text for step 11 image

Stringoptional
Step 12 actionstep_12

Verb-first action text for step 12

Stringoptional
Step 12 detailstep_12_detail

Additional description for step 12

Stringoptional
Step 12 imagestep_12_image

Image filename (without 'File:' prefix)

Stringoptional
Step 12 image sizestep_12_image_size

Image width. Default: 250px

Default
250px
Stringoptional
Step 12 image positionstep_12_image_position

'left' or 'right'. Default: left

Default
left
Stringoptional
Step 12 captionstep_12_caption

Caption text for step 12 image

Stringoptional


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