add guardian article
[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
7 ## Installing Open Sans
8
9 1. Find your texmf directory: `kpsewhich -var-value TEXMFHOME`
10 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.
11 3. Run `mktexlsr` to refresh the file name database and make TEX aware of the new files. (You _may_ need `sudo` here.)
12 4. Run `updmap --enable Map=opensans.map` to make `Dvips`, `dvipdf` and `pdfTEX` aware of the new fonts.
13
14
15 Now you can use `make pdf` to render a PDF using the new fonts.
16
17 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/>
18
19
20
21 --------------------------------------------------------------------------------
22 ### Resulting `texmf` directory structure
23
24 This what your `texmf` folder structure should look like now.
25
26         ├── doc
27         │   └── fonts
28         │       └── opensans
29         ├── fonts
30         │   ├── afm
31         │   │   └── public
32         │   │       └── opensans
33         │   ├── enc
34         │   │   └── dvips
35         │   │       └── opensans
36         │   ├── map
37         │   │   └── dvips
38         │   │       └── opensans
39         │   ├── tfm
40         │   │   └── public
41         │   │       └── opensans
42         │   ├── truetype
43         │   │   └── public
44         │   │       └── opensans
45         │   ├── type1
46         │   │   └── public
47         │   │       └── opensans
48         │   └── vf
49         │       └── public
50         │           └── opensans
51         ├── source
52         │   └── fonts
53         │       └── opensans
54         └── tex
55             └── latex
56                 └── opensans