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
Try it out: 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:
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
|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 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:
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 [format="csv", options="header", ...] |=== 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
8.4.1. Demonstration text below
This text is purely for demonstration purposes:
The world-wide web is a wild and woolly place.
Created June 6, 2014, last updated: August 21, 2015