From 6a0cf3b57a51d5f3c60bd1bcc53619dce9cf0355 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?John=20Ankarstr=C3=B6m?= Date: Sun, 31 Jan 2021 00:14:05 +0000 Subject: Remove (linktext) links, add links --- README.html | 59 +++++++++++++++++++++++++++++++++++++---------------------- 1 file changed, 37 insertions(+), 22 deletions(-) (limited to 'README.html') diff --git a/README.html b/README.html index c6fa908..efcee0b 100644 --- a/README.html +++ b/README.html @@ -12,19 +12,17 @@ never more than a single possible em representation.

Em values readability over expressiveness. This means that it is rather limited in terms of what HTML it can produce. Most noticeably, only a very limited -form of inline links are supported (see Lists and Inline formatting). +form of inline links are supported (see Hyperlinks below).

Em also values consistency and predictability. As such, the syntax is rather strict. This makes it a bit harder to learn, but much more predictable.

-Em's complete and exact syntax is defined by its implementation (link), but a +Em's complete and exact syntax is defined by its implementation [1], but a general description follows below. For longer examples, see the source -code for this text (link) or the test file (link). +code for this text [2] or the test file [3].

-
    -

Em is implemented in portable awk, with an rc script to bind it together. It is written on and for Plan 9 primarily, but the rc code can (more or less) @@ -66,31 +64,43 @@ Example of an inline reference [1]. [1] The quick brown fox ...

+In the final output, the inline reference becomes a link to the +reference item later in the document: +

+
+<p>Example of an inline reference [<a href="#ref1">1</a>].
+</p>
+<ol class="reflist">
+<li value="1" id="ref1">The quick brown fox ...
+</li>
+</ol>
+
+

For more information about references, see Reference lists below.

Hyperlinks

Hyperlinks are a special case of inline references. When an inline -reference refers to a reference containing only a web address, -the inline reference is replaced with a hyperlink to that address. +reference refers to a reference containing a single link, the inline +reference points directly to that link, rather than at the reference. 

-It is available for download [2].
+It is available for download [1].
 
- [2] v1.tgz
+ [1] <./v1.tgz>

The above example translates to the following HTML: 

-<p>It is available for download (<a href="v1.tgz">link</a>).
+<p>It is available for download [<a href="./v1.tgz">1</a>].
 </p>
+<ol class="reflist">
+<li value="1" id="ref1"><a href="./v1.tgz">./v1.tgz</a>
+</li>
+</ol>
-

-The default link text ("link") can be changed by setting -the linktext environment variable. -

Block-level formatting