[digikam-doc] digikam: move intro background in dedicated docbook file

Gilles Caulier caulier.gilles at gmail.com
Tue Aug 23 07:44:53 UTC 2016


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 "snap". &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 "snap". &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:
+-->


More information about the kde-doc-english mailing list