_pub.n
Title page | James Carlson

Collapse Share Open book
  • 1.1 Editinghttp://epsilon.my.noteshare.io/section/noteshare-for-mathematicians-intro?part=Editing#_editing
  • 1.2 Interactivity: click blocks and apps.http://epsilon.my.noteshare.io/section/noteshare-for-mathematicians-intro?part=Interactivity:%20click%20blocks%20and%20apps.#_interactivity_click_blocks_and_apps
  • 1.3 Feature summaryhttp://epsilon.my.noteshare.io/section/noteshare-for-mathematicians-intro?part=Feature%20summary#_feature_summary
  • 1.4 Lecture Noteshttp://epsilon.my.noteshare.io/section/noteshare-for-mathematicians-intro?part=Lecture%20Notes#_lecture_notes
  • 1.5 Problem Setshttp://epsilon.my.noteshare.io/section/noteshare-for-mathematicians-intro?part=Problem%20Sets#_problem_sets
  • 2.1 Pythagorean tripleshttp://epsilon.my.noteshare.io/section/mathematics-article-jc?part=Pythagorean%20triples#_pythagorean_triples
  • 2.2 Another result from ancient timeshttp://epsilon.my.noteshare.io/section/mathematics-article-jc?part=Another%20result%20from%20ancient%20times#_another_result_from_ancient_times
  • 2.3 Algorithmshttp://epsilon.my.noteshare.io/section/mathematics-article-jc?part=Algorithms#_algorithms
  • 3.1 Inline and displayed mathematicshttp://epsilon.my.noteshare.io/section/latex-in-noteshare?part=Inline%20and%20displayed%20mathematics#_inline_and_displayed_mathematics
  • 3.2 Environmentshttp://epsilon.my.noteshare.io/section/latex-in-noteshare?part=Environments#_environments
  • 3.3 Labelshttp://epsilon.my.noteshare.io/section/latex-in-noteshare?part=Labels#_labels
  • 3.4 The equation environmenthttp://epsilon.my.noteshare.io/section/latex-in-noteshare?part=The%20equation%20environment#_the_equation_environment
  • 3.5 Cross referenceshttp://epsilon.my.noteshare.io/section/latex-in-noteshare?part=Cross%20references#_cross_references
  • 3.6 Macroshttp://epsilon.my.noteshare.io/section/latex-in-noteshare?part=Macros#_macros

Noteshare for Mathematicians

1. Why Noteshare for Mathematicians?

Thanks to Donald Knuth and Leslie Lamport, mathematicians have truly wonderful tools —  TeX and LaTeX — for writing mathematical documents. Because they provide both a tool and language, we can write anything we want. And the rendered text is — well, beautiful.

A tool for authors

The aim of VS is to bring these same tools to the web — with some additions, such as search facilities, an image database, the click environment, interactive graphics, and export to other formats such as LaTeX and ePub. The goal is frictionless composition: you type, and each time you press "Update" or ctrl-U, Voila! the latest version of your class notes is on the web. (Of course, you can control the visibility of your work if you wish: keep it completely private, share it with a group which you designate, or share it with the world when you press "Publish").

Note
If you want to see what typeset mathematics in Noteshare looks like now, go to the Sample Article. To see the author’s source text, choose Source from the View menu. The source is written in Asciidoc-LaTeX, a hybrid of two markup languages.
Collaboration

Noteshare also gives you tools for collaboration. Form groups to share work, and set permissions to read, edit, and create documents belonging to the group. To make sure that sections of a document are edited by only one person at a time, individual sections can be "checked out."

1.1. Editing

Screen Shot 2015 08 20 at 5.15.54 AM

The two-pane editor displays the source text on the left, the rendered text on the right. By default, the two windows are yoked together: scroll the left window, and the text in the right window follows. Press ctrl-I to let the two windows scroll independently. Press ctrl-Y to re-yoke them. If you forget these commands, press the Help button, or selec Help from the Home menu.

1.2. Interactivity: click blocks and apps.

A word about two interactive features. First is the "click environment," a feature especially useful for problem sets and instructional handouts. Below are two examples — problems where the answer or hint — the text in blue — is "clickable." Click on the blue header to reveal the "body" of the click block. Click again to hide it. The syntax is very close to what one might do in LaTeX. See the sidebar for the source code.¨

Problem 1.
What is the value of the integral below? \[ \int_0^1 x^n dx \]
Answer
\[ \frac{1}{n+1} \]
Problem 2.
What is the sum of the series below? \[ S = \sum_{n=0}^\infty \frac{1}{3^n} \]
Hint
Consider the relation of \(S\) to the quantity \(3S\).

Second is the capability of incorporating apps written in Javascript in Noteshare. See the sidebar for an example. For more examples and details on who this is done, see the JSXGraph Scrapbook and also the Noteshare Handbook.

