diff options
author | Karl Berry <karl@freefriends.org> | 2010-01-01 01:30:46 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2010-01-01 01:30:46 +0000 |
commit | 71b40e8ec749d2bdb93cf522e3dbe5e10ddf8693 (patch) | |
tree | f25f42c276e5e51b984f9695080a5aa8dcdba134 /Master/texmf-dist | |
parent | 190be0f375907ce109add95341d6e9b85c60afba (diff) |
engpron ^^ update from non-tds.zip
git-svn-id: svn://tug.org/texlive/trunk@16558 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist')
-rw-r--r-- | Master/texmf-dist/doc/latex/engpron/engpron-en.ltx | 481 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/engpron/engpron-ex-en.tex | 211 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/engpron/engpron-ex-fr.tex | 215 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/engpron/engpron-fr.ltx | 506 | ||||
-rw-r--r-- | Master/texmf-dist/tex/latex/engpron/engpron-tools.sty | 96 | ||||
-rw-r--r-- | Master/texmf-dist/tex/latex/engpron/engpron.sty | 72 |
6 files changed, 1545 insertions, 36 deletions
diff --git a/Master/texmf-dist/doc/latex/engpron/engpron-en.ltx b/Master/texmf-dist/doc/latex/engpron/engpron-en.ltx new file mode 100644 index 00000000000..5ca14403b12 --- /dev/null +++ b/Master/texmf-dist/doc/latex/engpron/engpron-en.ltx @@ -0,0 +1,481 @@ +%% +%% This is file `engpron-en.ltx', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% engpron.dtx (with options: `doc,en') +%% This is a generated file. +%% +%% Copyright (C) 2003-2008 Y. Henel, le TeXnicien de surface +%% <le.texnicien.de.surface@wanadoo.fr> +%% +%% This file may be distributed and/or modified under the conditions of +%% the LaTeX Project Public License, either version 1.2 of this license +%% or (at your option) any later version. The latest version of this +%% license is in: +%% +%% http://www.latex-project.org/lppl.txt +%% +%% and version 1.2 or later is part of all distributions of LaTeX version +%% 1999/12/01 or later. +\documentclass[a4paper]{article} +\usepackage{xspace,array} +\usepackage[latin1]{inputenc} +\usepackage[tame,hyphenable]{engpron} +\usepackage[T1]{fontenc} +\usepackage[frenchb,english]{babel} +\usepackage{engpron-tools} +\usepackage{makeidx} +\usepackage[colorlinks=true, + linkcolor=blue, + urlcolor=blue, + citecolor=blue]{hyperref} +\makeindex +\begin{document} +\GetFileInfo{engpron.sty} +\newcommand{\GBP}{\texttt{^^a3}\xspace} +\title{The English documentation of the package + \textsf{engpron}\thanks{This document corresponds to the file + \textsf{engpron}~\fileversion, dated \filedate.}} +\author{Le \TeX nicien de surface\\ + \href{mailto:le.texnicien.de.surface@wanadoo.fr}% + {le.texnicien.de.surface@wanadoo.fr}} +\date{\docdate} + +\maketitle + +\begin{abstract} + This package is a tiny handle hardly correctly sewn on the package + |tipa| the author of which, \textsc{Fukui}~Rei, I thank very much. I + also wish to thank T.~\textsc{Lachand-Robert} for his + book~\cite{tlachand}, without which I would far less able than I am + (poorly) nowadays, and Josselin~\textsc{Noirel} for his invaluable + pieces of advice with which he provided me on + \url{fr.comp.text.tex}. + + This new (2) version can use the package \texttt{drac} created by + Josselin~\textsc{Noirel} if the relevant option is choosen as it is + the case by default. + + This package provides macros beginning with the \GBP character, made + active, which enable us to write the British or American English + pronunciation as one can find it in the ``English Pronouncing + Dictionary'' by Daniel~Jones. There is an option to typeset the + pronunciation in the style of the Harrap's~\cite{harraps}. + + I provide a table (page~\pageref{latable}) at the end of this + document in which one could find the macros beginning with a + \texttt{^^a3} and their effect when the options by default + |monstress| and |jones| are enforced. +\end{abstract} + +\tableofcontents + +\section{Usage} + +This package loads \Pkg{tipa}, with which one can write with the +API\footnote{Alphabet Phon^^e9tique International} through \LaTeX. It +provides some macros which enable one to typeset the British or +American English pronunciation \emph{^^e0 la} +\textsc{Jones}~\cite{jones15} (default) or as +\textsc{Harrap}~\cite{harraps} with the package option +\Option{harraps}. + +The \Pkg{drac} package is used by default to make of \GBP a robust (in +\LaTeX\ parlance) active character. + +\subsection{The Package and its Options} + +Here come the options of \Pkg{engpron}. You can load +\Pkg{engpron} with +e.~g.\ \cs{usepackage}|[|\BOP|wild|\BOP|]|\BOP|{|\BOP|engpron|\BOP|}|. + +I have tried to group the options according to their effect. + +\subsubsection{\GBP's Behaviour} + +By default or with the option \Option{wild} this package makes the +\DescribeOption{wild} +character \GBP active et redefines it to enable the definition of +macros such as |^^a3a| and their usage in all the text. It also enables +us to obtain a uniform presentation of the pronunciation with the +macro \cs{pron}\marg{text in API}. +If you prefer, you can chose the option \Option{tame} which +reestablish the character \GBP in its usual category in the +\DescribeOption{tame} +encoding given by |fontenc|\oarg{T1} i.~e.\ makes it active and makes +it print the symbol of the pound. You will have to use either the +macro \cs{Pron}\marg{text in API} or \cs{PRON}\marg{text in API} \TO and +thus obtain the presentation ensured by \cs{pron}\TF or the +environment |LivreActive| in which \GBP is active. + +By default or explicitly with option \Option{drac} this package +\DescribeOption{drac} +uses the \Pkg{drac} package to turn \GBP into a \emph{robust} active +character where \emph{robust} has the meaning it has in the context of +\LaTeX{} moving arguments. +\DescribeOption{nodrac} +The opposite option is \Option{nodrac} with which \Pkg{drac} is not +loaded and \GBP keeps the definition given in the version~1. + +\subsubsection{The Look of the Text} + +By default \Pkg{engpron} enforces the option \Option{jones} and so +\DescribeOption{jones} gives the presentation of the final ``r'' +\PRON{a^^a3Z} and of the optional sounds according to~\cite{jones15}. You +then obtain \PRON{n^^a3Xen} for the ``schwa \Pron{^^a3e}'' and +\PRON{a^^a3Xt^^a3sa} for optional ``t''. + +There is also the option \Option{harraps} which then gives the +presentation \DescribeOption{harraps}\label{harrapsrfin} which you +find in~\cite{harraps}: the optional sounds are given in parenthesis +and the final ``r'' looks like this \textsl{r}. Moreover +\pron{\textsl{o}} denotes what Jones~\cite{jones15} writes \PRON{^^a3w}. + +\subsubsection{The Syllable Divisions and the Stresses} + +The package offers many options supporting the syllable division. With +option \Option{hyphenable} you allow \LaTeX\ to cut\index{hyphenation} +words on the explicit marks of syllable division\index{syllable + division} \TO see below |^^a3k|, page~\pageref{livrek} \TF and on the +marks of primary or secondary stresses\index{stress} \TO |^^a3b|, |^^a3B|, +|^^a3h| et |^^a3H|. In such a case I will say that the marks of syllable +divisions and of stresses ar \emph{cuttable}\index{cuttable}. + +With the option \Option{unhyphenable} you forbid the cutting of words +on those marks. Those marks are then said to be +\emph{uncuttable}\index{uncuttable}. \DescribeOption{unhyphenable} To +keep the behaviour of the preceding version, the option +\Option{unhyphenable} is the default. + +\vspace{\baselineskip} + +You can chose between option \Option{visible} and option +\DescribeOption{visible} \Option{invisible}. With the first, +\Option{visible}, the macro of syllable division |^^a3k| produces a glyph +which is defined by \cs{EPSyllabeMarque} \TO macro that you can +redefine with \cs{renewcommand} and which by default gives a plain +dot. When you enforce option \Option{invisible}, the macro |^^a3k| +produces no glyph but is un\slash cuttable according to the chosen +option between \Option{hyphenable} and \Option{unhyphenable}. + +\vspace{\baselineskip} + +\Pkg{engpron} offers two other options: \Option{monstress} which is +\DescribeOption{monstress} the default and \Option{tipastress}. They +are mutually exclusive and set the glyphs which present the primary +and secondary stresses. The \DescribeOption{tipastress} user can +redefine with \cs{renewcommand} the macros used by default \TO +\cs{EPaccentprincipal} and \cs{EPaccentsecondaire}\TF and thus replace +the default glyphs I provide. With the first, and default, option you +obtain \Pron{^^a3h} and \Pron{^^a3b} as glyphs of primary and secondary +stress respectively; with the second option you obtain +\textprimstress{} and \textsecstress{} respectively, glyphs provided +by \Pkg{tipa}. + +\subsubsection{Draft and Error} + +Some macros, \emph{viz.} |^^a3K|, |^^a3m|, and |^^a3M|, await a letter to +\DescribeOption{final} determine what they have to do. However all the +letters are not suitable. With option \Option{final} which is the +opposite of \DescribeOption{draft} \Option{draft} \Pkg{engpron} +doesn't produce anything in the document but emits a warning you can +find in the |.log| file if you \DescribeOption{nice} have choosen +option \Option{nice} or stops on an error if option +\DescribeOption{tough} \Option{tough} is enforced. With option +\Option{draft} you can read, in the document, the following +``message'' \texttt{\string?\string!<*>\string!\string?} where +\texttt{*} plays here the role of the \emph{erroneous} character. + +\subsubsection{Summary of Available Options} + +To sum it up: +\nopagebreak{}\par\nopagebreak{} +\noindent +\begin{tabular}{*{2}{>{\scshape}l} l} + \multicolumn{1}{l}{The default option} & + \multicolumn{1}{l}{and the opposite option} & + act on\\ + wild & tame & active status of \GBP\\ + drac & nodrac & robustness of \GBP\\ + jones & harraps & notation of the pronunciation\\ + monstress & tipastress & notation of stresses\\ + unhyphenable & hyphenable & creation of discretionary break\\ + visible & invisible & visibility of syllable divisions\\ + \multicolumn{3}{l}{\emph{In case of an error with} \texttt{^^a3K}, + \texttt{^^a3M}, \emph{or} \texttt{^^a3m}}\\ + final & draft & written trace in the doc \\ + nice & tough & \TeX\ warning or error +\end{tabular} + +\subsection{The \GBP Macros} +\label{sec:macrospound} + +I will now present the macros the name of which begins with \GBP. + +To create these macros I used once again the book~\cite{tlachand} by +T.~\textsc{Lachand-Robert}. It's from its example of macros using |^^a7| +to write greek letters that came the idea of doing something on the +same line to denote the pronunciation of English words. I needed that +then for I was teaching maths in English to French pupils in ``Euro'' +section. I found bits every now and then which gave me the means of +creating macros such as \cs{EP@haut}. + +In this section I present just some of the macros which are all given +in the table on page~\pageref{latable}. + +\subsubsection{The Stress Marks} + +You will obtain the stress marks \TO as defined by the option +\DescribePoundMacro{h} +\Option{tipastress} or \Option{monstress}\TF with, for the primary +\DescribePoundMacro{H} +stress |^^a3h| or |^^a3H| and for the secondary stress with |^^a3b| or |^^a3B|. +\DescribePoundMacro{b} +\DescribePoundMacro{b} The ``rationale'' for them are, in French, |h| for +\DescribePoundMacro{B} +\emph{haut} and |b| for \emph{bas} but I think it is safe to think to +\emph{high} and \emph{below}. + +\NOUVEAU{From version~2, when option \Option{hyphenable} have been + chosen these stress marks are cuttable i.~e.\ they give \TeX\ + discretionary breaks.} + +\subsubsection{Syllable Division} + +\NOUVEAU{What pertains to syllable division, i.~e.\ marking the limits + of the syllables, is introduced in version~2 of the package.} + +You may want, or need, to show the limits of the syllables of words as +\DescribeMacro{EPSyllabeCoupure} +you can see it in the Jones~\cite{jones15}. To this effect, the +package provides one macro \cs{EPSyllabeCoupure} linked to the +|^^a3k|~macro.\label{livrek} Its behaviour is controlled by the following +pairs of opposite options: \Option{hyphenable}\slash +\Option{unhyphenable} and \Option{visible}\slash +\Option{invisible}. With \Option{hyphenable} the macro gives \TeX\ a +discretionary break which it doesn't with option +\Option{unhyphenable}. With option \Option{visible} |^^a3k| produces the +\DescribeMacro{EPSyllabeMarque} +glyph determined by \cs{EPSyllabeMarque} whereas with +\Option{invisible} it produces nothing. + +By default, \cs{EPSyllabeMarque} is equal to a period (full stop). You +should take care of the fact that, for \cs{EPSyllabeMarque} is an +argument of \cs{discretionary}, it suffers some restrictions such as +e.~g.\ to not contain maths. + +Whatever are the enforced options, you can always give \TeX\ a +\DescribePoundMacro{KX} discretionary break with |^^a3KX| which doesn't +produce any glyph so |^^a3KX| is cuttable and invisible. With |^^a3KB| and +|^^a3KH| you get \DescribePoundMacro{KB}\DescribePoundMacro{KH} +respectively primary and secondary \emph{cuttable} stress marks. With +|^^a3Kk| you get an always \emph{visible} and \emph{uncuttable} syllable +division mark. Lastly |^^a3KK| \DescribePoundMacro{KK} produces an always +visible and cuttable syllable division mark. The look of the marks is +as a matter of course set by \cs{EPSyllabeMarque}. You will have +remarked that lower case letters are linked to \emph{uncuttable} marks +and upper case letters to \emph{cuttable} ones. I have feel no urge to +provide a |^^a3Kx| which would have done strictly nothing, I tend to +believe that then a void string is largely enough. + +\subsubsection{Optional Sounds} + +To note optional sounds \DescribePoundMacro{X} you will use the |^^a3X| +macro as in |^^a3X|\meta{one letter} for |^^a3X| \textbf{must} be followed +by \textbf{a single letter}. The macro doesn't work if followed by a +group. It normally can deal with the optional sounds of the English +language. It makes the difference, when option \Option{jones} is +enforced, between the letter ``e'' which gives \PRON{^^a3Xe} and the +others such as ``t'' which gives \PRON{^^a3Xt} with |^^a3Xe| and |^^a3Xt| +respectively. + +To denote the final and \TO to use Jones' term\TF potential ``r'' +which is pronounced, in British English, when followed by a word +beginning by a vowel, you will use \DescribePoundMacro{Z} |^^a3Z| which is +redefined when option \Option{harraps} is chosen, +see~\ref{harrapsrfin}. + +\subsection{Other Macros and one Environment} + \label{sec:autresmacros} + +I give the user an easy access to some macros which enable us to set +some details of presentation. You can redefine them with +\cs{renewcommand} and so doing obtain your own style. + +As already said above \TO see \Option{monstress} \TF the macros +\cs{EPaccentprincipal} and \cs{EPaccentsecondaire} define the glyphs +obtained with |^^a3H| and |^^a3B| respectively. + +\NOUVEAU{Since version~2} the \cs{EPAccentCoupure} macro set the +\DescribeMacro{EPAccentCoupure} +behaviour of the stress marks when there is a break. The default is to +keep the stress mark with the text which begins the new line +i.~e.\ \Pron{^^a3Bh^^a3p^^a3kf^^a3Xen^^a3H^^a3q^^a3k^^a3s^^a3Xen} is cut, if necessary, as +\Pron{^^a3Bh^^a3p^^a3kf^^a3Xen}\verb+|+\Pron{^^a3H^^a3q^^a3k^^a3s^^a3Xen}. + +\NOUVEAU{Since version~2} the \cs{EPSyllabeMarque} set the mark for +syllable division and \cs{EPSyllabe}\BOP|Coupure| defines the +behaviour of \DescribeMacro{EPSyllabeCoupure} the mark in case of +break. Default is to keep the mark at the end of the line so +\Pron{^^a3Hh^^a3p^^a3kf^^a3Xen} is cut in \Pron{^^a3Hh^^a3p^^a3k}\verb+|+\Pron{f^^a3Xen}. + +The macros \cs{EPouvrante} (\emph{opening}) and \cs{EPfermante} +(\emph{closing}) define \DescribeMacro{EPouvrante} what precedes and +follows the pronunciation. The macro \cs{EPtextestyle} defines the +style of the \DescribeMacro{EPfermante} text of the pronunciation. By +default, the first two macros give \EPouvrante{} and +\EPfermante{}; \DescribeMacro{EPtextestyle} \cs{EPtextestyle} is +defined as |\rmfamily\upshape|. + +In what follows I will write that ``the pound is +active''\index{pound!active} to mean that the +character \GBP is active and \textbf{is not} defined to produce the +glyph of the pound sterling but to give the macro beginning with +\GBP. In all other cases I will write that ``the pound is +inactive''\index{pound!inactive}. + +Those three macros are used by \cs{pron} and \cs{PRON} to produce a +\DescribeMacro{pron} uniform presentation whatever the contexte and +the activity of the pound. The macro \cs{pron}\marg{text} produces a +presentation of the pronunciation as you can find it usually after a +word in a text. You will use it when ``the pound is +active\index{pound!active}.'' You will then write |\pron{ma^^a3i}| to +obtain \PRON{ma^^a3i}. + +When ``the pound is inactive\index{pound!inactive}'' you will use +\DescribeMacro{PRON} \cs{PRON}\marg{text} to obtain the same +result. In fact as in this document I've loaded the package +\Pkg{engpron} with option \Option{tame} I've obtained, in the +preceding paragraph, \PRON{ma^^a3i} with |\PRON{ma^^a3i}|. And now I've said +it all! + +Lastly when the pound is inactive\index{pound!inactive}, +\cs{Pron}\marg{text} give the means of enter API without the +presentation given by \cs{pron}. With |\Pron{^^a3Hf^^a3in^^a3k^^a3i^^a3kg^^a3en}| you +will simply obtain \Pron{^^a3Hf^^a3in^^a3k^^a3i^^a3kg^^a3en} without ``decoration.'' + +The macro \cs{ActiveLaLivre} \DescribeMacro{ActiveLaLivre} makes the +pound active\index{pound!active}, it is used by \cs{Pron}, \cs{PRON}, +and the following environment. You can use it for example in a array +\TO with the package \Pkg{array}\TF to make the pound active in a +column. + + + +\vspace{\baselineskip} + +\NOUVEAU{To conclude}, with the antagonistic macros +\DescribeMacro{MakeHyphenable} \cs{MakeHyphenable}\slash +\cs{MakeUnHyphenable} you can thwart the effect of options +\Option{hyphenable}\slash\Option{unhyphenable} +\DescribeMacro{MakeUnHyphenable}\index{hyphenation}. + +\cs{MakeHyphenable} redefines the macros linked to |^^a3H|, |^^a3h|, |^^a3B|, +|^^a3b|, and |^^a3k|\index{stress}\index{syllable division} in order that +they produce cuttable\index{mark!cuttable}\index{cuttable} +marks. \cs{MakeUnHyphenable} redefines them to obtain uncuttable +marks\index{mark!uncuttable}\index{uncuttable}. The +visibility\index{mark!visibility}\index{visibility} of |^^a3k| is not +modified. + +Other pair of opposite macros: \DescribeMacro{MakeVisible} +\cs{MakeVisible}\slash\cs{MakeInVisible}. The macro +\cs{Make}\BOP|Vi|\BOP|sible| redefines the macro linked to +|^^a3k|\index{syllable division}\index{visibility} to make it produce +visible marks\index{mark!visible}, \cs{MakeInVisible} does the +opposite\index{mark!invisible}\DescribeMacro{MakeInVisible}. The +cuttability\index{cuttability} of |^^a3k| is not modified. + +\subsection{Conclusion} +\label{sec:conclusion} + +You will notice, if you look at the table~\ref{latable} or the code of +this package, that there remain place to define other macros using +an active pound. + +First of all some letters are not used and e.~g.\ |^^a3S| does nothing. On +the other hand, you can define other macros with more than one letter +behind \GBP but you will have to type |^^a3{aeiou}| to use a macro the +true name of which would be |\^^a3aeiou|. I do believe it should be kept +for macros with a substantial effect \Sourire. + +As a conclusion, I will freely admit that the chosen code is not +necessarily optimal. Actually, I have made it along in view of my +needs and I cannot say that there is a general rule for +organization. Nevertheless you will be able to notice some efforts +made towards systematization. + +You should feel free to make changes you want as long as \TO in accord +with the license under which this package is made available\TF you +change its name. You can, if you prefer, ask for modification and I +will try to make it according to your requirement if feasible but I +make \textbf{no} promise to be quick and clever. + +\begin{thebibliography}{99} +\addcontentsline{toc}{section}{Bibliography} +\bibitem{jones15} Daniel~\textsc{Jones} \dag. +\emph{English Pronouncing Dictionary}. +15th Edition. This major new edition edited by Peter Roach \& James +Hartman. +Cambridge University Press, \oldstylenums{1997}.\\ +\textsc{isbn} : \texttt{0-521-45903-6} +\bibitem{jones} Daniel~\textsc{Jones} \dag. +\emph{English Pronouncing Dictionary}. +Cambridge University Press, \oldstylenums{1991}. +\bibitem{tlachand} T.~\textsc{Lachand-Robert}. +\emph{La ma^^eetrise de \TeX{} et \LaTeX{}}. +Masson, Paris, Milan, Barcelone, \oldstylenums{1995}.\\ +\textsc{isbn} : \texttt{2-225-84832-7}. +\bibitem{harraps} J. E. \textsc{Manson}, M.A. +\emph{Harrap's New Shorter French And English Dictionary.} +Revised edition \copyright{} George G. Harrap \& +Co. Ltd. \oldstylenums{1967}. +Bordas diffuseur, \oldstylenums{1980}.\\ +\textsc{isbn} : \texttt{0 245 59062 5} +\end{thebibliography} + +\newpage + +\section{Table of the \GBP Macros} + +\thispagestyle{empty}{\LARGE +\vspace*{\stretch{1}} +\begin{LivreActive} +\noindent +\begin{tabular}[l]{|>{\ttfamily }c|>{\ActiveLaLivre }c||>{\ttfamily +}c|c||>{\ttfamily }c|c||>{\ttfamily}c|c|}\hline +\multicolumn{8}{|c|}{Vowels}\\ \hline +\^^a3a & ^^a3a & \^^a3A & ^^a3A & \^^a3e & ^^a3e & \^^a3E & ^^a3E \\ \hline +\^^a3i & ^^a3i & \^^a3I & ^^a3I & \^^a3o & ^^a3o & \^^a3O & ^^a3O \\ \hline +\^^a3u & ^^a3u & \^^a3U & ^^a3U & \^^a3v & ^^a3v & \^^a3x & ^^a3x \\ \hline +\^^a3c & ^^a3c & \^^a3C & ^^a3C & \^^a3y & ^^a3y & & \\ \hline +\multicolumn{8}{|c|}{Diphthongs}\\ \hline +\^^a3p & ^^a3p & \^^a3q & ^^a3q & \^^a3r & ^^a3r & \^^a3P & ^^a3P\\ \hline +\^^a3Q & ^^a3Q & \^^a3R & ^^a3R & \^^a3w & ^^a3w & \^^a3W & ^^a3W\\ \hline +\^^a3V & ^^a3V & & & & & & \\ \hline +\multicolumn{8}{|c|}{Consonants}\\ \hline +\^^a3d & ^^a3d & \^^a3f & ^^a3f & \^^a3j & ^^a3j & \^^a3l & ^^a3l \\ \hline +\^^a3n & ^^a3n & \^^a3s & ^^a3s & \^^a3t & ^^a3t & \^^a3z & ^^a3z \\ \hline +\^^a3T & ^^a3T & \^^a3L & ^^a3L & & & & \\ \hline +\multicolumn{8}{|c|}{Stresses}\\ \hline +\^^a3b & ^^a3b & \^^a3B & ^^a3B & \^^a3h & ^^a3h & \^^a3H & ^^a3H \\ \hline +\^^a3Kb & ^^a3Kb & \^^a3KB & ^^a3KB & \^^a3Kh & ^^a3Kh & \^^a3KH & ^^a3KH \\ \hline +\multicolumn{8}{|c|}{Syllable division}\\ \hline +\^^a3k & ^^a3k & \^^a3Kk & ^^a3Kk & \^^a3KK & ^^a3KK & \^^a3KX & ^^a3KX \\ \hline +\multicolumn{8}{|c|}{French nasalised vowels}\\ +\multicolumn{8}{|c|}{French pronunciation}\\ \hline +\^^a3Ma & ^^a3Ma & \^^a3Mi & ^^a3Mi & \^^a3Mo & ^^a3Mo & \^^a3Mu & ^^a3Mu \\ \hline +\multicolumn{8}{|c|}{English pronunciation}\\ \hline +\^^a3ma & ^^a3ma & \^^a3mi & ^^a3mi & \^^a3mo & ^^a3mo & \^^a3mu & ^^a3mu \\ \hline +\end{tabular}\label{latable} +\end{LivreActive} +\vspace*{\stretch{1}} +} + +\printindex +\end{document} +\endinput +%% +%% End of file `engpron-en.ltx'. diff --git a/Master/texmf-dist/doc/latex/engpron/engpron-ex-en.tex b/Master/texmf-dist/doc/latex/engpron/engpron-ex-en.tex new file mode 100644 index 00000000000..addeaec741b --- /dev/null +++ b/Master/texmf-dist/doc/latex/engpron/engpron-ex-en.tex @@ -0,0 +1,211 @@ +%% +%% This is file `engpron-ex-en.tex', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% engpron.dtx (with options: `exemple,en') +%% This is a generated file. +%% +%% Copyright (C) 2003-2008 Y. Henel, le TeXnicien de surface +%% <le.texnicien.de.surface@wanadoo.fr> +%% +%% This file may be distributed and/or modified under the conditions of +%% the LaTeX Project Public License, either version 1.2 of this license +%% or (at your option) any later version. The latest version of this +%% license is in: +%% +%% http://www.latex-project.org/lppl.txt +%% +%% and version 1.2 or later is part of all distributions of LaTeX version +%% 1999/12/01 or later. +\documentclass[a4paper]{article} +\usepackage{array,xspace} +\usepackage[latin1]{inputenc} +\usepackage[tame,hyphenable]{engpron}[2008/08/15] +\usepackage[T1]{fontenc} +\usepackage{lmodern} +\usepackage[frenchb, english]{babel} +\setlength{\parindent}{0pt} +\newcommand\BOP{\discretionary{}{}{}} +\newcommand{\TO}{\textemdash\ \ignorespaces} +\newcommand{\TF}{\unskip\ \textemdash\xspace} +\newcommand\Pkg[1]{\textsf{#1}} +\newcommand\Option[1]{\textsc{#1}} +\begin{document} +\begin{center}\LARGE + Usage of the \Pkg{engpron} package +\end{center} +Here are some examples of the usage of the \texttt{^^a3}-macros. The +\verb+engpron+ package is loaded whith the options \Option{jones}, +\Option{monstress}, \Option{unhyphenable}, \Option{visible}, +\Option{nice}, and \Option{final} \TO default options\TF and the +explicit option \Option{tame} which replaces the default option +\Option{wild}. +\paragraph{The \texttt{^^a3X} macro} This macro \emph{must} be +followed by a single letter. It notes the optional sounds the way +Jones~\cite{jones15} does if option \Option{jones} has been chosen, +or, the Harraps~\cite{harraps} does if option \Option{harraps} has +been chosen. + +One would type for example +\verb!\PRON{!\texttt{^^a3e^^a3h^^a3Xt^^a3s^^a3U^^a3kli^^a3k^^a3en}\verb!}! +to obtain \PRON{^^a3e^^a3h^^a3Xt^^a3s^^a3U^^a3kli^^a3k^^a3en}. + +Followed by the letter `e' it gives \Pron{^^a3Xe} +(\verb+\Pron{^^a3Xe}+) as in \PRON{^^a3B^^a3af^^a3kek^^a3Ht^^a3q^^a3k^^a3s^^a3Xen} one can +obtain with \verb+\PRON{^^a3B^^a3af^^a3kek^^a3Ht^^a3q^^a3k^^a3s^^a3Xen}+. +\paragraph{\texttt{^^a3M} and \texttt{^^a3m} macros} They give the French +nasalised vowels, French way for the 1rst one and English way for the +2nd. See the 2nd table. They must be followed by one of the following +letters: a, i, o, u. One may think to the French +`restaur\textbf{ant}', `v\textbf{in}', `b\textbf{on} march^^e9', +`Verd\textbf{un}'. +\paragraph{Macro \texttt{^^a3Z}} It notes the final `r' which is only +pronunced when followed by a vowel. One has e.g. \Pron{^^a3H^^a3akt^^a3e^^a3Z} with +\verb+\Pron{^^a3H^^a3akt^^a3e^^a3Z}+. +\paragraph{Macro \texttt{^^a3k}} Its beheviour is controlled by the +options \Option{hyphenable} \TO which is the contrary of +\Option{unhyphenable}\TF and \Option{visible} \TO contrary of +\Option{invisible}. It is used to mark the syllable limits. + +With the default option \Option{visible} it produces a glyph which is +by default [.] and defined by the macro +\verb+\EPSyllabeMarque+. This macro can be redefined with a +\verb+\renewcommand+ if necessary. With option \Option{invisible} \verb+^^a3k+ +doesn't produce any glyph. + +With option \Option{hyphenable} \verb+^^a3k+ allows a break but prevent it +with \Option{unhyphenable} which is the default. +\paragraph{Macro \texttt{^^a3K}} Its behaviour is determined by the +following letter. \texttt{X} gives an invisible breakable point, +\texttt{k} a visible unbreakable mark of syllable limit, \texttt{K} a +visible \emph{breakable} mark of syllable limit, \texttt{b} an +unbreakable mark of secondary stress, \texttt{B} a \emph{breakable} +mark of secondary stress, \texttt{h} an unbreakable mark of primary +stress, and, avant last, \texttt{H} a \emph{breakable} mark of primary +stress. Its behaviour \textbf{doesn't depend} on the enforced options. +\vspace*{\stretch{1}} + +\begin{thebibliography}{99} +\bibitem{jones15} Daniel~\textsc{Jones} \dag. +\emph{English Pronouncing Dictionary}. +15th Edition. This major new edition edited by Peter Roach \& James +Hartman. +Cambridge University Press, 1997. +\textsc{isbn} : \texttt{0-521-45903-6} +\bibitem{harraps} J. E. \textsc{Manson}, M.A. +\emph{Harrap's New Shorter French And English Dictionary.} +Revised edition \copyright{} George G. Harrap \& +Co. Ltd. \oldstylenums{1967}. +Bordas diffuseur, \oldstylenums{1980}. +\textsc{isbn} : \texttt{0 245 59062 5} +\end{thebibliography} +\newpage + +\vspace*{\stretch{1}} + +\begin{LivreActive}\Large +\hspace*{\stretch{1}} +\begin{tabular}[c]{|>{\ttfamily }c|c||>{\ttfamily }c|c||>{\ttfamily + }c|c||>{\ttfamily }c|c||>{\ttfamily }c|c|}\hline +\multicolumn{10}{|c|}{ +The macros in alphabetic order +}\\ +\multicolumn{10}{|c|}{ +The star refers to the preceding explanations +}\\ \hline +\^^a3a & ^^a3a & \^^a3b & ^^a3b & \^^a3c & ^^a3c & \^^a3d & ^^a3d & \^^a3e & ^^a3e \\ \hline +\^^a3f & ^^a3f & \^^a3g & ^^a3g & \^^a3h & ^^a3h & \^^a3i & ^^a3i & \^^a3j & ^^a3j \\ \hline +\^^a3k & $\ast$ & \^^a3l & ^^a3l & \^^a3m & $\ast$ & \^^a3n & ^^a3n & \^^a3o & ^^a3o \\ \hline +\^^a3p & ^^a3p & \^^a3q & ^^a3q & \^^a3r & ^^a3r & \^^a3s & ^^a3s & \^^a3t & ^^a3t \\ \hline +\^^a3u & ^^a3u & \^^a3v & ^^a3v & \^^a3w & ^^a3w & \^^a3x & ^^a3x & \^^a3y & ^^a3y \\ \hline +\^^a3z & ^^a3z & & & & & & & & \\ \hline +\^^a3A & ^^a3A & \^^a3B & ^^a3B & \^^a3C & ^^a3C & \^^a3D & ^^a3D & \^^a3E & ^^a3E \\ \hline +\^^a3F & ^^a3F & \^^a3G & ^^a3G & \^^a3H & ^^a3H & \^^a3I & ^^a3I & \^^a3J & ^^a3J \\ \hline +\^^a3K & $\ast$ & \^^a3L & ^^a3L & \^^a3M & $\ast$ & \^^a3N & ^^a3N & \^^a3O & ^^a3O \\ \hline +\^^a3P & ^^a3P & \^^a3Q & ^^a3Q & \^^a3R & ^^a3R & \^^a3S & ^^a3S & \^^a3T & ^^a3T \\ \hline +\^^a3U & ^^a3U & \^^a3V & ^^a3V & \^^a3W & ^^a3W & \^^a3X & $\ast$ & \^^a3Y & ^^a3Y \\ \hline +\^^a3Z & ^^a3Z & & & & & & & & \\ \hline +\end{tabular} +\hspace*{\stretch{1}} +\end{LivreActive} + +\vspace*{\stretch{1}} +\newpage +\thispagestyle{empty} + +\vspace*{\stretch{1}} +\begin{LivreActive} +\hspace*{\stretch{1}} +{\Large +\begin{tabular}[c]{|>{\ttfamily }c|c||>{\ttfamily }c|c||>{\ttfamily + }c|c||>{\ttfamily }c|c|}\hline +\multicolumn{8}{|c|}{ +Vowels +}\\ \hline +\^^a3a & ^^a3a & \^^a3A & ^^a3A & \^^a3e & ^^a3e & \^^a3E & ^^a3E \\ \hline +\^^a3i & ^^a3i & \^^a3I & ^^a3I & \^^a3o & ^^a3o & \^^a3O & ^^a3O \\ \hline +\^^a3u & ^^a3u & \^^a3U & ^^a3U & \^^a3v & ^^a3v & \^^a3x & ^^a3x \\ \hline +\^^a3c & ^^a3c & \^^a3C & ^^a3C & \^^a3y & ^^a3y & & \\ \hline +\multicolumn{8}{|c|}{ +Diphtongs +}\\ \hline +\^^a3p & ^^a3p & \^^a3q & ^^a3q & \^^a3r & ^^a3r & \^^a3P & ^^a3P\\ \hline +\^^a3Q & ^^a3Q & \^^a3R & ^^a3R & \^^a3w & ^^a3w & \^^a3W & ^^a3W\\ \hline +\^^a3V & ^^a3V & & & & & & \\ \hline +\multicolumn{8}{|c|}{ +Consonants +}\\ \hline +\^^a3d & ^^a3d & \^^a3f & ^^a3f & \^^a3j & ^^a3j & \^^a3l & ^^a3l \\ \hline +\^^a3n & ^^a3n & \^^a3s & ^^a3s & \^^a3t & ^^a3t & \^^a3z & ^^a3z \\ \hline +\^^a3T & ^^a3T & \^^a3L & ^^a3L & & & & \\ \hline +\multicolumn{8}{|c|}{ +Stress +}\\ \hline +\^^a3b & ^^a3b & \^^a3B & ^^a3B & \^^a3h & ^^a3h & \^^a3H & ^^a3H \\ \hline +\^^a3Kb & ^^a3Kb & \^^a3KB & ^^a3KB & \^^a3Kh & ^^a3Kh & \^^a3KH & ^^a3KH \\ \hline +\multicolumn{8}{|c|}{ +Nasalised vowels +}\\ +\multicolumn{8}{|c|}{ +French pronunciation +}\\ \hline +\^^a3Ma & ^^a3Ma & \^^a3Mi & ^^a3Mi & \^^a3Mo & ^^a3Mo & \^^a3Mu & ^^a3Mu \\ \hline +\multicolumn{8}{|c|}{ +English pronunciation +}\\ \hline +\^^a3ma & ^^a3ma & \^^a3mi & ^^a3mi & \^^a3mo & ^^a3mo & \^^a3mu & ^^a3mu \\ \hline +\multicolumn{8}{|c|}{ +Syllables marking +}\\ \hline +\^^a3k & ^^a3k & \^^a3Kk & ^^a3Kk & \^^a3KK & ^^a3KK & \^^a3KX& ^^a3KX\\ \hline +\end{tabular}} +\hspace*{\stretch{1}} +\vspace*{\stretch{4}} + +{\footnotesize +The preceding table is written in a \verb+LivreActive+-environment and +one must use the \verb+\+\texttt{\^^a3}-macro to obtain the character +\^^a3. But one can type `^^a3a' with a straightforward `\texttt{\^^a3a}'. + +Inside a \verb+LivreActive+-environment, one obtains \pron{^^a3H^^a3akt^^a3e^^a3Z} +with \verb+\pron{+\texttt{\^^a3H}\BOP\texttt{\^^a3akt}\BOP\texttt{\^^a3e}\BOP% +\texttt{\^^a3Z}\verb+}+ but one will notice by reading the present +\texttt{engpron-ex-en.tex} file what is required to obtain a semblance of +\texttt{verbatim}. +} + +\vspace{2\baselineskip} +\newlength{\montruc}\settowidth{\montruc}{Yvon \textsc{Henel}, \TeX + nicien de surface.} +\hspace*{\stretch{1}}\makebox[\montruc][c]{Yvon \textsc{Henel}, \TeX + nicien de surface.}\\[.5\baselineskip] +\hspace*{\stretch{1}}\makebox[\montruc][c]{2008-07-15} + +\vspace*{\stretch{1}} +\end{LivreActive} +\end{document} +\endinput +%% +%% End of file `engpron-ex-en.tex'. diff --git a/Master/texmf-dist/doc/latex/engpron/engpron-ex-fr.tex b/Master/texmf-dist/doc/latex/engpron/engpron-ex-fr.tex new file mode 100644 index 00000000000..d48f4a369bf --- /dev/null +++ b/Master/texmf-dist/doc/latex/engpron/engpron-ex-fr.tex @@ -0,0 +1,215 @@ +%% +%% This is file `engpron-ex-fr.tex', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% engpron.dtx (with options: `exemple,fr') +%% This is a generated file. +%% +%% Copyright (C) 2003-2008 Y. Henel, le TeXnicien de surface +%% <le.texnicien.de.surface@wanadoo.fr> +%% +%% This file may be distributed and/or modified under the conditions of +%% the LaTeX Project Public License, either version 1.2 of this license +%% or (at your option) any later version. The latest version of this +%% license is in: +%% +%% http://www.latex-project.org/lppl.txt +%% +%% and version 1.2 or later is part of all distributions of LaTeX version +%% 1999/12/01 or later. +\documentclass[a4paper]{article} +\usepackage{array,xspace} +\usepackage[latin1]{inputenc} +\usepackage[tame,hyphenable]{engpron}[2008/08/15] +\usepackage[T1]{fontenc} +\usepackage{lmodern} +\usepackage[english, frenchb]{babel} +\setlength{\parindent}{0pt} +\newcommand\BOP{\discretionary{}{}{}} +\newcommand{\TO}{\textemdash\ \ignorespaces} +\newcommand{\TF}{\unskip\ \textemdash\xspace} +\newcommand\Pkg[1]{\textsf{#1}} +\newcommand\Option[1]{\textsc{#1}} +\newcommand{\CAD}{c.-^^e0-d.\xspace} +\begin{document} +\begin{center}\LARGE + Utilisation du module \Pkg{engpron} +\end{center} +Voici quelques exemples d'utilisation des macros avec \texttt{^^a3}. Le +module \verb+engpron+ est charg^^e9 avec les options \Option{jones}, +\Option{monstress}, \Option{unhyphenable}, \Option{visible}, +\Option{nice} et \Option{final} \TO options par d^^e9faut\TF et l'option +explicite \Option{tame} qui remplace l'option par d^^e9faut +\Option{wild}. +\paragraph{Macro \texttt{^^a3X}} Cette macro \emph{doit} ^^eatre suivie d'une +lettre seule. Elle note les sons optionnels ^^e0 la mani^^e8re de +Jones~\cite{jones15}, avec l'option \Option{jones}, ou ^^e0 la mani^^e8re du +Harraps~\cite{harraps}, avec l'option \Option{harraps}. + +On aura par exemple +\verb!\PRON{!\texttt{^^a3e^^a3h^^a3Xt^^a3s^^a3U^^a3kli^^a3k^^a3en}\verb!}! +qui donnera \PRON{^^a3e^^a3h^^a3Xt^^a3s^^a3U^^a3kli^^a3k^^a3en}. + +Suivie de la lettre \og e \fg elle donne \Pron{^^a3Xe} +(\verb+\Pron{^^a3Xe}+) comme dans \PRON{^^a3B^^a3af^^a3kek^^a3Ht^^a3q^^a3k^^a3s^^a3Xen} qui +s'obtient avec \verb+\PRON{^^a3B^^a3af^^a3kek^^a3Ht^^a3q^^a3k^^a3s^^a3Xen}+. +\paragraph{Macros \texttt{^^a3M} et \texttt{^^a3m}} Elles permettent +d'obtenir les voyelles nasalis^^e9s, ^^e0 la mode fran^^e7aise pour la 1\iere +et ^^e0 la mode anglaise pour la 2\up{de}. Se reporter ^^e0 la 2\ieme +table. Elles doivent ^^eatre suivies d'une des lettres : a, i, o, +u. Penser ^^e0 \og ban \fg, \og vin \fg, \og long \fg et \og parfum \fg +(dans la prononciation tr^^e8s correcte du fran^^e7ais soutenu). +\paragraph{Macro \texttt{^^a3Z}} Elle note le \og r \fg final qui n'est +prononc^^e9 qu'en cas de liaison. On a, p. ex. \Pron{^^a3H^^a3akt^^a3e^^a3Z} avec +\verb+\Pron{^^a3H^^a3akt^^a3e^^a3Z}+. +\paragraph{Macro \texttt{^^a3k}} Son comportement est d^^e9termin^^e9e par les +options \Option{hyphenable} \TO qui s'oppose ^^e0 +\Option{unhyphenable}\TF et \Option{visible} \TO qui s'oppose ^^e0 +\Option{invisible}. Elle sert ^^e0 marquer les limites de syllabes. + +Avec l'option \Option{visible}, option par d^^e9faut, on obtient une +marque qui est par d^^e9faut [.] et est d^^e9finie par la +macro \verb+\EPSyllabeMarque+. Cette derni^^e8re peut ^^eatre red^^e9finie ^^e0 +l'aide de \verb+\renewcommand+. Avec l'option \Option{invisible}, +\verb+^^a3k+ ne produit aucun glyphe. + +Avec l'option \Option{hyphenable}, \verb+^^a3k+ permet la c^^e9sure mais +l'interdit avec l'option \Option{unhyphenable} qui est l'option par +d^^e9faut. +\paragraph{Macro \texttt{^^a3K}} Son comportement est d^^e9termin^^e9e par la +lettre suivante. \texttt{X} donne un point de c^^e9sure invisible, +\texttt{k} une marque ins^^e9cable et visible de syllabisation, +\texttt{K} une marque \emph{s^^e9cable} et visible de syllabisation, +\texttt{b} une marque d'accent tonique secondaire ins^^e9cable, +\texttt{B} une marque d'accent tonique secondaire \emph{s^^e9cable}, +\texttt{h} une marque d'accent tonique principal ins^^e9cable et, enfin, +\texttt{H} une marque d'accent tonique principal \emph{s^^e9cable}. Son +comportement \textbf{ne d^^e9pend pas} des options en vigueur. +\vspace*{\stretch{1}} + +\begin{thebibliography}{99} +\bibitem{jones15} Daniel~\textsc{Jones} \dag. +\emph{English Pronouncing Dictionary}. +15th Edition. This major new edition edited by Peter Roach \& James +Hartman. +Cambridge University Press, 1997. +\textsc{isbn} : \texttt{0-521-45903-6} +\bibitem{harraps} J. E. \textsc{Manson}, M.A. +\emph{Harrap's New Shorter French And English Dictionary.} +Revised edition \copyright{} George G. Harrap \& +Co. Ltd. \oldstylenums{1967}. +Bordas diffuseur, \oldstylenums{1980}. +\textsc{isbn} : \texttt{0 245 59062 5} +\end{thebibliography} +\newpage + +\vspace*{\stretch{1}} + +\begin{LivreActive}\Large +\hspace*{\stretch{1}} +\begin{tabular}[c]{|>{\ttfamily }c|c||>{\ttfamily }c|c||>{\ttfamily + }c|c||>{\ttfamily }c|c||>{\ttfamily }c|c|}\hline +\multicolumn{10}{|c|}{ +Classement par ordre alphab^^e9tique +}\\ +\multicolumn{10}{|c|}{ +L'^^e9toile renvoie aux explications ci-dessus +}\\ \hline +\^^a3a & ^^a3a & \^^a3b & ^^a3b & \^^a3c & ^^a3c & \^^a3d & ^^a3d & \^^a3e & ^^a3e \\ \hline +\^^a3f & ^^a3f & \^^a3g & ^^a3g & \^^a3h & ^^a3h & \^^a3i & ^^a3i & \^^a3j & ^^a3j \\ \hline +\^^a3k & $\ast$ & \^^a3l & ^^a3l & \^^a3m & $\ast$ & \^^a3n & ^^a3n & \^^a3o & ^^a3o \\ \hline +\^^a3p & ^^a3p & \^^a3q & ^^a3q & \^^a3r & ^^a3r & \^^a3s & ^^a3s & \^^a3t & ^^a3t \\ \hline +\^^a3u & ^^a3u & \^^a3v & ^^a3v & \^^a3w & ^^a3w & \^^a3x & ^^a3x & \^^a3y & ^^a3y \\ \hline +\^^a3z & ^^a3z & & & & & & & & \\ \hline +\^^a3A & ^^a3A & \^^a3B & ^^a3B & \^^a3C & ^^a3C & \^^a3D & ^^a3D & \^^a3E & ^^a3E \\ \hline +\^^a3F & ^^a3F & \^^a3G & ^^a3G & \^^a3H & ^^a3H & \^^a3I & ^^a3I & \^^a3J & ^^a3J \\ \hline +\^^a3K & $\ast$ & \^^a3L & ^^a3L & \^^a3M & $\ast$ & \^^a3N & ^^a3N & \^^a3O & ^^a3O \\ \hline +\^^a3P & ^^a3P & \^^a3Q & ^^a3Q & \^^a3R & ^^a3R & \^^a3S & ^^a3S & \^^a3T & ^^a3T \\ \hline +\^^a3U & ^^a3U & \^^a3V & ^^a3V & \^^a3W & ^^a3W & \^^a3X & $\ast$ & \^^a3Y & ^^a3Y \\ \hline +\^^a3Z & ^^a3Z & & & & & & & & \\ \hline +\end{tabular} +\hspace*{\stretch{1}} +\end{LivreActive} + +\vspace*{\stretch{1}} +\newpage +\thispagestyle{empty} + +\vspace*{\stretch{1}} +\begin{LivreActive} +\hspace*{\stretch{1}} +{\Large +\begin{tabular}[c]{|>{\ttfamily }c|c||>{\ttfamily }c|c||>{\ttfamily + }c|c||>{\ttfamily }c|c|}\hline +\multicolumn{8}{|c|}{ +Voyelles +}\\ \hline +\^^a3a & ^^a3a & \^^a3A & ^^a3A & \^^a3e & ^^a3e & \^^a3E & ^^a3E \\ \hline +\^^a3i & ^^a3i & \^^a3I & ^^a3I & \^^a3o & ^^a3o & \^^a3O & ^^a3O \\ \hline +\^^a3u & ^^a3u & \^^a3U & ^^a3U & \^^a3v & ^^a3v & \^^a3x & ^^a3x \\ \hline +\^^a3c & ^^a3c & \^^a3C & ^^a3C & \^^a3y & ^^a3y & & \\ \hline +\multicolumn{8}{|c|}{ +Diphtongues +}\\ \hline +\^^a3p & ^^a3p & \^^a3q & ^^a3q & \^^a3r & ^^a3r & \^^a3P & ^^a3P\\ \hline +\^^a3Q & ^^a3Q & \^^a3R & ^^a3R & \^^a3w & ^^a3w & \^^a3W & ^^a3W\\ \hline +\^^a3V & ^^a3V & & & & & & \\ \hline +\multicolumn{8}{|c|}{ +Consonnes +}\\ \hline +\^^a3d & ^^a3d & \^^a3f & ^^a3f & \^^a3j & ^^a3j & \^^a3l & ^^a3l \\ \hline +\^^a3n & ^^a3n & \^^a3s & ^^a3s & \^^a3t & ^^a3t & \^^a3z & ^^a3z \\ \hline +\^^a3T & ^^a3T & \^^a3L & ^^a3L & & & & \\ \hline +\multicolumn{8}{|c|}{ +Accents toniques +}\\ \hline +\^^a3b & ^^a3b & \^^a3B & ^^a3B & \^^a3h & ^^a3h & \^^a3H & ^^a3H \\ \hline +\^^a3Kb & ^^a3Kb & \^^a3KB & ^^a3KB & \^^a3Kh & ^^a3Kh & \^^a3KH & ^^a3KH \\ \hline +\multicolumn{8}{|c|}{ +Voyelles nasalis^^e9es +}\\ +\multicolumn{8}{|c|}{ +prononciation fran^^e7aise +}\\ \hline +\^^a3Ma & ^^a3Ma & \^^a3Mi & ^^a3Mi & \^^a3Mo & ^^a3Mo & \^^a3Mu & ^^a3Mu \\ \hline +\multicolumn{8}{|c|}{ +prononciation anglaise +}\\ \hline +\^^a3ma & ^^a3ma & \^^a3mi & ^^a3mi & \^^a3mo & ^^a3mo & \^^a3mu & ^^a3mu \\ \hline +\multicolumn{8}{|c|}{ +Syllabisation +}\\ \hline +\^^a3k & ^^a3k & \^^a3Kk & ^^a3Kk & \^^a3KK & ^^a3KK & \^^a3KX& ^^a3KX\\ \hline +\end{tabular}} +\hspace*{\stretch{1}} +\vspace*{\stretch{4}} + +{\footnotesize +Le tableau ci-dessus est ^^e9crit dans un environnement +\verb+LivreActive+ et l'on doit utiliser la macro \verb+\+\texttt{\^^a3} +pour obtenir le caract^^e8re \^^a3. Mais on peut ^^e9crire \og ^^a3a \fg +directement avec \og \texttt{\^^a3a} \fg. + +Lorsque l'on se trouve dans l'environnement \verb+LivreActive+, on +obtient \pron{^^a3H^^a3akt^^a3e^^a3Z} avec +\verb+\pron{+\texttt{\^^a3H}\BOP\texttt{\^^a3akt}\BOP\texttt{\^^a3e}\BOP% + \texttt{\^^a3Z}\verb+}+ mais on remarquera, en lisant ce fichier +\texttt{engpron-ex-fr.tex} ce qu'il faut faire comme \og gymnastique \fg +pour obtenir un semblant de \texttt{verbatim}. +} + +\vspace{2\baselineskip} +\newlength{\montruc}\settowidth{\montruc}{Yvon \textsc{Henel}, \TeX + nicien de surface.} +\hspace*{\stretch{1}}\makebox[\montruc][c]{Yvon \textsc{Henel}, \TeX + nicien de surface.}\\[.5\baselineskip] +\hspace*{\stretch{1}}\makebox[\montruc][c]{2008-07-15} + +\vspace*{\stretch{1}} +\end{LivreActive} +\end{document} +\endinput +%% +%% End of file `engpron-ex-fr.tex'. diff --git a/Master/texmf-dist/doc/latex/engpron/engpron-fr.ltx b/Master/texmf-dist/doc/latex/engpron/engpron-fr.ltx new file mode 100644 index 00000000000..9da46c323ed --- /dev/null +++ b/Master/texmf-dist/doc/latex/engpron/engpron-fr.ltx @@ -0,0 +1,506 @@ +%% +%% This is file `engpron-fr.ltx', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% engpron.dtx (with options: `doc,fr') +%% This is a generated file. +%% +%% Copyright (C) 2003-2008 Y. Henel, le TeXnicien de surface +%% <le.texnicien.de.surface@wanadoo.fr> +%% +%% This file may be distributed and/or modified under the conditions of +%% the LaTeX Project Public License, either version 1.2 of this license +%% or (at your option) any later version. The latest version of this +%% license is in: +%% +%% http://www.latex-project.org/lppl.txt +%% +%% and version 1.2 or later is part of all distributions of LaTeX version +%% 1999/12/01 or later. +\documentclass[a4paper]{article} +\usepackage{xspace,array} +\usepackage[latin1]{inputenc} +\usepackage[tame,hyphenable]{engpron} +\usepackage[T1]{fontenc} +\usepackage[english,frenchb]{babel} +\usepackage{engpron-tools} +\usepackage{makeidx} +\usepackage[colorlinks=true, + linkcolor=blue, + urlcolor=blue, + citecolor=blue]{hyperref} +\makeindex +\begin{document} +\GetFileInfo{engpron.sty} +\newcommand{\GBP}{\texttt{^^a3}\xspace} +\title{Documentation fran^^e7aise de l'extension + \textsf{engpron}\thanks{% + Ce document correspond au fichier + \textsf{engpron}~\fileversion, + du \filedate, ^^e9dition du cinquantenaire.}} +\author{Le \TeX nicien de surface\\ + \href{mailto:le.texnicien.de.surface@wanadoo.fr}% + {le.texnicien.de.surface@wanadoo.fr}} +\date{\docdate} + +\maketitle + +\begin{abstract} + Ce module n'est qu'une petite poign^^e9e fix^^e9e tant bien que mal sur + le module \Pkg{tipa} dont je tiens ^^e0 remercier l'auteur, + \textsc{Fukui}~Rei, tr^^e8s cordialement. Je remercie ^^e9galement + T.~\textsc{Lachand-Robert} pour son ouvrage~\cite{tlachand} sans + lequel je ne serais que peu de chose |;)| et + Josselin~\textsc{Noirel} pour ses conseils sur + \url{fr.comp.text.tex} ainsi que pour \og notre \fg module + \Pkg{drac}. + + Ce module fournit des macros\footnote{appel^^e9es ensuite \og macros + en \GBP \fg.} commen^^e7ant par le caract^^e8re \GBP, rendu actif, qui + permettent d'^^e9crire la prononciation de l'anglais britannique ou + am^^e9ricain ^^e0 l'aide de l'API telle qu'on la trouve dans le \og + English Pronouncing Dictionary \fg de Daniel~\textsc{Jones}. Une + option permet d'obtenir le style adopt^^e9 par le + Harraps~\cite{harraps}. + + Le module \Pkg{engpron} utilise, si l'option \Option{drac} est + choisie comme c'est le cas par d^^e9faut, le module \Pkg{drac} pour + faire de \GBP un caract^^e8re actif robuste, ce qui permet d'utiliser + les macros en \GBP dans des arguments \og mobiles \fg au sens de + \LaTeX. + + On trouvera en fin de document (page~\pageref{latable}) une table + des commandes commen^^e7ant par un \GBP dans la configuration par + d^^e9faut : \Option{monstress} et \Option{jones}. +\end{abstract} + +\tableofcontents + +\section{Utilisation} + +Ce module charge \Pkg{tipa}, merveilleux module qui permet +d'^^e9crire en API, alphabet phon^^e9tique international, avec +\LaTeX{}. Il fournit quelques macros qui permettent de reprendre la +prononciation de l'anglais britannique et am^^e9ricain telle qu'on la +trouve dans le \textsc{Jones}~\cite{jones15} ou dans~\cite{jones}. + +L'extension \Pkg{drac} est utilis^^e9, par d^^e9faut, pour faire de \GBP un +caract^^e8re actif robuste au sens de \LaTeX. + +\subsection{Le module et ses options} + +On pr^^e9sente ici les options de \Pkg{engpron}. On chargera +\Pkg{engpron} avec, p.~ex., +\cs{usepackage}|[|\BOP|wild|\BOP|]|\BOP|{|\BOP|engpron|\BOP|}|. + +J'ai tent^^e9 de regrouper les options par rapport ^^e0 leurs effets. + +\subsubsection{Comportement de \GBP} + +Par d^^e9faut, ou explicitement avec l'option \Option{wild}, ce module +rend le caract^^e8re \GBP actif et le red^^e9finit de mani^^e8re ^^e0 +\DescribeOption{wild} permettre la d^^e9finition de macros comme +|^^a3a| et leur utilisation dans tout le texte. Il permet ^^e9galement +d'obtenir une pr^^e9sentation uniforme de la prononciation ^^e0 l'aide de +la macro \cs{pron}\marg{texte en API}. +Si l'on pr^^e9f^^e8re, on peut choisir l'option \Option{tame} +qui r^^e9tablit le caract^^e8re \GBP dans sa cat^^e9gorie dans le +\DescribeOption{tame} +codage fournit par |fontenc|\oarg{T1} et donc le rend actif et lui +permet d'^^e9crire le symbole de la livre sterling. Il faudra alors +utiliser soit la macro \cs{Pron}\marg{texte en API}, soit +\cs{PRON}\marg{texte en API} \TO et obtenir ainsi la pr^^e9sentation +donn^^e9e par \cs{pron}\TF soit enfin l'environnement |LivreActive| dans +lequel \GBP est activ^^e9. + +Par d^^e9faut, ou explicitement avec l'option \Option{drac}, ce module +\DescribeOption{drac} +utilise l'extension \Pkg{drac} pour faire de \GBP un caract^^e8re +actif et \emph{robuste} au sens des arguments mouvants de \LaTeX. +\DescribeOption{nodrac} +L'option oppos^^e9e est \Option{nodrac} qui ne charge pas l'extension +\Pkg{drac} est conserve les d^^e9finitions de \GBP donn^^e9es par la +version~1. + +\subsubsection{Aspect du texte} + +Par d^^e9faut \Pkg{engpron} active l'option \Option{jones} qui +\DescribeOption{jones} permet d'obtenir une pr^^e9sentation du \og r \fg +final \PRON{a^^a3Z} et des sons optionnels conforme ^^e0~\cite{jones15}. On +obtient \PRON{n^^a3Xen} pour le \og schwa \Pron{^^a3e} \fg et \PRON{a^^a3Xt^^a3sa} +pour un \og t \fg optionnel. + +\Pkg{engpron} propose ^^e9galement l'option \Option{harraps} qui permet +d'obtenir \DescribeOption{harraps}\label{harrapsrfin} alors une +pr^^e9sentation conforme ^^e0~\cite{harraps} \CAD que les sons optionnels +sont repr^^e9sent^^e9s entre parenth^^e8ses et que le \og r \fg final se +pr^^e9sente comme ceci : \textsl{r}. De plus \pron{\textsl{o}} note ce +que Jones~\cite{jones15} ^^e9crit \PRON{^^a3w}. + +\subsubsection{Syllabisation et accents toniques} + +Le module propose plusieurs options g^^e9rant la syllabisation. Avec +\Option{hyphenable} on \DescribeOption{hyphenable} autorise \LaTeX\ ^^e0 +couper\index{coupure} sur les marques explicites de +syllabisation\index{syllabisation} \TO voir plus loin |^^a3k|, +page~\pageref{livrek}\TF et sur les marques d'accents +toniques\index{accent tonique} \TO |^^a3b|, |^^a3B|, |^^a3h| et |^^a3H|. On dira +alors que les marques de syllabisation et d'accents toniques sont +\emph{s^^e9cables}\index{s^^e9cable}. + +Avec l'option \Option{unhyphenable}, on interdit la coupure des mots +sur ces marques. Les marques sont dites alors +\emph{ins^^e9cables}\index{ins^^e9cable}. \DescribeOption{unhyphenable} Pour +conserver le comportement des versions pr^^e9c^^e9dentes, c'est l'option +\Option{unhyphenable} qui est choisie par d^^e9faut. + +\vspace{\baselineskip} + +On peut choisir entre l'option \Option{visible} et l'option +\Option{invisible}. Avec la premi^^e8re, \Option{visible}, la marque de +\DescribeOption{visible} syllabisation, |^^a3k|, produit un glyphe qui +est d^^e9fini par \cs{EPSyllabeMarque} \TO macro que l'on peut red^^e9finir +^^e0 coup de \cs{renewcommand} et qui, par d^^e9faut, donne un simple +point. Lorsque l'option \Option{invisible} est en vigueur, la macro +\DescribeOption{invisible} |^^a3k| ne produit aucun glyphe mais la c^^e9sure +y reste possible si l'option \Option{hyphenable} est en vigueur. + +\vspace{\baselineskip} + +\Pkg{engpron} propose deux autres options : \Option{monstress}, +\DescribeOption{monstress} option par d^^e9faut, et +\Option{tipastress}. Elles sont exclusives l'une de l'autre et +d^^e9finissent les glyphes repr^^e9sentant les accents toniques principaux +et secondaires. L'utilisateur peut \DescribeOption{tipastress} +red^^e9finir ^^e0 sa convenance les deux macros utilis^^e9es par d^^e9faut +\cs{EPaccentprincipal} et \cs{EPaccent}\BOP|secondaire| et remplacer +ainsi les \og glyphes \fg que je fournis par d^^e9faut. Avec la +premi^^e8re, on obtient \Pron{^^a3h} et \Pron{^^a3b} comme marque d'accent +tonique principal et secondaire respectivement et avec la deuxi^^e8me +\textprimstress{} et \textsecstress{} respectivement, glyphes fournis +par \Pkg{tipa}. + +\subsubsection{Brouillon et erreur} + +Certaines macros, ^^e0 savoir |^^a3K|, |^^a3m| et |^^a3M|, attendent une lettre +pour d^^e9terminer ce qu'elles ont ^^e0 faire. Cependant toutes les lettres +ne conviennent pas. Avec l'option \Option{final}, +\DescribeOption{final}qui s'oppose ^^e0 \Option{draft}, \Pkg{engpron} ne +produit rien dans le document mais ^^e9met un \DescribeOption{draft} +avertissement dont on trouve la trace dans le fichier |.log|, avec +l'option \Option{nice}, ou s'arr^^eate sur une erreur +\DescribeOption{nice} avec l'option \Option{tough}. Avec +\Option{draft}, on lit le texte suivant dans le document produit: +\texttt{\string?\string!<*>\string!\string?} o^^f9 \DescribeOption{tough} +\texttt{*} tient ici la place du caract^^e8re \emph{erron^^e9}. + +\subsubsection{R^^e9sum^^e9 des options disponibles} + +Bref, pour r^^e9sumer: +\nopagebreak{}\par\nopagebreak{} +\noindent +\begin{tabular}{*{2}{>{\scshape}l} l} + \multicolumn{1}{l}{L'option par d^^e9faut} & + \multicolumn{1}{l}{et l'option oppos^^e9e} & + agissent sur\\ + wild & tame & activit^^e9 de \GBP\\ + drac & nodrac & robustesse de \GBP\\ + jones & harraps & notation de la prononciation\\ + monstress & tipastress & notation des accents toniques\\ + unhyphenable & hyphenable & cr^^e9ation de points de c^^e9sure\\ + visible & invisible & visibilit^^e9 de la syllabisation\\ + \multicolumn{3}{l}{\emph{En cas d'erreur avec} \texttt{^^a3K}, + \texttt{^^a3M} \emph{ou} \texttt{^^a3m}}\\ + final & draft & trace \og ^^e9crite\fg \\ + nice & tough & avertissement ou message d'erreur +\end{tabular} + +\subsection{Les macros \og \GBP \fg} +\label{sec:macrospound} + +Nous allons maintenant pr^^e9senter les macros commen^^e7ant par \GBP. + +Pour r^^e9aliser ces macros, je me suis appuy^^e9 une fois encore sur +T.~\textsc{Lachand-Robert} dans~\cite{tlachand}. C'est son exemple +de macros utilisant |^^a7| pour ^^e9crire les lettres grecques qui m'a +donn^^e9 l'id^^e9e de faire pareil pour pouvoir noter la phon^^e9tique +anglaise, ce dont j'avais besoin pour mes classes\footnote{On finit + par faire des choses ^^e9tranges lorsque l'on enseigne les + math^^e9matiques \emph{en anglais} en section europ^^e9enne de + lyc^^e9e\Sourire.}. Et c'est en piochant de ci de l^^e0 que j'ai trouv^^e9 +les techniques pour r^^e9aliser les macros comme \cs{EP@haut}. + +Je ne pr^^e9sente dans cette section que quelques unes des macros +reprises dans la table situ^^e9e page~\pageref{latable}. + +\subsubsection{Accents toniques} + +On obtient les accents toniques \TO tels que d^^e9finit par l'option +\DescribePoundMacro{h} \Option{tipastress} ou \Option{monstress}\TF +avec, pour l'accent tonique principal\index{accent +principal}\index{accent tonique}, \DescribePoundMacro{H} |^^a3h| \TO |h| +comme \emph{haut}\TF ou encore, pour des raisons de commodit^^e9s de +frappe au clavier, par |^^a3H|. \DescribePoundMacro{b}Pour l'accent +tonique secondaire\index{accent secondaire}, on utilisera +\DescribePoundMacro{B} +indiff^^e9remment soit |^^a3b| soit |^^a3B| \TO |b| pour \emph{bas}. + +\NOUVEAU{D^^e9sormais, quand l'option \Option{hyphenable} est choisie, les + marques d'accents toniques fournissent ^^e0 \TeX\ des points de + coupure de mot \TO \emph{c^^e9sure}. Ils sont s^^e9cables.} + +\subsubsection{Syllabisation} + +\NOUVEAU{Ce qui concerne la \emph{syllabisation}, \CAD l'indication + des limites de syllabes, est introduit par la version~2 du + module.} + +On peut avoir envie, ou besoin, d'indiquer la limite des syllabes +des mots, comme on le voit dans le Jones~\cite{jones15}. Pour ce +faire, le module fournit une seule macro \cs{EPSyllabeCoupure} +\DescribeMacro{EPSyllabeCoupure} rattach^^e9e ^^e0 la macro\label{livrek} +|^^a3k|\DescribePoundMacro{k}. Son comportement est contr^^f4l^^e9 par les +couples d'options \Option{hyphenable}\slash \Option{unhyphenable} et +\Option{visible}\slash \Option{invisible}. Avec +\Option{hyphenable}, elle indique ^^e0 \LaTeX\ un point de coupure de +mot, ce qu'elle ne fait pas avec \Option{unhyphenable}. Avec +\Option{visible}, elle place un glyphe dont \cs{EPSyllabeMarque} +\DescribeMacro{EPSyllabeMarque} d^^e9termine +l'aspect. Avec \Option{invisible}, elle ne produit rien. + +Par d^^e9faut, \cs{EPSyllabeMarque} est d^^e9finie comme un b^^eate point. On +prendra garde au fait que, \cs{EPSyllabeMarque} intervenant comme +argument de \cs{discretionary}, elle est soumise ^^e0 certaines +restrictions comme, p.~ex. le fait de ne pas pouvoir contenir de +math^^e9matiques. + +Quelles que soient les options en vigueur, on peut +toujours\label{livreK} indiquer un point de coupure possible ^^e0 l'aide +de |^^a3KX|, dans ce cas aucun glyphe n'est \DescribePoundMacro{KX} +produit et le point est \emph{invisible}. Avec |^^a3KB| et |^^a3KH| on +produit un \DescribePoundMacro{KB} \DescribePoundMacro{KH} accent +tonique secondaire ou principal \emph{s^^e9cable}. Avec |^^a3Kb| ou |^^a3Kh|, +les accents toniques sont \emph{ins^^e9cables}. Avec |^^a3Kk|, on place une +marque de syllabisation toujours visible et toujours +ins^^e9cable. \DescribePoundMacro{Kk} Enfin, |^^a3KK| +\DescribePoundMacro{KK} produit toujours une marque de syllabisation +visible et s^^e9cable. L'aspect des marques de syllabisation est, bien +entendu, fix^^e9 par \cs{EPSyllabeMarque}. On aura remarqu^^e9 que les +minuscules sont li^^e9es ^^e0 des objets \emph{ins^^e9cables} et les capitales +^^e0 des objets \emph{s^^e9cables}\footnote{Si c'est pas du souci du d^^e9tail + et de la syst^^e9matique!}. Je n'ai pas ^^e9prouv^^e9 le besoin de fournir un +|^^a3Kx| qui ne ferait strictement rien: une chaine de caract^^e8res vide me +semble faire tout aussi bien l'affaire. + +\subsubsection{Sons optionnels} + +Pour indiquer les sons optionnels \DescribePoundMacro{X} on +utilisera la macro |^^a3X|\meta{une lettre} qui \textbf{doit} ^^eatre suivie +d'\emph{une lettre}. La macro ne fonctionne pas si elle est suivie +d'un groupe\footnote{Peut-^^eatre pour la prochaine version, qui sait ?}. +Cette macro fournit normalement ce qu'il faut pour les sons optionnels +de l'anglais. Elle traite diff^^e9remment (avec l'option \Option{jones}) +la lettre \og e \fg qui donne \PRON{^^a3Xe} et les autres comme \og t \fg +qui donne \PRON{^^a3Xt} avec |^^a3Xe| et |^^a3Xt| respectivement. + +Pour noter le \og r \fg final qui n'est prononc^^e9 qu'en cas de liaison, +on \DescribePoundMacro{Z} utilisera |^^a3Z| qui est red^^e9finit lors du +choix de l'option \Option{harraps} \TO voir~\ref{harrapsrfin}. + +\subsection{Autres macros et un environnement} + \label{sec:autresmacros} + +L'utilisateur a acc^^e8s \TO facilement\TF ^^e0 un certain nombres de +commandes qui permettent de r^^e9gler des d^^e9tails de pr^^e9sentation. Il +peut les red^^e9finir par \cs{renewcommand} et obtenir ainsi son propre +style. + +Comme indiqu^^e9e ci-dessus, cf. \Option{monstress}, les macros +\cs{EPaccentprincipal} et \cs{EPaccent}\BOP|secondaire| d^^e9finissent +les glyphes obtenus par |^^a3H| et |^^a3B| respectivement. + +\NOUVEAU{Apparue avec la version~2}, la macro \cs{EPAccentCoupure} +\DescribeMacro{EPAccentCoupure} d^^e9finit le comportement des marques +d'accents toniques en cas de c^^e9sure. Par d^^e9faut, la marque d'accent +tonique passe ^^e0 la ligne avec la syllabe qui porte l'accent, autrement +dit, \Pron{^^a3Bh^^a3p^^a3kf^^a3Xen^^a3H^^a3q^^a3k^^a3s^^a3Xen} est coup^^e9, si n^^e9cessaire, en +\Pron{^^a3Bh^^a3p^^a3kf^^a3Xen}\verb+|+\Pron{^^a3H^^a3q^^a3k^^a3s^^a3Xen}. + +\NOUVEAU{Depuis la version~2}, la macro \cs{EPSyllabeMarque} d^^e9finit +la marque de limite de syllabe et \cs{EPSyllabeCoupure} d^^e9finit le +comportement de la coupure sur une telle marque. Par d^^e9faut, +\DescribeMacro{EPSyllabeCoupure} la c^^e9sure sur \Pron{^^a3Hh^^a3p^^a3kf^^a3Xen} +donne \Pron{^^a3Hh^^a3p^^a3k}\verb+|+\Pron{f^^a3Xen}, autrement dit, la marque +de syllabisation est conserv^^e9e avant le saut de ligne. + +Les macros \cs{EPouvrante}, \cs{EPfermante} et \cs{EPtextestyle} +d^^e9finissent \DescribeMacro{EPouvrante} ce qui entoure la +prononciation et, pour la troisi^^e8me, le style du +\DescribeMacro{EPfermante} texte de cette prononciation. Par +d^^e9faut, les deux premi^^e8re donnent \EPouvrante{} +\DescribeMacro{EPtextestyle} et \EPfermante{} et \cs{EPtextestyle} +est d^^e9finie comme |\rmfamily\upshape|. + +Pour ce qui suit je noterai que \og la livre est active +\fg\index{livre!active} pour signifier que le +caract^^e8re \GBP est actif et \textbf{n'est pas} d^^e9fini pour donner le +glyphe de la livre sterling mais bien pour renvoyer la macro +commen^^e7ant par \GBP. J'^^e9crirai que \og la livre est +inactive\index{livre!inactive} \fg dans tous les +autres cas. + +Ces trois macros sont utilis^^e9e par \cs{pron} et \cs{PRON} pour +permettre \DescribeMacro{pron} l'obtention d'une pr^^e9sentation uniforme +quelque soit le contexte et l'activit^^e9 de la livre. La macro +\cs{pron}\marg{texte} permet d'obtenir une pr^^e9sentation de la +prononciation comme on la trouve habituellement apr^^e8s un mot dans un +texte au long. On l'utilise lorsque \og la livre est +active\index{livre!active} \fg. On ^^e9crira alors +|\pron{ma^^a3i}| pour obtenir \PRON{ma^^a3i}. + +Lorsque \og la livre est inactive\index{livre!inactive} \fg, on +utilisera \DescribeMacro{PRON} \cs{PRON}\marg{texte} pour obtenir le +m^^eame r^^e9sultat. En fait, comme dans ce document je charge le module +\Pkg{engpron} avec l'option \Option{tame} j'ai obtenu, au paragraphe +pr^^e9c^^e9dent, \PRON{ma^^a3i} avec |\PRON{ma^^a3i}|. Et l^^e0 je vous ai tout dit ! + +Enfin, la livre ^^e9tant inactive\index{livre!inactive}, +\cs{Pron}\marg{texte} fournit le \DescribeMacro{Pron} moyen de taper +de l'API sans la pr^^e9sentation donn^^e9e par \cs{pron}. En tapant +|\Pron{^^a3Hf^^a3in^^a3k^^a3i^^a3kg^^a3en}| on obtiendra simplement +\Pron{^^a3Hf^^a3in^^a3k^^a3i^^a3kg^^a3en} sans \og d^^e9coration \fg. + +La macro \cs{ActiveLaLivre} \DescribeMacro{ActiveLaLivre} rend la +livre active\index{livre!active}, elle est utilis^^e9e par \cs{Pron}, +\cs{PRON} et l'environnement qui suit. On peut l'utiliser dans un +tableau \TO avec le module \Pkg{array}\TF pour obtenir la livre active +dans une colonne, par exemple. + +L'environnement \DescribeEnv{LivreActive} fait ce que son +nom indique et active la livre. C'est tout ce qu'il fait. On pourra +donc taper l'horrible \\[2pt] +|\begin{LivreActive} \pron{^^a3Hstj^^a3U^^a3kp^^a3id} \end{LivreActive}|\\[2pt] +au lieu de |\PRON{^^a3Hklev^^a3k^^a3E^^a3Z}|. On aura compris qu'il s'utilise pour +de long texte, des tables\dots + +\vspace{\baselineskip} + +\NOUVEAU{Pour finir}, avec les macros antagonistes +\DescribeMacro{MakeHyphenable} \cs{MakeHyphenable}\slash +\cs{MakeUnHyphenable} on peut contrarier l'effet des options +\Option{hyphenable}\slash\Option{unhyphenable} +\DescribeMacro{MakeUnHyphenable}\index{coupure}. + +\cs{MakeHyphenable} red^^e9finit les macros li^^e9es ^^e0 |^^a3H|, |^^a3h|, |^^a3B|, +|^^a3b| et |^^a3k|\index{accent tonique}\index{syllabisation} pour qu'elles +fournissent des marques +s^^e9cables\index{marque!s^^e9cable}\index{s^^e9cable}. \cs{MakeUnHyphenable} les +red^^e9finit pour que les marques soient +ins^^e9cables\index{marque!ins^^e9cable}\index{ins^^e9cable}. La +visibilit^^e9\index{marque!visibilit^^e9}\index{visibilit^^e9} de |^^a3k| n'est +pas modifi^^e9e. + +Autre couple de macros oppos^^e9es: \DescribeMacro{MakeVisible} +\cs{MakeVisible}\slash\cs{MakeInVisible}. La macro +\cs{Make}\BOP|Vi|\BOP|si|\BOP|ble| red^^e9finit la macro li^^e9e ^^e0 +|^^a3k|\index{syllabisation}\index{visibilit^^e9} pour qu'elle fournisse des +marques visibles\index{marque!visible}, +\cs{MakeInVisible}\index{marque!visible} fait le +\DescribeMacro{MakeInVisible} contraire. La +s^^e9cabilit^^e9\index{s^^e9cabilit^^e9} de |^^a3k| n'est pas modifi^^e9e. + +\subsection{Conclusion} +\label{sec:conclusion} + +On remarquera en regardant la table~\ref{latable} ou le code de +l'extension qu'il reste de la place pour d^^e9finir d'autres macros +utilisant la livre active. + +Tout d'abord quelques lettres ne sont pas employ^^e9es et, par exemple, +|^^a3S| ne fait rien. Par ailleurs, on peut d^^e9finir d'autre macros avec +plus d'une lettre derri^^e8re le \GBP mais on devra alors taper +|^^a3{aeiou}| pour utiliser en fait la macro |\^^a3aeiou|. Je pense qu'il +faudrait r^^e9server cela ^^e0 des macros ayant un effet substantiel +\Sourire. + +En dernier lieu, j'avouerais que le codage +choisi n'est pas forc^^e9ment optimal. En fait, je l'ai ^^e9labor^^e9 au fur +^^e0 mesure des besoins et il n'y a pas de r^^e8gle g^^e9n^^e9rale +d'organisation. Toutefois on pourra remarquer quelques efforts de +syst^^e8me. + +L'utilisateur devrait se sentir libre d'effectuer les changements +qu'il souhaite \TO mais dans ce cas, conform^^e9ment ^^e0 la licence sous +laquelle est publi^^e9 ce module, on devra en changer le nom\TF ou, +s'il le pr^^e9f^^e8re me demander de les mettre en \oe uvre. Je ne fais +cependant aucune promesse quant ^^e0 la rapidit^^e9 ^^e0 laquelle +j'interviendrais. + +\begin{thebibliography}{99} +\addcontentsline{toc}{section}{Bibliographie} +\bibitem{jones15} Daniel~\textsc{Jones} \dag. +\emph{English Pronouncing Dictionary}. +15th Edition. This major new edition edited by Peter Roach \& James +Hartman. +Cambridge University Press, \oldstylenums{1997}.\\ +\textsc{isbn} : \texttt{0-521-45903-6} +\bibitem{jones} Daniel~\textsc{Jones} \dag. +\emph{English Pronouncing Dictionary}. +Cambridge University Press, \oldstylenums{1991}. +\bibitem{tlachand} T.~\textsc{Lachand-Robert}. +\emph{La ma^^eetrise de \TeX{} et \LaTeX{}}. +Masson, Paris, Milan, Barcelone, \oldstylenums{1995}.\\ +\textsc{isbn} : \texttt{2-225-84832-7}. +\bibitem{harraps} J. E. \textsc{Manson}, M.A. +\emph{Harrap's New Shorter French And English Dictionary.} +Revised edition \copyright{} George G. Harrap \& +Co. Ltd. \oldstylenums{1967}. +Bordas diffuseur, \oldstylenums{1980}.\\ +\textsc{isbn} : \texttt{0 245 59062 5} +\end{thebibliography} + +\newpage + +\section{Table des macros \GBP} + +\thispagestyle{empty}{\LARGE +\vspace*{\stretch{1}} +\begin{LivreActive} +\noindent +\begin{tabular}[l]{|>{\ttfamily }c|>{\ActiveLaLivre }c||>{\ttfamily +}c|c||>{\ttfamily }c|c||>{\ttfamily}c|c|}\hline +\multicolumn{8}{|c|}{Voyelles}\\ \hline +\^^a3a & ^^a3a & \^^a3A & ^^a3A & \^^a3e & ^^a3e & \^^a3E & ^^a3E \\ \hline +\^^a3i & ^^a3i & \^^a3I & ^^a3I & \^^a3o & ^^a3o & \^^a3O & ^^a3O \\ \hline +\^^a3u & ^^a3u & \^^a3U & ^^a3U & \^^a3v & ^^a3v & \^^a3x & ^^a3x \\ \hline +\^^a3c & ^^a3c & \^^a3C & ^^a3C & \^^a3y & ^^a3y & & \\ \hline +\multicolumn{8}{|c|}{Diphtongues}\\ \hline +\^^a3p & ^^a3p & \^^a3q & ^^a3q & \^^a3r & ^^a3r & \^^a3P & ^^a3P\\ \hline +\^^a3Q & ^^a3Q & \^^a3R & ^^a3R & \^^a3w & ^^a3w & \^^a3W & ^^a3W\\ \hline +\^^a3V & ^^a3V & & & & & & \\ \hline +\multicolumn{8}{|c|}{Consonnes}\\ \hline +\^^a3d & ^^a3d & \^^a3f & ^^a3f & \^^a3j & ^^a3j & \^^a3l & ^^a3l \\ \hline +\^^a3n & ^^a3n & \^^a3s & ^^a3s & \^^a3t & ^^a3t & \^^a3z & ^^a3z \\ \hline +\^^a3T & ^^a3T & \^^a3L & ^^a3L & & & & \\ \hline +\multicolumn{8}{|c|}{Accents toniques}\\ \hline +\^^a3b & ^^a3b & \^^a3B & ^^a3B & \^^a3h & ^^a3h & \^^a3H & ^^a3H \\ \hline +\^^a3Kb & ^^a3Kb & \^^a3KB & ^^a3KB & \^^a3Kh & ^^a3Kh & \^^a3KH & ^^a3KH \\ \hline +\multicolumn{8}{|c|}{Syllabisation}\\ \hline +\^^a3k & ^^a3k & \^^a3Kk & ^^a3Kk & \^^a3KK & ^^a3KK & \^^a3KX & ^^a3KX \\ \hline +\multicolumn{8}{|c|}{Voyelles nasalis^^e9es}\\ +\multicolumn{8}{|c|}{prononciation fran^^e7aise}\\ \hline +\^^a3Ma & ^^a3Ma & \^^a3Mi & ^^a3Mi & \^^a3Mo & ^^a3Mo & \^^a3Mu & ^^a3Mu \\ \hline +\multicolumn{8}{|c|}{prononciation anglaise}\\ \hline +\^^a3ma & ^^a3ma & \^^a3mi & ^^a3mi & \^^a3mo & ^^a3mo & \^^a3mu & ^^a3mu \\ \hline +\end{tabular}\label{latable} +\end{LivreActive} +\vspace*{\stretch{1}} +} + +\printindex +\end{document} +\endinput +%% +%% End of file `engpron-fr.ltx'. diff --git a/Master/texmf-dist/tex/latex/engpron/engpron-tools.sty b/Master/texmf-dist/tex/latex/engpron/engpron-tools.sty new file mode 100644 index 00000000000..9aab544ef39 --- /dev/null +++ b/Master/texmf-dist/tex/latex/engpron/engpron-tools.sty @@ -0,0 +1,96 @@ +%% +%% This is file `engpron-tools.sty', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% engpron.dtx (with options: `doc-sty') +%% This is a generated file. +%% +%% Copyright (C) 2003-2008 Y. Henel, le TeXnicien de surface +%% <le.texnicien.de.surface@wanadoo.fr> +%% +%% This file may be distributed and/or modified under the conditions of +%% the LaTeX Project Public License, either version 1.2 of this license +%% or (at your option) any later version. The latest version of this +%% license is in: +%% +%% http://www.latex-project.org/lppl.txt +%% +%% and version 1.2 or later is part of all distributions of LaTeX version +%% 1999/12/01 or later. +\def\docdate{2008/08/15} +\ProvidesPackage{engpron-tools} +\RequirePackage[a4paper,% + inner=5cm,% + outer=2cm,% + marginparwidth=5cm]{geometry} +\RequirePackage{fancyvrb} +\AtBeginDocument{\DefineShortVerb{\|}} +\newcommand\BOP{\discretionary{}{}{}} +\newcommand\Option[1]{\textsc{#1}} +\newcommand\Pkg[1]{\textsf{#1}} +\newcommand{\TO}{\textemdash\ \ignorespaces} +\newcommand{\TF}{\unskip\ \textemdash\xspace} +\newcommand{\CAD}{c.-^^e0-d.\xspace} +\newcommand\NOUVEAU[1]{{\slshape #1}} +\newcommand\Sourire{\texttt{\string;-)}} +%%% piqu^^e9 dans doc.sty +\DeclareRobustCommand\meta[1]{% + \ensuremath\langle + \ifmmode \expandafter \nfss@text \fi + {% + \meta@font@select + \edef\meta@hyphen@restore + {\hyphenchar\the\font\the\hyphenchar\font}% + \hyphenchar\font\m@ne + \language\l@nohyphenation + #1\/% + \meta@hyphen@restore + }\ensuremath\rangle +} +\def\meta@font@select{\itshape} + +\def\GetFileInfo#1{% + \def\filename{#1}% + \def\@tempb##1 ##2 ##3\relax##4\relax{% + \def\filedate{##1}% + \def\fileversion{##2}% + \def\fileinfo{##3}}% + \edef\@tempa{\csname ver@#1\endcsname}% + \expandafter\@tempb\@tempa\relax? ? \relax\relax} + +%%% piqu^^e9 dans ltxdoc.cls +\DeclareRobustCommand\cs[1]{\texttt{\char`\\#1}} +\providecommand\marg[1]{% + {\ttfamily\char`\{}\meta{#1}{\ttfamily\char`\}}} +\providecommand\oarg[1]{% + {\ttfamily[}\meta{#1}{\ttfamily]}} +\providecommand\parg[1]{% + {\ttfamily(}\meta{#1}{\ttfamily)}} + +%%% red^^e9finitions et d^^e9finitions +\newcommand\PrintDescribeMacro[1]{\cs{#1}} +\newcommand\PrintDescribePoundMacro[1]{\texttt{^^a3#1}} +\def\DescribePoundMacro{\leavevmode\@bsphack + \begingroup\Describe@PoundMacro} +\def\Describe@PoundMacro#1{\endgroup + \marginpar{\raggedleft\PrintDescribePoundMacro{#1}}% + \index{^^a3#1@\PrintDescribePoundMacro{#1}}\@esphack\ignorespaces} +\def\DescribeMacro{\leavevmode\@bsphack + \begingroup\Describe@Macro} +\def\Describe@Macro#1{\endgroup + \marginpar{\raggedleft\PrintDescribeMacro{#1}}% + \index{#1@\PrintDescribeMacro{#1}}\@esphack\ignorespaces} +\newcommand\DescribeOption[1]{\@bsphack + \marginpar{\raggedleft\textsc{#1}}% + \index{#1@\Option{#1} (option)}% + \index{option!\Option{#1}}\@esphack\ignorespaces} +\newcommand\DescribeEnv[1]{\@bsphack + \marginpar{\raggedleft\texttt{#1}}% + \index{#1@\texttt{#1} (environnement)}% + \index{environnement!\texttt{#1}}\@esphack\ignorespaces} +\reversemarginpar +\endinput +%% +%% End of file `engpron-tools.sty'. diff --git a/Master/texmf-dist/tex/latex/engpron/engpron.sty b/Master/texmf-dist/tex/latex/engpron/engpron.sty index 36811989aac..be3b651bb6e 100644 --- a/Master/texmf-dist/tex/latex/engpron/engpron.sty +++ b/Master/texmf-dist/tex/latex/engpron/engpron.sty @@ -65,16 +65,16 @@ The possible options are (the first is the default):\MessageBreak \ProcessOptions\relax \ifthenelse{\boolean{b@drac}}{\RequirePackage{drac}}{} \let\l@viellelivre=\pounds -\newcommand{\EP@ActiveL@Livre}{\catcode `\£=\active} +\newcommand{\EP@ActiveL@Livre}{\catcode `\^^a3=\active} \ifthenelse{\boolean{b@drac}}% {\newcommand{\ActiveLaLivre}{\EP@ActiveL@Livre% - \ReDeclareRobActChar{£}[1]{\csname \string£##1\endcsname}}} + \ReDeclareRobActChar{^^a3}[1]{\csname \string^^a3##1\endcsname}}} {\newcommand{\ActiveLaLivre}{\EP@ActiveL@Livre% - \def£##1{\csname\string£##1\endcsname}}} -\newcommand{\makepoundletter}{\catcode`\£11\relax} -\newcommand{\makepoundother}{\catcode`\£12\relax} + \def^^a3##1{\csname\string^^a3##1\endcsname}}} +\newcommand{\makepoundletter}{\catcode`\^^a311\relax} +\newcommand{\makepoundother}{\catcode`\^^a312\relax} \newenvironment{LivreActive}{\ActiveLaLivre}{} -\def\£{\pounds} +\def\^^a3{\pounds} \newcommand{\EPtextestyle}{\rmfamily\upshape} \newcommand{\EPouvrante}{[} \def\EP@ouvr@nte{\bgroup\EPouvrante} @@ -209,30 +209,30 @@ with M or m: a, e, i, o, u {\renewcommand\EP@SyllabeEffective{\relax}}% } \makepoundletter -\def\£a{\ae} \def\£A{\EP@al@ng} -\def\£b{\EP@bas} \def\£B{\EP@bas} -\def\£c{\textopeno} \def\£C{\textscripta} -\def\£d{\EP@djeu} -\def\£e{\textschwa} \def\£E{\EP@eul@ng} -\def\£f{\texttheta} -\def\£h{\EP@haut} \def\£H{\EP@haut} -\def\£i{\EP@icourt} \def\£I{\EP@il@ng} -\def\£j{\textyogh} -\def\£l{\EP@syll@bicl} \def\£L{\textbeltl} -\def\£m{\EP@ngln@s@liser} \def\£M{\EP@fr@nn@s@liser} -\def\£n{\ng} \def\£N{\EP@ng@g} -\def\£o{\textturnscripta} \def\£O{\EP@ol@ng} -\def\£p{\EP@ahyi} \def\£P{\EP@eheu} -\def\£q{\EP@ehyi} \def\£Q{\EP@iyeu} -\def\£r{\EP@ohyi} \def\£R{\EP@oueu} -\def\£s{\textesh} -\def\£t{\EP@tcheu} \def\£T{\EP@usfl@ppedt} -\def\£u{\textupsilon} \def\£U{\EP@ul@ng} -\def\£v{\textturnv} \def\£V{\EP@usoou} -\def\£w{\EP@euou} \def\£W{\EP@ahou} -\def\£x{\textrevepsilon} \def\£X{\EP@option@lsound} -\def\£y{\textrhookschwa} -\def\£z{\dh} \def\£Z{\EP@silent@r} +\def\^^a3a{\ae} \def\^^a3A{\EP@al@ng} +\def\^^a3b{\EP@bas} \def\^^a3B{\EP@bas} +\def\^^a3c{\textopeno} \def\^^a3C{\textscripta} +\def\^^a3d{\EP@djeu} +\def\^^a3e{\textschwa} \def\^^a3E{\EP@eul@ng} +\def\^^a3f{\texttheta} +\def\^^a3h{\EP@haut} \def\^^a3H{\EP@haut} +\def\^^a3i{\EP@icourt} \def\^^a3I{\EP@il@ng} +\def\^^a3j{\textyogh} +\def\^^a3l{\EP@syll@bicl} \def\^^a3L{\textbeltl} +\def\^^a3m{\EP@ngln@s@liser} \def\^^a3M{\EP@fr@nn@s@liser} +\def\^^a3n{\ng} \def\^^a3N{\EP@ng@g} +\def\^^a3o{\textturnscripta} \def\^^a3O{\EP@ol@ng} +\def\^^a3p{\EP@ahyi} \def\^^a3P{\EP@eheu} +\def\^^a3q{\EP@ehyi} \def\^^a3Q{\EP@iyeu} +\def\^^a3r{\EP@ohyi} \def\^^a3R{\EP@oueu} +\def\^^a3s{\textesh} +\def\^^a3t{\EP@tcheu} \def\^^a3T{\EP@usfl@ppedt} +\def\^^a3u{\textupsilon} \def\^^a3U{\EP@ul@ng} +\def\^^a3v{\textturnv} \def\^^a3V{\EP@usoou} +\def\^^a3w{\EP@euou} \def\^^a3W{\EP@ahou} +\def\^^a3x{\textrevepsilon} \def\^^a3X{\EP@option@lsound} +\def\^^a3y{\textrhookschwa} +\def\^^a3z{\dh} \def\^^a3Z{\EP@silent@r} \ifthenelse{\boolean{b@visible}}{% \ifthenelse{\boolean{b@hyphenable}}{% \newcommand\EP@SyllabeEffective{\EPSyllabeCoupure}}{% @@ -241,14 +241,14 @@ with M or m: a, e, i, o, u \newcommand\EP@SyllabeEffective{\discretionary{}{}{}}}{% \newcommand\EP@SyllabeEffective{\relax}} } -\def\£k{\EP@SyllabeEffective} -\def\£K{\EP@Speci@l} -\catcode `\£=\active +\def\^^a3k{\EP@SyllabeEffective} +\def\^^a3K{\EP@Speci@l} +\catcode `\^^a3=\active \ifthenelse{\boolean{b@drac}} - {\DeclareRobustActChar{£}[1]{\csname \string£#1\endcsname}} - {\def£#1{\csname \string£#1\endcsname}} + {\DeclareRobustActChar{^^a3}[1]{\csname \string^^a3#1\endcsname}} + {\def^^a3#1{\csname \string^^a3#1\endcsname}} \ifthenelse{\boolean{b@wild}}{}{% -\EP@ActiveL@Livre \global\let£=\l@viellelivre\relax +\EP@ActiveL@Livre \global\let^^a3=\l@viellelivre\relax } \endinput %% |