Installation

From CeltxWiki

Revision as of 13:30, 2 May 2007; view current revision
←Older revision | Newer revision→

Contents

Installation

The first step is to download the Celtx installer from our download page. Celtx is available for Windows, Mac OS X / Universal and Linux, in a variety of different languages. Download the OS version and language pack that suits your needs.

For Windows (XP, NT, 2000, 98)

Double click the CeltxSetup.exe file and follow the installation wizard. The setup will place a shortcut on your Desktop as well as place Celtx in the Start menu.

If you get a reported problem with:

"The application has failed to start because MSVCR71.dll was not found. Restarting the application may fix this problem."

you need to get the files msvcr71.dll and msvcp71.dll. They can be found at http://www.driverskit.com/dll/msvcr71.dll/2373.html and http://www.driverskit.com/dll/msvcp71.dll/2371.html (or search for them on Google). The DLLs go in your C:\Windows\system32 directory.

As with any software downloaded off the Internet, you should be careful installing files from untrusted sources. For the security conscious, the MD5 checksums should be:

MD5 (msvcr71.dll) = 86f1895ae8c5e8b17d99ece768a70732
MD5 (msvcp71.dll) = 561fa2abb31dfa8fab762145f81667c2

For Mac OS X / Universal

Double click the Celtx.dmg file to mount the drive to your system. Drag the Celtx icon to your Applications folder to complete the installation.

For Linux

You can install Celtx by extracting the downloaded archive into your home folder (e.g. /home/yourusername/bin) and run the application from there. But then only this single user will have access to it.

Otherwise, if you want all users to have access to it, Celtx must be installed and run once as the root user. A typical installation from an administrator account is done as follows:

cd /usr/local

sudo tar zxf /path/to/Celtx.tar.gz

(enter your password)

sudo /usr/local/celtx/celtx

Now any user can run it using /usr/local/celtx/celtx.

If you're running a 64-bit build, ensure the 32-bit libraries are installed. Just search for the string "ia32" within synaptic. You might have to install the normal "ia32-libs" and also "ia32-libs-gtk", perhaps more.

Hyperlinks

Hyperlinks may not work. Firefox (upon which Celtx is based) primarily supports the GNOME desktop environment, although various Linux distributions include modified forms of Firefox with support for KDE. At the moment, Celtx consults the GNOME registry to check what your default browser is. We hope to address this when we have the time.

Root

If you can only run Celtx as root (not just the first time), you need to delete the following directories:

  • .greyfirst
  • .celtx

They will most likely be in one of the following locations:

  • Your home directory (~)
  • /tmp
  • /usr/tmp
  • /usr/local/celtx

The small Print

When installing, we'd really appreciate it if you would please take the time to read the small print:

Launching for the first time

To launch Celtx double click the movie clapper icon like the one below.

Image:Celtx_Clapper_icon.png

The application will open and display the Splash Page.


Installing other dictionaries to the Spell Checker

With the following steps you can add new language dictionaries to the Celtx Spell Checking tool.:

1. Download the appropriate language from the list available below.

2. Open the downloaded zip file. It will contain the two necessary files to add to the spellcheck directory (*.aff and *.dic).

3. Copy the two files in the archive, *.aff and *.dic, to the celtx myspell directory.

On Windows this is "DRIVE:\{Celtx-installation-path}\components\myspell" In my case Celtx-installation-path was "C:\Program Files\Celtx", thus the final destination of those two files was "C:\Program Files\Celtx\components\myspell"

On a Mac, 'ctrl + click' the Celtx application icon and select 'Show Package Contents' form the context menu. Navigate to Contents/MacOS/dictionaries. Copy the dictionary files to this Dictionaries directory.

4. Restart Celtx and then open the Spell Check tool and select the newly installed language dictionary from the drop down menu. Note that the selected dictionary is good for the session only, and will have to be reselected the next time you start Celtx. This is feature to be addressed in a future release.

Voila. This language will now be available for the spell-checking tool. Just select the appropriate language in the spell-check dialogue and start spell-checking. This way you can add new languages to your Celtx, especially if you are writing different projects in different languages.

Below is a list of available dictionaries for Celtx. The zip file will contain the 2 necessary files to add to your installation (*.aff and *.dic):