Merge pull request #32 from ax3l/ssh-moreEtmMacs
[ach-master.git] / 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