Before authoring a document, decide its primary audience. If
the document contains relatively simple content, e.g., no
mathematical equations etc. and is primarily targeted at the
web, you are probably better off using HTML. You can create
well-structured HTML documents with the help of package
nxml-mode
for editing XML documents. Another
option is to use org-mode
to create a Wiki-like
text document that can be easily published to multiple output
formats including HTML.
Packages org-mode
and nxml-mode
are speech-enabled by Emacspeak to provide auditory icons,
structured navigation and outlines, as well as voice locking
for audio formatted feedback as you work.
If the document being authored is more complex, you are
usually better off creating it in LaTeX. Note that LaTeX
documents can be converted to HTML either via package
tex4ht
— available on the WWW.
The TeX family of typesetting languages is suitable for producing well-formatted documents in an eyes-free environment. Unlike WYSIWYG environments, the author of a TeX or LaTeX document works with the content of the document, leaving it to the formatting system (TeX) to format the document for good visual presentation.
The AUCTeX
package is an Emacs extension that
facilitates authoring and maintaining structured documents in
TeX and LaTeX. Package bibtex
facilitates
maintenance and use of bibtex
bibliography
databases. The Texinfo package allows creation of software
documentation that is suitable for both printing as well as
online viewing as hypertext. Emacspeak speech-enables packages
AUCTeX
, bibtex
and
texinfo
to provide convenient spoken feedback as
you create documents. For details on using these packages, see
their accompanying online info documentation.
As the document preparation system of choice, Emacspeak supports a fluent speech-enabled interface to editing and formatting LaTeX documents. This interface is provided by speech-enabling AUCTeX mode.
Mode AUCTeX provides efficient keyboard shortcuts for inserting and maintaining LaTeX markup as a document is being authored. All of these editing commands provide succinct auditory feedback when used with Emacspeak. The syntax coloring provided by this mode is extended to provide voice locking — consequently, Emacspeak uses different voices to speak the embedded markup to set it apart from the content.
Mode AUCTeX can be used to create empty document templates and to insert document content at the appropriate places in the template. The mode also enables structured navigation of the document as it is being edited. Emacspeak speech-enables these template creation and structured navigation commands to produce auditory icons and succinct spoken feedback. For example, while editing, the user can quickly browse through the sections of the document and have each section title spoken. Document elements such as paragraphs and bulleted lists can be manipulated as logical units. These features are especially relevant in an eyes-free environment where the user needs to select logical parts of the document without having to point at portions of a visual display.