Typedoc: Localization support

Created on 31 Jul 2018  路  5Comments  路  Source: TypeStrong/typedoc

I tried to find documentation for supporting multiple languages with no success. Is localization supported for documentation generation?

enhancement wontfix

Most helpful comment

Very cool! Do you want to add that to the typedoc readme?

All 5 comments

Sorry, currently localization is not supported. I think this is out of scope for the time being so I'll close this issue but feel free to continue discussing your ideas here.

This is the solution to my question. We have created a typedoc plugin which is:

  1. Merging all code comments (classes, methods, properties, enumerations etc.) that needs localization in a couple of json files.
  2. Translate them by hand and save your changes.
  3. Use the updated files to build a documentation for an entire project in the desired language.

In the Readme.md you can find more detailed explanation of the steps that you should take to use the plugin.

Very cool! Do you want to add that to the typedoc readme?

That would be great! If there is something that we need to consider as a plugin requirements or repository configuration, just let me know.

Sharing with the community steps and a video representation of the localization plugin usage:

npm install typedoc-plugin-localization

npx typedoc projects\igniteui-angular\src\public_api.ts --generate-json exports

npx typedoc .\projects\igniteui-angular\src\public_api.ts --generate-from-json .\exports\ --out localized

For more information, have a look at the readme.md file.

localizationplugin

Was this page helpful?
0 / 5 - 0 ratings

Related issues

Rycochet picture Rycochet  路  4Comments

unsafecode picture unsafecode  路  4Comments

atomsoftwarestudios picture atomsoftwarestudios  路  4Comments

Bibliofile picture Bibliofile  路  3Comments

nidsharm picture nidsharm  路  3Comments