View source for Transclusionism

<div class="book">This page documents some of the contraptions at work in the Mondotheque wiki. The name "transclusionism" refers to the term "transclusion" coined by utopian systems humanist [[L'UTOPISTE|Ted Nelson]] and used in Mediawiki to refer to inclusion of the same piece of text in between different pages.</div>

== How to transclude labelled sections between texts: ==

To create transclusions between different texts, you need to select a section of text that will form a connection between the pages, based on a common subject:

* Think of a category that is the common ground for the link. For example if two texts refer to a similar issue or specific concept (eg. '<code>rawdata</code>'), formulate it '''without spaces''' or using underscores (eg. '<code>raw_data</code>', not '<code>raw data</code>' );
* Edit the two or more pages which you want to link, adding <code><nowiki>{{RT|rawdata}}<section begin=rawdata /> </nowiki></code> before the text section, and  <code><nowiki><section end=rawdata /></nowiki></code> at the end (take care of the closing '<code>/></code>' );
* All text sections in other wiki pages that are marked up through the same common ground, will be transcluded in the margin of the text.

== How it shows up: ==
For example, this is how a transclusion from a labelled section from the [[Xanadu]] article on the wiki appears:
{{RT|xanadu}}

== How it works: ==

The <code><nowiki><section></nowiki></code> code is used by the 'Labeled Section Transclusion' extension, which looks for the tagged sections in a text, to transclude them into another text based on the assigned labels.

The <code><nowiki>{{RT|rawdata}} </nowiki></code> instead, creates the side links by transcluding the [[Template:RT]] page, substituting the word <code>rawdata</code> in its internal code, in place of <code>{{{1}}}</code>. This is the commented content of Template:RT:

<pre><nowiki>
#  Puts the trancluded sections in its own div:
<div class="side">
# Searches semantically for all the pages in the
# requested category, puts them in an array:                               
{{#ask:                                    
   [[Category:{{{1}}}]]|format=array | name=results
}}
# Starts a loop, going from 0 to the amount of pages
# in the array:
{{#loop: looper
 | 0                                                
 | {{#arraysize: results}}
# If the pagename of the current element of the array 
# is the same as the page calling the loop, it will skip 
# the page:
 | {{#ifeq: {{FULLPAGENAME:
       {{#arrayindex: results | {{#var:looper}}  }}
            }}
 |          {{FULLPAGENAME}}
 |
 |           {{#lst:
# Otherwise it searches through the current page in the 
# loop, for all the occurrences of labeled sections:
        {{#arrayindex: results | {{#var:looper}}  }}
 | {{{1}}}   }}
#  Adds a link to the current page in loop:
([[{{#arrayindex: results | {{#var:looper}}  }}]])
#  Adds some space after the page:
<br /><br />
#  End of pagename if statement:
   }}
#  End of loop:
}}
#  Closes div:
</div>
#  Adds the page to the label category:
[[category:{{{1}}}]]
</nowiki></pre>

== Necessaire ==

Currently, on top of MediaWiki and SemanticMediaWiki, the following extensions needed to be installed for the contraption to work:
* [https://www.mediawiki.org/wiki/Extension:Labeled_Section_Transclusion Labeled Section Transclusion]  to be able to select specific sections of the texts and make connections between them;
* [https://www.mediawiki.org/wiki/Extension:ParserFunctions Parser Functions] to be able to operate statements like <pre>if</pre> in the wiki pseudo-language;
* [https://www.mediawiki.org/wiki/Extension:Arrays Arrays] to create lists of objects, for example as a result of semantic queries;
* [https://www.mediawiki.org/wiki/Extension:Loops Loops] to loop between the arrays above;
* [https://www.mediawiki.org/wiki/Extension:Variables Variables] as it's needed by some of the above.

{{Revision}}
[[Category:Publication]]