Commits

Yung-Yu Chen  committed eb2517a

Add a howto notebook.

  • Participants
  • Parent commits f1fcb1a

Comments (0)

Files changed (1)

+{
+ "metadata": {
+  "name": "",
+  "signature": "sha256:d0c740e744db220b7c190b19632e035aba02c4826747364c35d304ae838c63f7"
+ },
+ "nbformat": 3,
+ "nbformat_minor": 0,
+ "worksheets": [
+  {
+   "cells": [
+    {
+     "cell_type": "markdown",
+     "metadata": {},
+     "source": [
+      "# Exchanging notes with iPython notebook and BitBucket\n",
+      "\n",
+      "iPython notebook is a very convenient tool for [writing notes with mathematical contents](http://nbviewer.ipython.org/github/ipython/ipython/blob/2.x/examples/Notebook/Typesetting%20Math%20Using%20MathJax.ipynb).  By embedding LaTeX expressions into [the Markdown cells of iPython notebooks](http://ipython.org/ipython-doc/1/interactive/notebook.html#markdown-cells), we use a little bit more efforts than writing on the paper to show the equations on screen.  There is only one problem: how can we show it to people who are not watching my screen?  The answer is http://nbviewer.ipython.org/ and BitBucket.\n",
+      "\n",
+      "[BitBucket](http://bitbucket.org/) is an online service for hosting Mercurial repository.  [Mercurial](http://mercurial.selenic.com/) is a source code management (SCM) tool.  We can register a BitBucket account for free, and use Mercurial to publicize the iPython notebook online.  For example, I wrote a note in my computer, and synchronize it to https://bitbucket.org/yungyuc/notes_cfd/src/84f510ad2c068e07b4eaa3f4832e1e4da4ae699a/draft/conservation.ipynb.  Atlassian, the company behind BitBucket, also made a GUI application [SourceTree](http://www.sourcetreeapp.com/) to help the synchronization.\n",
+      "\n",
+      "After the synchronization, visit http://nbviewer.ipython.org/.  The nbviewer service can render any iPython notebook file available online!  All you need to do is to go to your repository at BitBucket, find the \"raw\" link to your file (e.g., you can do that by clicking the \"Raw\" button at the right side of the top banner of the file listing).  Paste the raw link you got to the text field, and http://nbviewer.ipython.org/ will take you to the rendered notebook, like: http://nbviewer.ipython.org/urls/bitbucket.org/yungyuc/notes_cfd/raw/84f510ad2c068e07b4eaa3f4832e1e4da4ae699a/draft/conservation.ipynb!"
+     ]
+    }
+   ],
+   "metadata": {}
+  }
+ ]
+}