GNOME.org
 

[gimp-help-2] Add some section ids

commit 17314bee9dfe480a91ceb211d82c67e192da1f97
Author: Ulf-D. Ehlert <ulfehlert svn gnome org>
Date:   Mon Aug 24 20:24:38 2009 +0200

    Add some section ids
    
    Section ids produce meaningful HTML file names
    instead of cryptic names like "ch01s02s03.html".

 src/concepts/qmask.xml               |   49 ++++++++++++++++-----------------
 src/concepts/script-fu.xml           |    8 +++---
 src/gimp.xml                         |    8 +++---
 src/key-reference.xml                |   32 +++++++++++-----------
 src/tutorial/straight-lines.xml      |    6 ++--
 src/using/customize-splashscreen.xml |    2 +-
 src/using/paths.xml                  |    6 ++--
 7 files changed, 55 insertions(+), 56 deletions(-)
---
diff --git a/src/concepts/qmask.xml b/src/concepts/qmask.xml
index 49ec2c6..6bd5c71 100644
--- a/src/concepts/qmask.xml
+++ b/src/concepts/qmask.xml
@@ -1,5 +1,6 @@
 <?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";>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+                       "http://www.docbook.org/xml/4.3/docbookx.dtd";>
 <!--Section History
   2009-02-21 j.h: revised for v2.6. No change
   2006-09-06: added norwegian translation by KoSt
@@ -11,19 +12,18 @@
   in manual by j.h
 -->
 <sect1 id="gimp-image-window-qmask-button">
-  <title>
-    <phrase>QuickMask</phrase>
-  </title>
+  <title>QuickMask</title>
+
   <indexterm>
     <primary>QuickMask</primary>
   </indexterm>
+
   <figure>
-    <title>
-      <phrase>Image with QuickMask enabled</phrase>
-    </title>
+    <title>Image with QuickMask enabled</title>
     <mediaobject>
       <imageobject>
-        <imagedata fileref="images/dialogs/channel-quickmask.png" format="PNG"/>
+        <imagedata format="PNG"
+          fileref="images/dialogs/channel-quickmask.png"/>
       </imageobject>
     </mediaobject>
   </figure>
@@ -34,10 +34,9 @@
     things much easier.  Simply put, the QuickMask allows you to paint a
     selection instead of just tracing its outline.
   </para>
-  <sect2>
-    <title>
-      <phrase>Overview</phrase>
-    </title>
+
+  <sect2 id="gimp-image-window-qmask-overview">
+    <title>Overview</title>
     <para>
       Normally when you create a selection in <acronym>GIMP</acronym>, you see
       it represented by
@@ -59,7 +58,10 @@
       the image window. The button is a toggle, so clicking it again will
       return you to normal marching-ant mode. You can also activate the
       QuickMask by selecting in the image window menu
-      <menuchoice><guimenu>Select</guimenu><guimenuitem>Toggle QuickMask</guimenuitem></menuchoice>, or by using the
+      <menuchoice>
+        <guimenu>Select</guimenu>
+        <guimenuitem>Toggle QuickMask</guimenuitem>
+      </menuchoice>, or by using the
       <keycombo><keycap>Shift</keycap><keycap>Q</keycap></keycombo>
       shortcut.
     </para>
@@ -78,9 +80,8 @@
       pixels to be selected; painting with black causes them to be
       unselected. You can use any of the paint tools, as well as the bucket
       fill and gradient fill tools, in this way. Advanced users of
-<acronym>GIMP</acronym>
-      learn that <quote>painting the selection</quote> is the easiest and
-      most effective way to delicately manipulate it.
+      <acronym>GIMP</acronym> learn that <quote>painting the selection</quote>
+      is the easiest and most effective way to delicately manipulate it.
     </para>
     <tip>
       <para>
@@ -111,10 +112,8 @@
     </para>
   </sect2>
 
-  <sect2>
-    <title>
-      <phrase>Properties</phrase>
-    </title>
+  <sect2 id="gimp-image-window-qmask-properties">
+    <title>Properties</title>
     <para>
         There are two QuickMask properties you can change by right-clicking
         on the QuickMask button.
@@ -122,11 +121,11 @@
     <itemizedlist>
       <listitem>
         <para>
