Next: emacspeak-message, Previous: emacspeak-markdown, Up: Emacspeak Commands And Options [Contents][Index]

Do not try what follows until you have read js/node/README.org and successfully set up nvm (Node Version Manager) as described there.

Spoken mathematics on the emacspeak audio desktop. Use a NodeJS based speech-rule-engine for Mathematics as the backend for processing mathematical markup. The result of this processing is an annotated S-expression that is rendered via Emacspeak’s speech facilities. Annotations follow Aural CSS as implemented in Emacspeak, This allows us to map these expressions to aural properties supported by specific TTS engines.

Start the server/client: M-x emacspeak-maths-start. Once the server and client are started, you can browse any number of math expressions using the emacspeak-maths-navigator described below. Note: In general, once everything is configured correctly, using the maths navigator automatically starts the server and client. Invoke the Navigator using s-spc — this is the <windows> key on Linux. Now you can use these keys:

- Show Output <o> Switch to output buffer and quit Maths Navigator
- Enter: <SPC> Enter a LaTeX expression.
- Smart-Enter: <enter> Enter the guessed expression with no prompting.
- Alt-Text <a> Process alt-text under point as LaTeX.
- Down <down> Move down a level.
- Up <up> Move up a level.
- Left <left> Move left.
- Right <right> Move right.
- Exit <any other key> Exit navigator.

The current expression is spoken after each of the above commands. It is also displayed in a special buffer *Spoken Math*. That buffer holds all previously generated output, And Emacs commands forward-page and backward-page can be used to move through each chunk of output.

- Command:
**emacspeak-maths-depth** -
Move depth in current Math expression.

- Command:
**emacspeak-maths-down** -
Move down in current Math expression.

- Command:
**emacspeak-maths-enter***(latex)* -
Send a LaTeX expression to Maths server. Tries to guess default based on context. Uses guessed default if user enters an empty string.

- Command:
**emacspeak-maths-enter-guess** -
Send the guessed LaTeX expression to Maths server. Guess is based on context.

- Command:
**emacspeak-maths-left** -
Move left in current Math expression.

- Command:
**emacspeak-maths-navigator/body** -
`s-SPC`

Create a hydra with no body and the heads: "o": ‘emacspeak-maths-switch-to-output’, "RET": ‘emacspeak-maths-enter-guess’, "SPC": ‘emacspeak-maths-enter’, "a": ‘emacspeak-maths-speak-alt’, "d": ‘emacspeak-maths-depth’, "<up>": ‘emacspeak-maths-up’, "<down>": ‘emacspeak-maths-down’, "<left>": ‘emacspeak-maths-left’, "<right>": ‘emacspeak-maths-right’ The body can be accessed via ‘emacspeak-maths-navigator/body’.

- Command:
**emacspeak-maths-restart** -
Restart Node math-server if running. Otherwise starts a new one.

- Command:
**emacspeak-maths-right** -
Move right in current Math expression.

- Command:
**emacspeak-maths-root** -
Move root in current Math expression.

- Command:
**emacspeak-maths-shutdown** -
Shutdown client and server processes.

- Command:
**emacspeak-maths-speak-alt** -
Speak alt text as Maths. For use on Wikipedia pages for example.

- Command:
**emacspeak-maths-spoken-mode** -
Special mode for interacting with Spoken Math. This mode is used by the special buffer that displays spoken math returned from the Node server. This mode is similar to Emacs’ ‘view-mode’. see the key-binding list at the end of this description. Emacs online help facility to look up help on these commands. key binding — ——- [ backward-page ] forward-page h emacspeak-maths-left j emacspeak-maths-down k emacspeak-maths-up l emacspeak-maths-right In addition to any hooks its parent mode ‘special-mode’ might have run, this mode runs the hook ‘emacspeak-maths-spoken-mode-hook’, as the final or penultimate step during initialization.

- Command:
**emacspeak-maths-start** -
Start Maths server bridge.

- Command:
**emacspeak-maths-switch-to-output** -
Switch to output buffer.

- Command:
**emacspeak-maths-up** -
Move up in current Math expression.

- Variable:
**User Option***emacspeak-maths-inferior-program* -
Location of ‘node’ executable.