3 ms·
On a related topic of hybrid Swift and C++ tooling - has anyone used Doxygen/Sphinx to generate HML docs for modern Swift, similar to how people do it for pure
by ashvardanian 3y ago
On a related topic of hybrid Swift and C++ tooling - has anyone used Doxygen/Sphinx to generate HML docs for modern Swift, similar to how people do it for pure C++ projects?
- dagmx 3y agoSwift does have docc that does the same https://swift.org/blog/swift-docc/ https://swift.org/blog/swift-docc/ I’ve never had good luck getting documentation working cross language and so I use docc for Swift, doxygen for C++, rustdoc for Rust and Sphinx for Python. Then I just link between them if a project uses more than one language
- ashvardanian 3y agoSure, but how do you style and host those docs? Can you style them identically? We use a combo of Furo + Sphinx + Doxygen for C/C++, Python, JavaScript, Java here: https://unum-cloud.github.io/docs/usearch https://unum-cloud.github.io/docs/usearch For ObjC, Swift, Rust, and other languages we couldn’t make it work for now.
- dagmx 3y agoI gave up on trying to style them exactly the same. I manage my own CSS that brings them closer but they all behave so differently. I wrote my own hosting solution to host multiple doc types and switch between versions. Unfortunately I can’t share it since it’s for work but it wasn’t too hard. Though I wish there was a good off the shelf solution here.
- ashvardanian 3y agoSimilar state here. It’s so frustrating. Thx!