[Pitch] Adding Support for custom html elements in DocC

[Lucca-mito (Lucca de Mello)]

@N3v1

The current process for integrating custom headers and footers in DocC documentation is complex and not user-friendly.
[…]
Proposed solution
Automatic detection: The compiler will automatically identify […] files such as header.html and footer.html without requiring manual adjustments to the build process.

I believe that DocC already does exactly this (header.html, footer.html). Quoting @marcus_ortiz (source),

@marcus_ortiz

If you include the --experimental-enable-custom-templates flag when invoking docc convert, it will utilize the contents of a top-level header.html and/or footer.html file in your documentation catalog and inject it into the appropriate parts of the rendered documentation pages. This is lacking documentation at the moment due to its experimental nature.

Though the mechanism you’re proposing seems to be more general than that.

---

@N3v1

users will have the option to specify custom HTML files in a custom-scripts.json configuration file

If you’re referring to the custom-scripts.json proposed in this pitch, I’m not sure whether that would be the best place to declare custom HTML since that file is intended to declare custom scripts.