Commits

Matt Bone committed 88f5a41 Merge

latest

Comments (0)

Files changed (1)

alternatives_for_authoring.ipynb

+{
+ "metadata": {
+  "name": ""
+ },
+ "nbformat": 3,
+ "nbformat_minor": 0,
+ "worksheets": [
+  {
+   "cells": [
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "# Alternatives for Authoring\n",
+      "\n",
+      "We're already familiar with the idea of using XML as a means of communicating data or even using it to implement simple programming or configuration languages, but we also know it's often used for authoring documents. Today we'll look at many technologies, past and present, that have been used to author documents.\n"
+     ]
+    },
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "## LaTeX\n",
+      "\n",
+      "Sample LaTex document (from [wikipedia](http://en.wikipedia.org/wiki/LaTeX)):\n",
+      "\n",
+      "```\n",
+      "\\documentclass[12pt]{article}\n",
+      "\\usepackage{amsmath}\n",
+      "\\title{\\LaTeX}\n",
+      "\\date{}\n",
+      "\\begin{document}\n",
+      "  \\maketitle\n",
+      "  \\LaTeX{} is a document preparation system for the \\TeX{}\n",
+      "  typesetting program. It offers programmable desktop\n",
+      "  publishing features and extensive facilities for\n",
+      "  automating most aspects of typesetting and desktop\n",
+      "  publishing, including numbering and cross-referencing,\n",
+      "  tables and figures, page layout, bibliographies, and\n",
+      "  much more. \\LaTeX{} was originally written in 1984 by\n",
+      "  Leslie Lamport and has become the dominant method for\n",
+      "  using \\TeX; few people write in plain \\TeX{} anymore.\n",
+      "  The current version is \\LaTeXe.\n",
+      " \n",
+      "  % This is a comment, not shown in final output.\n",
+      "  % The following shows typesetting power of LaTeX:\n",
+      "  \\begin{align}\n",
+      "    E_0 &= mc^2                              \\\\\n",
+      "    E &= \\frac{mc^2}{\\sqrt{1-\\frac{v^2}{c^2}}}\n",
+      "  \\end{align}\n",
+      "\\end{document}\n",
+      "```\n",
+      "\n",
+      "Which is rendered as:\n",
+      "\n",
+      "![rendered LaTeX](http://upload.wikimedia.org/wikipedia/en/thumb/b/bc/Latex-example.png/520px-Latex-example.png)\n",
+      "\n",
+      "LaTeX is even important enough that it is included with ipython notebook:\n",
+      "\n",
+      "$$1 + 1 = 2$$\n",
+      "\n",
+      "$$E = \\frac{mc^2}{\\sqrt{1-\\frac{v^2}{c^2}}}$$\n",
+      "\n",
+      "And the inline support works, too: $2 + 2 = 4$.\n",
+      "\n",
+      "TeX's final version number is pi:\n",
+      "```\n",
+      "mbone@harold:~/Developer/markup-examples$ tex\n",
+      "This is TeX, Version 3.1415926 (TeX Live 2012/Debian)\n",
+      "**\n",
+      "```\n",
+      "\n",
+      "http://en.wikipedia.org/wiki/TeXML\n",
+      "\n",
+      "http://en.wikipedia.org/wiki/XSL_Formatting_Objects\n",
+      "\n",
+      "http://www.mos6581.org/introducing-rinohtype\n",
+      "\n",
+      "http://www.lyx.org/\n",
+      "\n",
+      "http://en.wikipedia.org/wiki/BibTeX\n",
+      "\n",
+      "http://en.wikipedia.org/wiki/Lout_%28software%29\n",
+      "\n",
+      "http://en.wikipedia.org/wiki/ConTeXt#Comparison_between_ConTeXt_and_LaTeX"
+     ]
+    },
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "## Wiki Syntax and Markdown\n",
+      "\n",
+      "The [first wiki](http://en.wikipedia.org/wiki/WikiWikiWeb) came around in 1995 and included [its own text formatting rules](http://c2.com/cgi/wiki?TextFormattingExamples) to enable quick communication between programmers. Not only did this inspire tons of [wikis](http://www.wikipedia.org/) and [wiki](http://moinmo.in/) [software](https://www.dokuwiki.org/dokuwiki), it also inspired a lot of wiki markup like [markdown](http://daringfireball.net/projects/markdown/basics) and [ReStructuredText](http://docutils.sourceforge.net/docs/user/rst/quickstart.html). Probably the most widely used syntax these days is [github flavored markdown](https://help.github.com/articles/github-flavored-markdown).\n",
+      "\n",
+      "* sphinx\n",
+      "* read the docs\n"
+     ]
+    },
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "## docbook\n",
+      "\n",
+      "http://www.docbook.org/tdg5/en/html/docbook.html"
+     ]
+    },
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "## pandoc\n",
+      "\n",
+      "http://johnmacfarlane.net/pandoc/"
+     ]
+    },
+    {
+     "cell_type": "code",
+     "collapsed": false,
+     "input": [],
+     "language": "python",
+     "metadata": {},
+     "outputs": []
+    }
+   ],
+   "metadata": {}
+  }
+ ]
+}