Re: XLink as a solution for references

Schimon Jehudah via Docutils-users <[email protected]> Wed, 8 Oct 2025 07:20:12 +0300
Newsgroups gmane.text.docutils.user
Message-ID <[email protected]>
R3VlbnRlci4gR29vZCBkYXkuCgpPbiBUdWUsIDcgT2N0IDIwMjUgMjA6MTM6MjMgLTAwMDAgKFVU
QykKR3VlbnRlciBNaWxkZSB2aWEgRG9jdXRpbHMtdXNlcnMgPGRvY3V0aWxzLXVzZXJzQGxpc3Rz
LnNvdXJjZWZvcmdlLm5ldD4Kd3JvdGU6Cgo+IE9uIDIwMjUtMTAtMDYsIFNjaGltb24gSmVodWRh
aCB2aWEgRG9jdXRpbHMtdXNlcnMgd3JvdGU6Cj4gCj4gPiBJIGZvcmdvdCB0byBhdHRhY2ggdGhl
IHJlU3RydWN0dXJlZFRleHQgZmlsZS4gIAo+IC4uLgo+IAo+ID4gLi4gYXV0aG9yczogTEFGS09O
IFB1Ymxpc2hpbmcgOyBtYWlsdG86aGFsbG9AbGFma29uLm5ldAo+ID4gLi4gY2F0ZWdvcnk6IGpv
dXJuYWwKPiA+IC4uIGNvbW1lbnRzOiB0cnVlCj4gPiAuLiBkYXRlOiAyMDA0LTA5LTA5IDA6MDA6
MDAgVVRDICAKPiAKPiAuLi4KPiAKPiBUaGVyZSBhcmUgYWN0dWFsbHkgMiB3YXlzIHRvIHNwZWNp
ZnkgbWV0YS1kYXRhIGluIHJTVCwgc28geW91IGRvbid0Cj4gbmVlZCB0byByZXNvcnQgdG8gY29t
bWVudHM6Cj4gCj4gYSkgYmlibGlvZ3JhcGhpYyBmaWVsZHMgKGZvciAidmlzaWJsZSIgbWV0YWRh
dGEpCj4gICAgaHR0cHM6Ly9kb2N1dGlscy5zb3VyY2Vmb3JnZS5pby9kb2NzL3JlZi9yc3QvcmVz
dHJ1Y3R1cmVkdGV4dC5odG1sI2JpYmxpb2dyYXBoaWMtZmllbGRzCj4gCj4gICAgQSAidmlzaWJs
ZSIgZG9jdW1lbnQgc3RhcnQgY291bGQgbG9vayBsaWtlOjoKPiAKPiAgICAgIGEgc2hvcnQgYW5p
bWF0ZWQgdmlkZW8gYWJvdXQgY29tcHV0ZXJzIGFuZCB0cnVzdAo+ICAgICAgLS0tLS0tLS0tLS0t
LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tCj4gICAgICAKPiAgICAgIDphdXRo
b3I6IExBRktPTiBQdWJsaXNoaW5nIDxoYWxsb0BsYWZrb24ubmV0Pgo+ICAgICAgOmF1dGhvcjog
YExBRktPTiBQdWJsaXNoaW5nIDxtYWlsdG86aGFsbG9AbGFma29uLm5ldD5gX18KPiAgICAgIDph
YnN0cmFjdDoKPiAgICAgICAgIFRoaXMgaXMgYSBzaG9ydCBhbmltYXRlZCB2aWRlbyAoMzozMCBt
aW51dGVzKSBhYm91dCBjb21wdXRlcnMKPiBhbmQgdHJ1c3QuIOKAnFRydXN0ZWQgQ29tcHV0aW5n
4oCdIC0gZXZlciBoZWFyZCBvZiBpdD8KPiAgICAgICAgIFRoaXMgbW90aW9uIGdyYXBoaWMgc3R5
bGUgZG9jdW1lbnRhcnkgZXhwbGFpbnMgd2hhdCB0aGUgdGVybQo+IOKAnHRydXN04oCdIGhhcyBp
biBjb21tb24gd2l0aCDigJxUcnVzdGVkIENvbXB1dGluZ+KAnSBhbmQgd2hlcmUgeW91IHdpbGwK
PiBtZWV0IHRoaXMgc28tY2FsbGVkIHRlY2hub2xvZ3kgaW4gdGhlIG5lYXIgZnV0dXJlLgo+ICAg
ICAgICAgQ29tcHV0ZXJzIGFuZCBJbnRlcm5ldCBnYXZlIHlvdSBmcmVlZG9tLiBUQ1BBIGlzIGRl
c2lnbmVkCj4gYWdhaW5zdCBmcmVlZG9tISBJdCBpcyBjcnVjaWFsIHRoYXQgeW91IGxpc3RlbiB0
byBpdC4KPiAgICAgIAo+ICAgICAgOmRhdGU6IDIwMDQtMDktMDkgMDowMDowMCBVVEMKPiAgICAg
IDpzbHVnOiAyMDA0LTA5LTA5LXRydXN0ZWQtY29tcHV0aW5nLTIwMDQKPiAgICAgIDp0YWdzOiBj
b250cm9sLCBjb21wdXRpbmcsIGlvdCwgbGFma29uLCBsYWdyYW5kZSwgCj4gICAgICA6dHlwZTog
dGV4dAo+IAoKVGhpcyBpcyBpbnRlcmVzdGluZywgYW5kIGl0IG1pZ2h0IGJlIGhlbHBmdWwgdG8g
bWUuIFRoYW5rIHlvdS4KCj4gYikgdGhlICJtZXRhIiBkaXJlY3RpdmUgKGZvciAiaW52aXNpYmxl
IiBtZXRhZGF0YSkKPiAgICBodHRwczovL2RvY3V0aWxzLnNvdXJjZWZvcmdlLmlvL2RvY3MvcmVm
L3JzdC9kaXJlY3RpdmVzLmh0bWwjbWV0YWRhdGEKPiAKPiAgICBFeGFtcGxlOjoKPiAgICAKPiAg
ICAgIC4uIG1ldGE6Ogo+ICAgICAgICAgOmF1dGhvcnM6IExBRktPTiBQdWJsaXNoaW5nIDxtYWls
dG86aGFsbG9AbGFma29uLm5ldD4KPiAgICAgICAgIDpjYXRlZ29yeTogam91cm5hbAo+ICAgICAg
ICAgOmNvbW1lbnRzOiB0cnVlCj4gICAgICAgICA6ZGF0ZTogMjAwNC0wOS0wOSAwOjAwOjAwIFVU
Qwo+ICAgICAgICAgOmRlc2NyaXB0aW9uOgo+ICAgICAgICAgOnNsdWc6IDIwMDQtMDktMDktdHJ1
c3RlZC1jb21wdXRpbmctMjAwNAo+ICAgICAgICAgOnRhZ3M6IGNvbnRyb2wsIGNvbXB1dGluZywg
aW90LCBsYWZrb24sIGxhZ3JhbmRlLCAKPiAgICAgICAgIDp0eXBlOiB0ZXh0Cj4gCj4gQm90aCBj
YW4gYmUgY29tYmluZWQuCj4gCgpJIGRpZCBub3Qga25vdyBvZiBpdDsgeWV0LCB0aGF0IGlzIHBy
b2JhYmx5IG5vdCB1c2VmdWwgZm9yIHByb2plY3QKUml2aXN0YSBWb3lhZ2VyLCBiZWNhdXNlIGl0
IHN0b3JlcyBtZXRhZGF0YSByZWZlcmVuY2VzIGluIEF0b20KU3luZGljYXRpb24gRm9ybWF0IGVs
ZW1lbnRzLCBhbmQgWFNMVCBpcyB0aGUgb25seSBtZWFuIHRvIHRyYW5zZm9ybQpBdG9tIFN5bmRp
Y2F0aW9uIEZvcm1hdCB0byBYSFRNTC4KClRhZ3MgYXJlIHBsYWNlZCBpbnNpZGUgZWxlbWVudCAi
YXRvbTpjYXRlZ29yeSIsIGFuZCBYU0xUIHN0eWxlc2hlZXQKZXh0cmFjdHMgdmFsdWVzIG9mICJh
dG9tImNhdGVnb3JpZXMiIHRvIChYKUhUTUwgbWV0YWRhdGEuCgo8eHNsOmlmIHRlc3Q9ImF0b206
Y2F0ZWdvcnkiPgogIDx4c2w6ZWxlbWVudCBuYW1lPSJtZXRhIj4KICAgIDx4c2w6YXR0cmlidXRl
IG5hbWU9Im5hbWUiPgogICAgICA8eHNsOnRleHQ+a2V5d29yZHM8L3hzbDp0ZXh0PgogICAgPC94
c2w6YXR0cmlidXRlPgogICAgPHhzbDphdHRyaWJ1dGUgbmFtZT0iY29udGVudCI+CiAgICAgIDx4
c2w6Zm9yLWVhY2ggc2VsZWN0PSJhdG9tOmNhdGVnb3J5Ij4KICAgICAgICA8eHNsOnZhbHVlLW9m
IHNlbGVjdD0iQHRlcm0iLz4KICAgICAgICA8eHNsOnRleHQ+LCA8L3hzbDp0ZXh0PgogICAgICA8
L3hzbDpmb3ItZWFjaD4KICAgIDwveHNsOmF0dHJpYnV0ZT4KICA8L3hzbDplbGVtZW50Pgo8L3hz
bDppZj4KClZpZXcgdGhlIHNvdXJjZSBjb2RlIG9mIHRoZXNlIGRvY3VtZW50cyAoWE1MIGFuZCBI
VE1MKS4KClRoaXMgaXMgQXRvbSAoWFNMVDogY2xpZW50LXNpZGUpCmh0dHBzOi8vam91cm5hbC53
b29kcGVja2Vyc25lc3QuZXUvcG9zdHMvMjAwNC0wOS0wOS10cnVzdGVkLWNvbXB1dGluZy0yMDA0
L2luZGV4LmF0b20KClRoaXMgaXMgSFRNTCAoWFNMVDogc2VydmVyLXNpZGUpCmh0dHBzOi8vam91
cm5hbC53b29kcGVja2Vyc25lc3QuZXUvcG9zdHMvMjAwNC0wOS0wOS10cnVzdGVkLWNvbXB1dGlu
Zy0yMDA0L2luZGV4Lmh0bWwKCkFkZGl0aW9uYWxseSwgYXMgZWxlbWVudCAiYXRvbTpjYXRlZ29y
eSIgcHJvdmlkZXMgYXR0cmlidXRlICJsYWJlbCIsCnRoZSByZVN0cnVjdHVyZWRUZXh0IHRhZ3Mg
ZmllbGQgd2lsbCBiZSBkZXNpZ25lZCBhcy4KCi4uIHRhZ3M6CiAgIEJpdFRvcnJlbnQgOyBiaXR0
b3JyZW50CiAgIGVEb25rZXkyMDAwIDsgZWQyawogICBHbnV0ZWxsYSA7IGdudXRlbGxhCiAgIElQ
RlMgOyBpcGZzCiAgIExpbnV4IDsgbGludXgKICAgTVVURTsgbXV0ZQogICBSZWFjdE9TIDsgcmVh
Y3RvcwoKQ29uY2VybmluZyB0byBmaWVsZCAiYXV0aG9ycyI7IEkgaGF2ZSBkZWxpYmVyYXRlbHkg
YWRkZWQgc2VtaWNvbG9uIGFzCml0IGl0IGVhc2llciB0byAic3BsaXQiIHRpdGxlIGZyb20gYWRk
cmVzcy4KCi4uIGF1dGhvcnM6IExBRktPTiBQdWJsaXNoaW5nIDsgbWFpbHRvOmhhbGxvQGxhZmtv
bi5uZXQKCj4gLi4uCj4gCj4gPiAuLiB0aXRsZTogVHJ1c3RlZCBDb21wdXRpbmcgKDIwMDQpICAK
PiAKPiBCZXNpZGVzIHRoZSAidmlzaWJsZSIgdGl0bGUgKHZpYSBmaXJzdCBzZWN0aW9uKQo+IGh0
dHBzOi8vZG9jdXRpbHMuc291cmNlZm9yZ2UuaW8vZG9jcy9yZWYvcnN0L3Jlc3RydWN0dXJlZHRl
eHQuaHRtbCNkb2N1bWVudC10aXRsZQo+IHRoZXJlIGlzIGFsc28gdGhlICJpbnZpc2libGUiIHRp
dGxlIHZpYSBkaXJlY3RpdmU6Cj4gaHR0cHM6Ly9kb2N1dGlscy5zb3VyY2Vmb3JnZS5pby9kb2Nz
L3JlZi9yc3QvZGlyZWN0aXZlcy5odG1sI21ldGFkYXRhLWRvY3VtZW50LXRpdGxlCj4gCgpJIGRp
ZCBub3Qga25vdyBvZiBpdC4gSSB3aWxsIGV4cGxvcmUgdGhpcyBjb25jZXJuLgoKPiAuLi4KPiAK
PiA+IC4uIGltYWdlOjogaHR0cHM6Ly9sYWZrb24ubmV0L3dvcmsvdHJ1c3RlZGNvbXB1dGluZy5q
cGcKPiA+ICAgIDphbHQ6IFRydXN0ZWQgQ29tcHV0aW5nCj4gPiAgICA6bG9hZGluZzogbGF6eQo+
ID4gICAgOnRhcmdldDogaHR0cHM6Ly9sYWZrb24ubmV0L3dvcmsvdHJ1c3RlZGNvbXB1dGluZy5q
cGcKPiA+ICAgIDp3aWR0aDogMTAwJSAgCj4gCj4gVGhlICJ0YXJnZXQiIG9wdGlvbiBpcyBpbnRl
bmRlZCBmb3IgY2FzZXMgd2hlcmUgeW91IHdhbnQgdG8gdXNlIGFuCj4gaW1hZ2UgYXMgbGluayBs
aWtlOjoKPiAKPiAgICAuLiBpbWFnZTo6IHJlc3RydWN0dXJlZHRleHQuc3ZnCj4gICAgICAgOmFs
dDogcmVTdHJ1Y3R1cmVkVGV4dAo+ICAgICAgIDp0YXJnZXQ6IGh0dHBzOi8vZG9jdXRpbHMuc291
cmNlZm9yZ2UuaW8vcnN0Lmh0bWwKPiAgICAgICAKClllcy4gSSBkaWQgc28gZm9yIEcyRE4gaHR0
cHM6Ly9nMi5kb3h1Lm9yZwoKaHR0cHM6Ly9qb3VybmFsLndvb2RwZWNrZXJzbmVzdC5ldS9wb3N0
cy8yMDI2LTAxLTAxLWdudXRlbGxhMi1hbmQtaW50ZXJuZXQtcHVibGljYXRpb25zLwoKaHR0cHM6
Ly9naXQueG1wcC1pdC5uZXQvc2NoL1JpdmlzdGEvc3JjL2JyYW5jaC9tYWluL3JpdmlzdGEvZGF0
YS9wYWdlcy9wb3N0cy8yMDI2LTAxLTAxLWdudXRlbGxhMi1hbmQtaW50ZXJuZXQtcHVibGljYXRp
b25zLnJzdAoKPiBZb3UgbWF5IGFsc28gdXNlIGl0IHRvIGdldCBhIHN0YW5kYWxvbmUgaW1hZ2Ug
b3IgYW4gaW1hZ2UgZnJvbSBhCj4gdGh1bWJuYWlsIEluIG1vc3QgY2FzZXMsIHRoZXJlIGlzIG5v
IG5lZWQgdG8gcmVwZWF0IHRoZSBpbWFnZSBVUkkgYXMKPiAidGFyZ2V0Ii4KPiAKClRoYW5rIHlv
dS4gSSBpbnRlbmQgdG8gZG8gdGhpcy4KCj4gLi4uCj4gCj4gPiBNYWlsIGBoYWxsb0BsYWZrb24u
bmV0IDxtYWlsdG86aGFsbG9AbGFma29uLm5ldD5gXyAgCj4gCj4gVGhpcyBjb3VsZCBiZSBzaW1w
bGlmaWVkLCBhcyBEb2N1dGlscyByZWNvZ25pemVzIGUtbWFpbCBhZGRyZXNzZXMgYXMKPiBzdGFu
ZGFsb25lIGh5cGVybGlua3MgKHRoZSB0ZWxlcGhvbmUgbWF5IGFsc28gYmUgc2ltcGxpZmllZCBp
ZiB5b3UKPiBhY2NlcHQgYSBzbGlnaHRseSBkaWZmZXJlbnQgbGluayB0ZXh0KS4KPiBodHRwczov
L2RvY3V0aWxzLnNvdXJjZWZvcmdlLmlvL2RvY3MvcmVmL3JzdC9yZXN0cnVjdHVyZWR0ZXh0Lmh0
bWwjc3RhbmRhbG9uZS1oeXBlcmxpbmtzCj4gCgpJIGFtIG5vdCBzdXJlIHdoeSB5b3Ugd3JvdGUg
aXQsIHNvIEkgaG9wZSB0aGF0IEkgYW5zd2VyIHRvIHRoZSBjb3JyZWN0CmNvbnRleHQuCgpGb3Ig
bW9zdCBsaW5rcywgSSByZXNvcnQgdG8gZWxlbWVudCAiYXRvbTpsaW5rIiB3aGljaCBpcyBoYW5k
bGVkIGJ5IHRoZQpzb2Z0d2FyZSB3aGljaCBoYW5kbGVzIEF0b20gU3luZGljYXRpb24gRm9ybWF0
IGRvY3VtZW50czsgaW4gdGhpcyBjYXNlLAp0aGUgWFNMVCBzdHlsZXNoZWV0IGlzIGEgc29mdHdh
cmUgd2hpY2ggaGFuZGxlcyB0aG9zZSBsaW5rcyBmb3IgbWUuCgpJIGRpZCBzbyB3aXRoIEh5cGVy
Y29yZSBhbmQgSVBGUyBVUklzLgoKaHR0cHM6Ly9qb3VybmFsLndvb2RwZWNrZXJzbmVzdC5ldS9o
ZWxwL2dlbWluaS8KCmh0dHBzOi8vZ2l0LnhtcHAtaXQubmV0L3NjaC9SaXZpc3RhL3NyYy9icmFu
Y2gvbWFpbi9yaXZpc3RhL2RhdGEvcGFnZXMvaGVscC9nZW1pbmkucnN0CgpJIGZ1cnRoZXIgdXRp
bGl6ZSB0aGF0IHN5bnRheCBpbiB0aGUgY29udGVudCBvZiBhIGRvY3VtZW50LCB5ZXQgSSBhbQps
ZXNzZXIgZm9uZCBvZiB0aGF0IGxpbmtpbmcgc3ludGF4LCBhbmQgSSB3b3VsZCBiZSBnbGFkIHRv
IGhhdmUgYW4KYWRkaXRpb25hbCBkaXJlY3RpdmUgZm9yIGxpbmtzLgoKQW5kIGNvbnNpZGVyaW5n
IFhMaW5rLCBJIHdvdWxkIGJlIGdsYWQgdG8gaGF2ZSBzb21ldGhpbmcgb2YgdGhpcyBzb3J0LApl
dmVuIGlmIFhMaW5rIHdhcyBub3QgYSBjb25jZXJuLgoKLi4gbGluazo6IGVkMms6Ly98ZmlsZXxU
cnVzdGVkQ29tcHV0aW5nX0xBRktPTl9ISUdILm1vdnw1MDgzNDA1M3w2OEQ5QjgwMzJGQ0YwQ0E1
QTA1MTVCNjU5OThGODM3NnwvCjp0ZXh0OiBUcnVzdGVkQ29tcHV0aW5nX0xBRktPTl9ISUdILm1v
dgogICA6aWQ6IHRydXN0ZWQtY29tcHV0aW5nLWxpbmsKICAgOmNsYXNzOiBlZDJrLWxpbmsKICAg
OnhsaW5rOiBlZDJrLXRydXN0ZWQtY29tcHV0aW5nCgo+IAo+IEfDvG50ZXIKPiAKPiAKClJlZ2Fy
ZHMsCgpTY2hpbW9uCgoKX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f
X19fX18KRG9jdXRpbHMtdXNlcnMgbWFpbGluZyBsaXN0CkRvY3V0aWxzLXVzZXJzQGxpc3RzLnNv
dXJjZWZvcmdlLm5ldApodHRwczovL2xpc3RzLnNvdXJjZWZvcmdlLm5ldC9saXN0cy9saXN0aW5m
by9kb2N1dGlscy11c2VycwoKUGxlYXNlIHVzZSAiUmVwbHkgQWxsIiB0byByZXBseSB0byB0aGUg
bGlzdC4K