-
Notifications
You must be signed in to change notification settings - Fork 2
/
Copy pathreadme.html
349 lines (336 loc) · 14.4 KB
/
readme.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<!-- 2023-01-16 Mon 10:26 -->
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>AsTeR: Spoken Math On The Emacspeak Audio Desktop</title>
<meta name="author" content="T.V Raman" />
<meta name="generator" content="Org Mode" />
<style>
#content { max-width: 60em; margin: auto; }
.title { text-align: center;
margin-bottom: .2em; }
.subtitle { text-align: center;
font-size: medium;
font-weight: bold;
margin-top:0; }
.todo { font-family: monospace; color: red; }
.done { font-family: monospace; color: green; }
.priority { font-family: monospace; color: orange; }
.tag { background-color: #eee; font-family: monospace;
padding: 2px; font-size: 80%; font-weight: normal; }
.timestamp { color: #bebebe; }
.timestamp-kwd { color: #5f9ea0; }
.org-right { margin-left: auto; margin-right: 0px; text-align: right; }
.org-left { margin-left: 0px; margin-right: auto; text-align: left; }
.org-center { margin-left: auto; margin-right: auto; text-align: center; }
.underline { text-decoration: underline; }
#postamble p, #preamble p { font-size: 90%; margin: .2em; }
p.verse { margin-left: 3%; }
pre {
border: 1px solid #e6e6e6;
border-radius: 3px;
background-color: #f2f2f2;
padding: 8pt;
font-family: monospace;
overflow: auto;
margin: 1.2em;
}
pre.src {
position: relative;
overflow: auto;
}
pre.src:before {
display: none;
position: absolute;
top: -8px;
right: 12px;
padding: 3px;
color: #555;
background-color: #f2f2f299;
}
pre.src:hover:before { display: inline; margin-top: 14px;}
/* Languages per Org manual */
pre.src-asymptote:before { content: 'Asymptote'; }
pre.src-awk:before { content: 'Awk'; }
pre.src-authinfo::before { content: 'Authinfo'; }
pre.src-C:before { content: 'C'; }
/* pre.src-C++ doesn't work in CSS */
pre.src-clojure:before { content: 'Clojure'; }
pre.src-css:before { content: 'CSS'; }
pre.src-D:before { content: 'D'; }
pre.src-ditaa:before { content: 'ditaa'; }
pre.src-dot:before { content: 'Graphviz'; }
pre.src-calc:before { content: 'Emacs Calc'; }
pre.src-emacs-lisp:before { content: 'Emacs Lisp'; }
pre.src-fortran:before { content: 'Fortran'; }
pre.src-gnuplot:before { content: 'gnuplot'; }
pre.src-haskell:before { content: 'Haskell'; }
pre.src-hledger:before { content: 'hledger'; }
pre.src-java:before { content: 'Java'; }
pre.src-js:before { content: 'Javascript'; }
pre.src-latex:before { content: 'LaTeX'; }
pre.src-ledger:before { content: 'Ledger'; }
pre.src-lisp:before { content: 'Lisp'; }
pre.src-lilypond:before { content: 'Lilypond'; }
pre.src-lua:before { content: 'Lua'; }
pre.src-matlab:before { content: 'MATLAB'; }
pre.src-mscgen:before { content: 'Mscgen'; }
pre.src-ocaml:before { content: 'Objective Caml'; }
pre.src-octave:before { content: 'Octave'; }
pre.src-org:before { content: 'Org mode'; }
pre.src-oz:before { content: 'OZ'; }
pre.src-plantuml:before { content: 'Plantuml'; }
pre.src-processing:before { content: 'Processing.js'; }
pre.src-python:before { content: 'Python'; }
pre.src-R:before { content: 'R'; }
pre.src-ruby:before { content: 'Ruby'; }
pre.src-sass:before { content: 'Sass'; }
pre.src-scheme:before { content: 'Scheme'; }
pre.src-screen:before { content: 'Gnu Screen'; }
pre.src-sed:before { content: 'Sed'; }
pre.src-sh:before { content: 'shell'; }
pre.src-sql:before { content: 'SQL'; }
pre.src-sqlite:before { content: 'SQLite'; }
/* additional languages in org.el's org-babel-load-languages alist */
pre.src-forth:before { content: 'Forth'; }
pre.src-io:before { content: 'IO'; }
pre.src-J:before { content: 'J'; }
pre.src-makefile:before { content: 'Makefile'; }
pre.src-maxima:before { content: 'Maxima'; }
pre.src-perl:before { content: 'Perl'; }
pre.src-picolisp:before { content: 'Pico Lisp'; }
pre.src-scala:before { content: 'Scala'; }
pre.src-shell:before { content: 'Shell Script'; }
pre.src-ebnf2ps:before { content: 'ebfn2ps'; }
/* additional language identifiers per "defun org-babel-execute"
in ob-*.el */
pre.src-cpp:before { content: 'C++'; }
pre.src-abc:before { content: 'ABC'; }
pre.src-coq:before { content: 'Coq'; }
pre.src-groovy:before { content: 'Groovy'; }
/* additional language identifiers from org-babel-shell-names in
ob-shell.el: ob-shell is the only babel language using a lambda to put
the execution function name together. */
pre.src-bash:before { content: 'bash'; }
pre.src-csh:before { content: 'csh'; }
pre.src-ash:before { content: 'ash'; }
pre.src-dash:before { content: 'dash'; }
pre.src-ksh:before { content: 'ksh'; }
pre.src-mksh:before { content: 'mksh'; }
pre.src-posh:before { content: 'posh'; }
/* Additional Emacs modes also supported by the LaTeX listings package */
pre.src-ada:before { content: 'Ada'; }
pre.src-asm:before { content: 'Assembler'; }
pre.src-caml:before { content: 'Caml'; }
pre.src-delphi:before { content: 'Delphi'; }
pre.src-html:before { content: 'HTML'; }
pre.src-idl:before { content: 'IDL'; }
pre.src-mercury:before { content: 'Mercury'; }
pre.src-metapost:before { content: 'MetaPost'; }
pre.src-modula-2:before { content: 'Modula-2'; }
pre.src-pascal:before { content: 'Pascal'; }
pre.src-ps:before { content: 'PostScript'; }
pre.src-prolog:before { content: 'Prolog'; }
pre.src-simula:before { content: 'Simula'; }
pre.src-tcl:before { content: 'tcl'; }
pre.src-tex:before { content: 'TeX'; }
pre.src-plain-tex:before { content: 'Plain TeX'; }
pre.src-verilog:before { content: 'Verilog'; }
pre.src-vhdl:before { content: 'VHDL'; }
pre.src-xml:before { content: 'XML'; }
pre.src-nxml:before { content: 'XML'; }
/* add a generic configuration mode; LaTeX export needs an additional
(add-to-list 'org-latex-listings-langs '(conf " ")) in .emacs */
pre.src-conf:before { content: 'Configuration File'; }
table { border-collapse:collapse; }
caption.t-above { caption-side: top; }
caption.t-bottom { caption-side: bottom; }
td, th { vertical-align:top; }
th.org-right { text-align: center; }
th.org-left { text-align: center; }
th.org-center { text-align: center; }
td.org-right { text-align: right; }
td.org-left { text-align: left; }
td.org-center { text-align: center; }
dt { font-weight: bold; }
.footpara { display: inline; }
.footdef { margin-bottom: 1em; }
.figure { padding: 1em; }
.figure p { text-align: center; }
.equation-container {
display: table;
text-align: center;
width: 100%;
}
.equation {
vertical-align: middle;
}
.equation-label {
display: table-cell;
text-align: right;
vertical-align: middle;
}
.inlinetask {
padding: 10px;
border: 2px solid gray;
margin: 10px;
background: #ffffcc;
}
#org-div-home-and-up
{ text-align: right; font-size: 70%; white-space: nowrap; }
textarea { overflow-x: auto; }
.linenr { font-size: smaller }
.code-highlighted { background-color: #ffff00; }
.org-info-js_info-navigation { border-style: none; }
#org-info-js_console-label
{ font-size: 10px; font-weight: bold; white-space: nowrap; }
.org-info-js_search-highlight
{ background-color: #ffff00; color: #000000; font-weight: bold; }
.org-svg { }
</style>
<base href="http://emacspeak.sf.net/raman"/>
</head>
<body>
<div id="content" class="content">
<h1 class="title">AsTeR: Spoken Math On The Emacspeak Audio Desktop</h1>
<div id="outline-container-org610668c" class="outline-2">
<h2 id="org610668c"><span class="section-number-2">1.</span> Dedication</h2>
<div class="outline-text-2" id="text-1">
<div class="org-center">
<p>
To My Guiding Eyes
</p>
</div>
<p>
In fond memory of <a href="http://emacspeak.sf.net/raman/aster-labrador">Aster</a> who first showed the way for 10 years; to <a href="http://emacspeak.sf.net/raman/hubbell-labrador">Hubbell</a> and
<a href="http://emacspeak.sf.net/raman/tilden-labrador">Tilden</a> who ably followed her lead over the next 22+ years!
</p>
<table>
<tr><td colspan="3">On The Internet</td></tr>
<tr>
<td><strong>No one knows you're not a dog!</strong></td>
<td><strong>Nor if you're the same dog!</strong></td>
<td><strong>Or even the same gender!</strong></td>
</tr>
<tr>
<td><a href="aster-labrador/">
<img src="aster-labrador/aster-geb-graduation.jpg"
alt="Aster Labrador" width="150" height="216" /></a>
<br/>(2/15/1987—12/05/1999)</td>
<td><a href="hubbell-labrador/">
<img
src="hubbell-labrador/hubbell-and-raman.jpg" width="150" height="216"
alt=" Hubbell Labrador" /></a>
<br/>(12/21/1997—4/11/2011)</td>
<td><a href="tilden-labrador/">
<img src="tilden-labrador/raman-and-tilden-geb.jpg"
alt="Tilden Labrador" width="150"
height="216" /></a>
<br/>(8/4/2009—9/3/2022)</td>
</tr>
</table>
</div>
</div>
<div id="outline-container-orgcddbff8" class="outline-2">
<h2 id="orgcddbff8"><span class="section-number-2">2.</span> Overview</h2>
<div class="outline-text-2" id="text-2">
<p>
The work describing Audio System For Technical Readings <a href="https://emacspeak.sourceforge.net/raman/aster/abstract.html">(AsTeR)</a> was
presented to the Faculty of the Graduate School of Cornell University
on Monday, Jan 17, 1994 for my <a href="http://awards.acm.org/award_winners/raman_4110221.cfm">PhD</a>. This release
is an updated version of AsTeR using the Software DECTalk.
</p>
</div>
</div>
<div id="outline-container-org2f8be67" class="outline-2">
<h2 id="org2f8be67"><span class="section-number-2">3.</span> Implementation</h2>
<div class="outline-text-2" id="text-3">
<ul class="org-ul">
<li>AsTeR <i>audio-formats</i> <b>TeX</b> and <b>LaTeX</b>.</li>
<li>User interface is implemented in Emacs.</li>
<li>The audio-formatter is implemented in Common Lisp (SBCL) and uses the Emacspeak speech-server <code>dtk-soft</code>.</li>
<li>Emacs commands call Common Lisp via <i>slime</i> to communicate with AsTeR.</li>
</ul>
</div>
</div>
<div id="outline-container-org0dc12d1" class="outline-2">
<h2 id="org0dc12d1"><span class="section-number-2">4.</span> Prerequisites</h2>
<div class="outline-text-2" id="text-4">
<ul class="org-ul">
<li>Install Emacspeak 57.0 or later from Github.</li>
<li>Install <i>slime</i> and <i>auctex</i> using <code>M-x package-install</code>.</li>
<li>Install <i>flex</i>, <i>SBCL</i> and <i>cl-asdf</i> using the linux package manager.</li>
<li>Install <a href="https://github.com/dectalk/dectalk">Software DECTalk</a> from Github.</li>
</ul>
</div>
</div>
<div id="outline-container-org8eb9165" class="outline-2">
<h2 id="org8eb9165"><span class="section-number-2">5.</span> Building AsTeR</h2>
<div class="outline-text-2" id="text-5">
<ol class="org-ol">
<li><code>cd</code> <emacspeak> to change to your <code>emacspeak</code> directory.</li>
<li>Get source via git checkout <a href="https://github.com/tvraman/aster-math">https://github.com/tvraman/aster-math</a></li>
<li><code>cd aster-math/lisp && make</code></li>
</ol>
</div>
</div>
<div id="outline-container-orgf107455" class="outline-2">
<h2 id="orgf107455"><span class="section-number-2">6.</span> Usage</h2>
<div class="outline-text-2" id="text-6">
<ul class="org-ul">
<li>Add directory <code>aster-math/ui/</code> to your Emacs <code>load-path</code>.</li>
<li>Run <code>M-x load-library</code> <i>aster</i>; <code>M-x aster</code>.</li>
<li>Aster commands are on Emacs prefix-key
<code>C-; SPC</code> and <code>C-' a</code>.</li>
<li><code>M-x describe-function aster</code> displays help.</li>
<li>Optional: Set environment variable <code>ASTER_TTS</code> to the pulseaudio device
you wish to use: e.g., <code>export ASTER_TTS=tts_left</code> will result in
AsTeR using the left audio channel for output.</li>
</ul>
<p>
To speak math, send <i>La)TeX</i> to AsTeR from any Emacs
buffer.
</p>
<ol class="org-ol">
<li>When editing LaTeX — including from within org-mode buffers.</li>
<li>When browsing Wikipedia pages containing mathematics using Emacs'
EWW browser. (Make sure to first disable <code>shr-discard-aria-hidden</code>).</li>
<li>From Emacs Calculator (calc).</li>
<li>From the Emacs interface to Sage — a symbolic algebra system.</li>
<li>Send a TeX file e.g., <code>etc/demo.tex</code>.</li>
<li>Papers from <a href="https://arxiv.org/">arxiv.org</a> — see <a href="https://info.arxiv.org/about/accessibility_research_report.html">Arxiv.org Accessibility Report</a></li>
</ol>
<ul class="org-ul">
<li>Once Aster starts speaking, you can use Aster's
browser to move around.</li>
</ul>
</div>
</div>
<div id="outline-container-orgd88dd8a" class="outline-2">
<h2 id="orgd88dd8a"><span class="section-number-2">7.</span> References</h2>
<div class="outline-text-2" id="text-7">
<ol class="org-ol">
<li><a href="https://emacspeak.sourceforge.net/raman/aster/2022-aster.ogg">Demo recorded in October 2022</a>.</li>
<li><a href="https://emacspeak.sourceforge.net/raman/aster/aster-toplevel.html">Demo recorded in 1994</a>.</li>
<li><a href="http://emacspeak.sf.net/raman/amsci-96.pdf">Brian Hayes: Speaking Of Mathematics</a>, American Scientist, March
1996 — An accessible overview of AsTeR.</li>
<li><a href="https://emacspeak.sourceforge.net/raman/sciam-0996profile.html">Envisioning Speech:Scientific American</a>, Wayte Gibbs, September 1996
— Describes AsTeR, Audio-formatting and Emacspeak.</li>
<li><a href="https://emacspeak.sourceforge.net/raman/publications/rfb-math-workshop/">Proceedings: RFB Math & Science Symposium</a>, May 12 – 13 1994.</li>
<li><a href="https://emacspeak.sourceforge.net/raman/phd-thesis/index.html">PHd Thesis</a>, January 1994.</li>
</ol>
</div>
</div>
</div>
<div id="postamble" class="status">
<p class="date">Date: 2022-11-28 Mon 00:00</p>
<p class="author">Author: T.V Raman</p>
<p class="date">Created: 2023-01-16 Mon 10:26</p>
<p class="validation"><a href="https://validator.w3.org/check?uri=referer">Validate</a></p>
</div>
</body>
</html>