don't forget things we said during the meeting. put it into TODO.md

[ach-master.git] / fontSetup.md

diff --git a/fontSetup.md b/fontSetup.md
index 11fc567..8e661be 100644 (file)
--- a/fontSetup.md
+++ b/fontSetup.md
@@ -1,10 +1,61 @@
 # Font Setup
-
 ============
 
-## Installing Open Sans
+To use the proper font for PDF rendering you need to install the necessary typefaces into your TeX distribution.
+
+## Installing Open Sans for TeXLive/MacTeX (> 2011)
+
+* `tlmgr install opensans` (with `sudo`, if applicable)
+* Or, on MacTeX, use the _TeX Live Utility_ to search for 'opensans'
+
+
+## Installing Open Sans manually
 
 1. Find your texmf directory: `kpsewhich -var-value TEXMFHOME`
-2. Copy the font files from the fonts directory in the repository to your texmf folder.
-3. Run `mktexlsr` to refresh the file name database and make TEX aware of the new files.
-4. Run `updmap --enable Map=opensans.map` to make Dvips, dvipdf and pdfTEX aware of the new fonts.
\ No newline at end of file
+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.
+3. Run `mktexlsr` to refresh the file name database and make TEX aware of the new files. (You _may_ need `sudo` here.)
+4. Run `updmap --enable Map=opensans.map` to make `Dvips`, `dvipdf` and `pdfTEX` aware of the new fonts.
+
+
+Now you can use `make pdf` to render a PDF using the new fonts.
+
+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/>
+
+
+
+--------------------------------------------------------------------------------
+### Resulting `texmf` directory structure
+
+This what your `texmf` folder structure should look like now.
+
+       ├── doc
+       │   └── fonts
+       │       └── opensans
+       ├── fonts
+       │   ├── afm
+       │   │   └── public
+       │   │       └── opensans
+       │   ├── enc
+       │   │   └── dvips
+       │   │       └── opensans
+       │   ├── map
+       │   │   └── dvips
+       │   │       └── opensans
+       │   ├── tfm
+       │   │   └── public
+       │   │       └── opensans
+       │   ├── truetype
+       │   │   └── public
+       │   │       └── opensans
+       │   ├── type1
+       │   │   └── public
+       │   │       └── opensans
+       │   └── vf
+       │       └── public
+       │           └── opensans
+       ├── source
+       │   └── fonts
+       │       └── opensans
+       └── tex
+           └── latex
+               └── opensans