Débugue tes humanités Saison 3b

Séance 06 - Introduction à l'éditeur de texte Stylo

Un éditeur de texte pour les sciences humaines.

Chaire de recherche du Canada sur les écritures numériques, Bibliothèque des lettres et des sciences humaines, Ouvroir d'histoire de l'art et de muséologie numérique. — roch.delannay@umontreal.ca ; giulia.ferretti@umontreal.ca ; louis-olivier.brassard@umontreal.ca

Plan de la séance #

Stylo
Création d’un compte
Tour de plateforme
Gestion des articles
Gestion des contenus
Gestion de la bibliographie
BibTeX
Better BibTeX
YAML
Prévisualisation et annotation
Module d’export
GrapQL Playground

1. Stylo #

Éditeur de texte WYSIWYM
Séparation entre mise forme et sens du texte
Gestion du balisage dans le mains du chercheur·e·s
Métadonnées enrichies (YAML, BibTeX)
Single source publishing (PDF, HTML, XML…)
API GraphQl et Pandoc

2. Création d’un compte #

Ma page utilisateur

3. Tour de plateforme #

Gestion des articles et des tags
Éditeur de texte (Monaco) avec MarkDown
Gestion des bibliographies avec BibTeX
Gestion des métadonnées avec YAML
Prévisualisation et annotation avec Hypothes.is : publique ou [dans un groupe privé] (https://hypothes.is/groups/B2j3obmw/debugue)
Export avec Pandoc

4. Gestion des articles #

Créer un nouvel article
Gérer les étiquettes
Supprimer un article

4. Gestion des articles #

Copier la dernière version d’un article
Partager un article avec toutes ses versions
Exporter un article
Prévisualisation d’un article

5. Gestion des contenus #

La syntaxe MarkDown

Titres
Notes
Italiques/gras
Images
Liens
Tableaux

Class

``` 
[texte]{.class}

```
```
:::{.class}
texte
:::
``` 
Équivalent HTML : 
- Premier cas : `<span class="class">`
- Deuxième cas : `<div class="class">`

Seulement pour l'export PDF : `\epigraph texte`

Espace insécable : Ctrl+Shift+Espace ou   en ASCII

Versions
- Comparaison entre différentes versions

5. Gestion des contenus #

Modifier des parties de texte #

CTRL/Cmd+F
CTR//Cmd+H :
Expressions régulières

RegEx – Exemples #

Voir ICI et ICI pour plus d’exemples

Et ICI pour expérimenter les expressions rationnelles

^The : correspond à toute chaîne de caractères commençant par The
end$ : correspond à une chaîne qui se termine par end
^The end$ : correspondance exacte de la chaîne (commence et se termine par The end)
the : matches any string that has the text end in it

\*\*(?=) : pour trouver des mots en gras

abc*
abc+
abc{2}
a(b|\s) 

/(^|\s)(the\s.*?\.)/g : pur mettre en gras toutes les phrases commençant par The

5. Gestion des contenus #

Exercice –Docx vers MarkDown #

Convertir un texte docx en Markdown via Pandoc : pandoc -f docx -t markdown "word_filename.docx" -o "markdown_filename.md"
Corriger les balises Dans la version précédente, cette conversion était intégrée dans Stylo : Voir ICI
Une alternative temporaire pour comprendre les commandes Pandoc : ICI

6. Gestion de la bibliographie #

Manage Bibliography
Import a collection from my account
Raw BibTeX
Citations dans le texte + autocomplétion
- [@clef]
- [-@clef]
- @clef

7. BibTeX #

BibTeX est un format de fichier structurant une bibliographie :

format qui a été créé en 1985 pour gérer les bases de données bibliographiques dans des fichier LaTeX ;
le format BibTeX fonctionne par entrée bibliographiques : chaque entrée correspond à une description d’un document avec des items “mot-clef = valeur”.

@book{kirschenbaum_track_2016,
  address = {{Cambridge, Massachusetts, Etats-Unis d'Am{\'e}rique}},
  title = {Track Changes: A Literary History of Word Processing},
  isbn = {978-0-674-41707-6},
  shorttitle = {Track Changes},
  language = {anglais},
  publisher = {{The Belknap Press of Harvard University Press, 2016}},
  author = {Kirschenbaum, Matthew G.},
  year = {2016, cop. 2016}
}

8. Better BibTeX #

Installation de Better BibTex #

Better BibTex (https://retorque.re/zotero-better-bibtex/installation/) ajoute à Zotero des fonctionnalités très pratiques :

affichage des clés de citation ;
nouveaux formats d’export ;
exports dynamiques (mises à jour automatiques) de bibliographies.

8. Better BibTeX #

Installez Better BibTeX #

https://retorque.re/zotero-better-bibtex/installation/

9. YAML #

YAML

Un langage de sérialisation de données facilement lisible.
Fonctionne avec d’autres langages de programmation
vs. JSON

10. Prévisualisation et annotation #

Hypothesis
Création d’un compte
Annotations publiques ou dans un groupe privé

11. Module d’export #

https://export.stylo.huma-num.fr/ Ancien : https://stylo-export.ecrituresnumeriques.ca/

12.GrapQL Playground #

Download de l’application
Observation de la plateforme et premières requêtes

HTTP HEADER

{
    "Authorization": "Bearer  API Key.eyJlbWFpbCI6ImdpdWxpYS5mZXJyZXR0aTE5OTVAZ21haWwuY29tIiwiX2lkIjoiNjA1NDg3YjkxZDA2MDAwMDEyMTY3YmQ3IiwiYXV0aFR5cGUiOiJsb2NhbCIsImFkbWluIjpmYWxzZSwic2Vzc2lvbiI6dHJ1ZSwiaWF0IjoxNjc5NDA1MTk2fQ.xmeCU60hVnQG679jdf5_DQ4ssd6UyZfEjw8P11PgLb0"
}

Exemples #

query tousMesArticles {
  user {
    _id
    email

    articles {
      _id
      title
    }
  }
}

query stats {
  stats {
    users {
      total
        local
      openid
      years {year count}
    }
    
    articles {
      total
      years {year count}
    }
  }
}

query singleArticle ($article: ID!) {
  article (article: $article) {
    _id
    title
    
    rename (title: "How Not to Stylo")
  }
}

QUERY VARIABLES :

{"article":"ID"}