_pub.n

• 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
• 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
• 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
• 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
• 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
• 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.4 More Asciidoc Exampleshttp://www.noteshare.io/section/asciidoc-markup?part=More%20Asciidoc%20Examples#_more_asciidoc_examples

# Noteshare Handbook


## 8. Cross references

### 8.1. References within a note

To make a reference to a section, subsection, etc. of a single "note" of a notebook, enclose the verbatim text of the section name in double angle brackets, e.g., << References within Noteshare >> — but with no spaces after << or before >>. This will make a link to subsection like

`  === References within Noteshare`

Parts of a note can also be labeled and referred to, At the bottom of this section there is some text about the The Internet. Here is the text of the reference:

`  <<woolly>>`

And here is the text referred to:

```  [[wooly]]
.The Internet
The world-wide web is a wild and woolly place.```

The text .The Internet provides a title, while [[wooly]] provides a label. We use that label to make the reference.

### 8.2. References within Noteshare

Here is a reference to another note in the current notebook: Working with Images. And here is how the reference is made.

All you need is the ID number of the note. To find the ID, look the lower right of the screen. You will see the text 56:571. Here 56 is the ID number of this notebook, and 571 is the ID number of this section. Thus one could write

 Note Reference to a note in another notebook are made in the same way as one makes a reference to a note in the current notebook. Thus the link xlink::260[Lightning and Earthquakes], rendered as Lightning and Earthquakes, refers to a note in a book of Physics notes.

### 8.3. References to a web page

To make a reference to a web page, imitate this model:

`http://tolweb.org/tree/[Tree of Life]`

Here is an example of the model in action:

The Tree of Life web site shows the evolutionary relationships between different life forms.

The technique used to refer to an external web page also works to refer to a pages in Noteshare. Thus one can say

```  The article
http://www.noteshare.io/section/jsxgraph-harmonic-oscillator[HO]
demonstrates a simulation of a mass-spring system.```

in order to obtain this:

The article HO demonstrates a simulation of a mass-spring system.

For this you need to know the public URL of the noteshare page. To find it click on SA (section attribute) in the main edit window. You will see it displayed on the top right.

### 8.4. References to something inside a web page

Let’s suppose that we want to refer to the table of energies found at Physics Notebook, Tables. We can do this

```  http://phys.noteshare.io/section/physics-basic-tables#energies[Table
of Energies]```

to obtain this:

For this you need to know the ID of the table (if it has one). If you are the author, that is easy. You look back at the source text, which reads

```  [[energies]]
.Energies
|===
Quantity, Value
Thermal motion at room temp, 0.04 ev```

There you see that"energies" was set as the ID, or label. If you are not the author, there is a geeky solution. Use View Source in you browser and search for the title, which in this case is "Energies". Look for

<table id="energies" …​

The value of the `id` attribute is `energies`, and this is what you want.

#### 8.4.1. Demonstration text below

This text is purely for demonstration purposes:

The Internet

The world-wide web is a wild and woolly place.

Created June 6, 2014, last updated: August 21, 2015