mirror of
https://github.com/angular/angular
synced 2026-05-24 09:28:37 +00:00
42289f25c6
The purpose of the changes is to clean all markdown to match a single pedantic style.
* To ensure all changes in style are properly separated.
* To ensure all styled content aligns to nearest 4-character-tab.
* To ensure all code blocks use the Angular `<code-example>` or `<code-tab>` elements.
* To ensure all markdown exists outside of html tags.
* To ensure all images use the Angular style for `<img>` elements.
* To ensure that all smart punctuation is replaced or removed.
```text
’, ’, “, ”, –, —, …
```
* To ensure all content does not conflict with the following reserved characters.
```text
@, $, *, &, #, |, <, >,
```
* To ensure all content displays using html entities.
The following changes were made to files in the following directory.
```text
aio/content
```
The target files were markdown files.
The list of excluded files:
```text
.browserslistrc, .css, .conf, .editorconfig, .gitignore, .html, .js, .json, .sh, .svg, .ts, .txt, .xlf,
```
PR Close #45325
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 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 2022-02-28
|