source: trunk/language/en_UK/help/photos_add_ftp.html @ 5369

Last change on this file since 5369 was 5369, checked in by tosca, 14 years ago

Have taken advantage of the 2.1 version to review every EN and FR languages files since 4859/4860 revisions (last commit on languages files by tosca).
Fixed typos and languages mistakes, and made EN and FR files consistent with one another.

Older languages files (prior to 4859 revision) still to be reviewed.

  • Property svn:eol-style set to LF
File size: 4.2 KB
Line 
1<fieldset>
2  <legend>Quick Start</legend>
3
4<ol>
5  <li>Create a directory on your computer.</li> 
6
7  <li>Copy some photos inside this directory, resize them for web display. <em>Warning</em>: the name of directories and files must contain only letters, figures, "-", "_" or ".". No blank space, nor accentuated characters.</li>
8
9  <li>With a FTP client, copy your directory in the "galleries" directory of your Piwigo installation.</li>
10
11  <li>Logon your gallery and go to <span class="pwgScreen">Administration &raquo; Pictures &raquo; Thumbnails</span> to create missing thumbnails.</li>
12
13  <li>Go to <span class="pwgScreen">Administration</span> and click on the big Synchronization button.</li>
14</ol>
15
16Congratulations! You have successfully created the first category of your photo gallery.
17</fieldset>
18
19<fieldset>
20  <legend>Directories and files organization</legend>
21
22<ul>
23
24  <li>
25
26    <p>Category directories are in the Piwigo directory
27    "galleries". Here follows the directory tree of a very small gallery (but
28    using many features):</p>
29
30    <pre>
31.
32|-- admin
33|-- doc
34|-- galleries
35|   |-- category-1
36|   |   |-- category-1.1
37|   |   |   |-- category-1.1.1
38|   |   |   |   |-- category-1.1.1.1
39|   |   |   |   |   |-- pwg_high
40|   |   |   |   |   |   +-- wedding.jpg
41|   |   |   |   |   |-- thumbnail
42|   |   |   |   |   |   +-- TN-wedding.jpg
43|   |   |   |   |   +-- wedding.jpg
44|   |   |   |   +-- category-1.1.1.2
45|   |   |   +-- category-1.1.2
46|   |   |-- category-1.2
47|   |   |   |-- pookie.jpg
48|   |   |   +-- thumbnail
49|   |   |       +-- TN-pookie.jpg
50|   |   +-- category-1.3
51|   +-- category-2
52|       |-- piglet.gif
53|       |-- pwg_representative
54|       |   +-- video.jpg
55|       |-- thumbnail
56|       |   +-- TN-piglet.jpg
57|       +-- video.avi
58|-- include
59|-- install
60|-- language
61|-- template
62+-- tool</pre>
63
64  </li>
65
66  <li>Except for those named "thumbnail", "pwg-high" or "pwg_representative" (see explanations below), each directory under "galleries" produces a category. There is no limit on deepness.</li>
67
68  <li>Basically, an element is represented by a file. A file can be a
69  Piwigo element if its extension is among <code>file_ext</code>
70  configuration parameter possibilities (see <span
71  class="filename">include/config_default.inc.php</span> file). A file can
72  be a picture if its extension is among <code>picture_ext</code>
73  configuration parameter possibilities.</li>
74
75  <li>Picture elements must have an associated thumbnail (see section below
76  about thumbnails)</li>
77
78  <li>Picture elements can have a high quality file associated. As for
79  wedding.jpg in the example above. No prefix on the high quality picture.</li>
80
81  <li>Non picture elements (video, sounds, file texts, whatever you want...) are represented by default by an icon corresponding to the filename
82  extension. Optionally, you can associate a thumbnail and a representative
83  file (see video.avi in the example above).</li>
84
85  <li><em>Warning</em>: the name of directories and files must contain only letters, figures, "-", "_" or ".". No blank space, nor accentuated characters.</li>
86
87  <li>Once files, thumbnails and representatives are correctly placed in the
88  directories, go to: <span class="pwgScreen">Administration &raquo; Categories &raquo;
89  Synchronize</span></li>
90
91</ul>
92</fieldset>
93
94<fieldset>
95  <legend>Thumbnails</legend>
96<ul>
97
98  <li>Each photo must have its thumbnail.</li>
99
100  <li>Thumbnails are stored in the "thumbnail" sub-directory of the category
101  directory. The thumbnail has the same filename as the corresponding photo, with configuration parameter <code>prefix_thumbnail</code> as prefix (see <span class="filename">include/config.inc.php</span>).</li>
102
103  <li>Thumbnails files have not necessary the same extension as the associated image (eg a ".jpg" image may have a ".GIF" extension).</li>
104
105  <li>It is recommended to use an external module for thumbnails creation.</li>
106
107  <li>The usage of the thumbnails creation tool integrated in Piwigo is not advisable, because the resulting quality might be disappointing and this will lie heavily on the server ressources (and that could be a serious problem on a shared server).
108
109  <li>If you choose to use the webserver to generate thumbnails, you must allow write access on all category directories.</li>
110
111</ul>
112</fieldset>
Note: See TracBrowser for help on using the repository browser.