Difference between revisions of "Apertium on Mac OS X (Local)"

From Apertium
Jump to navigation Jump to search
(add link to updated instructions)
 
(31 intermediate revisions by 8 users not shown)
Line 1: Line 1:
[[Installation locale sur Mac OS X|En français]]
{{TOCD}}


<div style="background-color:pink; text-align:center; line-height:2.5; border: 1px solid crimson;">Are you sure this is the page you want?<br/>If not, you probably actually want [[Apertium_on_Mac_OS_X]]<br/>If you're here because the instructions on that page didn't work for you, log on to [[IRC]] and describe what went wrong.</div>
This page gives instructions on compiling Apertium on Mac OS/X, it will presume you are installing into a directory called <code>Local</code> inside your home directory (your home directory will be in <code>/Users/<your user name></code>). This is slightly more complicated, but more contained. Please replace <code>spectie</code> with the name of your user. You can find the name of your user by typing <code>whoami</code>.


==Preparation==


{{TOCD}}
At the very minimum we assume that you have subversion (<code>svn</code>) installed. If you don't, you can install it with:


This page gives instructions on compiling Apertium on Mac OS X. It will presume you are installing into a directory called <code>Local</code> inside your home directory (your home directory will be in <code>/Users/<your user name></code>). This is slightly more complicated than [[Apertium on Mac OS X (System)]], but more contained, and doesn't require root.
<pre>
$ sudo port install subversion
</pre>


==The procedure==
Then continue...


First, we create the directories to hold our source and the installed binaries. Then we export these environment variables so that binaries and libraries from your local installation are taken before those from the system installation.
<pre>
$ pwd
$ mkdir Local
$ mkdir Source
</pre>

==Downloading==


<pre>
<pre>
mkdir Local
$ svn co http://apertium.svn.sourceforge.net/svnroot/apertium/trunk/lttoolbox
mkdir Source
$ svn co http://apertium.svn.sourceforge.net/svnroot/apertium/trunk/apertium
PATH=$HOME/Local/bin/:$PATH
$ curl -O ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/pcre-7.8.tar.gz
export PATH
$ curl -O http://pkgconfig.freedesktop.org/releases/pkg-config-0.23.tar.gz
PKG_CONFIG_PATH=$HOME/Local/lib/pkgconfig
$ curl -O ftp://xmlsoft.org/libxml2/libxml2-2.7.1.tar.gz
export PKG_CONFIG_PATH
LD_LIBRARY_PATH=$HOME/Local/lib
export LD_LIBRARY_PATH
cd Source
</pre>
</pre>


Also, put this in your ~/.bashrc so you don't have to paste it in every time you open a new terminal:
==Compiling==

First export these environment variables so that binaries and libraries from your local installation are taken before those from the system installation.

<pre>
<pre>
$ export PATH=/Users/spectie/Local/bin/:$PATH
PATH=$HOME/Local/bin/:$PATH
export PATH
$ export PKG_CONFIG_PATH=/Users/spectie/Local/lib/pkgconfig
PKG_CONFIG_PATH=$HOME/Local/lib/pkgconfig
$ export LD_LIBRARY_PATH=/Users/spectie/Local/lib
export PKG_CONFIG_PATH
$ cd Source
LD_LIBRARY_PATH=$HOME/Local/lib
export LD_LIBRARY_PATH
</pre>
</pre>


Now the standard steps:
===libxml===
# Install the [[Prerequisites for Mac OS X]].
# Follow [[Install Apertium core by compiling]], using <code>$HOME/Local</code> as your $prefix.
# See [[Installation_troubleshooting]] if you have problems.


== See also==
<pre>
$ cd libxml2-2.7.1


* [[Apertium on Mac OS X (System)]] &mdash; for installation in the main system.
$ ./configure --prefix=/Users/spectie/Local/
$ make
$ make install
</pre>

===pkg-config===

<pre>
$ cd pkg-config-0.23

$ ./configure --enable-utf8 --prefix=/Users/spectie/Local/
$ make
$ make install
</pre>

===lttoolbox===
:''Note: This is likely to fail in more than one place, check the troubleshooting info below!''

