I'm working on an internal documentation tool for our company in the form of a Mac/MacCatalyst app. The goal is to distribute this app to our team to help them during the development of our app.
I have a prototype where I can insert SwiftUI/UIKit components onto a WKWebView. The web view shows some documentation and includes working and interactive SwiftUI/UIKit components that are injected.
Right now, the WKWebView is loading basic HTML, but I'd love to start using docC instead. Is there a way to inject custom HTML, javascript, or ID tags into the built website so I can insert the native interactive components I'd like to display as part of the documentation?
The visual end of the DocC results is a single-page Javascript app that uses the Vue.js framework. The path to doing something like this would be to provide a variation of the docc-renderer app. The relevant project is GitHub - swiftlang/swift-docc-render: Web renderer for Swift-DocC documentation., the "dist" of which is bundled into Swift toolchains/etc.
Thanks for the quick response.
To be clear, you're suggesting forking the renderer to add support for what I'm looking for?
It's a path to get to what you're after. More than anything else, I wanted to make sure you knew it was a JS app providing the rendering dynamically, not a mechanism thats rendering static HTML that you can "adjust" or include other things into.
I'm not familiar in general with Vue.js, so I can't really provide any opinion on the level of effort to extend functionality within it, and if there's a good "plugin to get X feature" kind of thing, or if it's more of a "fork it all and do what you need" kind of app.