Lorsque j'ai acheté ce programme de galerie pour Lionel, le mode d'emploi était livré avec, ainsi que le code source du design en format flash. J'ai pu donc créer une galerie originale à partir de tout ça. En 2005 ce site c'est ouvert à d'autres artistes, multipliant la somme de travail. J'ai donc rédigé ce petit tuto pour ne plus avoir à expliquer plusieurs fois la même chose à chaque artiste lors des updates des contenus des galeries. Et puis mieux vaut écrire certaines choses futiles plutôt que de gâcher du cerveau à les apprendre, non ?

( Spiceware; Webdesigner, Webmaster )

1. Voici ce que vous devez m'envoyer dans vos emails de mise à jour :


. Penser à joindre votre texte de présentation, la liste de vos expositions. Pour toutes updates de texte, envoyer le texte et préciser la rubrique à remplacer ou a créer.

. Préciser simplement les noms ou titres des photos et de la galerie correspondante pour en enlever.

. Préciser dans quelle galerie seront rajoutées les photos.

. Joindre vos nouvelles photos sans les miniatures (500Ko par photo maxi pour ne pas pourrir ma boîte).

. Les photos doivent être titrées ainsi : 001titre.JPG ("001" est le numero est un repere pour l'ordre d'apparition dans la galerie, "titre" est évidement à remplacer par le titre de votre image, "JPG" est le nom de l'extension, seul "JPG, jpg, JPEG, jpeg" sont supporté ).

. Les titres des photos ne doivent surtout pas contenir d'espaces, d'accents de majuscules, de ponctuation ou autres caractères spéciaux ; juste des chiffres et  des minicuscules. Les photos mal titrées n'apparaissent pas dans la galerie qui ne gère pas ou très mal ces caractères.

. Le bout de programme qui m'est necessaire pour l'ajouter au fichier "gallery.xml" de la galerie à mettre à jour doit contenir les "item*" pour chacunes de vos nouvelles oeuvres. *c'est un objet virtuel définissant l'emplacement des icônes et des images et qui contient baussi leurs légendes la galerie va afficher (voir 2. ).

Le fichier 
"gallery.xml" d'une galerie contenant l'ensemble des item est indispensable. Sans ce fichier la galerie ne fonctionne plus, car elle ne sait pas où trouver les fichiers à afficher toute seule.

Surtout  
pas d'espaces, pas  d'accents, pas de majuscules, pas de ponctuation, ni d'autres caractères spéciaux dans les parties "thumb" et " img" de votre " item". Seul le texte descriptif "caption" de l'image est libre au niveau ponctuation.
2. Comment réaliser la liste des "item" à ajouter ?

Exemple d'Item pour une image 001titre.JPG étant en 3 ème position d'affichage dans la galerie. Pensez à mettre dans la partie "caption" : le titre entre guillemet ; ainsi que : le format, les techniques et support, et l'année de production, entre parenthèses comme dans l'exemple ci-dessous.

<item>
<thumb>mini-003titre.JPG</thumb> ACCENTS, ESPACES, MAJUSCULES, PONCTUATION > NON !
<img>003titre.
JPG</img> ACCENTS, ESPACES, MAJUSCULES, PONCTUATION > NON !
<caption>"Titre" (100x200cm, huile sur toile, 2012)</caption> ACCENTS, ESPACES, MAJUSCULES, PONCTUATION > OUI !
</item>
Edition du code
Dans cette colonne ; le code à recopier dans un fichier texte, document, ou dans un email. Il faut remplacer les zones surlignées en Bleu  pour lister chaque image dans l'ordre d'affichage de votre galerie :Dans cette colonne ; la description du CODE ligne par ligne.
<item>
<thumb>mini-000xxx.
JPG</thumb>
<img>000xxx.jpg</img>
<caption>"Xxxx" (00x00cm, Xxxx ...)</caption>
</item>
<item>
<thumb>mini-000xxx.
JPG</thumb>
<img>000xxx.jpg</img>
<caption>"Xxxx" (00x00cm, Xxxx ...)</caption>
</item>

<item>
<thumb>mini-000xxx.
JPG</thumb>
<img>000xxx.jpg</img>
<caption>"Xxxx" (00x00cm, Xxxx ...)</caption>
</item>
<item>
<thumb>mini-000xxx.JPG</thumb>
<img>.... ect...
Début item 1ère image
.icône 1ère image
.1ère image
.texte 1ère image
-Fin item 1ère image
Début item 2ème image
.icône 
2ème image
.2ème image
.texte 2ème image
-Fin item 2ème image
Début item 3ème image
.icône 
3ème image
.3ème image
.texte 3ème image
-Fin item 3ème image
Début item 4ème image
.icône 4ème image
ect...
3. Plus de détails sur les balises utilisées :

<item> Ouvre les définitions pour que la galerie reconnaisse et affiche une image avec son icône et son texte descriptif.

</item> Ferme les définitions pour une image afin de pouvoir ouvrir une autre définition pour l'image suivante dans l'ordre d'affichage de la galerie.

<thumb>......</thumb> appelle l'icône de l'image qui s'affichera dans la galerie il est toujours contenu entre <item> et </item>.

<img>......</img> appelle l'image qui s'affichera dans la galerie il est toujours contenu entre <item> et </item>.

<caption>......</caption> défini la phrase à afficher sous votre image.

Les Balises ça sert à quoi ?


En language XML en général le symbole <#> ouvre # et le symbole </#> ferme # .
Si # représente ici l'objet dont on ouvre la définition, <#> et </#> sont les balises entre lesquelles # va être défini. Mais # peut être un objet composé d'autres objets tel que ¤ et de ~.
On aura alors :

<#>
<¤> definition de ¤ </¤>
<~> definition de ¤ </~>
</#>

Tandis que dans une page HTML de site web les balises servent à définir la mise en forme et les liens d'un contenant, la page XML elle est hors ligne et sert à définir le contenu. Une page PHP ou un module en language Flash permettent de définir et réaliser les actions en rapport avec le contenant et le contenu (par ex : un clic de souris sur une page web qui ouvre une galerie d'image en diaporama puis un autre clic sur une image défilante de cette galerie va stopper le mode diaporarama, agrandir l'image cliquée tout en affichant un petit texte au dessus).

Le langage XML n'a pas de liste de balises prédéfinies, il est possible de créer les balises qu'on veut puis de réaliser le programme qui va savoir lire ce fichier et ses nouvelles balises.

Mais pourquoi un fichier XML ?


Modifier le coeur du programme d'une galerie est relativement long et demande des compétences professionnelles en programmation.
Le programme principal de la galerie a donc été relié à un petit fichier XML qui lui sert de liste, d'annuaire et de base de données pour les légendes.
Un XML est facilement éditable et est modifiable à souhait et si on se trompe on abime pas le programme principal de la galerie.
Opérer de la sorte est donc ingénieu et indispensable pour qu'un simple utilisateur puisse facilement comprendre, configurer et mettre à jour sa galerie tout seul.
Encore des problèmes ou des questions ?  http:spiceware.free.fr
(Spiceware, Août 2008)