[solang] help: Lot of changes in C



commit 20fd9acba379511cf390824b0769460dab6fd071
Author: Florent Thévenet <feuloren free fr>
Date:   Fri Feb 12 23:58:43 2010 +0100

    help: Lot of changes in C
    
    Added keyboard shortcuts page
    Renamed "How do I export photos ?" to "Archive your photos"
    Splited tags_manage in two different pages
    Some title changes to remove "How do I"
    Lot of changes in import
    
    Thanks to Phill Bull and Shaun McCance
    
    Signed-off-by: Debarshi Ray <rishi gnu org>

 docs/C/export_folder.page  |    6 +-
 docs/C/howto_search.page   |    3 +-
 docs/C/import.page         |    9 +---
 docs/C/index.page          |   10 ++++-
 docs/C/keys.page           |  105 ++++++++++++++++++++++++++++++++++++++++++++
 docs/C/photos_by_page.page |    2 +-
 docs/C/tags_intro.page     |    7 +--
 docs/C/tags_manage.page    |   44 ++----------------
 docs/C/tags_use.page       |   49 ++++++++++++++++++++
 9 files changed, 179 insertions(+), 56 deletions(-)
---
diff --git a/docs/C/export_folder.page b/docs/C/export_folder.page
index 91c2a3f..2c1e335 100644
--- a/docs/C/export_folder.page
+++ b/docs/C/export_folder.page
@@ -4,11 +4,11 @@
 <info>
 	<link type="guide" xref="index_export"/>
 	<desc>
-	To export photos in a archive or a folder.
+	To copy photos in a archive or a folder.
 	</desc>
 </info>
-<title>How do I export photos ?</title>
-<p>You can export photos to a directory of your computer.</p>
+<title>Archive your photos</title>
+<p>You can copy photos to a directory of your computer or put them in a archive.</p>
 
 <p>First you have to add the photos you want to export to the export queue. There are many ways to add a photo to the Export Queue.</p>
 <steps>
diff --git a/docs/C/howto_search.page b/docs/C/howto_search.page
index 058d3d9..e4844a7 100644
--- a/docs/C/howto_search.page
+++ b/docs/C/howto_search.page
@@ -7,9 +7,8 @@
 	Filters your photos.
 	</desc>
 </info>
-<title>How do I use the search function ?</title>
+<title>How do I use the search function?</title>
 
-  <p><app>Solang</app> uses a powerful yet hard to understand search function.</p>
   <p>Actually you have to drag and drop one or more filters to the <gui>Search Basket</gui>. <app>Solang</app> will display only photos that correspond to all the filters you have chosen. Today only tags are filters.</p>
   <list>
     <item><p>To add a filter drag a tag from the <gui>Tag List</gui> to the <gui>Search Basket</gui>.</p></item>
diff --git a/docs/C/import.page b/docs/C/import.page
index d160b03..a0cb5ac 100644
--- a/docs/C/import.page
+++ b/docs/C/import.page
@@ -1,5 +1,5 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="guide"
+      type="topic"
       id="import">
 <info>
 	<link type="guide" xref="index_questions"/>
@@ -7,10 +7,7 @@
 	To view your photos in <app>Solang</app>.
 	</desc>
 </info>
-<title>How do I import photos ?</title>
-<p>With <app>Solang</app> you don't need to import photos from your hard drive.</p>
-<p>Indeed <app>Solang</app> uses Tracker to get the list of your photos; so don't worry about importing the new photos you've got from your camera : It's automatically here.</p>
-
-<!-- add links to help for importers here -->
+<title>I can't see any photos</title>
+<p>Solang only displays photos that are indexed by the <app>Tracker search tool</app>, if you don't see your photos Tracker may not be running or your photos may not be indexed. To make sure Tracker indexes your photos use the <app>Search tool preferences</app> from the <gui>System</gui> menu.</p>
 
 </page>
diff --git a/docs/C/index.page b/docs/C/index.page
index 7a4409b..be14e76 100644
--- a/docs/C/index.page
+++ b/docs/C/index.page
@@ -5,7 +5,7 @@
 
   <note style="tip">
     <p>
