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