diff options
Diffstat (limited to 'help/C/other-files.page')
| -rw-r--r-- | help/C/other-files.page | 146 |
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> + |