-      This guide is created for <app>Solang</app>'s 0.4 series. Since there have been some UI regressions from the 0.3 series, this guide may not cover some features of <app>Solang</app> 0.3.
+      This guide is created for <app>Solang</app>'s 0.4 series. Since there have been some UI regressions from the 0.3 series, this guide may not cover some features of <app>Solang</app> 0.3, mostly the import process.
     </p>
   </note>
 
@@ -29,10 +29,18 @@
 		<title>Tags</title>
 		<info>
 			<link type="topic" xref="tags_intro"/>
+			<link type="topic" xref="tags_use"/>
 			<link type="topic" xref="tags_manage"/>
 		</info>
 	</section>
 
+	<section id="index_tips" style="2colum">
+		<title>Tips and Tricks</title>
+		<info>
+			<link type="topic" xref="keys"/>
+		</info>
+	</section>
+
 <!--	<section id="index_webservices" style="2column">
 		<title>Using Webservices</title>
 		<info>
diff --git a/docs/C/keys.page b/docs/C/keys.page
new file mode 100644
index 0000000..54a782a
--- /dev/null
+++ b/docs/C/keys.page
@@ -0,0 +1,105 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="keys">
+<info>
+	<desc>
+	You are going to love your keyboard.
+	</desc>
+</info>
+<title>Keyboard shortcuts</title>
+
+<section id="keys_view">
+<title>View</title>
+<table shade="rows" rules="cols" frame="top bottom">
+    <tr>
+    <td><p>Fullscreen</p></td> <td><p>Go to fullscreen mode and go back to windowed mode.</p></td>
+    <td><p><key>F11</key></p></td>
+    </tr>
+    <tr>
+    <td><p>Slideshow</p></td> <td><p>Go to slideshow mode.</p></td>
+    <td><p><key>F5</key></p></td>
+    </tr>
+    <tr>
+    <td><p>Zoom In</p></td> <td><p>Enlarge the picture or the thumbnails.</p></td>
+    <td><p><keyseq><key>Ctrl</key><key>+</key></keyseq></p></td>
+    </tr>
+    <tr>
+    <td><p>Zoom Out</p></td> <td><p>Reduce the size of the picture or the thumbnails.</p></td>
+    <td><p><keyseq><key>Ctrl</key><key>-</key></keyseq></p></td>
+    </tr>
+    <tr>
+    <td><p>Normal size</p></td> <td><p>Display image in its normal size (only in <gui>Enlarged mode</gui>).</p></td>
+    <td><p><keyseq><key>Ctrl</key><key>0</key></keyseq></p></td>
+    </tr>
+</table>
+</section>
+
+<section id="keys_tags">
+<title>Tags</title>
+<table shade="rows" rules="cols" frame="top bottom">
+    <tr>
+    <td><p>Attach Tag to Selection</p></td> <td><p>Attach the selected tag to the selected photos.</p></td>
+    <td><p><keyseq><key>Ctrl</key><key>T</key></keyseq></p></td>
+    </tr>
+</table>
+</section>
+
+<!--<section id="keys_tools"> note to reviewers : saving is not implemented at the time so it may be a good idea not to give user bad surprises
+<title>Tools</title>
+<table shade="rows" rules="cols" frame="top bottom">
+    <tr>
+    <td><p>Rotate Clockwise</p></td> <td><p>Rotate the selected photos clockwise.</p></td>
+    <td><p><keyseq><key>Ctrl</key><key>R</key></keyseq></p></td>
+    </tr>
+    <tr>
+    <td><p>Rotate Counterclockwise</p></td> <td><p>Rotate the selected photos clockwise.</p></td>
+    <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>R</key></keyseq></p></td>
+    </tr>
+</table>
+</section>-->
+
+<section id="keys_navigation_browser">
+<title>Navigation (In <gui>Browser mode</gui>)</title>
+<table shade="rows" rules="cols" frame="top bottom">
+    <tr>
+    <td><p>Previous Page</p></td> <td><p>Go to the previous page.</p></td>
+    <td><p><keyseq><key>Alt</key><key>Left</key></keyseq></p></td>
+    </tr>
+    <tr>
+    <td><p>Next Page</p></td> <td><p>Go to the next page.</p></td>
+    <td><p><keyseq><key>Alt</key><key>Right</key></keyseq></p></td>
+    </tr>
+    <tr>
+    <td><p>First Page</p></td> <td><p>Go to the first page.</p></td>
+    <td><p><keyseq><key>Alt</key><key>Home</key></keyseq></p></td>
+    </tr>
+    <tr>
+    <td><p>Last Page</p></td> <td><p>Go to the last page.</p></td>
+    <td><p><keyseq><key>Alt</key><key>End</key></keyseq></p></td>
+    </tr>
+</table>
+</section>
+
+<section id="keys_navigation_enlarged">
+<title>Navigation (In <gui>Enlarged mode</gui>)</title>
+<table shade="rows" rules="cols" frame="top bottom">
+    <tr>
+    <td><p>Previous Photo</p></td> <td><p>Go to the previous photo.</p></td>
+    <td><p><keyseq><key>Alt</key><key>Left</key></keyseq></p></td>
+    </tr>
+    <tr>
+    <td><p>Next Photo</p></td> <td><p>Go to the next photo.</p></td>
+    <td><p><keyseq><key>Alt</key><key>Right</key></keyseq></p></td>
+    </tr>
+    <tr>
+    <td><p>First Photo</p></td> <td><p>Go to the first photo.</p></td>
+    <td><p><keyseq><key>Alt</key><key>Home</key></keyseq></p></td>
+    </tr>
+    <tr>
+    <td><p>Last Photo</p></td> <td><p>Go to the last photo.</p></td>
+    <td><p><keyseq><key>Alt</key><key>End</key></keyseq></p></td>
+    </tr>
+</table>
+</section>
+
+</page>
diff --git a/docs/C/photos_by_page.page b/docs/C/photos_by_page.page
index e495552..a60486b 100644
--- a/docs/C/photos_by_page.page
+++ b/docs/C/photos_by_page.page
@@ -7,7 +7,7 @@
 	To view more than 50 photos.
 	</desc>
 </info>
