Re: XLink as a solution for references

Schimon Jehudah via Docutils-users <[email protected]> Thu, 9 Oct 2025 16:39:52 +0300
Newsgroups gmane.text.docutils.user
Message-ID <[email protected]>
R3VlbnRlci4gR29vZCBldmVuaW5nLgoKT24gVGh1LCA5IE9jdCAyMDI1IDExOjQ0OjAxIC0wMDAw
IChVVEMpCkd1ZW50ZXIgTWlsZGUgdmlhIERvY3V0aWxzLXVzZXJzIDxkb2N1dGlscy11c2Vyc0Bs
aXN0cy5zb3VyY2Vmb3JnZS5uZXQ+Cndyb3RlOgoKPiBPbiAyMDI1LTEwLTA5LCBTY2hpbW9uIEpl
aHVkYWggdmlhIERvY3V0aWxzLXVzZXJzIHdyb3RlOgo+ID4gT24gVGh1LCA5IE9jdCAyMDI1IEd1
ZW50ZXIgTWlsZGUgdmlhIERvY3V0aWxzLXVzZXJzIHdyb3RlOiAgCj4gPj4gT24gMjAyNS0xMC0w
OCwgU2NoaW1vbiBKZWh1ZGFoIHZpYSBEb2N1dGlscy11c2VycyB3cm90ZTogIAo+IC4uLgo+IAo+
ID4+IFlvdSBzaG91bGQgZGVjaWRlLCB3aGV0aGVyIHRoZSBwcmVhbWJsZS9tZXRhZGF0YSBibG9j
ayBzaG91bGQgYmUKPiA+PiBwYXJzZWQgYXMgcmVTdHJ1Y3R1cmVkVGV4dCAoclNUKSBhdCBhbGwg
b3IgYmUgYSBkaWZmZXJlbnQgZm9ybWF0ICAKPiAKPiAKPiA+PiBJZiB5b3UgZGVjaWRlIHRvIHVz
ZSByU1QgZm9yIHRoZSBtZXRhZGF0YSwgeW91IGNhbiBzcGxpdCBvZmYgdGhlCj4gPj4gcHJlYW1i
bGUgYW5kIHBhcnNlIGl0IHRvIERvY3V0aWxzLVhNTCB3aGljaCB0aGVuIGNhbiBiZSBjb252ZXJ0
ZWQKPiA+PiB0byBBdG9tIFN5bmRpY2F0aW9uIEZvcm1hdCB3aXRoIFhTTFQuICAKPiAKPiA+IElz
IHRoZXJlIGV4YW1wbGUgY29kZT8gIAo+IAo+IE5vdCBkaXJlY3RseS4KPiAKPiBJdCBhbHNvIGRl
cGVuZHMgb24gaG93IHlvdSB3b3VsZCBsaWtlIHRvIHNwbGl0IHRoZSBwcmVhbWJsZSBmcm9tCj4g
dGhlIGNvbnRlbnQKPiAKPiAqIHdpdGggYSBwcmUtcHJvY2Vzc29yIGZyb20gdGhlIHJTVCBmaWxl
Cj4gKiBhZnRlciBwYXJzaW5nLCBmcm9tIHRoZSBQeXRob24gImRvY3RyZWUiIG9iamVjdAo+ICog
d2l0aCBYU0xUIGZyb20gdGhlIERvY3V0aWxzLVhNTAo+IAoKRmluZS4gU28sIEkgc3VwcG9zZSwg
dGhhdCBpdCBpcyBmb3IgbWUgdG8gZGVjaWRlLgoKSXQgaXMganVzdCB0aGF0IHNlbWljb2xvbnMg
c2hvdWxkIG5vdCBiZSB1dGlsaXplZCwgYnV0IGNvbW1hcy4KCj4gPj4gQW4gYWx0ZXJuYXRpdmUg
aWRlYSB3b3VsZCBiZSB1c2luZyAieWFtbCIsIFsuLi5dICAKPiAKPiA+IE5vLiBJIGFtIGludGVy
ZXN0ZWQgaW4gdXRpbGl6aW5nIG9ubHkgclNULiBJdCBhcHBlYXJzIHRvIGJlIGEKPiA+IHBlcmZl
Y3QgZm9ybWF0IGZvciBkb2N1bWVudHMsIHByZXNlbnRhdGlvbnMsIGFuZCBpbnRlcm5ldCBwYWdl
cy4gIAo+IAo+IAo+ID4+IC4uLiAgCj4gCj4gPj4gPiBDb25jZXJuaW5nIHRvIGZpZWxkICJhdXRo
b3JzIjsgSSBoYXZlIGRlbGliZXJhdGVseSBhZGRlZAo+ID4+ID4gc2VtaWNvbG9uIGFzIGl0IGl0
IGVhc2llciB0byAic3BsaXQiIHRpdGxlIGZyb20gYWRkcmVzcy4gIAo+IAo+ID4+IEkgc3Ryb25n
bHkgcmVjb21tZW5kIHVzaW5nIGFuIGV4aXN0aW5nIHN0YW5kYXJkIGZvcm1hdC4gIAo+IAo+ID4g
VGhlIHB1cnBvc2Ugb2YgUml2aXN0YSBWb3lhZ2VyIGlzIHRvIG9ubHkgdXRpbGl6ZSBzdGFuZGFy
ZHMuICAKPiAKPiAuLi4KPiAKPiA+IEkgd291bGQgYXBwcmVjaWF0ZSBleGFtcGxlIGNvZGUgZm9y
IGh0ZSBleHRyYWN0aW9uIG9mICJ0aXRsZSIgYW5kCj4gPiAiYWRkcmVzcyIuICAKPiAKPiA+IFBs
ZWFzZSBzZWUgZmllbGRzIG9mIHRoZSBuZXcgdmVyc2lvbiBvZiB0aGF0IGRvY3VtZW50LiAgCj4g
Cj4gUGxlYXNlIHByb3ZpZGUgYSAqKm1pbmltYWwqKiBleGFtcGxlLgo+IChlLmcuIGlucHV0IHRv
IGdlbmVyYXRlIHNvbWV0aGluZyBsaWtlCj4gaHR0cHM6Ly9lbi53aWtpcGVkaWEub3JnL3dpa2kv
QXRvbV8od2ViX3N0YW5kYXJkKSNFeGFtcGxlX29mX2FuX0F0b21fMS4wX2ZlZWQpCj4gCgpQYXJk
b24uIEkgZG8gbm90IHJlYWxpemUgd2hhdCBpcyB0aGlzIGZvciwgdW5sZXNzIHlvdSBtZWFuIHRo
YXQgYnkKInN0YW5kYXJkIiBJIHNob3VsZCBjb21wbHkgd2l0aCB0aGUgZmllbGRzIChYTUwgZWxl
bWVudHMpIG9mIFRoZSBBdG9tClN5bmRpY2F0aW9uIEZvcm1hdC4gUGxlYXNlIHJlYWQgZnVydGhl
ciBhdCB0aGUgZW5kIG9mIHRoaXMgbWVzc2FnZS4KCk90aGVyd2lzZSwgSSBoYW5kbGUgQXRvbSBT
eW5kaWNhdGlvbiBGb3JtYXQgYnkgY29sbGVjdGluZyByU1QKcHJvcGVydGllcywgYW5kIGNvbnRl
bnRzIGludG8gYSBkaWN0aW9uYXJ5IChpLmUuICJkaWN0Iikgd2hpY2ggaXMgdGhlbgpkZWxpdmVy
ZWQgdG8gZnVuY3Rpb24gIlBhcnNlckF0b20uZG9jdW1lbnQiIGZvciBmdXJ0aGVyIHByb2Nlc3Np
bmcgaW50bwphbiBBdG9tIFN5bmRpY2F0aW9uIEZvcm1hdCBmaWxlLgoKPiAKPiAuLi4KPiAKPiA+
IC4uIGF1dGhvcnM6IFNjaGltb24gSmVodWRhaCBaYWNoYXJ5IDsgeG1wcDpzY2hAcGltdXguZGU/
bWVzc2FnZQo+ID4gLi4gZGF0ZTogMjAyNS0wNy0xNCAwMDowMDowMCBVVEMKPiA+IC4uIGRlc2Ny
aXB0aW9uOiBQdWJsaXNoaW5nIGNsaWVudCBzb2Z0d2FyZSBmb3IgWE1QUC4KPiA+IC4uIGxpbms6
IHhtcHAKPiA+IC4uIG1pY3Jvc3VtbWFyaWVzOgo+ID4gICAgNSBYTVBQIHB1Ymxpc2hpbmcgY2xp
ZW50IHNvZnR3YXJlIDsgcHJvamVjdHMKPiA+ICAgIDEgWE1QUCBwdWJsaXNoaW5nIGNsaWVudCBz
b2Z0d2FyZSA7IGRlc2t0b3AKPiA+ICAgIDQgWE1QUCBwdWJsaXNoaW5nIGNsaWVudCBzb2Z0d2Fy
ZSA7IGh0bWwKPiA+ICAgIDEgWE1QUCBwdWJsaXNoaW5nIGNsaWVudCBzb2Z0d2FyZSA7IG1vYmls
ZSAgCj4gLi4uCj4gCj4gSWYgeW91IGNvbnZlcnQgdGhlIHByZWFtYmxlIHRvIGEgclNUIGJpYmxp
b2dyYXBoeTo6Cj4gCj4gICA6YXV0aG9yczogU2NoaW1vbiBKZWh1ZGFoIFphY2hhcnkgOyB4bXBw
OnNjaEBwaW11eC5kZT9tZXNzYWdlCj4gICA6ZGF0ZTogMjAyNS0wNy0xNCAwMDowMDowMCBVVEMK
PiAgIDpkZXNjcmlwdGlvbjogUHVibGlzaGluZyBjbGllbnQgc29mdHdhcmUgZm9yIFhNUFAuCj4g
ICA6bGluazogLi4uCj4gCj4gd2l0aCBhIHN1aXRhYmxlIHJTVCBjb25zdHJ1Y3QgaW5zdGVhZCBv
ZiB0aGUgbm9uLXN0YW5kYXJkICI7IizCuSAgCj4gYW5kIHJ1biByc3QyeG1sIG9uIGl0LCB5b3Ug
c2VlIHRoZSBYTUwgcmVwcmVzZW50YXRpb24uCj4gCgpJIHRoaW5rLCB0aGF0IHRoZXJlIGlzIG5v
IGRpZmZlcmVuY2UgdG8gbWUsIGJlY2F1c2UgaXQgYXBwZWFycyB0aGF0IHRoZQpvdXRwdXQgd291
bGQgYmUganVzdCB0aGUgc2FtZSB3aXRoIHNlbWljb2xvbi4KCkhvd2V2ZXIsIEkgd2lsbCByZXBs
YWNlIGFsbCBpbnN0YW5jZXMgb2Ygc2VtaWNvbG9uIGJ5IGNvbW1hLCBmb3IgdGhlCnNha2Ugb2Yg
c3RhbmRhcmRzIGNvbXBsaWFuY3kuCgpOT1RFOiBJdCAgbWVhbnMsIHRoYXQgdGhlIHN5c3RlbSB3
b3VsZCBoYXZlIHRvIHJlamVjdCBhdHRlbXB0cyB0bwogICAgICBpbmNvcnBvcmF0ZSBjb21tYW5z
IGludG8gTWljcm9zdW1tYXJpZXMsIE5hbWVzIGFuZCBUaXRsZXMuCgpUaGlzIGZpZWxkLgoKLi4g
YXV0aG9yczoKICAgQmFieWxvbk9ic2VydmVyLmNvbSAsIGh0dHBzOi8vYmFieWxvbm9ic2VydmVy
LmNvbQogICBUaGUgQmFieWxvbiBPYnNlcnZlciAsIG1haWx0bzppbmZvQGJhYnlsb25vYnNlcnZl
ci5jb20KCklzIHJlYWxpemVkIHRvIHRoaXMgY29kZS4KCjxjb21tZW50IHhtbDpzcGFjZT0icHJl
c2VydmUiPmF1dGhvcjoKQmFieWxvbk9ic2VydmVyLmNvbSAsIGh0dHBzOi8vYmFieWxvbm9ic2Vy
dmVyLmNvbQpUaGUgQmFieWxvbiBPYnNlcnZlciAsIG1haWx0bzppbmZvQGJhYnlsb25vYnNlcnZl
ci5jb208L2NvbW1lbnQ+CgpUaGUgc2FtZSBmb3IgZmllbGQgdGFncy4KCi4uIHRhZ3M6CiAgIEFu
YWx5c2VzLCBDdXJyZW5jeSwgRWNvbm9taWNzLCBGaW5hbmNlLCBGdW5kLCBHYXJkZW4sIEluZHVz
dHJ5LAogICBNZXRhcGhvciwgTXlzdGVyeSBQYXBlciwgUG93ZXIsIFdvcmxkCgo8Y29tbWVudCB4
bWw6c3BhY2U9InByZXNlcnZlIj50YWdzOgpBbmFseXNlcywgQ3VycmVuY3ksIEVjb25vbWljcywg
RmluYW5jZSwgRnVuZCwgR2FyZGVuLCBJbmR1c3RyeSwKTWV0YXBob3IsIE15c3RlcnkgUGFwZXIs
IFBvd2VyLCBXb3JsZDwvY29tbWVudD4KCj4gSG93IHRvIGV4dHJhY3QvY29udmVydCB0aGlzIHRv
IGF0b20gWE1MIGlzIGxlZnQgYXMgZXhlcmNpc2UgdG8gdGhlCj4gcmVhZGVyLgo+IAo+IFJlZ2Fy
ZHMsCj4gR8O8bnRlciAgIAo+IAo+IAo+IMK5IEluIHJTVCwgdGhlIGZvcm1hdCBmb3IgZGF0YSBl
bnRyaWVzIGlzIGEgImZpZWxkIGxpc3QiIG9yIGEKPiBkZXNjcmlwdGlvbiBsaXN0LiAKPiAgIFdo
YXQgdG8gdXNlIGRlcGVuZHMgb24gdGhlIGNvbnRleHQgYW5kIG1heSBiZSBkaXNjdXNzZWQgbGF0
ZXIgb24gYQo+ICAgKm1pbmltYWwqIGV4YW1wbGUgd2l0aCBjb3JyZXNwb25kaW5nIEF0b20gZWxl
bWVudCAob25lIGl0ZW0gYXQgYQo+IHRpbWUpLiAKPiAKCkkgdGhpbmsgdGhhdCBJLCBub3csIHJl
YWxpemUgd2hhdCB5b3UgbWVhbi4KCklmIEkgY29ycmVjdGx5IHJlYWxpemUgd2hhdCB5b3UgbWVh
biwgYnkgcmVjb21tZW5kaW5nIHRvIGNvbXBseSB3aXRoCnN0YW5kYXJkcywgdGhlbiB0aGlzIGlz
IHdoYXQgSSBhbSBpbnRlbmRpbmcgdG8gZG8uCgpJIGludGVuZCB0byByZW1vdmUgZmllbGRzIHRo
YXQgYXJlIG5vdCBvZiBUaGUgQXRvbSBTeW5kaWNhdGlvbiBGb3JtYXQsCnN1Y2ggYXMgImNhdGVn
b3J5Iiwgb3IgcmVuYW1lIG90aGVyIGZpZWxkcyB0byBjb21wbHkgd2l0aCBUaGUgQXRvbQpTeW5k
aWNhdGlvbiBGb3JtYXQsIHN1Y2ggYXMgcmVuYW1pbmcgInNsdWciIHRvICJpZCIsICJ0YWdzIiB0
bwoiY2F0ZWdvcmllcyIsICJkYXRlIiB0byAicHVibGlzaGVkIiwgYW5kIGFkZCBtb3JlIGZpZWxk
cyBzdWNoIGFzCiJ1cGRhdGVkIi4KCkhvd2V2ZXIsIGZpZWxkcyAibWV0YWxpbmtzIiBhbmQgIm1p
Y3Jvc3VtbWFyaWVzIiBhcmUgbm90IHBhcnQgb2YgVGhlCkF0b20gU3luZGljYXRpb24gRm9ybWF0
LgoKV2hlbiB5b3UgaW1wbHkgdG8gY29ycmVzcG9uZCB3aXRoIHN0YW5kYXJkLCBkb2VzIGl0IG1l
YW4gdGhhdCB5b3UKYWR2aXNlIHRvIHJlbW92ZSBmaWVsZHMgIm1ldGFsaW5rcyIgYW5kICJtaWNy
b3N1bW1hcmllcyIgZnJvbSByU1QgYW5kCnV0aWxpemUgZXh0ZXJuYWwgZmlsZXMgKGUuZy4gVE9N
TCkgdG8gaGFuZGxlIHRob3NlIGN1c3RvbSBmaWVsZHM/CgpGaWVsZCAiY29tbWVudHMiIGlzIGFs
c28gbm90IHN0YW5kYXJkOyBpdCBpcyBhIHNldHRpbmcgdG8gZW5hYmxlCmNvbW1lbnRzLCBzbyBp
dCB3b3VsZCBoYXZlIHRvIGJlIHJlbW92ZWQgYWxzby4KCk5PVEU6IFRoZSBmaWVsZHMgb2YgIm1l
dGFsaW5rcyIgYW5kICJtaWNyb3N1bW1hcmllcyIgYXJlIHJlYWxpemVkIGludG8KICAgICAgZWxl
bWVudCAiYXRvbTpsaW5rIiwgbWV0YWxpbmtzIGludG8gcmVsPSJlbmNsb3N1cmUiIGFuZAogICAg
ICBtaWNyb3N1bW1hcmllcyBpbnRvIHJlbD0ibWljcm9zdW1tYXJ5Ii4KCkFkZGl0aW9uYWxseSwg
VGhlIEF0b20gU3luZGljYXRpb24gRm9ybWF0IGFsbG93cyB0byBiZSBleHRlbmRlZCwgYnV0IEkK
ZG8gbm90IGV4dGVuZCBpdC4gaHR0cHM6Ly9yZmMtZWRpdG9yLm9yZy9yZmMvcmZjNDI4NyNzZWN0
aW9uLTYKClRoaW5raW5nIG9mIHRoaXMgZnVydGhlciwgSSB3b25kZXIgd2hldGhlciBJIHNob3Vs
ZCByZXBsYWNlIGZpZWxkcwoiZW5jbG9zdXJlcyIgYW5kICJyZWxhdGVkIiAoYm90aCBhcmUgcmVh
bGl6ZWQgYXMgImF0b206bGluayIpIGJ5IGZpZWxkCiJsaW5rIiwgYW5kIGFkZCBhIG5ldyBmaWVs
ZCBmb3IgInJlbCIuCgouLiBsaW5rczoKICAgTXlzdGVyeSBQYXBlciBEb2N1bWVudGFyeSBTZXJp
ZXMgLCBodHRwczovL2JhYnlsb25vYnNlcnZlci5jb20vbXlzdGVyeS1wYXBlci8sIHJlbAogICBU
aGUgQmFieWxvbiBPYnNlcnZlciAsIGh0dHBzOi8vYmFieWxvbm9ic2VydmVyLmNvbSwgcmVsCiAg
IE15c3RlcnkgUGFwZXIg4oCTIEVwaXNvZGUgNCDigJMgVGhlIERlY29sb25pc2F0aW9uIFNob3cg
LCAvbW92aWVzL015c3RlcnkuUGFwZXIuUzAxLkUwNC5ta3YsIGVuY2xvc3VyZQogICBSZWNlbnQg
ZXBpc29kZTogIzQg4oCTIFRoZSBEZWNvbG9uaXNhdGlvbiBTaG93ICwgcmVjZW50LWVwaXNvZGUg
LCBtaWNyb3N1bW1hcnkKCkFzIHNlZW4sIHRoaXMgZG9lcyBub3QgYXBwZWFyIHRvIGFsbG93IG1l
IHRvIHNlbGVjdGl2ZWx5IGdlbmVyYXRlCk1ldGFsaW5rcywgc28gSSB3b3VsZCBoYXZlIHRvIGdl
bmVyYXRlIE1ldGFsaW5rcyB0byBhbGwgbG9jYWwgZmlsZXMsCkkgc3VwcG9zZS4gVGhpcyBpcyBm
aW5lLCB5ZXQgdGhpcyBpcyB3aGVuIEkgd291bGQgaGF2ZSB0byB1dGlsaXplIGEgbWVhbgp3aGlj
aCBiZSBleHRlcm5hbCB0byByU1QgKGUuZy4gVE9NTCkuCgoKUmVnYXJkcywKClNjaGltb24KCgpf
X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fXwpEb2N1dGlscy11
c2VycyBtYWlsaW5nIGxpc3QKRG9jdXRpbHMtdXNlcnNAbGlzdHMuc291cmNlZm9yZ2UubmV0Cmh0
dHBzOi8vbGlzdHMuc291cmNlZm9yZ2UubmV0L2xpc3RzL2xpc3RpbmZvL2RvY3V0aWxzLXVzZXJz
CgpQbGVhc2UgdXNlICJSZXBseSBBbGwiIHRvIHJlcGx5IHRvIHRoZSBsaXN0Lgo=