|
1
|
# Markdown Link-test |
|
2
|
|
|
3
|
This document exists solely as a test for some of the hyperlinking |
|
4
|
capabilities of Markdown as implemented by Fossil. |
|
5
|
|
|
6
|
## Relative-Path Links |
|
7
|
|
|
8
|
* The index: [](../index.wiki) |
|
9
|
|
|
10
|
* Load management: [](../loadmgmt.md) |
|
11
|
|
|
12
|
* Site-map: [](../../../../sitemap) |
|
13
|
|
|
14
|
* Windows CGI: [](../server/windows/cgi.md) |
|
15
|
|
|
16
|
## The Magic $ROOT Path Prefix |
|
17
|
|
|
18
|
In text of the form `href="$ROOT/..."` in the HTML that markdown |
|
19
|
generates, the $ROOT is replaced by the complete URI for the root |
|
20
|
of the document tree. |
|
21
|
Note that the $ROOT translation only occurs within the `<a href="...">` |
|
22
|
element, not within the text of the hyperlink. So you should see the |
|
23
|
$ROOT text on this page, but if you mouse-over the hyperlink the $ROOT |
|
24
|
value should have been expanded to the actual document root. |
|
25
|
|
|
26
|
* Timeline: []($ROOT/timeline) |
|
27
|
|
|
28
|
* Site-map: []($ROOT/sitemap) |
|
29
|
|
|
30
|
The $ROOT prefix on markdown links is superfluous. The same link |
|
31
|
works without the $ROOT prefix. (Though: the $ROOT prefix is required |
|
32
|
for HTML documents.) |
|
33
|
|
|
34
|
* Timeline: [](/timeline) |
|
35
|
|
|
36
|
* Help: [](/help/help) |
|
37
|
|
|
38
|
* Site-map: [](/sitemap) |
|
39
|
|
|
40
|
## The Magic $CURRENT Document Version Translation |
|
41
|
|
|
42
|
In URI text of the form `.../doc/$CURRENT/...` the |
|
43
|
$CURRENT value is converted to the version number of the document |
|
44
|
currently being displayed. This conversion happens after translation |
|
45
|
into HTML and only occurs on href='...' attributes so it does not occur |
|
46
|
for plain text. |
|
47
|
|
|
48
|
* Document index: [](/doc/$CURRENT/www/index.wiki) |
|
49
|
|
|
50
|
Both the $ROOT and the $CURRENT conversions can occur on the same link. |
|
51
|
|
|
52
|
* Document index: []($ROOT/doc/$CURRENT/www/index.wiki) |
|
53
|
|
|
54
|
The translations must be contained within HTML markup in order to work. |
|
55
|
They do not work for ordinary text that appears to be an href= attribute. |
|
56
|
|
|
57
|
* `x href='$ROOT/timeline'` |
|
58
|
* `x action="$ROOT/whatever"` |
|
59
|
* `x href="https://some-other-site.com/doc/$CURRENT/tail"` |
|
60
|
|