[f-spot] Add new f-spot topic based help



commit 30a74aa11401a18534cbda006e865d0679cf5858
Author: Harold Schreckengost <mewshi gmail com>
Date:   Mon May 10 19:55:13 2010 -0500

    Add new f-spot topic based help

 docs/C/23hq.page               |   19 +
 docs/C/adjust-color.page       |   55 ++
 docs/C/cd.page                 |   14 +
 docs/C/colors.page             |   28 +
 docs/C/date-search.page        |   49 ++
 docs/C/enhancements.page       |   42 ++
 docs/C/extensions.page         |   85 +++
 docs/C/f-spot.xml              | 1467 ----------------------------------------
 docs/C/facebook.page           |   42 ++
 docs/C/file-management.page    |   40 ++
 docs/C/flickr.page             |   19 +
 docs/C/folder.page             |   42 ++
 docs/C/general-editing.page    |   60 ++
 docs/C/import-photos.page      |   36 +
 docs/C/import-roll-search.page |   38 +
 docs/C/index.page              |   34 +
 docs/C/introduction.page       |   17 +
 docs/C/picasa.page             |   39 ++
 docs/C/rate-search.page        |   35 +
 docs/C/ratings.page            |   35 +
 docs/C/smugmug.page            |   19 +
 docs/C/tag-attach.page         |   42 ++
 docs/C/tag-creation.page       |   72 ++
 docs/C/tag-delete.page         |   25 +
 docs/C/tag-remove.page         |   41 ++
 docs/C/tag-search.page         |   40 ++
 docs/C/tags.page               |   19 +
 docs/C/upload-to-web.page      |   16 +
 docs/C/versioning.page         |   28 +
 docs/C/zooomr.page             |   19 +
 30 files changed, 1050 insertions(+), 1467 deletions(-)
