Git commit 15b09798752908f457760a4e21b8c27dff54f825 by Gilles Caulier.
Committed on 23/08/2016 at 07:44.
Pushed by cgilles into branch 'master'.

move intro background in dedicated docbook file

M  +8    -65   digikam/index.docbook
A  +72   -0    digikam/intro-background.docbook

http://commits.kde.org/digikam-doc/15b09798752908f457760a4e21b8c27dff54f825

diff --git a/digikam/index.docbook b/digikam/index.docbook
index b8f1249..db37ff1 100644
--- a/digikam/index.docbook
+++ b/digikam/index.docbook
@@ -9,6 +9,8 @@
   <!ENTITY path "">
   <!ENTITY doc-file-formats           SYSTEM "file-formats.docbook">
   <!ENTITY doc-sidebar                SYSTEM "sidebar.docbook">
+<!-- introduction -->
+  <!ENTITY doc-intro-background       SYSTEM "intro-background.docbook">
 <!-- image editor -->
   <!ENTITY doc-photo-editing          SYSTEM "photo-editing.docbook">
   <!ENTITY doc-editor-color           SYSTEM "editor-color.docbook">
@@ -17,7 +19,7 @@
   <!ENTITY doc-editor-filters         SYSTEM "editor-filters.docbook">
   <!ENTITY doc-editor-decorate        SYSTEM "editor-decorate.docbook">
   <!ENTITY doc-color-management       SYSTEM "color-management.docbook">
-<!-- bqm -->
+<!-- batch queue manager -->
   <!ENTITY doc-bqm-mainwindow         SYSTEM "bqm-mainwindow.docbook">
   <!ENTITY doc-bqm-rawconverter       SYSTEM "bqm-rawconverter.docbook">
 <!-- tools -->
@@ -83,72 +85,13 @@
 
 <!-- *********************************************************************** 
-->
 
-<chapter id="introduction">     <title>Introduction</title>
+<chapter id="introduction">    <title>Introduction</title>
 
- <sect1 id="using-background">         <title>Background</title>
+ <sect1 id="intro-background"> <title>Background</title>
 
-       <sect2 id="using-about">
-       <title>About &digikam;</title>
-
-       <para>
-       &digikam; is an advanced digital photo management application for 
Linux, MacOS and Windows desktop. It provides a simple interface which makes 
importing and organizing digital photographs a &quot;snap&quot;. &digikam; 
enables you to manage large numbers of digital photographs in Albums and to 
organize these photographs for easy retrieval using tags (keywords), captions, 
collections, dates, geolocation and searches. It has many features for viewing, 
organizing, processing and sharing your images. Thus, &digikam; is a formidable 
<link linkend="dam">Digital Asset Management</link> (DAM) software including 
powerful image editing functions.
-       </para>
-
-       <para>
-       An easy-to-use Camera interface is provided, that will connect to your 
digital camera and download photographs directly into &digikam; Albums. More 
than <ulink url="http://www.gphoto.org/proj/libgphoto2/support.php";>1000 
digital cameras</ulink> are supported by the gphoto2 library. Of course, any 
media or card reader supported by your operating system will interface with 
&digikam;.
-       </para>
-
-       <para>&digikam; incorporates a fast Image Editor with many image 
editing tools. You can use the Image Editor to view your photographs, comment 
and rate them, correct, enhance and alter them. The images post processing  can 
be easily extended by a set of plugins, the <ulink 
url="https://quickgit.kde.org/?p=kipi-plugins.git";>KIPI project</ulink> (<ulink 
url="help:/kipi-plugins/index.html">manual</ulink>) dedicated to work with 
remote web services.
-       </para>
-
-       <para>While &digikam; remains easy to use, it provides professional 
level features by the dozens. It is fully 16 bit enabled including all 
available plugins, supports RAW format conversion through libraw, DNG export 
and ICC color management <link linkend="rawprocessing.anchor">work flow</link>.
-       </para>
-       </sect2>
-
-       <sect2>
-       <title>Reporting Bugs</title>
-
-       <para>
-       &digikam; is an Open Source project. This means that it relies on its 
users to play their part by, at least, reporting problems and suggesting 
possible improvements.
-       </para>
-
-       <para>
-       &digikam; makes it as easy as possible for you to report bugs or 
suggest improvements. Wherever you are in the application the Help menu will 
include a Report Bugs option. This will display a message box with a 
highlighted link. Click on the link and your web browser will open the page for 
the reporting system. All the information required will already be filled in, 
just follow the instructions for completing your report.
-       </para>
-       </sect2>
-
-       <sect2>
-       <title>Support</title>
-
-       <para>
-       &digikam; is a community supported project, which means that users and 
developers support one another. If you become a regular user of &digikam; you 
are encouraged to join the &digikam; Users Mailing List. You can start off by 
asking questions to other &digikam; users and hopefully soon you will be 
answering the support questions of others.
-       </para>
-
-       <para>
-       <ulink 
url="https://mail.kde.org/mailman/listinfo/digikam-users";>&digikam; Users 
Mailing
-       List joining instructions.</ulink>
-       </para>
-
-       <para>
-       You can also visit the <ulink url="http://www.digikam.org";>&digikam; 
Home Page.</ulink> for news of new releases and other &digikam; related 
information.
-       </para>
-       </sect2>
-
-       <sect2>
-       <title>Getting Involved</title>
-
-       <para>
-       There are many ways that you can get involved with the continued 
development of &digikam;. You do not need to be a software developer. You can 
help with documentation, translation and user interface design or just 
contribute really good ideas to the wish-list. You can also get involved by 
testing early development code as it is being developed and providing feedback 
to the developers. Of course, if you are a software developer then you can help 
to make &digikam; the best digital photograph application there is.
-       </para>
-
-       <para>
-       The best way to start getting involved with &digikam; is to join the 
Developers Mailing List.
-       <ulink 
url="https://mail.kde.org/mailman/listinfo/digikam-devel";>&digikam; Developer 
Mailing
-       List joining instructions.</ulink>
-       </para>
-       </sect2>
-
-    </sect1>
+    &doc-intro-background;
+     
+</sect1>
 
  <sect1 id="using-firstrun">           <title>Getting Started</title>
 
