Transclusion

[jmatsushita]

• Load index.md with prose
• Display transclusion with a special highlighting.
• Enable new toolbar icon ("Insert Content") when selected
  • When toolbar button is clicked, display list of local snippets (reuse media approach)
  • In addition to Insert, also have an "Edit" button that opens the transcluded file.
• Clicking preview runs hercule.
  • If there is an index.md file then preview uses it - to show local snippets in context.)
  • If the index.md file is a "redirect" then load that instead and run hercule.

Assembly test case

Use https://github.com/contentascode/fixture-assembly which contains:

  index.md    # with :[](snippet1) :[](snippet2)
  snippet1.md 
  snippet2.md

Next

Preview - ProseMirror

• Load index.md with prose
• Load index.md in ProseMirror
  • Use extension to display transclusion with a special symbol.
  • Allow to click symbol to edit transcluded file.

In Place

• Load index.md with Prose.
• Pre-process with hercule.
  • For each transcluded content, spin up a ProseMirror instance linked to the original md file. (Can children PM instances exist in a parent instance?)
• Modification in ProseMirror (not collaborative first) would be saved only on Prose commit (maybe adding a separate metadata file, hidden from Prose).

How about showing snippet1.md in its possible contexts? I guess the transclusion graph would need to be calculated and cached, to allow going up to the potential parents.

• Needs extending the document model / markdown parser.
• Use Graymatter for parsing frontmatter. https://github.com/jonschlinkert/gray-matter#optionslang ?