DocC for other languages

Development Swift-DocC
1

Greetings! I am a student from China and I am intending to write a manual of the lighting console for the school using Swift-DocC.

I know DocC is intended to be used for development and coding documentations and not for normal real-world manuals like this, but it does support Markdown and also it has a straightfoward UI for me to display things, so I figured I'm using it anyway. The only problem I am having with DocC now is that its default language is English and I can't seem to find any settings or whatsoever about localization. Now it does display Chinese text correctly since Helvetica Neue supports CJK. Yet, for templated titles like "Topic" or page headers ("Article") and such, they still display themselves in English. And using "Topic" is neccessary for organizing the navigation sidebar, so I was wondering if localization can be available for the webpages DocC creates.

I am happy to contribute to localizations if neccessary.

1 Like
2

Unfortunately, DocC doesn't currently have internationalization support built into it. The focused pieces you're asking for are a subset of the broader needs for full internationalization support. There is an issue open on GitHub (Internationalization support · Issue #648 · swiftlang/swift-docc · GitHub) that I'd recommend you add your voice to - outlining the needs you're after here.

@pepi mentioned he'd start a forum discussion about the needs, but I'm unable to find anything in the forums with searching, and don't recall the thread myself - so it might have never started.