From 2949c84a3674bc71441f9e188ae3096f6f49a04e Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sat, 28 Nov 2009 01:09:55 +0000 Subject: new latex package combelow (19oct09) git-svn-id: svn://tug.org/texlive/trunk@16213 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/combelow/README | 26 ++++ Master/texmf-dist/doc/latex/combelow/combelow.bib | 30 +++++ Master/texmf-dist/doc/latex/combelow/combelow.pdf | Bin 0 -> 105061 bytes Master/texmf-dist/doc/latex/combelow/combelow.tex | 150 ++++++++++++++++++++++ 4 files changed, 206 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/combelow/README create mode 100644 Master/texmf-dist/doc/latex/combelow/combelow.bib create mode 100644 Master/texmf-dist/doc/latex/combelow/combelow.pdf create mode 100644 Master/texmf-dist/doc/latex/combelow/combelow.tex (limited to 'Master/texmf-dist/doc/latex') diff --git a/Master/texmf-dist/doc/latex/combelow/README b/Master/texmf-dist/doc/latex/combelow/README new file mode 100644 index 00000000000..5ed643ad9c4 --- /dev/null +++ b/Master/texmf-dist/doc/latex/combelow/README @@ -0,0 +1,26 @@ +This is the README file for combelow package. + +combelow: comma below (accent) + +combelow provides you with a command that typesets comma belowed characters. + +Author: +------- +Gianluca Pignalberi (g.pignalberi@freesoftwaremagazine.com) + +Copyright: 2009 by Gianluca Pignalberi +---------- +This program can be redistributed and/or modified under the terms +of the LaTeX Project Public License Distributed from CTAN +archives in directory macros/latex/base/lppl.txt. + +Installation: +------------- +Copy combelow.sty in a suitable directory under texmf/tex/latex, and +combelow.pdf and this README in the corresponding directory under +texmf/doc/latex, then run texhash (check your system to locate the texmf tree). + +Usage: +------ +To add a comma below (accent) to a character, call it x, just write \cb x in +your document. diff --git a/Master/texmf-dist/doc/latex/combelow/combelow.bib b/Master/texmf-dist/doc/latex/combelow/combelow.bib new file mode 100644 index 00000000000..b397c63ed19 --- /dev/null +++ b/Master/texmf-dist/doc/latex/combelow/combelow.bib @@ -0,0 +1,30 @@ +@article{babel, + title = "{Babel, a multilingual package for use with \LaTeX's standard + document classes}", + author = "Johannes Braams", + year = "2006", + note = "{\url{http://www.ctan.org}}", +} + +@misc{Ced, + author = "Wikipedia", + title = "{Cedilla}", + note = "{\url{http://en.wikipedia.org/wiki/Cedilla}}", + year = "2009", +} + +@misc{Unitables, + author = "{Unicode Consortium}", + title = "{Code charts}", + note = "{\url{http://www.unicode.org/charts}}", + year = "2009", +} + +@article{GP09, + author = "Gianluca Pignalberi", + title = "{\textsf{combelow}: abbasso i segni diacritici di serie B}", + journal = "ArsTeXnica", + number = "8", + year = "2009", + month = "October", +} diff --git a/Master/texmf-dist/doc/latex/combelow/combelow.pdf b/Master/texmf-dist/doc/latex/combelow/combelow.pdf new file mode 100644 index 00000000000..0944a73884f Binary files /dev/null and b/Master/texmf-dist/doc/latex/combelow/combelow.pdf differ diff --git a/Master/texmf-dist/doc/latex/combelow/combelow.tex b/Master/texmf-dist/doc/latex/combelow/combelow.tex new file mode 100644 index 00000000000..c4601283fcc --- /dev/null +++ b/Master/texmf-dist/doc/latex/combelow/combelow.tex @@ -0,0 +1,150 @@ +\documentclass{ltxdoc} + +\usepackage{combelow} +\usepackage{url} +\usepackage{listings} +\lstset{numbers=left,numberstyle=\tiny,basicstyle=\ttfamily,language=[LaTeX]TeX,breaklines} + +\begin{document} +\title{The \textsf{combelow} package} +\author{Gianluca Pignalberi\\\texttt{g.pignalberi@freesoftwaremagazine.com}} +\date{10/11/2009~(0.99e)} +\maketitle + +\begin{abstract} +Standard \LaTeX{} doesn't have the commands necessary to typeset some +``secondary'' diacritic marks used in some European languages. Romanian and +Latvian have some letters with a \emph{comma below} (aka comma accent). Up +to now, \LaTeX{} users approximated it with the \emph{cedilla} (~\c{}~). From +now on they have a proper comma below (~\cb{}~). +\end{abstract} + +\section{Introduction} +Once I had to typeset a flyer in Romanian. The flyer text had a word +containing a `\cb t'. To my big surprise and disappointment, \LaTeX{} +wasn't able to produce that glyph with a specific command, and I then +approximated it with a cedilla (after reading chapter 40 of \cite{babel}). +After asking some Romanians, they told me the flyer was ok, but those answers +didn't persuade me: every Romanian newspapers and magazines had a comma below +Ts and Ss, not a cedilla. + +I decided to read Unicode books and documents~\cite{Unitables,Ced}, and +discovered that \c s and \c t are Turkish strokes. Romanian would rather have +the so-called \emph{comma below} (a preferred form for cedilla). I also +discovered that Latvian has some other letters with a comma below: g, k, l, n +and r. Being `g' a descending letter, its comma below becomes a +\emph{turned comma above} (\cb g). + +I thought that using \textsf{utf8x} encoding would allow me to typeset those +letters, and their corresponding uppercase versions, once typed with a +Unicode editor. I was wrong, and a real command was needed. + +You can find a more in-depth description of the whole work in~\cite{GP09}. + +\section{Usage} +After including the package into your document +(\verb+\usepackage{combelow}+), you're provided with the command \verb+\cb+ +that typesets its argument with the proper comma. Table~\ref{tab:cb} +summarizes commands and results. + +\begin{table} +\centering +\begin{tabular}{cc} +Command&Result\\ +\verb+\cb g+&\cb g\\ +\verb+\cb k+&\cb k\\ +\verb+\cb l+&\cb l\\ +\verb+\cb n+&\cb n\\ +\verb+\cb r+&\cb r\\ +\verb+\cb s+&\cb s\\ +\verb+\cb t+&\cb t\\ +\end{tabular} +\caption{Examples of comma below-ed letters} +\label{tab:cb} +\end{table} + +\section{Properties and known issues} +A lot of Romanian printed matter show comma below-ed letters with a comma +below slightly smaller than the actual font size. The package isn't able yet +to manage a comma below less than the current font size. + +If you want to put the comma accent below a two or more bytes Unicode +character, you have to surround it with braces, just as you would do with +other standard accents. + +The biggest drawback is that the package doesn't allow hyphenation and loses +kerning information too. + +\section{The code} +\begin{lstlisting} +\NeedsTeXFormat{LaTeX2e} +\ProvidesPackage{combelow}[2009/11/10 v0.99e comma below command] +\def\@commafont{\check@mathfonts + \fontsize\sf@size\z@\selectfont} +\DeclareRobustCommand{\cb}[1]{{% +\setbox\z@\hbox{#1}% +\ifdim\dp\z@<.1\ht\z@\ooalign{\unhbox\z@\crcr\hidewidth\lower.4ex\hbox{\@commafont,}\hidewidth}% +\else\ooalign{\unhbox\z@\crcr\hidewidth\raise.5ex\hbox{\@commafont`}\hidewidth}% +\fi}}% +\endinput +\end{lstlisting} +That's all: it stacks a comma (typeset in a smaller font) under a character +without descendant (with no depth), while stacks an open single quote over a +descending character (with a significant depth, since some Times fonts have no +descendant, while being deeper than 0). + +\bibliographystyle{plain} +\bibliography{combelow} + +\appendix +\section{Changes} +\textbf{2009/04/21} \textbf{v0.1} + +\vspace{.5em} +\noindent +\begin{itemize} +\item Initial version, not released. Could only typeset g, k, l, n, r, s +and t with comma below, and the corresponding uppercase letters. +\end{itemize} + +\vspace{.5em} +\noindent +\textbf{2009/04/30} \textbf{v0.2} + +\vspace{.5em} +\noindent +\begin{itemize} +\item Not released. Could typeset every not descending letters with comma +below, but only g among descending letters. +\end{itemize} + +\vspace{.5em} +\noindent +\textbf{2009/08/23} \textbf{v0.99a, b, c, d} + +\vspace{.5em} +\noindent +\begin{itemize} +\item Can typeset all letters with comma below, recognizing descendents and +positioning the comma according to them (wrong turned comma above for italics +and slanted characters in 0.99a; wrong vertical position in 0.99c). Since all +of these versions are contemporary, I've just released 0.99d. +\end{itemize} + +\vspace{.5em} +\noindent +\textbf{2009/10/19} \textbf{v0.99d bug fix} + +\begin{itemize} +\item Fixed a problem with fonts like Times. Thanks to Enrico Gregorio. +\end{itemize} + +\vspace{.5em} +\noindent +\textbf{2009/11/10} \textbf{v0.99e} + +\begin{itemize} +\item Now the comma is finally smaller than the current font. Thanks to Enrico +Gregorio for providing me with the necessary code. +\end{itemize} +\end{document} -- cgit v1.2.3