From 4a35a6083597c5be84ca9a8c1f2da109d8c3a960 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 5 Dec 2010 00:11:31 +0000 Subject: braille (4dec10) git-svn-id: svn://tug.org/texlive/trunk@20655 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/braille/README | 51 +++- Master/texmf-dist/doc/latex/braille/braille.html | 8 +- Master/texmf-dist/doc/latex/braille/summary.pdf | Bin 67811 -> 57727 bytes Master/texmf-dist/tex/latex/braille/braille.sty | 286 +++++++++++++---------- 4 files changed, 209 insertions(+), 136 deletions(-) diff --git a/Master/texmf-dist/doc/latex/braille/README b/Master/texmf-dist/doc/latex/braille/README index abb8cb6d9c3..67580780f1f 100644 --- a/Master/texmf-dist/doc/latex/braille/README +++ b/Master/texmf-dist/doc/latex/braille/README @@ -1,11 +1,40 @@ -braille.html -- short description of braille.sty, grade[12].py -braillegif1.gif -- transparent image -braillegif2.gif -- transparent image -braille.sty -- LaTeX2e package for typesetting Braille -grade1.py -- Python script to convert text to Grade 1 Braille -grade2.py -- Python script to convert text to Grade 2 Braille -summary.tex -- list of TeX macros and Braille symbols -summary.ps -- postscript of summary.tex - -William Park -April 1999 +Author: +------- + +William Park +September 1998, April 1999 + - original author + +Dominique Unruh +March 2001, October 2001 + - major additions + + +Copyright: +---------- + +Copyright 1998-2010 William Park + +This work may be distributed and/or modified under the +conditions of the LaTeX Project Public License, either version 1.3 +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.3 or later is part of all distributions of LaTeX +version 2005/12/01 or later. + +This work has the LPPL maintenance status `maintained'. + +The Current Maintainer of this work is William Park. + +This work consists of all files listed below: + README -- this file + braille.html -- short description of braille.sty, grade[12].py + braille.sty -- LaTeX2e package for typesetting Braille + braillegif1.gif -- transparent image + braillegif2.gif -- transparent image + grade1.py -- Python script to convert text to Grade 1 Braille + grade2.py -- Python script to convert text to Grade 2 Braille + summary.pdf -- PDF of summary.tex + summary.tex -- list of TeX macros and Braille symbols + diff --git a/Master/texmf-dist/doc/latex/braille/braille.html b/Master/texmf-dist/doc/latex/braille/braille.html index 6f0db66f902..061575135be 100644 --- a/Master/texmf-dist/doc/latex/braille/braille.html +++ b/Master/texmf-dist/doc/latex/braille/braille.html @@ -3,7 +3,7 @@ LaTeX2e package for typesetting Braille

LaTeX2e package for typesetting Braille

-

William Park

+

William Park <opengeometry@yahoo.ca>

April 1999

1    Introduction

