diff options
Diffstat (limited to 'biblio/bibtex/contrib/francais-bst/README.md')
-rw-r--r-- | biblio/bibtex/contrib/francais-bst/README.md | 174 |
1 files changed, 174 insertions, 0 deletions
diff --git a/biblio/bibtex/contrib/francais-bst/README.md b/biblio/bibtex/contrib/francais-bst/README.md new file mode 100644 index 0000000000..9efba0e990 --- /dev/null +++ b/biblio/bibtex/contrib/francais-bst/README.md @@ -0,0 +1,174 @@ +# Bibliographic styles `francais` and `francaissc` + +The package **francais-bst** provides the bibliography styles +`francais` and `francaissc` to typeset author-year bibliographies +using the French typographic standards outlined in "Guide de la +communication écrite au cégep, à l'université et en entreprise", by +Marie Malo (Québec Amérique, 1996). + +The styles were originally generated using the program `makebst` by +Patrick W. Daly. The master bibliographic style file is heavily based +on `merlin.mbs` from the package **custom-bib**. + +## Licence + +LaTeX Project Public License, version 1.3c or (at your option) any +later version. + +## Version + +2.0 (2023-10-28) + +## Author + +Vincent Goulet <vincent.goulet@act.ulaval.ca> + +## Source code repository + +https://gitlab.com/vigou3/francais-bst + +## Contents + +- `francais-bst.ins`: installation script; see below; +- `francais-bst.mbs`: master bibliographic style and documentation; +- `francais.dbj`, `francaissc.dbj`, `francaisbst.dbj`: driver files + for the bibliographic styles and the language definition file; +- `francais-bst.pdf`: documentation of the styles; +- `README.md`: this file. + +## Installation + +The package **francais-bst** is distributed through the +Comprehensive TeX Archive Network (CTAN) and it is part of the +standard TeX distributions. Therefore, we strongly recommend using +the package manager of your distribution to install or update the +package. + +TeX experts may generate the bibliographic styles and the language +definition file by running the file `francais-bst.ins` through +LaTeX: + + latex francais-bst.ins + +The compilation will create the bibliographic styles (`francais.bst`, +`francaissc.bst`) and the language definition file +(`francaisbst.tex`). These files should ideally be moved into a local +or personal TeX tree as follows: + +``` +$TEXMFHOME/bibtex/bst/francais.bst +$TEXMFHOME/bibtex/bst/francaissc.bst +$TEXMFHOME/tex/latex/francais-bst/francaisbst.tex +``` + +## Documentation + +The file `francais-bst.pdf` contains the documentation of the styles +and the master bibliographic style. You may recreate these documents +from the file `francais-bst.mbs` as follows: + + xelatex francais-bst.mbs + makeindex -s gglo.ist -o francais-bst.gls francais-bst.glo + xelatex francais-bst.mbs + xelatex francais-bst.mbs + +## Version history + +The version history of the class appears in `francais-bst.pdf`. + +## Comments or suggestions + +The Gitlab [project repository](https://gitlab.com/vigou3/francais-bst) +is the best place to report bugs or to propose improvements to the +project. + +====================================================================== + +# Styles bibliographiques `francais` et `francaissc` + +Le paquetage **francais-bst** contient les styles bibliographiques +`francais` et `francaissc` pour composer des bibliographies en +français conformes aux règles de présentation de la méthode +auteur-date proposées dans l'ouvrage de référence de Marie Malo, +«Guide de la communication écrite au cégep, à l'université et en +entreprise» (Québec Amérique, 1996). + +Les styles ont été développé à l'origine à l'aide du programme +`makebst` de Patrick W. Daly. Le fichier maitre de styles +bibliographiques dérive étroitement du fichier `merlin.mbs` du +paquetage **custom-bib**. + +## Licence + +LaTeX Project Public License, version 1.3c ou (à votre choix) toute +version ultérieure. + +## Version + +2.0 (2023-10-28) + +## Auteur + +Vincent Goulet <vincent.goulet@act.ulaval.ca> + +## Dépôt du code source + +https://gitlab.com/vigou3/francais-bst + +## Contenu du paquetage + +- `francais-bst.ins`: procédure d'installation; voir ci-dessous; +- `francais-bst.mbs`: fichier maitre de styles bibliographiques et + documentation; +- `francais.dbj`, `francaissc.dbj`, `francaisbst.dbj`: scripts de + génération des styles bibliographiques et du fichier de localisation + français; +- `francais-bst.pdf`: documentation des styles; +- `README.md`: le présent fichier. + +## Installation + +Le paquetage **francais-bst** est distribué via le réseau de sites +Comprehensive TeX Archive Network (CTAN) et il fait partie des +distributions TeX standards. Par conséquent, nous recommandons +fortement d'installer ou de mettre à jour le paquetage à l'aide du +gestionnaire de paquetages de votre distribution. + +Les experts TeX peuvent générer les styles bibliographiques et le +fichier de localisation français en compilant le fichier +`francais-bst.ins` avec LaTeX: + + latex francais-bst.ins + +La compilation créera les styles de bibliographie (`francais.bst`, +`francaissc.bst`) et le fichier de localisation français +(`francaisbst.tex`). Idéalement, ces fichiers seront ensuite placés +une arborescence TeX locale ou personnelle comme ceci: + +``` +$TEXMFHOME/bibtex/bst/francais.bst +$TEXMFHOME/bibtex/bst/francaissc.bst +$TEXMFHOME/tex/latex/francais-bst/francaisbst.tex +``` + +## Documentation + +Le fichier `francais-bst.pdf` contient la documentation des styles et +du fichier maitre de styles bibliographiques. Utilisez les commandes +suivantes pour recréer le document à partir du fichier +`francais-bst.mbs`: + + xelatex francais-bst.mbs + makeindex -s gglo.ist -o francais-bst.gls francais-bst.glo + xelatex francais-bst.mbs + xelatex francais-bst.mbs + +## Historique des versions + +L'historique des versions se trouve dans `francais-bst.pdf`. + +## Commentaires et suggestions + +Le [dépôt du projet](https://gitlab.com/vigou3/francais-bst) dans +GitLab demeure le meilleur endroit pour rapporter des bogues ou pour +proposer des améliorations au projet. |