# TeXlipse

Project hosted by:

# FAQ

• How to add dictionaries to TeXlipse?
If you have downloaded one or more dictionary files from the Sourceforge page, extract the .gz files in a directory of your choice and change the path in TeXlipse Spelling preferences to this path.
• Where to find a dictionary for language xy?
You can use Aspell to create wordlists for your favorite language by
aspell --encoding=UTF-8 --lang=<lang> dump master > <lang>.dict
where you have to replace <lang> by your language.
• After installing the latest TeXlipse version, spell checking in other Eclipse documents does not work correct. What's wrong?
In version 1.4.0 TeXlipse overwrites the default spell checker settings, so its spell checker was used in nearly every document (and there was a bad bug that could crash Eclipse too...). This was fixed in version 1.4.1 but maybe you have to change the spelling engine back to the default one (see Preferences/General/Editors/Text Editors/Spelling).
• There are so many type of Eclipse packages, which one should I download?
If you only need Eclipse for TeXlipse, it is enough to download the Platform Runtime Binary. It is a little bit hidden on the main Eclipse site:
• Which pdf viewer do you use with Windows?
We use Pdf4Eclipse on every system!
An alternative for Windows is SumatraPDF. It is a light-weight pdf viewer which supports automatic reloading the pdf after a fresh build. Furthermore you can enable forward and inverse search support with TeXlipse. You can find a good manual how to configure TeXlipse here.
• In nearly every other LaTeX editors I can build a file by pressing a button. Where is this button in TeXlipse?
The philosophy of Eclipse is, that the source code and the binary code are always in sync, that means that when you save your LaTeX build, your output file is generated automatically by TeXlipse and there is no need to build it "by hand". TeXlipse also detects how many builds are needed and whether it must invoke BibTeX.
• I do not like the automatic building feature, can I switch it off?
Yes, just switch off Build Automatically in the Project menu. To create the output files use the Build Project menu item.
• Why cannot I open an arbitrary TeX-file and compile it?
TeXlipse or more generally Eclipse needs a project where your files are located. If you have many small files, e.g. letters, just create a project called e.g. "misc." and add your small files to it. For more details how to build these files, take a look at the next entry.
• I have many self-contained LaTeX files in my project, but only my main TeX file is build after save. How can I build the other files without switching the main TeX file every time?
There is a nice feature in TeXlipse which you should use in this case: Partial building. If switched on, TeXlipse tries to build only the file you are currently editing. It uses two different strategies depending on the file type you are editing:
1. If the file is a "main" TeX file, it simply builds the file and move it to your output directory. When you use Preview Document after that, this file will be shown.
2. If the file is not a self-contained TeX file, TeXlipse extracts the preamble of your main file and includes it together with the file you are editing in a temporary file. This newly created file will be build and shown if you preview it.
• If I write totally correct (La)TeX Code like
 \alpha $$\endgroup  TeXlipse shows an error marker although there are no errors in the output of the LaTeX command. Apart from scanning the output of LaTeX for errors and warnings, TeXlipse includes his own small LaTeX parser. Since writing a full-fledged parser is not that easy, it can handle only the most common things. It should help you to find common errors like missing \end{...} or braces while editing. If you use fancy constructs like in the example above, you can tell the parser to ignore parts of your document by surrounding it with the special comment %###. Just write  %### \alpha$$ \endgroup %###  to let the parser ignore this construct.