summaryrefslogtreecommitdiff
path: root/help/C
diff options
context:
space:
mode:
Diffstat (limited to 'help/C')
-rw-r--r--help/C/edit-adjustments.page51
-rw-r--r--help/C/edit-crop.page46
-rw-r--r--help/C/edit-enhance.page17
-rw-r--r--help/C/edit-external.page54
-rw-r--r--help/C/edit-nondestructive.page22
-rw-r--r--help/C/edit-redeye.page26
-rw-r--r--help/C/edit-rotate.page27
-rw-r--r--help/C/edit-straighten.page28
-rw-r--r--help/C/edit-time-date.page21
-rw-r--r--help/C/edit-undo.page22
-rwxr-xr-xhelp/C/figures/crop_thirds.jpgbin0 -> 10579 bytes
-rw-r--r--help/C/figures/edit_toolbar.pngbin0 -> 6786 bytes
-rw-r--r--help/C/figures/editing_overview.pngbin0 -> 183110 bytes
-rw-r--r--help/C/figures/shotwell_logo.pngbin0 -> 3658 bytes
-rw-r--r--help/C/figures/trash_process.pngbin0 -> 38417 bytes
-rwxr-xr-xhelp/C/formats.page35
-rw-r--r--help/C/import-camera.page33
-rw-r--r--help/C/import-f-spot.page22
-rw-r--r--help/C/import-file.page24
-rw-r--r--help/C/import-memorycard.page32
-rw-r--r--help/C/index.page48
-rw-r--r--help/C/organize-event.page60
-rw-r--r--help/C/organize-flag.page35
-rw-r--r--help/C/organize-rating.page30
-rw-r--r--help/C/organize-remove.page45
-rw-r--r--help/C/organize-search.page63
-rw-r--r--help/C/organize-tag.page94
-rw-r--r--help/C/organize-title.page20
-rw-r--r--help/C/other-files.page146
-rw-r--r--help/C/other-missing.page23
-rw-r--r--help/C/other-multiple.page23
-rw-r--r--help/C/other-plugins.page29
-rw-r--r--help/C/raw.page46
-rw-r--r--help/C/running.page29
-rw-r--r--help/C/share-background.page23
-rw-r--r--help/C/share-export.page45
-rw-r--r--help/C/share-print.page24
-rw-r--r--help/C/share-send.page25
-rw-r--r--help/C/share-slideshow.page23
-rw-r--r--help/C/share-upload.page38
-rw-r--r--help/C/view-displaying.page28
-rw-r--r--help/C/view-information.page19
-rw-r--r--help/C/view-sidebar.page36
43 files changed, 1412 insertions, 0 deletions
diff --git a/help/C/edit-adjustments.page b/help/C/edit-adjustments.page
new file mode 100644
index 0000000..c8d9e3f
--- /dev/null
+++ b/help/C/edit-adjustments.page
@@ -0,0 +1,51 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="edit-adjustments">
+
+ <info>
+ <link type="guide" xref="index#edit"/>
+ <desc>Change the exposure, saturation, tint, and shadows of a photo.</desc>
+
+ <link type="next" xref="edit-crop" />
+ </info>
+
+ <title>Color adjustments</title>
+
+<p>The <gui>Adjust</gui> button opens a floating window with a histogram and sliders to adjust a photo's exposure, saturation, tint, temperature, and shadows. The histogram also has sliders to reduce the upper and lower intensity thresholds of the photograph, expanding the contrast of the middle range.</p>
+
+<p>The <gui>Enhance</gui> button adjusts the histogram and shadows sliders to improve the quality of a photo.</p>
+
+<p>When the photo's colors and contrast are to your liking, press <gui>Apply</gui> to save the changes. <gui>Reset</gui> will return the image to its original state. <gui>Cancel</gui> discards all changes you've made.</p>
+
+<section>
+ <title>What do the color adjustments do?</title>
+ <terms>
+ <item>
+ <title>Exposure</title>
+ <p>Changes the brightness to make it look like the photo was exposed for a longer or shorter time. Use this to correct under- or over-exposed photos.</p>
+ </item>
+ <item>
+ <title>Saturation</title>
+ <p>Changes how vivid colors look. If your photo looks gray and washed out, try increasing the saturation. If colors look too bold, try decreasing it.</p>
+ </item>
+ <item>
+ <title>Tint</title>
+ <p>This tints the photo with a color. It's useful for correcting photos taken with the wrong white balance setting, which typically have an unnatural color cast. For example, photos taken outdoors with the white balance set to "Tungsten" may have a blue cast.</p>
+ </item>
+ <item>
+ <title>Temperature</title>
+ <p>Changes how "warm" or "cool" the picture looks. Use this to make cold, depressing scenes look more lively, for example.</p>
+ </item>
+ <item>
+ <title>Shadows</title>
+ <p>This makes shadowy areas appear lighter. Use this to make detail more visible if it's obscured by the darkness of a shadow.</p>
+ </item>
+ <item>
+ <title>Intensity Threshold (sliders on the histogram)</title>
+ <p>These sliders change how light the brightest white is and how dark the darkest black is. Use them to change the contrast of the photo. Photos which look washed out should particularly benefit from changing these settings.</p>
+ </item>
+ </terms>
+</section>
+
+</page>
+
diff --git a/help/C/edit-crop.page b/help/C/edit-crop.page
new file mode 100644
index 0000000..f39028f
--- /dev/null
+++ b/help/C/edit-crop.page
@@ -0,0 +1,46 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="edit-crop">
+
+ <info>
+ <link type="guide" xref="index#edit"/>
+ <desc>Improve the composition of a photo by cutting out parts of it.</desc>
+
+ <link type="next" xref="edit-external" />
+ </info>
+
+ <title>Cropping</title>
+
+ <p>To reduce the area of a photo and concentrate the viewer's attention on a smaller portion of it, use the Crop tool.
+ The crop tool is only available in full-window or fullscreen mode.</p>
+
+<steps>
+ <item>
+ <p>Double-click on a photo to enter full-window mode, then press the <gui>Crop</gui> button on the toolbar.</p>
+ </item>
+ <item>
+ <p>A white box, the crop rectangle, will appear over the photo. The lighter portion of the photo within the crop rectangle represents what the photo will look like when you crop it.</p>
+ </item>
+ <item>
+ <p>If you place your cursor in the middle of the box, you can move the box around. If you drag the edges of the box, you can adjust its size. As you move and adjust the crop box, you'll see four lines appear inside it, like a tic-tac-toe grid. These are <em>rule of thirds</em> lines.</p>
+ <p>You can also constrain the crop box to one of many common sizes. Choose a size from the drop-down list that suits your needs. If you press the flip button next to it, the orientation of the constraint will switch (from landscape to portrait).</p>
+ </item>
+ <item>
+ <p>When you're happy with your crop outline, press the <gui>Apply</gui> button. Shotwell will display the cropped photo.</p>
+ </item>
+ <item>
+ <p>If you change your mind, press the <gui>Crop</gui> button again and fine-tune the crop.</p>
+ <p>If you press <gui>Cancel</gui> rather than <gui>Apply</gui>, Shotwell will return to the photo's previous crop dimensions.</p>
+ </item>
+</steps>
+
+<section>
+ <title>What is the rule of thirds?</title>
+ <p>The <em>rule of thirds</em> helps you to choose a pleasing composition for a photo.</p>
+ <p>Imagine that the scene is divided up into a 3x3 grid by two equally-spaced vertical lines and two equally-spaced horizontal lines. According to the rule, you're more likely to get a pleasing composition if you align major features (like the horizon, or a person's body) with one of the lines. Paying attention to the way features flow from one part of the grid to another can also help.</p>
+ <p>Cropping a photo so that it conforms to the rule of thirds often results in a more visually appealing image.</p>
+ <media type="image" src="figures/crop_thirds.jpg">
+ <p>Cropping a photo, using the "rule of thirds" lines to improve the composition.</p>
+ </media>
+</section>
+</page>
diff --git a/help/C/edit-enhance.page b/help/C/edit-enhance.page
new file mode 100644
index 0000000..8e8040d
--- /dev/null
+++ b/help/C/edit-enhance.page
@@ -0,0 +1,17 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="edit-enhance">
+
+ <info>
+ <link type="guide" xref="index#edit"/>
+ <desc>Let Shotwell improve the brightness and contrast of a photo automatically.</desc>
+
+ <link type="seealso" xref="edit-adjustments" />
+
+ <link type="next" xref="edit-adjustments" />
+ </info>
+
+ <title>Auto-enhance</title>
+
+ <p>Clicking on the <gui>Enhance</gui> button is a quick way to automatically adjust the brightness and contrast of your photo. It will often give you a photo that is correctly exposed. You can also use it as a starting point and then improve the adjustments by clicking on the <gui>Adjust</gui> button.</p>
+</page>
diff --git a/help/C/edit-external.page b/help/C/edit-external.page
new file mode 100644
index 0000000..cee9fea
--- /dev/null
+++ b/help/C/edit-external.page
@@ -0,0 +1,54 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="edit-external">
+
+ <info>
+ <link type="guide" xref="index#edit"/>
+ <desc>Use a different program to edit a photo.</desc>
+
+ <link type="next" xref="edit-redeye" />
+ </info>
+
+ <title>
+ Edit photos with an external program
+ </title>
+
+ <p>
+ You might want to use an external editor to do additional work on a photo.
+ If installed, GIMP and UFRaw are the default external editors for photo and RAW editing,
+ respectively. If these programs are not installed, you must select your preferred
+ editors by choosing <guiseq><gui>Edit</gui><gui>Preferences</gui></guiseq> and selecting
+ editors from drop-down menus of installed applications.
+ </p>
+
+ <p>
+ Once your editors have been set, select a photo and choose <guiseq><gui>Photos</gui>
+ <gui>Open With External Editor</gui></guiseq> to open the photo with the external editor.
+ Likewise, if the original photo is a RAW file, select <guiseq><gui>Photos</gui><gui>Open
+ With RAW Editor</gui></guiseq> to edit the RAW file directly with the set RAW editor.
+ </p>
+
+ <p>
+ When you complete your edits and save the file, Shotwell will detect the changes and
+ update the photo. When external edits have been made, press and hold the
+ <key>Shift</key> key in full-window view to show the original photo rather than the
+ externally-edited one.
+ </p>
+
+ <p>
+ Reverting to original will erase any external edits.
+ </p>
+
+ <note>
+ <p>
+ If you externally edit a RAW photo and save the result to another image, such as a
+ JPEG or PNG, Shotwell cannot automatically determine that the original RAW and the
+ new image should be paired.
+ </p>
+
+ <p>
+ If you want to work within the resulting image within Shotwell, you'll need to
+ import it yourself.
+ </p>
+ </note>
+</page>
diff --git a/help/C/edit-nondestructive.page b/help/C/edit-nondestructive.page
new file mode 100644
index 0000000..c289e25
--- /dev/null
+++ b/help/C/edit-nondestructive.page
@@ -0,0 +1,22 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="edit-nondestructive">
+
+ <info>
+ <link type="guide" xref="index#edit"/>
+ <desc>Shotwell is a non-destructive photo editor - it does not modify your original photos.</desc>
+
+ <link type="next" xref="edit-time-date" />
+ </info>
+
+ <title>What happens to the original when I edit a photo?</title>
+
+<p>Shotwell is a non-destructive photo editor. It does not modify your original photographs. That is to say, if you crop a photo or adjust its colors, the photo file on disc remains untouched. Shotwell stores your edits in a database and applies them on the fly as necessary. This means you can undo any alterations you make to a photograph.</p>
+
+<p>If you want to see what a photo looked like before your modifications, press the <key>Shift</key> key. The original photo will be displayed as long as you hold the key down.</p>
+
+<p>Note that Shotwell can optionally write metadata (such as tags and titles) to photo files.
+For more information, see the section <link xref="other-files">Photo files</link>.</p>
+
+</page>
+
diff --git a/help/C/edit-redeye.page b/help/C/edit-redeye.page
new file mode 100644
index 0000000..470874f
--- /dev/null
+++ b/help/C/edit-redeye.page
@@ -0,0 +1,26 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="edit-redeye">
+
+ <info>
+ <link type="guide" xref="index#edit"/>
+ <desc>Correct photos where people have red eyes because of the camera's flash.</desc>
+
+ <link type="next" xref="edit-rotate" />
+ </info>
+
+ <title>Removing red-eye</title>
+
+ <p>Red-eye occurs when the camera's flash reflects off the pupil of someone's eye. To eliminate this in a photo, use the Red-eye tool.</p>
+ <steps>
+ <item>
+ <p>Click <gui>Red-eye</gui>. A circle will appear on the photo.</p>
+ </item>
+ <item>
+ <p>Drag the circle over the affected pupil, adjust its size with the slider control, and press <gui>Apply</gui>. The redness will be removed.</p>
+ </item>
+ <item>
+ <p>Repeat this process for all red pupils in your photo. Press <gui>Close</gui> when finished.</p>
+ </item>
+ </steps>
+</page>
diff --git a/help/C/edit-rotate.page b/help/C/edit-rotate.page
new file mode 100644
index 0000000..6a85966
--- /dev/null
+++ b/help/C/edit-rotate.page
@@ -0,0 +1,27 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="edit-rotate">
+
+ <info>
+ <link type="guide" xref="index#edit"/>
+ <desc>Click the <gui>Rotate</gui> button, or choose one of the commands in the <gui>Photo</gui> menu.</desc>
+
+ <link type="next" xref="edit-straighten" />
+ </info>
+
+ <title>Rotate or flip a photo</title>
+
+ <p>You can rotate your photos left and right (clockwise and counterclockwise) with the <gui>Rotate</gui> button on the toolbar of most views. You can also make a mirror image of any photo.</p>
+
+ <p>To rotate right, click on the <gui>Rotate</gui> button. To rotate left, press and hold the <key>Ctrl</key> key and then click the button. Both commands are available in the <gui>Photos</gui> menu too. Alternatively, use the following keyboard shortcuts:</p>
+ <list>
+ <item><p>rotate left: <keyseq><key>Shift</key><key>Ctrl</key><key>R</key></keyseq> or <key>[</key></p></item>
+ <item><p>rotate right: <keyseq><key>Ctrl</key><key>R</key></keyseq> or <key>]</key></p></item>
+ </list>
+ <p>To create a mirror image of a photo, use the <gui>Flip Horizontally</gui> command in the <gui>Photos</gui> menu. To flip an image vertically, use the <gui>Flip Vertically</gui> command in the same menu.</p>
+
+ <note>
+ <p>If you select more than one image, you can rotate all of them at the same time.</p>
+ </note>
+
+</page>
diff --git a/help/C/edit-straighten.page b/help/C/edit-straighten.page
new file mode 100644
index 0000000..6dc0af1
--- /dev/null
+++ b/help/C/edit-straighten.page
@@ -0,0 +1,28 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="edit-straighten">
+
+ <info>
+ <link type="guide" xref="index#edit"/>
+ <desc>Straighten a photo so that its horizon appears level.</desc>
+
+ <link type="next" xref="edit-undo" />
+ </info>
+
+ <title>Straighten photos</title>
+
+<p>The straighten tools allows photos to be leveled and straightened. The straighten tool is only available in full-window or fullscreen mode. </p>
+
+ <steps>
+ <item>
+ <p>Click <gui>Straighten</gui>. The straighten slider will appear. Alternatively, use the keyboard shortcut <keyseq><key>Ctrl</key><key>A</key></keyseq>.</p>
+ </item>
+ <item>
+ <p>Drag the slider to achieve the desired degree of straightening.</p>
+ </item>
+ <item>
+ <p>Press <gui>OK</gui> when finished.</p>
+ </item>
+ </steps>
+
+</page>
diff --git a/help/C/edit-time-date.page b/help/C/edit-time-date.page
new file mode 100644
index 0000000..2f3f03c
--- /dev/null
+++ b/help/C/edit-time-date.page
@@ -0,0 +1,21 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="edit-time-date">
+
+ <info>
+ <link type="guide" xref="index#edit"/>
+ <desc>Change the time and date of photos if those details are incorrect.</desc>
+
+ <link type="next" xref="edit-enhance" />
+ </info>
+
+ <title>Adjust the time and date of photos</title>
+
+<p>To adjust the time and date of photos, select the photos you would like to adjust, choose <guiseq><gui>Photos</gui><gui>Adjust Time and Date</gui></guiseq> and select a new time and date.</p>
+
+<p>If you are changing the date and time of multiple photos at once, you can choose to shift all the photos by the same amount of time or to set all the photos to the same time.</p>
+
+<p>By default, the time and date are only changed inside Shotwell. You can also choose to modify the time and date in the original file, but this cannot be undone once you exit Shotwell.</p>
+
+</page>
+
diff --git a/help/C/edit-undo.page b/help/C/edit-undo.page
new file mode 100644
index 0000000..74c2f78
--- /dev/null
+++ b/help/C/edit-undo.page
@@ -0,0 +1,22 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="edit-undo">
+
+ <info>
+ <link type="guide" xref="index#edit"/>
+ <desc>Return a photo to its original, unedited form.</desc>
+
+ <link type="seealso" xref="edit-nondestructive" />
+
+ <link type="next" xref="edit-nondestructive" />
+ </info>
+
+ <title>Undoing changes</title>
+
+ <p>Because Shotwell is a non-destructive photo editor, you can undo any alterations you make to a photograph.</p>
+
+ <p>If you want to see what a photo looked like before your modifications, press the <key>Shift</key> key. The original photo will be displayed as long as you hold the key down.</p>
+
+ <p>To completely undo all the changes you've made to a photo, click <guiseq><gui>Photos</gui><gui>Revert to Original</gui></guiseq>. The only exception is that time and date adjustments will not be reverted.</p>
+
+</page>
diff --git a/help/C/figures/crop_thirds.jpg b/help/C/figures/crop_thirds.jpg
new file mode 100755
index 0000000..2e5ebb4
--- /dev/null
+++ b/help/C/figures/crop_thirds.jpg
Binary files differ
diff --git a/help/C/figures/edit_toolbar.png b/help/C/figures/edit_toolbar.png
new file mode 100644
index 0000000..0a5f5ae
--- /dev/null
+++ b/help/C/figures/edit_toolbar.png
Binary files differ
diff --git a/help/C/figures/editing_overview.png b/help/C/figures/editing_overview.png
new file mode 100644
index 0000000..266b639
--- /dev/null
+++ b/help/C/figures/editing_overview.png
Binary files differ
diff --git a/help/C/figures/shotwell_logo.png b/help/C/figures/shotwell_logo.png
new file mode 100644
index 0000000..5431bdb
--- /dev/null
+++ b/help/C/figures/shotwell_logo.png
Binary files differ
diff --git a/help/C/figures/trash_process.png b/help/C/figures/trash_process.png
new file mode 100644
index 0000000..d114d32
--- /dev/null
+++ b/help/C/figures/trash_process.png
Binary files differ
diff --git a/help/C/formats.page b/help/C/formats.page
new file mode 100755
index 0000000..5b9b19d
--- /dev/null
+++ b/help/C/formats.page
@@ -0,0 +1,35 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="formats">
+
+ <info>
+ <link type="guide" xref="index"/>
+ <desc>Shotwell supports JPEG, PNG, TIFF, BMP and RAW photo files as well as video files.</desc>
+
+ <link type="next" xref="running" />
+ </info>
+
+ <title>Supported photo and video formats</title>
+
+ <p>Shotwell supports JPEG, PNG, TIFF, BMP and <link type="guide" xref="other-raw">RAW</link> photo files. Shotwell does not yet support other graphics format such as GIF.</p>
+
+<p>Shotwell's RAW format support is currently limited. When you view a RAW photo, you are actually viewing a JPEG derived from the RAW photo, not the RAW image itself. Additionally, the RAW editing pipeline is not fully 16-bit - you can only export edited photos as 8-bit files. All supported formats can be used for export (JPEG, PNG, TIFF, BMP).</p>
+
+<p>For more information about RAW-format photos in Shotwell, please see
+the <link type="guide" xref="other-raw">RAW</link> section.
+</p>
+
+<p>Shotwell also supports video files in any format supported by the GStreamer media library on the system where
+Shotwell is running. This typically includes the following formats among others:</p>
+<list>
+<item><p>Container formats: Ogg, QuickTime, MP4, AVI.</p></item>
+<item><p>Codecs: Theora, Quicktime, MPEG-4, Motion JPEG. <em>Note that some operating systems may not include all
+codecs listed here due to legal or licensing restrictions.</em></p></item>
+</list>
+
+<p>Shotwell supports both photos and videos, but for simplicity, this documentation uses just the term "photos"
+in most places. Many operations in Shotwell apply to both photos and videos, however. In particular, events,
+flagging, rating, tagging, and publishing work both for photos and for videos.</p>
+
+</page>
+
diff --git a/help/C/import-camera.page b/help/C/import-camera.page
new file mode 100644
index 0000000..59d3e31
--- /dev/null
+++ b/help/C/import-camera.page
@@ -0,0 +1,33 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="import-camera">
+
+ <info>
+ <link type="guide" xref="index#import"/>
+ <desc>Copy photos from a digital camera.</desc>
+
+ <link type="next" xref="import-memorycard"/>
+ </info>
+
+ <title>Importing from a camera</title>
+
+ <p>To import photos from a digital camera:</p>
+
+ <steps>
+ <item>
+ <p>Connect the camera to your computer and switch it on.
+ Shotwell will detect it and list it in the sidebar.</p>
+ </item>
+ <item>
+ <p>Select the camera in the sidebar. Previews of each photo on the camera will be displayed.</p>
+ </item>
+ <item>
+ <p>If you like, you can choose a set of specific photos to import. To do this, hold down the <key>Ctrl</key> key and click to select individual photos. You can hold down <key>Shift</key> and click to select a range of photos too.</p>
+ </item>
+ <item>
+ <p>Click either <gui>Import Selected</gui> or <gui>Import All</gui>. The photos will be copied from the camera and saved on your computer.</p>
+ </item>
+ </steps>
+
+ <p>Once the import is complete, you can open the <gui>Last Import</gui> view (in the sidebar) to see all photos that were imported. The Events list (also in the sidebar) will also show the new photos, organized by date.</p>
+</page>
diff --git a/help/C/import-f-spot.page b/help/C/import-f-spot.page
new file mode 100644
index 0000000..f96c128
--- /dev/null
+++ b/help/C/import-f-spot.page
@@ -0,0 +1,22 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="import-f-spot">
+
+ <info>
+ <link type="guide" xref="index#import"/>
+ <desc>Shotwell can import all your photos and tags from the F-Spot photo manager.</desc>
+
+ <link type="next" xref="import-camera"/>
+ </info>
+
+ <title>Importing from F-Spot</title>
+
+ <p>To import an existing photo collection from F-Spot:</p>
+ <steps>
+ <item><p>Select <guiseq><gui>File</gui><gui>Import From F-Spot</gui></guiseq>. </p></item>
+ <item><p>Now choose either the default F-Spot library or another F-Spot database.
+ If importing from another F-Spot database, select a directory and file from the chooser dialog box.</p></item>
+ </steps>
+ <p>Shotwell will import your photos, together with their tags and other information.
+ Once the import is complete, you can select <gui>Last Import</gui> in the sidebar to see all photos successfully imported. The Events list will also show new entries for the dates corresponding to the imported photos.</p>
+</page>
diff --git a/help/C/import-file.page b/help/C/import-file.page
new file mode 100644
index 0000000..afc8cef
--- /dev/null
+++ b/help/C/import-file.page
@@ -0,0 +1,24 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="import-file">
+
+ <info>
+ <link type="guide" xref="index#import"/>
+ <desc>Import photos that are already saved on your computer.</desc>
+
+ <link type="next" xref="import-f-spot"/>
+ </info>
+
+ <title>Importing from your hard disk</title>
+
+ <p>To import photo files from your hard disk into Shotwell, just drag them from your file browser into the Shotwell window.</p>
+
+ <p>Alternatively, click <guiseq><gui>File</gui><gui>Import From Folder</gui></guiseq> and select the folder containing the photos you want to import.</p>
+
+ <p>Shotwell will ask whether you want to copy the photo files to your library folder (usually this is the <file>Pictures</file> folder in your home directory) or to import them in place without copying the files.</p>
+
+ <p>If you hold down <key>Ctrl</key> while dragging photos in, Shotwell will copy the photos into your library folder without prompting. Similarly, if you hold down <keyseq><key>Ctrl</key><key>Shift</key></keyseq> while dragging photos in, Shotwell will import the photos without copying them.</p>
+
+ <p>Once the import is complete, you can select <gui>Last Import</gui> in the sidebar to see all photos successfully imported. The Events list will also show new entries for the dates corresponding to the imported photos.</p>
+
+</page>
diff --git a/help/C/import-memorycard.page b/help/C/import-memorycard.page
new file mode 100644
index 0000000..79833d9
--- /dev/null
+++ b/help/C/import-memorycard.page
@@ -0,0 +1,32 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="import-memorycard">
+
+ <info>
+ <link type="guide" xref="index#import"/>
+ <desc>Import photos from a digital camera's memory card.</desc>
+
+ <link type="next" xref="import-file"/>
+ </info>
+
+ <title>Importing from a memory card</title>
+
+<p>To import photos from a camera memory card:</p>
+
+<steps>
+ <item>
+ <p>Put the card into your card reader. Make sure the card reader is plugged in to the computer and switched on.</p>
+ </item>
+ <item>
+ <p>The card reader and card should be detected automatically.</p>
+ </item>
+ <item>
+ <p>Follow the instructions for <link xref="import-file">importing photos from your hard disk</link>. If you click <guiseq><gui>File</gui><gui>Import From Folder</gui></guiseq>, the memory card should be visible as a folder in the side bar of the file selection window.</p>
+ </item>
+</steps>
+
+<p>Shotwell can import photos from any memory card that is compatible with your card reader.</p>
+
+<p>If the card is not detected automatically, your card reader may not have been recognized. Try unplugging it and then plugging it in again. If that doesn't work, you should still be able to import photos by <link xref="import-camera">connecting your camera directly to the computer</link>, though.</p>
+
+</page>
diff --git a/help/C/index.page b/help/C/index.page
new file mode 100644
index 0000000..9777b3f
--- /dev/null
+++ b/help/C/index.page
@@ -0,0 +1,48 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="index">
+
+ <info>
+ <title type="link">Shotwell</title>
+ <title type="text">Shotwell</title>
+ <credit type="author">
+ <name>Jim Nelson</name>
+ <email>jim@yorba.org</email>
+ <name>Allison Barlow</name>
+ <email>allison@yorba.org</email>
+ <name>Robert Ancell</name>
+ <email>robert.ancell@canonical.com</email>
+ <name>Peter Smith</name>
+ <email>pdo.smith@gmail.com</email>
+ <name>Phil Bull</name>
+ <email>philbull@gmail.com</email>
+ </credit>
+ </info>
+
+
+ <title><media type="image" src="figures/shotwell_logo.png"></media>Shotwell Photo Manager</title>
+
+ <section id="import" style="2column">
+ <title>Importing Photos</title>
+ </section>
+
+ <section id="view" style="2column">
+ <title>Viewing Photos</title>
+ </section>
+
+ <section id="organize" style="2column">
+ <title>Organizing Photos</title>
+ </section>
+
+ <section id="edit" style="2column">
+ <title>Editing Photos</title>
+ </section>
+
+ <section id="share" style="2column">
+ <title>Sharing Photos</title>
+ </section>
+
+ <section id="other" style="2column">
+ <title>Other Features</title>
+ </section>
+</page>
diff --git a/help/C/organize-event.page b/help/C/organize-event.page
new file mode 100644
index 0000000..72bf212
--- /dev/null
+++ b/help/C/organize-event.page
@@ -0,0 +1,60 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="event">
+
+ <info>
+ <link type="guide" xref="index#organize"/>
+ <desc>Group photos together that were taken at the same time. Learn how to rename, merge, and sort events.</desc>
+
+ <link type="next" xref="flag"/>
+ </info>
+
+ <title>Events</title>
+
+ <p>An event is a group of photos that were taken at approximately the same time. When you import photos, Shotwell checks when each photo was taken. It then groups the photos into events.</p>
+
+ <p>Choose <gui>Events</gui> from the sidebar to see your photos organized by date. If you select a month or year from the sidebar, a list of events will be displayed in the main window. Double-click an event to see all the photos that were taken around that time.</p>
+
+ <p>If a photo has no embedded date/time information, then Shotwell can't automatically
+ place it in any event. In this case the photo will appear in the <gui>No Event</gui>
+ view accessible from the sidebar. You can still move the photo to any event you like
+ as described below.
+ </p>
+
+ <section>
+ <title>Renaming events</title>
+
+ <p>To give an event a name rather than referring to it by its date, select the event, click <guiseq><gui>Edit</gui><gui>Rename Event</gui></guiseq> and enter a new name. Another way of renaming an event is to double-click its name in the sidebar; type a new name and then press <key>Enter</key>.</p>
+ </section>
+
+ <section>
+ <title>Moving photos between events</title>
+
+ <p>Even though photos are initially grouped into events by their date, you can move photos between events. To do this, drag any photo to the sidebar and drop it on an event.</p>
+ </section>
+
+ <section>
+ <title>Creating and merging events</title>
+ <p>To create a new event, select the photos you would like in the new event and click <guiseq><gui>Events</gui><gui>New Event</gui></guiseq>.</p>
+ <p>To merge events, select <guiseq><gui>Events</gui></guiseq> from the sidebar, then, while holding down <key>Ctrl</key> click on the events you want to merge in the main window area. Finally, click <guiseq><gui>Events</gui><gui>Merge Events</gui></guiseq>.</p>
+ </section>
+
+ <section>
+ <title>Sorting events</title>
+
+ <p>Events are displayed in a tree in the sidebar, organized by the year and month of the earliest photo in the event.
+ To change the event sort order, click <guiseq><gui>View</gui><gui>Sort Events</gui></guiseq> and select either ascending or descending.</p>
+
+ </section>
+
+ <section>
+ <title>Change the photo used to represent each event</title>
+
+ <p>If you select the Events item in the sidebar, you'll see a single photo which represents each event. This is called the key photo.</p>
+
+ <p>By default, Shotwell uses the first photo in each event as its key photo.
+ To use a different key photo, select the photo and choose <guiseq><gui>Photos</gui><gui>Make Key Photo for Event</gui></guiseq>.</p>
+
+ </section>
+
+</page>
diff --git a/help/C/organize-flag.page b/help/C/organize-flag.page
new file mode 100644
index 0000000..26b0a1d
--- /dev/null
+++ b/help/C/organize-flag.page
@@ -0,0 +1,35 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="flag">
+
+ <info>
+ <link type="guide" xref="index#organize"/>
+ <desc>Flag photos to mark them as special or to work with them as a set.</desc>
+
+ <link type="next" xref="rating"/>
+ </info>
+
+ <title>Flagging photos</title>
+
+ <p>Shotwell lets you <em>flag</em> photos. When a photo is flagged, a small flag icon
+ appears in its upper right corner. You can select the <gui>Flagged</gui> item in the sidebar to see
+ all photos which have been flagged.</p>
+
+ <p>Flagging a photo marks it as special. You can interpret this in any way you like. For example,
+ you might flag all photos which need visual
+ adjustment, or all photos which you want to share with a friend.</p>
+
+ <p>Flagging
+ is also useful because you can operate on all flagged photos as a set. For example, you can
+ select the <gui>Flagged</gui> view and then upload all flagged photos to a publishing service.</p>
+
+ <section>
+ <title>To flag or unflag a photo</title>
+ <p>
+ To flag or unflag a photo, right-click the photo and choose <gui>Flag</gui> or <gui>Unflag</gui>
+ from the context menu. Or use the <keyseq><key>Ctrl</key><key>G</key></keyseq> or <key>/</key>
+ shortcut keys.
+ </p>
+ </section>
+
+</page>
diff --git a/help/C/organize-rating.page b/help/C/organize-rating.page
new file mode 100644
index 0000000..e75abfa
--- /dev/null
+++ b/help/C/organize-rating.page
@@ -0,0 +1,30 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="rating">
+
+ <info>
+ <link type="guide" xref="index#organize"/>
+ <desc>Give photos a rating between 1 and 5 stars. You can reject bad photos, hiding them from view.</desc>
+
+ <link type="next" xref="delete"/>
+ </info>
+
+ <title>Ratings</title>
+<p>You can assign each photo a rating from 1-5 stars, or may alternatively rate it as Rejected, in which case Shotwell will hide the photo by default.</p>
+
+<p>You can rate a photo or a set of photos in any of these ways:</p>
+
+<list>
+<item><p>Select the photo(s), then choose a rating from the top-level <guiseq><gui>Photos</gui><gui>Set Rating</gui></guiseq> menu.</p></item>
+<item><p>Right-click on the photo(s), then choose a rating from the Set Rating context menu.</p></item>
+<item><p>Select the photo(s), then press any of the shortcut keys <key>1</key>, <key>2</key>, <key>3</key>, <key>4</key> or <key>5</key> to assign a rating. Or press <key>9</key> to mark the photo(s) as rejected or <key>0</key> to clear the rating(s).</p></item>
+</list>
+
+<p>
+Normally Shotwell displays all photos except rejected photos. You can set a different rating filter using the <guiseq><gui>View</gui><gui>Filter Photos</gui></guiseq> menu - for example, you can display only photos rated with 3 stars or higher, or you can display all photos including those marked rejected. The Shotwell icon on the toolbar displays the current rating filter and can also be used to set the filter.</p>
+
+<p>Shotwell normally displays each photo's rating in its lower left-hand corner. You can turn off the display of ratings using the <guiseq><gui>View</gui><gui>Ratings</gui></guiseq> menu item.</p>
+
+<p>You can increase or decrease a photo's rating using the <guiseq><gui>Set Rating</gui><gui>Increase</gui></guiseq> and <guiseq><gui>Set Rating</gui><gui>Decrease</gui></guiseq> commands, or the keyboard shortcuts <key>&lt;</key> and <key>&gt;</key>. </p>
+</page>
+
diff --git a/help/C/organize-remove.page b/help/C/organize-remove.page
new file mode 100644
index 0000000..4cfc3b6
--- /dev/null
+++ b/help/C/organize-remove.page
@@ -0,0 +1,45 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="delete">
+
+ <info>
+ <link type="guide" xref="index#organize"/>
+ <desc>Remove photos from the library, or delete them from your computer entirely.</desc>
+
+ <link type="next" xref="search"/>
+ </info>
+
+ <title>Removing and deleting photos</title>
+
+ <p>You may remove photos from your library and you may additionally delete them entirely from your hard disk.</p>
+<media type="image" src="figures/trash_process.png">Delete process</media>
+<p>This diagram shows how a photo, when deleted, is first put into Shotwell's trash. If you delete it from Shotwell's trash, it is put into your computer's trash. If you delete it from your computer's trash the photo is finally and irretrievably deleted from your computer.</p>
+<section id="delete-remove">
+ <title>Removing photos from the library</title>
+ <p>Select the photos to remove and choose <guiseq><gui>Edit</gui><gui>Move to Trash</gui></guiseq>.
+ (You can also press the <key>Delete</key> key.)
+ The photos will be moved from your library to Shotwell's Trash.</p>
+ <p>If you want to remove photos from Shotwell without having them pass through the trash, simply select the photos to be removed and choose <guiseq><gui>Edit</gui><gui>Remove From Library</gui></guiseq>. The photo files will be left in place on disk.</p>
+</section>
+
+<section id="delete-empty">
+ <title>Emptying or restoring the trash folder</title>
+ <p>Select the Trash entry in the Sidebar and Shotwell will display all photos that have been marked for removal or deletion. In the Trash view, the following commands are available:</p>
+ <terms>
+ <item><title>Delete</title><p>Delete the selected photos from the trash folder.</p></item>
+ <item><title>Restore</title><p>Restore the selected photos into Shotwell.</p></item>
+ <item><title>Empty trash</title><p>Delete all photos from the trash folder.</p></item>
+ </terms>
+</section>
+
+<section id="delete-trash">
+ <title>Deleting or emptying Trash</title>
+ <p>When you delete files from the Trash folder or empty the Trash folder, you will be given the following choices:</p>
+ <terms>
+ <item><title>Only Remove</title><p>Remove photos from the library but leave the photos in their location on the computer.</p></item>
+ <item><title>Trash file</title><p>Remove photos from the library and delete them from the computer.</p></item>
+ <item><title>Cancel</title><p>Do nothing.</p></item>
+ </terms>
+</section>
+
+</page>
diff --git a/help/C/organize-search.page b/help/C/organize-search.page
new file mode 100644
index 0000000..7f97370
--- /dev/null
+++ b/help/C/organize-search.page
@@ -0,0 +1,63 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="search">
+
+ <info>
+ <link type="guide" xref="index#organize"/>
+ <desc>Find photos and videos in your collection by a variety of criteria.</desc>
+
+ <link type="next" xref="tag"/>
+ </info>
+
+ <title>Searching</title>
+
+ <p>
+ There are two ways to search in Shotwell: the filter toolbar, and with a saved search. The search
+ bar allows you to quickly search the current view for certain criteria. Saved Searches feature
+ more complex search criteria and persist in the sidebar between sessions.
+ </p>
+
+ <section id="searchbar">
+ <title>Search bar</title>
+ <p>
+ The <guiseq><gui>View</gui><gui>Search Bar</gui></guiseq> checkbox toggles the display of the
+ search bar. You can also hit <keyseq><key>Ctrl</key><key>F</key></keyseq> or <key>F8</key> to
+ bring up the search bar. From this bar, you can find, show and hide photos and videos based on
+ title, tag, rating or other options.
+ </p>
+
+ <p>
+ To begin searching, simply enter a search keyword in the text box, or click on <gui>Flagged</gui>,
+ <gui>Rating</gui> or <gui>Type</gui>. The text search matches your keywords across tag names,
+ photo or video titles and photos' original filenames. The <gui>Flagged</gui>,
+ <gui>Rating</gui> and <gui>Type</gui> buttons allow you to filter your collection by
+ whether photos are flagged, their current number of stars, and whether the items shown are
+ images, videos, or raw camera files, respectively.
+ </p>
+
+ <p>
+ Disabling the search bar or exiting Shotwell automatically resets the search bar.
+ </p>
+ </section>
+
+ <section id="savedsearch">
+ <title>Saved search</title>
+ <p>
+ A saved search persists across Shotwell sessions, and is updated as photos and videos are added
+ and removed from your Shotwell library.
+ </p>
+
+ <p>
+ Create a new saved search with <guiseq><gui>Edit</gui><gui>New Search</gui></guiseq> or by hitting
+ <keyseq><key>Ctrl</key><key>S</key></keyseq>. The dialog box allows you to enter a name for the
+ search and select whether you want to meet Any, All, or None of the criteria in the following rows.
+ </p>
+
+ <p>
+ Each row represents a search criterion. Use the + button to add more rows, and the - button to
+ remove a specific row. The combo box on the left of each row selects the type of criteria.
+ Criteria must be entered correctly before the OK button becomes available.
+ </p>
+ </section>
+
+</page>
diff --git a/help/C/organize-tag.page b/help/C/organize-tag.page
new file mode 100644
index 0000000..86f2d0c
--- /dev/null
+++ b/help/C/organize-tag.page
@@ -0,0 +1,94 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="tag">
+
+ <info>
+ <link type="guide" xref="index#organize"/>
+ <desc>Organize photos by labelling them.</desc>
+
+ <link type="seealso" xref="event"/>
+
+ <link type="next" xref="title"/>
+ </info>
+
+ <title>Tagging photos</title>
+
+ <p>
+ You can assign one or more tags to selected photos.
+ A tag can be one or more words that you want to associate with
+ those photos.
+ </p>
+
+ <p>
+ To add new tags to photos, select the photos you would like to
+ tag, then do any of the following:
+ </p>
+
+ <list>
+ <item><p>Choose <guiseq><gui>Tags</gui><gui>Add Tags</gui></guiseq>.</p></item>
+ <item><p>Type <keyseq><key>Ctrl</key><key>T</key></keyseq>.</p></item>
+ <item><p>Drag the selected photos and drop them on the desired tag.</p></item>
+ </list>
+
+ <p>
+ When you use <keyseq><key>Ctrl</key><key>T</key></keyseq> or
+ <guiseq><gui>Tags</gui><gui>Add Tags</gui></guiseq> you can type
+ in the names of one or more tags, separated by commas.
+ Once you have created a tag, you can rename it by selecting that
+ tag in the sidebar and choosing
+ <guiseq><gui>Tags</gui><gui>Rename Tag "[name]"</gui></guiseq>,
+ by rightclicking on it and choose <gui>Rename...</gui> or
+ double-click on the tag in the sidebar.
+ </p>
+
+ <p>
+ To change which tags are associated with a particular photo,
+ select that photo, choose
+ <guiseq><gui>Tags</gui><gui>Modify Tags</gui></guiseq> or
+ right-click on a photo and select <gui>Modify Tags</gui> and
+ edit the comma separated list.
+ To remove a tag from one or more photos, first select that tag
+ in the sidebar, then select the photos you would like to remove,
+ and choose
+ <guiseq><gui>Tags</gui><gui>Remove Tag "[name]" from Photos</gui></guiseq>
+ or right-click on the photos an select
+ <gui>Remove Tag "[name]" from Photos</gui>.
+ </p>
+
+ <p>
+ To delete a tag entirely, select that tag in the sidebar and choose
+ <guiseq><gui>Tags</gui><gui>Delete Tag "[name]"</gui></guiseq>
+ or by right-click and select <gui>Delete Tag "[name]"</gui>.
+ </p>
+
+ <p>
+ When you create a tag, it will appear in the sidebar under the
+ Tags item, which is hidden if there are no tags. Photos can have
+ multiple tags attached to them, and when you click on the name
+ of a given tag in the sidebar, you will see all the photos
+ associated with that tag.
+ </p>
+
+ <section id="hierarchaicaltags">
+ <title>Hierarchical Tags</title>
+ <p>
+ Shotwell supports also hierarchial tags. You can
+ rearrange your tags by drag and drop a tag onto another.
+ To create a new subtag right-click on a tag and select
+ <gui>New</gui>.
+ </p>
+
+ <p>
+ Hierarchial tags can help you to sort your tag list in
+ ways that better match how you work or think; for example,
+ you can store location tags like "Mountains" or "Beach"
+ under a parent tag "Places", which itself can be placed
+ under the tag "Summer Holidays".
+ </p>
+
+ <p>
+ Note that deleting a parent tag will also delete its
+ child tags.
+ </p>
+ </section>
+</page>
diff --git a/help/C/organize-title.page b/help/C/organize-title.page
new file mode 100644
index 0000000..1bc1790
--- /dev/null
+++ b/help/C/organize-title.page
@@ -0,0 +1,20 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="title">
+
+ <info>
+ <link type="guide" xref="index#organize"/>
+ <desc>Give titles to your photos.</desc>
+
+ <link type="next" xref="event" />
+ </info>
+
+ <title>Titles</title>
+
+<p>The <guiseq><gui>View</gui><gui>Titles</gui></guiseq> checkbox toggles the display of titles
+beneath each photo. By default, a photo's title is its filename.</p>
+
+<p>To change a photo's title,
+select the photo and click <guiseq><gui>Photos</gui><gui>Edit Title</gui></guiseq>, or press <key>F2</key>.</p>
+
+</page>
diff --git a/help/C/other-files.page b/help/C/other-files.page
new file mode 100644
index 0000000..20bb9f8
--- /dev/null
+++ b/help/C/other-files.page
@@ -0,0 +1,146 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="other-files">
+
+ <info>
+ <link type="guide" xref="index#other"/>
+ <desc>Keep the Shotwell library in sync with photo files on disk.</desc>
+
+ <link type="next" xref="other-plugins"/>
+ </info>
+
+ <title>Photo files</title>
+
+ <p>
+ Every photo in the Shotwell library corresponds to a file stored on your hard disk. Shotwell has
+ several features which help you keep the Shotwell library and files on disk in sync.
+ </p>
+ <links type="section" />
+
+ <section id="dirpattern">
+ <title>Using a custom directory pattern</title>
+ <p>
+ Shotwell allows you to specify how it names directories in your library. You can do this
+ by changing the <gui>Directory Structure</gui> and <gui>Pattern</gui> settings in the
+ <gui>Preferences</gui> dialog. You may use a preselected pattern, or choose <gui>Custom</gui>
+ and type in your own.
+ </p>
+
+ <p>
+ The available symbols for the directory pattern begin with a % (percent sign). The values
+ these symbols produce are locale-dependent, so what you see on your computer may vary
+ from the examples below.
+ </p>
+
+ <table frame="all" rules="rowgroups">
+ <tbody>
+ <tr>
+ <td><p> </p></td> <td><p><em>Symbol</em></p></td> <td><p><em>Meaning</em></p></td> <td><p><em>Example</em></p></td>
+ </tr>
+ </tbody>
+ <tbody>
+ <tr>
+ <td><p> </p></td><td><p> %Y </p></td><td><p> Year: full </p></td><td><p> 2011 </p></td>
+ </tr>
+ <tr>
+ <td><p> </p></td><td><p> %y </p></td><td><p> Year: two digit </p></td><td><p> 11 </p></td>
+ </tr>
+ <tr>
+ <td><p> </p></td><td><p> %d </p></td><td><p> Day of the month with leading zero </p></td><td><p> 03 </p></td>
+ </tr>
+ <tr>
+ <td><p> </p></td><td><p> %A </p></td><td><p> Day name: full </p></td><td><p> Wednesday </p></td>
+ </tr>
+ <tr>
+ <td><p> </p></td><td><p> %a </p></td><td><p> Day name: abbreviated </p></td><td><p> Wed </p></td>
+ </tr>
+ <tr>
+ <td><p> </p></td><td><p> %m </p></td><td><p> Month number with leading zero </p></td><td><p> 02 </p></td>
+ </tr>
+ <tr><td><p> </p></td><td><p> %b </p></td><td><p> Month name: abbreviated </p></td><td><p> Feb
+
+ </p></td></tr><tr><td><p> </p></td><td><p> %B </p></td><td><p> Month name: full </p></td><td><p> February
+ </p></td></tr><tr><td><p> </p></td><td><p> %I </p></td><td><p> Hour: 12 hour format </p></td><td><p> 05
+ </p></td></tr><tr><td><p> </p></td><td><p> %H </p></td><td><p> Hour: 24 hour format </p></td><td><p> 17
+
+ </p></td></tr><tr><td><p> </p></td><td><p> %M </p></td><td><p> Minute </p></td><td><p> 16
+ </p></td></tr><tr><td><p> </p></td><td><p> %S </p></td><td><p> Second </p></td><td><p> 30
+ </p></td></tr><tr><td><p> </p></td><td><p> %p </p></td><td><p> AM or PM </p></td><td><p> PM </p></td></tr>
+ </tbody>
+ </table>
+
+ <p>
+ There are other symbols available; please check the manual for strftime by running
+ the command <cmd>man strftime</cmd> if you need one that isn't listed here.
+ </p>
+ </section>
+
+ <section id="automatic-import">
+ <title>Automatically importing photos</title>
+
+ <p>Shotwell can automatically import new photos which appear in the library directory.
+ (The library directory is usually the <file>Pictures</file> directory in your home directory;
+ you can change its location in in the <gui>Preferences</gui> window.)
+ </p>
+
+ <p>To enable auto-import,
+ check the box <gui>Watch library directory for new files</gui> in
+ the <gui>Preferences</gui> window.</p>
+
+ <note style="advanced"><p>Shotwell can also follow symbolic links inside automatically-imported directories.</p></note>
+
+ </section>
+
+ <section id="automatic-rename">
+ <title>Automatically renaming imported photos to lowercase</title>
+
+ <p>
+ Shotwell can automatically change the filenames of imported photos
+ to lowercase. To enable this, choose <guiseq><gui>Edit</gui><gui>Preferences</gui></guiseq>,
+ and in the <gui>Preferences</gui> window, check the <gui>Rename imported files to lowercase</gui>
+ box.
+ </p>
+
+ </section>
+
+ <section id="writing-metadata">
+ <title>Writing metadata on the fly</title>
+
+ <p>By default, Shotwell does not modify photo files, even when you edit photos or change their
+ tags or titles. Shotwell records these changes in its own database only.</p>
+
+ <p>To change this behavior, you can enable the checkbox
+ <gui>Write tags, titles and other metadata to photo files</gui>
+ in the <gui>Preferences</gui> dialog. When this option is enabled, Shotwell will write
+ the following metadata to most photo files whenever you change it in Shotwell:</p>
+
+ <list>
+ <item><p>titles</p></item>
+ <item><p>tags</p></item>
+ <item><p>ratings</p></item>
+ <item><p>rotation information</p></item>
+ <item><p>time/date</p></item>
+ </list>
+
+ <p>Shotwell stores this information in photo files in EXIF, IPTC and/or XMP format. Note
+ that Shotwell can write only to photo files in JPEG, PNG and TIFF format, not to BMP photos, RAW photos
+ or to video files.
+ </p>
+
+ </section>
+
+ <section id="runtime-monitoring">
+ <title>Runtime monitoring</title>
+
+ <p>While Shotwell is running, it notices changes made to any photo file externally.
+ When a photo file changes, Shotwell rereads the file and updates your view of the
+ photo and metadata.</p>
+
+ <p>Note that Shotwell checks all photo files for changes at startup, but only photo files contained in
+ the library directory are monitored in real time after startup. We hope to remove this limitation
+ in a further release.</p>
+
+ </section>
+
+</page>
+
diff --git a/help/C/other-missing.page b/help/C/other-missing.page
new file mode 100644
index 0000000..535070d
--- /dev/null
+++ b/help/C/other-missing.page
@@ -0,0 +1,23 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="other-missing">
+
+ <info>
+ <link type="guide" xref="index#other"/>
+ <desc>If Shotwell can't find a photo in your library, it marks it as missing.</desc>
+
+ <link type="next" xref="other-multiple"/>
+ </info>
+
+ <title>Missing photos</title>
+
+<p>Each time Shotwell starts up, it scans your photo library to verify that all photo files still exist on your hard drive. If Shotwell finds that any photo files are missing, it will not display them in the normal Photos, Events and Tags views, but will instead show them in a separate Missing Files view which will appear in the sidebar.</p>
+
+<p>If you no longer want the missing files to be part of your Shotwell collection (perhaps because you deleted them), go to the Missing Files view, select the photos and then click <gui>Remove From Library</gui>.</p>
+
+<p>If you have photos on a removable disk, such as a CD or USB flash drive, and <link xref="index#import">import</link> them into Shotwell <em>without</em> copying the photos to your computer, they will show up as missing files if you then disconnect the removable disk. See <link xref="import-file"/> to learn how to copy files from removable disks onto your computer.</p>
+
+<p>If any missing photo files become available again, Shotwell will notice this the next time it starts. The photos will once again appear in the Photos, Events and Tags views.</p>
+
+</page>
+
diff --git a/help/C/other-multiple.page b/help/C/other-multiple.page
new file mode 100644
index 0000000..1082ae9
--- /dev/null
+++ b/help/C/other-multiple.page
@@ -0,0 +1,23 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="other-multiple">
+
+ <info>
+ <link type="guide" xref="index#other"/>
+ <desc>You can open Shotwell with a different photo library by using the command line.</desc>
+
+ <link type="next" xref="other-files"/>
+ </info>
+
+ <title>Multiple libraries</title>
+
+<p>Shotwell normally stores its database and photo thumbnails in the directory <file>~/.shotwell</file> . This directory does not hold photos, but the database in this directory contains a list of all the photos in the Shotwell library.</p>
+
+<p>As an advanced feature, it's possible for you to have multiple Shotwell libraries, each of which has its own set of photos. Each library needs its own database directory. To launch Shotwell with an alternate library, specify an alternate database directory on the command line as follows:</p>
+
+<screen>
+shotwell -d [library-directory]
+</screen>
+
+</page>
+
diff --git a/help/C/other-plugins.page b/help/C/other-plugins.page
new file mode 100644
index 0000000..4381892
--- /dev/null
+++ b/help/C/other-plugins.page
@@ -0,0 +1,29 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="other-plugins">
+
+ <info>
+ <link type="guide" xref="index#other"/>
+ <desc>Extend Shotwell's functionality dynamically.</desc>
+
+ <link type="next" xref="other-missing"/>
+ </info>
+
+ <title>Plugins</title>
+ <p>
+ Shotwell can be used with <em>plugins</em>, which are companion shared libraries that can
+ add support for new publishing destinations or new slideshow transitions.
+ </p>
+
+ <p>
+ To see a list of installed plugins, choose <guiseq><gui>Edit</gui><gui>Preferences</gui></guiseq>,
+ and in the <gui>Preferences</gui> window, click on the <gui>Plugins</gui> tab. You'll see a list
+ of currently-installed plugins, each with a checkbox by it, and you may enable or disable each by
+ selecting or deselecting the checkbox by its name.
+ </p>
+
+ <note style="advanced"><p>Full documentation on how to develop new plugins is available at
+ <link href="http://redmine.yorba.org/projects/shotwell/wiki/ShotwellArchWritingPlugins">http://redmine.yorba.org/projects/shotwell/wiki/ShotwellArchWritingPlugins</link></p></note>
+
+</page>
+
diff --git a/help/C/raw.page b/help/C/raw.page
new file mode 100644
index 0000000..553f83b
--- /dev/null
+++ b/help/C/raw.page
@@ -0,0 +1,46 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="other-raw">
+
+ <info>
+ <link type="guide" xref="index#other"/>
+ <desc>More about RAW support in Shotwell.</desc>
+
+ <link type="next" xref="running" />
+ </info>
+
+ <title>RAW support in Shotwell</title>
+ <p>Some cameras have the ability to store data directly off the sensor
+ and into a file that contains extra color information; this is commonly
+ referred to as 'RAW' or 'camera RAW', and Shotwell supports these files
+ as well.</p>
+
+ <p>Since RAW photographs normally cannot be displayed directly, but must
+ be first developed - that is, have their extra information interpreted and
+ readied for displaying - most cameras will either embed a JPEG inside a
+ RAW-format file, or produce a JPEG alongside the RAW file at the time the
+ snapshot is taken. The latter is referred to throughout this document as
+ RAW+JPEG. If you import a RAW+JPEG pair, Shotwell will
+ keep them paired and treat them as one item in your library.
+ </p>
+
+ <p>When you import a RAW file, you can choose to either use the camera's
+ internally-developed JPEG or Shotwell's by selecting
+ <guiseq><gui>Photos</gui><gui>Developer</gui></guiseq> in the menus.
+ </p>
+
+ <note>
+ <p>
+ Changing between developers will cause all edits made to a photograph
+ to be discarded.
+ </p>
+ </note>
+
+ <p>
+ In order to publish or use a RAW photograph in most other software, it has to be
+ exported first. Shotwell can export your RAW photos in JPEG, PNG, TIFF
+ or BMP format, and, when publishing, will internally export a JPEG version
+ for you and publish that.
+ </p>
+
+</page>
diff --git a/help/C/running.page b/help/C/running.page
new file mode 100644
index 0000000..7f9f59c
--- /dev/null
+++ b/help/C/running.page
@@ -0,0 +1,29 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="running">
+
+ <info>
+ <link type="guide" xref="index"/>
+ <desc>Find Shotwell in the Applications menu, or have it start automatically when you plug in a camera.</desc>
+
+ <link type="seealso" xref="other-multiple" />
+
+ <link type="next" xref="formats" />
+ </info>
+
+ <title>Running Shotwell</title>
+
+<p>Once installed, Shotwell is available in your <gui>Applications</gui> menu under <gui>Graphics</gui> or <gui>Photography</gui>.</p>
+
+<p>Shotwell may also be executed automatically when a camera is plugged in to your computer. To check
+that your system is set up to run Shotwell when a camera is detected, go to
+<guiseq><gui>Edit</gui><gui>Preferences</gui></guiseq> in any
+Nautilus (file browser) window and choose the <gui>Media</gui> tab.  You'll see a dropdown box
+entitled <gui>Photos:</gui> which lets you choose Shotwell as your photo handling application.</p>
+
+<note style="advanced">
+ <p>Shotwell may also be executed directly from its build directory, although this is only recommended for testing out Shotwell or for developers.</p>
+</note>
+
+</page>
+
diff --git a/help/C/share-background.page b/help/C/share-background.page
new file mode 100644
index 0000000..9dff407
--- /dev/null
+++ b/help/C/share-background.page
@@ -0,0 +1,23 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="share-background">
+
+ <info>
+ <link type="guide" xref="index#share"/>
+ <desc>Set your desktop background to a single photo or to a slideshow of photos.</desc>
+
+ <link type="next" xref="share-slideshow" />
+ </info>
+
+ <title>Set a desktop background or slideshow</title>
+
+ <p>To set a single photo as your desktop background, select the photo and choose <guiseq><gui>File</gui><gui>Set as Desktop Background</gui></guiseq>.</p>
+
+ <p>You can also set your background to a slideshow of photos. To do this, select the photos for
+ the slideshow and choose <guiseq><gui>File</gui><gui>Set as Desktop Slideshow</gui></guiseq>.
+ Shotwell will prompt you for a slideshow delay, which can be any interval up to one day in length.
+ The background slideshow will proceed even when Shotwell is not running.
+ </p>
+
+</page>
+
diff --git a/help/C/share-export.page b/help/C/share-export.page
new file mode 100644
index 0000000..65a5f83
--- /dev/null
+++ b/help/C/share-export.page
@@ -0,0 +1,45 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="share-export">
+
+ <info>
+ <link type="guide" xref="index#share"/>
+ <desc>Copy photos out of Shotwell so you can put them somewhere else.</desc>
+
+ <link type="next" xref="share-print" />
+ </info>
+
+ <title>Exporting photos</title>
+
+<p>To export photos from Shotwell via drag and drop, drag the photos from Shotwell onto
+a file manager window or your desktop. The new files will be full-sized copies of
+the photos in your library.</p>
+
+<p>
+Alternatively, select a set of photos and choose the <guiseq><gui>File</gui><gui>Export</gui></guiseq> command or press <keyseq><key>Shift</key><key>Ctrl</key><key>E</key></keyseq>, which exports photos while letting you fine-tune the size and dimensions of your photo files.
+A window will appear allowing you to make several choices:
+</p>
+
+<list>
+<item><p>A format for export.
+</p>
+<list>
+<item><p>Choose <gui>Unmodified</gui> to export photos in their original format without
+any edits made in Shotwell. RAW photos will be exported in their original RAW format.</p></item>
+<item><p>Choose <gui>Current</gui> to export photos including edits made in Shotwell. RAW photos will be
+exported in JPEG format if you have edited them in Shotwell, and otherwise in their original RAW format.</p></item>
+<item><p>
+Or you can choose a particular image format (JPEG, PNG, TIFF, BMP) to be used for exporting. Any edits made in
+Shotwell will be included, and Shotwell will convert photos to the destination format.
+</p></item>
+</list>
+</item>
+<item><p>The image quality for exporting (Low, Medium, High, or Maximum).</p></item>
+<item><p>A scaling constraint (which means how Shotwell will decide to scale the photos down), and the desired pixel size.</p></item>
+<item><p>The option whether you like to export metadatas such as tags or ratings. This can help to save your privacy if you have geolocation tags or tags which shouldn't be seen by anyone.</p></item>
+</list>
+
+<p>If selected, Shotwell will write tags, titles, and other metadata to the new files.</p>
+
+</page>
+
diff --git a/help/C/share-print.page b/help/C/share-print.page
new file mode 100644
index 0000000..7af4799
--- /dev/null
+++ b/help/C/share-print.page
@@ -0,0 +1,24 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="share-print">
+
+ <info>
+ <link type="guide" xref="index#share"/>
+ <desc>Click <guiseq><gui>File</gui><gui>Print</gui></guiseq>. For more printing options, select the <gui>Page Setup</gui> tab in the <gui>Print</gui> dialog.</desc>
+
+ <link type="next" xref="share-upload" />
+ </info>
+
+ <title>Printing</title>
+
+ <p>To print a photo, select it and choose <guiseq><gui>File</gui><gui>Print</gui></guiseq>.</p>
+
+ <p>
+ Shotwell can also print multiple images in one page; to do this, select multiple images,
+ choose <guiseq><gui>File</gui><gui>Print</gui></guiseq>, and in the <gui>Print</gui> dialog,
+ choose the <gui>Image Settings</gui> tab. In <gui>Image Settings</gui>, choose one of the
+ multiple-image-per-page options under <gui>Autosize</gui>.
+ </p>
+
+ <p>If you would like to set formatting, paper size, and orientation options, choose the <gui>Page Setup</gui> tab in the <gui>Print</gui> dialog prior to printing.</p>
+</page>
diff --git a/help/C/share-send.page b/help/C/share-send.page
new file mode 100644
index 0000000..d788f6c
--- /dev/null
+++ b/help/C/share-send.page
@@ -0,0 +1,25 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="share-send">
+
+ <info>
+ <link type="guide" xref="index#share"/>
+ <desc>Send photos via email, instant messaging or in other ways.</desc>
+
+ <link type="next" xref="share-background" />
+ </info>
+
+ <title>Sending photos</title>
+
+ <p>Shotwell can send photos using the GNOME desktop's Send To mechanism, which
+ lets you send photos via email, instant messaging or in other ways.</p>
+ <p>To send photos, select them in Shotwell and choose
+ <guiseq><gui>File</gui><gui>Send To...</gui></guiseq>,
+ or right-click the photos and choose <gui>Send To...</gui> from the context menu.
+ A <gui>Send To</gui> dialog box will appear which lets you choose a mechanism for
+ sending the files (such as email or instant messaging) and a destination. You can
+ optionally choose to send the files in a compressed format.
+ </p>
+
+</page>
+
diff --git a/help/C/share-slideshow.page b/help/C/share-slideshow.page
new file mode 100644
index 0000000..41f131a
--- /dev/null
+++ b/help/C/share-slideshow.page
@@ -0,0 +1,23 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="share-slideshow">
+
+ <info>
+ <link type="guide" xref="index#share"/>
+ <desc>Watch a slideshow of your photos.</desc>
+
+ <link type="next" xref="share-export" />
+ </info>
+
+ <title>Slideshows</title>
+
+ <p>To see a sideshow of any collection in Shotwell, navigate to that collection and select <guiseq><gui>View</gui><gui>Slideshow</gui></guiseq> or press <key>F5</key>.</p>
+
+ <p>You can change some settings in a running slideshow:</p>
+
+ <list>
+ <item><p>The duration how long an image should be shown: 1 - 30 seconds</p></item>
+ <item><p>You can select different transition effects.</p></item>
+ <item><p>The time for each transition effect: 0.1 - 1.0 seconds</p></item>
+ </list>
+</page>
diff --git a/help/C/share-upload.page b/help/C/share-upload.page
new file mode 100644
index 0000000..71bc93a
--- /dev/null
+++ b/help/C/share-upload.page
@@ -0,0 +1,38 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="share-upload">
+
+ <info>
+ <link type="guide" xref="index#share"/>
+ <desc>Publish photos to Facebook, Flickr, Picasa Web Albums, or other sites.</desc>
+
+ <link type="next" xref="share-send" />
+ </info>
+
+ <title>Publishing to the Web</title>
+
+ <p>Through the use of <link xref="other-plugins">plugins</link>, Shotwell can publish photos
+ and videos to the following services, each of which requires an account:</p>
+
+ <list>
+ <item><p><link href="http://facebook.com">Facebook</link></p></item>
+ <item><p><link href="http://flickr.com">Flickr</link></p></item>
+ <item><p><link href="http://picasaweb.google.com">Picasa Web Albums</link> and <link href="http://plus.google.com">Google+</link></p></item>
+ <item><p><link href="http://youtube.com">YouTube</link> (videos only)</p></item>
+ <item><p><link href="http://fotki.yandex.ru">Yandex.Fotki</link>, a photo site popular in Russia (photos only)</p></item>
+ <item><p>Any site running the <link href="http://piwigo.org">Piwigo</link> photo gallery software (photos only)</p></item>
+ </list>
+
+ <p>To publish selected photos in a collection, choose <guiseq><gui>Edit</gui><gui>Preferences</gui></guiseq> and
+ click on the <gui>Plugins</gui> tab to enable the plugin for the service you want to publish to. Next, choose,
+ <guiseq><gui>File</gui><gui>Publish</gui></guiseq>, press the <gui>Publish</gui> toolbar button or use <keyseq><key>Ctrl</key><key>P</key></keyseq>.
+ You will see a dialog that lets you select a publishing service. You will then need to log in or create an account.</p>
+
+ <p>Publishing to Facebook requires you to grant certain permissions to the Shotwell Connect Facebook application.
+ You only need to grant these permissions once, when you first associate Shotwell Connect with your Facebook account.
+</p>
+
+ <p>Similarly, publishing to Flickr requires you to log in and permit Shotwell Connect to access your account.</p>
+
+ <p>If you have a Google account, but have not yet used Picasa Web Albums, you will need to log in to Picasa using a browser once before you can publish to this service.</p>
+</page>
diff --git a/help/C/view-displaying.page b/help/C/view-displaying.page
new file mode 100644
index 0000000..7833e03
--- /dev/null
+++ b/help/C/view-displaying.page
@@ -0,0 +1,28 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="view-view">
+
+ <info>
+ <link type="guide" xref="index#view"/>
+ <desc>Learn about different ways of viewing your photos: in a grid, filling the main window, or filling the whole screen.</desc>
+
+ <link type="next" xref="view-sidebar"/>
+ </info>
+
+ <title>Photo views</title>
+
+<p>When you select any collection in the sidebar, Shotwell displays all photos in the collection in the main window area. At the bottom right is a slider which adjusts the viewing size of the thumbnails. You may also adjust the thumbnail size using the plus and minus keys (<key>+</key> and <key>-</key>) or by pressing <key>Ctrl</key> while moving your mouse scroll wheel.</p>
+
+<p>You can view a photo full-window by double-clicking on it. From there you may move to other photos in the collection with the Back and Forward buttons. To return to the collection, double-click on the photo or press <key>Esc</key>.</p>
+
+<p>When viewing a photo in full-window mode, the slider on the toolbar controls zoom. You can pan around by grabbing and dragging anywhere on the photo. You can also zoom using your scroll wheel or by pressing the following keyboard shortcuts: <keyseq><key>Ctrl</key>0</keyseq> for the full image, <keyseq><key>Ctrl</key>1</keyseq> for 100% (1 photo pixel = 1 screen pixel), and <keyseq><key>Ctrl</key>2</keyseq> for 200% (1 photo pixel = 2x2 screen pixels).</p>
+
+<p>Shotwell offers a fullscreen mode to display photos. Choose <guiseq><gui>View</gui><gui>Fullscreen</gui></guiseq> or press <key>F11</key>. To see the fullscreen toolbar, move your mouse to the bottom of the screen. The toolbar offers buttons to move through the collection, to pin the toolbar down (so it isn't hidden when you move the mouse away), and to leave fullscreen view.</p>
+
+<section>
+<title>Viewing videos</title>
+<p>When you double-click a video, Shotwell will launch an external video player to play the video. It's not currently
+possible to display a video in full-window mode in Shotwell or to play the video within Shotwell itself.</p>
+</section>
+
+</page>
diff --git a/help/C/view-information.page b/help/C/view-information.page
new file mode 100644
index 0000000..c62f27e
--- /dev/null
+++ b/help/C/view-information.page
@@ -0,0 +1,19 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="view-information">
+
+ <info>
+ <link type="guide" xref="index#view"/>
+ <desc>View more detailed information about photos, like the exposure mode used by the camera.</desc>
+
+ <link type="next" xref="view-view"/>
+ </info>
+
+ <title>Basic and extended information</title>
+
+<p>The Basic Information pane appears at the bottom of the sidebar, and displays a brief summary of the photos you've selected. If no photos are selected, it displays a summary of the entire collection. You can toggle the display of this pane using the <guiseq><gui>View</gui><gui>Basic Information</gui></guiseq> command.</p>
+
+<p>The floating Extended Information window displays more information about the selected photo. The <guiseq><gui>View</gui><gui>Extended Information</gui></guiseq> command or <keyseq><key>Ctrl</key><key>Shift</key><key>X</key></keyseq> toggles the display of this window.</p>
+
+</page>
+
diff --git a/help/C/view-sidebar.page b/help/C/view-sidebar.page
new file mode 100644
index 0000000..2da4674
--- /dev/null
+++ b/help/C/view-sidebar.page
@@ -0,0 +1,36 @@
+<page xmlns="http://projectmallard.org/1.0/"
+ type="guide"
+ id="view-sidebar">
+
+ <info>
+ <link type="guide" xref="index#view"/>
+ <desc>The sidebar on the left of the window lists various views of your library.</desc>
+
+ <link type="seealso" xref="event"/>
+ <link type="seealso" xref="tag"/>
+ <link type="seealso" xref="flag"/>
+ <link type="seealso" xref="search#savedsearch"/>
+ <link type="seealso" xref="import-file"/>
+ <link type="seealso" xref="import-f-spot"/>
+ <link type="seealso" xref="import-memorycard"/>
+ <link type="seealso" xref="import-camera"/>
+
+ <link type="next" xref="view-information"/>
+ </info>
+
+ <title>The sidebar</title>
+
+<p>The sidebar on the left side of the Shotwell window lists various views of your library. Although you may see the same photo in multiple views, it's only stored once on your hard drive.</p>
+
+<p>The <gui>Last Import</gui> view lists your last imported photos no matter if they are imported from F-Spot, your camera, a memory card or the hard disk.</p>
+
+<p>The <gui>Flagged</gui> lists all photos you had previous flagged.</p>
+
+<p>The <gui>Saved Search</gui> allows you to sort your library by many criteria.</p>
+
+<p>The <gui>Events</gui> folder lists all events in your library. An event is a group of photos that were taken at approximately the same time.</p>
+
+<p>The <gui>Tags</gui> folder lists all tags you've assigned to photos. Photos can have multiple tags attached to them. When you click on the name of a tag in the sidebar, you will see all the photos associated with that tag.</p>
+
+</page>
+