--- a/Allura/allura/templates/jinja_master/lib.html
+++ b/Allura/allura/templates/jinja_master/lib.html
@@ -92,10 +92,29 @@
{% macro markdown_syntax() %}
<h1>Markdown Syntax Guide</h1>
+
<p>The Allura code uses markdown syntax everywhere to allow you to create rich<br>text markup, and extends markdown in several ways to allow for quick linking<br>to other artifacts in your project. </p>
<p>Markdown was created to be easy to read, easy to write, and still readable in plain text format.</p>
-<h2>Links</h2>
+<ul>
+ <li><a href="#md_ex_links">Links</a></li>
+ <li><a href="#md_ex_reflinks">Reference Links</a></li>
+ <li><a href="#md_ex_artlinks">Artifact Links</a></li>
+ <li><a href="#md_ex_text">Text</a></li>
+ <li><a href="#md_ex_bq">Blockquotes</a></li>
+ <li><a href="#md_ex_pre">Preformatted Text</a></li>
+ <li><a href="#md_ex_lists">Lists</a></li>
+ <li><a href="#md_ex_headers">Headers</a></li>
+ <li><a href="#md_ex_hr">Horizontal Rules</a></li>
+ <li><a href="#md_ex_img">Images</a></li>
+ <li><a href="#md_ex_escapes">Escapes</a></li>
+ <li><a href="#md_ex_moreheaders">More Headers</a></li>
+ <li><a href="#md_ex_code">Code Highlighting</a></li>
+ <li><a href="#md_ex_includes">Includes</a></li>
+ <li><a href="#md_ex_thanks">Thanks</a></li>
+</ul>
+
+<h2 id="md_ex_links">Links</h2>
<p>Most URLs will automatically be turned into links. To be explicit, just write it like this:</p>
@@ -109,7 +128,7 @@
You can add a *title* (which shows up under the cursor),
[like this](http://someurl "this title shows up when you hover").
</pre></div>
-<h2>Reference Links</h2>
+<h2 id="md_ex_reflinks">Reference Links</h2>
<div class="codehilite"><pre>You can also put the [link URL][1] below the current paragraph
like [this][2].
@@ -125,7 +144,7 @@
[shortcut]: http://goes/with/the/link/name/text
</pre></div>
-<h2>Artifact Links</h2>
+<h2 id="md_ex_artlinks">Artifact Links</h2>
<p>Any existing forge resource can be linked with surrounding square brackets ie [MyPage] or [#123].</p>
<p>Links to resources in other tools can be explicitly referenced by adding a tool identifier prefix to the link.
@@ -141,7 +160,7 @@
[tickets:#123]
</pre></div>
-<h2>Text</h2>
+<h2 id="md_ex_text">Text</h2>
<div class="codehilite"><pre>Use * or _ to emphasize things:
*this is in italic* and _so is this_
@@ -158,7 +177,7 @@
in the same paragraph.
</pre></div>
-<h2>Blockquotes</h2>
+<h2 id="md_ex_bq">Blockquotes</h2>
<div class="codehilite"><pre>> Use the > character in front of a line, *just like in email*.
> Use it if you're quoting a person, a song or whatever.
@@ -170,7 +189,7 @@
To end the blockquote, just put a blank line before the following
paragraph.
</pre></div>
-<h2>Preformatted Text</h2>
+<h2 id="md_ex_pre">Preformatted Text</h2>
<div class="codehilite"><pre>If you want some text to show up exactly as you write it, without
Markdown doing anything to it, just indent every line by at least 4
spaces (or 1 tab).
@@ -186,7 +205,7 @@
at all.`
</pre></div>
-<h2>Lists</h2>
+<h2 id="md_ex_lists">Lists</h2>
<div class="codehilite"><pre>* an asterisk starts an unordered list
* and this is another item in the list
+ or you can also use the + character
@@ -202,7 +221,7 @@
1. keep indenting for more sub lists
* here i'm back to the second level
</pre></div>
-<h2>Headers</h2>
+<h2 id="md_ex_headers">Headers</h2>
<div class="codehilite"><pre>This is a huge header
==================
@@ -212,7 +231,7 @@
Just put 1 or more dashes or equals signs (--- or ===) below the
title.
</pre></div>
-<h2>Horizontal Rule</h2>
+<h2 id="md_ex_hr">Horizontal Rule</h2>
<div class="codehilite"><pre>just put three or more *'s or -'s on a line:
----------------
@@ -232,7 +251,7 @@
</pre></div>
-<h2>Images</h2>
+<h2 id="md_ex_img">Images</h2>
<p>To include an image, just put a "!" in front of a text link:</p>
<div class="codehilite"><pre>
@@ -248,7 +267,7 @@
[[img src=attached-image.jpg alt=foobar width=20%]]
</pre></div>
-<h2>Escapes</h2>
+<h2 id="md_ex_escapes">Escapes</h2>
<p>What if you want to just show asterisks, not italics?</p>
<div class="codehilite"><pre>* this shows up in italics: *a happy day*
* this shows the asterisks: \*a happy day\*
@@ -266,7 +285,7 @@
<p>Individual ampersands (&) and less-than signs (<) are fine, they will be shown as expected.</p>
-<h2>More Headers</h2>
+<h2 id="md_ex_moreheaders">More Headers</h2>
<div class="codehilite"><pre>More ways of doing headers:
# this is a huge header #
@@ -278,7 +297,7 @@
</pre></div>
<p>You can use up to 6 <code>#</code> characters at the beginning of the line.</p>
-<h2>Code Highlighting</h2>
+<h2 id="md_ex_code">Code Highlighting</h2>
<p>The Code highlighting used in the newforge is based on (http://www.freewisdom.org/projects/python-markdown/CodeHilite). It follows the same syntax as regular Markdown code blocks, except that there are two ways to tell the highlighter what language to use for the code block.</p>
<p>If the first line of the codeblock contains a shebang, the language is derived from that and line numbers are used.</p>
@@ -303,13 +322,13 @@
~~~~~~
</pre></div>
-<h2>Includes</h2>
+<h2 id="md_ex_includes">Includes</h2>
<p>You can embed another wiki page directly:</p>
<div class="codehilite"><pre>
[[include ref=SamplePage]]
</pre></div>
-<h2>Thanks</h2>
+<h2 id="md_ex_thanks">Thanks</h2>
<p>Thanks to John Gruber and Aaron Swartz for creating Markdown.</p>
<p>
This page is based on some examples from Greg Schueler, <a href="mailto:greg@vario.us">greg@vario.us</a>