<pre>
$ cd lttoolbox

$ sh autogen.sh --prefix=/Users/spectie/Local/
$ make
$ make install
</pre>

===libpcre===

<pre>
$ cd pcre-7.8

$ ./configure --prefix=/Users/spectie/Local/
$ make
$ make install
</pre>

===apertium===
:''Note: This is likely to fail in more than one place, check the troubleshooting info below!''

<pre>
$ cd apertium

$ sh autogen.sh --prefix=/Users/spectie/Local/
$ make
$ make install
</pre>

==Troubleshooting==

===Undefined macro #1===

; Problem

The <code>autogen.sh</code> script complains about an undefined macro when encountering the <code>dnl</code> (comment) string.

<pre>
configure.ac:112: error: possibly undefined macro: dnl
If this token and others are legitimate, please use m4_pattern_allow.
See the Autoconf documentation.
</pre>

; Solution

Run <code>automake -a</code> then <code>autoconf</code>, then <code>./configure --prefix=/Users/spectie/Local/</code>.

===Undefined macro #2===

;Problem

<pre>
$ sh autogen.sh --prefix=/Users/spectie/Local/
- libtoolize.
You should add the contents of `/usr/share/aclocal/libtool.m4' to `aclocal.m4'.
- aclocal.
- autoconf.
configure.ac:109: error: possibly undefined macro: dnl
If this token and others are legitimate, please use m4_pattern_allow.
See the Autoconf documentation.
</pre>

;Solution

Re-run the <code>autogen.sh</code> command until it works.

===syntax error near unexpected token===

; Problem

The <code>configure</code> script cannot find the <code>PKG_CHECK_MODULES</code> macro

<pre>
checking for pkg-config... /Users/spectie/Local/bin//pkg-config
./configure: line 19355: syntax error near unexpected token `LTTOOLBOX,'
./configure: line 19355: `PKG_CHECK_MODULES(LTTOOLBOX, dnl'
</pre>

or

<pre>
checking for gawk... (cached) awk
./configure: line 2183: syntax error near unexpected token `APERTIUM,'
./configure: line 2183: ` PKG_CHECK_MODULES(APERTIUM, apertium-1.0 >= 1.0.0,'
</pre>

;Solution

Run:

<pre>
$ aclocal -I /Users/spectie/Local/share/aclocal
$ automake -a
$ autoconf
$ ./configure --prefix=/Users/spectie/Local/
</pre>


[[Category:Documentation]]
[[Category:Documentation]]
[[Category:Installation]]
[[Category:Documentation in English]]

Latest revision as of 19:35, 12 May 2019

En français

Are you sure this is the page you want?
If not, you probably actually want Apertium_on_Mac_OS_X
If you're here because the instructions on that page didn't work for you, log on to IRC and describe what went wrong.


This page gives instructions on compiling Apertium on Mac OS X. It will presume you are installing into a directory called Local inside your home directory (your home directory will be in /Users/<your user name>). This is slightly more complicated than Apertium on Mac OS X (System), but more contained, and doesn't require root.

The procedure[edit]

First, we create the directories to hold our source and the installed binaries. Then we export these environment variables so that binaries and libraries from your local installation are taken before those from the system installation.

mkdir Local
mkdir Source
PATH=$HOME/Local/bin/:$PATH
export PATH
PKG_CONFIG_PATH=$HOME/Local/lib/pkgconfig
export PKG_CONFIG_PATH
LD_LIBRARY_PATH=$HOME/Local/lib
export LD_LIBRARY_PATH
cd Source

Also, put this in your ~/.bashrc so you don't have to paste it in every time you open a new terminal:

PATH=$HOME/Local/bin/:$PATH
export PATH
PKG_CONFIG_PATH=$HOME/Local/lib/pkgconfig
export PKG_CONFIG_PATH
LD_LIBRARY_PATH=$HOME/Local/lib
export LD_LIBRARY_PATH

Now the standard steps:

  1. Install the Prerequisites for Mac OS X.
  2. Follow Install Apertium core by compiling, using $HOME/Local as your $prefix.
  3. See Installation_troubleshooting if you have problems.

See also[edit]