Description
While working with creating the combined documentation for Swift, I'm explicitly doing a post-processing command the change the hosting base path, and found that it's regenerating a stripped stub for every symbol where the hosting base path changes, loosing any custom injected HTML header or footer data.
Checklist
Expected Behavior
I was anticipating that the first archive in the merge set would set the stage for the HTML included, and then the hosting base path could be adjusted without impacting what injected HTML content in each of the stubs.
Actual behavior
After docc convert (or docc merge), the resulting archive's index.html correctly contains custom-header/custom-footer templates. I expected process-archive transform-for-static-hosting to either preserve those templates in the per-route stubs it generates, or copy them through verbatim. Instead, every generated stub is a bare shell.
Steps To Reproduce
- create archive with customer header/footer
- apply a hosting base path
- view using python -m http.server with the relevant location reflected
- note the missing HTML
Swift-DocC Version Information
6.3.2
Swift Compiler Version Information
Apple Swift version 6.3.2 (swift-6.3.2-RELEASE)
Target: arm64-apple-macosx26.0
(also applicable on `main`)
Description
While working with creating the combined documentation for Swift, I'm explicitly doing a post-processing command the change the hosting base path, and found that it's regenerating a stripped stub for every symbol where the hosting base path changes, loosing any custom injected HTML header or footer data.
Checklist
mainbranch of this package.Expected Behavior
I was anticipating that the first archive in the merge set would set the stage for the HTML included, and then the hosting base path could be adjusted without impacting what injected HTML content in each of the stubs.
Actual behavior
After docc convert (or docc merge), the resulting archive's index.html correctly contains custom-header/custom-footer templates. I expected process-archive transform-for-static-hosting to either preserve those templates in the per-route stubs it generates, or copy them through verbatim. Instead, every generated stub is a bare shell.
Steps To Reproduce
Swift-DocC Version Information
6.3.2
Swift Compiler Version Information
Apple Swift version 6.3.2 (swift-6.3.2-RELEASE) Target: arm64-apple-macosx26.0 (also applicable on `main`)