🍄Transclusion

Transclusion is a mechanism of including contents of other hyphae into one hypha.

Grammar

transclusion_line  ::= transclusion_token hypha_name LWS* [":" LWS* range LWS*]
transclusion_token ::= "<=" LWS+
hypha_name         ::= canonical_name | noncanonical_name
range              ::= id | (from_id two_dots to_id) | (from_id two_dots) | (two_dots to_id)
two_dots           ::= ".."

Examples

This is contents of hypha ‘goal’:

line 1
line 2
line 3

These are different transclusions of the hypha ⤵. Note that using that :-notation is not recommended because I'm planning on deprecating it in favor of a more semantic-oriented approach.

Full contents:
<= goal

Line 1 only:
<= goal : 1

Lines 1 and 2:
<= goal : 1..2

Heading of the page, lines 1 and 2:
<= goal : ..2

Lines 2 and 3:
<= goal : 2..3
<= goal : 2..

This is an actual transclusion of hypha Apple below. Note that Apple transcludes this very hypha, thus recursive transclusion happens. Recursive transclusion is limited.

apple

Mālum est pomum arboris “Malus pumila” ad familiam Rosacearum pertinentis, ex media Asia ortae, ad altitudinem plus 3 et minus 12 metrorum in climate temperato crescentis, vere florentis, autumno poma matura parientis. Ex omnibus Rosacearum fructibus mala latissime coluntur et facilius transportantur. Saepius cruda comeduntur; etiam coquuntur atque condimentis confecturisque servantur. Sucus praedulcis e malis expressus crudus bibitur et in pomacium sive “vinum malorum” fermentatur.

transclusion

Transclusion is a mechanism of including contents of other hyphae into one hypha.

Grammar

transclusion_line  ::= transclusion_token hypha_name LWS* [":" LWS* range LWS*]
transclusion_token ::= "<=" LWS+
hypha_name         ::= canonical_name | noncanonical_name
range              ::= id | (from_id two_dots to_id) | (from_id two_dots) | (two_dots to_id)
two_dots           ::= ".."

Examples

This is contents of hypha ‘goal’:

line 1
line 2
line 3

These are different transclusions of the hypha ⤵. Note that using that :-notation is not recommended because I'm planning on deprecating it in favor of a more semantic-oriented approach.

Full contents:
<= goal

Line 1 only:
<= goal : 1

Lines 1 and 2:
<= goal : 1..2

Heading of the page, lines 1 and 2:
<= goal : ..2

Lines 2 and 3:
<= goal : 2..3
<= goal : 2..

This is an actual transclusion of hypha Apple below. Note that Apple transcludes this very hypha, thus recursive transclusion happens. Recursive transclusion is limited.

apple

Mālum est pomum arboris “Malus pumila” ad familiam Rosacearum pertinentis, ex media Asia ortae, ad altitudinem plus 3 et minus 12 metrorum in climate temperato crescentis, vere florentis, autumno poma matura parientis. Ex omnibus Rosacearum fructibus mala latissime coluntur et facilius transportantur. Saepius cruda comeduntur; etiam coquuntur atque condimentis confecturisque servantur. Sucus praedulcis e malis expressus crudus bibitur et in pomacium sive “vinum malorum” fermentatur.

transclusion
Transclusion depth limit