khajavi / pandoc

Automatically exported from code.google.com/p/pandoc
GNU General Public License v2.0
0 stars 0 forks source link

Support for template/transclusion #290

Open GoogleCodeExporter opened 9 years ago

GoogleCodeExporter commented 9 years ago
http://plugins.jquery.com/project/markdown

## Transclusion

Transclusion is presenting the contents of one document (the referenced  
document) in another document (the referring document). You indicate a  
transclusion using a transclusion tag. The syntax for a transclusion tag  
is a path written between two curly braces as follows:

`{{mydocument.md}} -- convert and put mydocument.md in this document`
There are actually three different types of transclusions: standard  
transclusions, raw transclusions, and example transclusions.

A standard transclusion is specified as {{reference}}. The referenced  
document is processed as a normal Markdown document with all links and  
image references correctly resolved within the context (base and path)  
of the referenced document. Transitive transclusions are also resolved  
within the context of the referenced document. Recursive transclusions  
are checked and caught.

A raw transclusion is specified as {{!reference}}. The text from the  
referenced document replaces the transclusion tag but no further  
processing is performed. Raw transclusions are useful for simple text  
inclusion or for presenting source code between `<pre>...</pre>` tags.  
Since transitive transclusions are not resolved, recursive transclusions  
are not checked. You can include a document within itself as raw text.

An example transclusion is specified as {{%reference}}. The initial %  
character is removed and the transclusion tag is left in place. This is  
useful when writing about transclusions as we are doing in this guide.

Original issue reported on code.google.com by rea...@gmail.com on 15 Mar 2011 at 1:46