Support de présentation (ouvrir en grand) :

Utilisez les flèches ← et → pour naviguer entre les diapositives.

Sommaire

Plan de la séance #

1. Stylo
2. Création d’un compte
3. Tour de plateforme
4. Gestion des articles
5. Gestion des contenus
6. Gestion de la bibliographie
7. BibTeX
8. Better BibTeX
9. YAML
10. Prévisualisation et annotation
11. Module d’export
12. 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

• 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

^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.

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"
  }
  

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")
  }
}

{"article":"ID"}