## 2 Installation TEXworks is only a text editor; to be able to create documents with (LA)TEX and to typeset them to PDF, we also need what is called a TEX distribution. This is a collection of programs and other files which will be automatically called by TEXworks during its work. Thus you need to install a distribution: we will do that before starting TEXworks for the first time, as in this way TEXworks will automatically find what it needs. TeX Live (`http://www.tug.org/texlive/)`, a combination of teTeX, macTeX and XEmTeX, is available for the three operating systems (Linux, Mac OS X, Windows). The current version is TeX Live 2008. For Linux: every Linux distribution includes a TEX distribution, but it may not be installed by default and you will have to use the Linux package management tools to do that. As well as TeXlive, one can use teTeX (`http://www.tug.org/teTeX/`, a predecessor system to TeXlive. For the Mac: MacTeX, new distribution based on gwTeX and XeTeX, is available; see `http://www.tug.org/mactex/`. For Windows: a very popular distribution is MiKTeX (`http://www.miktex.org/`). MikTeX has an update programme, which has also been ported to Linux. You can also use the XEmTeX distribution (`http://www.xemtex.org/`). ### 2.1 Under Windows After the installation of the TEX distribution, obtain TEXworks by downloading the archived programmes from the TEXworks web site: `htp://tug.org/texworks/`; you will find binaries for Mac and Windows at: `http://code.google.com/p/texworks/downloads/list`. You need to get: `TeXworksW32-v0.1r352.zip` the programme itself and 1, some necessary library files 2. We create a folder, for example `C:\Program files\TeXworks`, and unzip the downloaded files in it. Create, on the Desktop or in the Quick Launch bar a short-cut to the `TeXworks.exe` file. When you start the program the first time, it creates a folder named `TeXworks` in your home folder (on Windows XP, `C:\Documents and Settings\<your name>`, on Vista, `C:\Users\<your name>`). This folder will contain some sub-folders for auto-completion, configuration, dictionaries, templates, and localisation files — we will see these details later.3 NB. At the time of writing, if `<your name>` contains any non-ASCII characters (for example accented characters) some TEXworks functions will not work correctly. For example, the spell-checker and forward/reverse synchronization between the source and .pdf will be impaired. ### 2.2 Under Linux After the installation of the TEX distribution, for TEXworks, download the archived programmes from the web site: `https://launchpad.net/ texworks/` and look for `+archive/ppa`. Under Linux, if a build of TEXworks exists for your system, use it, otherwise you will probably need to build the program from the source: see the annex section 6.4. Once the program is installed, start TEXworks. A folder `.texworks` will be created in your home directory. ### 2.3 Under Mac OS After the installation of the TEX distribution, for TEXworks, download the archived programmes from the TEXworks web site: `http://tug.org/texworks/`; you will find binaries for Mac and Windows at: `http://code.google.com/p/texworks/downloads/list`. You need to get: `TeXworks-0.1r333.zip`, this is a file with everything 4. It is a standalone `.app` package that does not require any Qt files installed into `/Library/Frameworks`, or other libraries into `/usr/local/lib`. Just copy the `.app` to anywhere you like, and run it. On Mac OS X, the TEXworks resource folder will be created in your `Library` folder (`~/Library/.TeXworks/`), inside your `home` directory. Preferences are stored in `~/Library/Preferences/org.tug.TeXworks.plist` which you can delete if you ever suspect it is causing problems. ### 2.4 Ready! Finally some files may need to be added to the “personal” files that TEXworks creates. As the exact location is dependent on your platform, this will be referred to as `<home>\TeXworks` or the TEXworks resource folder later in this manual. On Windows XP this will be at `C:\Documents and Settings\<your name>\TeXworks`, on Linux it is `~/TeXworks` and `~/Library/.TeXworks/` on the Mac. After installation and first run, have a look in the sub-folders of the TEXworks resources folder and delete any `qt_temp.xxxx` files; they are temporary files left behind and they could later on interfere with the normal ones, which are installed in the same folder.