1
<?xml version="1.0" encoding="utf-8"?>
2
<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-TW">
5
<link type="guide" xref="gedit-plugin-guide#gedit-default-plugins"/>
6
<revision pkgversion="3.8" date="2013-02-24" status="review"/>
7
<revision pkgversion="3.8" date="2013-03-22" status="review"/>
10
<name>Daniel Neel</name>
11
<email its:translate="no">dneelyep@gmail.com</email>
13
<credit type="author">
14
<name>Jim Campbell</name>
15
<email its:translate="no">jwcampbell@gmail.com</email>
17
<credit type="editor">
19
<email its:translate="no">sindhus@live.in</email>
22
<include xmlns="http://www.w3.org/2001/XInclude" href="legal-plugins.xml"/>
24
<desc>Automatically insert tags, strings and special characters into a document.</desc>
29
<p>The <app>Tag List</app> plugin allows you to insert common tags and
30
special characters from a list in the side pane. By default, the plugin can
31
insert tags and special characters for <app>HTML</app>, <app>XHTML</app>,
32
<app>XSLT</app>, <app>XUL</app> and <app>LaTeX</app>.</p>
34
<section id="enable-tag-list-plugin">
35
<title>Enable Tag List Plugin</title>
37
<p>To enable the <app>Tag List</app> plugin:</p>
41
<p>Select <guiseq><gui style="menu">gedit</gui>
42
<gui style="menuitem">Preferences</gui>
43
<gui style="tab">Plugins</gui></guiseq>.</p>
46
<p>Select <gui style="menuitem">Tag List</gui> to enable the plugin.</p>
49
<p>Access the tag list by selecting
50
<guiseq><gui style="menu">View</gui>
51
<gui style="menuitem">Side Pane</gui></guiseq>, or by pressing
56
<p>The side pane will initially show a list of open documents, so to view and
57
use the <app>Tag List</app>, you will need to click on the tab showing the
58
"plus" icon at the bottom of the side pane. The icon will look similar to
61
<p><media type="image" mime="image/png" src="figures/gedit-side-pane3.png"/></p>
65
<section id="inserting-tags">
66
<title>Inserting Tags and Special Characters</title>
68
<p>The <app>tag list</app> uses a drop-down menu to let you choose from the
69
different types of tags. For example, one tag option is <gui>HTML -
72
<p>To start inserting tags, complete the following:</p>
76
<p>Move the cursor to where you will want to insert the tag or special
80
<p>Select the desired tag type from the drop-down menu at the top of
84
<p>Scroll through the list to find the desired tag or character.</p>
87
<p>Double-click on the tag in the tag list.</p>
91
<p>The tag or special character you have chosen will then be displayed in
95
<section id="tag-list-tips">
96
<title>Tag List Tips</title>
99
<p>You can also insert a tag by pressing <key>Return</key> or
100
<keyseq><key>Shift</key><key>Return</key></keyseq>.</p>
101
<p>Pressing the <key>Return</key> key will insert the tag at the cursor
102
position, and then return focus to the document. Pressing
103
<keyseq><key>Shift</key><key>Return</key></keyseq> will insert the tag at
104
the cursor position, but will keep the focus on the
105
<app>tag-list</app>.</p>
109
<p>You can see a preview of what text will be inserted for each tag and
110
special character by clicking on the word the <gui>Preview</gui> at the
111
bottom of the side pane.</p>