---
diff --git a/docs/C/23hq.page b/docs/C/23hq.page
new file mode 100644
index 0000000..10f7360
--- /dev/null
+++ b/docs/C/23hq.page
@@ -0,0 +1,19 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="topic"
+      id="23hq">
+
+  <info>
+    <link type="guide" xref="upload-to-web"/>
+    <desc>Upload photos to 23hq</desc>
+  </info>
+
+  <title>
+    23hq
+  </title>
+
+  <p>To upload photos to 23hq you will need a 23hq account, as well as
+     internet access.  Also, the 23hq
+     <link xref="extensions">extension</link> must be installed and enabled.
+     </p>
+</page>
diff --git a/docs/C/adjust-color.page b/docs/C/adjust-color.page
new file mode 100644
index 0000000..11da61e
--- /dev/null
+++ b/docs/C/adjust-color.page
@@ -0,0 +1,55 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="adjust-color">
+  <info>
+    <link type="guide" xref="colors"/>
+    <desc>Adjusting the colors of a photo</desc>
+  </info>
+
+  <title>
+    Adjust Color
+  </title>
+  <p>As far as the editing tools in F-Spot, adjusting the color is easily the
+     most powerful.  The color editor allows you to adjust:</p>
+  <terms>
+    <item>
+      <title>Exposure</title>
+      <p>This adjustment simulates lengthening or shortening the exposure time.
+      </p>
+    </item>
+    <item>
+      <title>Saturation</title>
+      <p>This adjustment simulates adjusting the amount of color in the image, i.e.
+         sliding it to the left decrease color, making it black and white,
+         while sliding it to the right will increase the vibrancy of colors.
+      </p>
+    </item>
+    <item>
+      <title>Brightness</title>
+      <p>This adjustment increase the brightness of colors.  Increasing this
+           too much will make colors appear "washed out", while decreasing it
+           too much will make the image too dark and lacking in contrast. </p>
+    </item>
+    <item>
+      <title>Hue</title>
+      <p>This adjustment causes colors to "rotate" along the color wheel.</p>
+    </item>
+    <item>
+      <title>Contrast</title>
+      <p>This adjustment adjusts the contrast ratio, that is, the ratio of
+         difference between dark and light pixels.  Sliding to the left
+         decreases contrast, while sliding to the right will increase contrast.
+         </p>
+    </item>
+    <item>
+      <title>Temp</title>
+      <p>This adjust changes the color temperature, measured in degrees Kelvin.
+      </p>
+    </item>
+    <item>
+      <title>Tint</title>
+      <p>This adjustment allows you to tinge the photo with a color.</p>
+    </item>
+  </terms>
+</page>
+
diff --git a/docs/C/cd.page b/docs/C/cd.page
new file mode 100644
index 0000000..1647ea0
--- /dev/null
+++ b/docs/C/cd.page
@@ -0,0 +1,14 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="topic"
+      id="cd">
+
+  <info>
+    <link type="guide" xref="index#sharing"/>
+    <desc>Burn photos to a CD</desc>
+  </info>
+
+  <title>
+    CD Export
+  </title>
+</page>
diff --git a/docs/C/colors.page b/docs/C/colors.page
new file mode 100644
index 0000000..44c8758
--- /dev/null
+++ b/docs/C/colors.page
@@ -0,0 +1,28 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="guide"
+      id="colors">
+  <info>
+    <link type="guide" xref="index#editing" group="colors"/>
+    <desc>Edit the colors of your photos</desc>
+  </info>
+
+  <title>
+    Color Editing
+  </title>
+  <p><app>F-Spot</app> supports several modes of color manipulation.</p>
+  <terms>
+    <item>
+      <title>Desaturate</title>
+      <p>This mode eliminates all saturation, turning a color image into a
+         black and white image.</p>
+    </item>
+    <item>
+      <title>Sepia Tone</title>
+      <p>This mode simulates a photo being created with sepia toner.</p>
+    </item>
+    <item>
+      <title>Auto Color</title>
+      <p>This mode automatically adjusts the colors to a set profile.</p>
+    </item>
+  </terms>
+</page>
diff --git a/docs/C/date-search.page b/docs/C/date-search.page
new file mode 100644
index 0000000..4c5863c
--- /dev/null
+++ b/docs/C/date-search.page
@@ -0,0 +1,49 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="topic"
+      id="date-search">
+
+  <info>
+    <link type="guide" xref="index#searching"/>
+    <desc>Search photos by date</desc>
+  </info>
+
+  <title>
+    Search by Date
+  </title>
+
+  <p>To search by date:</p>
+  <steps>
+    <item>
+      <p>Select <guiseq><gui>Find</gui><gui>By Date</gui>
+      <gui>Set Date Range...</gui></guiseq>.</p>
+    </item>
+    <item>
+      <p>Select a time period to from which to view photos.
+         This can by done by selecting a set period, such as a week, or by
+         specifying dates.</p>
+    </item>
+    <item>
+      <p>Click <gui>Ok</gui>.</p>
+    </item>
+  </steps>
+  <p>Alternatively, you can use the timeline.  To use the timeline:</p>
+  <steps>
+    <item>
+      <p>Make sure the timeline is enabled by selecting <guiseq><gui>View</gui>
+      <gui>Components</gui></guiseq> and making sure that <gui>Timeline</gui>
+      is checked.</p>
+    </item>
+    <item>
+      <p>In the timeline, click the bar corresponding to the time period you
+         wish to look at.</p>
+    </item>
+  </steps>
+  <p>To stop searching by date:</p>
+  <steps>
+    <item>
+      <p>Select <guiseq><gui>Find</gui><gui>By Date</gui>
+      <gui>Clear Date Range</gui></guiseq>.</p>
+    </item>
+  </steps>
+</page>
diff --git a/docs/C/enhancements.page b/docs/C/enhancements.page
new file mode 100644
index 0000000..47b7afe
--- /dev/null
+++ b/docs/C/enhancements.page
@@ -0,0 +1,42 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="enhancements">
+  <info>
+    <link type="guide" xref="index#editing" group="enhancements"/>
+    <desc>Simple enhancements for your photos</desc>
+  </info>
+
+  <title>
+    Enhancements
+  </title>
+
+  <p>Currently, there are two main enhancements that <app>F-Spot</app>
+     supports: red-eye removal and the automatic enhancement of color.</p>
+  <p>To remove red-eye:</p>
+  <steps>
+    <item>
+      <p>By double-clicking, select the photo on which you wish to use the
+         red-eye removal tool.</p>
+    </item>
+    <item>
+      <p>Click <gui>Red-Eye Removal</gui> in the Edit panel.</p>
+    </item>
+    <item>
+      <p>Select the area from which you wish to remove red-eye.  Note:  If
+         the contains many red areas, you may wish to select each eye
+         individually.</p>
+    </item>
+    <item>
+      <p>Click <gui>Fix!</gui>.</p>
+    </item>
+  </steps>
+  <p>To automatically enhance the colors of the photo:</p>
+  <steps>
+    <item>
+      <p>By double-clicking, select the photo which you wish to enhance.</p>
+    </item>
+    <item>
+      <p>Click <gui>Auto Color</gui>.</p>
+    </item>
+  </steps>
+</page>
diff --git a/docs/C/extensions.page b/docs/C/extensions.page
new file mode 100644
index 0000000..7e844dd
--- /dev/null
+++ b/docs/C/extensions.page
@@ -0,0 +1,85 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="topic"
+      id="extensions">
+
+  <info>
+    <link type="guide" xref="index#advanced"/>
+    <desc>Working with <app>F-Spot</app> extensions</desc>
+  </info>
+
+  <title>
+    Extensions
+  </title>
+
+  <p><app>F-Spot</app> allows for the use of extensions to provide additional
+     functionality.</p>
+
+  <p>To open the extension manager, select <guiseq><gui>Edit</gui>
+     <gui>Manage Extensions</gui></guiseq>.</p>
+
+  <p>To install extensions:</p>
+  <steps>
+    <item>
+      <p>Open the extension manager.</p>
+    </item>
+    <item>
+      <p>Click <gui>Install Add-ins</gui>.</p>
+    </item>
+    <item>
+      <p>Select an add-on to install from the list.</p>
+    </item>
+    <item>
+      <p>Click <gui>Forward</gui>.</p>
+    </item>
+    <item>
+      <p>Verify all information, and click <gui>Forward</gui> again.</p>
+    </item>
+    <item>
+      <p>Click <gui>Ok</gui>.</p>
+    </item>
+  </steps>
+
+  <p>To enable plugins that are already installed:</p>
+  <steps>
+    <item>
+      <p>Open the extension manager.</p>
+    </item>
+    <item>
+      <p>Select the extension you wish to enable.</p>
+    </item>
+    <item>
+      <p>Click <gui>Enable</gui>.</p>
+    </item>
+  </steps>
+  <p>To disable plugins that are installed:</p>
+  <steps>
+    <item>
+      <p>Open the extension manager.</p>
+    </item>
+    <item>
+      <p>Select the extension you wish to disable.</p>
+    </item>
+    <item>
+      <p>Click <gui>Disable</gui>.</p>
+    </item>
+  </steps>
+  <p>To uninstall plugins:</p>
+  <steps>
+    <item>
+      <p>Open the extension manager.</p>
+    </item>
+    <item>
+      <p>Select the extension you wish to uninstall.</p>
+    </item>
+    <item>
+      <p>Click <gui>Uninstall</gui>.</p>
+    </item>
+    <item>
+      <p>Click <gui>Forward</gui>.</p>
+    </item>
+    <item>
+      <p>Click <gui>Ok</gui>.</p>
+    </item>
+  </steps>
+</page>
diff --git a/docs/C/facebook.page b/docs/C/facebook.page
new file mode 100644
index 0000000..44b42d3
--- /dev/null
+++ b/docs/C/facebook.page
@@ -0,0 +1,42 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="topic"
+      id="facebook">
+
+  <info>
+    <link type="guide" xref="upload-to-web"/>
+    <desc>Upload photos to Facebook</desc>
+  </info>
+
+  <title>
+    Facebook
+  </title>
+
+  <p>To upload photos to Facebook you will need a Facebook account, as well as
+     internet access.  Also, the Facebook
+     <link xref="extensions">extension</link> must be installed and enabled.
+     </p>
+
+  <p>To post selected photos to Facebook:</p>
+  <steps>
+    <item>
+      <p>Select <guiseq><gui>Photo</gui><gui>Export To</gui><gui>Facebook</gui>
+      </guiseq>.</p>
+    </item>
+    <item>
+      <p>Click <gui>Login</gui>.  A browser window will be brought up.  Log in
+         to Facebook and click "Allow" to allow F-Spot access to your Facebook
+         profile.</p>
+    </item>
+    <item>
+      <p>Select whether to create a new album or add to an existing album.  If
+         you are creating a new album, fill in the relevant information.</p>
+    </item>
+    <item>
+      <p>Edit captions for each photo, if so desired.</p>
+    </item>
+    <item>
+      <p>When finished, click <gui>Add</gui>.</p>
+    </item>
+  </steps>
+</page>
diff --git a/docs/C/file-management.page b/docs/C/file-management.page
new file mode 100644
index 0000000..3ff40ef
--- /dev/null
+++ b/docs/C/file-management.page
@@ -0,0 +1,40 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="topic"
+      id="file-management">
+
+  <info>
+    <link type="guide" xref="index#basic-functions" group="management"/>
+    <desc>Manage files already imported</desc>
+  </info>
+
+  <title>
+    File Management
+  </title>
+
+  <p><app>F-Spot</app> allows for some control over the contents of your
+     catalog, that is, removing files from your catalog as well as deleting
+     files from your catalog.</p>
+  <p>To remove files from your catalog:</p>
+  <steps>
+    <item>
+      <p>Select the photos you wish to remove from the catalog.</p>
+    </item>
+    <item>
+      <p>Right-click the photos, select <gui>Remove From Catalog</gui>.
+         Alternatively, select <guiseq><gui>Edit</gui><gui>Remove From
+         Catalog</gui></guiseq> or press the Delete key on your keyboard.</p>
+    </item>
+  </steps>
+  <p>To delete photos from your computer:</p>
+  <steps>
+    <item>
+      <p>Select the photos you wish to delete.</p>
+    </item>
+    <item>
+      <p>Right-click the photos, select <gui>Delete From Drive</gui>.
+         Alternatively, select <guiseq><gui>Edit</gui><gui>Delete
+         From Drive</gui></guiseq> or press Shift+Delete on your keyboard.</p>
+    </item>
+  </steps>
+</page>
diff --git a/docs/C/flickr.page b/docs/C/flickr.page
new file mode 100644
index 0000000..6313613
--- /dev/null
+++ b/docs/C/flickr.page
@@ -0,0 +1,19 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="topic"
+      id="flickr">
+
+  <info>
+    <link type="guide" xref="upload-to-web"/>
+    <desc>Upload photos to Flickr</desc>
+  </info>
+
+  <title>
+    Flickr
+  </title>
+
+  <p>To upload photos to Flickr you will need a Flickr account, as well as
+     internet access.  Also, the Flickr
+     <link xref="extensions">extension</link> must be installed and enabled.
+     </p>
+</page>
diff --git a/docs/C/folder.page b/docs/C/folder.page
new file mode 100644
index 0000000..fd8c9f8
--- /dev/null
+++ b/docs/C/folder.page
@@ -0,0 +1,42 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="topic"
+      id="folder">
+
+  <info>
+    <link type="guide" xref="index#sharing"/>
+    <desc>Send photos to a folder</desc>
+  </info>
+
+  <title>
+    Folder Export
+  </title>
+
+  <p><app>F-Spot</app> allows you to export to a folder.  In order to do so,
+     however, you will need to have the folder export
+     <link xref="extensions">extension</link> installed and enabled.</p>
+  <p>To export selected photos to a folder:</p>
+  <steps>
+    <item>
+      <p>Select <guiseq><gui>Photo</gui><gui>Export To</gui><gui>Folder...</gui>
+      </guiseq>.</p>
+    </item>
+    <item>
+      <p>Select a folder.</p>
+    </item>
+    <item>
+      <p>Name the gallery and give it a description.</p>
+    </item>
+    <item>
+      <p>Select an export method.  <gui>Create Standalone Web Gallery</gui>
+         will create a folder with contents fit to be uploaded to a web
+         server to present pictures in a gallery.  <gui>Save the files
+         only</gui>  will only move photos to the selected folder.
+         <gui>Create gallery using "Original"</gui> will create a folder
+         with contents suitable for using with Original Photo Gallery.</p>
+    </item>
+    <item>
+      <p>Click <gui>Export</gui>.</p>
+    </item>
+  </steps>
+</page>
diff --git a/docs/C/general-editing.page b/docs/C/general-editing.page
new file mode 100644
index 0000000..ef8d78d
--- /dev/null
+++ b/docs/C/general-editing.page
@@ -0,0 +1,60 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="general-editing">
+  <info>
+    <link type="guide" xref="index#editing" group="general"/>
+    <desc>Make simple edits to your photos</desc>
+  </info>
+
+  <title>
+    General Editing
+  </title>
+
+  <p><app>F-Spot</app> allows you to make simple general edits, including
+     straightening, cropping, and rotating your photos.</p>
+  <p>There are three ways to rotate a selected photo:</p>
+  <steps>
+    <item>
+      <p>Click the appropriate rotate button, to the right of the import
+         button.</p>
+    </item>
+    <item>
+      <p>Select the appropriate option from within the <gui>Edit</gui> menu.
+      </p>
+    </item>
+    <item>
+      <p>Use the bracket keys to rotate the photo.</p>
+    </item>
+  </steps>
+  <p>To straighten a selected photo:</p>
+  <steps>
+    <item>
+      <p>From within the editing pane, select <app>Straighten</app>.</p>
+    </item>
+    <item>
+      <p>Select a rotation, ranging from -45 to 45 degrees.</p>
+    </item>
+    <item>
+      <p>Click <gui>Straighten</gui>.</p>
+    </item>
+  </steps>
+  <p>To crop a selected photo:</p>
+  <steps>
+    <item>
+      <p>Click the <gui>Crop</gui> button in the Edit pane.</p>
+    </item>
+    <item>
+      <p>Select a contraining aspect ratio, that is, a proportion of height
+         to width to which the new photo must fit.  Examples of contraining
+         aspect ratios include 4x3, 4x6, and 5x7.</p>
+    </item>
+    <item>
+      <p>Click and drag to select the desired area to keep.  This box can be
+         dragged around after being sized.</p>
+    </item>
+    <item>
+      <p>When you have selected your area to crop to, click <gui>Crop</gui>.
+      </p>
+    </item>
+  </steps>
+</page>
diff --git a/docs/C/import-photos.page b/docs/C/import-photos.page
new file mode 100644
index 0000000..803ac10
--- /dev/null
+++ b/docs/C/import-photos.page
@@ -0,0 +1,36 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="import-photos">
+  <info>
+    <link type="guide" xref="index#basic-functions" group="import"/>
+    <desc>Import photos to be managed</desc>
+  </info>
+
+  <title>
+    Importing Photos
+  </title>
+  <p>
+    Chances are, the first thing you will want to do is import photos.
+  </p>
+  <p>
+    To import photos:
+  </p>
+  <steps>
+    <item>
+      <p>Select <guiseq><gui>Photo</gui><gui>Import...</gui></guiseq>.
+      Alternatively, click the <gui>Import</gui> button.</p>
+    </item>
+    <item>
+      <p>Select a source from which to import, such as a device or a folder.</p>
+     </item>
+     <item>
+       <p>It may take a while for F-Spot to index the files.  When it is done
+          indexing, your photos will be presented to you.  At this time, you
+          can attach <link xref="tags">tags</link> to all photos, or you can
+          leave that task for later.</p>
+    </item>
+    <item>
+      <p>When you are ready to finish importing photos, click <gui>Import</gui>.</p>
+    </item>
+  </steps>
+</page>
diff --git a/docs/C/import-roll-search.page b/docs/C/import-roll-search.page
new file mode 100644
index 0000000..6364665
--- /dev/null
+++ b/docs/C/import-roll-search.page
@@ -0,0 +1,38 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="topic"
+      id="import-roll-search">
+
+  <info>
+    <link type="guide" xref="index#searching"/>
+    <desc>Searching by date of import</desc>
+  </info>
+
+  <title>
+    Search by Import Roll
+  </title>
+
+  <p>Import rolls are "batches" of imported photos.  Regardless of the date the
+     photo was taken, the import roll timestamp is decided when you import photos.
+  </p>
+  <p>To search by latest import roll:</p>
+  <steps>
+    <item>
+      <p>Select <guiseq><gui>Find</gui><gui>By Import Roll</gui><gui>Last Import
+         Roll</gui></guiseq>.</p>
+    </item>
+  </steps>
+  <p>To select a previous import roll:</p>
+  <steps>
+    <item>
+      <p>Select <guiseq><gui>Find</gui><gui>By Import Roll</gui><gui>Select Import
+         Rolls</gui></guiseq>.</p>
+    </item>
+    <item>
+      <p>Select an import roll to search, or select a range by choosing
+      <gui>Between</gui> and select the dates you wish to include.</p>
+    </item>
+  </steps>
+  <p>To stop searching by import rolls, select <guiseq><gui>Find</gui><gui>By
+     Import Roll</gui><gui>Clear Roll Filter</gui></guiseq>.</p>
+</page>
diff --git a/docs/C/index.page b/docs/C/index.page
new file mode 100644
index 0000000..ffebc24
--- /dev/null
+++ b/docs/C/index.page
@@ -0,0 +1,34 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="guide"
+      id="index">
+
+  <info>
+    <title type="link">F-Spot photo manager</title>
+    <title type="text">F-Spot photo manager</title>
+  </info>
+
+  <title>
+    F-Spot photo manager
+  </title>
+
+  <section id="basic-functions" style="2column" groups="import tag rate management">
+    <title>Basic Functions</title>
+  </section>
+
+  <section id="searching" style="2column">
+    <title>Searching</title>
+  </section>
+
+  <section id="editing" style="2column" groups="general colors enhancements">
+    <title>Photo Editing</title>
+  </section>
+
+  <section id="sharing" style="2column">
+    <title>Sharing</title>
+  </section>
+
+  <section id="advanced" style="2column">
+    <title>Advanced Options</title>
+  </section>
+</page>
diff --git a/docs/C/introduction.page b/docs/C/introduction.page
new file mode 100644
index 0000000..dfe247d
--- /dev/null
+++ b/docs/C/introduction.page
@@ -0,0 +1,17 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="introduction">
+  <info>
+    <link type="guide" xref="index"/>
+    <desc>A brief introduction to F-Spot</desc>
+  </info>
+
+  <title>
+    Introduction
+  </title>
+  <p><app>F-Spot</app> is a full-featured photo manager for the GNOME Desktop,
+     allowing you to tag, rate, and date photos, edit photo metadata, and
+     even includes a simple in-program photo editor.</p>
+  <p>For help getting started using <app>F-Spot</app>, check out the <link
+  xref="index#basic-functions">basic functions</link> of the help file.</p>
+</page>
diff --git a/docs/C/picasa.page b/docs/C/picasa.page
new file mode 100644
index 0000000..1a3e9df
--- /dev/null
+++ b/docs/C/picasa.page
@@ -0,0 +1,39 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="topic"
+      id="picasa">
+
+  <info>
+    <link type="guide" xref="upload-to-web"/>
+    <desc>Upload photos to Google's PicasaWeb</desc>
+  </info>
+
+  <title>
+    Picasa
+  </title>
+
+  <p>To upload photos to Picasa you will need a Picasa account, as well as
+     internet access.  Also, the PicasaWeb
+     <link xref="extensions">extension</link> must be installed and enabled.
+     </p>
+  <steps>
+    <item>
+      <p>Select the photos you wish to upload.</p>
+    </item>
+    <item>
+      <p>Click <guiseq><gui>Photo</gui><gui>Export To</gui>
+      <gui>PicasaWeb...</gui></guiseq>.</p>
+    </item>
+    <item>
+      <p>Add a gallery by clicking <gui>Add</gui> and supplying a username and
+         password.</p>
+    </item>j
+    <item>
+      <p>Select a gallery to export to, or click <gui>Add</gui> to create a new
+         gallery.</p>
+    </item>
+    <item>
+      <p>Click <gui>Export</gui>.</p>
+    </item>
+  </steps>
+</page>
diff --git a/docs/C/rate-search.page b/docs/C/rate-search.page
new file mode 100644
index 0000000..d197c6c
--- /dev/null
+++ b/docs/C/rate-search.page
@@ -0,0 +1,35 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="topic"
+      id="rate-search">
+
+  <info>
+    <link type="guide" xref="index#searching"/>
+    <desc>Search photos by star rating</desc>
+  </info>
+
+  <title>
+    Search by Rating
+  </title>
+
+  <p>To search by rating:</p>
+  <steps>
+    <item>
+      <p>Select <guiseq><gui>Find</gui><gui>By Rating</gui><gui>Set Rating
+         Filter...</gui></guiseq>.</p>
+    </item>
+    <item>
+      <p>Select the rating range which you wish to view.</p>
+    </item>
+    <item>
+      <p>Click <gui>Ok</gui>.</p>
+    </item>
+  </steps>
+  <p>To stop searching by rating:</p>
+  <steps>
+    <item>
+      <p>Select <guiseq><gui>Find</gui><gui>By Rating</gui><gui>Set Rating
+         Filter</gui></guiseq>.</p>
+    </item>
+  </steps>
+</page>
diff --git a/docs/C/ratings.page b/docs/C/ratings.page
new file mode 100644
index 0000000..0bf8770
--- /dev/null
+++ b/docs/C/ratings.page
@@ -0,0 +1,35 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="ratings">
+  <info>
+    <link type="guide" xref="index#basic-functions" group="rate"/>
+    <desc>Rate your photos from one to five stars</desc>
+  </info>
+
+  <title>
+    Rating your photos
+  </title>
+  <p><app>F-Spot</app> allows you to rate your photos from one to five stars.
+     There are two ways to rate photos.</p>
+  <p>Method One:</p>
+  <steps>
+    <item>
+      <p>By double-clicking, select the photo you wish to rate.</p>
+    </item>
+    <item>
+      <p>In the lower-right corner, you will see five dots, corresponding to
+         the rating you wish to give; to give a rating of one star, for
+         example, click the first dot.</p>
+    </item>
+  </steps>
+  <p>Method Two:</p>
+  <steps>
+    <item>
+      <p>Select the photo(s) you wish to rate.</p>
+    </item>
+    <item>
+      <p>Right-click the photo(s) you wish to rate, and select a rating at the
+         bottom of the right-click menu by clicking the corresponding dot.</p>
+    </item>
+  </steps>
+</page>
diff --git a/docs/C/smugmug.page b/docs/C/smugmug.page
new file mode 100644
index 0000000..079ad3b
--- /dev/null
+++ b/docs/C/smugmug.page
@@ -0,0 +1,19 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="topic"
+      id="smugmug">
+
+  <info>
+    <link type="guide" xref="upload-to-web"/>
+    <desc>Upload photos to SmugMug</desc>
+  </info>
+
+  <title>
+    SmugMug
+  </title>
+
+  <p>To upload photos to SmugMug you will need a SmugMug account, as well as
+     internet access.  Also, the SmugMug
+     <link xref="extensions">extension</link> must be installed and enabled.
+     </p>
+</page>
diff --git a/docs/C/tag-attach.page b/docs/C/tag-attach.page
new file mode 100644
index 0000000..a30f1e5
--- /dev/null
+++ b/docs/C/tag-attach.page
@@ -0,0 +1,42 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="tag-attach">
+  <info>
+    <link type="guide" xref="tags#tag-functions" group="attach"/>
+    <desc>Attaching tags to photos</desc>
+  </info>
+
+  <title>
+    Attaching
+  </title>
+  <p>By attaching tags you have <link xref="tag-creation">created</link> you
+     make it easier to search through your photos.  As with creating tags,
+     there is more than one method of attaching tags to photos.</p>
+  <p>Method One:</p>
+  <steps>
+    <item>
+      <p>Select photos to which to attach a tag.</p>
+    </item>
+    <item>
+      <p>In the tag pane, select a tag to attach to the photos you have
+         selected.</p>
+    </item>
+    <item>
+      <p>Click <guiseq><gui>Tags</gui><gui>Attach Tag to Selection</gui>
+      </guiseq>.  Alternatively, press Ctrl+T.</p>
+    </item>
+  </steps>
+  <p>Method Two:</p>
+  <steps>
+    <item>
+      <p>Select photos to which to attach a tag.</p>
+    </item>
+    <item>
+      <p>Right click the photos.</p>
+    </item>
+    <item>
+      <p>Select <gui>Attach Tag</gui> and select the tag you wish to attach.
+      </p>
+    </item>
+  </steps>
+</page>
diff --git a/docs/C/tag-creation.page b/docs/C/tag-creation.page
new file mode 100644
index 0000000..9db50b5
--- /dev/null
+++ b/docs/C/tag-creation.page
@@ -0,0 +1,72 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="tag-creation">
+  <info>
+    <link type="guide" xref="tags#tag-functions" group="create"/>
+    <desc>Creating tags to be attached to photos</desc>
+  </info>
+
+  <title>
+    Creating
+  </title>
+  <p>In order to use tags, you need to first create a set of tags which you
+     wish to use.  There are three main methods to create tags.</p>
+  <p>Method One:</p>
+  <steps>
+    <item>
+      <p>Select <guiseq><gui>Tags</gui><gui>Create New Tag...</gui></guiseq>.
+      </p>
+    </item>
+    <item>
+      <p>Select a parent tag for the new tag to appear under, such as people
+         or events.  If you wish to create a new tag without a parent, select
+         <gui>(None)</gui>.</p>
+    </item>
+    <item>
+      <p>Name the tag.</p>
+    </item>
+    <item>
+      <p>Click <gui>Create</gui></p>
+    </item>
+  </steps>
+  <p>Method Two:</p>
+  <steps>
+    <item>
+      <p>In the tags page, right click, and select <gui>Create New Tag...</gui>
+      </p>
+    </item>
+    <item>
+      <p>Select a parent tag for the new tag to appear under, such as people
+         or events.  If you wish to create a new tag without a parent, select
+         <gui>(None)</gui>.</p>
+    </item>
+    <item>
+      <p>Name the tag.</p>
+    </item>
+    <item>
+      <p>Click <gui>Create</gui></p>
+    </item>
+  </steps>
+  <p>Method three has the advantage of also <link xref="tag-attach">
+     attaching</link> the new tag to the photos selected.  To do this:</p>
+  <steps>
+    <item>
+      <p>Select the photos to which you wish to attach the new tag.</p>
+    </item>
+    <item>
+      <p>Right-click on the photos, and select <guiseq><gui>Attach Tag</gui>
+         <gui>Create New Tag...</gui></guiseq>.</p>
+    </item>
+    <item>
+      <p>Select a parent tag for the new tag to appear under, such as people
+         or events.  If you wish to create a new tag without a parent, select
+         <gui>(None)</gui>.</p>
+    </item>
+    <item>
+      <p>Name the tag.</p>
+    </item>
+    <item>
+      <p>Click <gui>Create</gui></p>
+    </item>
+  </steps>
+</page>
diff --git a/docs/C/tag-delete.page b/docs/C/tag-delete.page
new file mode 100644
index 0000000..651523f
--- /dev/null
+++ b/docs/C/tag-delete.page
@@ -0,0 +1,25 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="tag-delete">
+  <info>
+    <link type="guide" xref="tags#tag-functions" group="delete"/>
+    <desc>Deleting tags from the system</desc>
+  </info>
+
+  <title>
+    Deleting
+  </title>
+  <p>Deleting tags removes them entirely from your system, but leaves behind
+     any photos to which that tag is attached.</p>
+  <p>To delete a tag:</p>
+  <steps>
+    <item>
+      <p>Select the tag you wish to delete from within the tag pane.</p>
+    </item>
+    <item>
+      <p>Click <guiseq><gui>Tags</gui><gui>Delete Select Tag</gui></guiseq>.
+      Alternatively, right click the tag within the pane, and click
+      <gui>Delete Tag</gui>.</p>
+    </item>
+  </steps>
+</page>
diff --git a/docs/C/tag-remove.page b/docs/C/tag-remove.page
new file mode 100644
index 0000000..86c1b7e
--- /dev/null
+++ b/docs/C/tag-remove.page
@@ -0,0 +1,41 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="tag-remove">
+  <info>
+    <link type="guide" xref="tags#tag-functions" group="remove"/>
+    <desc>Removing tags from photos</desc>
+  </info>
+
+  <title>
+    Removing
+  </title>
+  <p>As with attaching tags, there are two main methods of removing tags
+     from photos.</p>
+  <p>Method One:</p>
+  <steps>
+    <item>
+      <p>Select photos from which to remove a tag.</p>
+    </item>
+    <item>
+      <p>In the tag pane, select a tag to remove from the photos you have
+         selected.</p>
+    </item>
+    <item>
+      <p>Click <guiseq><gui>Tags</gui><gui>Remove Tag From Selection</gui>
+      </guiseq>.</p>
+    </item>
+  </steps>
+  <p>Method Two:</p>
+  <steps>
+    <item>
+      <p>Select photos from which to remove a tag.</p>
+    </item>
+    <item>
+      <p>Right click the photos.</p>
+    </item>
+    <item>
+      <p>Select <gui>Remove Tag</gui> and select the tag you wish to remove.
+      </p>
+    </item>
+  </steps>
+</page>
diff --git a/docs/C/tag-search.page b/docs/C/tag-search.page
new file mode 100644
index 0000000..2b3b28f
--- /dev/null
+++ b/docs/C/tag-search.page
@@ -0,0 +1,40 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="topic"
+      id="tag-search">
+
+  <info>
+    <link type="guide" xref="index#searching"/>
+    <desc>Search photos using tags</desc>
+  </info>
+
+  <title>
+    Search by Tag
+  </title>
+
+  <p>There are several methods to search by tags.</p>
+  <p>Method One:  Double-click the tags you wish to search for.</p>
+  <p>Method Two:</p>
+  <steps>
+    <item>
+      <p>Enable the Find bar by clicking <guiseq><gui>Find</gui>
+         <gui>Show Find bar</gui></guiseq>.</p>
+    </item>
+    <item>
+      <p>Drag the tags you wish to search for into the newly-enabled Find bar.
+      </p>
+    </item>
+  <p>To remove a tag from your search, right-click the tag in the Find bar and
+     click <gui>Remove From Search</gui>.</p>
+  </steps>
+  <p>To exclude a tag from your search:</p>
+  <steps>
+    <item>
+      <p>In the tag pane, double-click the tag you wish to exclude.  This will
+         add it to the Find bar.</p>
+    </item>
+    <item>
+      <p>In the Find bar, double-click the tag you wish to exclude.</p>
+    </item>
+  </steps>
+</page>
diff --git a/docs/C/tags.page b/docs/C/tags.page
new file mode 100644
index 0000000..68d3fe9
--- /dev/null
+++ b/docs/C/tags.page
@@ -0,0 +1,19 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="guide"
+      id="tags">
+  <info>
+    <link type="guide" xref="index#basic-functions" group="tag"/>
+    <desc>A brief introduction to the tagging capabilities of F-Spot</desc>
+  </info>
+
+  <title>
+    Tags
+  </title>
+  <p>Like certain other photo managers, <app>F-Spot</app> lets you tag your photos,
+     allowing for quick, easy content-based searching of your photos.  You can
+     tag people, events, places, favorite things, or even make your own groups
+     of tags.</p>
+  <section id="tag-functions" style="2column" groups="create attach remove delete">
+    <title>Working with Tags</title>
+  </section>
+</page>
diff --git a/docs/C/upload-to-web.page b/docs/C/upload-to-web.page
new file mode 100644
index 0000000..42efd9b
--- /dev/null
+++ b/docs/C/upload-to-web.page
@@ -0,0 +1,16 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="guide"
+      id="upload-to-web">
+
+  <info>
+    <link type="guide" xref="index#sharing"/>
+    <desc>Upload photos to various web services</desc>
+  </info>
+
+  <title>
+    Upload to Web
+  </title>
+  <p><app>F-Spot</app> allows you to upload photos to popular web services,
+     including Google's PicasaWeb and Flickr.</p>
+</page>
diff --git a/docs/C/versioning.page b/docs/C/versioning.page
new file mode 100644
index 0000000..ff7a266
--- /dev/null
+++ b/docs/C/versioning.page
@@ -0,0 +1,28 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="topic"
+      id="versions">
+
+  <info>
+    <link type="guide" xref="index#advanced"/>
+    <desc>Track different versions of your photos</desc>
+  </info>
+
+  <title>
+    Versioning
+  </title>
+  <p><app>F-Spot</app> allows you to keep multiple versions of your photos.
+     This is especially useful when editing photos, as you can quickly see the
+     difference between the edited version and the original.</p>
+  <p>To switch between versions while editing:</p>
+  <steps>
+    <item>
+      <p>Double-click the photo you wish to edit.</p>
+    </item>
+    <item>
+      <p>In the sidebar, you will see a drop-down box labeled
+         <gui>Version:</gui>.  To select a version to view, select it in the
+         drop-down box.</p>
+    </item>
+  </steps>
+</page>
diff --git a/docs/C/zooomr.page b/docs/C/zooomr.page
new file mode 100644
index 0000000..21c3ca3
--- /dev/null
+++ b/docs/C/zooomr.page
@@ -0,0 +1,19 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="topic"
+      id="zooomr">
+
+  <info>
+    <link type="guide" xref="upload-to-web"/>
+    <desc>Upload photos to Zooomr</desc>
+  </info>
+
+  <title>
+    Zooomr
+  </title>
+
+  <p>To upload photos to Zooomr you will need a Zooomr account, as well as
+     internet access.  Also, the Zooomr
+     <link xref="extensions">extension</link> must be installed and enabled.
+     </p>
+</page>



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