1.3. Feature summary

  • Frictionless publishing. Type and save. It is already on the web.

  • Available everywhere, secure. Any place you have an internet connection, you have access to your Noteshare documents. They are backed up, and secure.

  • Smart phones and tablets. Later this spring, Noteshare will be compatible with smart phones and tablets. Functionality decreases with the size of the device, but in all cases Noteshare content can be read regardless of the size of the device.

  • Search. For documents, authors, images. Full text search also available.

  • Searchable image database. Images you place there can be private, or part of the Noteshare intellectual commons.

  • Collaboration. Form groups, check sections of a document in and out for collaborative composition and editing.

  • Export to LaTeX, PDF, and ePub.[1]

  • Ownership. You own what you create. Source text and media resources such as images are stored on Noteshare servers. See this blog post for instructions how to download your Noteshare work to your computer.

  • Snippet sharing. If you wish, you can make selected sections of includable. This means that others can incorporate them verbatim in their own documents. Included snippets cannot be changed except by the author; credit is given, and cannot be removed wihout removing the snippet. This can be a great labor-saving device. Why re-invent the wheel when there is so much new work to be done?

In this section we discuss two scenarios

In the sections that follow we discuss how to compose documents (notebooks) in VS.

1.4. Lecture Notes

Screen Shot 2015 08 20 at 5.15.54 AM
Figure 1. Editor control panel

You are giving a lecture and want to write up your notes for the web. You start a new document ("notebook") on Noteshare and type away using familiar LaTeX notation and Noteshare’s verson of LaTeX environments. Pressing update as you go, or typing control-U, you check the changes in the split editor — source on the left, rendered LaTeX on the right. When you are finished, you press exit. In the editor control palette you press Publish — and Presto!! The notes for your talk are on the web.

To let your colleagues and students know about your write-up, you press Share in the control panel. This brings up a blank email with a public link to your write-up. You fill in the address field, press "send", and are done with your work.

Later that day. You realize that a few points in your talk need a more detailed explanation. You choose the Recent item from the Home menu to locate the last section of the last Noteshare document you were working on. You click on the link to bring up your notes, then select Write from the menu bar. You make your changes, press upate and Voila! The updated version of your notes is published.

That evening. You decide to put in some links to related work in your write-up. You open up your document and add this text:

 http://en.wikipedia.org/wiki/Twin_prime[Twin primes]

In the rendered text, you see this: Twin primes. You exit, pressing control-X this time, and select Print from the View menu. Up comes a printable version of your notes. That’s it for the day!

Several days later. You have expanded your notes from one section to three. This time you select Compiled from the View menu. Noteshare assembles all sections of you notebook into a single document which you print. You notice the URL of the compiled document in your browser. It is something like this:

https://vschool.s3.amazonaws.com/manuscripts/351.html

You email that link to some colleagures and students. Done for the day!

Several months latter. You have refined your notes further and decide to submit them for publication. Instead of "Compiled", you select LaTeX. Noteshare assembles all the sections of your notebook into a single LaTeX document and provides you with a link to dowload it to your computer. Note: this last feature is in development and will be ready for beta testers by June 1.

1.5. Problem Sets

Here is an example problem set, first in rendered form, then in source form.

  1. Compute the integral \[ \int_0^1 x^n dx \]

    Answer
    \[ \frac{1}{n+1} \]
  2. Determine the number and nature of the oots of the equation \(x^2 + 5x + 1 = 0\) without actually finding the roots. Explain how you did this.

    Answer
    The discriminant of this equation is \(b^2 - 4ac = 21\). Because it is nonzero, there are two distinc roots. Because it is positive, the roots are real. Because it is not a perfect square, the roots are irrational.

Here is the source:

. Compute the integral \[ \int_0^1 x^n dx \]
+
[click.answer]
--
 \[ \frac{1}{n+1} \]
--

. Determine the number and nature
of the roots of the equation
$x^2 + 5x + 1 = 0$ without
actually finding the roots.
Explain how you did this.
+
[click.answer]
--
The discriminant of this equation is
$b^2 - 4ac = 21$.  Because
it is nonzero, there are two
distinct roots.  Because it is
positive, the roots are real.
Because it is not a perfect square,
the roots are irrational.
--

The little + signs that you see are to make sure that the question and the answer are treated as forming an entire item in a numbered list. Such + signs are called continuations.


Created February 28, 2015, last updated: August 28, 2015


1 These are experimental and in varying stages of development. The experimental LaTeX converter is available now. The others will be available later this year

The Click Environment

Here is the source code for the "click block" example on the left, below.¨ These examples also demonstate the Asciidoctor-latex syntax that Noteshare uses. Inline math and display math are pure LaTeX. There are also analogues of LaTeX environments — [env.theorem], [env.definition], [env.problem], etc. Click blocks, e.g. [click.answer] and [click.hint] are a special interactive environment that has no counterpart in LaTeX.

[env.problem]
--
What is the value of the integral below?
\[
   \int_0^1 x^n dx
\]
--

[click.Answer]
--
\[
  \frac{1}{n+1}
\]
--

[env.problem]
--
What is the sum of the series below?
\[
   S =  \sum_{n=0}^\infty \frac{1}{3^n}
\]

[click.hint]
--
Consider the relation of $S$ to the quantity $3S$.
--

Apps

This app courtesy of http://jsxgraph.uni-bayreuth.de

JSXGraph 1.