Changes between Version 35 and Version 36 of TracDev/Proposals/AdvancedWikiFormatting

Timestamp:

Jul 14, 2010, 11:47:48 PM (14 years ago)

Author:

Christian Boos

Comment:

start a section on #Transclusion

TracDev/Proposals/AdvancedWikiFormatting

@@ -129 +129 @@
 ==== Alternative forms of linking ==== #linking
 
- - shorthand for `[[Image(<img>)]]`: `{{<img>}}`, see MoinMoin:HelpOnLinking; `{{...}}` is also used for [MediaWiki:Help:Template transclusion] in MediaWiki
+ - shorthand for `[[Image(<img>)]]`: `{{<img>}}`, see MoinMoin:HelpOnLinking; `{{...}}` will also be used for [#Transclusion transclusion]
  - shorthand for footnotes? see #9037
 
@@ -166 +166 @@
  - others?
 
+== The really advanced stuff...
+
+(Most likely post-0.13)
+
+=== Transclusion
+
+The basic idea is that the content of a Wiki page can be reused and displayed in some other places, typically another wiki page which aggregates the content of several other pages.
+
+One typical use case is to transclude a parametric page used as a template (`Template:` namespace - #3021). In order to be really useful, this implies having wiki variables, and some control structures (at the very least simple conditionals).
+
+Also, we could have ways to include only //parts// of a page, by using some kind of selector mechanism (XPath or CSS inspired?) on the WikiDom tree.
+
+Some existing implementations can serve as good starting points [http://twiki.org/cgi-bin/view/Codev/ParameterizedIncludes ParameterizedIncludes] in TWiki, [MediaWiki:Help:Template Template] in MediaWiki, [MoinMoin:HelpOnLinking#Embedding Embedding] and [MoinMoin:HelpOnMacros/Include Include] in MoinMoin and the [http://www.dokuwiki.org/plugin:include plugin:include] of DokuWiki.
+
+Trac could use both the `{{<resource>}}` syntax and a more explicit Include macro/WikiProcessor. The latter form would allow to pass "complex" parameters for template, e.g.
+{{{
+{{{#!include page="Template:ReleaseInfo" version="1.0"
+ {{{#!param name="description"
+ This version is feature complete, mind you.
+  - all existing tickets are implemented
+  - there are no known (or unknown) bugs
+  - there's even no feature left to be implemented, all is there
+ }}}
+}}}
+}}}
+Alternatively, the default content of the include processor could be made available to the  wiki variables present in the template in a special variable, e.g. "INCLUDE_CONTENT".
+
+Variables expansion could also be done using a dedicated syntax (e.g. `@INCLUDE_CONTENT@`, like [MoinMoin:HelpOnVariables MoinMoin] or [http://www.dokuwiki.org/plugin:templater plugin:templater] in dokuwiki), (to be continued...)
+
+See also #4468.