How to generate multiple languages from multiple specs?

[travistyoj]

I have a site using the basic i18n features of docusaurus, with each language having content in

i18n/[langcode]/docusaurus-plugin-content-docs/current/

I have endpoints being properly generated into /docs/api/endpoints in the root /docs folder for english

    [
      "docusaurus-plugin-openapi-docs",
      {
        id: "api-en",
        docsPluginId: "classic",
        config: {
          api: {
            specPath: "oas/openapi-en.yaml",
            outputDir: "docs/api/endpoints",
            sidebarOptions: {
              groupPathsBy: "tag",
            },
          } satisfies OpenApiPlugin.Options,
        },
      },
    ]

I have non-english spec files in the oas directory, like openapi-ja.yaml. When I add another instance of the plugin, I get:
"OpenAPI docs plugin ID must be specified when more than one plugin instance exists."

I'm not quite wrapping my head around the best way to build out multi instances of content-docs plugins, so that it works the same way as the automatic i18n method. Are there any example configs of this? Seems like it would be a common problem to solve. Thanks!

[travistyoj]

I figured this out, leaving the solution for others that might search for this:

    [
      "docusaurus-plugin-openapi-docs",
      {
        id: "api",
        docsPluginId: "classic",
        config: {
          en: {
            specPath: "oas/openapi-en.yaml",
            outputDir: "docs/api/endpoints",
            sidebarOptions: {
              groupPathsBy: "tag",
            },
          } satisfies OpenApiPlugin.Options,
          ja: {
            specPath: "oas/openapi-ja.yaml",
            outputDir: "i18n/ja/docusaurus-plugin-content-docs/current/api/endpoints",
            sidebarOptions: {
              groupPathsBy: "tag",
            },
          } satisfies OpenApiPlugin.Options,
        },
      },
    ]