mirror of
https://github.com/angular/angular.git
synced 2026-09-14 13:54:52 +08:00
Joe Martin (Crowdstaffing)
85c0ce793b
Add new $localize and Ivy content. Clean up navigation. PR Close #43722
54 lines
2.4 KiB
Markdown
54 lines
2.4 KiB
Markdown
# Deploy multiple locales
|
|
|
|
If `myapp` is the directory that contains the distributable files of your project, you typically make different versions available for different locales in locale directories. For example, your French version is located in the `myapp/fr` directory and the Spanish version is located in the `myapp/es` directory.
|
|
|
|
The HTML `base` tag with the `href` attribute specifies the base URI, or URL, for relative links.
|
|
If you set the `"localize"` option in [`angular.json`][AioGuideWorkspaceConfig] workspace build configuration file to `true` or to an array of locale IDs, the CLI adjusts the base `href` for each version of the application.
|
|
To adjust the base `href` for each version of the application, the CLI adds the locale to the configured `"baseHref"`.
|
|
Specify the `"baseHref"` for each locale in your [`angular.json`][AioGuideWorkspaceConfig] workspace build configuration file.
|
|
The following example displays `"baseHref"` set to an empty string.
|
|
|
|
<code-example language="json" header="angular.json" path="i18n/angular.json" region="i18n-baseHref" ></code-example>
|
|
|
|
Also, to declare the base `href` at compile time, use the CLI `--baseHref` option with [`ng build`][AioCliBuild].
|
|
|
|
## Configure a server
|
|
|
|
Typical deployment of multiple languages serve each language from a different subdirectory.
|
|
Users are redirected to the preferred language defined in the browser using the `Accept-Language` HTTP header.
|
|
If the user has not defined a preferred language, or if the preferred language is not available, then the server falls back to the default language.
|
|
To change the language, change your current location to another subdirectory.
|
|
The change of subdirectory often occurs using a menu implemented in the application.
|
|
|
|
<div class="alert is-helpful">
|
|
|
|
For more information on how to deploy apps to a remote server, see [Deployment][AioGuideDeployment].
|
|
|
|
</div>
|
|
|
|
### Nginx example
|
|
|
|
The following example displays an Nginx configuration.
|
|
|
|
<code-example path="i18n/doc-files/nginx.conf" language="nginx"></code-example>
|
|
|
|
### Apache example
|
|
|
|
The following example displays an Apache configuration.
|
|
|
|
<code-example path="i18n/doc-files/apache2.conf" language="apache"></code-example>
|
|
|
|
<!-- links -->
|
|
|
|
[AioCliBuild]: cli/build "ng build | CLI | Angular"
|
|
|
|
[AioGuideDeployment]: guide/deployment "Deployment | Angular"
|
|
|
|
[AioGuideWorkspaceConfig]: guide/workspace-config "Angular workspace configuration | Angular"
|
|
|
|
<!-- external links -->
|
|
|
|
<!-- end links -->
|
|
|
|
@reviewed 2021-10-07
|