matthiasbeyer/imag
1
0
Fork 0
Code Releases Activity

doc: Rewrite linking chapter

Browse source
This commit is contained in:
Matthias Beyer 2016-07-08 18:43:46 +02:00
parent 7a8432123b
commit f81e47ceb2
1 changed files with 17 additions and 23 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

40
doc/src/02010-linking.md
View file

@ -1,35 +1,29 @@
## Linking from an store entry {#sec:thestore:linking} ## Linking from an store entry {#sec:thestore:linking}
In @sec:thestore:fileformat:header:imag it was already defined that there MUST As described in @sec:intro:problem the purpose of imag is to _link_ content
BE a section "imag" in the header. This section can be used to link to together. The following section describes, from a technical view, how this is
"internal" and "external" content, whereas "internal content" refers to entries done in imag.
which are stored in the very same store as the entry which links.
The term "external content" means content which is not stored in the
store, but elsewhere on the filesystem or the network (thus, an URL is valid
external content).
Entries can be referenced from the content part. For example, if the content There are two ways of linking in imag. You can either link internally or
part is written in Markdown, the user is able to link content within the externally. The following sections describe the differences.
Markdown text.
These links could be either links to internal content or external content.
### Linking to internal content {#sec:thestore:linking:internal} ### Linking to internal content {#sec:thestore:linking:internal}
Links to internal content are stored in the Array "imag.links = []". Internal links are links between store entries themselfes. This means that one
Each entry in this array MUST BE a String which is an absolute path to a store store entry can link to another. Actually, links are not pointers but rather
entry (@sec:thestore:links). tries between entries, meaning that an link is not directed, but always a
two-way pointer.
As links from within the content part of a module is not cross-compatible over How linking works from the user interface is described in @sec:modules:link.
modules, each module SHOULD store the links which are in the content
part also in the "imag.links" Array. This way, other modules can read the links
without having knowledge about how to parse the content part of an entry.
### Linking to external content {#sec:thestore:linking:external} ### Linking to external content {#sec:thestore:linking:external}
Each Entry can store _one link to external content at most_. Linking to external content means linking to files or directories which do not
live inside the store itself but outside of it.
This link is stored in the header field "imag.content.uri" Each store entry can store _one link to external content at most_.
(@sec:thestore:fileformat:header:imag).
A key "imag.content.file" COULD be used for a local mirror of the content which External linking should not be used from the user interface but rather the
is referenced by "imag.content.uri". `ref` feature (@sec:modules:ref) should be used.
@sec:modules:ref describes why that is.