| 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 | <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" /> |
|---|
| 10 | </head> |
|---|
| 11 | <body> |
|---|
| 12 | <div id="TOC"> |
|---|
| 13 | <ul> |
|---|
| 14 | <li><a href="#monitorización-de-netflow-con-nfsen---gestión-de-redes"><span class="toc-section-number">0.1</span> Monitorización de Netflow con NfSen - Gestión de Redes</a></li> |
|---|
| 15 | <li><a href="#introducción"><span class="toc-section-number">1</span> Introducción</a><ul> |
|---|
| 16 | <li><a href="#metas"><span class="toc-section-number">1.1</span> Metas</a></li> |
|---|
| 17 | <li><a href="#notas"><span class="toc-section-number">1.2</span> Notas</a></li> |
|---|
| 18 | </ul></li> |
|---|
| 19 | <li><a href="#configurar-el-recolector-collector"><span class="toc-section-number">2</span> Configurar el Recolector (Collector)</a><ul> |
|---|
| 20 | <li><a href="#instalar-nfdump-y-el-software-asociado"><span class="toc-section-number">2.1</span> Instalar NFDump y el software asociado</a><ul> |
|---|
| 21 | <li><a href="#probando-nfcapd-y-nfdump"><span class="toc-section-number">2.1.1</span> Probando nfcapd y nfdump</a></li> |
|---|
| 22 | </ul></li> |
|---|
| 23 | <li><a href="#instalación-y-configuración-de-nfsen"><span class="toc-section-number">2.2</span> Instalación y configuración de NfSen</a></li> |
|---|
| 24 | <li><a href="#cree-el-usuario-netflow-en-el-sistema"><span class="toc-section-number">2.3</span> Cree el usuario netflow en el sistema</a></li> |
|---|
| 25 | <li><a href="#instalar-nfsen-e-iniciarlo"><span class="toc-section-number">2.4</span> Instalar NFSen e iniciarlo</a></li> |
|---|
| 26 | <li><a href="#instalar-el-script-de-inicio"><span class="toc-section-number">2.5</span> Instalar el script de inicio</a></li> |
|---|
| 27 | <li><a href="#ver-los-flujos-a-través-de-la-web"><span class="toc-section-number">2.6</span> Ver los flujos a través de la web:</a></li> |
|---|
| 28 | </ul></li> |
|---|
| 29 | <li><a href="#notas-1"><span class="toc-section-number">3</span> NOTAS</a><ul> |
|---|
| 30 | <li><a href="#añadiendo-fuentes"><span class="toc-section-number">3.1</span> Añadiendo fuentes</a></li> |
|---|
| 31 | </ul></li> |
|---|
| 32 | </ul> |
|---|
| 33 | </div> |
|---|
| 34 | <h2 id="monitorización-de-netflow-con-nfsen---gestión-de-redes"><a href="#monitorización-de-netflow-con-nfsen---gestión-de-redes"><span class="header-section-number">0.1</span> Monitorización de Netflow con NfSen - Gestión de Redes</a></h2> |
|---|
| 35 | <h1 id="introducción"><a href="#introducción"><span class="header-section-number">1</span> Introducción</a></h1> |
|---|
| 36 | <h2 id="metas"><a href="#metas"><span class="header-section-number">1.1</span> Metas</a></h2> |
|---|
| 37 | <ul> |
|---|
| 38 | <li>Aprender a instalar las herramientas nfdump y NfSen</li> |
|---|
| 39 | </ul> |
|---|
| 40 | <h2 id="notas"><a href="#notas"><span class="header-section-number">1.2</span> Notas</a></h2> |
|---|
| 41 | <ul> |
|---|
| 42 | <li>Los comandos precedidos por "$" implican que debe ejecutar el comando como usuario genérico - no como root</li> |
|---|
| 43 | <li>Los comandos precedidos por "#" implican que debería estar trabajando como usuario root.</li> |
|---|
| 44 | <li>Los comandos con inicios de línea más específicos como "rtrX>" o "mysql>" indican que debe ejecutar los comandos en un equipo remoto, o dentro de otro programa.</li> |
|---|
| 45 | </ul> |
|---|
| 46 | <h1 id="configurar-el-recolector-collector"><a href="#configurar-el-recolector-collector"><span class="header-section-number">2</span> Configurar el Recolector (Collector)</a></h1> |
|---|
| 47 | <h2 id="instalar-nfdump-y-el-software-asociado"><a href="#instalar-nfdump-y-el-software-asociado"><span class="header-section-number">2.1</span> Instalar NFDump y el software asociado</a></h2> |
|---|
| 48 | <p>Nfdump es parte de las herramientas del colector de flujo Netflow, que incluye:</p> |
|---|
| 49 | <p>nfcapd, nfdump, nfreplay, nfexpire, nftest, nfgen</p> |
|---|
| 50 | <p>Hay un paquete en Ubuntu, pero es demasiado viejo - por lo que vamos a instalar desde el código fuente. En primer lugar, compruebe que dispone de las herramientas y dependencias necesarias:</p> |
|---|
| 51 | <pre><code>$ sudo apt-get update |
|---|
| 52 | $ sudo apt-get install build-essential autoconf |
|---|
| 53 | $ sudo apt-get install rrdtool mrtg librrds-perl librrdp-perl librrd-dev \ |
|---|
| 54 | libmailtools-perl php5 bison flex</code></pre> |
|---|
| 55 | <p>Ahora proceda a descargar y construir. Tenga en cuenta que sólo el último paso (make install) tiene que hacerse como root.</p> |
|---|
| 56 | <pre><code>$ cd |
|---|
| 57 | $ wget http://noc.ws.nsrc.org/downloads/nfdump-1.6.13.tar.gz |
|---|
| 58 | $ tar xvzf nfdump-1.6.13.tar.gz |
|---|
| 59 | $ cd nfdump-1.6.13 |
|---|
| 60 | $ ./configure --help # optional, shows the build settings available |
|---|
| 61 | $ ./configure --enable-nfprofile --enable-nftrack |
|---|
| 62 | $ make |
|---|
| 63 | $ sudo make install</code></pre> |
|---|
| 64 | <h3 id="probando-nfcapd-y-nfdump"><a href="#probando-nfcapd-y-nfdump"><span class="header-section-number">2.1.1</span> Probando nfcapd y nfdump</a></h3> |
|---|
| 65 | <pre><code>$ mkdir /tmp/nfcap-test |
|---|
| 66 | $ nfcapd -E -p 9001 -l /tmp/nfcap-test</code></pre> |
|---|
| 67 | <p>... después de un tiempo, una serie de flujos deben ser mostrados en pantalla.</p> |
|---|
| 68 | <p>Detenga la herramienta con CTRL + C y luego revise el contenido en /tmp/nfcap-test</p> |
|---|
| 69 | <pre><code>$ ls -l /tmp/nfcap-test</code></pre> |
|---|
| 70 | <p>Deberá ver uno o más archivos llamados <code>nfcapd.<AÑO><MES><DÍA><HR><MIN></code></p> |
|---|
| 71 | <p>Procesar el/los archivo(s) con nfdump:</p> |
|---|
| 72 | <pre><code>nfdump -r /tmp/nfcap-test/nfcapd.201Ywwxxyyzz | less |
|---|
| 73 | nfdump -r /tmp/nfcap-test/nfcapd.201Ywwxxyyzz -s srcip/bytes</code></pre> |
|---|
| 74 | <p>Debe obtener alguna información útil :)</p> |
|---|
| 75 | <h2 id="instalación-y-configuración-de-nfsen"><a href="#instalación-y-configuración-de-nfsen"><span class="header-section-number">2.2</span> Instalación y configuración de NfSen</a></h2> |
|---|
| 76 | <p>DDescargar y compilar. El parche es para arreglar un problema reportado en <a href="http://sourceforge.net/p/nfsen/bugs/31/">http://sourceforge.net/p/nfsen/bugs/31/</a></p> |
|---|
| 77 | <pre><code>$ cd |
|---|
| 78 | $ wget http://noc.ws.nsrc.org/downloads/nfsen-1.3.6p1.tar.gz |
|---|
| 79 | $ tar xvzf nfsen-1.3.6p1.tar.gz |
|---|
| 80 | $ cd nfsen-1.3.6p1 |
|---|
| 81 | $ wget http://noc.ws.nsrc.org/downloads/nfsen-socket6.patch |
|---|
| 82 | $ patch -p0 < nfsen-socket6.patch |
|---|
| 83 | $ cd etc |
|---|
| 84 | $ cp nfsen-dist.conf nfsen.conf |
|---|
| 85 | $ editor nfsen.conf</code></pre> |
|---|
| 86 | <p>Ajuste la variable $BASEDIR</p> |
|---|
| 87 | <pre><code>$BASEDIR = "/var/nfsen";</code></pre> |
|---|
| 88 | <p>Ajuste los usuarios adecuadamente para que Apache pueda acceder a los archivos:</p> |
|---|
| 89 | <pre><code>$WWWUSER = 'www-data'; |
|---|
| 90 | $WWWGROUP = 'www-data';</code></pre> |
|---|
| 91 | <p>Ajuste el tamaño del búfer a algo pequeño y observara datos rápidamente. No se recomienda hacer esto en un sistema de producción.</p> |
|---|
| 92 | <pre><code># Receive buffer size for nfcapd - see man page nfcapd(1) |
|---|
| 93 | $BUFFLEN = 2000;</code></pre> |
|---|
| 94 | <p>Encuentre la definición de fuentes (%sources), y cámbiela a:</p> |
|---|
| 95 | <pre><code>%sources=( |
|---|
| 96 | 'rtrX' => {'port'=>'9001','col'=>'#0000ff','type'=>'netflow'}, |
|---|
| 97 | ); </code></pre> |
|---|
| 98 | <p>(Sustituir el router de su grupo para rtrX, y descomente o elimine las fuentes existentes de muestra).</p> |
|---|
| 99 | <p>Finalmente cambia $HTMLDIR de <code>/var/www/nfsen/</code> a <code>/var/www/html/nfsen/</code></p> |
|---|
| 100 | <pre><code>$HTMLDIR = "/var/www/html/nfsen/";</code></pre> |
|---|
| 101 | <p>Ahora, guarde y salga del archivo.</p> |
|---|
| 102 | <h2 id="cree-el-usuario-netflow-en-el-sistema"><a href="#cree-el-usuario-netflow-en-el-sistema"><span class="header-section-number">2.3</span> Cree el usuario netflow en el sistema</a></h2> |
|---|
| 103 | <pre><code>$ sudo useradd -d /var/nfsen -G www-data -m -s /bin/false netflow</code></pre> |
|---|
| 104 | <h2 id="instalar-nfsen-e-iniciarlo"><a href="#instalar-nfsen-e-iniciarlo"><span class="header-section-number">2.4</span> Instalar NFSen e iniciarlo</a></h2> |
|---|
| 105 | <p>Cambie de nuevo al directorio donde está el código fuente:</p> |
|---|
| 106 | <pre><code>$ cd |
|---|
| 107 | $ cd nfsen-1.3.6p1</code></pre> |
|---|
| 108 | <p>Ahora, finalmente, instalamos:</p> |
|---|
| 109 | <pre><code>$ sudo perl install.pl etc/nfsen.conf</code></pre> |
|---|
| 110 | <p>Presione ENTER cuando se le pida la ruta de Perl.</p> |
|---|
| 111 | <h2 id="instalar-el-script-de-inicio"><a href="#instalar-el-script-de-inicio"><span class="header-section-number">2.5</span> Instalar el script de inicio</a></h2> |
|---|
| 112 | <p>Con el fin de que nfsen se inicie y se detenga automáticamente cuando se inicie el sistema, se tiene que agregar un enlace al diretorio init.d apuntando al script de inicio nfsen:</p> |
|---|
| 113 | <pre><code>$ sudo ln -s /var/nfsen/bin/nfsen /etc/init.d/nfsen |
|---|
| 114 | $ sudo update-rc.d nfsen defaults 20</code></pre> |
|---|
| 115 | <p>Para iniciar NfSen</p> |
|---|
| 116 | <pre><code>$ sudo service nfsen start</code></pre> |
|---|
| 117 | <p>Compruebe que los procesos nfcapd se han inciado:</p> |
|---|
| 118 | <pre><code>$ ps auxwww | grep nfcapd</code></pre> |
|---|
| 119 | <h2 id="ver-los-flujos-a-través-de-la-web"><a href="#ver-los-flujos-a-través-de-la-web"><span class="header-section-number">2.6</span> Ver los flujos a través de la web:</a></h2> |
|---|
| 120 | <p>Puede encontrar la página de nfsen aquí:</p> |
|---|
| 121 | <pre><code>http://pcX.ws.nsrc.org/nfsen/nfsen.php</code></pre> |
|---|
| 122 | <p>Si está trabajando en parejas, entonces ambos deben apuntar su navegador web al PC que está recibiendo flujos.</p> |
|---|
| 123 | <p>Es posible que aparezca un mensaje como:</p> |
|---|
| 124 | <pre><code>Frontend - Backend version mismatch!</code></pre> |
|---|
| 125 | <p>Esto desaparecerá si vuelve a cargar la página, no es un problema.</p> |
|---|
| 126 | <p>¡Ya está! Continúe en el tercer laboratorio, ejercicio3-nfsen-top-talkers</p> |
|---|
| 127 | <h1 id="notas-1"><a href="#notas-1"><span class="header-section-number">3</span> NOTAS</a></h1> |
|---|
| 128 | <h2 id="añadiendo-fuentes"><a href="#añadiendo-fuentes"><span class="header-section-number">3.1</span> Añadiendo fuentes</a></h2> |
|---|
| 129 | <p>Si tuvieras varios enrutadores en la red todos enviando los flujos al misma colector, puede o bien configurarlos para que envíen a diferentes puertos del colector, o le puede decir a NFSen la dirección IP de origen de cada router. esto permite a Nfsen mostrar datos diferentes de cada origen.</p> |
|---|
| 130 | <p>NO HACERLO AHORA!!! Ya que sólo tiene un único router, pero si lo necesitase, lo haría de la siguiente manera:</p> |
|---|
| 131 | <ul> |
|---|
| 132 | <li>Editar /var/nfsen/etc/nfsen.conf y agregar la(s) fuente(s), por ejemplo:</li> |
|---|
| 133 | </ul> |
|---|
| 134 | <pre><code>%sources = ( |
|---|
| 135 | 'rtrX' => { 'port' => '9001', 'col' => '#0000ff', 'type' => 'netflow' }, |
|---|
| 136 | 'rtrY' => { 'port' => '9002', 'col' => '#00ff00', 'type' => 'netflow' }, |
|---|
| 137 | 'gw' => { 'port' => '9996', 'col' => '#ff0000', 'type' => 'netflow' }, |
|---|
| 138 | );</code></pre> |
|---|
| 139 | <ul> |
|---|
| 140 | <li>Reconfigurar Nfsen.</li> |
|---|
| 141 | </ul> |
|---|
| 142 | <p>Usted tendrá que ejecutar esto cada vez que modifique '/var/nfsen/etc/nfsen.conf':</p> |
|---|
| 143 | <pre><code>$ sudo /etc/init.d/nfsen reconfig</code></pre> |
|---|
| 144 | <p>Debería ver:</p> |
|---|
| 145 | <pre><code>New sources to configure : gw rtrY |
|---|
| 146 | Continue? [y/n] y |
|---|
| 147 | |
|---|
| 148 | Add source 'gw' |
|---|
| 149 | Add source 'rtrY' |
|---|
| 150 | |
|---|
| 151 | Start/restart collector on port '9002' for (rtr2)[pid] |
|---|
| 152 | Start/restart collector on port '9996' for (gw)[pid] |
|---|
| 153 | |
|---|
| 154 | Restart nfsend:[pid]</code></pre> |
|---|
| 155 | </body> |
|---|
| 156 | </html> |
|---|
