gedit-common 3.10.4-0ubuntu4 / usr / share / help / C / gedit / gedit-plugins-snippets.page

This file is indexed.

/usr/share/help/C/gedit/gedit-plugins-snippets.page is in gedit-common 3.10.4-0ubuntu4.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below. 

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
<page xmlns="http://projectmallard.org/1.0/"
      type="guide" style="task 2column"
      id="gedit-plugins-snippets-guide">
  <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>Jim Campbell</name>
      <email>jwcampbell@gmail.com</email>
    </credit>
    <credit type="author">
      <name>Sindhu S</name>
      <email>sindhus@live.in</email>
    </credit>
    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
    <desc>Use snippets to quickly insert often-used pieces of text</desc>
  </info>

  <title>Snippets</title>

  <p><app>Snippets</app> provide a convenient way of inserting repetitive
  portions of code into your files. For example, an HTML snippet for the
  <code><![CDATA[<img>]]></code> tag would insert the opening and closing
  portions of the tag, as well as fixed places where you can enter image
  attributes. This can make writing code easier and faster.</p>

  <section id="enable-snippets">
    <title>Enable Snippets Plugin</title>

    <p>To enable the <gui>Snippets</gui> 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">Snippets</gui> to enable the
        plugin.</p>
      </item>
    </steps>
  </section>

  <section id="browse-snippets">
    <title>Browse Snippets</title>

    <p>To browse available snippets:</p>
    <steps>
      <item>
        <p>Select <guiseq><gui style="menu">Tools</gui>
        <gui style="menuitem">Manage Snippets</gui></guiseq>.</p>
        <note style="important">
          <p>Make sure the syntax is set appropriately. The status bar at the
          bottom of the <app>gedit</app> window will show the current language
          setting. This language setting is what allows gedit to insert the
          proper snippets. <app>Gedit</app> will normally detect the language or
          syntax of the file that you're using, but sometimes you may need to
          set it.</p>
          <figure>
            <desc>In this example, the language is set to HTML.</desc>
            <media type="image" mime="image/png"
            src="figures/gedit-html-snippet.png"></media>
        </figure>
        </note>
      </item>
      <item>
        <p>Browse the snippets that are available for your language or
        syntax.</p>
      </item>
    </steps>
  </section>

  <section id="using-snippets">
    <title>Using Snippets</title>

    <p>To insert a snippet into your current document:</p>

    <steps>
      <item>
        <p>Type the desired snippet name anywhere in your current document.</p>
      </item>
      <item>
        <p>Press <key>Tab</key> to insert the snippet associated with the input
        term.</p>
      </item>
    </steps>
  </section>

    <section id="example-insert-snippet">
    <title>Snippet Example Usage</title>

    <p>For example, if you have set the syntax to <em>HTML</em>, type
    <code>head </code>, and press the <key>Tab</key> key. The text would have
    auto completed into a snippet as:</p>

    <code>
      <![CDATA[<head>
      <meta http-equiv="Content-type" content="text/html; charset=utf-8" />
      <title>Page Title</title>
      </head>]]>
    </code>

  </section>

  <section id="adding-snippets">
    <title>Adding Snippets</title>

    <p>You can add new Snippets that work either globally (that is, they are
    language agnostic) or only in a particular syntax.</p>

    <steps>
      <item>
        <p>Select <guiseq style="menu"><gui style="menuitem">Tools</gui>
        <gui style="menuitem">Manage Snippets</gui></guiseq>.</p>
      </item>
      <item>
        <p>From the <gui>Manage Snippets</gui> sidebar select the desired syntax
        and click on the "+" button to list existing snippets for the selected
        syntax.</p>
        <note style="tip">
          <p>To add a snippet that works globally (that is, when no particular
          syntax or language has been set for the document), select
          <gui>Global</gui> from the <gui>Manage Snippets</gui> sidebar.</p>
        </note>
      </item>
      <item>
        <p>To add a new snippet, click on the "plus" icon in the
        <gui>Manage Snippets</gui> sidebar.</p>
      </item>
      <item>
        <p>Input a name for the new snippet. The name of the snippet can be
        different from the snippet you want to add.</p>
      </item>
      <item>
        <p>Under the <gui style="group">Activation</gui> section, you must
        input a term for the <gui style="input">Tab trigger:</gui> textarea.
        You will be using this term to insert your snippet.</p>
        <note style="tip">
          <p>If you wish to insert a snippet with a keyboard shortcut, then
          click your mouse pointer on <gui style="input">Shortcut key:</gui>
          textarea and press the desired combination of keys. Once you have
          pressed and released the keys, the keyboard shortcut will be set.</p>
        </note>
      </item>
      <item>
        <p>Under the textarea for <gui style="input">Edit:</gui>, input the
        desired text for the snippet. You may use <code>${n}</code> to indicate
        variables, where <em>n</em> is replaced with a number that
        represents the numerical order of variables included.</p>
      </item>
    </steps>

  </section>

  <section id="example-add-snippet">
    <title>New Snippet Example</title>

    <p>Consider you have created a snippet with the term <var>greetings</var>
    in <gui style="input">Tab trigger:</gui>. The
    <gui style="input">Edit:</gui> textarea contains:</p>

    <code>
      <![CDATA[<greetings>Hello ${1:wonderful}${2:amazing} world!
      </greetings>]]>
    </code>

    <p>You can insert this snippet by typing <var>greetings</var> in the
    document and pressing the <key>Tab</key> key. The following text snippet
    will be inserted:</p>

    <code>
      <![CDATA[<greetings>Hello wonderfulamazing world!</greetings>]]>
    </code>

    <p>The words "wonderful" and "amazing" can be retained or deleted depending
    on your choice of usage. To do so, press <key>Tab</key> to choose between
    "wonderful" and "amazing" and press <key>Del</key> to delete the least
    preferred option.</p>
  </section>

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

  </section>-->
</page>

APT Browse - Built by Thomas Orozco.