Wiki de l'ARHN

Axe de recherche en histoire numérique
LARHRA UMR5190

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
Revenir à l'[[intro_histoire_numerique:accueil|accueil]]


===== Encodage sémantique de textes en XML =====



==== HTML ====

Hypertext Markup Language – HTML

  *[[https://fr.wikipedia.org/wiki/Hypertext_Markup_Language|Hypertext Markup Language]] (Wikipedia en français)
  * [[https://www.w3schools.com/html/|HTML Tutorial (w3schools)]]


==== XML  ====



=== Tutoriels ===

  * [[https://openclassrooms.com/fr/courses/1766341-structurez-vos-donnees-avec-xml?status=published|Structurez vos données avec XML]]
    * XML - [[https://openclassrooms.com/fr/courses/1766341-structurez-vos-donnees-avec-xml/1766585-les-elements-de-base|Eléments de base]]
    * [[https://openclassrooms.com/fr/courses/1766341-structurez-vos-donnees-avec-xml/1769236-introduction-a-xslt|XSLT]]

  * [[https://fr.wikipedia.org/wiki/Extensible_Markup_Language|Extensible Markup Language – XML]]
  * [[https://fr.wikipedia.org/wiki/XQuery|XQuery]] – [[https://www.w3schools.com/XML/xquery_flwor.asp|FLOWR Tutorial]]





==== TEI – Text encoding initiative ====



<HTML><ul></HTML>
<HTML><li></HTML>[[https://tei-c.org/|TEI: Text Encoding Initiative]]<HTML></li></HTML>
<HTML><li></HTML><HTML><p></HTML>[[https://www.tei-c.org/release/doc/tei-p5-doc/en/html/index.html|TEI Guidelines]]<HTML></p></HTML>
<HTML><ul></HTML>
<HTML><li></HTML>[[https://tei-c.org/guidelines/customization/Lite/|TEILite]]: designed to meet “90% of the needs of 90% of the TEI user community”.<HTML></li></HTML><HTML></ul></HTML>

<HTML><p></HTML><HTML></p></HTML><HTML></li></HTML>
<HTML><li></HTML>[[https://journals.openedition.org/jtei/|Journal of the Text Encoding Initiative]]<HTML></li></HTML><HTML></ul></HTML>

  * Un [[https://groupes.renater.fr/wiki/symogih/symogih_manuel/edition_de_textes_en_xml-tei|exemple d'encodage sémantique]] autour du projet symogih.org



== Exemple: encoder des correspondances ==

  * TEI: [[https://tei-c.org/Activities/SIG/Correspondence/|Correspondence SIG]]
  * [[https://wiki.tei-c.org/index.php?title=C._M._v._Weber_an_Johann_Gänsbacher,_Munich,_27th_June_1811|C. M. v. Weber an Johann Gänsbacher, Munich, 27th June 1811]]
  * [[https://correspsearch.net/|correspSearch]] ([[https://tei-c.org/activities/projects/correspsearch/|TEI: correspSearch]])



== Collections, ressources, méthodes d'édition ==

  * [[https://wiki.tei-c.org/index.php?title=Samples_of_TEI_texts|Samples of TEI texts]]
  * Projet Gutenberg: [[http://www.gutenberg.org/catalog/world/results?filetype=tei&pageno=1|textes publiés]] selon les recommandations de la TEI
  * [[https://ride.i-d-e.de/issues/|Ride]] – A review journal for digital editions and resources



== Digital Latin Library ==

  * [[https://digitallatin.org/blog/setting-atom-editing-texts-digital-latin-library|Setting up Atom for Editing Texts for the Digital Latin Library]]
  * [[https://digitallatin.org/blog/using-beautifulsoup-add-works-dlls-database|Using BeautifulSoup to add works to the DLL's database]]

==== Encodage sémantique ====



  * Beretta, Francesco,[[https://halshs.archives-ouvertes.fr/halshs-01505635| Pour une annotation sémantique des textes: le projet symogih.org et la Text encoding initiative]], //Bruniana e Campanelliana, Ricerche filosofiche e materiali storico - testuali//, Fabrizio Serra editore, 2016, XXII (2), [[https://dx.doi.org/10.19272/201604102005|⟨10.19272/201604102005⟩]]



=== Annotation sémantique de textes XML en utilisant quelques éléments de TEILite : ===



<HTML><ul></HTML>
<HTML><li></HTML>ouvrir un existant document préconfiguré (par ex. naudet_2.xml)<HTML></li></HTML>
<HTML><li></HTML><HTML><p></HTML>remplacer le texte et les méta-données de l'élément //teiHeader// avec les nouvelles données – enregistrer sous un nouveau nom:<HTML></p></HTML>
<HTML><p></HTML><sourceDesc><HTML></p></HTML>
<HTML><p></HTML>   <p corresp="https:%%//%%fr.wikipedia.org/wiki/Emmanuel_de_Pastoret">Notice wikipedia</p><HTML></p></HTML>
<HTML><p></HTML></sourceDesc><HTML></p></HTML><HTML></li></HTML>
<HTML><li></HTML><HTML></li></HTML>
<HTML><li></HTML>copier coller le texte de la notice dans l'élément //body//<HTML></li></HTML>
<HTML><li></HTML>créer divisions et paragraphes (éléments //div// et //p//)<HTML></li></HTML>
<HTML><li></HTML><HTML><p></HTML>annoter les **entités nommées** : éléments //name// et //rs//, attributs @ref pour l'individu<HTML></p></HTML>
<HTML><p></HTML><name ref="1">Galileo Galilei</name><HTML></p></HTML>
<HTML><p></HTML><rs ref="1">l'astronome toscan</rs><HTML></p></HTML><HTML></li></HTML>
<HTML><li></HTML><HTML><p></HTML>annoter les entités nommées sous-entendues: element //ptr//, attribut @target<HTML></p></HTML>
<HTML><p></HTML><ptr target="1"/><HTML></p></HTML><HTML></li></HTML>
<HTML><li></HTML><HTML><p></HTML>Annoter les dates:<HTML></p></HTML>
<HTML><p></HTML>Elle est née le <date when="1953-09-17">27 septembre 1953</date><HTML></p></HTML>
<HTML><p></HTML>Il a été membre du conseil du comté de Suffolk <date from="2001" to="2005">entre 2001 et 2005</date><HTML></p></HTML><HTML></li></HTML>
<HTML><li></HTML><HTML><p></HTML>annoter les entités temporelles: élément //seg// (au dessous du niveau paragraphe), attributs @type pour le sigle de la classe, @ana pour le code de la classe\\
    <seg ana="3">[segment de texte concernant une naissance]</seg><HTML></p></HTML>
<HTML><p></HTML><seg ana="3"><name ref="14">Diane Julie Abbott</name>, née le <date when="1953-09-17">27 septembre 1953</date> à <name ref="317">Londres</name></seg>.<HTML></p></HTML><HTML></li></HTML><HTML></ul></HTML>

<HTML><ul></HTML>
<HTML><li></HTML><HTML><p></HTML>ajouter les propriétés avec l'attribut @ana\\
    <name ana="19">[segment de texte qui contient le nom de la personne qui naît]</seg><HTML></p></HTML>
<HTML><p></HTML><seg ana="3"><name ref="14" ana="19">Diane Julie Abbott</name>, née le <date when="1953-09-17">27 septembre 1953</date> à <name ref="317" ana="4">Londres</name></seg>.<HTML></p></HTML><HTML></li></HTML><HTML></ul></HTML>

<HTML><ul></HTML>
<HTML><li></HTML><HTML><p></HTML>ajouter des concepts qui classent les textes<HTML></p></HTML>
<HTML><ul></HTML>
<HTML><li></HTML>utiliser les balises structurelles : //div// ou //p //ou la balise //seg avec des attributs @type, //en mettant des noms de concepts en tant que types comme chaînes de caractères (et non des chiffres).<HTML></li></HTML>
<HTML><li></HTML>attention: plusieurs concepts possibles réparés par espace mais dans le nom du concept pas d'accent ni espace; pour les concepts composés de deux mots mettre un tiret sous la ligne (underscore)<HTML></li></HTML>
<HTML><li></HTML>ces conceptes permettent d'identifier des portions de texte mais ne représentent pas des entités temporelles<HTML></li></HTML>
<HTML><li></HTML>on utilise @type pour les concepts définis en tant qu'instances (données) et @ana pour les code / clés des classes et propriétés (modèle)<HTML></li></HTML><HTML></ul></HTML>

<HTML><p></HTML><div type="biographie carriere_politique">[division du texte qui concerne tel sujet]</div><HTML></p></HTML>
<HTML><p></HTML><p type="biographie">[paragraphe qui concerne tel sujet]</p<HTML></p></HTML><HTML></li></HTML><HTML></ul></HTML>

==== Atom - éditeur de texte et de code ====



=== Installation de base ===

Sous Windows:

  * Vérifier que Java est bien installé sur votre ordinateur sous Windows:
    * activer l'invite de commandes de Windows = cherche CMD parmi les programmes
    * dans l'invite de commandes (CMD) taper: java -version
    * si il vous dit que Java n'est pas dans le chemin il n'est pas installé, s'il est installé il vous indique le numéro de version installée
  * Si Java n'est pas installé, l'installer depuis ce site:\\
   https:%%//%%www.java.com/fr/download/
  * Tester l'insallation de java, taper dans CMD:\\
java -version



Sous MacOS:

  * Vérifier que Java est bien installé sur votre ordinateur:
    * ouvrir Terminal
    * taper: java -version
  * Java devrait être installé par défaut sur macOS, gérer dans Préférences Système > Java





<HTML><ul></HTML>
<HTML><li></HTML><HTML><p></HTML>Télécharger le logiciel libre [[https://atom.io/|Atom]]<HTML></p></HTML>
<HTML><ul></HTML>
<HTML><li></HTML><HTML><p></HTML>Vérifier présence de:<HTML></p></HTML>
<HTML><ul></HTML>
<HTML><li></HTML>autocomplete-html<HTML></li></HTML><HTML></ul></HTML>
<HTML></li></HTML>
<HTML><li></HTML><HTML><p></HTML>[[https://fr.wikipedia.org/wiki/Atom_(éditeur_de_texte)|Wikipedia : Atom]] <HTML></p></HTML>
<HTML><ul></HTML>
<HTML><li></HTML>afin de protégér votre sphère privée, dans Préférences > Packages > désactiver le plugin 'metrics'<HTML></li></HTML><HTML></ul></HTML>
<HTML></li></HTML><HTML></ul></HTML>

<HTML><p></HTML>\\
Plugins à installer:<HTML></p></HTML>
<HTML><ul></HTML>
<HTML><li></HTML>atom-beautify<HTML></li></HTML>
<HTML><li></HTML>atom-html-preview<HTML></li></HTML>
<HTML><li></HTML>atom-xsltransform<HTML></li></HTML>
<HTML><li></HTML><HTML><p></HTML>installer l'extension **linter-autocomplete-jing**<HTML></p></HTML>
<HTML><ul></HTML>
<HTML><li></HTML>   Lorsque le logiciel vous demande: Install dependency? répondre Oui<HTML></li></HTML><HTML></ul></HTML>

<HTML><p></HTML>   et ce plusieurs fois (Java est requis pour cette installation)<HTML></p></HTML><HTML></li></HTML>
<HTML><li></HTML>atom-wrap-in-tag<HTML></li></HTML>
<HTML><li></HTML>atom-live-server-plus<HTML></li></HTML>
<HTML><li></HTML>language-sparql<HTML></li></HTML><HTML></ul></HTML>
<HTML></li></HTML><HTML></ul></HTML>





== Installation optionnelle ==



Installer Git pour versionnement et intallation de plugins supplémentaires qui utilisent Git



  * Vérifier sous Mac si Git est installé -> dans Terminal taper:
    * git --version
  * si GIT n'est pas installé, installer Git pour Mac:
    * [[https://git-scm.com/book/en/v2/Getting-Started-Installing-Git|page d'instructions]]
    * lien de téléchargement: https://git-scm.com/download/mac



  * Install GIT with Git for Windows: 
  * Install [[https://www.atlassian.com/git/tutorials/install-git|Git for Windows]]  
  * [[https://gitforwindows.org/|Documentation: Git for Windows]]
    * [[https://www.jamessturtevant.com/posts/5-Ways-to-install-git-on-Windows/|5 Ways of installing GIT]] on Windows

  * choisir Atom comme éditeur GIT par defaut dans les préférences d'Atom
    * en principe, le [[https://github.atom.io/|plugin GitHub est préinstallé dans Atom]]
    * [[https://courses.cs.washington.edu/courses/cse154/19su/resources/assets/atomgit/windows/|Git and Atom Setup - Windows]]
  * le reste per default, y compris MinTTY
  * Vérifier l'installation:

//apm -version//

//Résultat (avec d'autres versions des paquets)://

//apm  2.4.3\\
npm  6.2.0\\
node 10.2.1 x64\\
atom 1.40.1\\
python 3.7.3\\
git 2.17.2//



Après avoir installé Git et vérifié qu'il est bien là:

<HTML><ul></HTML>
<HTML><li></HTML>installer le plugin //quick-query//<HTML></li></HTML>
<HTML><li></HTML>puis le plugin: [[https://atom.io/packages/quick-query-sqlite|quick-query-sqlite]] qui permet de visualiser des données d'une base SQLite directement dans Atom<HTML></li></HTML>
<HTML><li></HTML><HTML><p></HTML>SQLite est en lecture seule, si on utilise PostgreSQL on peut aussi écrire dans la base de données<HTML></p></HTML>
<HTML><p></HTML><HTML></p></HTML><HTML></li></HTML><HTML></ul></HTML>
Wiki de l'ARHNAxe de recherche en histoire numériqueLARHRA UMR5190

Outils pour utilisateurs

Outils du site

Outils de la page

Wiki de l'ARHN

Axe de recherche en histoire numérique
LARHRA UMR5190
