Skip to content

Missing localize config documentation #59664

@ChristopherInova

Description

@ChristopherInova

Describe the problem that you experienced

We use “de” as sourceLocale, but would like to host all locales under a 5-letter code. Apart from the fact that I don't understand in which cases the locales are 2-letter and why, for example, “de-DE” is not also available as a 5-letter variant, there currently seems to be no documentation on the sourceLocale node of the angular.json.

I have seen in another issue (angular/angular-cli#17144) that sourceLocale also accepts an object with baseHref and code in addition to a string. If you set this, the baseHref in the index.html is adjusted, but the build is still written to the “de” directory.

I know, i can write a postbuild script to change directory naming from de to 'de-DE', but i'm wondering why you support to set a baseHref but not renaming the directory. Maybe there is another undocumented property to allow renaming, but except of the issue i couldn't find any information about this.

Enter the URL of the topic with the problem

https://angular.dev/guide/i18n

Describe what you were looking for in the documentation

I'm missing a typed documention of the i18n node of the angular.json. There is no hint, what properties can be set at i18n except of the provided samples. So at least there is missing the information that sourceLocale can also be an object.

Describe the actions that led you to experience the problem

No response

Describe what you want to experience that would fix the problem

No response

Add a screenshot if that helps illustrate the problem

No response

If this problem caused an exception or error, please paste it here


If the problem is browser-specific, please specify the device, OS, browser, and version


Provide any additional information here in as much as detail as you can


Metadata

Metadata

Assignees

No one assigned

    Labels

    area: docsRelated to the documentation

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions