From 62482b86cf7dd9d55147049961daedf845c14307 Mon Sep 17 00:00:00 2001 From: Nicolas Sauret Date: Wed, 6 Dec 2023 14:14:01 +0100 Subject: [PATCH 1/2] =?UTF-8?q?ajout=20d'une=20section=20de=20documentatio?= =?UTF-8?q?n=20=E2=86=92=20bibliographie=20cas=20particuliers?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/src/fr/bibliographie.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/docs/src/fr/bibliographie.md b/docs/src/fr/bibliographie.md index 8602d07ab..7ab82ebd5 100644 --- a/docs/src/fr/bibliographie.md +++ b/docs/src/fr/bibliographie.md @@ -95,6 +95,32 @@ Par exemple : **Attention :** il ne faut pas utiliser de syntaxe Markdown en accompagnement d'une citation. Par exemple, il ne faut surtout pas utiliser un balisage de ce type : `[@shirky_here_2008, [lien vers une page web](https://sens-public.org)]` +## Cas particuliers + +### Lettres capitales pour les titres en anglais + +Les styles bibliographiques en anglais requièrent souvent une capitalisation de chaque mot du titre de la référence. Stylo (et Pandoc) vont correctement styler les titres à condition que les références déclarent bien la langue utilisée. + +La langue du document Stylo détermine la langue du style bibliographique par défaut pour toutes les références, sauf pour les références bibliographiques contenant une autre donnée de langue. Par exemple, si la langue déclarée dans les métadonnées du document est `fr`, les références seront traitées comme telles. Si, parmi ces références, l'une est déclarée `en`, alors la capitalisation du titre s'appliquera. + +**Attention :** le format Bibtex intègre plusieurs clés de langue : `language`, `langid`. Stylo (et Pandoc) ne prend en compte que la clé `langid`, alors que l'interface de Zotero ne permet de renseigner que la clé `language` ! Il sera donc nécessaire d'ajouter la clé `langid` directement dans le bibtex (onglet [BibTex brut] dans le gestionnaire bibliographique) pour que la langue de la référence soit correctement prise en compte par Stylo. + +```bibtex +@book{coleman_coding_2013, + address = {Princeton}, + title = {Coding freedom: the ethics and aesthetics of hacking}, + isbn = {978-0-691-14460-3}, + shorttitle = {Coding freedom}, + language = {eng}, + langid = {en}, + publisher = {Princeton University Press}, + author = {Coleman, E. Gabriella}, + year = {2013}, +} +``` + +- Pour en savoir plus : [documentation Pandoc | Capitalization in titles](https://pandoc.org/MANUAL.html#capitalization-in-titles) + ## Quelques ressources - [Qu'est-ce que Zotero ?](http://editorialisation.org/ediwiki/index.php?title=Zotero) From 26898da1f937f99ba1bbb374827cb5351c9b51ac Mon Sep 17 00:00:00 2001 From: Nicolas Sauret Date: Wed, 13 Dec 2023 14:26:29 +0100 Subject: [PATCH 2/2] add tips "section Extra" thanks @loup-brun ! --- docs/src/fr/bibliographie.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/docs/src/fr/bibliographie.md b/docs/src/fr/bibliographie.md index 7ab82ebd5..069d38fd0 100644 --- a/docs/src/fr/bibliographie.md +++ b/docs/src/fr/bibliographie.md @@ -103,7 +103,10 @@ Les styles bibliographiques en anglais requièrent souvent une capitalisation de La langue du document Stylo détermine la langue du style bibliographique par défaut pour toutes les références, sauf pour les références bibliographiques contenant une autre donnée de langue. Par exemple, si la langue déclarée dans les métadonnées du document est `fr`, les références seront traitées comme telles. Si, parmi ces références, l'une est déclarée `en`, alors la capitalisation du titre s'appliquera. -**Attention :** le format Bibtex intègre plusieurs clés de langue : `language`, `langid`. Stylo (et Pandoc) ne prend en compte que la clé `langid`, alors que l'interface de Zotero ne permet de renseigner que la clé `language` ! Il sera donc nécessaire d'ajouter la clé `langid` directement dans le bibtex (onglet [BibTex brut] dans le gestionnaire bibliographique) pour que la langue de la référence soit correctement prise en compte par Stylo. +**Attention :** le format Bibtex intègre plusieurs propriétés de langue : `language`, `langid`. Stylo (et Pandoc) ne prend en compte que la propriété `langid`, alors que l'interface de Zotero ne permet de renseigner que la propriété `language` ! Il sera donc nécessaire d'ajouter manuellement la propriété `langid: en`. Pour cela, deux possibilités : + +1. Soit dans Zotero, utiliser [la section Extra](https://www.zotero.org/support/kb/item_types_and_fields#citing_fields_from_extra) qui permet de renseigner des couples `propriété: valeur` supplémentaire, par exemple dans notre cas : `langid: en`. Après synchronisation Zotero/Stylo, la propriété sera bien prise en compte dans Stylo. +2. Soit dans Stylo, ouvrir l'onglet [Bibtex brut] dans le gestionnaire de bibliographie, et ajouter le couple `langid: en` à la référence concernée. ```bibtex @book{coleman_coding_2013, @@ -119,6 +122,8 @@ La langue du document Stylo détermine la langue du style bibliographique par d } ``` +Notez que la synchronisation Zotero ne fonctionne que dans un sens : les ajouts ou les modifications des références dans l'onglet [Bibtex brut] ne seront pas reportés dans votre collection Zotero. Une nouvelle synchronisation depuis Zotero vers Stylo effacera vos modifications manuelles dans [Bibtex brut]. La première option (section Extra) est donc conseillée. + - Pour en savoir plus : [documentation Pandoc | Capitalization in titles](https://pandoc.org/MANUAL.html#capitalization-in-titles) ## Quelques ressources