[gimp-help-2] Move some bibliographical refs to bibliography.xml
- From: Ulf-D. Ehlert <ulfehlert src gnome org>
- To: svn-commits-list gnome org
- Subject: [gimp-help-2] Move some bibliographical refs to bibliography.xml
- Date: Tue, 21 Jul 2009 10:26:46 +0000 (UTC)
commit d09aa5cfe60b199a56686523e10ec0d4b8064def
Author: Ulf-D. Ehlert <ulfehlert svn gnome org>
Date: Tue Jul 21 12:16:09 2009 +0200
Move some bibliographical refs to bibliography.xml
src/appendix/bibliography.xml | 87 +++++++++++++++++++++++++----------
src/filters/decor/carve-it.xml | 56 ++++++++++------------
src/filters/enhance/deinterlace.xml | 57 +++++++++++------------
src/introduction.xml | 13 ++---
src/using/fileformats.xml | 70 +++++++++++++++++-----------
5 files changed, 163 insertions(+), 120 deletions(-)
---
diff --git a/src/appendix/bibliography.xml b/src/appendix/bibliography.xml
index a136077..0022386 100644
--- a/src/appendix/bibliography.xml
+++ b/src/appendix/bibliography.xml
@@ -13,29 +13,6 @@
<bibliodiv id="bibliography-books">
<title>Books</title>
- <biblioentry id="bibliography-books-bunks">
- <abbrev>Bunks00</abbrev>
- <title>Grokking the Gimp</title>
- <author>
- <firstname>Carey</firstname>
- <surname>Bunks</surname>
- </author>
- <copyright>
- <year>2000</year>
- <holder>New Riders Publishing</holder>
- </copyright>
- <publisher>
- <publishername>
- New Riders Publishing, www.newriders.com
- </publishername>
- </publisher>
- <isbn>ISBN 0-7357-0924-6</isbn>
- <releaseinfo>
- <ulink url="http://gimp-savvy.com/BOOK/">
- http://gimp-savvy.com/BOOK
- </ulink>
- </releaseinfo>
- </biblioentry>
<biblioentry id="bibliography-books-apress">
<abbrev>APRESS00</abbrev>
<title>Beginning GIMP: From Novice to Professional</title>
@@ -72,7 +49,31 @@
<remark>2nd Ed. (Addison Wesley, 1990)</remark>
</releaseinfo>
</biblioentry>
+ <biblioentry id="bibliography-books-grokking">
+ <abbrev>GROKKING</abbrev>
+ <title>Grokking the Gimp</title>
+ <author>
+ <firstname>Carey</firstname>
+ <surname>Bunks</surname>
+ </author>
+ <copyright>
+ <year>2000</year>
+ <holder>New Riders Publishing</holder>
+ </copyright>
+ <publisher>
+ <publishername>
+ New Riders Publishing, www.newriders.com
+ </publishername>
+ </publisher>
+ <isbn>ISBN 0-7357-0924-6</isbn>
+ <releaseinfo>
+ <ulink url="http://gimp-savvy.com/BOOK/">
+ http://gimp-savvy.com/BOOK
+ </ulink>
+ </releaseinfo>
+ </biblioentry>
</bibliodiv>
+
<bibliodiv id="bibliography-online">
<title>Online resources</title>
<biblioentry id="bibliography-online-adobrgb">
@@ -84,6 +85,15 @@
</ulink>
</releaseinfo>
</biblioentry>
+ <biblioentry id="bibliography-online-apod">
+ <abbrev>APOD</abbrev>
+ <title>Astronomy Picture of the Day</title>
+ <releaseinfo>
+ <ulink url="http://antwrp.gsfc.nasa.gov/apod/">
+ http://antwrp.gsfc.nasa.gov/apod/
+ </ulink>
+ </releaseinfo>
+ </biblioentry>
<biblioentry id="bibliography-online-apod01">
<abbrev>APOD01</abbrev>
<title>Astronomy Picture of the Day (today)</title>
@@ -333,8 +343,8 @@
<abbrev>GIMP-DOCS</abbrev>
<title>GIMP Documentation project page</title>
<releaseinfo>
- <ulink url="http://docs.gimp.org/en">
- http://docs.gimp.org/en
+ <ulink url="http://docs.gimp.org">
+ http://docs.gimp.org
</ulink>
</releaseinfo>
</biblioentry>
@@ -424,6 +434,15 @@
</ulink>
</releaseinfo>
</biblioentry>
+ <biblioentry id="bibliography-online-gpl">
+ <abbrev>GPL</abbrev>
+ <title>General Public License (GPL)</title>
+ <releaseinfo>
+ <ulink url="http://www.fsf.org/licensing/licenses/gpl.html">
+ http://www.fsf.org/licensing/licenses/gpl.html
+ </ulink>
+ </releaseinfo>
+ </biblioentry>
<biblioentry id="bibliography-online-gqview">
<abbrev>GQVIEW</abbrev>
<title>Homepage of GQview, an image browser</title>
@@ -702,6 +721,24 @@
</ulink>
</releaseinfo>
</biblioentry>
+ <biblioentry id="bibliography-online-wkpd-deflate">
+ <abbrev>WKPD-DEFLATE</abbrev>
+ <title>Wikipedia - Deflate</title>
+ <releaseinfo>
+ <ulink url="http://en.wikipedia.org/wiki/deflate">
+ http://en.wikipedia.org/wiki/deflate
+ </ulink>
+ </releaseinfo>
+ </biblioentry>
+ <biblioentry id="bibliography-online-wkpd-deinterlace">
+ <abbrev>WKPD-DEINTERLACE</abbrev>
+ <title>Wikipedia - Deinterlace</title>
+ <releaseinfo>
+ <ulink url="http://en.wikipedia.org/wiki/Deinterlace">
+ http://en.wikipedia.org/wiki/Deinterlace
+ </ulink>
+ </releaseinfo>
+ </biblioentry>
<biblioentry id="bibliography-online-wkpd-dithering">
<abbrev>WKPD-DITHERING</abbrev>
<title>Wikipedia - Dithering</title>
diff --git a/src/filters/decor/carve-it.xml b/src/filters/decor/carve-it.xml
index 6a6996a..958de83 100644
--- a/src/filters/decor/carve-it.xml
+++ b/src/filters/decor/carve-it.xml
@@ -1,5 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.docbook.org/xml/4.3/docbookx.dtd">
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+ "http://www.docbook.org/xml/4.3/docbookx.dtd">
<!-- section history:
2009-06-23 j.h: Some changes for better understanding
2007-12-16 MikaS: added 'fr'
@@ -10,6 +11,7 @@
-->
<sect2 id="script-fu-carve-it">
<title>Stencil Carve</title>
+
<indexterm>
<primary>Filters</primary>
<secondary>Decor</secondary>
@@ -20,18 +22,13 @@
</indexterm>
<sect3>
- <title>
- <phrase>Overview</phrase>
- </title>
+ <title>Overview</title>
<figure>
- <title>
- <phrase>
- Example for the <quote>Stencil Carve</quote> filter
- </phrase>
- </title>
+ <title>Example for the <quote>Stencil Carve</quote> filter</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/filters/examples/taj_grayscale.jpg" format="JPG"/>
+ <imagedata format="JPG"
+ fileref="images/filters/examples/taj_grayscale.jpg"/>
</imageobject>
<caption>
<para>Original image</para>
@@ -39,7 +36,8 @@
</mediaobject>
<mediaobject>
<imageobject>
- <imagedata fileref="images/filters/examples/decor-taj-carve-it.jpg" format="JPG"/>
+ <imagedata format="JPG"
+ fileref="images/filters/examples/decor-taj-carve-it.jpg"/>
</imageobject>
<caption>
<para><quote>Stencil Carve</quote> applied</para>
@@ -55,10 +53,9 @@
target image must have the same size as the source image.
</para>
</sect3>
+
<sect3>
- <title>
- <phrase>Activating the filter</phrase>
- </title>
+ <title>Activating the filter</title>
<para>
This filter is found in the image window menu under
<menuchoice>
@@ -81,7 +78,8 @@
<title><quote>Stencil Carve</quote> options</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/filters/options-decor-carve-it.png" format="PNG"/>
+ <imagedata format="PNG"
+ fileref="images/filters/options-decor-carve-it.png"/>
</imageobject>
</mediaobject>
</figure>
@@ -105,12 +103,11 @@
source image is used as stencil, e.g.:
</para>
<figure>
- <title>
- <phrase>Engraving Masks</phrase>
- </title>
+ <title>Engraving Masks</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/filters/examples/carve-it-mask.jpg" format="JPG"/>
+ <imagedata format="JPG"
+ fileref="images/filters/examples/carve-it-mask.jpg"/>
</imageobject>
<caption>
<para>Normal mask</para>
@@ -118,7 +115,8 @@
</mediaobject>
<mediaobject>
<imageobject>
- <imagedata fileref="images/filters/examples/carve-it-invmask.jpg" format="JPG"/>
+ <imagedata format="JPG"
+ fileref="images/filters/examples/carve-it-invmask.jpg"/>
</imageobject>
<caption>
<para>Inverted mask</para>
@@ -142,14 +140,11 @@
text.
</para>
<figure>
- <title>
- <phrase>
- Example for <quote>Carve white areas</quote>
- </phrase>
- </title>
+ <title>Example for <quote>Carve white areas</quote></title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/filters/examples/carve-it-normal.png" format="PNG"/>
+ <imagedata format="PNG"
+ fileref="images/filters/examples/carve-it-normal.png"/>
</imageobject>
<caption>
<para>White areas carved</para>
@@ -157,7 +152,8 @@
</mediaobject>
<mediaobject>
<imageobject>
- <imagedata fileref="images/filters/examples/carve-it-stencil.png" format="PNG"/>
+ <imagedata format="PNG"
+ fileref="images/filters/examples/carve-it-stencil.png"/>
</imageobject>
<caption>
<para>Stencil</para>
@@ -165,7 +161,8 @@
</mediaobject>
<mediaobject>
<imageobject>
- <imagedata fileref="images/filters/examples/carve-it-invers.png" format="PNG"/>
+ <imagedata format="PNG"
+ fileref="images/filters/examples/carve-it-invers.png"/>
</imageobject>
<caption>
<para>Black areas carved</para>
@@ -174,8 +171,7 @@
</figure>
<para>
Information about the many layers created by this filter can be
- found in
- <ulink url="http://gimp-savvy.com/BOOK/index.html">Grokking the GIMP (node77)</ulink>.
+ found in <xref linkend="bibliography-books-grokking"/>.
</para>
</listitem>
</varlistentry>
diff --git a/src/filters/enhance/deinterlace.xml b/src/filters/enhance/deinterlace.xml
index 97f6156..e80b3be 100644
--- a/src/filters/enhance/deinterlace.xml
+++ b/src/filters/enhance/deinterlace.xml
@@ -1,5 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.docbook.org/xml/4.3/docbookx.dtd">
+<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+ "http://www.docbook.org/xml/4.3/docbookx.dtd">
<!-- section history:
2007-08-19 AntI: added 'es'
2007-04-12 KoSt: added 'no'
@@ -8,9 +9,8 @@
050830 de added by axel.wernicke
-->
<sect2 id="plug-in-deinterlace">
- <title>
- Deinterlace
- </title>
+ <title>Deinterlace</title>
+
<indexterm>
<primary>Filters</primary>
<secondary>Enhance</secondary>
@@ -21,9 +21,7 @@
</indexterm>
<sect3>
- <title>
- Overview
- </title>
+ <title>Overview</title>
<para>
Images captured by videocards, especially when fast movement is
recorded, may look blurred and stripped, with split objects. This is
@@ -42,13 +40,12 @@
</para>
<para>
You can find interlaced images at
- <ulink url="http://en.wikipedia.org/wiki/Deinterlace">Wikipedia</ulink>.
+ <xref linkend="bibliography-online-wkpd-deinterlace"/>.
</para>
</sect3>
+
<sect3>
- <title>
- Activating the filter
- </title>
+ <title>Activating the filter</title>
<para>
You can find this filter through
<menuchoice>
@@ -60,16 +57,15 @@
</sect3>
<sect3>
- <title>
- Options
- </title>
+ <title>Options</title>
<figure>
<title>
Deinterlace filter options
</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/filters/options-enhance-deinterlace.png" format="PNG"/>
+ <imagedata format="PNG"
+ fileref="images/filters/options-enhance-deinterlace.png"/>
</imageobject>
</mediaobject>
</figure>
@@ -96,32 +92,31 @@
</sect3>
<sect3>
- <title>
- Example
- </title>
+ <title>Example</title>
<figure>
- <title>
- Simple applying example for the Deinterlace filter
- </title>
+ <title>Simple applying example for the Deinterlace filter</title>
<mediaobject>
<imageobject>
- <imagedata fileref="images/filters/examples/interlaced.png" format="PNG"/>
+ <imagedata format="PNG"
+ fileref="images/filters/examples/interlaced.png"/>
</imageobject>
<caption>
<para>
- Top : even lines pixels are shifted by one pixel to the right.
- Bottom : one line is missing. These images are zoomed to show
+ Top: even lines pixels are shifted by one pixel to the right.
+ Bottom: one line is missing. These images are zoomed to show
pixels.
</para>
</caption>
</mediaobject>
<mediaobject>
<imageobject>
- <imagedata fileref="images/filters/examples/deinterlaced-1.png" format="PNG"/>
+ <imagedata format="PNG"
+ fileref="images/filters/examples/deinterlaced-1.png"/>
</imageobject>
<caption>
- <para><quote>Keep even fields checked</quote>.
- Top : odd lines have been shifted to the right, to align
+ <para>
+ <quote>Keep even fields checked</quote>.
+ Top: odd lines have been shifted to the right, to align
themselves with the even lines. Bottom: the empty line has been
filled with red.
</para>
@@ -129,11 +124,13 @@
</mediaobject>
<mediaobject>
<imageobject>
- <imagedata fileref="images/filters/examples/deinterlaced-2.png" format="PNG"/>
+ <imagedata format="PNG"
+ fileref="images/filters/examples/deinterlaced-2.png"/>
</imageobject>
<caption>
- <para><quote>Keep odd fields</quote> checked.
- Top : even lines have been shifted to the left, to align
+ <para>
+ <quote>Keep odd fields</quote> checked.
+ Top: even lines have been shifted to the left, to align
themselves with the odd lines. Bottom: the empty line persists,
but joins up and down through a gradient.
</para>
diff --git a/src/introduction.xml b/src/introduction.xml
index 6e6d10c..dfd8145 100644
--- a/src/introduction.xml
+++ b/src/introduction.xml
@@ -48,9 +48,8 @@
operating systems such as <productname>Microsoft Windows</productname>
or Apple's <productname>Mac OS X</productname>
(<application>Darwin</application>). The <acronym>GIMP</acronym>
- is a Free Software application covered by the General Public License (
- <ulink url="http://www.fsf.org/licensing/licenses/gpl.html">
- <acronym>GPL</acronym> license</ulink>). The <acronym>GPL</acronym>
+ is a Free Software application covered by the General Public License
+ <xref linkend="bibliography-online-gpl"/>. The <acronym>GPL</acronym>
provides users with the freedom to access and alter the source code that
makes up computer programs.
</para>
@@ -75,10 +74,10 @@
users have provided you with the information necessary to understand
how to use <acronym>GIMP</acronym>. The User Manual is
an important part of this help. The current version is on
- the <ulink url="http://docs.gimp.org">web site</ulink> of the
- Documentation Team in HTML format. The HTML version is also available
- as context sensitive help (if you installed it)
- while using <acronym>GIMP</acronym> by pressing the
+ the web site of the Documentation Team
+ <xref linkend="bibliography-online-gimp-docs"/> in HTML format. The HTML
+ version is also available as context sensitive help (if you installed
+ it) while using <acronym>GIMP</acronym> by pressing the
<keycap>F1</keycap> key. Help on specific menu items can be accessed
by pressing the <keycap>F1</keycap> key while the mouse pointer is
focused on the menu item. Read on to begin your
diff --git a/src/using/fileformats.xml b/src/using/fileformats.xml
index c4d61bf..06b5002 100644
--- a/src/using/fileformats.xml
+++ b/src/using/fileformats.xml
@@ -205,20 +205,23 @@
</para>
<itemizedlist mark="opencircle">
<listitem>
- <para><guilabel>I don't care</guilabel>
- : you can use this option if all your layers are
+ <para>
+ <guilabel>I don't care</guilabel>:
+ you can use this option if all your layers are
opaque. Layers will overwrite what is beneath.
</para>
</listitem>
<listitem>
- <para><guilabel>Cumulative Layers (combine)</guilabel>
- : previous frames will not be deleted when a new one
+ <para>
+ <guilabel>Cumulative Layers (combine)</guilabel>:
+ previous frames will not be deleted when a new one
is displayed.
</para>
</listitem>
<listitem>
- <para><guilabel>One frame per layer (replace)</guilabel>
- : previous frames will be deleted before displaying a
+ <para>
+ <guilabel>One frame per layer (replace)</guilabel>:
+ previous frames will be deleted before displaying a
new frame.
</para>
</listitem>
@@ -406,11 +409,10 @@
</term>
<listitem>
<para>
- If a particular quality setting (or
- <quote>quantization table</quote>
- ) was attached to the image when it was loaded, then this
- option allows you to use them instead of the standard
- ones.
+ If a particular quality setting (or <quote>quantization
+ table</quote>) was attached to the image when it was
+ loaded, then this option allows you to use them instead of
+ the standard ones.
</para>
<para>
If you have only made a few changes to the image, then
@@ -463,8 +465,9 @@
</para>
<itemizedlist>
<listitem>
- <para><guilabel>1x1,1x1,1x1 (best quality)</guilabel>
- : preserves borders and contrasting colors, but
+ <para>
+ <guilabel>1x1,1x1,1x1 (best quality)</guilabel>:
+ preserves borders and contrasting colors, but
compression is less.
</para>
</listitem>
@@ -479,8 +482,9 @@
</para>
</listitem>
<listitem>
- <para><guilabel>2x2,1x1,1x1 (smallest file)</guilabel>
- : important compression; suits images with weak
+ <para>
+ <guilabel>2x2,1x1,1x1 (smallest file)</guilabel>:
+ important compression; suits images with weak
borders but tends to denature colors.
</para>
</listitem>
@@ -499,8 +503,9 @@
</para>
<itemizedlist>
<listitem>
- <para><guilabel>float</guilabel>
- : The float method is very slightly more accurate than
+ <para>
+ <guilabel>float</guilabel>:
+ The float method is very slightly more accurate than
the integer method, but is much slower unless your
machine has very fast floating-point hardware. Also
note that the results of the floating-point method may
@@ -509,14 +514,16 @@
</para>
</listitem>
<listitem>
- <para><guilabel>integer</guilabel>
+ <para>
+ <guilabel>integer</guilabel>
(the default): This method is faster than
<quote>float</quote>, but not as accurate.
</para>
</listitem>
<listitem>
- <para><guilabel>fast integer</guilabel>
- : The fast integer method is much less accurate than
+ <para>
+ <guilabel>fast integer</guilabel>:
+ The fast integer method is much less accurate than
the other two.
</para>
</listitem>
@@ -717,12 +724,14 @@
</para>
<itemizedlist>
<listitem>
- <para><guilabel>None</guilabel> : fast method, but resulting in
+ <para>
+ <guilabel>None</guilabel>: fast method, but resulting in
a big file.
</para>
</listitem>
<listitem>
- <para><guilabel>LZW</guilabel> : The image will be compressed
+ <para>
+ <guilabel>LZW</guilabel>: The image will be compressed
using the <quote>Lempel-Ziv-Welch</quote> algorithm, a
lossless compression technique. This is an old method,
still efficient and fast. More informations at
@@ -730,7 +739,8 @@
</para>
</listitem>
<listitem>
- <para><guilabel>Pack Bits</guilabel> : is a fast, simple
+ <para>
+ <guilabel>Pack Bits</guilabel>: is a fast, simple
compression scheme for run-length encoding of data. Apple
introduced the PackBits format with the release of
MacPaint on the Macintosh computer. A PackBits data
@@ -740,21 +750,25 @@
</para>
</listitem>
<listitem>
- <para><guilabel>Deflate</guilabel>: It is a lossless data
+ <para>
+ <guilabel>Deflate</guilabel>: It is a lossless data
compression algorithm that uses a combination of the LZ77
algorithm and Huffman coding. It is also used in Zip,
Gzip and PNG file formats. Source:
- <ulink url="http://en.wikipedia.org/wiki/Deflate">Wikipedia</ulink>.
+ <xref linkend="bibliography-online-wkpd-deflate"/>.
</para>
</listitem>
<listitem>
- <para><guilabel>JPEG</guilabel>: this is a very good
+ <para>
+ <guilabel>JPEG</guilabel>: this is a very good
compression algorithm but lossy.
</para>
</listitem>
<listitem>
- <para><guilabel>CCITT Group 3 fax</guilabel>;
- <guilabel>CCITT Group 4 fax</guilabel></para>
+ <para>
+ <guilabel>CCITT Group 3 fax</guilabel>;
+ <guilabel>CCITT Group 4 fax</guilabel>
+ </para>
<note>
<para>
These options can only be selected, if the image is in
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]