Difference between revisions of "Transclusionism"

From Mondothèque

(How it works:)
(How to transclude labeled sections between texts:)
Line 5: Line 5:
 
To create links between different pages, based on some selection of text that somehow connects the pages on the bases of some common ground:
 
To create links between different pages, based on some selection of text that somehow connects the pages on the bases of some common ground:
 
* Think of a category that is the common ground for the link. (eg. '<code>rawdata</code>'), formulate it '''without spaces''' or using underscores (eg. '<code>raw_data</code>', not '<code>raw data</code>' );
 
* Think of a category that is the common ground for the link. (eg. '<code>rawdata</code>'), formulate it '''without spaces''' or using underscores (eg. '<code>raw_data</code>', not '<code>raw data</code>' );
* Edit the page and add <code><nowiki>{{RT|rawdata}}<section begin=rawdata /> </nowiki></code> before the text selection, and  <code><nowiki><section end=rawdata /></nowiki></code> at the end (take care of the '<code>/</code>', without it doesn't work);
+
* Edit the 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 '<code>/</code>', without it doesn't work);
* All the other text selections in other pages which are selected along the same common ground will be transcluded on the side of the text.
+
* All the text sections in other wiki pages which are selected along the same common ground will be transcluded on the side of the text.
 
 
  
 
===== How it works: =====
 
===== How it works: =====

Revision as of 10:47, 27 February 2016

This page documents some of the contraptions at work in this wiki.


How to transclude labeled sections between texts:

To create links between different pages, based on some selection of text that somehow connects the pages on the bases of some common ground:

  • Think of a category that is the common ground for the link. (eg. 'rawdata'), formulate it without spaces or using underscores (eg. 'raw_data', not 'raw data' );
  • Edit the 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 '/', without it doesn't work);
  • All the text sections in other wiki pages which are selected along the same common ground will be transcluded on the side of the text.
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, transcludes the Template:RT page, substituting the word rawdata in its internal code, in place of {{{1}}}. This is the commented content of Template:RT:

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

What links here