related topics
{system, computer, user}
{work, book, publish}
{math, number, function}
{theory, work, human}
{company, market, business}
{rate, high, increase}
{law, state, case}

In computer science, transclusion is the inclusion of a document or part of a document into another document by reference.

For example, an article about a country might include a chart or a paragraph describing that country's agricultural exports from a different article about agriculture. Rather than copying the included data and storing it in two places, a transclusion embodies modular design, by allowing it to be stored only once (and perhaps corrected and updated if the link type supported that) and viewed in different contexts. The reference also serves to link both articles.

The term was coined by hypertext pioneer Ted Nelson in 1982.


Technical considerations

Context neutrality

Transclusion works better when transcluded sections of text are self-contained, so that the meaning and validity of the text is independent of the context in which it appears. For example, formulations like "as explained in the previous section" are problematic, because the transcluded section may appear in a different context, causing confusion. What constitutes "context neutral" text varies, but often includes things like company information or boilerplate.


Under some circumstances, and in some technical contexts, transcluded sections of text may not require strict adherence to the "context neutrality" principle, because the transcluded sections are capable of parameterization. Parameterization implies the ability to modify certain portions or subsections of a transcluded text depending on exogenous variables that can be changed independently. This is customarily done by supplying a transcluded text with one or more substitution placeholders. These placeholders are then replaced with the corresponding variable values prior to rendering the final transcluded output in context.

History and implementation by Project Xanadu

Nelson (who had also originated the words "hypertext" and "hypermedia") coined the term "transclusion" in his 1982 book, Literary Machines. Part of his proposal was the idea that micropayments could be automatically exacted from the reader for all the text, no matter how many snippets of content are taken from various places.

Full article ▸

related documents
IBM 704
Dave Cutler (software engineer)
Wiki software
Z3 (computer)
UserLand Software
Context menu
Pseudonymous remailer
Display PostScript
OpenGL Utility Toolkit
Program counter
CHS conversion
Phil Katz
Korn shell
Links (web browser)
ISO 7816
Fiber distributed data interface
Line editor
32-bit application
Fluent, Inc.
Wide area information server
Motorola 88000
Distributed-queue dual-bus