anchor.diff:      It's a custom _attribute_, recognized by Angular tools and compilers.
       It will be removed by the compiler _after_ translation.
   
  +    `i18n`不是Angular指令。
  +    它是一个自定义**属性**，Angular工具和编译器认识它。
  +    它将在完成翻译**之后**，被编译器移除。
  +
   :marked
     In the accompanying sample, an `<h1>` tag displays a simple English language greeting which you will translate to French:
  +
  +  在例子中，`<h1>`标签显示了一句简单的英文问候语，它将被翻译为法语：
  +
   +makeExample('cb-i18n/ts/app/app.component.1.html', 'greeting', 'app/app.component.html')(format=".")
   :marked
     Add the `i18n` attribute to the tag to mark it for translation.
  +
  +  添加`i18n`属性到该标签上，把它标记为需要翻译的文本。
   
   +makeExample('cb-i18n/ts/app/app.component.1.html', 'i18n-attribute', 'app/app.component.html')(format=".")
   
   :marked
     The translator may need a description of the message to translate it accurately.
     Assign a description to the i18n attribute:
  +
  +  翻译人员可能需要待翻译文本的描述才能翻译准确。
  +  为i18n属性添加描述：
     
   +makeExample('cb-i18n/ts/app/app.component.1.html', 'i18n-attribute-desc', 'app/app.component.html')(format=".")
   
   :marked
     The true _meaning_ of the text may require some application context.
     Add a contextual meaning to the assigned string, separating it from the description with the `|` character:
  +
  +  文本的准确**意思**可能需要一些应用上下文。
  +  在制定的字符串中添加上下文含义，用`|`将其与描述文字隔开。
     
   +makeExample('cb-i18n/ts/app/app.component.html', 'i18n-attribute-meaning', 'app/app.component.html')(format=".")
   
  
positive.code:   The Angular extraction tool preserves both the _meaning_ and the _description_ in the translation source file
    to facilitiate contextually-specific translations.
  
  a#ng-xi18n
  .l-main-section
  :marked
    ## Create a translation source file with the _ng-xi18n_ tool
    
    Use the `ng-xi18n` extraction tool to extract the `i18n`-marked texts 
    into a translation source file in an industry standard format.
    
    This is an Angular CLI tool in the `@angular/compiler-cli` npm package.
    If you haven't already installed the CLI and its `platform-server` peer dependency, do so now:
    
  code-example(language="sh" class="code-shell").
    npm install @angular/compiler-cli @angular/platform-server --save
  
  :marked
    Open a terminal window at the root of the application project and enter the `ng-xi18n` command:
   
  code-example(language="sh" class="code-shell").
    ./node_modules/.bin/ng-xi18n
  
negative.code:   By default the tool generates a translation file named **`messages.xlf`** in the
    <a href="https://en.wikipedia.org/wiki/XLIFF" target="_blank">XML Localisation Interchange File Format (XLIFF, version 1.2)</a>.
  
    工具默认生成一个名为**`messages.xlf`**的翻译文件，格式为<a href="https://en.wikipedia.org/wiki/XLIFF" target="_blank">XML本地化互换文件格式(XLIFF, version 1.2)</a>。
  
  code-example(language="sh" class="code-shell").
    ./node_modules/.bin/ng-xi18n  --i18nFormat=xmb
  
  .l-sub-section
    :marked
      Windows users may have to quote the command:
  
      Windows用户可能需要双引号这个命令：
  
    code-example(language="sh").
      "./node_modules/.bin/ng-xi18n"
    :marked
      Consider adding a convenience shortcut to the `scripts` section of the `package.json`
      to make the command easier to remember and run:
  
      建议在`package.json`文件的`scripts`部分添加一个便利的快捷方式，让这个命令更容易被记住和运行：
    code-example(format='.').
      "scripts": {
        "i18n": "ng-xi18n", 
  