<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" type="topic" style="task" id="plugin-tag-list" xml:lang="zh-CN">

  <info>
    <link type="guide" xref="gedit-plugin-guide#gedit-default-plugins"/>
    <revision pkgversion="3.8" date="2013-02-24" status="review"/>
    <revision pkgversion="3.8" date="2013-03-22" status="review"/>

    <credit type="author">
      <name>Daniel Neel</name>
      <email its:translate="no">dneelyep@gmail.com</email>
    </credit>
    <credit type="author">
      <name>Jim Campbell</name>
      <email its:translate="no">jwcampbell@gmail.com</email>
    </credit>
    <credit type="editor">
      <name>Sindhu S</name>
      <email its:translate="no">sindhus@live.in</email>
    </credit>

    <include xmlns="http://www.w3.org/2001/XInclude" href="legal-plugins.xml"/>

    <desc>Automatically insert tags, strings and special characters into a document.</desc>
  </info>

  <title>Tag List</title>

  <p>The <app>Tag List</app> plugin allows you to insert common tags and
  special characters from a list in the side pane. By default, the plugin can
  insert tags and special characters for <app>HTML</app>, <app>XHTML</app>,
  <app>XSLT</app>, <app>XUL</app> and <app>LaTeX</app>.</p>

<section id="enable-tag-list-plugin">
  <title>Enable Tag List Plugin</title>

  <p>To enable the <app>Tag List</app> plugin:</p>

  <steps>
    <item>
      <p>Select <guiseq><gui style="menu">gedit</gui>
      <gui style="menuitem">Preferences</gui>
      <gui style="tab">Plugins</gui></guiseq>.</p>
    </item>
    <item>
      <p>Select <gui style="menuitem">Tag List</gui> to enable the plugin.</p>
    </item>
    <item>
      <p>Access the tag list by selecting
      <guiseq><gui style="menu">View</gui>
      <gui style="menuitem">Side Pane</gui></guiseq>, or by pressing
      <key>F9</key>.</p>
    </item>
  </steps>

  <p>The side pane will initially show a list of open documents, so to view and
  use the <app>Tag List</app>, you will need to click on the tab showing the
  "plus" icon at the bottom of the side pane. The icon will look similar to
  this:</p>

  <p><media type="image" mime="image/png" src="figures/gedit-side-pane3.png"/></p>

</section>

<section id="inserting-tags">
  <title>插入标记或特殊字符</title>

  <p><app>标记列表</app>中，使用下拉列表来选择不同类型的标记符号，例如，里面有一个 <gui>HTML-标记</gui>。</p>

  <p>要插入一个标记，请按下面的步骤操作：</p>

  <steps>
    <item>
      <p>把鼠标指针定位想要插入标记符号或特殊字符的位置。</p>
    </item>
    <item>
      <p>从侧边栏顶部的下拉列表中，选择想要使用的标记类型。</p>
    </item>
    <item>
      <p>向下滚动列表查找所需的标记或字符。</p>
    </item>
    <item>
      <p>双击列表中的标记名称。</p>
    </item>
  </steps>

  <p>The tag or special character you have chosen will then be displayed in
  your document.</p>
</section>

<section id="tag-list-tips">
  <title>标记列表小提示</title>

  <note style="tip">
    <p>您也可以按<key>回车键</key>或 <keyseq><key>Shift</key><key>回车键</key></keyseq>来插入标记符号。</p>
    <p>按 <key>回车键</key> 将在光标位置插入标记符号，然后焦点留在文档中，按 <keyseq><key>Shift</key><key>回车键</key></keyseq> 在光标位置插入标记符号，而焦点仍然在 <app>标记列表</app>。</p>
  </note>

  <note style="tip">
    <p>您可以点击侧栏底部的<gui>预览</gui>标签，预先查看一下要插入的标记和特殊字符。</p>
  </note>
</section>

</page>
