Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [asciidoc-lang-dev] Proposing olinks

On 2/18/21 12:50 PM, David Jencks wrote:
> After some more thought I’ve refined my perspective a bit.
> ...
> From this point of view, I like the idea of `xref` expressing links between source documents in the set and `link` expressing links outside the set.

I like that!

The idea of a "Document Set" as a body of AsciiDoc documents makes a
clear distinction between links inside the set and links outside the set:

### Inside the set ("xref"):

* Document Foo (foo.adoc)
* ID "bar" in same document
* ID "bar" in document Foo (foo.adoc#bar)

### Outside the set ("link"):

* Relative link to "reference.html"
* Anchor link to "reference.html#bar"

-Dave Gauer

Back to the top