Comienzo rápido

1. Cree un repertorio en su ordenador.
2. Copie las fotos dentro de este repertorio, luego redimensione para una visualización en la web. Atención : El nombre de los repertorios y de los ficheros debe contener sólo letras, cifras y los carácteres "-", "_" y ".". Ningún espacio o carácteres acentuados.
3. Con un cliente FTP, copie el repertorio en el repertorio " galleries " de su instalación de Piwigo.
4. Conecte usted a su instalación de Piwigo y vaya aAdministración » Imágenes » Miniaturas para crear las miniaturas que faltan.
5. Vaya a Administración y haga clic en el botón de sincronización.

¡ Bravo! Usted creó con éxito la primera categoría de su galería.

Organización de los repertorios y de los ficheros

- Los repertorios que representan las categorías están en el repertorio " galleries ". Más abajo el árbol de los repertorios de una galería muy pequeña (pero utilizando numerosos carácteres funcionales):

      .
      |-- admin
      |-- doc
      |-- galleries
      |   |-- categoría-1
      |   |   |-- categoría-1.1
      |   |   |   |-- categoría-1.1.1
      |   |   |   |   |-- categoría-1.1.1.1
      |   |   |   |   |   |-- pwg_high
      |   |   |   |   |   |   +-- mariage.jpg
      |   |   |   |   |   |-- thumbnail
      |   |   |   |   |   |   +-- TN-mariage.jpg
      |   |   |   |   |   +-- mariage.jpg
      |   |   |   |   +-- categoría-1.1.1.2
      |   |   |   +-- categoría-1.1.2
      |   |   |-- categoría-1.2
      |   |   |   |-- pookie.jpg
      |   |   |   +-- thumbnail
      |   |   |       +-- TN-pookie.jpg
      |   |   +-- categoría-1.3
      |   +-- categoría-2
      |       |-- porcinet.gif
      |       |-- pwg_representative
      |       |   +-- video.jpg
      |       |-- thumbnail
      |       |   +-- TN-porcinet.jpg
      |       +-- video.avi
      |-- include
      |-- install
      |-- language
      |-- template
      +-- tool

- Fundamentalmente, una categoría es representada por un repertorio a cualquier nivel bajo el repertorio " galleries " de su instalación de Piwigo. Cada categoría puede contener tantos subniveles como deseado. En el ejemplo más arriba, categoría-1.1.1.1 está en un nivel 4 de profundidad.
- Fundamentalmente, un elemento es representado por un fichero. Un fichero puede ser un elemento para Piwigo si la extensión del nombre del fichero está entre la lista del parámetro de configuración `file_ext` (Ver fichero include/config.inc.php). Un fichero puede ser una imagen si su extensión está entre el parámetro de configuración `picture_ext`.
- Los elementos de tipo llena de imágenes deben tener una miniatura asociada (ver la sección siguiente a propósito de las miniaturas).
- Los elementos de tipo imágenes pueden tener unas imágenes de gran tamaño asociado. Así como para el fichero mariage.jpg En el ejemplo más arriba. Ningún prefijo es necesario sobre el nombre del fichero.
- Los elementos no imagen (vídeos, sonidos, archivos de texto, todo lo que usted quiere) por defecto son representado por icono que corresponde a la extensión del nombre del fichero. Optionalmente, una miniatura y un representante pueden ser asociados (ver el fichero video.avi en el ejemplo).
- Atención : El nombre de un repertorio o de un fichero debe ser constuitido sólo por letras, cifras, de "-", "_" o ".". Ningún espacio o carácteres acentuados.
- Consejo : Una categoría puede contener elementos y subcategorías a la vez. Sin embargo, es fuertemente aconsejado para cada categoría escoger entre: contener elementos o bien Subcategorías.
- En cuanto los ficheros, las miniaturas y los representantes están correctamente colocados en los repertorios, ir a Administración » Categorías » Sincronizar.

Miniaturas

- Así como mencionado anteriormente, cada elemento de tipo imágenes debe ser asociado con una miniatura.
- Las miniaturas son almacenadas en el subdirectorio " thumbnail " de cada repertorio que representa una categoría. Una miniatura es un fichero de tipo imágenes (la misma extensión del nombre del fichero) cuyo nombre de fichero es prefijado por el parámetro de configuración `prefix_thumbnail` (ver include/config.inc.php).
- Las miniaturas no necesitan tener la misma extensión que las imágenes asociada (una imagen con ".jpg" como extensión puede tener una miniatura .GIF " por ejemplo).
- Es aconsejado utilizar un programa externo para la creación de las miniaturas
- Usted también puede utilizar el programa de creación de miniatura integrado a Piwigo pero esto es desaconsejado porque la calidad corre peligro de ser decepcionante y esto utiliza inútilmente los recursos del servidor (lo que puede ser un problema grave sobre un servidor mutualisado).
- Si usted escoge utilizar al servidor web para generar las miniaturas, usted debe dar los derechos en escritura a los repertorios.