-<title>Why can't I see all my pictures ?</title>
+<title>I don't see all my photos.</title>
 <p><app>Solang</app> only display 50 photos by page, so you can only preview 50 photos at once.</p>
 <p>Hopefully there are multiple pages.</p>
 <p>To go to the next page you can</p>
diff --git a/docs/C/tags_intro.page b/docs/C/tags_intro.page
index 9c8c249..dbe3b46 100644
--- a/docs/C/tags_intro.page
+++ b/docs/C/tags_intro.page
@@ -2,14 +2,13 @@
       type="topic"
       id="tags_intro">
 <info>
-	<link type="guide" xref="index_tags"/>
 	<desc>
 	An introduction to tags
 	</desc>
 </info>
-<title>What's a tag ?</title>
-<p>Tags are keyword or terms you can associate with a document. You may have already seen it in weblogs.</p>
-<p><app>Solang</app> uses tags to help you organizing your photos. You can use tags to organize your pictures the way you want !</p>
+<title>What's a tag?</title>
+<p>Tags are keyword you can use to label and organize your photos. You may have already seen it in weblogs.</p>
+<p><app>Solang</app> uses tags to help you organizing your photos. In fact, you can use tags to organize your photos the way you want!</p>
 <p>For example, some people uses tags to create "albums" of their holiday photos.
 Some others use tags to show what friends are in their photos, to view only photos from one geographical place or distinguish the photos they have modified.</p>
 <p><app>Solang</app> allows you to use tags as filters to view only photos that have some tags attached to them.</p>
diff --git a/docs/C/tags_manage.page b/docs/C/tags_manage.page
index 26b1300..7870fbb 100644
--- a/docs/C/tags_manage.page
+++ b/docs/C/tags_manage.page
@@ -3,11 +3,12 @@
       id="tags_manage">
 <info>
 	<link type="guide" xref="index_tags"/>
