<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="guide" style="task 2column" id="gedit-plugins-snippets" xml:lang="zh_CN">
  <info>
    <link type="guide" xref="gedit-plugin-guide#gedit-default-plugins"/>
    <desc>使用片断功能快速插入常用文本短语。</desc>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>TeliuTe</mal:name>
      <mal:email>teliute@163.com</mal:email>
      <mal:years>2009, 2011</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Colin Zhao</mal:name>
      <mal:email>lonely.ibm@gmail.com</mal:email>
      <mal:years>2011</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>wancheng zhang</mal:name>
      <mal:email>wancheng.com.cn@gmail.com</mal:email>
      <mal:years>2012</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Zhe Wei</mal:name>
      <mal:email>weizhe86@gmail.com</mal:email>
      <mal:years>2014</mal:years>
    </mal:credit>
  </info>

  <title>片段</title>

  <p><app>片段</app>为您提供了一个将常用片段方便地插入到文件中的方法。例如，<code>&lt;img&gt;</code> 的HTML代码片段可以插入标签开始和结束的代码,并且直接定位到需要写入图片属性的位置。这将使编码变得更快更简单。</p>

  <section id="enable-snippets">
    <title>启用片段插件</title>

    <p>启用<gui>片段</gui>插件：</p>

    <steps>
      <item>
        <p>点菜单 <guiseq><gui style="menu">gedit</gui> <gui style="menuitem">首选项</gui> <gui style="tab">插件</gui></guiseq>。</p>
      </item>
      <item>
        <p>选择 <gui style="menuitem">片段</gui> 来启用该插件。</p>
      </item>
    </steps>
  </section>

  <section id="browse-snippets">
    <title>浏览片段</title>

    <p>浏览可用的片段:</p>
    <steps>
      <item>
        <p>点菜单 <guiseq><gui style="menu">工具</gui> <gui style="menuitem">管理片段</gui></guiseq></p>
        <note style="important">
          <p>请确保正确设置语法。<app>gedit</app>底部的状态栏会显示当前的语言设置。gedit会依据语言设置插入正确的片段。通常<app>Gedit</app>可以自动识别文件的语言或语法，但有时需要您手工设置。</p>
          <figure>
            <desc>在这个示例中，语言设置为了 HTML 。</desc>
            <media type="image" mime="image/png" src="figures/gedit-html-snippet.png"/>
        </figure>
        </note>
      </item>
      <item>
        <p>浏览适合您的语言或语法的片段。</p>
      </item>
    </steps>
  </section>

  <section id="using-snippets">
    <title>使用片段</title>

    <p>将片段插入到当前的文档中：</p>

    <steps>
      <item>
        <p>在文档的任意位置输入您所需代码片段的名字。</p>
      </item>
      <item>
        <p>按下<key>Tab</key>键即可将片段插入相应的代码片段。</p>
      </item>
    </steps>
  </section>

    <section id="example-insert-snippet">
    <title>片段插件的用法示例</title>

    <p>例如，如果您已设置语法为<em>HTML</em>，输入<code>head </code>，然后按下<key>Tab</key>键。以下文本将自动插入：</p>

    <code>
      &lt;head&gt;
      &lt;meta http-equiv="Content-type" content="text/html; charset=utf-8" /&gt;
      &lt;title&gt;Page Title&lt;/title&gt;
      &lt;/head&gt;
    </code>

  </section>

  <section id="adding-snippets">
    <title>添加片段</title>

    <p>您可以将新代码片段设定为作用于全局（也就是说，他们是语言无关的）或者只作用于特定语法。</p>

    <steps>
      <item>
        <p>选择 <guiseq style="menu"><gui style="menuitem">工具</gui> <gui style="menuitem">管理片段</gui></guiseq>。</p>
      </item>
      <item>
        <p>从<gui>管理片段</gui>侧边栏选择所需语法，然后通过点击语法左侧 "+" 按钮显示该语法已有的片段。</p>
        <note style="tip">
          <p>要添加作用于全局的片段（即使是未设置特定语法或语言的文档），请在<gui>管理片段</gui>侧边栏选择<gui>Global</gui>。</p>
        </note>
      </item>
      <item>
        <p>要添加新片段，点击<gui>管理片段</gui>侧边栏底部的"+"图标。</p>
      </item>
      <item>
        <p>为新增的片段输入名称，名称可以与您要添加的片段不同。</p>
      </item>
      <item>
        <p><gui style="group">Activation</gui>区域内，你必须在<gui style="input">触发条件:</gui>文本框中输入一个词语。你可以通过这则词语将该片段插入到文档中。</p>
        <note style="tip">
          <p>如果您希望通过快捷键插入片段，请使用鼠标点击<gui style="input">快捷键:</gui>文本框并按下所需的组合键。当您按下并放开组合键的时候，该快捷键就设置好了。</p>
        </note>
      </item>
      <item>
        <p>在<gui style="input">编辑:</gui>文本框中，输入合适的片段内容。您可以使用<code>${n}</code>表示变量，请将<em>n</em>替换为数字，用以标示变量的顺序。</p>
      </item>
    </steps>

  </section>

  <section id="example-add-snippet">
    <title>新增片段示例</title>

    <p>目前认为您已经创建了<gui style="input">触发条件:</gui>是<var>greetings</var>的片段。<gui style="input">编辑:</gui>区域内容如下:</p>

    <code>
      &lt;greetings&gt;Hello ${1:wonderful}${2:amazing} world!
      &lt;/greetings&gt;
    </code>

    <p>您可以在文档中输入<var>greetings</var>并按<key>Tab</key>键来插入该片段。以下的文本片段将被插入。</p>

    <code>
      &lt;greetings&gt;Hello wonderfulamazing world!&lt;/greetings&gt;
    </code>

    <p>根据您的选择"wonderful"和"amazing"两个单词可保留或删除。如果要删除的话，请按下<key>Tab</key>键选择"wonderful"或"amazing"，然后按下<key>Del</key>键来删除您不需要的那个。</p>
  </section>

  <!--TODO: <section id="modifying-snippets">
    <title>Modifying Existing Snippets</title>

  </section>-->
</page>
