_pub.n
Title page | James Carlson

Collapse Share Open book
  • 2.1 Create a notebookhttp://www.noteshare.io/section/asciidoc-101?part=Create%20a%20notebook#_create_a_notebook
  • 2.2 Create a new sectionhttp://www.noteshare.io/section/asciidoc-101?part=Create%20a%20new%20section#_create_a_new_section
  • 2.3 Imageshttp://www.noteshare.io/section/asciidoc-101?part=Images#_images
  • 2.4 Manage notebookhttp://www.noteshare.io/section/asciidoc-101?part=Manage%20notebook#_manage_notebook
  • 2.5 Collaborationhttp://www.noteshare.io/section/asciidoc-101?part=Collaboration#_collaboration
  • 2.6 Exporthttp://www.noteshare.io/section/asciidoc-101?part=Export#_export
  • 3.1 First things firsthttp://www.noteshare.io/section/markup-basics?part=First%20things%20first#_first_things_first
  • 3.2 Sectionshttp://www.noteshare.io/section/markup-basics?part=Sections#_sections
  • 3.3 Blockshttp://www.noteshare.io/section/markup-basics?part=Blocks#_blocks
  • 3.4 Basic tableshttp://www.noteshare.io/section/markup-basics?part=Basic%20tables#_basic_tables
  • 4.5 Math Homeworkhttp://www.noteshare.io/section/math-homework?part=Math%20Homework#_math_homework
  • 4.6 Chemistryhttp://www.noteshare.io/section/math-homework?part=Chemistry#_chemistry
  • 5.1 Browse menubarhttp://www.noteshare.io/section/the-menus--to-revise-and-update-?part=Browse%20menubar#_browse_menubar
  • 5.2 Read menubarhttp://www.noteshare.io/section/the-menus--to-revise-and-update-?part=Read%20menubar#_read_menubar
  • 5.3 Write menubarhttp://www.noteshare.io/section/the-menus--to-revise-and-update-?part=Write%20menubar#_write_menubar
  • 5.4 Media menubarhttp://www.noteshare.io/section/the-menus--to-revise-and-update-?part=Media%20menubar#_media_menubar
  • 6.1 Creating a Notehttp://www.noteshare.io/section/creating-notes-and-notebooks?part=Creating%20a%20Note#_creating_a_note
  • 6.2 Editing a Notehttp://www.noteshare.io/section/creating-notes-and-notebooks?part=Editing%20a%20Note#_editing_a_note
  • 6.3 Markup 102http://www.noteshare.io/section/creating-notes-and-notebooks?part=Markup%20102#_markup
  • 6.4 Creating a notebookhttp://www.noteshare.io/section/creating-notes-and-notebooks?part=Creating%20a%20notebook#_creating_a_notebook
  • 7.1 A simple tablehttp://www.noteshare.io/section/tables-?part=A%20simple%20table#_a_simple_table
  • 7.2 A formatted tablehttp://www.noteshare.io/section/tables-?part=A%20formatted%20table#_a_formatted_table
  • 7.3 A table with a headerhttp://www.noteshare.io/section/tables-?part=A%20table%20with%20a%20header#_a_table_with_a_header
  • 7.4 A table with a header and footerhttp://www.noteshare.io/section/tables-?part=A%20table%20with%20a%20header%20and%20footer#_a_table_with_a_header_and_footer
  • 8.1 References within a notehttp://www.noteshare.io/section/cross-references-2?part=References%20within%20a%20note#_references_within_a_note
  • 8.2 References within Notesharehttp://www.noteshare.io/section/cross-references-2?part=References%20within%20Noteshare#_references_within_noteshare
  • 8.3 References to a web pagehttp://www.noteshare.io/section/cross-references-2?part=References%20to%20a%20web%20page#_references_to_a_web_page
  • 8.4 References to something inside a web pagehttp://www.noteshare.io/section/cross-references-2?part=References%20to%20something%20inside%20a%20web%20page#_references_to_something_inside_a_web_page
  • 9.1 Syntaxhttp://www.noteshare.io/section/mathematical-notation?part=Syntax#_syntax
  • 10.1 Exampleshttp://www.noteshare.io/section/chemistry?part=Examples#_examples
  • 10.2 Structural formulashttp://www.noteshare.io/section/chemistry?part=Structural%20formulas#_structural_formulas
  • 10.3 Referenceshttp://www.noteshare.io/section/chemistry?part=References#_references
  • 14.1 Check-in and check-outhttp://www.noteshare.io/section/collaboration?part=Check-in%20and%20check-out#_check_in_and_check_out
  • 14.4 Authorship of commentshttp://www.noteshare.io/section/comments?part=Authorship%20of%20comments#_authorship_of_comments
  • 15.1 Attributeshttp://www.noteshare.io/section/extras?part=Attributes#_attributes
  • 16.1 Notes on the embed featurehttp://www.noteshare.io/section/test-of-embed-feature?part=Notes%20on%20the%20embed%20feature#_notes_on_the_embed_feature
  • 17.1 Standard accounthttp://www.noteshare.io/section/noteshare-advanced-features?part=Standard%20account#_standard_account
  • 17.2 Premium accounthttp://www.noteshare.io/section/noteshare-advanced-features?part=Premium%20account#_premium_account
  • 17.3 In the pipelinehttp://www.noteshare.io/section/noteshare-advanced-features?part=In%20the%20pipeline#_in_the_pipeline
  • 20.1 Problem sets, etc.http://www.noteshare.io/section/technical-appendix?part=Problem%20sets,%20etc.#_problem_sets_etc
  • 20.2 Quiz #1http://www.noteshare.io/section/technical-appendix?part=Quiz%20#1#_quiz
  • 20.3 Quiz #2http://www.noteshare.io/section/technical-appendix?part=Quiz%20#2#_quiz
  • 20.4 Technical notehttp://www.noteshare.io/section/technical-appendix?part=Technical%20note#_technical_note
  • 21.1 The Quadratic Equationhttp://www.noteshare.io/section/linking-the-main-page-and-the-aside?part=The%20Quadratic%20Equation#_the_quadratic_equation
  • 21.2 The Cubic equationhttp://www.noteshare.io/section/linking-the-main-page-and-the-aside?part=The%20Cubic%20equation#_the_cubic_equation
  • 22.1 Why Markup?http://www.noteshare.io/section/asciidoc-markup?part=Why%20Markup?#_why_markup
  • 22.2 PDFhttp://www.noteshare.io/section/asciidoc-markup?part=PDF#_pdf
  • 22.3 Links between lessonshttp://www.noteshare.io/section/asciidoc-markup?part=Links%20between%20lessons#_links_between_lessons
  • 22.4 More Asciidoc Exampleshttp://www.noteshare.io/section/asciidoc-markup?part=More%20Asciidoc%20Examples#_more_asciidoc_examples

