|Genre:||Health and Food|
|Published (Last):||10 September 2006|
|PDF File Size:||14.62 Mb|
|ePub File Size:||15.13 Mb|
|Price:||Free* [*Free Regsitration Required]|
For each of them there is a separate major mode in AUCTeX and each major mode runs text-mode-hook , TeX-mode-hook as well as a hook special to the mode in this order. The following table provides an overview of the respective mode functions and hooks. If you need to make a customization via a hook which is only relevant for one of the modes listed above, put it into the respective mode hook, if it is relevant for any AUCTeX mode, add it to TeX-mode-hook and if it is relevant for all text modes, append it to text-mode-hook.
See Processing , for finding out how to compile your document. Each function in the hook is run with the compiled output document as its argument. This is useful for automatically refreshing the viewer after re-compilation especially when using Emacs viewers such as DocView or PDF Tools. The function TeX-revert-document-buffer can be added to the hook for this purpose.
You may wish to spread a document over many files as you are likely to do if there are multiple authors, or if you have not yet discovered the power of the outline commands see Outline. These files may also include other files themselves. However, to format the document you must run the commands on the top level master file. When you, for example, ask AUCTeX to run a command on the master file, it has no way of knowing the name of the master file. By default, it will assume that the current file is the master file.
If you insert the following in your. If AUCTeX finds the line indicating the end of the header in a master file TeX-header-end , it can figure out for itself that this is a master file. Otherwise, it will ask for the name of the master file associated with the buffer. You can also insert the file variable yourself, by putting the following text at the end of your files. You should always set this variable to the name of the top level document.
If you always use the same name for your top level documents, you can set TeX-master in your. The master file associated with the current buffer. If the file being edited is actually included from another file, then you can tell AUCTeX the name of the master file by setting this variable. If there are multiple levels of nesting, specify the top level file. You should set this variable to match the name of all files, for which it is a good idea to append a TeX-master file variable entry automatically.
When AUCTeX adds the name of the master file as a file variable, it does not need to ask next time you edit the file. AUCTeX will not ask for a master file when it encounters existing files.
This function shall give you the possibility to insert the variable manually. AUCTeX keeps track of macros, environments, labels, and style files that are used in a given document. For this to work with multifile documents, AUCTeX has to have a place to put the information about the files in the document. This is done by having an auto subdirectory placed in the directory where your document is located. When you load a file, AUCTeX will read the information in the auto directory about the file you loaded and the master file specified by TeX-master.
Since the master file perhaps indirectly includes all other files in the document, AUCTeX will get information from all files in the document. This means that you will get from each file, for example, completion for all labels defined anywhere in the document. Without it, the files in the document will not know anything about each other, except for the name of the master file.
See Automatic Local. AUCTeX depends heavily on being able to extract information from the buffers by parsing them. Since parsing the buffer can be somewhat slow, the parsing is initially disabled. You are encouraged to enable them by adding the following lines to your.
If AUCTeX finds the pre-parsed information when loading a file, it will not need to reparse the buffer. The information in the auto directory is also useful for multifile documents, see Multifile , since it allows each file to access the parsed information from all the other files in the document. This is done by first reading the information from the master file, and then recursively the information from each file stored in the master file.
Even when you have disabled the automatic parsing, you can force the generation of style information by pressing C-c C-n. This is often the best choice, as you will be able to decide when it is necessary to reparse the file.
C-c C-n Remove all information about this buffer, and apply the style hooks again. Save buffer first including style information. With optional argument, also reload the style hooks. To convert tabs to spaces when saving a buffer, insert the following in your. Instead of disabling the parsing entirely, you can also speed it significantly up by limiting the information it will search for and store when parsing the buffer.
You can do this by setting the default values for the buffer local variables TeX-auto-regexp-list and TeX-auto-parse-length in your. This example will speed the parsing up significantly, but AUCTeX will no longer be able to provide completion for labels, macros, environments, or bibitems specified in the document, nor will it know what files belong to the document.
The pre-specified lists of regexps are defined below. Note that Unicode is not fully supported in Emacs 21 and XEmacs CJK characters are not usable. I prefer the latter, it has the advantage that the usual standard emacs word movement and case change commands will work. Other languages than Western European ones will probably have other encoding needs. Emacs The manner in which this is supported differs between Emacsen, so you need to take a look at your respective documentation.
A compromise is to use an European character set when editing the file, and convert to TeX macros when reading and writing the files. AUCTeX supports style files for several languages. Each style file may modify AUCTeX to better support the language, and will run a language specific hook that will allow you to for example change ispell dictionary, or run code to change the keyboard remapping.
This requires parsing to be enabled, see Parsing Files. Runs style hook TeX-language-bg-hook. Runs style hook TeX-language-cz-hook. Runs style hook TeX-language-dk-hook. Runs style hook TeX-language-fr-hook. Runs style hook TeX-language-de-hook. Runs style hook TeX-language-is-hook. Runs style hook TeX-language-it-hook. Runs style hook TeX-language-pl-hook. Runs style hook TeX-language-sk-hook. Runs style hook TeX-language-sv-hook. You can put point after the hypen string anytime and trigger the replacement by typing -.
In case you are not satisfied with the suggested behavior of quote and hyphen insertion you can change it by customizing the variables TeX-quote-language-alist and LaTeX-babel-hyphen-language-alist respectively. Used for overriding the default language-specific quote insertion behavior. This is an alist where each element is a list consisting of four items. The first item is the name of the language in concern as a string. See the list of supported languages above.
The second item is the opening quotation mark. The third item is the closing quotation mark. Opening and closing quotation marks can be specified directly as strings or as functions returning a string. The fourth item is a boolean controlling quote insertion. Used for overriding the behavior of hyphen insertion for specific languages. Every element in this alist is a list of three items. The first item should specify the affected language as a string.
The second item denotes the hyphen string to be used as a string. The defaults of hyphen insertion are defined by the variables LaTeX-babel-hyphen and LaTeX-babel-hyphen-after-hyphen respectively. String to be used when typing -. Control insertion of hyphen strings. If non-nil insert normal hyphen on first key press and swap it with the language-specific hyphen string specified in the variable LaTeX-babel-hyphen on second key press.
If nil do it the other way round. To use the Japanese TeX engines, activate japanese-plain-tex-mode or japanese-latex-mode. When enabled, japanese-latex-mode selects the suitable Japanese TeX engine automatically based on the class file name such as jbook , jsarticle and tjreport and its option. If you find that wrong command is used, check the value of TeX-engine on that buffer. To make the selected engine to persist across Emacs sessions, there are two ways from which you can choose one according to your needs:.
You can override the command names associated with the above three engines or define your own engine by customizing TeX-engine-alist. See Processor Options. In such cases, use the file local variable method above to select the engine you intend to use. Mode to enter for a new file when it cannot be determined whether the file is plain TeX or LaTeX or what.
Usually AUCTeX guesses the right coding systems for input to and output from the Japanese TeX process, but you can override them by the following two customize options. If non-nil, used for encoding input to Japanese TeX process. If non-nil, used for decoding output from Japanese TeX process.
Subscribe to RSS
For each of them there is a separate major mode in AUCTeX and each major mode runs text-mode-hook , TeX-mode-hook as well as a hook special to the mode in this order. The following table provides an overview of the respective mode functions and hooks. If you need to make a customization via a hook which is only relevant for one of the modes listed above, put it into the respective mode hook, if it is relevant for any AUCTeX mode, add it to TeX-mode-hook and if it is relevant for all text modes, append it to text-mode-hook. See Processing , for finding out how to compile your document. Each function in the hook is run with the compiled output document as its argument. This is useful for automatically refreshing the viewer after re-compilation especially when using Emacs viewers such as DocView or PDF Tools. The function TeX-revert-document-buffer can be added to the hook for this purpose.