davelab6/INSTALL-ttfautohint.md

## INSTALL-ttfautohint.md

      
    Raw
  

              INSTALL-ttfautohint.md
            
          
    With HomeBrew

If you have Homebrew and are comfortable with it, you can run
brew edit ttfautohint;

and then replace the file with this one
require 'formula'

class Ttfautohint < Formula
  homepage 'http://www.freetype.org/ttfautohint'
  url 'http://download.savannah.gnu.org/releases/freetype/ttfautohint-0.95.tar.gz'
  sha1 '5039cf8af38283a2f70b8912a968dd1abde9836a'
  head 'git://repo.or.cz/ttfautohint.git'

  depends_on :freetype
  depends_on qt

  def install
    system "./configure", "--disable-dependency-tracking",
                          "--prefix=#{prefix}",
                          "--with-doc=no"
    system "make install"
  end

  test do
    system "#{bin}/ttfautohintGUI", "-V"
  end
end

then simply run
brew install ttfautohint;

and then to run it with the gui, you can from Terminal type
ttfautohintGUI;


From Scratch

If you don't have Homebrew, you should check it out because its super useful. But supposing you don't want ot use it, you can install the GUI on Mac OS X from scratch.
We start by installing XCode from the App Store, and then the Command Line Tools. Instructions are at http://guide.macports.org/chunked/installing.xcode.html
Next we install FreeType, the system that ttfautohint is based on.
Create a folder in your Home folder called src
In your browser, download http://downloads.sourceforge.net/project/freetype/freetype2/2.5.0/freetype-2.5.0.1.tar.gz
In Finder, go to your Downloads folder and double click the freetype-2.5.0.1.tar.bz2 file to unpack it into a folder named freetype-2.5.0.1.
In Finder, rename the folder freetype-2.5.0.1 to freetype2 and then move that folder into the src folder you created in your Home folder.
Open Terminal.app and type
cd ~/src/freetype2;

Press the return key.
./configure;

Press the return key and you will see a bunch of text rolling through the Terminal app. When it is done, type...
make;

Press the return key and see more text rolling through. When it is done, type...
sudo make install;

Press the return key, then enter your Mac login password, then press the return key again.
Now install the Qt libraries for making ttfautohint's Graphical User Interface.
With your browser, download the latest Qt Libraries for Mac .dmg file from http://qt-project.org/downloads#qt-lib and install Qt in the normal way. Currently the direct link is http://releases.qt-project.org/qt4/source/qt-mac-opensource-4.8.2.dmg
Now visit http://freetype.org/ttfautohint/ and in the download section, download the latest version of the source code. Currently the direct link is http://sourceforge.net/projects/freetype/files/ttfautohint/0.95/ttfautohint-0.95.tar.gz/download
In Finder, go to your Downloads folder and double click the ttfautohint-0.95.tar.gz file to unpack it into a folder named ttfautohint-0.95. Move the ttfautohint-0.95 folder to the src folder in your Home folder.
In Terminal, type...
cd ~/src/ttfautohint-0.95;

Press the return key, and type...
./configure --without-doc;

Press the return key and you will see a bunch of text rolling through the Terminal app. When it is done, type...
make;

Press the return key and you will see a bunch of text rolling through the Terminal app. When it is done, type...
sudo make install;

Press the return key, then enter your Mac login password, then press the return key again. You will see a bunch of text rolling through the Terminal app. When it is done, type...
ttfautohintGUI;

Press the return key, and you should now see the GUI!
:-)