-            Normally the QuickMask shows unselected areas <quote>fogged over
-            </quote> and selected areas <quote>in clear</quote>, but you can
-            reverse this by choosing <quote>Mask Selected Areas</quote>
-            instead of the default <quote>Mask Unselected Areas</quote>.
-          </para>
+          Normally the QuickMask shows unselected areas <quote>fogged over
+          </quote> and selected areas <quote>in clear</quote>, but you can
+          reverse this by choosing <quote>Mask Selected Areas</quote> instead
+          of the default <quote>Mask Unselected Areas</quote>.
+        </para>
       </listitem>
       <listitem>
         <para>
diff --git a/src/concepts/script-fu.xml b/src/concepts/script-fu.xml
index 423abe0..507598f 100644
--- a/src/concepts/script-fu.xml
+++ b/src/concepts/script-fu.xml
@@ -10,7 +10,7 @@
       2006-01-06 updated fr
       2006-01-05 fixed ambigous description of installing new script-fu
       scripts (#324309)
-      -->
+-->
 <sect1 id="gimp-concepts-script-fu">
   <title>Using Script-Fu Scripts</title>
 
@@ -106,7 +106,7 @@
     </procedure>
   </sect2>
 
-  <sect2>
+  <sect2 id="common-script-fu-errors">
     <title>Do's and Don'ts</title>
     <para>
       A common error when you are dealing with Script-Fus is that you simply
@@ -116,7 +116,7 @@
     </para>
   </sect2>
 
-  <sect2>
+  <sect2 id="kinds-of-script-fu">
     <title>Different Kinds Of Script-Fus</title>
     <para>
       There are two kinds of Script-Fus:
@@ -381,7 +381,7 @@
     </variablelist>
   </sect2>
 
-  <sect2>
+  <sect2 id="image-independent-script-fu">
     <title>Image-Dependent Scripts</title>
     <para>
       Now, scripts and filters that perform operations on an existing image are
diff --git a/src/gimp.xml b/src/gimp.xml
index daec79d..b827f29 100644
--- a/src/gimp.xml
+++ b/src/gimp.xml
@@ -46,11 +46,11 @@
     </legalnotice>
   </bookinfo>
   <toc/>
-  <preface>
+  <preface id="preface">
     <title>Preface</title>
     <xi:include href="preface/authors.xml"/>
   </preface>
-  <part>
+  <part id="getting-started">
     <title>Getting Started</title>
     <chapter id="introduction">
       <title>Introduction</title>
@@ -75,7 +75,7 @@
       <xi:include href="using/getting-unstuck.xml"/>
     </chapter>
   </part>
-  <part>
+  <part id="become-a-gimp-wizard">
     <title>
       How do I Become a <acronym>GIMP</acronym> Wizard?
     </title>
@@ -148,7 +148,7 @@
       <xi:include href="using/script-fu-tutorial.xml"/>
     </chapter>
   </part>
-  <part>
+  <part id="gimp-function-reference">
     <title>Function Reference</title>
     <chapter id="gimp-toolbox">
       <title>Toolbox</title>
diff --git a/src/key-reference.xml b/src/key-reference.xml
index ad0d5f4..bb8ccf8 100644
--- a/src/key-reference.xml
+++ b/src/key-reference.xml
@@ -4,7 +4,7 @@
 
 <reference id="key-reference">
   <title>Keys and Mouse Reference</title>
-  <refentry>
+  <refentry id="key-reference-help">
     <refmeta>
       <refentrytitle>Help</refentrytitle>
     </refmeta>
@@ -32,7 +32,7 @@
       </variablelist>
     </refsect1>
   </refentry>
-  <refentry>
+  <refentry id="key-reference-tools">
     <refmeta>
       <refentrytitle>Tools</refentrytitle>
     </refmeta>
@@ -234,7 +234,7 @@
       </note>
     </refsect1>
   </refentry>
-  <refentry>
+  <refentry id="key-reference-file">
     <refmeta>
       <refentrytitle>File</refentrytitle>
     </refmeta>
@@ -360,7 +360,7 @@
   </refentry>
 
   <!-- TODO:check -->
-  <refentry>
+  <refentry id="key-reference-dialogs">
     <refmeta>
       <refentrytitle>Dialogs</refentrytitle>
     </refmeta>
@@ -539,7 +539,7 @@
       </variablelist>
     </refsect1>
   </refentry>
-  <refentry>
+  <refentry id="key-reference-view">
     <refmeta>
       <refentrytitle>View</refentrytitle>
     </refmeta>
@@ -717,7 +717,7 @@
       </note>
     </refsect1>
   </refentry>
-  <refentry>
+  <refentry id="key-reference-edit">
     <refmeta>
       <refentrytitle>Edit</refentrytitle>
     </refmeta>
@@ -826,14 +826,14 @@
       </variablelist>
     </refsect1>
   </refentry>
-  <refentry>
+  <refentry id="key-reference-layer">
     <refmeta>
-      <refentrytitle>Layers</refentrytitle>
+      <refentrytitle>Layer</refentrytitle>
     </refmeta>
     <refnamediv>
-      <refname>Layers</refname>
+      <refname>Layer</refname>
       <refpurpose>
-        Key reference for <guimenuitem>Layers</guimenuitem> menu
+        Key reference for <guimenuitem>Layer</guimenuitem> menu
       </refpurpose>
     </refnamediv>
     <refsect1>
@@ -882,14 +882,14 @@
       </variablelist>
     </refsect1>
   </refentry>
-  <refentry>
+  <refentry id="key-reference-select">
     <refmeta>
-      <refentrytitle>Selections</refentrytitle>
+      <refentrytitle>Select</refentrytitle>
     </refmeta>
     <refnamediv>
-      <refname>Selections</refname>
+      <refname>Select</refname>
       <refpurpose>
-        Key reference for <guimenuitem>Selections</guimenuitem> menu
+        Key reference for <guimenuitem>Select</guimenuitem> menu
       </refpurpose>
     </refnamediv>
     <refsect1>
@@ -940,7 +940,7 @@
       </variablelist>
     </refsect1>
   </refentry>
-  <refentry>
+  <refentry id="key-reference-filters">
     <refmeta>
       <refentrytitle>Filters</refentrytitle>
     </refmeta>
@@ -971,7 +971,7 @@
       </variablelist>
     </refsect1>
   </refentry>
-  <refentry>
+  <refentry id="key-reference-zoom">
     <refmeta>
       <refentrytitle>Zoom tool</refentrytitle>
     </refmeta>
diff --git a/src/tutorial/straight-lines.xml b/src/tutorial/straight-lines.xml
index 6f5af89..11c24dc 100644
--- a/src/tutorial/straight-lines.xml
+++ b/src/tutorial/straight-lines.xml
@@ -24,7 +24,7 @@
     <xref linkend="bibliography-online-tutorial01"/>.
   </para>
 
-  <sect2>
+  <sect2 id="gimp-tutorial-straight-lines-intention">
     <title>Intention</title>
     <figure>
       <title>Example of straight lines</title>
@@ -37,7 +37,7 @@
     </figure>
     <para>
       This tutorial shows you how to draw straight lines with
-      <acronym>GIMP</acronym>.Forcing a line to be straight is a
+      <acronym>GIMP</acronym>. Forcing a line to be straight is a
       convenient way to deal with the imprecision of a
       mouse or tablet, and to take advantage of the power of a computer to
       make things look neat and orderly. This tutorial doesn't use Straight
@@ -171,7 +171,7 @@
     </procedure>
   </sect2>
 
-  <sect2>
+  <sect2 id="gimp-tutorial-straight-lines-examples">
     <title>Examples</title>
     <figure>
       <title>Examples I</title>
diff --git a/src/using/customize-splashscreen.xml b/src/using/customize-splashscreen.xml
index cd9a9c2..3af7198 100644
--- a/src/using/customize-splashscreen.xml
+++ b/src/using/customize-splashscreen.xml
@@ -9,7 +9,7 @@
   2007-05-16: ude: German translation
   2007-05-10: created by j.h
 -->
-<sect1 id="using-customize-splashscreen">
+<sect1 id="customize-splashscreen">
   <title>Customize Splash-Screen</title>
 
   <indexterm>
diff --git a/src/using/paths.xml b/src/using/paths.xml
index 8591f6b..dbdf191 100644
--- a/src/using/paths.xml
+++ b/src/using/paths.xml
@@ -212,7 +212,7 @@
     </para>
   </sect2>
 
-  <sect2>
+  <sect2 id="gimp-using-paths-and-selections">
     <title>Paths and Selections</title>
     <para>
       GIMP lets you transform the selection for an image into a path; it also
@@ -312,7 +312,7 @@
     </para>
   </sect2>
 
-  <sect2>
+  <sect2 id="gimp-using-paths-and-text">
     <title>Paths and Text</title>
     <figure>
       <title>Text converted to a path</title>
@@ -365,7 +365,7 @@
     </itemizedlist>
   </sect2>
 
-  <sect2>
+  <sect2 id="gimp-using-paths-and-svg">
     <title>Paths and <acronym>SVG</acronym> files</title>
     <para>
       <acronym>SVG</acronym>, standing for <quote>Scalable Vector
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]