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, no 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 » Pictures » 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 | |
---|
16 | Congratulations! You have successfuly 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>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 extenstion 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, what you want...) are |
---|
82 | by default represented by an icon corresponding to the filename |
---|
83 | extension. Optionaly, you can associate a thumbnail and a representative |
---|
84 | file (see video.avi in the example above).</li> |
---|
85 | |
---|
86 | <li><em>Warning</em>: the name of directories and files must contain only letters, figures, "-", "_" or ".". No blank space, no accentuated characters.</li> |
---|
87 | |
---|
88 | <li>Once files, thumbnails and representatives are correctly placed in the |
---|
89 | directories, go to : <span class="pwgScreen">Administration » Categories » |
---|
90 | Synchronize</span></li> |
---|
91 | |
---|
92 | </ul> |
---|
93 | </fieldset> |
---|
94 | |
---|
95 | <fieldset> |
---|
96 | <legend>Thumbnails</legend> |
---|
97 | <ul> |
---|
98 | |
---|
99 | <li>Each photo must have its thumbnail.</li> |
---|
100 | |
---|
101 | <li>Thumbnails are stored in the sub-directory "thumbnail" of the category |
---|
102 | directory. The thumbnail has the same filename as the corresponding photo, with <em>TN-</em> as prefix.</li> |
---|
103 | |
---|
104 | <li><em>Advise</em>: use an external module for thumbnails creation.</li> |
---|
105 | |
---|
106 | <li>Even if it is not recommended (image quality, web server resource load), you can use <span |
---|
107 | class="pwgScreen">Administration » Pictures » Thumbnails</span> page to create thumbnails.</li> |
---|
108 | |
---|
109 | <li>Give write access on all category directories.</li> |
---|
110 | |
---|
111 | </ul> |
---|
112 | </fieldset> |
---|