lazygal - En ligne dans le Cloud

PROGRAMME:

Nom

lazygal - générateur de galerie web statique

SYNOPSIS

paresseux [-h | -v | [Options] répertoire d'album]

DESCRIPTION

Cette page de manuel explique les paresseux programme. Ce programme est une galerie web statique
générateur écrit en Python.

paresseux fonctionne ainsi : vous devriez avoir un magasin de fichiers d'origine - contenant peut-être
sous-répertoires (leurs noms servant de titres si vous n'utilisez pas la fonction de métadonnées d'album).
Il s'agit de la hiérarchie du fichier source. Il ne sera jamais modifié par paresseux. Puis quand
lancement:

$ lazygal -o /var/www/MonAlbum /home/utilisateur/RepSource

paresseux analysera le contenu de la hiérarchie source et (re)créera la cible
hiérarchie, avec toutes les fonctionnalités définies par les modèles. Seules les pièces manquantes ou
les pièces qui ne sont pas à jour seront générées. Il y a une limite à ce mécanisme
cependant : bien que les mises à jour dans le répertoire source, dans les métadonnées ou dans les thèmes soient
détectés, modifications des options de ligne de commande et des fichiers de configuration depuis la dernière génération
ne le sont pas et l'utilisateur doit supprimer manuellement les fichiers qui doivent être à nouveau générés.

OPTIONS

Ces programmes suivent la syntaxe habituelle de la ligne de commande GNU, avec de longues options commençant par
deux tirets (`-'). Un résumé des options est inclus ci-dessous. Pour une description complète, voir
le -h interrupteur.

-v --version
Afficher le numéro de version du programme et quitter.

-h --Aidez-moi
Afficher le résumé des options.

--silencieux
Ne rien sortir sauf les erreurs.

--déboguer
Affichez tout ce que fait lazygal.

-o DEST_DIR --répertoire-de-sortie=DEST_DIR
Répertoire où les pages Web, les diapositives et les vignettes seront écrites (la valeur par défaut est actuelle
annuaire).

-t THÈME --thème=THÈME
Nom du thème (recherché dans le répertoire du thème) ou chemin complet du thème.

--style-par défaut=STYLE PAR DÉFAUT
Style par défaut à appliquer au thème.

--template-vars=TPL_VARS
Variables communes pour charger tous les modèles, par exemple --template-vars='footer=foo
bar,couleur=baz'. Pour des contenus variables plus longs, il est plus simple d'utiliser un fichier de configuration
(voir paresseuxgal.conf(5)).

-f --force-gen-pages
Forcer la reconstruction des pages Web, quelles que soient les heures de modification de leur
dépendances. C'est pratique lors de la modification d'une option de configuration affectant ces
(thème, aplatissement de répertoire, etc.).

--propre-destination
Nettoyer le répertoire de destination des fichiers qui ne devraient pas s'y trouver (la valeur par défaut consiste à imprimer un
avertissement mais ne pas supprimer).

--check-all-répertoires
Parcourez tous les répertoires de manière exhaustive, quelle que soit l'heure de modification de la source.

-s TAILLE DE L'IMAGE --image-taille=TAILLE DE L'IMAGE
Taille des images, définir comme prénom=xxy, ..., par exemple. petit=800x600,moyen=1024x768. Les
les dimensions spéciales 0x0 utilisent la taille d'origine. Référez-vous à la DESCRIPTION DE LA TAILLE DE L'IMAGE
pour plus d'informations sur la syntaxe disponible.

-T THUMBNAIL_SIZE --thumbnail-size=THUMBNAIL_SIZE
Taille des vignettes, par ex. 150x113. Référez-vous à la section DESCRIPTION DE LA TAILLE DE L'IMAGE pour
plus d'informations sur la syntaxe disponible.

-q QUALITE --qualité=QUALITE
Qualité des images JPEG générées (la valeur par défaut est 85).

-O --original
Inclure des photos originales dans la sortie.

--orig-base=CHEMIN RELATIF
Ne copiez pas les photos originales dans le répertoire de sortie, mais liez-les plutôt à l'aide CHEMIN RELATIF
comme base pour ces liens (rejetés sans -O).

--orig-lien symbolique
Ne copiez pas les photos originales dans le répertoire de sortie, créez plutôt des liens symboliques vers leur
emplacements d'origine. Ceci est utile lorsque vous prévoyez de transférer l'intégralité du répertoire
qui paresseux généré vers un autre emplacement, peut-être avec rsync, et vous souhaitez
évitez de créer une copie supplémentaire de chaque photo.

Attention
Cette option n'est pas disponible sous Windows ; si vous essayez de l'utiliser sur ce fonctionnement
, paresseux sortira immédiatement avec un état de sortie de 1.

--puburl=PUB_URL
URL de publication (utile uniquement pour la génération de flux).

-m --générer des métadonnées
Générer des fichiers de description de métadonnées là où ils n'existent pas dans l'arborescence source à la place
de générer la galerie Web. Cela désactive toutes les autres options.

-n THUMBS_PER_PAGE --thumbs-per-page=THUMBS_PER_PAGE
Nombre maximum de pouces par page d'index. Cela permet la pagination d'index (0 est
illimité).

--filter-par-balise=TAG
S'il est défini, lazygal n'exportera que les images qui ont l'une de leurs balises (IPTC)
TAG correspondant. Il est également possible d'utiliser un équivalent des tests booléens AND et OR pour
balises de filtre. Pour plus de détails, lisez ci-dessous la section TAG Filtrage.

--pic-tri-par=COMMANDER
Ordre de tri des images dans une sous-galerie, parmi « mtime », « nom de fichier » ou « exif ». (défaut
est 'exif' qui est par date EXIF ​​si les données EXIF ​​sont disponibles, nom de fichier sinon, tri
images sans EXIF ​​auparavant). Ajoutez ':reverse' pour inverser l'ordre de tri (par exemple
--pic-sort-by=mtime:inverse).

--subgal-sort-par=COMMANDER
Ordre de tri des sous-galeries, parmi 'exif' (date EXIF ​​de la dernière photo dans
sous-galerie), 'mtime' ou 'dirname' (la valeur par défaut est 'dirname'). Ajouter ':reverse' pour inverser
l'ordre de tri (par exemple --subgal-sort-by=nom de répertoire: inverse).

--dir-aplatissement-profondeur=NIVEAU
Niveau en dessous duquel l'arborescence des répertoires est aplatie. La valeur par défaut n'est pas d'aplatissement (« Non »).

Cette option permet au programme d'inclure l'index de la galerie Web des galeries enfants dans
l'indice de galerie de leurs parents, si leur niveau est supérieur à celui fourni NIVEAUL’
le niveau de la racine de l'album est 0.

Les pages d'index avec plusieurs galeries (ce qui se produit lorsque cette section est utilisée) affichent les
liens d'images dans les sections de la galerie.

Les exemples suivants montrent les index produits pour un exemple d'album (2 sous-galeries,
1 sous-sous-galerie, 1 photo dans chacune de celles-ci).

Exemple 1. --dir-flattening-depth=Non (Par défaut)

index.html <- liens de sous-galerie
subgal1/index.html <- index avec img1
sous-gal1/img1.html
subgal1/subsubgal1/index.html <- index avec img2
sous-gal1/sous-sous-gal1/img2.html
subgal2/index.html <- index avec img3
sous-gal2/img3.html

Exemple 2. --dir-aplatissement-profondeur=0

index.html <- contient un index pour toutes les photos
sous-gal1/img1.html
sous-gal1/sous-sous-gal1/img2.html
sous-gal2/img3.html

Exemple 3. --dir-aplatissement-profondeur=1

index.html <- contient un index pour toutes les photos
subgal1/index.html <- index avec img1 et img2
sous-gal1/img1.html
sous-gal1/sous-sous-gal1/img2.html
subgal2/index.html <- index avec img3
sous-gal2/img3.html

-z --make-dir-zip
Créez une archive zip des images originales pour chaque répertoire.

--webalbum-pic-bg=WEBALBUMPIC_BG
Couleur d'arrière-plan de l'image de l'album Web. La valeur par défaut est transparente et implique le format PNG.
Toute autre valeur, par exemple rouge, blanc, bleu, utilise JPEG.

--webalbum-pic-type=WEBALBUMPIC_TYPE
Quel type de vignettes d'album Web générer. Par défaut, lazygal génère le
miniatures "désordonnées" bien-aimées avec des images sélectionnées au hasard dans l'album chacune
tourné d'un montant aléatoire et collé ensemble. Cette valeur par défaut peut également être forcée par
en spécifiant "désordonné" comme WEBALBUMPIC_TYPE.

D'un autre côté, spécifier 'tidy' comme valeur de cette option force lazygal à
sauter les rotations, résultant en des vignettes de forme plus régulière qui peuvent également être
plus dense. Cela peut être un avantage si tous les utilisateurs de vos albums n'ont pas
écrans géants :-)

--keep-gps-data
Ne supprimez pas les données GPS des balises EXIF. Par défaut, les balises de localisation sont supprimées pour
raisons de confidentialité. Cependant, il existe des situations où le fait d'avoir les données de localisation rend
sens et est désiré. Ceci est principalement destiné à être utilisé avec des photos de vacances.

THÈMES

Un thème correspond à un répertoire qui contient les éléments suivants :

thème/PARTAGÉ_*
Fichiers à mettre dans le répertoire partagé de la galerie Web, par exemple CSS, Javascript, images ou
d'autres ressources communes à toutes les galeries.

thème/parcourir.thtml
Le modèle XHTML pour la page de navigation du thème (affichant une image).

thème/dirindex.thtml ou thème/dynindex.thtml
Le modèle XHTML pour la page d'index du répertoire (liens d'images et de sous-galeries).

Selon le fichier d'index présent, le thème sera :

dirindex.thtml : entièrement statique
une page HTML par image, par taille et un index par taille, ou

dynindex.thtml : dynamique
un seul index par répertoire est à générer.

thème/*.thtml doit être un XML valide. Voir
http://genshi.edgewall.org/wiki/Documentation/xml-templates.html pour la syntaxe. Dépendances
pour les modèles statiquement inclus (c'est-à-dire avec des noms de fichiers non calculés à partir de variables) sont
calculé automatiquement : lorsqu'un modèle inclus est modifié, le logiciel
déterminer automatiquement les pages à régénérer. Les fichiers modèles manquants seront
recherché dans le défaut thème.

thèmeLes fichiers /SHARED_* (ressources communes pour le répertoire partagé) sont renommés pour supprimer le
PARTAGÉ_ préfixe et :

· Traité à l'aide du moteur de modèle de texte Genshi (voir
http://genshi.edgewall.org/wiki/Documentation/text-templates.html pour la syntaxe.) si
leur extension de fichier commence par t,

· Copié vers la destination de l'album Web autrement.

Utilisation du manifeste de thème thème/manifest.json, il est possible d'inclure des fichiers de
d'autres répertoires à copier dans les fichiers partagés de l'album Web.

Exemple 4. manifest.json

{
"partagé": [
# copier en tant que partagé/lib.js
{ "chemin": "../lib-2.1.js", "dest": "lib.js" },

# copier comme partagé/js/lib-2.1.js
{ "chemin": "../lib-2.1.js", "dest": "js/" }
]
}

Veuillez vous référer aux exemples fournis dans /usr/share/lazygal/themes.

ALBUM METADATA

Si un répertoire de l'album source contient un fichier nommé album_description, il est
traité comme une source de métadonnées d'album. Le format est emprunté à un autre album
outil de génération - Matew. Chaque ligne est traitée comme une balise possible, les lignes inconnues sont
simplement ignoré. Voici un exemple de contenu de ce fichier :

Exemple 5. description_album

Nom de l'album "Mon album"
Description de l'album "Description, qui peut être très longue."
Identifiant de l'image de l'album relatif/chemin/vers/image.jpg

Sinon, l'utilisateur peut fournir des métadonnées dans les fichiers suivants.

SOURCE_DIR/nom-album
Le titre à utiliser pour ce répertoire d'album.

SOURCE_DIR/description-de-l'album
La description de ce répertoire d'albums. Les balises HTML sont utilisées textuellement à partir de ce fichier.

SOURCE_DIR/album-photo
L'image à utiliser en haut de la pile d'images de l'album.

SOURCE_DIR/PICTURE_FILENAME.commenter
La description à utiliser pour cette image particulière. Veuillez noter que les balises HTML sont prises
comme fourni dans ce fichier pour la sortie dans les modèles.

Lazygal extrait également des informations de nombreuses balises de métadonnées dans les fichiers image. Concernant l'image
description, Lazygal recherche les commentaires dans cet ordre :

1. image.jpegfichier .commentaire

2. Exif.Photo.UserComment

3. Exif.Image.ImageDescription

4. Iptc.Application2.NomObjet

5. Commentaire JPEG

Utilisez lazygal en ligne en utilisant les services onworks.net