\(\)

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!

Note
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
margin

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

1. Marked up prose

Italics

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

Eggs

one dozen

Potatoes

twelve pounds

Milk

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
  end
  return  a
end

6. Questions and Answers

Question 1.
Who is buried in Grant’s Tomb?
Answer
President Ulysses S. Grant
Question 2.
What is the area of a circle one centimeter in diameter?
Answer
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

wegener

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

[#poem]

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

<<poem>>

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):

[doc.header]
:numbered:
:toc2:

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

[.capsule] -- Noteshare.io documents are written in [blue]#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 [blue]#Asciidoctor# -- transforms what you, the author, writes into what your audience reads. You write the "source text", your fans read the "rendered text": [.indent] 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 http://epsilon.my.noteshare.io/section/what-is-noteshare#[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! (((verbatim text))) NOTE: 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 margin Sometimes -- say for avant-garde poetry for code -- you want verbatim text. But usually not. [blue]#Asciidoctor# -- transforms what you, (((text, italic))) .Italics 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._ (((hyperlinks))) .A hyperlink Read more at http://en.wikipedia.org/wiki/Thomas_Jefferson[Wikipedia] (((text, bold face))) .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) (((text, strikethrough))) (((text, highlighting))) .Strikethrough and highlighting He said that it [line-through]#ain't# #isn't# much of a job. (((poetry))) (((verse))) == Poetry [verse#poem] -- 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 -- == Lists (((lists, numbered))) .Numbered list . Go the bank . Oil change for car . Groceries (((lists, itemized))) .Itemized list * Identify the the problem * Identify possible solutions * Discuss their pros and cons * Make a decision (((tables))) == Tables |=== | Eggs | one dozen | Potatoes | twelve pounds | Milk | three quarts |=== +++
+++ See the http://www.noteshare.io/section/tables-#[Noteshare Handbook] for more details. (((code))) == Code [env.code#iter] -- def iter(f, a, n) n.times do a = f.call(a) puts a end return a end -- == Questions and Answers (((click blocks))) (((teaching tools))) [env.question] -- Who is buried in Grant's Tomb? -- [click.answer] -- President Ulysses S. Grant -- [env.question] -- What is the area of a circle one centimeter in diameter? -- [click.answer] -- 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._ (((images))) == Images image::442[align=center] For information on how to upload and use mages, see the http://www.noteshare.io/section/adding-an-image[Noteshare Manual]. (((music))) == Music .Chopin, Posthumous Nocturne in C# Minor audio::56[] (((video))) == Video video::EsTgr-n53Ow?[youtube,height=350,width=525, align=center] http://georgeoakleycomposition.com[George Oakley's] Sonata for Cello and Piano was played at http://georgeoakleycomposition.com/merkin_hall_concert.php[Merkin Hall] in New York City on February 8, 2014. == Mathematical formulas (((mathematics, inline formulas))) .An inline formula The square of $a+b$ is $a^2 = 2ab + b^2$. (((mathematics, displayed formulas))) .A displayed formula $$ \int_0^1 x^n dx = \frac{1}{n+1} $$ .Another one $$ e^{2\pi \sqrt{-1}} = 1 $$ == Higher Math (((mathematics, theorems))) [env.theorem] -- There are infinitely many prime numbers -- [env.theorem#th-pythagoras] -- 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! ⟪⟪th-pythagoras⟫⟫ is due to Pythagoras!! (((mathematics, equation environment))) [env.equation#harmonic-series] -- \sum_{n=1}^\infty \frac{1}{n} = \infty -- The result in (⟪⟪harmonic-series⟫⟫) was known to the medieval Scholastic philosopher Nicole Oresme (c. 1320–1325 – July 11, 1382). See http://en.wikipedia.org/wiki/Nicole_Oresme[Wikepedia]. (((mathematics, equationalign environment))) [env.equationalign#binomials] -- (a + b)^2 &= a^2 + 2ab + b^2 \\ (a + b)^3 &= a^3 + 3a^2b + 3ab^2 + b^3 -- The formulas in (⟪⟪binomials⟫⟫) are well-known. (((cross-references))) == Cross references Earlier in this document we gave an example of a ⟪⟪poem⟫⟫. The text [#poem] 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 ⟪⟪poem⟫⟫ See the http://www.noteshare.io/section/cross-references-2#[Noteshare Handbook] for more on cross-references. (((numbering))) == Numbering sections To number the sections of a document, edit the notebook settings using image:754[width=16px] so that the the `doc.header` element is present and looks like this (with a blank line afterwards): ---- [doc.header] :numbered: :toc2: ---- 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 image:757[width=16px] and click the *renumber* button.