mirror of
https://github.com/YunoHost-Apps/piwigo_ynh.git
synced 2024-09-03 20:06:03 +02:00
81 lines
3 KiB
HTML
81 lines
3 KiB
HTML
<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, nor 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</span> and click on the big Synchronization button.</li>
|
|
</ol>
|
|
|
|
<p>Congratulations! You have successfully created the first album of your photo gallery.</p>
|
|
</fieldset>
|
|
|
|
<fieldset>
|
|
<legend>Directories and files organization</legend>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
|
|
<p>Album directories are in the Piwigo directory
|
|
"galleries". Here follows the directory tree of a very small gallery (but
|
|
using many features):</p>
|
|
|
|
<pre>
|
|
galleries
|
|
|-- wedding
|
|
| |-- celebration
|
|
| | |-- arrival
|
|
| | | |-- paul-alone.jpg
|
|
| | | +-- sarah-alone.jpg
|
|
| | +-- departure
|
|
| | +-- paul-and-sarah.jpg
|
|
| +-- party
|
|
| |-- dancers001.jpg
|
|
| |-- dancers002.jpg
|
|
| +-- dancers003.jpg
|
|
+-- honeymoon
|
|
| |-- hotel.png
|
|
| |-- video-from-plane.avi
|
|
| +-- pwg_representative
|
|
| +-- video-from-plane.jpg
|
|
+-- photoshoot
|
|
|-- img0001.jpg
|
|
|-- img0002.jpg
|
|
+-- pwg_format
|
|
|-- img0001.cr2
|
|
|-- img0001.cmyk.jpg
|
|
|-- img0001.zip
|
|
|-- img0002.cr2
|
|
+-- img0002.cmyk.jpg
|
|
</pre>
|
|
|
|
</li>
|
|
|
|
<li>Except for "pwg_representative" and "pwg_format" (see explanations below), each directory under "galleries" produces a album. 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 extension 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>Non photo elements (video, sounds, file texts, whatever you want...) are represented by default by an icon corresponding to the filename
|
|
extension. Optionally, you can associate a thumbnail and a representative
|
|
file (see video.avi in the example above).</li>
|
|
|
|
<li>Multiple formats: a photo can be available in several formats. In this example, we have 3 additional formats for img0001.jpg. You can activate this feature with <code>$conf['enable_formats'] = true;</code> in your local configuration and define a list of formats, like <code>$conf['format_ext'] = array('cmyk.jpg', 'cr2', 'zip');</code></li>
|
|
|
|
<li><em>Warning</em>: the name of directories and files must contain only letters, figures, "-", "_" or ".". No blank space, nor accentuated characters.</li>
|
|
|
|
<li>Once photos are correctly placed in the
|
|
directories, go to: <span class="pwgScreen">Administration » Tools »
|
|
Synchronize</span></li>
|
|
|
|
</ul>
|
|
</fieldset>
|