{
  "id": "cli/extract-i18n",
  "title": "ng extract-i18n",
  "contents": "\n<article>\n  <div class=\"github-links\">\n  <a href=\"https://github.com/angular/angular-cli/edit/master/packages/angular/cli/commands/extract-i18n.json?message=docs(...)%3A%20describe%20your%20change...\" aria-label=\"Suggest Edits\" title=\"Suggest Edits\"><i class=\"material-icons\" aria-hidden=\"true\" role=\"img\">mode_edit</i></a>\n  <a href=\"https://github.com/angular/angular-cli/tree/v12.0.0-next.7/packages/angular/cli/commands/extract-i18n.json\" aria-label=\"View Source\" title=\"View Source\"><i class=\"material-icons\" aria-hidden=\"true\" role=\"img\">code</i></a>\n</div>\n  \n\n\n<div class=\"breadcrumb\">\n  <script type=\"application/ld+json\">\n    {\n      \"@context\": \"http://schema.org\",\n      \"@type\": \"BreadcrumbList\",\n      \"itemListElement\": [\n        { \"@type\": \"ListItem\", \"position\": 1, \"item\": { \"@id\": \"https://angular.io/cli\", \"name\": \"CLI\" } },\n        { \"@type\": \"ListItem\", \"position\": 2, \"item\": { \"@id\": \"https://angular.io/cli/extract-i18n\", \"name\": \"extract-i18n\" } }\n      ]\n    }\n  </script>\n    <a href=\"cli\">CLI</a>\n</div>\n\n  \n<header class=\"cli-header\">\n  <h1 id=\"ng-extract-i18n\">ng extract-i18n<a title=\"Link to this heading\" class=\"header-link\" aria-hidden=\"true\" href=\"cli/extract-i18n#ng-extract-i18n\"><i class=\"material-icons\">link</i></a></h1>\n</header>\n\n\n  <aio-toc class=\"embedded\"></aio-toc>\n\n  <div class=\"cli-body\">\n    \n    <p>Extracts i18n messages from source code.</p>\n\n    \n<code-example hidecopy=\"true\" class=\"no-box api-heading no-auto-link\">ng <span class=\"cli-name\">extract-i18n</span> &#x3C;<var>project</var>> [<var>options</var>]</code-example>\n\n<code-example hidecopy=\"true\" class=\"no-box api-heading no-auto-link\">ng <span class=\"cli-name\">i18n-extract</span> &#x3C;<var>project</var>> [<var>options</var>]</code-example>\n\n<code-example hidecopy=\"true\" class=\"no-box api-heading no-auto-link\">ng <span class=\"cli-name\">xi18n</span> &#x3C;<var>project</var>> [<var>options</var>]</code-example>\n\n\n\n    \n\n    \n\n<h2 class=\"no-anchor\" id=\"arguments\">Arguments</h2>\n<table class=\"is-full-width list-table property-table\">\n  <thead>\n    <tr>\n      <th width=\"15%\">Argument</th>\n      <th width=\"40%\">Description</th>\n      <th>Value Type</th>\n    </tr>\n  </thead>\n  <tbody>\n  \n  <tr class=\"cli-option\">\n    <td><code class=\"cli-option-syntax no-auto-link\">&#x3C;<var>project</var>></code></td>\n    <td>\n      <p>The name of the project to build. Can be an application or a library.</p>\n\n      \n    </td>\n    <td><code class=\"cli-option-syntax no-auto-link\">string</code></td>\n  </tr>\n  \n  </tbody>\n</table>\n\n\n    \n\n<h2 class=\"no-anchor\" id=\"options\">Options</h2>\n<table class=\"is-full-width list-table property-table\">\n  <thead>\n    <tr>\n      <th width=\"15%\">Option</th>\n      <th width=\"40%\">Description</th>\n      <th>Value Type</th>\n      <th>Default Value</th>\n      </tr>\n  </thead>\n  <tbody>\n  \n    <tr class=\"cli-option\">\n      <td>\n        <code class=\"cli-option-syntax no-auto-link\">--browser-target</code>\n      </td>\n      <td>\n        \n        <p>A browser builder target to extract i18n messages in the format of <code>project:target[:configuration]</code>. You can also pass in more than one configuration name as a comma-separated list. Example: <code>project:target:production,staging</code>.</p>\n\n        \n      </td>\n      <td><code class=\"no-auto-link\">string</code></td>\n      <td></td>\n    </tr>\n  \n    <tr class=\"cli-option\">\n      <td>\n        <code class=\"cli-option-syntax no-auto-link\">--configuration</code>\n      </td>\n      <td>\n        \n        <p>One or more named builder configurations as a comma-separated list as specified in the \"configurations\" section of angular.json.\nThe builder uses the named configurations to run the given target.\nFor more information, see <a href=\"https://angular.io/guide/workspace-config#alternate-build-configurations\">https://angular.io/guide/workspace-config#alternate-build-configurations</a>.\nSetting this explicitly overrides the \"--prod\" flag.</p>\n\n        <p><span class=\"cli-aliases\">Aliases:</span> -c</p>\n      </td>\n      <td><code class=\"no-auto-link\">string</code></td>\n      <td></td>\n    </tr>\n  \n    <tr class=\"cli-option\">\n      <td>\n        <code class=\"cli-option-syntax no-auto-link\">--format</code>\n      </td>\n      <td>\n        \n        <p>Output format for the generated file.</p>\n\n        \n      </td>\n      <td><code class=\"no-auto-link\">xmb|xlf|xlif|xliff|xlf2|xliff2|json|arb|legacy-migrate</code></td>\n      <td><code class=\"no-auto-link\">xlf</code></td>\n    </tr>\n  \n    <tr class=\"cli-option\">\n      <td>\n        <code class=\"cli-option-syntax no-auto-link\">--help</code>\n      </td>\n      <td>\n        \n        <p>Shows a help message for this command in the console.</p>\n\n        \n      </td>\n      <td><code class=\"no-auto-link\">true|false|json|JSON</code></td>\n      <td><code class=\"no-auto-link\">false</code></td>\n    </tr>\n  \n    <tr class=\"cli-option\">\n      <td>\n        <code class=\"cli-option-syntax no-auto-link deprecated-api-item\">--i18n-format</code>\n      </td>\n      <td>\n        \n          \n            <p><strong>Deprecated:</strong> Use 'format' option instead.</p>\n\n          \n        \n        <p>Output format for the generated file.</p>\n\n        \n      </td>\n      <td><code class=\"no-auto-link\">xmb|xlf|xlif|xliff|xlf2|xliff2|json|arb|legacy-migrate</code></td>\n      <td><code class=\"no-auto-link\">xlf</code></td>\n    </tr>\n  \n    <tr class=\"cli-option\">\n      <td>\n        <code class=\"cli-option-syntax no-auto-link deprecated-api-item\">--i18n-locale</code>\n      </td>\n      <td>\n        \n          \n            <p><strong>Deprecated:</strong> Use 'i18n' project level sub-option 'sourceLocale' instead.</p>\n\n          \n        \n        <p>Specifies the source language of the application.</p>\n\n        \n      </td>\n      <td><code class=\"no-auto-link\">string</code></td>\n      <td></td>\n    </tr>\n  \n    <tr class=\"cli-option\">\n      <td>\n        <code class=\"cli-option-syntax no-auto-link\">--out-file</code>\n      </td>\n      <td>\n        \n        <p>Name of the file to output.</p>\n\n        \n      </td>\n      <td><code class=\"no-auto-link\">string</code></td>\n      <td></td>\n    </tr>\n  \n    <tr class=\"cli-option\">\n      <td>\n        <code class=\"cli-option-syntax no-auto-link\">--output-path</code>\n      </td>\n      <td>\n        \n        <p>Path where output will be placed.</p>\n\n        \n      </td>\n      <td><code class=\"no-auto-link\">string</code></td>\n      <td></td>\n    </tr>\n  \n    <tr class=\"cli-option\">\n      <td>\n        <code class=\"cli-option-syntax no-auto-link deprecated-api-item\">--prod</code>\n      </td>\n      <td>\n        \n          \n            <p><strong>Deprecated:</strong> Use <code>--configuration production</code> instead.</p>\n\n          \n        \n        <p>Shorthand for \"--configuration=production\".\nSet the build configuration to the production target.\nBy 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.</p>\n\n        \n      </td>\n      <td><code class=\"no-auto-link\">boolean</code></td>\n      <td></td>\n    </tr>\n  \n    <tr class=\"cli-option\">\n      <td>\n        <code class=\"cli-option-syntax no-auto-link\">--progress</code>\n      </td>\n      <td>\n        \n        <p>Log progress to the console.</p>\n\n        \n      </td>\n      <td><code class=\"no-auto-link\">boolean</code></td>\n      <td><code class=\"no-auto-link\">true</code></td>\n    </tr>\n  \n  </tbody>\n</table>\n\n\n    \n  </div>\n</article>\n\n<!-- links to this doc:\n - cli\n-->\n<!-- links from this doc:\n - cli\n - cli/extract-i18n#ng-extract-i18n\n - https://angular.io/guide/workspace-config#alternate-build-configurations\n - https://github.com/angular/angular-cli/edit/master/packages/angular/cli/commands/extract-i18n.json?message=docs(...)%3A%20describe%20your%20change...\n - https://github.com/angular/angular-cli/tree/v12.0.0-next.7/packages/angular/cli/commands/extract-i18n.json\n-->"
}