Warning, /office/kile/README.MacOSX is written in an unsupported language. File is not indexed.

0001 [See below for an alternative way]
0002 
0003 In order to install Kile on MacOS X, you need the following things:
0004 - a working LaTeX distribution
0005 - the KDE libraries
0006 - and Kile itself, of course
0007 
0008 Installing X11
0009 --------------
0010 
0011 [X11 does not need to be installed with Qt4 as it can use the Aqua framework.]
0012 
0013 
0014 Installing all the rest through Fink
0015 ------------------------------------
0016 
0017 Fink is the packaging system from Debian ported to MacOS X. Installing Fink itself is very straightforward, so only two things will be mentioned here:
0018 - you must download and install the latest Xcode version from Apple (free download, just requires registration),
0019 - make sure Fink uses the package repository compatible with your system (specifically, if you have MacOS X 10.4, use the 10.4 branch and *not* the 10.4-transitional branch).
0020 
0021 Fink lets you choose between precompiled, ready-to-use, packages, and compiling them yourself. Practically speaking, the Fink project provides few up-to-date precompiled packages, so compilation is often necessary. But don't worry, the procedure is automatic in any case.
0022 
0023 After that, installing the rest is very straightforward:
0024 
0025 - LaTeX distribution: install packages "tetex" and "tetex-base".
0026 - KDE libraries: the bare minimum would be package "kdebase3-unified", but you should also install packages like "kpdf", "kdvi" and "kghostview" to make best use of Kile. Installing a localisation package to have dialogs in your language would also be nice ; for example, the French package is called "kde-i18n-french".
0027 - Kile: its package is called "kile".
0028 - Other useful packages, depending on your habits: "bibview", "gnuplot", "xfig", "beamer", "texpower"... Just go shopping with Fink.
0029 
0030 Have fun!
0031 
0032 Fink project: http://fink.sourceforge.net
0033 
0034 
0035 Installing Kile through Macports
0036 --------------------------------
0037 
0038 Macports is a source-based package manager, from which it is possible to install the whole software suite needed for Kile. 
0039 Macports can be installed from a package installer, which can be found for each Apple platform at: http://www.macports.org/install.php.
0040 
0041 Configuring Macports:
0042 When Macports is installed, it needs to be configured slightly in order to ensure that the correct configurations are prepared for Kile. For this, run:
0043         sudo pico /opt/local/etc/macports/variants.conf
0044 and add:
0045         +no_x11 +quartz +qt4
0046 at the end of the file. 
0047 
0048 Then, run
0049         sudo port selfupdate
0050 in order to ensure that latest versions of the softwares will be installed. 
0051 
0052 Installing Kile:
0053 At this point, you can run 
0054         sudo port install kile-devel
0055 kile-devel is the KDE4 port for Kile. This will install all the libraries needed for Kile, including Qt4, and KDE packages. This compilation will take a lot of time, but you can follow the installation progress for each package. At the end of the installation, you need to run some commands in order to finish the configuration, to ensure that DBUS will work, and to ensure you have access to KDE preferences:
0056         sudo launchctl load -w /Library/LaunchDaemons/org.freedesktop.dbus-system.plist
0057         launchctl load -w /Library/LaunchAgents/org.freedesktop.dbus-session.plist
0058         sudo chown -R $USER ~/Library/Preferences/KDE
0059 where $USER should be changed to your login name. 
0060 
0061 Finding TeX paths:
0062 The application bundles of Apple do not recognize the $PATH variables set for xterm. We therefore need to set them for Kile. To set globally the $PATH variable for application bundles. For this, you can run the following commands:
0063         mkdir ~/.MacOSX
0064         pico ./.MacOSX/environments.plist
0065 and add the following text in environments.plist:
0066         <?xml version="1.0" encoding="UTF-8"?>
0067         <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
0068         <plist version="1.0">
0069         <dict>
0070                 <key>KDEDIRS</key>
0071                 <string>/opt/local</string>
0072                 <key>PATH</key>
0073                 <string>/opt/local/bin:/opt/local/sbin:$TEXPATH</string>
0074         </dict>
0075         </plist>
0076 where you should replace $TEXPATH with the path to your TeX distribution. Typically, it should be /opt/local/bin if you are using the TeXLive port of Macports (so that you can leave it blank), or /usr/local/texbin if you are using MacTeX package. 
0077 
0078 Starting Kile:
0079 You should first start the /Applications/Macports/KDE4/kdeinit4.app program to set up the KDE environment. Then, you can start Kile, and check that everything work fine by performing a system check from the Settings menu.
0080 
0081 
0082 Other installation methods
0083 --------------------------
0084 
0085 [i-installer is deprecated as of Jan 1 2007]
0086 
0087 [This upper part of the readme was contributed by Thibaut Cousin (cousin@kde.org)]
0088 
0089 
0090 Kile SVN for KDE 4
0091 ------------------
0092 It is now possible to install the latest version of Kile from the Subversion repository using the KDE 4 libraries. This means that you no longer need to use the X11 libraries. To achieve this you need:
0093 
0094 - KDE 4.1 packages from http://mac.kde.org/
0095 - Kile source from SVN
0096 
0097 First download the latest packages from http://mac.kde.org/?id=download
0098 At the time of writing the latest version is 4.1.2. Install the packages in order. Once these
0099 are installed you should have a working version of KDE for the Mac. If applications crash, try issuing the command: 
0100 
0101 launchctl load -F /Library/LaunchAgents/org.freedesktop.dbus-session.plist 
0102 
0103 to launch D-BUS. If when a program starts but gives an error about D-BUS being uncontactable, try rebooting.
0104 
0105 Once you have a working copy of KDE 4.1 the next step is to download and compile Kile from the Subversion repository. Follow the instructions on:
0106 
0107 http://techbase.kde.org/Projects/KDE_on_Mac_OS_X/Macbook_Manifesto 
0108 
0109 This will set up your build environment. Next get the latest version using the command:
0110 
0111 svn co svn://anonsvn.kde.org/home/kde/trunk/extragear/office/kile
0112 
0113 Go into this directory in a terminal and run the commands:
0114 - cmake .
0115 - make
0116 - sudo make install
0117 
0118 You now have a running native version of Kile on your Mac!
0119 
0120 [The lower part of this readme was contributed by Thomas Quillinan <t.quillinan@gm...>]