Imported Upstream version 0.18.1upstream/0.18.1

1 files changed, 146 insertions, 0 deletions

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>
+