Voici le source du fichier XML demandé.

index.xml


<lph>
  <titre h1 = "1" >
    Mosalis
  </titre>
  <p>
    <b>
      mosalis
    </b>
     est un script
    <sc>
      Perl
    </sc>
     utilisable sous
    <sc>
      Linux
    </sc>
     dans le but de générer des albums photos. Il utilise des
    <i>
      styles
    </i>
     prédéfinis mais l'intention est de donner la possibilité de les modifier et de les enregistrer ensuite, afin de les réutiliser. Pour l'instant il n'y a que très peu d'informations attachées à ces albums, il est prévu d'en gérer davantage (en particulier les données
    <i>
      exif
    </i>
    ) de façon à constituer une réelle base de données.
  </p>
  <div style = "background:#EFEFEF;border:1px solid #FE3;padding:5px;margin-bottom:15px" >
    <b>
      Attention
    </b>
     — Ce script est en cours de développement, certaines de ses fonctionnalités sont susceptibles d'être modifiées. La documentation sera mise en place progressivement.
  </div>
  <div style = "text-align:center" >
    <img alt = "angles" src = "styles/angles/angles1a.jpg" title = "Style angles" ></img>
       
    <img alt = "dolomites" src = "styles/dolomites/dolomites1a.jpg" title = "Style dolomites" ></img>
  </div>
  <h2>
    Installation
  </h2>
  <p>
    Après téléchargement de l'
    <a href = "mosalis-0.1.tar.gz" >
      archive
    </a>
    , il faut la décompacter et exécuter
    <code>
      make install
    </code>
     en se plaçant à la racine du répertoire obtenu.
  </p>
  <p>
    L'installation se réduit aux opérations suivantes.
  </p>
  <ul>
    <li>
      Déplacement de deux scripts
      <sc>
        Perl
      </sc>
       vers le répertoire
      <code>
        ~/bin
      </code>
       de l'utilisateur. Au passage, cela suppose que ce répertoire est dans le chemin de recherche des exécutables (variable
      <code>
        PATH
      </code>
      ).
    </li>
    <li>
      Création du répertoire
      <code>
        ~/.mosalis
      </code>
       dans lequel sont déplacés les styles et quelques autres petites choses.
    </li>
  </ul>
  <h2>
    Utilisation
  </h2>
  <p>
    Pour créer un album
    <b>
      Mosalis
    </b>
     il faut commencer par rassembler les photos qui vont le constituer dans un répertoire. Et oui,
    <b>
      Mosalis
    </b>
     ne fais pas tout, et comme vous allez le constater il en laisse beaucoup à l'utilisateur ce qui est de nature à ménager sa sensibilité d'artiste.
  </p>
  <p>
    Une fois le répertoire créé et les photos logées (avec l'extension
    <code>
      .jpg
    </code>
    ) alors il est temps d'initialiser la procédure.
  </p>
  <p>
    <code>
      $> mosalis mosap::init
    </code>
  </p>
  <p>
    Ce n'est pas tout à fait conventionnel comme appel mais
    <b>
      Mosalis
    </b>
     est en phase de développement et je souhaite ménager des possibilités d'extension. Cet appel est en réalité l'invocation d'une méthode (
    <code>
      init
    </code>
    ) liée à un objet (
    <code>
      mosap
    </code>
    ).
  </p>
  <p>
    Ainsi le répertoire sera configuré comme un album
    <b>
      Mosalis
    </b>
     avec le style par défaut:
    <a href = "styles/angles/" >
      angles
    </a>
    . Si vous souhaitez démarrer avec un autre style (
    <a href = "styles/dolomites/" >
      dolomites
    </a>
     par exemple), il suffit d'entrer la commande suivante.
  </p>
  <p>
    <code>
      $> mosalis mosap::init[dolomites]
    </code>
  </p>
  <p>
    Avant de passer à la construction de l'album, il faut documenter le fichier
    <code>
      album.xml
    </code>
     qui se trouve dans le répertoire
    <code>
      datas
    </code>
     à la racine de l'album
    <b>
      Mosalis
    </b>
    . Cela peut se faire avec n'importe quel éditeur de texte, voire un éditeur de fichiers
    <sc>
      XML
    </sc>
    .
  </p>
  <ul>
    <li>
      <b>
        titre
      </b>
       : titre de l'album.
    </li>
    <li>
      <b>
        auteur
      </b>
       : auteur de photos.
    </li>
    <li>
      <b>
        date
      </b>
       : date de prise de vue.
    </li>
    <li>
      <b>
        image
      </b>
       : légende des différentes photos, vous pouvez spécifier, comme arguments, un
      <i>
        auteur
      </i>
       différent et/ou une
      <i>
        date
      </i>
       différente.
    </li>
  </ul>
  <p>
    Le fichier
    <code>
      album.xml
    </code>
     peut servir à cacher des photos de l'album et à les réordonner. Il suffit de retirer des éléments
    <i>
      image
    </i>
     (ou de les commenter) et de les réordonner.
  </p>
  <p>
    Voici la dernière chose à faire pour disposer d'un album achevé:
    <code>
      make all
    </code>
     à la racine de l'album. En fait l'aventure commence, vous allez pouvoir visionner l'album en pointant un navigateur sur le fichier
    <code>
      index.html
    </code>
     situé à la racine, son adaptation se fera en allant triturer les fichiers situés dans le répertoire
    <code>
      datas/mosap
    </code>
     et en adaptant éventuellement le
    <code>
      Makefile
    </code>
     qui est à la racine de l'album.
  </p>
</lph>
Composé par petitParseur le vendredi 3 mai 2024