Add and intercept options disabled self-contained and standalone

[TomAugspurger]

• [ ] Add command line options to override the default standalone & self-contained.

By default, pandoc produces document fragments for HTML (no header / footer), pdf, epub, epub3, fb2, docx all are standalone by default.

related options

• --self-contained

  Produce a standalone HTML file with no external dependencies, using data: URIs to incorporate the contents of linked scripts, stylesheets, images, and videos. The resulting file should be “self-contained,” in the sense that it needs no external files and no net access to be displayed properly by a browser. This option works only with HTML output formats, including html, html5, html+lhs, html5+lhs, s5, slidy, slideous, dzslides, and revealjs. Scripts, images, and stylesheets at absolute URLs will be downloaded; those at relative URLs will be sought relative to the working directory (if the first source file is local) or relative to the base URL (if the first source file is remote). Limitation: resources that are loaded dynamically through JavaScript cannot be incorporated; as a result, --self-contained does not work with --mathjax, and some advanced features (e.g. zoom or speaker notes) may not work in an offline “self-contained” reveal.js slide show.

---

Thoughts: standalone is nice for easily generating output that you can share. R Markdown outputs standalone HTML by default, and I think that's the right choice.

[TomAugspurger]

I was confusing self-contained and standalone in my head. For reference

• standalone: whether you make a document fragment (e.g. no HTML header, etc.)
• self-contained: How assets like images, css are handled. Links or inlined as data:

We'll be standalone and self-contained by default. We'll define a couple new command-line arguments --no-standalone and --no-self-contained if you want to generate those kinds of output.

Every image will get wrapped in an Image tag,

[Image(['', [], []], [Str("")], [data, ""])]

If we're self-contained then data is base64 png or svg, e.g. data:image/png;base64,{data} If we're not self-contained then data is a file path, where we've written the png / svg / whatever.