872 lines
21 KiB
HTML
872 lines
21 KiB
HTML
<HTML
|
|
><HEAD
|
|
><TITLE
|
|
>Productivity</TITLE
|
|
><META
|
|
NAME="GENERATOR"
|
|
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
|
|
"><LINK
|
|
REL="HOME"
|
|
TITLE="Emacspeak User's Guide"
|
|
HREF="index.html"><LINK
|
|
REL="PREVIOUS"
|
|
TITLE="Working online"
|
|
HREF="working-online.html"><LINK
|
|
REL="NEXT"
|
|
TITLE="Entertainment"
|
|
HREF="entertainment.html"></HEAD
|
|
><BODY
|
|
CLASS="sect1"
|
|
BGCOLOR="#FFFFFF"
|
|
TEXT="#000000"
|
|
LINK="#0000FF"
|
|
VLINK="#840084"
|
|
ALINK="#0000FF"
|
|
><DIV
|
|
CLASS="NAVHEADER"
|
|
><TABLE
|
|
SUMMARY="Header navigation table"
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
CELLPADDING="0"
|
|
CELLSPACING="0"
|
|
><TR
|
|
><TH
|
|
COLSPAN="3"
|
|
ALIGN="center"
|
|
>Emacspeak User's Guide</TH
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="10%"
|
|
ALIGN="left"
|
|
VALIGN="bottom"
|
|
><A
|
|
HREF="working-online.html"
|
|
ACCESSKEY="P"
|
|
>Prev</A
|
|
></TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="center"
|
|
VALIGN="bottom"
|
|
></TD
|
|
><TD
|
|
WIDTH="10%"
|
|
ALIGN="right"
|
|
VALIGN="bottom"
|
|
><A
|
|
HREF="entertainment.html"
|
|
ACCESSKEY="N"
|
|
>Next</A
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><HR
|
|
ALIGN="LEFT"
|
|
WIDTH="100%"></DIV
|
|
><DIV
|
|
CLASS="sect1"
|
|
><H1
|
|
CLASS="sect1"
|
|
><A
|
|
NAME="productivity">7. Productivity</H1
|
|
><P
|
|
>Emacs provides many applications that can help you get your work done. From coding to writing a dissertation to scheduling appointments, you can do just about anything from within Emacs.</P
|
|
><DIV
|
|
CLASS="sect2"
|
|
><H2
|
|
CLASS="sect2"
|
|
><A
|
|
NAME="writing-code">7.1. Coding in Emacs</H2
|
|
><P
|
|
>Emacs has "major modes" (essentially editors) for Lisp, Scheme, Awk, C, C++, FORTRAN, Icon, Java, Objective-C, Pascal, Perl, and Tcl. You can invoke a major mode by creating and/or opening a file with the appropriate extension. For example, to invoke the c++ major mode, create a file with a <TT
|
|
CLASS="filename"
|
|
>.cpp</TT
|
|
> extension and then open that file. You can also download additional major modes, such as SGML.</P
|
|
><P
|
|
>Because of the breadth of coding options, it is beyond the scope of this document to cover them all. However, there is an extensive section in the Gnu Emacs Manual on coding available at
|
|
<A
|
|
HREF="http://www.delorie.com/gnu/docs/emacs/emacs_238.html"
|
|
TARGET="_top"
|
|
>http://www.delorie.com/gnu/docs/emacs/emacs_238.html</A
|
|
>. </P
|
|
></DIV
|
|
><DIV
|
|
CLASS="sect2"
|
|
><H2
|
|
CLASS="sect2"
|
|
><A
|
|
NAME="customization">7.2. Customizing Emacspeak</H2
|
|
><P
|
|
>Emacspeak contains many options for customization. The most commonly requested options are covered here, but if there's something else that should be included, please do not hesitate to suggest it.</P
|
|
><DIV
|
|
CLASS="sect3"
|
|
><H3
|
|
CLASS="sect3"
|
|
><A
|
|
NAME="changing-the-speech-rate">7.2.1. Changing the speech rate</H3
|
|
><P
|
|
>The default Emacspeak speech rate may be too slow or fast for your tastes, so you can customize it in your <TT
|
|
CLASS="filename"
|
|
>.emacs</TT
|
|
> file. To do so, add the following lines to your <TT
|
|
CLASS="filename"
|
|
>.emacs</TT
|
|
> file: </P
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="programlisting"
|
|
>(setq dtk-default-speech-rate 410) (setq outloud-default-speech-rate 90)</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
>The numerical values in these commands are the speech rate, in words per minute. The examples above are for the Dectalk Express and the ViaVoice Outloud synthesizers.</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="sect3"
|
|
><H3
|
|
CLASS="sect3"
|
|
><A
|
|
NAME="auditory-icons">7.2.2. Auditory Icons for Emacspeak</H3
|
|
><P
|
|
>Ann Parsons wrote a great explanation of the Emacspeak desktop and auditory icons that you can read at
|
|
<A
|
|
HREF="http://www.cs.vassar.edu/~priestdo/emacspeak/msg00256.html"
|
|
TARGET="_top"
|
|
>http://www.cs.vassar.edu/~priestdo/emacspeak/msg00256.html</A
|
|
>. In a nutshell, auditory icons provide you with feedback when you perform different tasks in Emacs. You can get audible feedback when you change buffers, quit a program, enter the buffers list, edit C code, etc.</P
|
|
><P
|
|
>If you want to use auditory icons and ViaVoice is your speech synthesizer, check to see whether or not you have a multi-channel sound card (try playing a CD and a .au file at the same time - if it works, you have a multi-channel card). If your card is not multi-channel, you must install the application <SPAN
|
|
CLASS="application"
|
|
>stdiom</SPAN
|
|
> as follows:</P
|
|
><P
|
|
></P
|
|
><OL
|
|
TYPE="1"
|
|
><LI
|
|
><P
|
|
>Download the application <SPAN
|
|
CLASS="application"
|
|
>stdiosynth</SPAN
|
|
> from
|
|
<A
|
|
HREF="http://www.leb.net/pub/blinux/emacspeak/blinux/stdiom.tar.gz"
|
|
TARGET="_top"
|
|
>http://www.leb.net/pub/blinux/emacspeak/blinux/stdiom.tar.gz</A
|
|
>. </P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>Log in to your machine as root, then change to the directory where you placed the downloaded file <TT
|
|
CLASS="filename"
|
|
>stdiom.tar.gz</TT
|
|
>.</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>Unzip the file using the command <B
|
|
CLASS="command"
|
|
>gunzip stdiom.tar.gz</B
|
|
>.</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>Untar the resulting file using the command <B
|
|
CLASS="command"
|
|
>tar -xvf stdiom.tar</B
|
|
>.</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>Change directories to the resulting <TT
|
|
CLASS="filename"
|
|
>stdio_musician1.0</TT
|
|
> directory and type <B
|
|
CLASS="command"
|
|
>make</B
|
|
>. You should get a message that says, "stdiosynth is up to date."</P
|
|
></LI
|
|
></OL
|
|
><P
|
|
>Currently there are two auditory icon themes that you can download from the Emacspeak website, called Chimes and Cartoons. Chimes is made up of different chimes and short notes from various instruments. The icons are high-quality 44K-mono, and can be downloaded from <A
|
|
HREF="http://emacspeak.sourceforge.net/chimes-mono.tar.gz"
|
|
TARGET="_top"
|
|
>http://emacspeak.sourceforge.net/chimes-mono.tar.gz</A
|
|
>. The Cartoons theme was contributed by Bryan Smart and is made up of 22K-mono sounds. You can download it from
|
|
<A
|
|
HREF="http://emacspeak.sourceforge.net/cartoons-mono.tar.gz"
|
|
TARGET="_top"
|
|
>http://emacspeak.sourceforge.net/cartoons-mono.tar.gz</A
|
|
>.</P
|
|
><P
|
|
>To install either of these themes, download and unpack the archives into the emacspeak/sounds directory in your emacspeak installation. You can then select themes you have already installed by using the Emacspeak command <B
|
|
CLASS="command"
|
|
>M-x emacspeak-sounds-select-theme</B
|
|
>. Alternatively, you can add the following lines to your <TT
|
|
CLASS="filename"
|
|
>.emacspeak </TT
|
|
> file:</P
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="programlisting"
|
|
>(setq emacspeak-toggle-auditory-icons t) (when (emacspeak-sounds-theme-p "chimes-mono") (emacspeak-sounds-select-theme "chimes-mono/" ))</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
>Some people use sound cards that can play multiple channels to produce their auditory icons. For this option, set<B
|
|
CLASS="command"
|
|
>emacspeak-aumix-multichannel-capable-p</B
|
|
> to <B
|
|
CLASS="command"
|
|
>t</B
|
|
> in your <TT
|
|
CLASS="filename"
|
|
>.emacs</TT
|
|
> file:
|
|
</P
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="programlisting"
|
|
>(setq emacspeak-aumix-multichannel-capable-p t) </PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="sect2"
|
|
><H2
|
|
CLASS="sect2"
|
|
><A
|
|
NAME="reading-adobe-acrobat-files">7.3. Reading Adobe Acrobat files</H2
|
|
><P
|
|
>There are two ways to view an Adobe Acrobat PDF file with Emacspeak. The first option is to generate a text version of the PDF using <SPAN
|
|
CLASS="application"
|
|
>Xpdf</SPAN
|
|
>, then read the text version. The second option is the use Adobe's PDF to HTML converter, then read the HTML file.</P
|
|
><DIV
|
|
CLASS="sect3"
|
|
><H3
|
|
CLASS="sect3"
|
|
><A
|
|
NAME="using-xpdf">7.3.1. Using Xpdf</H3
|
|
><P
|
|
>To generate a text version of the PDF, you'll need to download the <SPAN
|
|
CLASS="application"
|
|
>Xpdf</SPAN
|
|
> package. The main website is at <A
|
|
HREF="http://www.foolabs.com/xpdf/"
|
|
TARGET="_top"
|
|
>http://www.foolabs.com/xpdf/</A
|
|
>, and you can download a precompiled binary (unless, of course, you're interested in playing with the source code, in which case you'd download the source) from <A
|
|
HREF="ftp://ftp.foolabs.com/pub/xpdf/xpdf-0.92-linux2.0.tgz"
|
|
TARGET="_top"
|
|
>ftp://ftp.foolabs.com/pub/xpdf/xpdf-0.92-linux2.0.tgz</A
|
|
>.</P
|
|
><P
|
|
>Assuming that you downloaded the binary file <TT
|
|
CLASS="filename"
|
|
>xpdf-0.92-linux2.0.tgz</TT
|
|
>, to install and run<SPAN
|
|
CLASS="application"
|
|
>Xpdf</SPAN
|
|
>: </P
|
|
><P
|
|
></P
|
|
><OL
|
|
TYPE="1"
|
|
><LI
|
|
><P
|
|
>Open an Emacs command shell using <B
|
|
CLASS="command"
|
|
>M-x shell</B
|
|
>.</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>Change to the appropriate directory where the <TT
|
|
CLASS="filename"
|
|
>xpdf-0.92-linux2.0.tgz</TT
|
|
> file is located, then unzip the file using <B
|
|
CLASS="command"
|
|
>gunzip xpdf-0.92-linux2.0.tgz</B
|
|
>.</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>Decompress the resulting <TT
|
|
CLASS="filename"
|
|
>xpdf-0.92-linux2.0.tar</TT
|
|
> file using the command <B
|
|
CLASS="command"
|
|
>tar -xvf xpdf-0.92-linux2.0.tar</B
|
|
>.</P
|
|
></LI
|
|
></OL
|
|
><P
|
|
>The resulting directory will be called <TT
|
|
CLASS="filename"
|
|
>xpdf-0.92-linux2.0</TT
|
|
>. Within this directory are a number of applications, including <SPAN
|
|
CLASS="application"
|
|
>pdfimages</SPAN
|
|
>, <SPAN
|
|
CLASS="application"
|
|
>pdfinfo</SPAN
|
|
>, <SPAN
|
|
CLASS="application"
|
|
>pdftopbm</SPAN
|
|
>, <SPAN
|
|
CLASS="application"
|
|
>pdftops</SPAN
|
|
>, <SPAN
|
|
CLASS="application"
|
|
>pdftotext</SPAN
|
|
>, and <SPAN
|
|
CLASS="application"
|
|
>xpdf</SPAN
|
|
>. You can find out what each of these applications does from the README file also included in the director the Emacs command shell as follows:</P
|
|
><P
|
|
></P
|
|
><OL
|
|
TYPE="1"
|
|
><LI
|
|
><P
|
|
>Open an Emacs shell window using the command <B
|
|
CLASS="command"
|
|
>M-x shell</B
|
|
>.</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>At the prompt, type <B
|
|
CLASS="command"
|
|
>pdftotext <TT
|
|
CLASS="filename"
|
|
>filename.pdf</TT
|
|
></B
|
|
>.</P
|
|
><P
|
|
>Result: The file is converted to text. You can read the resulting text file with Emacs.</P
|
|
></LI
|
|
></OL
|
|
></DIV
|
|
><DIV
|
|
CLASS="sect3"
|
|
><H3
|
|
CLASS="sect3"
|
|
><A
|
|
NAME="using-adobes-converter">7.3.2. Using Adobe's converter</H3
|
|
><P
|
|
>As an alternative to <SPAN
|
|
CLASS="application"
|
|
>Xpdf</SPAN
|
|
>, you can use Adobe's PDF to HTML converter if the PDF file you want to read has a URL. To convert a file:</P
|
|
><P
|
|
></P
|
|
><OL
|
|
TYPE="1"
|
|
><LI
|
|
><P
|
|
>Use <SPAN
|
|
CLASS="application"
|
|
>W3</SPAN
|
|
> to go to <A
|
|
HREF="http://access.adobe.com/simple_form.html"
|
|
TARGET="_top"
|
|
>http://access.adobe.com/simple_form.html</A
|
|
>.</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>Type in the URL of the PDF file to convert.</P
|
|
><P
|
|
>Result: The file is converted it HTML. You can use W3 to read and navigate within the file.</P
|
|
></LI
|
|
></OL
|
|
><P
|
|
>Tests show that this conversion works very well on some PDFdocuments, but not so well on others. If the HTML file you end up with isn't readable, try using <SPAN
|
|
CLASS="application"
|
|
>Xpdf</SPAN
|
|
> to convert to a plain text file.</P
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="sect2"
|
|
><H2
|
|
CLASS="sect2"
|
|
><A
|
|
NAME="calendar-and-appointments">7.4. Scheduling appointments and calendar events</H2
|
|
><P
|
|
>Emacs has a built-in desk calendar that includes a diary for planned events. The calendar and diary support both US and European date formats, but default to the US format. The diary keeps track of appointments and reminders using a diary file, a text file that contains a list of events and their dates. You can have Emacs send you an email every day with your schedule, or you can look at the calendar to view the day's events.</P
|
|
><P
|
|
>To start the calendar application, use the command <B
|
|
CLASS="command"
|
|
>M-x calendar</B
|
|
>. Calendar navigation commands are, for the most part, identical to text navigation commands, and you can also use the arrow keys to navigate.</P
|
|
><P
|
|
>If you'd like to use the diary, you need to create a diary file that contains your events. The diary file is a simple text file, and, by default, Emacs uses <TT
|
|
CLASS="filename"
|
|
>~/diary</TT
|
|
> as the diary file. Although you'll need to create the file manually, there are commands that allow you to add, view, and change diary entries. Most of these commands are Emacspeak-enabled.</P
|
|
><P
|
|
>Diary entries come in a number of formats and entries can be set to repeat. Below are some examples:</P
|
|
><P
|
|
></P
|
|
><TABLE
|
|
BORDER="0"
|
|
><TBODY
|
|
><TR
|
|
><TD
|
|
>12/22/2001</TD
|
|
><TD
|
|
>Mom arrives for visit</TD
|
|
><TD
|
|
>Appears once on 12/22/2001</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
>October 17</TD
|
|
><TD
|
|
>Joe's birthday</TD
|
|
><TD
|
|
>Repeats yearly on October 17th</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
>Friday</TD
|
|
><TD
|
|
>Time cards due</TD
|
|
><TD
|
|
>Repeats every Friday</TD
|
|
></TR
|
|
></TBODY
|
|
></TABLE
|
|
><P
|
|
></P
|
|
><P
|
|
>Of course, there are many more options than those shown here. You can find a complete listing of diary features in the GNU Emacs manual, located at <A
|
|
HREF="http://www.delorie.com/gnu/docs/emacs/emacs_376.html"
|
|
TARGET="_top"
|
|
>http://www.delorie.com/gnu/docs/emacs/emacs_376.html</A
|
|
>.</P
|
|
><P
|
|
>You can view the diary entries for the current date using the command <B
|
|
CLASS="command"
|
|
>M-x diary</B
|
|
>. Alternatively, you can have the day's appointments automatically displayed when you enter Emacs by adding the following line to your <TT
|
|
CLASS="filename"
|
|
>.emacs</TT
|
|
> file:</P
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="programlisting"
|
|
>(diary)</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
>You can also have your events emailed to you on a daily basis by running the command <B
|
|
CLASS="command"
|
|
>M-x diary-mail-entries</B
|
|
>. You'll probably get an error message the first time you do this that says, "No buffer named *Fancy Diary Entries*." This error message was reported as a bug to the bug-gnu-emacs mailing list by Tim Hesterberg. However, the command does in fact work, so you can just ignore the error message. By default, you'll be e-mailed the calendar entries for the next seven days. Also, when you enter Emacs it will automatically show you the calendar entries for the next seven days. According to the GNU Emacs Manual, there is a way to change the number of days the email covers, but according to Tim that feature also has bugs and doesn't seem to work. At the time of writing, these problems have not been addressed.</P
|
|
><P
|
|
>For complete instructions on using the calendar and diary, refer to the section on the calendar and diary in the GNU Emacs Manual, located at <A
|
|
HREF="http://www.delorie.com/gnu/docs/emacs/emacs_376.html"
|
|
TARGET="_top"
|
|
>http://www.delorie.com/gnu/docs/emacs/emacs_376.html</A
|
|
>.</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="sect2"
|
|
><H2
|
|
CLASS="sect2"
|
|
><A
|
|
NAME="writing-text">7.5. Writing text in Emacs</H2
|
|
><P
|
|
>Emacs provides for many modes of text editing, and the tools you should use are task-dependent.</P
|
|
><DIV
|
|
CLASS="sect3"
|
|
><H3
|
|
CLASS="sect3"
|
|
><A
|
|
NAME="writing-print-pdf-postscript">7.5.1. Writing for print, PDF, or postscript</H3
|
|
><P
|
|
>If you want to output your writing in print, postscript, or PDF, <SPAN
|
|
CLASS="application"
|
|
>LaTeX</SPAN
|
|
> is the way to go. <SPAN
|
|
CLASS="application"
|
|
>LaTeX</SPAN
|
|
> is essentially a markup language that produces high-quality print, PDF, or postscript output. <SPAN
|
|
CLASS="application"
|
|
>LaTeX</SPAN
|
|
> was designed for the production of technical and scientific documentation, and in addition to allowing for detailed formatting, it also provides support for mathematical functions, automatic generation of bibliographies and indexes, graphics support, and much more. You can find out more about <SPAN
|
|
CLASS="application"
|
|
>LaTeX</SPAN
|
|
> from <A
|
|
HREF="http://www.latex-project.org"
|
|
TARGET="_top"
|
|
>http://www.latex-project.org</A
|
|
>. In the documentation section at the <SPAN
|
|
CLASS="application"
|
|
>LaTeX</SPAN
|
|
> site, you will find an introduction to <SPAN
|
|
CLASS="application"
|
|
>LaTeX</SPAN
|
|
>, as well as a complete reference manual.</P
|
|
><P
|
|
><SPAN
|
|
CLASS="application"
|
|
>AUC Tex</SPAN
|
|
> is the Emacs editing mode for <SPAN
|
|
CLASS="application"
|
|
>LaTeX</SPAN
|
|
>. The <SPAN
|
|
CLASS="application"
|
|
>AUC Tex</SPAN
|
|
> home page is located at <A
|
|
HREF="http://mirrors.sunsite.dk/auctex/www/auctex/"
|
|
TARGET="_top"
|
|
>http://mirrors.sunsite.dk/auctex/www/auctex/</A
|
|
>. You can download <SPAN
|
|
CLASS="application"
|
|
>AUC Tex</SPAN
|
|
> from <A
|
|
HREF="ftp://sunsite.dk/packages/auctex/auctex.tar.gz"
|
|
TARGET="_top"
|
|
>ftp://sunsite.dk/packages/auctex/auctex.tar.gz</A
|
|
>. Once you've downloaded the file, you'll need to install it as follows:</P
|
|
><P
|
|
></P
|
|
><OL
|
|
TYPE="1"
|
|
><LI
|
|
><P
|
|
>Open an Emacs command shell as root, using the command <B
|
|
CLASS="command"
|
|
>M-x emacspeak-root</B
|
|
>.</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>Change directories to where the downloaded file <TT
|
|
CLASS="filename"
|
|
>auctex.tar.gz</TT
|
|
> is located.</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>Unzip the file using the command <B
|
|
CLASS="command"
|
|
>gunzip auctex.tar.gz</B
|
|
>.</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>Unpack the resulting tarball using the command <B
|
|
CLASS="command"
|
|
>tar -xvf auctex.tar</B
|
|
>.</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>Change directories into the new <TT
|
|
CLASS="filename"
|
|
>auctex-10.0g</TT
|
|
> directory, then type the command <B
|
|
CLASS="command"
|
|
>make</B
|
|
>.</P
|
|
><P
|
|
>The next several steps are covered in greater detail in the <TT
|
|
CLASS="filename"
|
|
>INSTALLATION</TT
|
|
> file included in the <TT
|
|
CLASS="filename"
|
|
>auctex-10.0g</TT
|
|
> directory.</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>When the Makefile is finished building, type the command <B
|
|
CLASS="command"
|
|
> make lispdir=/usr/local/share/emacs/site-lisp install</B
|
|
>. If the Emacs path defined as "lispdir" in this command is not correct for your machine, supply the correct path to your Emacs installation.</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>Check to make sure the <TT
|
|
CLASS="filename"
|
|
>tex-*.el</TT
|
|
> files were placed in the directory specified in the <TT
|
|
CLASS="filename"
|
|
>lispdir</TT
|
|
> command above. If not, copy them there.</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>Add the following line to your <TT
|
|
CLASS="filename"
|
|
>.emacs</TT
|
|
> file:</P
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#E0E0E0"
|
|
WIDTH="100%"
|
|
><TR
|
|
><TD
|
|
><FONT
|
|
COLOR="#000000"
|
|
><PRE
|
|
CLASS="programlisting"
|
|
>(require 'tex-site)</PRE
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
>When you are finished, save and close your <TT
|
|
CLASS="filename"
|
|
>.emacs</TT
|
|
> file.</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>To invoke the <SPAN
|
|
CLASS="application"
|
|
>AUC Tex</SPAN
|
|
> editing mode, create a new file with a <TT
|
|
CLASS="filename"
|
|
>.tex</TT
|
|
> extension.</P
|
|
></LI
|
|
></OL
|
|
><P
|
|
>You'll probably also want to install the online documentation. This is located in the <TT
|
|
CLASS="filename"
|
|
>doc</TT
|
|
> directory within the <TT
|
|
CLASS="filename"
|
|
>auctex-10.0g</TT
|
|
> directory. To install the documentation:</P
|
|
><P
|
|
></P
|
|
><OL
|
|
TYPE="1"
|
|
><LI
|
|
><P
|
|
>Change directories to the <TT
|
|
CLASS="filename"
|
|
>doc</TT
|
|
> directory.</P
|
|
></LI
|
|
><LI
|
|
><P
|
|
>At the command prompt, type <B
|
|
CLASS="command"
|
|
>make</B
|
|
>. When the makefile is finished, type <B
|
|
CLASS="command"
|
|
>make install</B
|
|
>.</P
|
|
><P
|
|
>Result: The documentation is installed in the <TT
|
|
CLASS="filename"
|
|
>/usr/local/info/</TT
|
|
> directory.</P
|
|
></LI
|
|
></OL
|
|
><P
|
|
> You can also get this information in the online manual at <A
|
|
HREF="http://mirrors.sunsite.dk/auctex/www/auctex/doc/"
|
|
TARGET="_top"
|
|
>http://mirrors.sunsite.dk/auctex/www/auctex/doc/</A
|
|
>.</P
|
|
><P
|
|
>Since <SPAN
|
|
CLASS="application"
|
|
>AUC TeX</SPAN
|
|
> is a part of <SPAN
|
|
CLASS="application"
|
|
>LaTeX</SPAN
|
|
>, you'll need to know <SPAN
|
|
CLASS="application"
|
|
>LaTeX</SPAN
|
|
> to use it. There's a good <SPAN
|
|
CLASS="application"
|
|
>LaTeX</SPAN
|
|
> manual by David R. Wilkins called "Getting Started with LaTeX" located at <A
|
|
HREF="http://www.maths.tcd.ie/~dwilkins/LaTeXPrimer/"
|
|
TARGET="_top"
|
|
>http://www.maths.tcd.ie/~dwilkins/LaTeXPrimer/</A
|
|
>. </P
|
|
></DIV
|
|
><DIV
|
|
CLASS="sect3"
|
|
><H3
|
|
CLASS="sect3"
|
|
><A
|
|
NAME="writing-for-online">7.5.2. Writing for online viewing</H3
|
|
><P
|
|
>If you're writing a document that will be read online, you have several choices: HTML, SGML, and XML, to name a few. Emacs comes with a built-in HTML editor, called <SPAN
|
|
CLASS="application"
|
|
>html-mode</SPAN
|
|
>. This editor provides you with additional commands for adding appropriate HTML tags to your document. To start <SPAN
|
|
CLASS="application"
|
|
>html-mode</SPAN
|
|
>, type <B
|
|
CLASS="command"
|
|
>M-x html-mode</B
|
|
>.</P
|
|
><P
|
|
>If you do a lot of HTML coding, you may wish to use <SPAN
|
|
CLASS="application"
|
|
>html-helper-mode</SPAN
|
|
>. This mode has a slightly different interface and many more features than <SPAN
|
|
CLASS="application"
|
|
>html-mode</SPAN
|
|
>. The home page for <SPAN
|
|
CLASS="application"
|
|
>html-helper-mode</SPAN
|
|
> is located at <A
|
|
HREF="http://www.santafe.edu/~nelson/tools/"
|
|
TARGET="_top"
|
|
>http://www.santafe.edu/~nelson/tools/</A
|
|
>. You can either download just the <TT
|
|
CLASS="filename"
|
|
>html-helper-mode.el</TT
|
|
> file from <A
|
|
HREF="http://www.santafe.edu/~nelson/tools/html-helper-mode.el"
|
|
TARGET="_top"
|
|
>http://www.santafe.edu/~nelson/tools/html-helper-mode.el</A
|
|
>, or you can download the entire distribution, including documentation, from <A
|
|
HREF="ftp://ftp.reed.edu/pub/src/html-helper-mode.tar.gz"
|
|
TARGET="_top"
|
|
>ftp://ftp.reed.edu/pub/src/html-helper-mode.tar.gz</A
|
|
>. Installation instructions for both of these options are located at the <SPAN
|
|
CLASS="application"
|
|
>html-helper-mode</SPAN
|
|
> website at <A
|
|
HREF="http://www.gest.unipd.it/~saint/hth.html"
|
|
TARGET="_top"
|
|
>http://www.gest.unipd.it/~saint/hth.html</A
|
|
>. </P
|
|
><P
|
|
>If you're authoring larger documents or want to author in SGML, the PSGML mode for Emacs is recommended. The home page for PSGML is located at <A
|
|
HREF="http://www.lysator.liu.se/projects/about_psgml.html"
|
|
TARGET="_top"
|
|
>http://www.lysator.liu.se/projects/about_psgml.html</A
|
|
>.</P
|
|
><P
|
|
>There's also an XML editor for Emacs, called <SPAN
|
|
CLASS="application"
|
|
>sxml-mode</SPAN
|
|
>. The home page is located at <A
|
|
HREF="http://koala.ilog.fr/plh/sxml.html"
|
|
TARGET="_top"
|
|
>http://koala.ilog.fr/plh/sxml.html</A
|
|
>. You must have a Java Virtual Machine, as well as PSGML 1.0.1 or better to run <SPAN
|
|
CLASS="application"
|
|
>sxml-mode</SPAN
|
|
>. Complete instructions for downloading and installing are available on the web site.</P
|
|
></DIV
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="NAVFOOTER"
|
|
><HR
|
|
ALIGN="LEFT"
|
|
WIDTH="100%"><TABLE
|
|
SUMMARY="Footer navigation table"
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
CELLPADDING="0"
|
|
CELLSPACING="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="working-online.html"
|
|
ACCESSKEY="P"
|
|
>Prev</A
|
|
></TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="index.html"
|
|
ACCESSKEY="H"
|
|
>Home</A
|
|
></TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="entertainment.html"
|
|
ACCESSKEY="N"
|
|
>Next</A
|
|
></TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
>Working online</TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
> </TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
>Entertainment</TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></BODY
|
|
></HTML
|
|
> |