Difference between revisions of "Transclusionism"

From Mondothèque

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

Revision as of 16:51, 2 August 2016

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 Ted Nelson and used in Mediawiki to refer to inclusion of the same piece of text in between different pages.

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. 'rawdata'), formulate it without spaces or using underscores (eg. 'raw_data', not 'raw data' );
  • Edit the two or more pages which you want to link, adding {{RT|rawdata}}<section begin=rawdata /> before the text section, and <section end=rawdata /> at the end (take care of the closing '/>' );
  • 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:

From Xanadu:
Every document can contain links of any type including virtual copies ("transclusions") to any other document in the system accessible to its owner.

For example, this is how a transclusion from a labelled section from the Xanadu article on the wiki appears:

How it works:

The <section> 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 {{RT|rawdata}} instead, creates the side links by transcluding the Template:RT page, substituting the word rawdata in its internal code, in place of {{{1}}}. This is the commented content of Template:RT:

#  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}}}]]

Necessaire

Currently, on top of MediaWiki and SemanticMediaWiki, the following extensions needed to be installed for the contraption to work:

  • Labeled Section Transclusion to be able to select specific sections of the texts and make connections between them;
  • Parser Functions to be able to operate statements like
    if
    in the wiki pseudo-language;
  • Arrays to create lists of objects, for example as a result of semantic queries;
  • Loops to loop between the arrays above;
  • Variables as it's needed by some of the above.
Last Revision: 2·08·2016

What links here