Support an output format that doesn't require running on a server

[tonyarnold]

Feature Name

Static Output

Description

I've been looking at using DocC for more general documentation that we ship with our apps. Unfortunately, this is not currently possible as the generated output of DocC is a javascript app that seems to require absolute URLs and references to resources (thus must be hosted on a server).

Motivation

I would really like to be able to open the generated documentation using a file:/// link locally on my machine.

This would allow me to ship a set of DocC generated tutorials and articles in my application's bundle as help documentation.

Importance

Currently, there doesn't seem to be a workaround for the "static" output still needing to be hosted on a server.

Alternatives Considered

No response

[schwa]

Generating a PDF of a docc project would be a fantastic way to discuss API with co-workers.

[robmathers]

I'd love to see either a "static" HTML option (anything that could be opened locally in a browser), as well as a PDF renderer. It would certainly help adoption in my company, and I suspect many others. We need the ability to share documents internally without a whole private web host infrastructure, as well as being able to share with customers who might want to see our SDK documentation without having Xcode available to open the archive. Public web hosting infrastructure isn't a great fit.

[muthuveerappanal]

The offline version of the documentation would be really useful to be used with the Apple's Books app (on the Mac / iOS) for bookmarking, adding notes and annotations as I continue to learn incrementally.

[wti]

The online docs do not support search for text other than symbols.

[quigs-stryker]

Having a non-hosted format would be very useful for including documentation in FDA-regulated software and avoid a lot of manual formatting/documenting.