<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" style="task" id="gedit-plugins-tag-list" xml:lang="zh-HK">

<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>dneelyep@gmail.com</email>
  </credit>
  <credit type="author">
    <name>Jim Campbell</name>
    <email>jwcampbell@gmail.com</email>
  </credit>
  <credit type="editor">
    <name>Sindhu S</name>
    <email>sindhus@live.in</email>
  </credit>
  <include xmlns="http://www.w3.org/2001/XInclude" href="legal.xml"/>
  <desc>Automatically insert tags, strings and special characters into a
  document</desc>
</info>

  <title>標記清單 (Tag 清單)</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>Inserting Tags and Special Characters</title>

    <p>The <app>tag list</app> uses a drop-down menu to let you choose from the
    different types of tags. For example, one tag option is <gui>HTML -
    Tags</gui>.</p>

    <p>To start inserting tags, complete the following:</p>

    <steps>
      <item>
        <p>Move the cursor to where you will want to insert the tag or special
        character.</p>
      </item>
      <item>
        <p>Select the desired tag type from the drop-down menu at the top of
        the side pane.</p>
      </item>
      <item>
        <p>Scroll through the list to find the desired tag or character.</p>
      </item>
      <item>
        <p>Double-click on the tag in the tag list.</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>Tag List Tips</title>
    <note style="tip">
      <p>You can also insert a tag by pressing <key>Return</key> or
      <keyseq><key>Shift</key><key>Return</key></keyseq>.</p>
      <p>Pressing the <key>Return</key> key will insert the tag at the cursor
      position, and then return focus to the document. Pressing
      <keyseq><key>Shift</key><key>Return</key></keyseq> will insert the tag at
      the cursor position, but will keep the focus on the
      <app>tag-list</app>.</p>
    </note>

    <note style="tip">
      <p>You can see a preview of what text will be inserted for each tag and
      special character by clicking on the word the <gui>Preview</gui> at the
      bottom of the side pane.</p>
    </note>
  </section>
</page>
