Title page | James Carlson

Collapse Share Open book
  • 2 Listshttp://epsilon.my.noteshare.io/section/sample-document?part=Lists#_lists
  • 3 Tableshttp://epsilon.my.noteshare.io/section/sample-document?part=Tables#_tables
  • 4 Codehttp://epsilon.my.noteshare.io/section/sample-document?part=Code#_code
  • 5 Questions and Answershttp://epsilon.my.noteshare.io/section/sample-document?part=Questions%20and%20Answers#_questions_and_answers
  • 6 Imageshttp://epsilon.my.noteshare.io/section/sample-document?part=Images#_images
  • 7 Musichttp://epsilon.my.noteshare.io/section/sample-document?part=Music#_music
  • 8 Videohttp://epsilon.my.noteshare.io/section/sample-document?part=Video#_video
  • 9 Mathematical formulashttp://epsilon.my.noteshare.io/section/sample-document?part=Mathematical%20formulas#_mathematical_formulas
  • 10 Higher Mathhttp://epsilon.my.noteshare.io/section/sample-document?part=Higher%20Math#_higher_math
  • 11 Cross referenceshttp://epsilon.my.noteshare.io/section/sample-document?part=Cross%20references#_cross_references
  • 12 Numbering sectionshttp://epsilon.my.noteshare.io/section/sample-document?part=Numbering%20sections#_numbering_sections

Sample Document


Noteshare.io documents are written in Asciidoc, a markup language. Markup means that you add little codes to the text to give it structure and shape its appearance. A program — in this case Asciidoctor — transforms what you, the author, writes into what your audience reads. You write the "source text", your fans read the "rendered text":

Source text ⇒ Rendered text

A fast way to learn the mark up you need is to compare the parts of the source and rendered versions of this document that are relevant to your writing. To do this, you need to be logged in so that you have access to the View menu. Just choose Source from that menu.

This sample document contains a variety of texts  —  marked up prose, verse, lists, tables, hypertext links, mathematical notation, and also images, audio, and video. See the Quick Start Guide. for more information as well as instructions on creating new documents, new sections, etc.

Type plain old prose much as you would an email. Type without regard to line endings. Put in two blank lines to start a new paragraph. That’s it!

Be sure to start your paragraph at the extreme left margin. Otherwise it will be interpreted as verbatim text, as below:
This is what
    happens when
        you don't start at the left

Sometimes — say for avant-garde poetry for code — you want verbatim text. But usually not.

1. Marked up prose


We hold these truths to be self-evident: that all men are created equal; that they are endowed by their Creator with certain unalienable rights; that among these are life, liberty, and the pursuit of happiness.

A hyperlink

Read more at Wikipedia

.Bold face text Something worth pondering: If we could first know where we are, and whither we are tending, we could then better judge what to do, and how to do it. (Abraham Lincoln)

Strikethrough and highlighting

He said that it ain’t isn’t much of a job.

2. Poetry

Twas brillig, and the slithy toves
      Did gyre and gimble in the wabe:
All mimsy were the borogoves,
      And the mome raths outgrabe.

“Beware the Jabberwock, my son!
      The jaws that bite, the claws that catch!
Beware the Jubjub bird, and shun
      The frumious Bandersnatch!”
 — Lewis Carroll

3. Lists

Numbered list
  1. Go the bank

  2. Oil change for car

  3. Groceries

Itemized list
  • Identify the the problem

  • Identify possible solutions

  • Discuss their pros and cons

  • Make a decision

4. Tables


one dozen


twelve pounds


three quarts

See the Noteshare Handbook for more details.

5. Code

Listing 1.
def iter(f, a, n)
  n.times do
    a = f.call(a)
    puts a
  return  a

6. Questions and Answers

Question 1.
Who is buried in Grant’s Tomb?
President Ulysses S. Grant
Question 2.
What is the area of a circle one centimeter in diameter?
About 0.7854 square centimetesrs: \(A = \pi r^2\), so \(A\) is about \(3.1416 \times 0.5^2\).

Click on the blue headings above to reveal that which is hidden …​ click again to hide.

7. Images


For information on how to upload and use mages, see the Noteshare Manual.

8. Music

Chopin, Posthumous Nocturne in C# Minor

9. Video

George Oakley’s Sonata for Cello and Piano was played at Merkin Hall in New York City on February 8, 2014.

10. Mathematical formulas

An inline formula

The square of \(a+b\) is \(a^2 = 2ab + b^2\).

A displayed formula

\[ \int_0^1 x^n dx = \frac{1}{n+1} \]

Another one

\[ e^{2\pi \sqrt{-1}} = 1 \]

11. Higher Math

Theorem 1.
There are infinitely many prime numbers
Theorem 2.
If \(a\), \(b\), and \(c\) are the sides of a right triangle, where \(c\) is the hypotenuse, then \(a^2 + b^2 = c^2\).

Hey! Theorem 2 is due to Pythagoras!!

\[ \sum_{n=1}^\infty \frac{1}{n} = \infty \] (1)

The result in (1) was known to the medieval Scholastic philosopher Nicole Oresme (c. 1320–1325 – July 11, 1382). See Wikepedia.

\[\begin{split} (a + b)^2 &= a^2 + 2ab + b^2 \\ (a + b)^3 &= a^3 + 3a^2b + 3ab^2 + b^3 \end{split}\] (2)

The formulas in (2) are well-known.

== Cross references

Earlier in this document we gave an example of a [poem]. The text


was used to make the reference. The hash mark followed by some text creates an id for the poem. In making the cross-reference, we refer to the id like this


See the Noteshare Handbook for more on cross-references.

12. Numbering sections

To number the sections of a document, edit the notebook settings using gears so that the the doc.header element is present and looks like this (with a blank line afterwards):


To be more precise, the body of the doc.header must contain the line :numbered: If you need to update the section numbers, click the contents tool toc and click the renumber button.

Created August 20, 2015, last updated: October 1, 2015