Migrate Ruler documentation from Wiki

helplink.json

@@ -32,6 +32,7 @@
     "org.sugarlabs.PortfolioActivity": "portfolio.html",
     "org.laptop.sugar.ReadActivity": "read.html",
     "org.laptop.RecordActivity": "record.html",
+    "org.laptop.RulerActivity": "ruler.html",
     "org.worldwideworkshop.olpc.SliderPuzzle": "Slider.html",
     "vu.lux.olpc.Speak": "speak.html",
     "org.laptop.StarChart": "starchart.html",

source/index.rst

@@ -69,6 +69,7 @@ Activities
     portfolio.rst
     read.rst
     record.rst
+    ruler.rst
     Slider.rst
     speak.rst
     starchart.rst

source/ruler.rst

@@ -0,0 +1,60 @@
+Ruler
+=============================
+
+.. figure:: ../images/300px-Ruler.jpg
+   :alt: 300px-Ruler.jpg
+
+Where to get Ruler
+------------------
+
+`Activity <http://activities.sugarlabs.org/en-US/sugar/addon/4192/%5D>`__
+\| `Source <https://github.com/sugarlabs/ruler/>`__
+
+About Ruler
+-----------
+
+.. figure:: ../images/Ruler-icon.png
+   :alt: Ruler-icon.png
+
+Ruler is a simple collection of measurement tools that are displayed on
+the screen.
+
++--------------------+--------------------+--------------------+--------------------+
+| |120px-Ruler-fig1| | |120px-Ruler-fig2| | |120px-Ruler-fig3| | |120px-Ruler-fig4| |
++--------------------+--------------------+--------------------+--------------------+
+| CM and MM scales   | CM and MM grid     | Angles             | Checkerboard       |
++--------------------+--------------------+--------------------+--------------------+
+
+Since the OLPC XO computer has a 200 DPI display, the rulers are quite
+accurate. One other hardware, where the display resolution is not known,
+their is a spinner to let the user set the DPI. Ruler saves this value
+to the Journal, so it need not be set on subsequent uses of the
+Activity.
+
+Toolbar
+~~~~~~~
+
+.. figure:: ../images/Ruler-toolbar.png
+   :alt: Ruler-toolbar.png
+
+From left to right:
+
+-  Activity menu button
+-  CM and MM ruler
+-  CM and MM grid
+-  Angles (protractor)
+-  Checkerboard
+-  Dots per inch (DPI) spinner – used to set the display DPI – only
+   appears when DPI is not known, e.g., non-OLPC-XO hardware
+-  Stop button (not shown)
+
+Reporting Bugs 
+~~~~~~~~~~~~~~~~~~
+
+-  `Submit an issue here <https://github.com/sugarlabs/ruler/issues/new>`__
+-  `View all open issues <https://github.com/sugarlabs/ruler/issues/>`__
+
+.. |120px-Ruler-fig1| image:: ../images/120px-Ruler-fig1.png
+.. |120px-Ruler-fig2| image:: ../images/120px-Ruler-fig2.png
+.. |120px-Ruler-fig3| image:: ../images/120px-Ruler-fig3.png
+.. |120px-Ruler-fig4| image:: ../images/120px-Ruler-fig4.png