+	<link type="topic" xref="tags_intro"/>
 	<desc>
-	Create, delete and attach tags to photos.
+	Create, modify and delete tags.
 	</desc>
 </info>
-<title>How do I use tags ?</title>
+<title>Manage your tags</title>
 
 <section id="create_tag" style="task">
   <title>Create a tag</title>
@@ -28,26 +29,9 @@
   </steps>
   </section>
 
-<section id="attach_tag" style="task">
-  <title>Attach a tag to photos.</title>
 
-  <p>You can attach a tag to one or more photos at once.</p>
-
-  <steps>
-    <item>
-      <p>From the <gui>main</gui> window, select one or more photos you want to tag.</p>
-    </item>
-    <item>
-      <p>In the <gui>Tag List</gui>, click on the tag you want to attach to these photos.</p>
-    </item>
-    <item>
-      <p>Choose <guiseq><gui>Tags</gui><gui>Attach Tag to Selection</gui></guiseq> or press <keyseq><key>Ctrl</key><key>T</key></keyseq> to attach the tag to these photos.</p>
-    </item>
-  </steps>
-  </section>
-
-<section id="create_tag" style="task">
-  <title>Modify a tag</title>
+<section id="modify_tag" style="task">
+  <title>Modify a Tag</title>
 
   <p>You can modify the name and the description of a tag.</p>
 
@@ -65,24 +49,6 @@
   </steps>
   </section>
 
-<section id="remove_tag" style="task">
-  <title>Remove a tag from photos.</title>
-
-  <p>You can remove a tag from one or more photos at once.</p>
-
-  <steps>
-    <item>
-      <p>From the <gui>main</gui> window, select one or more photos you want to untag.</p>
-    </item>
-    <item>
-      <p>In the <gui>Tag List</gui>, click on the tag you want to remove from these photos.</p>
-    </item>
-    <item>
-      <p>Choose <guiseq><gui>Tags</gui><gui>Remove Tag From Selection</gui></guiseq> to remove the tag from these photos.</p>
-    </item>
-  </steps>
-  </section>
-
 <section id="delete_tag" style="task">
   <title>Delete a tag.</title>
 
diff --git a/docs/C/tags_use.page b/docs/C/tags_use.page
new file mode 100644
index 0000000..ad5d27b
--- /dev/null
+++ b/docs/C/tags_use.page
@@ -0,0 +1,49 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="tags_use">
+<info>
+	<link type="guide" xref="index_tags"/>
+	<link type="topic" xref="tags_intro"/>
+	<desc>
+	Attach tags to photos and remove them.
+	</desc>
+</info>
+<title>Attach tags to photos</title>
+
+<section id="attach_tag" style="task">
+  <title>Attach a tag to photos.</title>
+
+  <p>You can attach a tag to one or more photos at once.</p>
+
+  <steps>
+    <item>
+      <p>From the <gui>main</gui> window, select one or more photos you want to tag.</p>
+    </item>
+    <item>
+      <p>In the <gui>Tag List</gui>, click on the tag you want to attach to these photos.</p>
+    </item>
+    <item>
+      <p>Choose <guiseq><gui>Tags</gui><gui>Attach Tag to Selection</gui></guiseq> or press <keyseq><key>Ctrl</key><key>T</key></keyseq> to attach the tag to these photos.</p>
+    </item>
+  </steps>
+  </section>
+
+<section id="remove_tag" style="task">
+  <title>Remove a tag from photos.</title>
+
+  <p>You can remove a tag from one or more photos at once.</p>
+
+  <steps>
+    <item>
+      <p>From the <gui>main</gui> window, select one or more photos you want to untag.</p>
+    </item>
+    <item>
+      <p>In the <gui>Tag List</gui>, click on the tag you want to remove from these photos.</p>
+    </item>
+    <item>
+      <p>Choose <guiseq><gui>Tags</gui><gui>Remove Tag From Selection</gui></guiseq> to remove the tag from these photos.</p>
+    </item>
+  </steps>
+  </section>
+
+</page>



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]