Skip to content

Can language switching be supported? #120

Closed

Description

@Soveilove

Can language switching be supported?

Activity

  1. anhnh2002 commented on Sep 29, 2026

    @anhnh2002
    Collaborator

    Sorry, could you please provide a bit more detail? What do you mean by “language switching”?

  2. Soveilove commented on Sep 29, 2026

    @Soveilove
    Author

    Sorry, could you please provide a bit more detail? What do you mean by “language switching”?

    I mean choosing the language of the generated documentation, such as Japanese. Using --instructions still leaves some content in English, and requesting translated filenames also causes “Module docs not found” warnings. Is there a recommended way to set the output language consistently?

  3. anhnh2002 commented on Sep 30, 2026

    @anhnh2002
    Collaborator

    Thanks for the details. I've added a dedicated option for this in #124:
    codewiki generate --language ja or: Japanese, vi, zh, ko, fr, ...
    codewiki config agent --language ja make it your default
    What it does:

    • All page text, headings, tables and Mermaid diagram labels are written in the chosen language. Code, identifiers and file paths stay as they are.
    • Filenames and module names are intentionally not translated. They link the pages, the module tree, the HTML viewer and --update together. Translating them is what caused the "Module docs not found" warnings you saw. The GitHub Pages viewer shows each page's translated title in the navigation instead, so the sidebar still reads in Japanese.
    • The language is saved in metadata.json. codewiki generate --update keeps using it automatically, so updated pages stay in Japanese. To switch language, regenerate without --update.
  4. added a commit that references this issue on Sep 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions