fontSetup.md

   1 # Font Setup
   2 ============
   3
   4 To use the proper font for PDF rendering you need to install the necessary typefaces into your TeX distribution.
   5
   6 ## Installing Open Sans for TeXLive/MacTeX (> 2011)
   7
   8 * `tlmgr install opensans` (with `sudo`, if applicable)
   9 * Or, on MacTeX, use the _TeX Live Utility_ to search for 'opensans'
  10
  11
  12 ## Installing Open Sans manually
  13
  14 1. Find your texmf directory: `kpsewhich -var-value TEXMFHOME`
  15 2. Copy the font folders from the `fonts/opensans` directory in the repository to the respective folders your texmf folder. Be careful not to replace any existing contents in there.
  16 3. Run `mktexlsr` to refresh the file name database and make TEX aware of the new files. (You _may_ need `sudo` here.)
  17 4. Run `updmap --enable Map=opensans.map` to make `Dvips`, `dvipdf` and `pdfTEX` aware of the new fonts.
  18
  19
  20 Now you can use `make pdf` to render a PDF using the new fonts.
  21
  22 You can find further information on Open Sans in the file `fonts/opensans/doc/fonts/opensans/opensans.pdf` and here: <http://www.ctan.org/tex-archive/fonts/opensans/>
  23
  24
  25
  26 --------------------------------------------------------------------------------
  27 ### Resulting `texmf` directory structure
  28
  29 This what your `texmf` folder structure should look like now.
  30
  31         ├── doc
  32         │   └── fonts
  33         │       └── opensans
  34         ├── fonts
  35         │   ├── afm
  36         │   │   └── public
  37         │   │       └── opensans
  38         │   ├── enc
  39         │   │   └── dvips
  40         │   │       └── opensans
  41         │   ├── map
  42         │   │   └── dvips
  43         │   │       └── opensans
  44         │   ├── tfm
  45         │   │   └── public
  46         │   │       └── opensans
  47         │   ├── truetype
  48         │   │   └── public
  49         │   │       └── opensans
  50         │   ├── type1
  51         │   │   └── public
  52         │   │       └── opensans
  53         │   └── vf
  54         │       └── public
  55         │           └── opensans
  56         ├── source
  57         │   └── fonts
  58         │       └── opensans
  59         └── tex
  60             └── latex
  61                 └── opensans