bibleref-french (12jul11)

git-svn-id: svn://tug.org/texlive/trunk@23261 c570f23f-e606-0410-a88d-b1316a301751

7 files changed, 116 insertions, 24 deletions

diff --git a/Master/texmf-dist/doc/latex/bibleref-french/Lacroux-Bible.pdf b/Master/texmf-dist/doc/latex/bibleref-french/Lacroux-Bible.pdf
new file mode 100644
index 00000000000..efcf5e4af51
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/bibleref-french/Lacroux-Bible.pdf
diff --git a/Master/texmf-dist/doc/latex/bibleref-french/README b/Master/texmf-dist/doc/latex/bibleref-french/README
deleted file mode 100644
index f32723170f6..00000000000
--- a/Master/texmf-dist/doc/latex/bibleref-french/README
+++ /dev/null
@@ -1,21 +0,0 @@
-A french translation of the package BibleRef.
-
-The commands are the same, but the abreviations and the names of the bible books are 
-in french, and the field's separators are like in French (ie. Ex 1, 2 and not Ex 1:2).  A 
-biblerefstyle was defined :"abrege" : print the french shorthands for books.
-
-The list of shorthands of books is joined. 
-
-See the manual of bibleref for commands. 
-
----
-Une traduction française du paquet bibleref.
-
-Les commandes sont les mêmes, mais les abréviations et les noms des livres sont 
-traduits en français, et le séparateurs de champs suivent les conventions françaises (i.e 
-Ex 1, 12 et pas Ex 1:12). Un style bibleref "abrege" a été défini : il imprime les 
-abréviations françaises pour les livres.
-
-La liste des abréviations est jointe. 
-
-Voir le manuel de Bibleref pour les commandes.
diff --git a/Master/texmf-dist/doc/latex/bibleref-french/bibleref-french-francais.pdf b/Master/texmf-dist/doc/latex/bibleref-french/bibleref-french-francais.pdf
new file mode 100644
index 00000000000..9ab8bb406b4
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/bibleref-french/bibleref-french-francais.pdf
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}
diff --git a/Master/texmf-dist/doc/latex/bibleref-french/bibleref-french.pdf b/Master/texmf-dist/doc/latex/bibleref-french/bibleref-french.pdf
new file mode 100644
index 00000000000..d1e510abb5e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/bibleref-french/bibleref-french.pdf
diff --git a/Master/texmf-dist/doc/latex/bibleref-french/shorthands.txt b/Master/texmf-dist/doc/latex/bibleref-french/shorthands.txt
index 77704df5be7..22655166c4c 100644
--- a/Master/texmf-dist/doc/latex/bibleref-french/shorthands.txt
+++ b/Master/texmf-dist/doc/latex/bibleref-french/shorthands.txt
@@ -50,6 +50,7 @@ Lc	Luc
 Jn	Jean
 Mc	Marc
 Ac	Acte
+Rm	Romains
 1Co	1 Corinthiens
 2Co	2 Corinthiens
 Ga	Galates
@@ -70,6 +71,4 @@ Jc	Jacques
 2Jn	2 Jean
 3Jn	3 Jean
 Jude	Jude
-
-Ap	Apocalypse
-Rm	Romains
\ No newline at end of file
+Ap	Apocalypse
\ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/bibleref-french/styles.tex b/Master/texmf-dist/doc/latex/bibleref-french/styles.tex
new file mode 100644
index 00000000000..549f764cf89
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/bibleref-french/styles.tex
@@ -0,0 +1,12 @@
+\begin{tabular}{lp{0.5\textwidth}}
+\bfseries Style & \bfseries Ex\\
+default & \biblerefstyle{default}\bibleverse{IICor}(12:1-5,7) ; \bibleverse{Qo}(1:3)(2:5) ; \bibleverse{Is}(10:)\\
+jerusalem & \biblerefstyle{jerusalem}\bibleverse{IICor}(12:1-5,7) ; \bibleverse{Qo}(1:3)(2:5) ; \bibleverse{Is}(10:)\\
+colombe & \biblerefstyle{colombe}\bibleverse{IICor}(12:1-5,7) ; \bibleverse{Qo}(1:3)(2:5) ; \bibleverse{Is}(10:)\\
+colombefull & \biblerefstyle{colombefull}\bibleverse{IICor}(12:1-5,7) ; \bibleverse{Qo}(1:3)(2:5) ; \bibleverse{Is}(10:)\\
+NBS & \biblerefstyle{NBS}\bibleverse{IICor}(12:1-5,7) ; \bibleverse{Qo}(1:3)(2:5) ; \bibleverse{Is}(10:)\\
+NBSfull & \biblerefstyle{NBSfull}\bibleverse{IICor}(12:1-5,7) ; \bibleverse{Qo}(1:3)(2:5) ; \bibleverse{Is}(10:)\\
+TOB & \biblerefstyle{TOB}\bibleverse{IICor}(12:1-5,7) ; \bibleverse{Qo}(1:3)(2:5) ; \bibleverse{Is}(10:)\\
+TOBfull & \biblerefstyle{TOBfull}\bibleverse{IICor}(12:1-5,7) ; \bibleverse{Qo}(1:3)(2:5) ; \bibleverse{Is}(10:)\\
+text & \biblerefstyle{text}\bibleverse{IICor}(12:1-5,7) ; \bibleverse{Qo}(1:3)(2:5) ; \bibleverse{Is}(10:)\\
+\end{tabular}