diff --git a/digikam/intro-background.docbook b/digikam/intro-background.docbook
new file mode 100644
index 0000000..3f7b1f2
--- /dev/null
+++ b/digikam/intro-background.docbook
@@ -0,0 +1,72 @@
+<sect2 id="intro-about">
+    <title>About &digikam;</title>
+
+    <para>
+    &digikam; is an advanced digital photo management application for Linux, 
MacOS and Windows desktop. It provides a simple interface which makes importing 
and organizing digital photographs a &quot;snap&quot;. &digikam; enables you to 
manage large numbers of digital photographs in Albums and to organize these 
photographs for easy retrieval using tags (keywords), captions, collections, 
dates, geolocation and searches. It has many features for viewing, organizing, 
processing and sharing your images. Thus, &digikam; is a formidable <link 
linkend="dam">Digital Asset Management</link> (DAM) software including powerful 
image editing functions.
+    </para>
+
+    <para>
+    An easy-to-use Camera interface is provided, that will connect to your 
digital camera and download photographs directly into &digikam; Albums. More 
than <ulink url="http://www.gphoto.org/proj/libgphoto2/support.php";>1000 
digital cameras</ulink> are supported by the gphoto2 library. Of course, any 
media or card reader supported by your operating system will interface with 
&digikam;.
+    </para>
+
+    <para>&digikam; incorporates a fast Image Editor with many image editing 
tools. You can use the Image Editor to view your photographs, comment and rate 
them, correct, enhance and alter them. The images post processing  can be 
easily extended by a set of plugins, the <ulink 
url="https://quickgit.kde.org/?p=kipi-plugins.git";>KIPI project</ulink> (<ulink 
url="help:/kipi-plugins/index.html">manual</ulink>) dedicated to work with 
remote web services.
+    </para>
+
+    <para>While &digikam; remains easy to use, it provides professional level 
features by the dozens. It is fully 16 bit enabled including all available 
plugins, supports RAW format conversion through libraw, DNG export and ICC 
color management <link linkend="rawprocessing.anchor">work flow</link>.
+    </para>
+
+</sect2>
+
+<sect2>
+    <title>Reporting Bugs</title>
+
+    <para>
+    &digikam; is an Open Source project. This means that it relies on its 
users to play their part by, at least, reporting problems and suggesting 
possible improvements.
+    </para>
+
+    <para>
+    &digikam; makes it as easy as possible for you to report bugs or suggest 
improvements. Wherever you are in the application the Help menu will include a 
Report Bugs option. This will display a message box with a highlighted link. 
Click on the link and your web browser will open the page for the reporting 
system. All the information required will already be filled in, just follow the 
instructions for completing your report.
+    </para>
+
+</sect2>
+
+<sect2>
+    <title>Support</title>
+
+    <para>
+    &digikam; is a community supported project, which means that users and 
developers support one another. If you become a regular user of &digikam; you 
are encouraged to join the &digikam; Users Mailing List. You can start off by 
asking questions to other &digikam; users and hopefully soon you will be 
answering the support questions of others.
+    </para>
+
+    <para>
+    <ulink url="https://mail.kde.org/mailman/listinfo/digikam-users";>&digikam; 
Users Mailing
+    List joining instructions.</ulink>
+    </para>
+
+    <para>
+    You can also visit the <ulink url="http://www.digikam.org";>&digikam; Home 
Page.</ulink> for news of new releases and other &digikam; related information.
+    </para>
+
+</sect2>
+
+<sect2>
+    <title>Getting Involved</title>
+
+    <para>
+    There are many ways that you can get involved with the continued 
development of &digikam;. You do not need to be a software developer. You can 
help with documentation, translation and user interface design or just 
contribute really good ideas to the wish-list. You can also get involved by 
testing early development code as it is being developed and providing feedback 
to the developers. Of course, if you are a software developer then you can help 
to make &digikam; the best digital photograph application there is.
+    </para>
+
+    <para>
+    The best way to start getting involved with &digikam; is to join the 
Developers Mailing List.
+    <ulink url="https://mail.kde.org/mailman/listinfo/digikam-devel";>&digikam; 
Developer Mailing
+    List joining instructions.</ulink>
+    </para>
+
+</sect2>
+
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+End:
+-->

Reply via email to