c73f6ea39ef2a11e4194bc79c858587e97be5e28
[ach-master.git] / fontSetup.md
1 # Font Setup
2 ============
3
4 To use the proper font for PDF rendering you need 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
18 --------------------------------------------------------------------------------
19 ### Resulting `texmf` directory structure
20
21 This what your `texmf` folder structure should look like now.
22
23         ├── doc
24         │   └── fonts
25         │       └── opensans
26         ├── fonts
27         │   ├── afm
28         │   │   └── public
29         │   │       └── opensans
30         │   ├── enc
31         │   │   └── dvips
32         │   │       └── opensans
33         │   ├── map
34         │   │   └── dvips
35         │   │       └── opensans
36         │   ├── tfm
37         │   │   └── public
38         │   │       └── opensans
39         │   ├── truetype
40         │   │   └── public
41         │   │       └── opensans
42         │   ├── type1
43         │   │   └── public
44         │   │       └── opensans
45         │   └── vf
46         │       └── public
47         │           └── opensans
48         ├── source
49         │   └── fonts
50         │       └── opensans
51         └── tex
52             └── latex
53                 └── opensans