/usr/share/help/C/shotwell/other-files.page is in shotwell-common 0.28.2-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 | <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 <link href="man:strftime">manual for strftime</link> 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>
|