1 files changed, 102 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/bibleref-french/bibleref-french-francais.tex b/Master/texmf-dist/doc/latex/bibleref-french/bibleref-french-francais.tex
new file mode 100644
index 00000000000..1f7a67b76f8
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/bibleref-french/bibleref-french-francais.tex
@@ -0,0 +1,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}