Angular CLI – ng xi18n Command

Angular CLI - ng xi18n Command

In this Angular CLI ng xi18n Command chapter explains the syntax, arguments and options of ng xi18n command along with an example. So all the details of Angular CLI ng xi18n Command explain below-

Syntax

The syntax for ng xi18n command is as follows −

ng xi18n <project> [options]
ng i18n-extract <project> [options]

ng xi18n command extracts i18n messages from the source code.

Arguments

The argument for ng xi18n command is as follows −

Sr.No.Argument & SyntaxDescription
1<project>The name of the project. It can be an application or library.

Options

Options are optional parameters.

Sr.No.Option & SyntaxDescription
1–browserTarget=browserTargetTarget to extract from.
2–configuration=configurationA named build target, as specified in the “configurations” section of angular.json. Each named target is accompanied by a configuration of option defaults for that target. Setting this explicitly overrides the “–prod” flag. Aliases: -c
3–createCommits=true|falseCreate source control commits for updates and migrations.Default: falseAliases: -C
4–format=xmb|xlf|xlif|xliff|xlf2|xliff2Output format for the generated file.Default: xlf
5–help=true|false|json|JSONShows a help message for this command in the console. Default: false
6–outFile=outFileName of the file to output.
7–outputPath=outputPathPath where output will be placed.
8–prod=true|falseShorthand for “–configuration=production”. When true, sets the build configuration to the production target. By default, the production target is set up in the workspace configuration such that all builds make use of bundling, limited tree-shaking, and also limited dead code elimination.
9–progress=true|falseLog progress to the console.Default: true

First, move to an angular project updated using ng build command. The chapter is available at https://adglob.in/blog/angular-cli-ng-build-command/.

Update the app.component.html as follows −

app.component.spec.ts

<div class="content" role="main">
   <span i18n>app is running!</span>
</div>
<app-goals></app-goals>
<router-outlet></router-outlet>

Now run the xi18n command.

Example

An example for ng xi18n command is given below −

\>Node\>Adglob> ng xi18n

Add localization support.

\>Node\>Adglob> ng add @angular/localize
Installing packages for tooling via npm.
Installed packages for tooling via npm.
UPDATE src/polyfills.ts (3064 bytes)

Now ng will create a message.xlf file in the root folder which is an industry-standard translation file.

messages. xlf

<?xml version="1.0" encoding="UTF-8" ?>
<xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
   <file source-language="en-US" datatype="plaintext" original="ng2.template">
      <body>
         <trans-unit id="6226cbeebaffaec0342459915ef7d9b0e9e92977" datatype="html">
            <source>app is running!</source>
            <context-group purpose="location">
               <context context-type="sourcefile">src/app/app.component.html</context>
               <context context-type="linenumber">2</context>
            </context-group>
         </trans-unit>
      </body>
   </file>
</xliff>

Next Topic : Click Here

This Post Has 2 Comments

Leave a Reply