summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/bibleref-french/bibleref-french-francais.tex
blob: 1f7a67b76f8a8af6bc4c14f71636f7b739474b6c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
\documentclass{ltxdoc}
\usepackage[utf8]{inputenc} 
\usepackage[french]{babel}
\usepackage[T1]{fontenc}
\usepackage{bibleref-french}
\usepackage[breaklinks=true,unicode=true]{hyperref}


\begin{document}

\shorthandoff{:}
\title{Le package \textsf{bibleref-french}}
\author{Ma\"ieul Rouquette \\ \& \\ Rapha\"el Pinson \\ \texttt{raphink@gmail.com}}

\maketitle
\begin{abstract}
Le  package \textsf{bibleref-french} fournit une traduction français du package \textsf{bibleref}.
\end{abstract}

\section{Utilisation}

Ce package hérite des commandes du package \textsf{bibleref}. Voir la documentation du package \textsf{bibleref} pour l'usage général.

\subsection{Styles additionnels}

\textsf{bibleref-french} ajoute des styles ou en surcharge du package \textsf{bibleref} (comme par exemples les styles \textsf{default}, \textsf{jerusalem} et \textsf{text}.).

Les styles sont notés dans le tableau~\ref{tab:styles}.

\begin{table}[tbh]
\caption{Styles de citation bibliques  (peuvent être utilisés comme options de  packages ou comme argument de  \cs{biblerefstyle})}
\label{tab:styles}
\vspace{10pt}
\begin{center}
\input{styles}
\end{center}
\end{table}

\subsection{Noms catholique ou protestant des livres}

Un livre de l'ancien Testament s'appelle Isaïe chez les catholiques et Esaïe chez les protestants.
Pour cette raison ce package fournit deux options supplémentaires :  \textsf{catholic} (ou \textsf{catholique}) et \textsf{protestant}. 

L'option \textsf{catholic} ne fait habituellement rien, puisque c'est l'option par défaut. Cependant, appeler  \verb!\brfullname@catholic! fournira un résumé de tous les noms catholiques de livres.

Tant \verb|\brfullname@catholic| que \verb|\brfullname@protestant| peuvent être utilisés en remplacement à  \verb|brefullname| dans les définitions de styles pour forcer à utiliser l'un ou l'autre des schémas de nommage.

Notez que le style \verb|TOB| utilise les noms catholiques, sauf pour le libre d'Esaïe qui est surchargé.

Au moment du chargement, le schéma de nommage peut être surchargé pour un style donné. Par exemple le style \verb|jerusalem| utilise \verb|\brfullname@catholic| mais vous pouvez utiliser \verb|\usepackage[jerusalem,protestant]{bibleref-french}| pour avoir le style \verb|jerusalem| avec les livres de la Bible Protestante.

Il en est de même pour \verb|brabbrvname| et les commandes dérivées.

\subsection{Tri des livres dans l'index}

Le package \verb|bibleref| autorise à choisir l'ordre des livres pour générer un index des références bibliques.

Cependant il utilise le nom complet des livres pour les trier, ce qui est problématique en français à cause des accents dans les noms.

Pour résoudre cela, ce package modifie \verb|bibleref| pour utiliser les abréviations à la place des noms complets.
 
En conséquence, \cs{biblerefmap} doit être utilisé avec les \emph{exactes} chaînes de caractères utilisés dans les commandes \cs{ibibleref}. Par exemple, si vous utilisez \verb|\ibibleref{Jn}(3:16)|, vous devrez déclarer \verb|\biblerefmap{Jn}{43}| à la place de \verb|\biblerefmap{Jean}{43}|

\subsection{Espaces insécables}

Le manuel de l'\emph{Imprimerie Nationale} expose que les nombres ne devraient pas être séparés des textes avec lesquelles ils vont. Pour cette raison, ce package utilise des espaces insécables dans les cas suivants :
\begin{itemize}
\item Entre le nombre et le nom quand le nom d'un livre contient un nombre (par ex. 2 Corinthiens) ;
\item Entre le nom du livre et le numéro de chapitre ;
\item Après un tiret demi-cadratin (--) dans un intervalle de versets.

\end{itemize}

Bien que cela soit généralement mieux, cela peut produire des lignes dépassantes en longueur quand une longue référence biblique termine une ligne.
Pour cette raison le package fournit une commande \cs{BRallowhypbch} pour autoriser les fins de ligne entre le nom du livre et le numéro de chapitre dans une référence biblique.
La commande \cs{BRforbidhypbch} restaure les espaces insécables entre le nom du livre et le numéro de chapitre.

Si vous avez besoin de résoudre un dépassement d'une ligne finissante avec un long verset biblique et qu'il n'y a pas d'autres possibilités que d'autoriser la séparation entre le nom du livre et le numéro de chapitre, il est recommandé d'utiliser \cs{BRallowhypbch} dans un environnement qui contient le paragraphe problématique.

\section{Problèmes connus}

\subsection{Noms de livre dans le style  \textsf{text}}

Le style \verb|text| doit être redéfinie pour prendre en considération les spécificités du français. Le tableau~\ref{tab:textspec} liste ces spécificités.

\begin{table}[tbh]
\caption{Spécificités françaises dans les noms de livres, avec les problèmes actuels en emphase} 
\label{tab:textspec}
\vspace{10pt}
\begin{center}
\begin{tabular}{lp{0.5\textwidth}}
\bfseries Anglais & \bfseries Français\\
Book of Genesis & Livre \emph{de la} Gen\`ese\\
Book of Exodus & Livre \emph{de l'}Exode\\
Book of Deuteronomy & Livre \emph{du} Deut\'eronome\\
Book of Numbers & Livre \emph{des} Nombres\\
Book of Acts & Livre \emph{des} Actes des Ap\^otres\\
Book of Revelations & Livre \emph{de l'}Apocalypse\\
\end{tabular}
\end{center}
\end{table}
\end{document}