@@ -19,7 +19,7 @@ and fonts to typeset 6-dot braille symbols. Both Grade 1 and 2 Braille are supported. All 189 grade 2 contractions are defined; however, some puctuation symbols are missing simply because I couldn't find them. List of TeX macros and braille symbols can be found in -summary.tex and summary.ps. +summary.tex and summary.pdf. The full usage is \usepackage[puttinydots,useemptybox]{braille} where puttinydots puts {\tiny.} at all dot positions @@ -102,8 +102,4 @@ or their usage as python module are
  • 3    grade1.py, grade2.py
  • 4    Table of Contents -


    -This file was generated using HTMLtag package.
    -William Park parkw@better.net
    -April 1999 diff --git a/Master/texmf-dist/doc/latex/braille/summary.pdf b/Master/texmf-dist/doc/latex/braille/summary.pdf index 3e08248a448..ab45bf5fb1d 100644 Binary files a/Master/texmf-dist/doc/latex/braille/summary.pdf and b/Master/texmf-dist/doc/latex/braille/summary.pdf differ diff --git a/Master/texmf-dist/tex/latex/braille/braille.sty b/Master/texmf-dist/tex/latex/braille/braille.sty index 3f9a66ef532..3827121aace 100644 --- a/Master/texmf-dist/tex/latex/braille/braille.sty +++ b/Master/texmf-dist/tex/latex/braille/braille.sty @@ -1,123 +1,171 @@ -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% braille.sty -% -% William Park -% September 1998, April 1999 -% -% Major additions made by Dominique Unruh -% March 2001, October 2001 -% - braille yields error, if invalid points are used in \braillbox -% - Option compact causes loading of \braille and tables to be ommitted -% (saves memory) -% - Option 8dots enables 8-dot braille -% - Option mirror mirrors. -% - Options useemptybox, puttinydots, 8dots, mirror can be switched on and off -% inside the document via \ifbraille...true and \ifbraille...false -% - Documentation in the header of braille.sty updated to reflect above -% changes -% - \braille{} command -% - compatible with e-LaTeX's r2l mode. -% -% -% This package defines macros, commands, and fonts to typeset 6- or -% 8-dot braille symbols for the blinds. Both Grade 1 and 2 Braille are -% supported. All 189 Grade 2 contractions are defined; however, some -% puctuation symbols are missing, simply because I couldn't find them. -% -% Normally, -% \usepackage{braille} -% is sufficient. The command \braille{} takes braille "text" which is -% made up of single character or string enclosed in {}. It converts -% "text" arguments into braille tags and calls predefined TeX macros to -% print out the braille symbols. For example, -% \usepackage{braille} -% \braille{I {like} {com}put{er}} -% will print braille symbols for -% 'I', 'like', 'com', 'p', 'u', 't', 'er' -% along with the 2 spaces. -% -% In the argument, whitespaces are processed by TeX in the usual manner. -% Multiple whitespaces (' ', '\t', '\n') collapse to single space. If -% extra spacing is needed, then it must come from outside of \braille{}. -% -% Examples: -% \braille{September {Number}1998} -% \braille{I run L{in}ux Slackw{ar}e {Number}3.3} -% \braille{{Capital}{this} is LaTeX package {for} {braille} {ou}tput.} -% \braille{I {also} wrote Py{th}on script {for} {con}v{er}t{ing} -% text {to}{braille}.} -% -% Therefore, you can type braille paragraph just as you would type -% normal text paragraph. To print single character, type that -% character. To print multi-character contraction, type that string -% enclosed in {}. -% -% Note that the \braille command assumes English text. Other languages have -% other abbreviations. -% -% The package is used as -% \usepackage[puttinydots,useemptybox,compact,8dots]{braille} -% where -% puttinydots -- puts {\tiny.} at all dot positions for visual check -% useemptybox -- uses empty braille box instead of \hskip -% compact -- load only command \braillebox, not \braille (saves -% memory) -% 8dots -- display 8-dot braille (not used by \braille) -% mirror -- mirrors each braille box (for "printing" braille by hand -% with a needle, use e-LaTeX to get right-to-left -% writing). -% You may activate or deactive inside the document -% puttinydots by \brailleputtinydotstrue resp. \brailleputtinydotsfalse -% useemptybox by \brailleuseemptyboxtrue resp. \brailleuseemptyboxfalse -% 8dots by \brailleeightdotstrue resp. \brailleeightdotsfalse -% mirror by \braillemirrortrue resp. \braillemirrorfalse -% -% Four macros are available to the user: -% \braillebox{} -- LaTeX picture box used as braille font -% \brailleunit -- \unitlength for \braillebox{} -% \brailledot{} -- actual dot printed in \braillebox{} -% \braille{} -- main user command (unless option compact is -% activated) -% -% Additional vertical space between paragraphs may be necessary, since -% \parskip=0pt is default. \braillebox{} is simple LaTeX picture box -% \begin{picture}(2,3) ... \end{picture} -% containing the actual patterns of dot which are placed with -% \put(0.5,0.5){\brailledot} ... -% The size and shape of braille box and dot can be changed by modifying -% \brailleunit and \brailledot{}, respectively. -% -% -% List of TeX macros and braille symbols defined here is summarized in -% summary.tex -- "Summary of Grade 1 and 2 Braille" -% summary.ps -% In order to type the braille tags manually, user would have to know -% Braille. To make it easier for people who don't know Braille, I wrote -% Python scripts to convert ordinary ASCII text into grade 1 and 2 -% braille tags: -% grade1.py -- converts text into grade 1 braille -% grade2.py -- converts text into grade 2 braille -% which behave like any Unix filters. Since my knowledge of Braille is -% limited, there will be errors and omissions. So, check with a braille -% expert. -% -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +% braille.sty +% +% William Park +% September 1998, April 1999 +% - original author +% +% Dominique Unruh +% March 2001, October 2001 +% - major additions +% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +% Copyright 1998-2010 William Park +% +% This work may be distributed and/or modified under the +% conditions of the LaTeX Project Public License, either version 1.3 +% 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.3 or later is part of all distributions of LaTeX +% version 2005/12/01 or later. +% +% This work has the LPPL maintenance status `maintained'. +% +% The Current Maintainer of this work is William Park. +% +% This work consists of all files listed below: +% README -- this file +% braille.html -- short description of braille.sty, grade[12].py +% braille.sty -- LaTeX2e package for typesetting Braille +% braillegif1.gif -- transparent image +% braillegif2.gif -- transparent image +% grade1.py -- Python script to convert text to Grade 1 Braille +% grade2.py -- Python script to convert text to Grade 2 Braille +% summary.pdf -- PDF of summary.tex +% summary.tex -- list of TeX macros and Braille symbols +% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +% +% +% Major additions made by Dominique Unruh +% March 2001, October 2001 +% - braille yields error, if invalid points are used in \braillbox +% - Option compact causes loading of \braille and tables to be ommitted (saves +% memory) +% - Option 8dots enables 8-dot braille +% - Option mirror mirrors. +% - Options useemptybox, puttinydots, 8dots, mirror can be switched on and off +% inside the document via \ifbraille...true and \ifbraille...false +% - Documentation in the header of braille.sty updated to reflect above +% changes +% - \braille{} command +% - compatible with e-LaTeX's r2l mode. +% +% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +% +% Author: +% ------- +% William Park +% September 1998, April 1999 +% +% Description: +% ------------ +% +% This package defines macros, commands, and fonts to typeset 6-dot or 8-dot +% braille symbols for the blinds. Both Grade 1 and 2 Braille are supported. +% All 189 Grade 2 contractions are defined; however, some puctuation symbols +% are missing, simply because I couldn't find them. +% +% Normally, +% \usepackage{braille} +% is sufficient. The command \braille{} takes braille "text" which is made up +% of single character or string enclosed in {}. It converts "text" arguments +% into braille tags and calls predefined TeX macros to print out the braille +% symbols. For example, +% \usepackage{braille} +% \braille{I {like} {com}put{er}} +% will print braille symbols for +% 'I', 'like', 'com', 'p', 'u', 't', 'er' +% along with the 2 spaces. +% +% In the argument, whitespaces are processed by TeX in the usual manner. +% Multiple whitespaces (' ', '\t', '\n') collapse to single space. If extra +% spacing is needed, then it must come from outside of \braille{}. +% +% Examples: +% \braille{September {Number}1998} +% \braille{I run L{in}ux Slackw{ar}e {Number}3.3} +% \braille{{Capital}{this} is LaTeX package {for} {braille} {ou}tput.} +% \braille{I {also} wrote Py{th}on script {for} {con}v{er}t{ing} text +% {to}{braille}.} +% +% Therefore, you can type braille paragraph just as you would type normal text +% paragraph. To print single character, type that character. To print +% multi-character contraction, type that string enclosed in {}. +% +% Note that the \braille command assumes English text. Other languages have +% other abbreviations. +% +% +% Options: +% -------- +% +% The package is used as +% \usepackage[puttinydots,useemptybox,compact,8dots]{braille} +% where +% puttinydots -- puts {\tiny.} at all dot positions for visual check +% useemptybox -- uses empty braille box instead of \hskip +% compact -- load only command \braillebox, not \braille (saves memory) +% 8dots -- display 8-dot braille (not used by \braille) +% mirror -- mirrors each braille box (for "printing" braille by hand +% with a needle, use e-LaTeX to get right-to-left writing). +% +% You may activate or deactive inside the document +% puttinydots by \brailleputtinydotstrue resp. \brailleputtinydotsfalse +% useemptybox by \brailleuseemptyboxtrue resp. \brailleuseemptyboxfalse +% 8dots by \brailleeightdotstrue resp. \brailleeightdotsfalse +% mirror by \braillemirrortrue resp. \braillemirrorfalse +% +% Four macros are available to the user: +% \braillebox{} -- LaTeX picture box used as braille font +% \brailleunit -- \unitlength for \braillebox{} +% \brailledot{} -- actual dot printed in \braillebox{} +% \braille{} -- main user command (unless option compact is activated) +% +% Additional vertical space between paragraphs may be necessary, since +% \parskip=0pt is default. \braillebox{} is simple LaTeX picture box +% \begin{picture}(2,3) ... \end{picture} +% containing the actual patterns of dot which are placed with +% \put(0.5,0.5){\brailledot} ... +% The size and shape of braille box and dot can be changed by modifying +% \brailleunit and \brailledot{}, respectively. +% +% +% Other Files: +% ------------ +% +% List of TeX macros and braille symbols defined here is summarized in +% summary.tex -- "Summary of Grade 1 and 2 Braille" +% summary.pdf +% In order to type the braille tags manually, user would have to know Braille. +% To make it easier for people who don't know Braille, I wrote Python scripts +% to convert ordinary ASCII text into grade 1 and 2 braille tags: +% grade1.py -- converts text into grade 1 braille +% grade2.py -- converts text into grade 2 braille +% which behave like any Unix filters. Since my knowledge of Braille is +% limited, there will be errors and omissions. So, check with a braille +% expert. +% +% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \NeedsTeXFormat{LaTeX2e} \ProvidesPackage{braille} % With options -% puttinydots = put {\tiny.} at all dot positions -% useemptybox = use empty braille box for space, not \hskip +% puttinydots = put {\tiny.} at all dot positions +% useemptybox = use empty braille box for space, not \hskip % Usage: \braillebox{12345678} % Put dot (\brailledot) at positions 1, 2, 3, 4, 5, 6, 7, 8 % Dot locations: -% 14 -% 25 -% 36 -% 78 +% 14 +% 25 +% 36 +% 78 % \newlength{\brailleunit} % size of box containing one dot \setlength{\brailleunit}{2mm} @@ -250,7 +298,7 @@ \newcommand{\suffix@char}[3]{\new@char{#3}{\old@char{#1}\braillebox{#2}}} -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % Defines \BRAILLE... % where ... can be one or more characters. @@ -304,14 +352,14 @@ \def@char{z}{1356} \prefix@char{6}{z}{Z} \ln@char{z}{as} % Punctuation -\def@char{,}{2} \ln@char{,}{ea} -\def@char{;}{23} \ln@char{;}{bb} \ln@char{;}{be} -\def@char{:}{25} \ln@char{:}{cc} \ln@char{:}{con} -\def@char{.}{256} \ln@char{.}{$} \ln@char{.}{dd} \ln@char{.}{dis} -\def@char{!}{235} \ln@char{!}{ff} \ln@char{!}{to} -\def@char{(}{2356} \ln@char{(}{)} \ln@char{(}{gg} \ln@char{(}{were} -\def@char{``}{236} \ln@char{``}{?} \ln@char{``}{his} -\def@char{''}{356} \ln@char{''}{by} \ln@char{''}{was} +\def@char{,}{2} \ln@char{,}{ea} +\def@char{;}{23} \ln@char{;}{bb} \ln@char{;}{be} +\def@char{:}{25} \ln@char{:}{cc} \ln@char{:}{con} +\def@char{.}{256} \ln@char{.}{$} \ln@char{.}{dd} \ln@char{.}{dis} +\def@char{!}{235} \ln@char{!}{ff} \ln@char{!}{to} +\def@char{(}{2356} \ln@char{(}{)} \ln@char{(}{gg} \ln@char{(}{were} +\def@char{``}{236} \ln@char{``}{?} \ln@char{``}{his} +\def@char{''}{356} \ln@char{''}{by} \ln@char{''}{was} \def@char{-}{36} \ln@char{-}{com} \def@char{'}{3} \def@char{/}{34} -- cgit v1.2.3