Embedding Content
Transclusion
Transclusion 1 allows the embedding of content of another document directly into your current document. Instead of embedding, one can link to the document, but the drawback to that is the break in reading flow.
Here is an example where the content of "Garage Bands vs Garage Labs" is embedded in this document. I also added the option to click to the original source inside the Transcluded document.
Garage Bands vs Garage Labs
Garages are for ...
Mechanics, for bands, or for creativity and invention
You know it's true.
Advantages
The Transcluded content can itself have a Transcluded section, like Russian dolls, one inside the other...indefinitely.
Here is an example of such a case.
The "Leitner Generic Review Schedule" transcludes that page.
Click on the sideways triangle, or on the description. You will see the contents of page "Leitner Generic Review Schedule."
Towards the bottom of that page, you will see anothe sideway triangle along with a description "Working In Public."
If you click on that, you will see the contents of the page "Working In Public," which in turn Transcludes "Factoring Cubic Polynomials".
Leitner Generic Review Schedule
Leitner Schedule
Example of a transclusion
"Working In Public" page is transcluded below directly in this page:
Note that "Working In Public" page is transcluding "Factoring Cubic Polynomials" page.
Working In Public
Write in Public
Let people see what you are doing.
The feedback is good for you.
It will help you create a better product.
but remember to study your math:
The End.
Transclusion allows the building of larger documents by taking smaller documents and stacking them. One, of course, can copy directly. But any changes would have to be made in every place the document was copied.
Change the original source and the changes propagate everywhere the document is embedded by Transclusion.
Three files within this one. Three layers deep in this case, but it can do deeper.
Cool, huh?
[1] Coined Ted Nelson ↩
WikiPedia: Transclusion