Noteshare Handbook

\(\def\AA{\mathbb{A}} \def\BB{\mathbb{B}} \def\CC{\mathbb{C}} \def\DD{\mathbb{D}} \def\EE{\mathbb{E}} \def\FF{\mathbb{F}} \def\NN{\mathbb{N}} \def\OO\mathbb{{O}} \def\PP{\mathbb{P}} \def\QQ{\mathbb{Q}} \def\RR{\mathbb{R}} \def\ZZ{\mathbb{Z}} \def\ffp{\mathfrak{p}} \def\bold#1{\bf #1} \def\CCC{\mathcal{C}} \def\EEE{\mathcal{E}} \def\FFF{\mathcal{F}} \def\PPP{\mathcal{P}} \def\UUU{\mathcal{U}}    \newcommand{\commadots}{, \ldots, } \newcommand{\set}[1]{ \{\,#1\, \} } \newcommand{\sett}[2]{ \{\,#1\, \mid\, #2\, \} } \newcommand{\Set}[1]{ \Big\{\,#1\, \Big\} } \newcommand{\Sett}[2]{ \Big\{\,#1\, \Big\vert\; #2\, \Big\} } \newcommand{\mapright}[1]{\ \smash{ \mathop{\longrightarrow}\limits^{#1}}\ } \newcommand{\vars}[2]{{#1}_1\commadots{#1}_{#2}} \newcommand{\map}{\longrightarrow} \def\rank{\mathop{rank}} \def\dim{\mathop{dim}} \def\height{\mathop{height}}\)

3. Markup Basics

In this section we go over the markup codes that you will most likely need when starting out — italic, bold, highlighted and strikethough text, lists, tables, references to web pages, images, and structuring a document into sections, subsections, and so on. We then discuss block constructs — quotations, verse, code, verbatim, etc.

In each case, we give references to more comprehensive sources.

3.1. First things first

Italic text

He shouted, this is very important!

He shouted, _this is very important!_
Bold text

He shouted, this is very important!

He shouted,  *this is very important!*
Highlighted text

Psychologists believe that marking up selected parts of a long text improves comprehension and memory. Sometimes the use of color can differentiate different kinds of text.

Strikethrough

Ms. Grundy made the following correction: "Dear teacher. I ain’t gonna like this class. Can I be excused?"

Numbered Lists

You write a numbered list of errands:

  1. Get groceries

  2. Put gas in the car

  3. Drop a package off at Fedex

Here is the marked-up text:

. Get groceries
. Put gas in the car
. Drop a package off at Fedex
Bulleted lists

You are writings an outline for a class presentation:

  • Atoms are the building blocks of matter

  • Atoms are very, very small

  • The idea goes back to Democritus, around 500 BC

  • We now know that atoms can be broken down into smaller particles

Here is the marked up text:

* Atoms are the building blocks of matter
* Atoms are very, very small
* The idea goes back to Democritus, around 500 BC
* We now know that atoms can be broken down
into smaller particles
Hyperlinks

You want to link to an article about Niels Bohr

Here is the marked-up text:

You want to link to an article about
https://en.wikipedia.org/wiki/Niels_Bohr[Niels Bohr]

Just paste in the link and follow it by a few words enclosed in brackets. Some times the links are so long that you have to choose the Wide option in the Edit menu.

Media

Noteshare documents can display media: images, audio, and text. The image below was inserted using the markup

image ::460[]

Here 460 is the ID number of the image. See XXX for more information about uploading media and placing them in your document.

111129135500aR7j

3.2. Sections

Section, subsections, etc., are indicated like this:

 == Top level section

 Blah, blah

 === Subsection

 Fee, fie, fo fum!

 ==== Subsection

 Ho ho ho!

 ===== Subsubsubsection

 The end!

Sections can be numbered or un-numbered.

Put the code :numbered: in your document to turn numbering on, put :!numbered: to turn it off.

3.3. Blocks

Blocks are used for quotations, poetry, computer code, and much more. The general form of a one-paragraph block is

[header]
TEXT

The general form of a several-paragraph block is

[header]
--
PARAGRAPH 1

PARAGRAPH 2

ETC
--

We illustrate this construction below.

3.3.1. Verse

Poem — one paragraph
’Twas brillig, and the slithy toves
      Did gyre and gimble in the wabe:
All mimsy were the borogoves,
      And the mome raths outgrabe.
Markup
[verse]
’Twas brillig, and the slithy toves
      Did gyre and gimble in the wabe:
All mimsy were the borogoves,
      And the mome raths outgrabe.
Poem — several paragraphs
’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!”
Markup
[verse]
--
’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!”
--

3.3.2. Quotations

A man who dares to waste one hour of time has not discovered the value of life.
— Charkes Darwin
The Autobiography of Charles Darwin
Markup
[quote, Charkes Darwin, The Autobiography of Charles Darwin, 1809–82]
A man who dares to waste one hour of time has
not discovered the value of life.

3.3.3. Code

Below is a a block of code; note that indentation is preserved:

sum = 0.0
for k in range(1,100):
  sum = sum + 1.0/k
Markup
[source, python]
--
sum = 0.0
for k in range(1,100):
  sum = sum + 1.0/k
--

3.4. Basic tables

Eggs

one dozen

Potatoes

twelve pounds

Milk

three quarts


The source code
|===
| Eggs | one dozen
| Potatoes | nine pounds
| Milks | three quarts
|===

For more, see the tables section of this manual.


Created August 21, 2015, last updated: August 22, 2015