[gimp-help-2] Add new tagging.xml
- From: Julien Hardlin <jhardlin src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp-help-2] Add new tagging.xml
- Date: Sat, 3 Mar 2012 07:11:54 +0000 (UTC)
commit d7dfa2d19aa588217302a2c81c017bffa31c6728
Author: Julien Hardelin <jm hard wanadoo fr>
Date: Sat Mar 3 08:12:18 2012 +0100
Add new tagging.xml
images/C/using/tagging.png | Bin 0 -> 21686 bytes
images/C/using/tagging2.png | Bin 0 -> 14995 bytes
src/dialogs/brushes-dialog.xml | 95 +++++++++++++++------------------------
src/dialogs/dialogs-content.xml | 2 +
src/dialogs/gradient-dialog.xml | 62 +++++++++----------------
src/dialogs/palettes-dialog.xml | 14 ++++++
src/dialogs/patterns-dialog.xml | 9 ++++
src/dialogs/tagging.xml | 87 +++++++++++++++++++++++++++++++++++
8 files changed, 172 insertions(+), 97 deletions(-)
---
diff --git a/images/C/using/tagging.png b/images/C/using/tagging.png
new file mode 100755
index 0000000..a54b57c
Binary files /dev/null and b/images/C/using/tagging.png differ
diff --git a/images/C/using/tagging2.png b/images/C/using/tagging2.png
new file mode 100755
index 0000000..ce1379e
Binary files /dev/null and b/images/C/using/tagging2.png differ
diff --git a/src/dialogs/brushes-dialog.xml b/src/dialogs/brushes-dialog.xml
old mode 100644
new mode 100755
index 97fe6c5..d9cc507
--- a/src/dialogs/brushes-dialog.xml
+++ b/src/dialogs/brushes-dialog.xml
@@ -2,14 +2,12 @@
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
+ 2012-03-02 j.h: added link to tagging
2009-06-02 j.h: added Ctrl+F for search field in list
- 2008-12-13 j.h: updated to v2.6 en;fr
- 2007-12-13 ude: updated de; changed en layout
+ 2008-12-13 j.h: updated to v2.6
+ 2007-12-13 ude: changed en layout
2007-08-13 j.h added Copy Brush Location
- 2007-08-04 jh : updated en;fr to 2.4
- 2007-03-06 KoSt: added 'no'
- 2006-08-19 ciampix: added italian translation
- 2006-03-30 lexa: added german translation and docbook compliance
+ 2007-08-04 jh : updated to 2.4
2006-02-24 Written Brush Editor en;fr by j.h
2005-11-28 replaced informalfigures by figures by lexa
-->
@@ -43,10 +41,10 @@
section for basic information on brushes and how they are used in GIMP.
The dialog also gives you access to several functions for manipulating
brushes. You can select a brush by clicking on it in the list: it will
- then be shown in the Brush/Pattern/Gradient area of the Toolbox. A few
- dozen basic brushes come pre-installed with GIMP, along with a few
- assorted bizarre ones that mainly serve to show you the range of
- possibilities. You can also create custom brushes using the Brush Editor,
+ then be shown in the Brush/Pattern/Gradient area of the Toolbox. GIMP
+ comes now with 56 brushes, different from each other, because the
+ size, the ratio and the angle of every brush can be set in the tool
+ options dialog. You can also create custom brushes using the Brush Editor,
or by saving images in a special brush file format.
</para>
@@ -207,13 +205,13 @@
alter the resources that GIMP pre-installs for you: brushes,
patterns, gradients, etc; only ones that you create yourself.
</para>
- <tip>
+ <!--<tip>
<para>
<keycombo><keycap>Ctrl</keycap><keycap>F</keycap></keycombo>
opens a search field.
See <xref linkend="gimp-dock-view-as-list" />
</para>
- </tip>
+ </tip>-->
</listitem>
</varlistentry>
</variablelist>
@@ -249,8 +247,8 @@
</listitem>
<listitem>
<para>
- A small cross means that the brush is in a reduced size. You can
- get it in normal size by maintaining left click on it.
+ A small cross means that the brush preview is in a reduced size. You
+ can get it in normal size by maintaining left click on it.
</para>
</listitem>
<listitem>
@@ -262,6 +260,14 @@
</itemizedlist>
</sect4>
+ <sect4 id="gimp-brush-dialog-tags">
+ <title>Tagging</title>
+ <para>
+ You can use tags to reorganize the gradients display.
+ See <xref linkend="gimp-tagging"/>.
+ </para>
+ </sect4>
+
<sect4 id="gimp-brush-dialog-buttons">
<title>Buttons at the bottom</title>
<para>
@@ -280,18 +286,13 @@
<para>
This slider lets you set the distance between consecutive brush
marks when you trace out a brushstroke with the mouse pointer.
- Spacing is a percentage of the brush width and varies from 1 to
- 200.
+ Spacing is a percentage of the brush width.
</para>
</listitem>
</varlistentry>
+
<varlistentry>
- <term>
- <guiicon>
- <inlinegraphic fileref="images/dialogs/stock-edit-16.png"/>
- </guiicon>
- <phrase condition="tag-is-required">Edit Brush</phrase>
- </term>
+ <term>Edit Brush</term>
<listitem>
<para>
This activates the
@@ -303,13 +304,9 @@
</para>
</listitem>
</varlistentry>
+
<varlistentry>
- <term>
- <guiicon>
- <inlinegraphic fileref="images/dialogs/dialogs-icon-new.png"/>
- </guiicon>
- <phrase condition="tag-is-required">New Brush</phrase>
- </term>
+ <term>New Brush</term>
<listitem>
<anchor id="gimp-brush-new"/>
<para>
@@ -321,12 +318,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>
- <guiicon>
- <inlinegraphic fileref="images/dialogs/stock-duplicate-16.png"/>
- </guiicon>
- <phrase condition="tag-is-required">Duplicate Brush</phrase>
- </term>
+ <term>Duplicate Brush</term>
<listitem>
<anchor id="gimp-brush-duplicate"/>
<para>
@@ -339,37 +331,27 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>
- <guiicon>
- <inlinegraphic fileref="images/dialogs/dialogs-icon-delete.png"/>
- </guiicon>
- <phrase condition="tag-is-required">Delete Brush</phrase>
- </term>
+ <term>Delete Brush</term>
<listitem>
<anchor id="gimp-brush-delete"/>
<para>
- This removes all traces of the brush, both from the dialog and
+ This option is active for parametric brushes only.
+ This removes all traces of the brush, both from the dialog and
the folder where its file is stored, if you have permission to
do so. It asks for confirmation before doing anything.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term>
- <guiicon>
- <inlinegraphic fileref="images/dialogs/stock-reload-16.png"/>
- </guiicon>
- <phrase condition="tag-is-required">Refresh Brushes</phrase>
- </term>
+ <term>Refresh Brushes</term>
<listitem>
<anchor id="gimp-brush-refresh"/>
<para>
- If you add brushes to your personal
- <filename class="directory">brushes</filename>
+ If you add brushes to your personal <filename>brushes</filename>
folder or any other folder in your brush search path, by some
- means other than the Brush Editor,
- this button causes the list to be reloaded, so that the new
- entries will be available in the dialog.
+ means other than the Brush Editor, this button causes the list
+ to be reloaded, so that the new entries will be available in the
+ dialog.
</para>
</listitem>
</varlistentry>
@@ -431,16 +413,13 @@
brush from a geometrical shape, a circle, a square, a diamond. This
editor has several elements:
</para>
- <para>
- <emphasis>The dialog bar</emphasis>:
+ <para><emphasis>The dialog bar</emphasis>:
As with all dialog windows, a click on the small triangle prompts a
menu allowing you to set the aspect of the Brush Editor.
</para>
- <para>
- <emphasis>The title bar</emphasis>: To give a name to your brush.
+ <para><emphasis>The title bar</emphasis>: To give a name to your brush.
</para>
- <para>
- <emphasis>The preview area</emphasis>: Brush changes appear in real
+ <para><emphasis>The preview area</emphasis>: Brush changes appear in real
time in this preview.
</para>
<variablelist>
diff --git a/src/dialogs/dialogs-content.xml b/src/dialogs/dialogs-content.xml
old mode 100644
new mode 100755
index d1859c7..691ffe7
--- a/src/dialogs/dialogs-content.xml
+++ b/src/dialogs/dialogs-content.xml
@@ -2,6 +2,7 @@
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
+ 2012-03-02 j.h: added link to tagging
2006-03-13 lexa: created new structure for dialogs
-->
<sect1 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-dialogs-content">
@@ -11,5 +12,6 @@
<xi:include href="patterns-dialog.xml"/>
<xi:include href="gradient-dialog.xml"/>
<xi:include href="palettes-dialog.xml"/>
+ <xi:include href="tagging.xml"/>
<xi:include href="fonts-dialog.xml"/>
</sect1>
diff --git a/src/dialogs/gradient-dialog.xml b/src/dialogs/gradient-dialog.xml
old mode 100644
new mode 100755
index 241894c..3e2a8c9
--- a/src/dialogs/gradient-dialog.xml
+++ b/src/dialogs/gradient-dialog.xml
@@ -2,6 +2,7 @@
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
+ 2012-03-02 j.h: added link to tagging
2008-12-15 j.h: updated en;fr to v2.6
2008-02-22 j.h: added description for the four first gradients en;fr.
2008-01-18 ude: added v2.4. gradient menu options and screenshot
@@ -50,8 +51,7 @@
between Foreground and background colors of toolbox in different ways.
</para>
<listitem>
- <para>
- <guilabel>FG to BG (RGB)</guilabel>: default gradient, between the
+ <para><guilabel>FG to BG (RGB)</guilabel>: default gradient, between the
Foreground and the background colors of the Toolbox, in the RGB mode.
</para>
</listitem>
@@ -114,8 +114,7 @@
</listitem>
<listitem>
<para>
- From the image by using the
- <keycombo><keycap>Ctrl</keycap><keycap>G</keycap></keycombo> shortcut.
+ From the image by using the <keycap>Ctrl+G</keycap> shortcut.
</para>
</listitem>
</itemizedlist>
@@ -186,12 +185,7 @@
</para>
<variablelist>
<varlistentry>
- <term>
- <guiicon>
- <inlinegraphic fileref="images/dialogs/stock-edit-16.png"/>
- </guiicon>
- <phrase condition="tag-is-required">Edit Gradient</phrase>
- </term>
+ <term>Edit Gradient</term>
<listitem>
<para>
This button activates the
@@ -200,19 +194,14 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>
- <guiicon>
- <inlinegraphic fileref="images/dialogs/dialogs-icon-new.png"/>
- </guiicon>
- <phrase condition="tag-is-required">New Gradient</phrase>
- </term>
+ <term>New Gradient</term>
<listitem>
<anchor id="gimp-gradient-new"/>
<para>
This creates a new gradient, initialized as a simple grayscale,
and activates the Gradient Editor so that you can alter it.
Gradients that you create are automatically saved in the
- <filename class="directory">gradients</filename>
+ <filename>gradients</filename>
folder of your personal GIMP directory, from which they are
automatically loaded when GIMP starts. (You can change this
folder, or add new ones, using the Preferences dialog.)
@@ -220,12 +209,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>
- <guiicon>
- <inlinegraphic fileref="images/dialogs/stock-duplicate-16.png"/>
- </guiicon>
- <phrase condition="tag-is-required">Duplicate Gradient</phrase>
- </term>
+ <term>Duplicate Gradient</term>
<listitem>
<anchor id="gimp-gradient-duplicate"/>
<para>
@@ -235,12 +219,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>
- <guiicon>
- <inlinegraphic fileref="images/dialogs/dialogs-icon-delete.png"/>
- </guiicon>
- <phrase condition="tag-is-required">Delete Gradient</phrase>
- </term>
+ <term>Delete Gradient</term>
<listitem>
<anchor id="gimp-gradient-delete"/>
<para>
@@ -250,20 +229,15 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>
- <guiicon>
- <inlinegraphic fileref="images/dialogs/stock-reload-16.png"/>
- </guiicon>
- <phrase condition="tag-is-required">Refresh Gradients</phrase>
- </term>
+ <term>Refresh Gradients</term>
<listitem>
<anchor id="gimp-gradient-refresh"/>
<para>
If you add gradients to your personal
- <filename class="directory">gradients</filename>
- folder by some means other than this dialog,
- this button causes the list to be reloaded, so that the new
- entries will be available.
+ <filename>gradients</filename>
+ folder by some means other than this dialog, this button causes
+ the list to be reloaded, so that the new entries will be
+ available.
</para>
</listitem>
</varlistentry>
@@ -316,6 +290,16 @@
</listitem>
</varlistentry>
</variablelist>
+
+ <sect4 id="gimp-gradient-dialog-tags">
+ <title>Tagging</title>
+ <para>
+ You can use tags to reorganize the gradients display.
+ See <xref linkend="gimp-tagging"/>.
+ </para>
+ </sect4>
+
</sect3>
<xi:include href="gradient-editor-dialog.xml"/>
</sect2>
+
diff --git a/src/dialogs/palettes-dialog.xml b/src/dialogs/palettes-dialog.xml
old mode 100644
new mode 100755
index 6e97722..8778135
--- a/src/dialogs/palettes-dialog.xml
+++ b/src/dialogs/palettes-dialog.xml
@@ -2,6 +2,7 @@
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
+ 2012-03-02 j.h: added link to tagging
2008-12-15 j.h: updated en;fr to v2.6
2007-10-05 j.h: updated en;fr to v2.4.New options added
2007-08-15 j.h: v2.4 added Edit Active Palette option en;fr
@@ -150,6 +151,19 @@
</listitem>
</varlistentry>
</variablelist>
+
+ <variablelist id="gimp-palettes-dialog-tags">
+ <varlistentry>
+ <term>tagging</term>
+ <listitem>
+ <para>
+ You can use tags to reorganize the gradients display.
+ See <xref linkend="gimp-tagging"/>.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+
<variablelist>
<title>The buttons of the Palettes Dialog</title>
<para>
diff --git a/src/dialogs/patterns-dialog.xml b/src/dialogs/patterns-dialog.xml
old mode 100644
new mode 100755
index ee64daa..c848577
--- a/src/dialogs/patterns-dialog.xml
+++ b/src/dialogs/patterns-dialog.xml
@@ -2,6 +2,7 @@
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd";>
<!-- section history:
+ 2012-03-02 j.h: added link to tagging
2008-12-13 j.h: updated en;fr to v2.6
2007-10-05 KoSt: updated 'no'
2007-08-13 j.h: v2.4 en;fr revision. Open as an image added. Clipboard
@@ -262,6 +263,14 @@
</variablelist>
</sect3>
+ <sect3 id="gimp-patterns-dialog-tags">
+ <title>Tagging</title>
+ <para>
+ You can use tags to reorganize the gradients display.
+ See <xref linkend="gimp-tagging"/>.
+ </para>
+ </sect3>
+
<sect3>
<title>The Pattern context menu</title>
<para>
diff --git a/src/dialogs/tagging.xml b/src/dialogs/tagging.xml
new file mode 100755
index 0000000..6fe8106
--- /dev/null
+++ b/src/dialogs/tagging.xml
@@ -0,0 +1,87 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+ "http://www.docbook.org/xml/4.3/docbookx.dtd";>
+
+<!-- section history:
+ 2012-03-01 Created by j.h
+-->
+
+<sect2 id="gimp-tagging">
+ <title>Tagging</title>
+
+ <indexterm>
+ <primary>Tags</primary>
+ </indexterm>
+
+ <para>
+ In Brushes, Gradients, Patterns and Palettes dialogs, you can define
+ tags and then, you can reorganize items according to chosen tags only.
+ </para>
+
+ <para>
+ You have two input fields:
+ <figure>
+ <title>Tagging</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/using/tagging.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <quote>Filter</quote> field: There, you can enter a tag previously
+ defined or select a tag in the pop list you get by clicking on
+ the arrow head at the right end of the field. Brushes, gradients,
+ patterns, or palettes are filtered and only these that have this
+ chosen tag will be displayed.
+ You can enter several tags, separated with commas.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <quote>Enter tag</quote> field: There, tags belonging to the current
+ brush, gradient, pattern, or palette are displayed. You can add
+ another tag to the current item by clicking on one of the defined
+ tag in the pop up list of the field. You can also create your own
+ tag for this item by typing its name in the field. Then the new tag
+ appears in the tag pop up list.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </para>
+
+ <figure>
+ <title>Example</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/using/tagging2.png" format="PNG"/>
+ </imageobject>
+ <caption>
+ <para>
+ In this example, we defined a <quote>green</quote> tag for the Pepper
+ and Vine brushes. Then, we entered <quote>green</quote> in
+ the <guilabel>Filter</guilabel>input field and so, only
+ brushes with the green tag are displayed.
+ </para>
+ </caption>
+ </mediaobject>
+ </figure>
+
+ <tip>
+ <para>
+ To give several brushes the same tag at once, display brushes in
+ List Mode, and use <keycombo><keycap>Ctrl</keycap><mousebutton>
+ Left click</mousebutton></keycombo> on the brushes you want to
+ select.
+ </para>
+ </tip>
+
+ <para>
+ You can delete tags: select a brush, then select a tag in the <quote>Enter
+ tag</quote> field and press the <keycap>Delete</keycap> key. When this
+ tag has been removed from all brushes, it disappears from the list.
+ </para>
+
+</sect2>
\ No newline at end of file
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
