Previous Up Next

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.


Previous Up Next