1 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
---|
2 | <html xmlns="http://www.w3.org/1999/xhtml"> |
---|
3 | <head> |
---|
4 | <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> |
---|
5 | <meta http-equiv="Content-Style-Type" content="text/css" /> |
---|
6 | <meta name="generator" content="pandoc" /> |
---|
7 | <title></title> |
---|
8 | <style type="text/css">code{white-space: pre;}</style> |
---|
9 | <style type="text/css"> |
---|
10 | table.sourceCode, tr.sourceCode, td.lineNumbers, td.sourceCode { |
---|
11 | margin: 0; padding: 0; vertical-align: baseline; border: none; } |
---|
12 | table.sourceCode { width: 100%; line-height: 100%; } |
---|
13 | td.lineNumbers { text-align: right; padding-right: 4px; padding-left: 4px; color: #aaaaaa; border-right: 1px solid #aaaaaa; } |
---|
14 | td.sourceCode { padding-left: 5px; } |
---|
15 | code > span.kw { color: #007020; font-weight: bold; } |
---|
16 | code > span.dt { color: #902000; } |
---|
17 | code > span.dv { color: #40a070; } |
---|
18 | code > span.bn { color: #40a070; } |
---|
19 | code > span.fl { color: #40a070; } |
---|
20 | code > span.ch { color: #4070a0; } |
---|
21 | code > span.st { color: #4070a0; } |
---|
22 | code > span.co { color: #60a0b0; font-style: italic; } |
---|
23 | code > span.ot { color: #007020; } |
---|
24 | code > span.al { color: #ff0000; font-weight: bold; } |
---|
25 | code > span.fu { color: #06287e; } |
---|
26 | code > span.er { color: #ff0000; font-weight: bold; } |
---|
27 | </style> |
---|
28 | <link href="data:text/css,%2F%2A%0A%20%20%20%20Buttondown%0A%20%20%20%20A%20Markdown%2FMultiMarkdown%2FPandoc%20HTML%20output%20CSS%20stylesheet%0A%20%20%20%20Author%3A%20Ryan%20Gray%0A%20%20%20%20Date%3A%2015%20Feb%202011%0A%20%20%20%20Revised%3A%2021%20Feb%202012%0A%20%20%20%0A%20%20%20%20General%20style%20is%20clean%2C%20with%20minimal%20re%2Ddefinition%20of%20the%20defaults%20or%20%0A%20%20%20%20overrides%20of%20user%20font%20settings%2E%20The%20body%20text%20and%20header%20styles%20are%20%0A%20%20%20%20left%20alone%20except%20title%2C%20author%20and%20date%20classes%20are%20centered%2E%20A%20Pandoc%20TOC%20%0A%20%20%20%20is%20not%20printed%2C%20URLs%20are%20printed%20after%20hyperlinks%20in%20parentheses%2E%20%0A%20%20%20%20Block%20quotes%20are%20italicized%2E%20Tables%20are%20lightly%20styled%20with%20lines%20above%20%0A%20%20%20%20and%20below%20the%20table%20and%20below%20the%20header%20with%20a%20boldface%20header%2E%20Code%20%0A%20%20%20%20blocks%20are%20line%20wrapped%2E%20%0A%20%0A%20%20%20%20All%20elements%20that%20Pandoc%20and%20MultiMarkdown%20use%20should%20be%20listed%20here%2C%20even%20%0A%20%20%20%20if%20the%20style%20is%20empty%20so%20you%20can%20easily%20add%20styling%20to%20anything%2E%0A%20%20%20%20%0A%20%20%20%20There%20are%20some%20elements%20in%20here%20for%20HTML5%20output%20of%20Pandoc%2C%20but%20I%20have%20not%20%0A%20%20%20%20gotten%20around%20to%20testing%20that%20yet%2E%0A%2A%2F%0A%20%0A%2F%2A%20NOTES%3A%0A%20%0A%20%20%20%20Stuff%20tried%20and%20failed%3A%0A%20%20%20%20%0A%20%20%20%20It%20seems%20that%20specifying%20font%2Dfamily%3Aserif%20in%20Safari%20will%20always%20use%20%0A%20%20%20%20Times%20New%20Roman%20rather%20than%20the%20user%27s%20preferences%20setting%2E%0A%20%20%20%20%0A%20%20%20%20Making%20the%20font%20size%20different%20or%20a%20fixed%20value%20for%20print%20in%20case%20the%20screen%20%0A%20%20%20%20font%20size%20is%20making%20the%20print%20font%20too%20big%3A%20Making%20font%2Dsize%20different%20for%20%0A%20%20%20%20print%20than%20for%20screen%20causes%20horizontal%20lines%20to%20disappear%20in%20math%20when%20using%20%0A%20%20%20%20MathJax%20under%20Safari%2E%0A%2A%2F%0A%20%0A%2F%2A%20%2D%2D%2D%2D%20Front%20Matter%20%2D%2D%2D%2D%20%2A%2F%0A%20%0A%2F%2A%20Pandoc%20header%20DIV%2E%20Contains%20%2Etitle%2C%20%2Eauthor%20and%20%2Edate%2E%20Comes%20before%20div%23TOC%2E%20%0A%20%20%20Only%20appears%20if%20one%20of%20those%20three%20are%20in%20the%20document%2E%0A%2A%2F%0A%20%0Adiv%23header%2C%20header%0A%20%20%20%20%7B%0A%20%20%20%20%2F%2A%20Put%20border%20on%20bottom%2E%20Separates%20it%20from%20TOC%20or%20body%20that%20comes%20after%20it%2E%20%2A%2F%0A%20%20%20%20border%2Dbottom%3A%201px%20solid%20%23aaa%3B%0A%20%20%20%20margin%2Dbottom%3A%200%2E5em%3B%0A%20%20%20%20%7D%0A%20%0A%2Etitle%20%2F%2A%20Pandoc%20title%20header%20%28h1%2Etitle%29%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20text%2Dalign%3A%20center%3B%0A%20%20%20%20%7D%0A%20%0A%2Eauthor%2C%20%2Edate%20%2F%2A%20Pandoc%20author%28s%29%20and%20date%20headers%20%28h2%2Eauthor%20and%20h3%2Edate%29%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20text%2Dalign%3A%20center%3B%0A%20%20%20%20%7D%0A%20%0A%2F%2A%20Pandoc%20table%20of%20contents%20DIV%20when%20using%20the%20%2D%2Dtoc%20option%2E%0A%20%20%20NOTE%3A%20this%20doesn%27t%20support%20Pandoc%27s%20%2D%2Did%2Dprefix%20option%20for%20%23TOC%20and%20%23header%2E%20%0A%20%20%20Probably%20would%20need%20to%20use%20div%5Bid%24%3D%27TOC%27%5D%20and%20div%5Bid%24%3D%27header%27%5D%20as%20selectors%2E%0A%2A%2F%0A%20%0Adiv%23TOC%2C%20nav%23TOC%0A%20%20%20%20%7B%0A%20%20%20%20%2F%2A%20Put%20border%20on%20bottom%20to%20separate%20it%20from%20body%2E%20%2A%2F%0A%20%20%20%20border%2Dbottom%3A%201px%20solid%20%23aaa%3B%0A%20%20%20%20margin%2Dbottom%3A%200%2E5em%3B%0A%20%20%20%20%7D%0A%20%0A%40media%20print%0A%20%20%20%20%7B%0A%20%20%20%20div%23TOC%2C%20nav%23TOC%0A%20%20%20%20%20%20%20%20%7B%0A%20%20%20%20%20%20%20%20%2F%2A%20Don%27t%20display%20TOC%20in%20print%20%2A%2F%0A%20%20%20%20%20%20%20%20display%3A%20none%3B%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%7D%0A%20%0A%2F%2A%20%2D%2D%2D%2D%20Headers%20and%20sections%20%2D%2D%2D%2D%20%2A%2F%0A%20%0Ah1%2C%20h2%2C%20h3%2C%20h4%2C%20h5%2C%20h6%0A%7B%0A%20%20%20%20font%2Dfamily%3A%20%22Helvetica%20Neue%22%2C%20Helvetica%2C%20%22Liberation%20Sans%22%2C%20Calibri%2C%20Arial%2C%20sans%2Dserif%3B%20%2F%2A%20Sans%2Dserif%20headers%20%2A%2F%0A%20%0A%20%20%20%20%2F%2A%20font%2Dfamily%3A%20%22Liberation%20Serif%22%2C%20%22Georgia%22%2C%20%22Times%20New%20Roman%22%2C%20serif%3B%20%2F%2A%20Serif%20headers%20%2A%2F%0A%20%0A%20%20%20%20page%2Dbreak%2Dafter%3A%20avoid%3B%20%2F%2A%20Firefox%2C%20Chrome%2C%20and%20Safari%20do%20not%20support%20the%20property%20value%20%22avoid%22%20%2A%2F%0A%7D%0A%20%0A%2F%2A%20Pandoc%20with%20%2D%2Dsection%2Ddivs%20option%20%2A%2F%0A%20%0Adiv%20div%2C%20section%20section%20%2F%2A%20Nested%20sections%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20margin%2Dleft%3A%202em%3B%20%2F%2A%20This%20will%20increasingly%20indent%20nested%20header%20sections%20%2A%2F%0A%20%20%20%20%7D%0A%20%0Ap%20%7B%7D%0A%20%0Ablockquote%0A%20%20%20%20%7B%20%0A%20%20%20%20font%2Dstyle%3A%20italic%3B%0A%20%20%20%20%7D%0A%20%0Ali%20%2F%2A%20All%20list%20items%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20%7D%0A%20%0Ali%20%3E%20p%20%2F%2A%20Loosely%20spaced%20list%20item%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20margin%2Dtop%3A%201em%3B%20%2F%2A%20IE%3A%20lack%20of%20space%20above%20a%20%3Cli%3E%20when%20the%20item%20is%20inside%20a%20%3Cp%3E%20%2A%2F%0A%20%20%20%20%7D%0A%20%0Aul%20%2F%2A%20Whole%20unordered%20list%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20%7D%0A%20%0Aul%20li%20%2F%2A%20Unordered%20list%20item%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20%7D%0A%20%0Aol%20%2F%2A%20Whole%20ordered%20list%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20%7D%0A%20%0Aol%20li%20%2F%2A%20Ordered%20list%20item%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20%7D%0A%20%0Ahr%20%7B%7D%0A%20%0A%2F%2A%20%2D%2D%2D%2D%20Some%20span%20elements%20%2D%2D%2D%20%2A%2F%0A%20%0Asub%20%2F%2A%20Subscripts%2E%20Pandoc%3A%20H%7E2%7EO%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20%7D%0A%20%0Asup%20%2F%2A%20Superscripts%2E%20Pandoc%3A%20The%202%5End%5E%20try%2E%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20%7D%0A%20%20%20%20%0Aem%20%2F%2A%20Emphasis%2E%20Markdown%3A%20%2Aemphasis%2A%20or%20%5Femphasis%5F%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20%7D%0A%20%20%20%20%0Aem%20%3E%20em%20%2F%2A%20Emphasis%20within%20emphasis%3A%20%2AThis%20is%20all%20%2Aemphasized%2A%20except%20that%2A%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20font%2Dstyle%3A%20normal%3B%0A%20%20%20%20%7D%0A%20%0Astrong%20%2F%2A%20Markdown%20%2A%2Astrong%2A%2A%20or%20%5F%5Fstrong%5F%5F%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20%7D%0A%20%0A%2F%2A%20%2D%2D%2D%2D%20Links%20%28anchors%29%20%2D%2D%2D%2D%20%2A%2F%0A%20%0Aa%20%2F%2A%20All%20links%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20%2F%2A%20Keep%20links%20clean%2E%20On%20screen%2C%20they%20are%20colored%3B%20in%20print%2C%20they%20do%20nothing%20anyway%2E%20%2A%2F%0A%20%20%20%20text%2Ddecoration%3A%20none%3B%0A%20%20%20%20%7D%0A%20%0A%40media%20screen%0A%20%20%20%20%7B%0A%20%20%20%20a%3Ahover%0A%20%20%20%20%20%20%20%20%7B%0A%20%20%20%20%20%20%20%20%2F%2A%20On%20hover%2C%20we%20indicate%20a%20bit%20more%20that%20it%20is%20a%20link%2E%20%2A%2F%0A%20%20%20%20%20%20%20%20text%2Ddecoration%3A%20underline%3B%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%7D%0A%20%0A%40media%20print%0A%20%20%20%20%7B%0A%20%20%20%20a%20%20%20%7B%0A%20%20%20%20%20%20%20%20%2F%2A%20In%20print%2C%20a%20colored%20link%20is%20useless%2C%20so%20un%2Dstyle%20it%2E%20%2A%2F%0A%20%20%20%20%20%20%20%20color%3A%20black%3B%0A%20%20%20%20%20%20%20%20background%3A%20transparent%3B%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%0A%20%20%20%20a%5Bhref%5E%3D%22http%3A%2F%2F%22%5D%3Aafter%2C%20a%5Bhref%5E%3D%22https%3A%2F%2F%22%5D%3Aafter%0A%20%20%20%20%20%20%20%20%7B%0A%20%20%20%20%20%20%20%20%2F%2A%20However%2C%20links%20that%20go%20somewhere%20else%2C%20might%20be%20useful%20to%20the%20reader%2C%0A%20%20%20%20%20%20%20%20%20%20%20so%20for%20http%20and%20https%20links%2C%20print%20the%20URL%20after%20what%20was%20the%20link%20%0A%20%20%20%20%20%20%20%20%20%20%20text%20in%20parens%0A%20%20%20%20%20%20%20%20%2A%2F%0A%20%20%20%20%20%20%20%20content%3A%20%22%20%28%22%20attr%28href%29%20%22%29%20%22%3B%0A%20%20%20%20%20%20%20%20font%2Dsize%3A%2090%25%3B%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%7D%0A%20%0A%2F%2A%20%2D%2D%2D%2D%20Images%20%2D%2D%2D%2D%20%2A%2F%0A%20%0Aimg%0A%20%20%20%20%7B%0A%20%20%20%20%2F%2A%20Let%20it%20be%20inline%20left%2Fright%20where%20it%20wants%20to%20be%2C%20but%20verticality%20make%20%0A%20%20%20%20%20%20%20it%20in%20the%20middle%20to%20look%20nicer%2C%20but%20opinions%20differ%2C%20and%20if%20in%20a%20multi%2Dline%20%0A%20%20%20%20%20%20%20paragraph%2C%20it%20might%20not%20be%20so%20great%2E%20%0A%20%20%20%20%2A%2F%0A%20%20%20%20vertical%2Dalign%3A%20middle%3B%0A%20%20%20%20%7D%0A%20%0Adiv%2Efigure%20%2F%2A%20Pandoc%20figure%2Dstyle%20image%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20%2F%2A%20Center%20the%20image%20and%20caption%20%2A%2F%0A%20%20%20%20margin%2Dleft%3A%20auto%3B%0A%20%20%20%20margin%2Dright%3A%20auto%3B%0A%20%20%20%20text%2Dalign%3A%20center%3B%0A%20%20%20%20font%2Dstyle%3A%20italic%3B%0A%20%20%20%20%7D%0A%20%0Ap%2Ecaption%20%2F%2A%20Pandoc%20figure%2Dstyle%20caption%20within%20div%2Efigure%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20%2F%2A%20Inherits%20div%2Efigure%20props%20by%20default%20%2A%2F%0A%20%20%20%20%7D%0A%20%0A%2F%2A%20%2D%2D%2D%2D%20Code%20blocks%20and%20spans%20%2D%2D%2D%2D%20%2A%2F%0A%20%0Apre%2C%20code%20%0A%20%20%20%20%7B%0A%20%20%20%20background%2Dcolor%3A%20%23fdf7ee%3B%0A%20%20%20%20%2F%2A%20BEGIN%20word%20wrap%20%2A%2F%0A%20%20%20%20%2F%2A%20Need%20all%20the%20following%20to%20word%20wrap%20instead%20of%20scroll%20box%20%2A%2F%0A%20%20%20%20%2F%2A%20This%20will%20override%20the%20overflow%3Aauto%20if%20present%20%2A%2F%0A%20%20%20%20white%2Dspace%3A%20pre%2Dwrap%3B%20%2F%2A%20css%2D3%20%2A%2F%0A%20%20%20%20white%2Dspace%3A%20%2Dmoz%2Dpre%2Dwrap%20%21important%3B%20%2F%2A%20Mozilla%2C%20since%201999%20%2A%2F%0A%20%20%20%20white%2Dspace%3A%20%2Dpre%2Dwrap%3B%20%2F%2A%20Opera%204%2D6%20%2A%2F%0A%20%20%20%20white%2Dspace%3A%20%2Do%2Dpre%2Dwrap%3B%20%2F%2A%20Opera%207%20%2A%2F%0A%20%20%20%20word%2Dwrap%3A%20break%2Dword%3B%20%2F%2A%20Internet%20Explorer%205%2E5%2B%20%2A%2F%0A%20%20%20%20%2F%2A%20END%20word%20wrap%20%2A%2F%0A%20%20%20%20%7D%0A%20%0Apre%20%2F%2A%20Code%20blocks%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20%2F%2A%20Distinguish%20pre%20blocks%20from%20other%20text%20by%20more%20than%20the%20font%20with%20a%20background%20tint%2E%20%2A%2F%0A%20%20%20%20padding%3A%200%2E5em%3B%20%2F%2A%20Since%20we%20have%20a%20background%20color%20%2A%2F%0A%20%20%20%20border%2Dradius%3A%205px%3B%20%2F%2A%20Softens%20it%20%2A%2F%0A%20%20%20%20%2F%2A%20Give%20it%20a%20some%20definition%20%2A%2F%0A%20%20%20%20border%3A%201px%20solid%20%23aaa%3B%0A%20%20%20%20%2F%2A%20Set%20it%20off%20left%20and%20right%2C%20seems%20to%20look%20a%20bit%20nicer%20when%20we%20have%20a%20background%20%2A%2F%0A%20%20%20%20margin%2Dleft%3A%20%200%2E5em%3B%0A%20%20%20%20margin%2Dright%3A%200%2E5em%3B%0A%20%20%20%20%7D%0A%20%0A%40media%20screen%0A%20%20%20%20%7B%0A%20%20%20%20pre%0A%20%20%20%20%20%20%20%20%7B%0A%20%20%20%20%20%20%20%20%2F%2A%20On%20screen%2C%20use%20an%20auto%20scroll%20box%20for%20long%20lines%2C%20unless%20word%2Dwrap%20is%20enabled%20%2A%2F%0A%20%20%20%20%20%20%20%20white%2Dspace%3A%20pre%3B%0A%20%20%20%20%20%20%20%20overflow%3A%20auto%3B%0A%20%20%20%20%20%20%20%20%2F%2A%20Dotted%20looks%20better%20on%20screen%20and%20solid%20seems%20to%20print%20better%2E%20%2A%2F%0A%20%20%20%20%20%20%20%20border%3A%201px%20dotted%20%23777%3B%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%7D%0A%20%0Acode%20%2F%2A%20All%20inline%20code%20spans%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20%7D%0A%20%0Ap%20%3E%20code%2C%20li%20%3E%20code%20%2F%2A%20Code%20spans%20in%20paragraphs%20and%20tight%20lists%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20%2F%2A%20Pad%20a%20little%20from%20adjacent%20text%20%2A%2F%0A%20%20%20%20padding%2Dleft%3A%20%202px%3B%0A%20%20%20%20padding%2Dright%3A%202px%3B%0A%20%20%20%20%7D%0A%20%20%20%20%0Ali%20%3E%20p%20code%20%2F%2A%20Code%20span%20in%20a%20loose%20list%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20%2F%2A%20We%20have%20room%20for%20some%20more%20background%20color%20above%20and%20below%20%2A%2F%0A%20%20%20%20padding%3A%202px%3B%0A%20%20%20%20%7D%0A%20%0A%2F%2A%20%2D%2D%2D%2D%20Math%20%2D%2D%2D%2D%20%2A%2F%0A%20%0Aspan%2Emath%20%2F%2A%20Pandoc%20inline%20math%20default%20and%20%2D%2Djsmath%20inline%20math%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20%2F%2A%20Tried%20font%2Dstyle%3Aitalic%20here%2C%20and%20it%20messed%20up%20MathJax%20rendering%20in%20some%20browsers%2E%20Maybe%20don%27t%20mess%20with%20at%20all%2E%20%2A%2F%0A%20%20%20%20%7D%0A%20%20%20%20%0Adiv%2Emath%20%2F%2A%20Pandoc%20%2D%2Djsmath%20display%20math%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20%7D%0A%20%20%20%20%0Aspan%2ELaTeX%20%2F%2A%20Pandoc%20%2D%2Dlatexmathml%20math%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20%7D%20%0A%20%0Aeq%20%2F%2A%20Pandoc%20%2D%2Dgladtex%20math%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20%7D%20%0A%20%0A%2F%2A%20%2D%2D%2D%2D%20Tables%20%2D%2D%2D%2D%20%2A%2F%0A%20%0A%2F%2A%20%20A%20clean%20textbook%2Dlike%20style%20with%20horizontal%20lines%20above%20and%20below%20and%20under%20%0A%20%20%20%20the%20header%2E%20Rows%20highlight%20on%20hover%20to%20help%20scanning%20the%20table%20on%20screen%2E%0A%2A%2F%0A%20%0Atable%0A%20%20%20%20%7B%0A%20%20%20%20border%2Dcollapse%3A%20collapse%3B%0A%20%20%20%20border%2Dspacing%3A%200%3B%20%2F%2A%20IE%206%20%2A%2F%0A%20%0A%20%20%20%20border%2Dbottom%3A%202pt%20solid%20%23000%3B%0A%20%20%20%20border%2Dtop%3A%202pt%20solid%20%23000%3B%20%2F%2A%20The%20caption%20on%20top%20will%20not%20have%20a%20bottom%2Dborder%20%2A%2F%0A%20%0A%20%20%20%20%2F%2A%20Center%20%2A%2F%0A%20%20%20%20margin%2Dleft%3A%20auto%3B%0A%20%20%20%20margin%2Dright%3A%20auto%3B%0A%20%20%20%20%7D%0A%20%20%20%20%0Athead%20%2F%2A%20Entire%20table%20header%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20border%2Dbottom%3A%201pt%20solid%20%23000%3B%0A%20%20%20%20background%2Dcolor%3A%20%23eee%3B%20%2F%2A%20Does%20this%20BG%20print%20well%3F%20%2A%2F%0A%20%20%20%20%7D%0A%20%0Atr%2Eheader%20%2F%2A%20Each%20header%20row%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20%7D%20%0A%20%0Atbody%20%2F%2A%20Entire%20table%20%20body%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20%7D%0A%20%0A%2F%2A%20Table%20body%20rows%20%2A%2F%0A%20%0Atr%20%20%7B%0A%20%20%20%20%7D%0Atr%2Eodd%3Ahover%2C%20tr%2Eeven%3Ahover%20%2F%2A%20Use%20%2Eodd%20and%20%2Eeven%20classes%20to%20avoid%20styling%20rows%20in%20other%20tables%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20background%2Dcolor%3A%20%23eee%3B%0A%20%20%20%20%7D%0A%20%20%20%20%0A%2F%2A%20Odd%20and%20even%20rows%20%2A%2F%0Atr%2Eodd%20%7B%7D%0Atr%2Eeven%20%7B%7D%0A%20%0Atd%2C%20th%20%2F%2A%20Table%20cells%20and%20table%20header%20cells%20%2A%2F%0A%20%20%20%20%7B%20%0A%20%20%20%20vertical%2Dalign%3A%20top%3B%20%2F%2A%20Word%20%2A%2F%0A%20%20%20%20vertical%2Dalign%3A%20baseline%3B%20%2F%2A%20Others%20%2A%2F%0A%20%20%20%20padding%2Dleft%3A%20%20%200%2E5em%3B%0A%20%20%20%20padding%2Dright%3A%20%200%2E5em%3B%0A%20%20%20%20padding%2Dtop%3A%20%20%20%200%2E2em%3B%0A%20%20%20%20padding%2Dbottom%3A%200%2E2em%3B%0A%20%20%20%20%7D%0A%20%20%20%20%0A%2F%2A%20Removes%20padding%20on%20left%20and%20right%20of%20table%20for%20a%20tight%20look%2E%20Good%20if%20thead%20has%20no%20background%20color%2A%2F%0A%2F%2A%0Atr%20td%3Alast%2Dchild%2C%20tr%20th%3Alast%2Dchild%0A%20%20%20%20%7B%0A%20%20%20%20padding%2Dright%3A%200%3B%0A%20%20%20%20%7D%0Atr%20td%3Afirst%2Dchild%2C%20tr%20th%3Afirst%2Dchild%20%0A%20%20%20%20%7B%0A%20%20%20%20padding%2Dleft%3A%200%3B%0A%20%20%20%20%7D%0A%2A%2F%0A%20%0Ath%20%2F%2A%20Table%20header%20cells%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20font%2Dweight%3A%20bold%3B%20%0A%20%20%20%20%7D%0A%20%0Atfoot%20%2F%2A%20Table%20footer%20%28what%20appears%20here%20if%20caption%20is%20on%20top%3F%29%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20%7D%0A%20%0Acaption%20%2F%2A%20This%20is%20for%20a%20table%20caption%20tag%2C%20not%20the%20p%2Ecaption%20Pandoc%20uses%20in%20a%20div%2Efigure%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20caption%2Dside%3A%20top%3B%0A%20%20%20%20border%3A%20none%3B%0A%20%20%20%20font%2Dsize%3A%200%2E9em%3B%0A%20%20%20%20font%2Dstyle%3A%20italic%3B%0A%20%20%20%20text%2Dalign%3A%20center%3B%0A%20%20%20%20margin%2Dbottom%3A%200%2E3em%3B%20%2F%2A%20Good%20for%20when%20on%20top%20%2A%2F%0A%20%20%20%20padding%2Dbottom%3A%200%2E2em%3B%0A%20%20%20%20%7D%0A%20%0A%2F%2A%20%2D%2D%2D%2D%20Definition%20lists%20%2D%2D%2D%2D%20%2A%2F%0A%20%0Adl%20%2F%2A%20The%20whole%20list%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20border%2Dtop%3A%202pt%20solid%20black%3B%0A%20%20%20%20padding%2Dtop%3A%200%2E5em%3B%0A%20%20%20%20border%2Dbottom%3A%202pt%20solid%20black%3B%0A%20%20%20%20%7D%0A%20%0Adt%20%2F%2A%20Definition%20term%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20font%2Dweight%3A%20bold%3B%0A%20%20%20%20%7D%0A%20%0Add%2Bdt%20%2F%2A%202nd%20or%20greater%20term%20in%20the%20list%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20border%2Dtop%3A%201pt%20solid%20black%3B%0A%20%20%20%20padding%2Dtop%3A%200%2E5em%3B%0A%20%20%20%20%7D%0A%20%20%20%20%0Add%20%2F%2A%20A%20definition%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20margin%2Dbottom%3A%200%2E5em%3B%0A%20%20%20%20%7D%0A%20%0Add%2Bdd%20%2F%2A%202nd%20or%20greater%20definition%20of%20a%20term%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20border%2Dtop%3A%201px%20solid%20black%3B%20%2F%2A%20To%20separate%20multiple%20definitions%20%2A%2F%0A%20%20%20%20%7D%0A%20%20%20%20%0A%2F%2A%20%2D%2D%2D%2D%20Footnotes%20%2D%2D%2D%2D%20%2A%2F%0A%20%0Aa%2Efootnote%2C%20a%2EfootnoteRef%20%7B%20%2F%2A%20Pandoc%2C%20MultiMarkdown%20footnote%20links%20%2A%2F%0A%20%20%20%20font%2Dsize%3A%20small%3B%20%0A%20%20%20%20vertical%2Dalign%3A%20text%2Dtop%3B%0A%7D%0A%20%0Aa%5Bhref%5E%3D%22%23fnref%22%5D%2C%20a%2Ereversefootnote%20%2F%2A%20Pandoc%2C%20MultiMarkdown%2C%20%3F%3F%20footnote%20back%20links%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20%7D%0A%20%0A%40media%20print%0A%20%20%20%20%7B%0A%20%20%20%20a%5Bhref%5E%3D%22%23fnref%22%5D%2C%20a%2Ereversefootnote%20%2F%2A%20Pandoc%2C%20MultiMarkdown%20%2A%2F%0A%20%20%20%20%20%20%20%20%7B%0A%20%20%20%20%20%20%20%20%2F%2A%20Don%27t%20display%20these%20at%20all%20in%20print%20since%20the%20arrow%20is%20only%20something%20to%20click%20on%20%2A%2F%0A%20%20%20%20%20%20%20%20display%3A%20none%3B%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%7D%0A%20%20%20%20%0Adiv%2Efootnotes%20%2F%2A%20Pandoc%20footnotes%20div%20at%20end%20of%20the%20document%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20%7D%0A%20%20%20%20%0Adiv%2Efootnotes%20li%5Bid%5E%3D%22fn%22%5D%20%2F%2A%20A%20footnote%20item%20within%20that%20div%20%2A%2F%0A%20%20%20%20%7B%0A%20%20%20%20%7D%0A%20%0A%2F%2A%20You%20can%20class%20stuff%20as%20%22noprint%22%20to%20not%20print%2E%20%0A%20%20%20Useful%20since%20you%20can%27t%20set%20this%20media%20conditional%20inside%20an%20HTML%20element%27s%20%0A%20%20%20style%20attribute%20%28I%20think%29%2C%20and%20you%20don%27t%20want%20to%20make%20another%20stylesheet%20that%20%0A%20%20%20imports%20this%20one%20and%20adds%20a%20class%20just%20to%20do%20this%2E%0A%2A%2F%0A%20%0A%40media%20print%0A%20%20%20%20%7B%0A%20%20%20%20%2Enoprint%0A%20%20%20%20%20%20%20%20%7B%0A%20%20%20%20%20%20%20%20display%3Anone%3B%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%7D%0A" rel="stylesheet" type="text/css" /> |
---|
29 | </head> |
---|
30 | <body> |
---|
31 | <div id="TOC"> |
---|
32 | <ul> |
---|
33 | <li><a href="#install-database"><span class="toc-section-number">1</span> Install database</a></li> |
---|
34 | <li><a href="#install-librenms"><span class="toc-section-number">2</span> Install LibreNMS</a><ul> |
---|
35 | <li><a href="#cloning"><span class="toc-section-number">2.1</span> Cloning</a></li> |
---|
36 | <li><a href="#web-interface"><span class="toc-section-number">2.2</span> Web Interface</a></li> |
---|
37 | </ul></li> |
---|
38 | <li><a href="#manual-vs.-web-installer"><span class="toc-section-number">3</span> Manual vs. web installer</a><ul> |
---|
39 | <li><a href="#web-installer"><span class="toc-section-number">3.1</span> Web installer</a><ul> |
---|
40 | <li><a href="#add-localhost"><span class="toc-section-number">3.1.1</span> Add localhost</a></li> |
---|
41 | </ul></li> |
---|
42 | <li><a href="#manual-installation"><span class="toc-section-number">3.2</span> Manual installation</a><ul> |
---|
43 | <li><a href="#initialise-the-database"><span class="toc-section-number">3.2.1</span> Initialise the database</a></li> |
---|
44 | <li><a href="#create-admin-user"><span class="toc-section-number">3.2.2</span> Create admin user</a></li> |
---|
45 | <li><a href="#add-localhost-1"><span class="toc-section-number">3.2.3</span> Add localhost</a></li> |
---|
46 | </ul></li> |
---|
47 | </ul></li> |
---|
48 | <li><a href="#final-configuration"><span class="toc-section-number">4</span> Final configuration</a><ul> |
---|
49 | <li><a href="#test-poller"><span class="toc-section-number">4.1</span> Test poller</a></li> |
---|
50 | <li><a href="#create-cronjob"><span class="toc-section-number">4.2</span> Create cronjob</a></li> |
---|
51 | <li><a href="#daily-updates"><span class="toc-section-number">4.3</span> Daily Updates</a></li> |
---|
52 | </ul></li> |
---|
53 | <li><a href="#install-complete"><span class="toc-section-number">5</span> Install complete</a></li> |
---|
54 | </ul> |
---|
55 | </div> |
---|
56 | <blockquote> |
---|
57 | <p>NOTE: These instructions are based on the <a href="http://docs.librenms.org/Installation/Installation-(Debian-Ubuntu)/">official LibreNMS installation notes</a> and have been tested on a fresh install of Ubuntu 14.04.</p> |
---|
58 | </blockquote> |
---|
59 | <blockquote> |
---|
60 | <p>NOTE: These instructions assume you are the root user. If you are not, prepend <code>sudo</code> to the shell commands (the ones that aren't at <code>mysql></code> prompts) or temporarily become a user with root privileges with <code>sudo -s</code>.</p> |
---|
61 | </blockquote> |
---|
62 | <h1 id="install-database"><span class="header-section-number">1</span> Install database</h1> |
---|
63 | <p>We will assume that the database is running on the same machine as your network management server (this is the most common initial deployment scenario).</p> |
---|
64 | <pre><code>apt-get install mysql-server mysql-client |
---|
65 | mysql -uroot -p</code></pre> |
---|
66 | <p>Input the MySQL root password to enter the MySQL command-line interface where you will get a <code>mysql></code> prompt.</p> |
---|
67 | <p>Create the database:</p> |
---|
68 | <pre class="sourceCode sql"><code class="sourceCode sql"><span class="kw">CREATE</span> <span class="kw">DATABASE</span> librenms; |
---|
69 | <span class="kw">GRANT</span> <span class="kw">ALL</span> <span class="kw">PRIVILEGES</span> <span class="kw">ON</span> librenms.* |
---|
70 | <span class="kw">TO</span> <span class="st">'librenms'</span>@<span class="st">'localhost'</span> |
---|
71 | <span class="kw">IDENTIFIED</span> <span class="kw">BY</span> <span class="st">'abc123'</span> |
---|
72 | ; |
---|
73 | <span class="kw">FLUSH</span> <span class="kw">PRIVILEGES</span>; |
---|
74 | exit</code></pre> |
---|
75 | <p>Here we are using "abc123" as the password for librenms to access MySQL.</p> |
---|
76 | <h1 id="install-librenms"><span class="header-section-number">2</span> Install LibreNMS</h1> |
---|
77 | <p>The NMS is the host is where the web server and SNMP poller run.</p> |
---|
78 | <p>Install the required software:</p> |
---|
79 | <pre><code>apt-get install libapache2-mod-php5 php5-cli php5-mysql php5-gd php5-snmp php-pear php5-curl \ |
---|
80 | snmp graphviz php5-mcrypt php5-json apache2 fping imagemagick whois mtr-tiny \ |
---|
81 | nmap python-mysqldb snmpd mysql-client php-net-ipv4 php-net-ipv6 rrdtool git</code></pre> |
---|
82 | <p>The packages listed above are an all-inclusive list of packages that were necessary on a clean install of Ubuntu 14.04.</p> |
---|
83 | <p>You need to configure snmpd appropriately if you have not already done so. An absolute minimal config for snmpd is:</p> |
---|
84 | <pre><code>rocommunity NetManage 127.0.0.1</code></pre> |
---|
85 | <p>Adding the above line to <code>/etc/snmp/snmpd.conf</code> and running <code>service snmpd restart</code> will activate this config.</p> |
---|
86 | <p>In <code>/etc/php5/apache2/php.ini</code> and <code>/etc/php5/cli/php.ini</code>, ensure <code>date.timezone</code> is set to your preferred time zone. See <a href="http://php.net/manual/en/timezones.php">http://php.net/manual/en/timezones.php</a> or files under <code>/usr/share/zoneinfo</code> for a list of supported timezones. Valid examples are: "America/New York", "Australia/Brisbane", "Etc/UTC".</p> |
---|
87 | <h2 id="cloning"><span class="header-section-number">2.1</span> Cloning</h2> |
---|
88 | <p>LibreNMS is installed using git. If you're not familiar with git, check out the <a href="http://git-scm.com/book">git book</a> or the tips at <a href="http://gitready.com/">git ready</a>. The initial install from github.com is called a <code>git clone</code>; subsequent updates are done through <code>git pull</code>.</p> |
---|
89 | <p>The initial clone can take quite a while (nearly 3 minutes on a 10Mbps connection is typical), so for this workshop we have set up a local mirror for you to use. Run the following:</p> |
---|
90 | <pre><code>cd /opt |
---|
91 | git clone http://www.ws.nsrc.org/git/librenms.git</code></pre> |
---|
92 | <p>Normally the URL to clone would be <code>https://github.com/librenms/librenms.git</code></p> |
---|
93 | <h2 id="web-interface"><span class="header-section-number">2.2</span> Web Interface</h2> |
---|
94 | <p>To prepare the web interface (and adding devices shortly), you'll need to create and chown a directory as well as create an Apache vhost.</p> |
---|
95 | <p>First, create and chown the <code>rrd</code> directory and create the <code>logs</code> directory:</p> |
---|
96 | <pre><code>cd /opt/librenms |
---|
97 | mkdir rrd logs |
---|
98 | chown www-data:www-data logs/ rrd/</code></pre> |
---|
99 | <p>Next, create <code>/etc/apache2/sites-available/librenms.conf</code> containing the following:</p> |
---|
100 | <pre class="sourceCode apache"><code class="sourceCode apache"><span class="fu"><VirtualHost</span><span class="ot"> *:80</span><span class="fu">></span> |
---|
101 | DocumentRoot<span class="st"> /opt/librenms/html/</span> |
---|
102 | ServerName<span class="st"> librenmsN.ws.nsrc.org</span> |
---|
103 | CustomLog<span class="st"> /opt/librenms/logs/access_log combined</span> |
---|
104 | ErrorLog<span class="st"> /opt/librenms/logs/error_log</span> |
---|
105 | <span class="ot">AllowEncodedSlashes</span><span class="ch"> NoDecode</span> |
---|
106 | <span class="fu"><Directory</span><span class="ot"> "/opt/librenms/html/"</span><span class="fu">></span> |
---|
107 | Require<span class="st"> all granted</span> |
---|
108 | <span class="ot">AllowOverride</span><span class="ch"> </span><span class="kw">All</span> |
---|
109 | <span class="ot">Options</span><span class="ch"> </span><span class="kw">FollowSymLinks</span><span class="ch"> </span><span class="kw">MultiViews</span> |
---|
110 | <span class="fu"></Directory></span> |
---|
111 | <span class="fu"></VirtualHost></span></code></pre> |
---|
112 | <p>Change the N in <code>librenmsN.ws.nsrc.org</code> to your PC number.</p> |
---|
113 | <p>On Ubuntu 14.04, mcrypt is not enabled on install. Run the following to enable it:</p> |
---|
114 | <pre><code>php5enmod mcrypt</code></pre> |
---|
115 | <p>Now enable the vhost and restart Apache</p> |
---|
116 | <pre><code>a2ensite librenms |
---|
117 | a2dissite 000-default |
---|
118 | a2enmod rewrite |
---|
119 | service apache2 restart</code></pre> |
---|
120 | <h1 id="manual-vs.-web-installer"><span class="header-section-number">3</span> Manual vs. web installer</h1> |
---|
121 | <p>You can choose either a web configuration or manual configuration at the command line.</p> |
---|
122 | <h2 id="web-installer"><span class="header-section-number">3.1</span> Web installer</h2> |
---|
123 | <p>At this stage you can launch the web installer by going to <a href="http://librenmsN.ws.nsrc.org/install.php">http://librenmsN.ws.nsrc.org/install.php</a>, follow the onscreen instructions.</p> |
---|
124 | <ul> |
---|
125 | <li>Stage 1 prompts you for the database settings. Enter |
---|
126 | <ul> |
---|
127 | <li>DB Host: localhost</li> |
---|
128 | <li>DB User: librenms</li> |
---|
129 | <li>DB Pass: abc123</li> |
---|
130 | <li>DB Name: librenms</li> |
---|
131 | </ul></li> |
---|
132 | <li><p>Stage 3: enter a username, password and E-mail address. This will become the login you use to access the web interface. We suggest you use "sysadm", the class password, and your home E-mail address.</p></li> |
---|
133 | <li><p>Stage 5: copy the generated config onto the clipboard. At the command line, create the file <code>/opt/librenms/config.php</code> with a text editor, and paste in the config. (Remember if you are using "vi" to enter insert mode before you paste)</p></li> |
---|
134 | </ul> |
---|
135 | <h3 id="add-localhost"><span class="header-section-number">3.1.1</span> Add localhost</h3> |
---|
136 | <p>Using the web interface go to <code>Devices > Add Device</code>, add an entry for host "localhost", giving the correct community string.</p> |
---|
137 | <p>Continue at "Final configuration" below.</p> |
---|
138 | <h2 id="manual-installation"><span class="header-section-number">3.2</span> Manual installation</h2> |
---|
139 | <p>Alternatively if you want to continue the setup manually then follow these instructions.</p> |
---|
140 | <pre><code>cd /opt/librenms |
---|
141 | cp config.php.default config.php |
---|
142 | editor config.php</code></pre> |
---|
143 | <p>Change the values to the right of the equal sign for lines beginning with <code>$config[db_]</code> to match your database information as setup above.</p> |
---|
144 | <pre><code>$config['db_host'] = "localhost"; |
---|
145 | $config['db_user'] = "librenms"; |
---|
146 | $config['db_pass'] = "abc123"; |
---|
147 | $config['db_name'] = "librenms";</code></pre> |
---|
148 | <p>Change the value of <code>$config['snmp']['community']</code> from <code>public</code> to <code>NetManage</code>. (If you have multiple communities, set it to the most common)</p> |
---|
149 | <h3 id="initialise-the-database"><span class="header-section-number">3.2.1</span> Initialise the database</h3> |
---|
150 | <p>Initiate the follow database with the following command:</p> |
---|
151 | <pre><code>php build-base.php</code></pre> |
---|
152 | <h3 id="create-admin-user"><span class="header-section-number">3.2.2</span> Create admin user</h3> |
---|
153 | <p>Create the admin user - priv should be 10</p> |
---|
154 | <pre><code>php adduser.php <name> <pass> 10</code></pre> |
---|
155 | <p>Substitute your desired username and password -- and leave the angled brackets off. We suggest you use "sysadm" and the class password.</p> |
---|
156 | <h3 id="add-localhost-1"><span class="header-section-number">3.2.3</span> Add localhost</h3> |
---|
157 | <pre><code>php addhost.php localhost NetManage v2c</code></pre> |
---|
158 | <p>This assumes you haven't made community changes -- if you have, replace <code>NetManage</code> with your community. It also assumes SNMP v2c. If you're using v3, there are additional steps (NOTE: instructions for SNMPv3 to come).</p> |
---|
159 | <h1 id="final-configuration"><span class="header-section-number">4</span> Final configuration</h1> |
---|
160 | <h2 id="test-poller"><span class="header-section-number">4.1</span> Test poller</h2> |
---|
161 | <p>Discover localhost and poll it for the first time: do this at the command line so you can see if it is working properly.</p> |
---|
162 | <pre><code>cd /opt/librenms |
---|
163 | php discovery.php -h all && php poller.php -h all</code></pre> |
---|
164 | <h2 id="create-cronjob"><span class="header-section-number">4.2</span> Create cronjob</h2> |
---|
165 | <p>Create the cronjob which will run periodic tasks required by librenms</p> |
---|
166 | <pre><code>cp librenms.cron /etc/cron.d/librenms</code></pre> |
---|
167 | <h2 id="daily-updates"><span class="header-section-number">4.3</span> Daily Updates</h2> |
---|
168 | <p>LibreNMS performs daily updates by default. At 00:15 system time every day, a <code>git pull --no-edit --quiet</code> is performed. You can override this default by editing your <code>config.php</code> file. Remove the comment (the <code>#</code> mark) on the line:</p> |
---|
169 | <pre><code>#$config['update'] = 0;</code></pre> |
---|
170 | <p>so that it looks like this:</p> |
---|
171 | <pre><code>$config['update'] = 0;</code></pre> |
---|
172 | <h1 id="install-complete"><span class="header-section-number">5</span> Install complete</h1> |
---|
173 | <p>That's it! You now should be able to log in to <a href="http://librenmsN.ws.nsrc.org/">http://librenmsN.ws.nsrc.org/</a>. Please note that we have not covered HTTPS setup in this example, so your LibreNMS install is not secure by default. Please do not expose it to the public Internet unless you have configured HTTPS and taken appropriate web server hardening steps.</p> |
---|
174 | </body> |
---|
175 | </html> |
---|