Ajouter / modifier des fichiers XML dans une édition

Lors de l’étape 3 de la création d’une nouvelle édition, une base de données est créée par défaut. Son nom est celui donnée à la question "Database path ?", et il figure dans la première ligne du fichier de configuration de l’édition (dossier [projet]-max/editions/[mon-edition]/[mon-edition]_confing_inc.xml).
Cette base de données contient les fichiers XML qui sont affichés dans MaX.

Nota Bene
À chaque mise à jour de vos fichiers XML vous devez les ré-indexer dans votre base de données BaseX.

Pour ajouter des fichiers XML dans BaseX :

1) En ligne de commande, se placer dans le dossier [projet]-basex/bin

cd [chemin-vers-le-projet]/[projet]-basex/bin

2) Si ce n’est pas déjà fait, lancer BaseX

./basexhttp &

3) Ouvrir BaseX Client

./basexclient

Nota Bene
Depuis BaseX 10+, il ne faut plus mettre "-w" après la commande ./basexclient

4) Renseigner les identifiants et mots de passe de BaseX. Le mot de passe est celui défini lors de l'étape de configuration de BaseX.

Une fois le client BaseX ouvert, plusieurs actions sont possibles, aux moyens de commandes.

  • Accéder à la liste des différentes bases déjà existantes (par défaut, celle créée lors de l’étape 3 de la création d’une édition) :

list

  • Créer une nouvelle base :

create db [nom-de-la-base]

  • Supprimer une base:

drop db [nom-de-la-base]

  • Lister les fichiers disponibles dans une base :

list [nom-de-la-base]

  • Ajouter des fichiers dans une base :

add to [nom-de-la-base] [chemin-vers-le-fichier]

Il est possible d’ajouter un seul fichier XML, ou bien un dossier complet comprenant plusieurs fichiers.

Par exemple :
add to [nom-de-la-base] /Users/[nom-d'utilisateur]/Documents/FichiersXML/[nom-du-dossier]

  • Ouvrir une base (ce qui permettra d’ajouter/de supprimer des fichiers) :

open [nom-de-la-base]

  • Ajouter des fichiers dans une base après avoir ouvert cette base :

add /Users/[nom-d'utilisateur]/Documents/FichiersXML/[nom-du-dossier]
ou
add /Users/[nom-d'utilisateur]/Documents/FichiersXML/[nom-du-fichier]

  • Supprimer un fichier ou un dossier d’une base :

delete [nom-du-fichier] ou delete [nom-du-dossier]

=> On peut vérifier que les fichiers ont bien été ajoutés ou supprimés à l’aide de la commande list [nom-de-la-base].

Pour quitter BaseX Client, saisir la commande exit.

Par défaut, les documents ajoutés dans la base de données de l’édition sont affichés dans MaX à l’adresse suivante : http://[host]:[port]/[edition]/sommaire.html.