Toolchain

Differences between revisions 4 and 6 (spanning 2 versions)
Revision 4 as of 2011-01-05 00:00:38
Size: 2490
Editor: 173-20-49-63
Comment:
Revision 6 as of 2011-01-05 19:18:50
Size: 2744
Editor: eth3
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= Toolchain Installation =
== Requirements ==
= Toolchain =
==
Installation ==
=== Requirements ===
Line 5: Line 6:
 * Reinstalling man-db package (or the {{{man <command>}}} won't work
Line 6: Line 8:
== Install TeX Live == === Install TeX Live ===
Line 17: Line 19:
 1. Change to the newly-unpacked directory:  1. Change to the newly unpacked directory:
Line 37: Line 39:
== Get Trunk and Run Script == === Get Trunk and Run Script ===
Line 49: Line 51:
= Language Toolchain = === Reinstall man-db ===

After installation, the {{{man}}} command may not work. You can restore it as follows:
{{{
sudo apt-get install --reinstall man-db
}}}

== Language Toolchain ==
Line 53: Line 62:
 * XeTeX. This is the underlying typesetting engine that we're using. IUt's what takes our code and generates PDFs. It supports Unicode, OpenType and Truetype fonts.  * 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.

Toolchain

Installation

Requirements

  • Installation of TeX Live from ctan.org
  • Execution of a script in the ubuntu-developer-manual branch
  • Reinstalling man-db package (or the man <command> won't work

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

Reinstall man-db

After installation, the man command may not work. You can restore it as follows:

sudo apt-get install --reinstall man-db

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.

DesktopTeam/10.10/DeveloperManual/Toolchain (last edited 2011-01-05 19:18:50 by eth3)