/docs/MyDocs

To get this branch, use:
bzr branch http://darksoft.org/webbzr/docs/MyDocs

« back to all changes in this revision

Viewing changes to xml/info/XLink.txt

  • Committer: Suren A. Chilingaryan
  • Date: 2009-04-09 03:21:08 UTC
  • Revision ID: csa@dside.dyndns.org-20090409032108-w4edamdh4adrgdu3
import

Show diffs side-by-side

added added

removed removed

Lines of Context:
xml/info/XLink.txt
 
1
 Generalization of HTML link concept (based on XPointer).
 
2
 
 
3
Terminology
 
4
-----------
 
5
Link            - Explicit relationship between two or more resources
 
6
Linking element - An XML element that asserts the existence and describes the
 
7
                characteristics of a link
 
8
Locator         - An indefication of a remote resource that is participating
 
9
                in the link
 
10
Outbound link   - The source is a local resource
 
11
Inbound link    - The destination is a local resource
 
12
Third-party link- None of the resources are local
 
13
 
 
14
Namespace
 
15
---------
 
16
 xmlns:xlink="http://www.w3.org/1999/xlink"
 
17
 
 
18
 
 
19
Attributes
 
20
----------
 
21
 xlink:type             resource        - indicates local linking resource
 
22
                        locator         - locates a remote linking resource
 
23
                        extended        - indicates a general linking element
 
24
                        simple          - indicates a general linking element
 
25
                                        (only two-ended outbound links)
 
26
                        arc             - define traversal rules (defines a set
 
27
                                         of arcs: from each resource having the
 
28
                                         from label to each resource having the
 
29
                                         to label)
 
30
                        title           - See xlink:title
 
31
 xlink:href             XPointer which specifies remote resource
 
32
 xlink:label            Linking element ideficator
 
33
 xlink:from             Specifies source link element (by indeficator)
 
34
 xlink:to               Specifies destination link element
 
35
 xlink:show             Specifies what happens when the link is activated:
 
36
                        embed   - insert the presentation of the target resource
 
37
                                (the one at the end of the arc) in place of the 
 
38
                                source (the one ate the begining of the arc, 
 
39
                                where traversal was initiated). 
 
40
                                Example: as images in HTML.
 
41
                        new     - Display the target resource some other place
 
42
                                without affecting the presentation of the
 
43
                                source resource.
 
44
                                Example: as target="_blank" in an HTML link
 
45
                                (loads link in new window)                      
 
46
                        replace - Replace the presentation of the resource 
 
47
                                containing the source with a presentation of
 
48
                                the destination.
 
49
                                Example: Noraml HTML link
 
50
                        other   - Behavior specified elsethere
 
51
                        none    - Non behavior specified
 
52
 xlink:actuate          Specifies when is the link activated
 
53
                        onLoad  - traverse the link immediately when recognized
 
54
                                Example: as HTML images
 
55
                        onRequest - traverse when explicitly requested
 
56
                                Example: as normal HTML links
 
57
                        other   - behavior specified elsethere
 
58
                        none    - no behavior is specified
 
59
 xlink:title            Provides human readable description
 
60
 xlink:role(arcrole)    Also can act as linking element ideficator
 
61
 
 
62
Tags
 
63
----
 
64
 mylink                 Specifies general link element
 
65
 myresource             Specifies link resources
 
66
 myarc                  Specifies link arcs
 
67
 
 
68
Simple vs. Extended
 
69
-------------------
 
70
 <mylink xlink:type="simple" xlink:href="..." xlink:show="..." .../>
 
71
 
 
72
                this links are equivalent
 
73
 
 
74
 <mylink xlink:type="extended">
 
75
    <myresource xlink:type="resource" 
 
76
                xlink:role="local"/>
 
77
    <myresource xlink:type="locator" 
 
78
                xlink:role="remote" xlink:href="..."/>
 
79
    <myarc xlink:type="arc" 
 
80
           xlink:from="local" xlink:to="remote" xlink:show="..." .../>
 
81
  </mylink>
 
82
 
 
83
 
 
84
 
 
85
Third-Party Link Example
 
86
------------------------
 
87
 <mylink xlink:type="extended">
 
88
    <myresource xlink:type="locator" 
 
89
                xlink:href="students.xml#Fred" xlink:label="student"/>
 
90
    <myresource xlink:type="locator" 
 
91
                xlink:href="teachers.xml#Joe" xlink:label="teacher"/>
 
92
    <myarc xlink:type="arc" 
 
93
           xlink:from="student" xlink:to="teacher"/>
 
94
  </mylink>
 
95