Toolchain

Revision 5 as of 2011-01-05 00:01:51

Clear message

Toolchain Installation

Requirements

  • Installation of TeX Live from ctan.org
  • Execution of a script in the ubuntu-developer-manual branch

Install TeX Live

  1. Uninstall Ubuntu TeX Live packages:
    • sudo apt-get remove texlive-*
  2. Download the TeX Live 2010 install script: http://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz

  3. Unpck the tarball:
    • tar -zxvf install-tl-unx.tar.gz
  4. Change to the newly unpacked directory:
    • cd install-tl-*
  5. Run the installation script:
    • sudo ./install-tl
  6. Configure the installation.
    • Use all defaults except: enable Create symlinks to standard directories, as follows:

    1. Enter capital letter 'O'
    2. Enter capital letter 'L'
    3. You are prompted, one at a time, to enter where you want binaries, man pages, and info pages. Use the following:
      • For binaries, use: /usr/bin
      • For man, use /usr/share/man
      • For info, use /usr/share/info
    4. Enter capital 'R' to return to the main menu
  7. Install:
    • Enter capital 'I' to install. This will take some time.

Get Trunk and Run Script

  1. Create a working dir and move into it
  2. Get the ubuntu-developer-manual branch:
    • bzr branch lp:ubuntu-developer-manual
  3. Execute install-pkgs.sh as root:
    • sudo ./install-pkgs.sh

Language Toolchain

  • launchpad.net to provide web UI for translation and to export translations to po files in trunk. (Ubuntu Translators through their good graces to translate.)
  • XeTeX. This is the underlying typesetting engine that we're using. It's what takes our code and generates PDFs. It supports Unicode, OpenType and Truetype fonts.

  • LaTeX. This is a common set of macros that run on top of the XeTeX (and other TeX) engine. This is what provides the \chapter{}, \section{}, etc. commands.
  • fontspec package. This package is a set of macros that provides afriendlier user interface to the underlying XeTeX font commands.
  • polyglossia package. This package maintains common translations(e.g., "Table of Contents," "Index," "Figure," "Table," "Glossary,") for a wide variety of languages and also changes the font based on the currently selected language.
  • xindy. Sorts and manages the indexes and glossaries.
  • po4a. po4a reads in our .tex files and emits .pot files. It also takes .po files and generates translated .tex files.