GNOME.org
 

[solang] help: Initial commit

commit a3727207db5440e8ad4bca1ff93d288e0b7cf8e7
Author: Florent Thévenet <feuloren free fr>
Date:   Wed Jan 27 13:40:48 2010 +0100

    help: Initial commit
    
    Documentation is wrote only for solang >= 0.4 series.
    
    Pages already written:
     * Introduction
     * Why can I see only 50 images ?
     * How can I use the search function ?
     * What's a tag ?
     * Use tags
     * Import from a hard drive
     * Export to a folder
    
    Signed-off-by: Debarshi Ray <rishi gnu org>

 docs/en_GB/export_folder.page  |   17 +++++++
 docs/en_GB/howto_search.page   |   18 +++++++
 docs/en_GB/import_local.page   |   13 +++++
 docs/en_GB/index.page          |   47 ++++++++++++++++++
 docs/en_GB/intro.page          |   13 +++++
 docs/en_GB/photos_by_page.page |   37 +++++++++++++++
 docs/en_GB/tags_intro.page     |   17 +++++++
 docs/en_GB/tags_manage.page    |  101 ++++++++++++++++++++++++++++++++++++++++
 8 files changed, 263 insertions(+), 0 deletions(-)
---
diff --git a/docs/en_GB/export_folder.page b/docs/en_GB/export_folder.page
new file mode 100644
index 0000000..faa42f5
--- /dev/null
+++ b/docs/en_GB/export_folder.page
@@ -0,0 +1,17 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="export_folder">
+<info>
+	<link type="guide" xref="index_export"/>
+	<desc>
+	To export some photos in a archive or a folder.
+	</desc>
+</info>
+<title>Export to Folder</title>
+<p>You can export some photos you have chosen to a folder of your computer.</p>
+
+<p>First you need to add the photos you want to export to the export
+<steps>
+
+</steps>
+</page>
diff --git a/docs/en_GB/howto_search.page b/docs/en_GB/howto_search.page
new file mode 100644
index 0000000..71c3d4c
--- /dev/null
+++ b/docs/en_GB/howto_search.page
@@ -0,0 +1,18 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="howto_search">
+<info>
+	<link type="guide" xref="index_UI"/>
+	<desc>
+	Filters your photos.
+	</desc>
+</info>
+<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>
+<item><p>To remove all the filters, click on the <gui>Clear filters</gui> button.</p></item>
+<item><p>To remove one filter, click on the filter in the <gui>Search Basket</gui> you want to remove and click on the <gui>Clear selected filters</gui> button.</p></item>
+</list>
+</page>
diff --git a/docs/en_GB/import_local.page b/docs/en_GB/import_local.page
new file mode 100644
index 0000000..843a0ab
--- /dev/null
+++ b/docs/en_GB/import_local.page
@@ -0,0 +1,13 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="import_local">
+<info>
+	<link type="guide" xref="index_import"/>
+	<desc>
+	Import photos from your computer's hard drive.
+	</desc>
+</info>
+<title>Import photos from a hard drive</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>
+</page>
diff --git a/docs/en_GB/index.page b/docs/en_GB/index.page
new file mode 100644
index 0000000..a6031ac
--- /dev/null
+++ b/docs/en_GB/index.page
@@ -0,0 +1,47 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="guide"
+      id="index">
+<title><app>Solang</app> Help</title>
+
+  <note style="tip">
+    <p>
+      This guide is created for <app>Solang</app>'s 0.4 series. Since there has been some UI regressions from the 0.3 series, this guide may not cover some features of <app>Solang</app> 0.3.
+    </p>
+  </note>
+
+	<section id="index_UI" style="2column">
+		<title>User Interface</title>
+		<info>
+			<link type="topic" xref="howto_search"/>
+			<link type="topic" xref="photos_by_page"/>
+		</info>
+	</section>
+
+	<section id="index_import" style="2column">
+		<title>Importing photos</title>
+		<info>
+			<link type="topic" xref="import_local"/>
+		</info>
+	</section>
+
+	<section id="index_export" style="2column">
+		<title>Exporting photos</title>
+		<info>
+			<link type="topic" xref="export_folder"/>
+		</info>
+	</section>
+
+	<section id="index_tags" style="2column">
+		<title>Tags</title>
+		<info>
+			<link type="topic" xref="tags_intro"/>
+			<link type="topic" xref="tags_manage"/>
+		</info>
+	</section>
+
+<!--	<section id="index_webservices" style="2column">
+		<title>Using Webservices</title>
+		<info>
+		</info>
+	</section>-->
+</page>
diff --git a/docs/en_GB/intro.page b/docs/en_GB/intro.page
new file mode 100644
index 0000000..78a2253
--- /dev/null
+++ b/docs/en_GB/intro.page
@@ -0,0 +1,13 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="intro">
+<info>
+	<link type="guide" xref="index"/>
+	<desc>
+	Introduction to the <app>Solang</app> photos manager.
+	</desc>
+</info>
+<title>Introduction to <app>Solang</app></title>
+<p>Solang is a photo manager for GNOME. It lets you manage your collection of photos by tagging them and searching through them based on various criteria -- tags, EXIF data, dates, etc; and offers a limited set of editing functionalities.</p>
+<p>Under the hood, <app>Solang</app> uses <app>Tracker</app> which allows it to automatically detect all the photos on your computer and publishes the tags all across the desktop.</p>
+</page>
diff --git a/docs/en_GB/photos_by_page.page b/docs/en_GB/photos_by_page.page
new file mode 100644
index 0000000..199b8c1
--- /dev/null
+++ b/docs/en_GB/photos_by_page.page
@@ -0,0 +1,37 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="photos_by_page">
+<info>
+	<link type="guide" xref="index_UI"/>
+	<desc>
+	To view more than 50 photos.
+	</desc>
+</info>
+<title>Why can't I see all my pictures ?</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>
+<list>
+	<item>
+	<p>Click on the <gui>Next page</gui> button in the <gui>Toolbar</gui>.</p>
+	</item>
+	<item>
+	<p>Press <keyseq><key>Alt</key><key>Page Down</key></keyseq>.</p>
+	</item>
+	<item>
+	<p>Choose <guiseq><gui>Go</gui><gui>Next Page</gui></guiseq> from the <gui>Main Window</gui>.</p>
+	</item>
+</list>
+<p>To go to the previous page you can</p>
+<list>
+	<item>
+	<p>Click on the <gui>Previous page</gui> button in the <gui>Toolbar</gui>.</p>
+	</item>
+	<item>
+	<p>Press <keyseq><key>Alt</key><key>Page Up</key></keyseq>.</p>
+	</item>
+	<item>
+	<p>Choose <guiseq><gui>Go</gui><gui>Previous Page</gui></guiseq> from the <gui>Main Window</gui>.</p>
+	</item>
+</list>
+</page>
diff --git a/docs/en_GB/tags_intro.page b/docs/en_GB/tags_intro.page
new file mode 100644
index 0000000..e1add5b
--- /dev/null
+++ b/docs/en_GB/tags_intro.page
@@ -0,0 +1,17 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="tags_intro">
+<info>
+	<link type="guide" xref="index_tags"/>
+	<link type="topic" xref="howto_search"/>
+	<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>
+<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>
+</page>
diff --git a/docs/en_GB/tags_manage.page b/docs/en_GB/tags_manage.page
new file mode 100644
index 0000000..ac98b6a
--- /dev/null
+++ b/docs/en_GB/tags_manage.page
@@ -0,0 +1,101 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="tags_manage">
+<info>
+	<link type="guide" xref="index_tags"/>
+	<desc>
+	Create, delete and attach tags to photos.
+	</desc>
+</info>
+<title>Use tags</title>
+
+<section id="create_tag" style="task">
+  <title>Create a tag</title>
+
+  <p>You can quickly create tags.</p>
+
+  <steps>
+    <item>
+      <p>From the <gui>main</gui> window, choose <guiseq><gui>Tags</gui>
+      <gui>Create New Tag...</gui></guiseq>.</p>
+    </item>
+    <item>
+      <p>In the <gui>Create New Tag</gui> window, enter the name of your tag and enter an optional description.</p>
+    </item>
+    <item>
+      <p>Press <gui>OK</gui> to validate the creation of the tag.</p>
+    </item>
+  </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 then 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 with these photos.</p>
+    </item>
+  </steps>
+  </section>
+
+<section id="create_tag" style="task">
+  <title>Modify a tag</title>
+
+  <p>You can modify the name and the description of a tag.</p>
+
+  <steps>
+    <item>
+      <p>From the <gui>main</gui> window, choose <guiseq><gui>Tags</gui>
+      <gui>Edit Selected Tag...</gui></guiseq>.</p>
+    </item>
+    <item>
+      <p>In the <gui>Edit Tag</gui> window, modify the field you want.</p>
+    </item>
+    <item>
+      <p>Press <gui>OK</gui> to save the modifications of the tag.</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 then 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>
+
+  <p>You can delete a tag.</p>
+
+  <steps>
+    <item>
+      <p>In the <gui>Tag List</gui>, click on the tag you want to delete.</p>
+    </item>
+    <item>
+      <p>Choose <guiseq><gui>Tags</gui><gui>Delete Selected Tag</gui></guiseq> to delete this tag.</p>
+    </item>
+  </steps>
+  </section>
+
+</page>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]