aboutsummaryrefslogtreecommitdiffstats
path: root/language/en_UK/help/photos_add_ftp.html
diff options
context:
space:
mode:
Diffstat (limited to 'language/en_UK/help/photos_add_ftp.html')
-rw-r--r--language/en_UK/help/photos_add_ftp.html112
1 files changed, 112 insertions, 0 deletions
diff --git a/language/en_UK/help/photos_add_ftp.html b/language/en_UK/help/photos_add_ftp.html
new file mode 100644
index 000000000..5bb2c552c
--- /dev/null
+++ b/language/en_UK/help/photos_add_ftp.html
@@ -0,0 +1,112 @@
+<fieldset>
+ <legend>Quick Start</legend>
+
+<ol>
+ <li>Create a directory on your computer.</li>
+
+ <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>
+
+ <li>With a FTP client, copy your directory in the "galleries" directory of your Piwigo installation.</li>
+
+ <li>Logon your gallery and go to <span class="pwgScreen">Administration &raquo; Pictures &raquo; Thumbnails</span> to create missing thumbnails.</li>
+
+ <li>Go to <span class="pwgScreen">Administration</span> and click on the big Synchronization button.</li>
+</ol>
+
+Congratulations! You have successfuly created the first category of your photo gallery.
+</fieldset>
+
+<fieldset>
+ <legend>Directories and files organization</legend>
+
+<ul>
+
+ <li>
+
+ <p>Category directories are in the Piwigo directory
+ "galleries". Here follows the directory tree of a very small gallery (but
+ using many features) :</p>
+
+ <pre>
+.
+|-- admin
+|-- doc
+|-- galleries
+| |-- category-1
+| | |-- category-1.1
+| | | |-- category-1.1.1
+| | | | |-- category-1.1.1.1
+| | | | | |-- pwg_high
+| | | | | | +-- wedding.jpg
+| | | | | |-- thumbnail
+| | | | | | +-- TN-wedding.jpg
+| | | | | +-- wedding.jpg
+| | | | +-- category-1.1.1.2
+| | | +-- category-1.1.2
+| | |-- category-1.2
+| | | |-- pookie.jpg
+| | | +-- thumbnail
+| | | +-- TN-pookie.jpg
+| | +-- category-1.3
+| +-- category-2
+| |-- piglet.gif
+| |-- pwg_representative
+| | +-- video.jpg
+| |-- thumbnail
+| | +-- TN-piglet.jpg
+| +-- video.avi
+|-- include
+|-- install
+|-- language
+|-- template
++-- tool</pre>
+
+ </li>
+
+ <li>Each directory under "galleries" produces a category. There is no limit on deepness.</li>
+
+ <li>Basically, an element is represented by a file. A file can be a
+ Piwigo element if its extenstion is among <code>file_ext</code>
+ configuration parameter possibilities (see <span
+ class="filename">include/config_default.inc.php</span> file). A file can
+ be a picture if its extension is among <code>picture_ext</code>
+ configuration parameter possibilities.</li>
+
+ <li>Picture elements must have an associated thumbnail (see section below
+ about thumbnails)</li>
+
+ <li>Picture elements can have a high quality file associated. As for
+ wedding.jpg in the example above. No prefix on the high quality picture.</li>
+
+ <li>Non picture elements (video, sounds, file texts, what you want...) are
+ by default represented by an icon corresponding to the filename
+ extension. Optionaly, you can associate a thumbnail and a representative
+ file (see video.avi in the example above).</li>
+
+ <li><em>Warning</em>: the name of directories and files must contain only letters, figures, "-", "_" or ".". No blank space, no accentuated characters.</li>
+
+ <li>Once files, thumbnails and representatives are correctly placed in the
+ directories, go to : <span class="pwgScreen">Administration &raquo; Categories &raquo;
+ Synchronize</span></li>
+
+</ul>
+</fieldset>
+
+<fieldset>
+ <legend>Thumbnails</legend>
+<ul>
+
+ <li>Each photo must have its thumbnail.</li>
+
+ <li>Thumbnails are stored in the sub-directory "thumbnail" of the category
+ directory. The thumbnail has the same filename as the corresponding photo, with <em>TN-</em> as prefix.</li>
+
+ <li><em>Advise</em>: use an external module for thumbnails creation.</li>
+
+ <li>Even if it is not recommended (image quality, web server resource load), you can use <span
+ class="pwgScreen">Administration &raquo; Pictures &raquo; Thumbnails</span> page to create thumbnails.</li>
+
+ <li>Give write access on all category directories.</li>
+
+</ul>
+</fieldset>