Différences

Ci-dessous, les différences entre deux révisions de la page.

--- td_histoire_numerique:descriptif_exercice_2 [2014/10/04 08:55]
Francesco Beretta [Interfaçage avec le logiciel Base]
+++ td_histoire_numerique:descriptif_exercice_2 [2014/10/06 09:07]
Francesco Beretta [Encodage de textes en XML – TEI]
@@ Ligne 5: / Ligne 5: @@
 ===== Création de la base de données bd_td_exercice =====
+Veuillez trouver [[td_histoire_numerique:postgresql&#apprendre_a_utiliser_postgresql|ici]] quelques indications pour apprendre à utiliser PostgreSQL.
+\\
+Procédure d'installation détaillée:
+\\
   * Téléchargez le {{:td_histoire_numerique:bases_de_donnees_20141003.zip|dossier zippé}} contenant les fichiers à utiliser
   * Dézippez-le: il contient deux dossier -> mettez-les dans le dossier du cours, dans un sous-dossier que vous nommerez 'bases_importees'
@@ Ligne 22: / Ligne 29: @@
   * Une fois le fichier ouvert (vous pourrez donc lire dans l'onglet 'Editeur SQL' une série de scripts SQL prêts à exécution), exécuter avec le menu Requêtes > Exécuter ou avec le bouton avec la forme d'une fleche verte
   * Vous regardez la dernière ligne du message : "La requête a été exécutée avec succès en 391 ms, mais ne renvoie aucun résultat." (le reste ne compte pas, même pas les lignes annulées) – Si vous voyez ce résultat (même si la durée en ms est différente) c'est bon.
+  * En exécutant la requête SQL que vous voyez dans la boîte de dialogue SQL, le serveur PostgreSQL a créé les tables et ajouté les données que contient la requête SQL (instruction INSERT).
   * Vous répétez ensuite l'opération avec les fichiers : **schema_parametres.sql** et **schema_vues_affichage.sql**
+    * Ouvrez le schema_parametres.sql
+    * Si le logiciel vous demande si vous voulez sauvegarder le texte que vous venez d'effacer à l'étape précédente, dites : non – car le nouveau texte SQL doit remplacer celui qui vient d'être exécuté
+    * Exécutez le script, etc.
   * ATTENTION : exécuter les trois fichiers .sql exactement DANS L'ORDRE INDIQUÉ
   * Fermez ensuite l'Editeur SQL'
@@ Ligne 61: / Ligne 74: @@
   * Ouvrir dans le fichier **schema_objets.sql**
   * Une fois le fichier ouvert (vous pourrez donc lire dans l'onglet 'Editeur SQL' une série de scripts SQL prêts à exécution), exécuter avec le menu Requêtes > Exécuter ou avec le bouton avec la forme d'une fleche verte
+  * En exécutant ce script SQL, le serveur PostgreSQL produit 3 nouvelles tables avec les séquences numériques associées, et alimente les tables avec les données que contient le script même (instruciton INSERT)
   * Vous répétez ensuite l'opération avec les fichiers : **schema_parametres.sql** et **schema_vues_affichage.sql**
   * ATTENTION : exécuter les trois fichiers .sql exactement DANS L'ORDRE INDIQUÉ
@@ Ligne 93: / Ligne 107: @@
 [[http://openoffice-libreoffice.developpez.com/cours/#base|Liste dans developpez.com]]
+[[https://wiki.documentfoundation.org/FR/FAQ/Base|Questions et problèmes habituels]]
+==== Procédure à suivre pour l'installation de l'interface ====
-Procédure à suivre:
   * Télécharger la version du fichier qui correspond au système de fonctionnement de l'ordinateur:
@@ Ligne 110: / Ligne 124: @@
   * Il n'y a rien a changer à ce sujet
   * Dans le cadre de gauche, dans 'Formulaires', {{ :td_histoire_numerique:bd_ecran_principal.png?100 |}} on peut ouvrir le formulaire **objets** et retrouver les objets déjà créées à partir des notices biographiques de l'exercice précédent
-  * On peut parcourir les objets un par un, ou ouvrir
+  * Au moment d'ouvrir le formulaire, Base vous demandera votre mot de passe utilisé lors de l'installation de PostgreSQL
+  * On peut parcourir les objets un par un, ou ouvrir la liste de tous les objets que contient la table –en utilisant le bouton en bas à droite {{ :td_histoire_numerique:bd_formulaire_objets.png?100 |}} – puis appliquer de filtres, trier, etc. C'est très pratique car l'objet sélectionné dans la liste est celui qu'on voit sur la fiche
+ATTENTION: ne pas toucher au contenu des tables du schéma paramètre car elles permettent à votre base de données de fonctionner correctement et vous risquez de compromettre l'affichage de vos données (mais pas les données elles mêmes car elles sont stockées à part)
+==== Installer l'interface de sa base personnelle ====
+Il s'agit maintenant de créer une interface pour la base de données personnelle que vous avez créé plus haut dans PostgreSQL: **bd_personnelle**
+Pour ce faire :
+  * Accéder au menu Fichier, enregistrer sous... {{ :td_histoire_numerique:bd_creer_copie_base.png?100 |}}
+  * renommez la copie que vous allez créer, l'appelant par ex. bd_personnelle – vous pouvez également la mettre dans un autre dossier, par ex. le dossier principal de votre travail de Master
+  * Validez et vous vous trouverez désormais dans le nouveau fichier de Base qui (pour mémoire) vous sert de client pour accéder au serveur PostgreSQL
+  * Il faudra maintenant changer les paramètres de connexion pour changer de base PostgreSQL interfacée
+  * allez dans le menu Edition > Base de données > Propriétés
+  * remplaces le nom de la base de données : 'dbname=bd_td_exercice' devient 'dbname=bd_personnelle'
+  * vous changez ainsi la base de données du serveur PostgreSQL qui devient visible grâce au client Base
+  * Testez la connexion avec le bouton de la même interface, mettant votre mot de passe.
+  * Si vous vous êtes trompés de mot de passe, il faut fermer et réouvrir le fichier
+  * ouvrez le formulaire 'objets': maintenant il sera vide car les tables du schéma 'objets' de votre base personnelle sont vides – à vous de les remplir
+  * pour créer un nouvel objet, uitliser le formulaire 'objets_creation' {{ :td_histoire_numerique:bd_formulaire_objets_creation.png?100 |}} car le formulaire 'objets' sert uniquement à visualiser et modifier des objets existants
+Si vous avez tout effectué correctement jusqu'ici vous disposez désormais d'une base de données à vous, vous permettant de créer des objets et de les associer entre eux. Par exemple, de créer un acteur et de l'associer à la bibliographie qui le concerne.
+==== Sauvegarde de votre base personnelle ====
+IMPORTANT: il faut **effectuer des sauvegardes régulières de votre base de données personnelle** en exportant en format SQL le contenu du schéma 'objets'. Vous pourrez ainsi recréer uen copie identique de votre base dans n'importe quel serveur PostgreSQL, par ex. sur un autre ordinateur.
+  * Ouvrir le client PGAdminIII et vous connecter à la base de données 'bd_personnelle'
+  * Déplier les schémas dans l'arboréscence à gauche
+  * sélectionner le schéma Objets, faire un click droit et sélectionner la commande sauvegarder{{ :td_histoire_numerique:pgsql_sauvegarde_du_schema.png?100 |}}
+  * créer un dossier de sauvegarde de vos données dans le dossier du TD ou de votre Master
+  * atteindre ce dossier par le bouton '...' de la sauvegarde de PGAdminIII
+  * comme nom du ficher de sauvegarde taper 'schema_objets_20141004.sql' Vous saurez ainsi directement à quelle date vous avez effectué la dernière sauvegarde
+  * Ensuite paramétrer dans le même onglet:
+    * Format : fichier plat
+    * Codage : UTF8
+    * Le reste :  vide
+  * Onglet 'Options 1': cocher 'Ne pas sauvegarder: Propriétaire, Droits'; le reste décoché
+  * Onglet 'Options 2' : cocher 'Requêtes : Utiliser les colonnes pour les Insert, Utiliser les commandes pour les insert' Le reste décoché, sauf laisser 'Messages en mode verbeux'
+  * Puis appuyer sur Sauvegarder.
+  * Si tout va bien, la liste des messages termine par 'Le process a retourné le code de sortie 0.' (si c'est '1' il y a un problème, '0' c'est OK)
+  * Vérifier que vous trouvez le nouveau document dans le dossier des sauvegardes.
+  * Ce n'est pas nécessaire de sauvegarder les autres schémas car normalement vous ne les touchez pas. Ils sont donc identiques aux fichiers que je vous ai envoyés et vous pouvez mettre une simple copie de ceux-ci dans votre dossier de sauvegarde.
+  * Le fichier de sauvegare vous permettra de recréer une copie exacte de votre schéma 'objets' de données sur un autre serveur (exactement comme on a fait lors de l'installation de la base de données pour le fichier exercice que je vous ai fourni). Donc si votre ordinateur a une défaillance, ou qu'on vous le vole, et si vous avez une copie de ces fichiers sur un disque dur à la maison, vous pourrez recréer votre base sur un nouvel ordinateur. Exactement comme on fait avec un document de traitement de texte.
+Le fichier de sortie .sql est un fichier texte, facilement stockable sur une clé USB et très facile à mettre sur n'importe quelle autre plateforme, garantissant ainsi la pérennité de vos données.
+Plus tard, vous pourrez aussi m'envoyer ces fichiers et je pourrai voir vos données, vous donner des indications et précisions et vous paramétrer des requêtes d'exploitation, pour vous apprendre à exploiter vos données
 ====== Création des objets et indexation des textes ======
+=====Présentation du modèle conceptuel=====
+Voici le {{:td_histoire_numerique:mcd_base_td_histoire_numerique.odg|fichier du MCD}} à télécharger.
+===== Encodage de textes en XML – TEI =====
+Installer le navigateur [[https://www.mozilla.org/fr/firefox/new/|Firefox]]
+La [[http://www.tei-c.org|page d'accueil]] de la Text encoding initiative.
+Les [[http://www.tei-c.org/release/doc/tei-p5-doc/fr/html/index.html|Guidelines]] en 'français'.
+[[http://xml.developpez.com/cours/?page=tech|Tutoriels]] d'introduction à XML.
+Exemples d'utilisation des balises tirés des Guidelines, par ex. [[http://www.tei-c.org/release/doc/tei-p5-doc/fr/html/examples-seg|l'élément 'seg']]. Remplacer le nom de l'élément après le tiret avec le nom de l'élément pour lequel on cherche des exemples.
+===== Activation de l'éditeur jEdit =====
+Télécharger le {{:td_histoire_numerique:documents_tei_20141005.zip|fichier}} contenant les documents pour jEdit, le dézipper et le placer dans le dossier du TD. Le dossier doit s'appeler 'documents_tei' sans date.
+Mise en fonction de jEdit:
+  * Dans le gestionnaire des plugins (Menu Plugins > Gestionnaires des plugins), vérifier si le plugin ProjectViewer est déjà installé (onglet Gestion), sinon l'ajouter (onglet Installation)
+  * Ajouter également le plugin SQL
+  * Ouvrir la fenêtre du ProjectViewer, dans le menu AllProjects créer un nouveau projet
+  * L'appeler td_histoire_numerique
+  * Comme 'root directory' = dossier racine chercher avec le bouton 'Choose' le dossier 'documents_tei' que vous venez de créer à partir du fichier dézippé, le sélectionner sans l'ouvrir et appuyer sur le bouton 'Parcourir'
+  * Valider, ce qui comporte l'ouverture de la boite de dialogue 'Inital import', ne rien changer dans le paramètres et clicquer sur 'Import'
+  * Le contenu du dossier sera visible dans la fenêtre des projets
-====== Sauvegarde de la base de données ======
+Paramétrage de jEdit
+  * Modification du menu contextuel
+    * Par click droit au milieu de la fenêtre du texte activer le menu contextuel et sélectionner personnaliser ce menu
+    * Clicquer sur le bouton '+' pour ajouter une nouvelle entrée
+    * Sélectionner plugin XML
+    * Ajouter les entrées: Indentation XML, Insertion XML (Afficher/Masquer), Editer la balise au curseur
+    * A l'aide des fléches vertes monter les trois éléments insérés dans la deuxième zone du menu
+    * Sélectionner Plugin: Sideclick-Parsers, ajouter xml (analyser xml) et le monter au début de la partie xml du menu contextuel
+  * Création des raccourcis
+    * Dans le menu Utilitaires > Options générales sélectionner Raccourcis
+    * Ajouter des raccourcis: Ctrl-i pour Indentation XML; ctrl-maj-i pour Insertion XML; ctrl-maj-a pour xml 'analyser XML)
+  * Modification de la largeur de la fenêtre
+    * Menu Utilitaires > options générales, dans l'entrée Edition activer le retour à la ligne 'soft'
+    * adapter la longueur de la ligne (80-100 caractères) en fonction de la largeur de son propre écran
+  * Dans l'entrée encodages, mettre l'encodage par défaut à UTF-8
+  * Docker les fenêtres des plugins (Sideclick, ProjectViewer, Insertion XML) dans la fenêtre de gauche: Otions globales, Ancrage
+  * Dans 'Zone de texte' modifier la taille de la police de l'éditeur si souhaité

Wiki de l'ARHNAxe de recherche en histoire numériqueLARHRA UMR5190

Outils pour utilisateurs

Outils du site

Différences

Outils de la page

Wiki de l'ARHN

Axe de recherche en histoire numérique
LARHRA UMR5190