Re: XLink as a solution for references
Schimon Jehudah via Docutils-users <[email protected]> Mon, 6 Oct 2025 14:44:21 +0300
| Newsgroups | gmane.text.docutils.user |
|---|---|
| Message-ID | <[email protected]> |
--MP_/Nt34zMLNase+/83jeq.W9ib Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Disposition: inline Greetings. I forgot to attach the reStructuredText file. Kindly, Schimon On Mon, 6 Oct 2025 14:40:08 +0300 Schimon Jehudah via Docutils-users <[email protected]> wrote: > Guenter. Good afternoon. >=20 > Thank you for this information. >=20 > I have wrote the use-case at the end of this message. >=20 > On Tue, 30 Sep 2025 09:20:07 -0000 (UTC) > Guenter Milde via Docutils-users > <[email protected]> wrote: >=20 > > Dear Schimon, > >=20 > > thank you for sharing your suggestions. > >=20 > > On 2025-09-28, Schimon Jehudah via Docutils-users wrote: > >=20 > > > This message is concerning to a feature which is not yet > > > implemented. =20 > >=20 > > > https://docutils.sourceforge.io/docs/ref/rst/directives.html#referenc= es > > > =20 > >=20 > > Mind, that the two unimplemented directives will only collect > > <footnote> or <citation> elements at one place. > > https://docutils.sourceforge.io/docs/dev/todo.html#footnote-citation-ga= thering > >=20 > > The reStructuredText syntax for `citation references`_ and > > `citations`_ can be used to write documents including a > > bibilography/references section or topic without need for a > > "citations" directive, e.g. :: > >=20 > > For details on brontosauruses, see [Elk:70]_. > > =20 > > References > > ---------- > > =20 > > .. [Elk:70] `My Theory on Brontosauruses`, > > Anne Elk, London, 1972. > >=20 > > ... > >=20 > > > XLink might be helpful for both, Atom and (X)HTML, in order to set > > > accurate links to references. =20 > >=20 > > The <citation> <citation_reference> and <footnote> > > <footnote_reference> Doctree elements already provide for a > > bi-directional cross-link via the refname, refid, and backrefs > > attributes. See > > https://docutils.sourceforge.io/docs/ref/doctree.html#refname and > > https://docutils.sourceforge.io/docs/ref/doctree.html#backrefs > >=20 > > The Docutils-XML output of the above example is:: > >=20 > > <!DOCTYPE document PUBLIC "+//IDN docutils.sourceforge.net//DTD > > Docutils Generic//EN//XML" > > "http://docutils.sourceforge.net/docs/ref/docutils.dtd"> <!-- > > Generated by Docutils 0.22.3b1.dev --> <document > > source=3D"/tmp/foo.rst"> <paragraph>For details on brontosauruses, see > > <citation_reference ids=3D"citation-reference-1" > > refid=3D"elk-70">Elk:70</citation_reference>.</paragraph> <section > > ids=3D"references" names=3D"references"> <title>References</title> > > <citation backrefs=3D"citation-reference-1" ids=3D"elk-70" > > names=3D"elk:70"> <label>Elk:70</label> <paragraph><title_reference>My > > Theory on Brontosauruses</title_reference>, Anne Elk, London, > > 1972.</paragraph> </citation> </section> > > </document> > >=20 > >=20 > > > That publishing system (Rivista Voyager) is purely made of XML and > > > XSLT, and it has no HTML nor XHTML files whatsoever; therefore I > > > deem it important to consider and utilize XLink as a practical > > > solution to XML, and (X)HTML. =20 > >=20 > > I am not sure what could be improved for the native Docutils-XML (or > > XHTML) output by using XLink syntax. >=20 > I am unsure also. I am currently contemplating the idea. >=20 > > Can you provide a **minimal** working example of what you want to > > achieve? > >=20 >=20 > Yes. I can. >=20 > I am working on a publication platform of which all produced documents > are XML (Atom Syndication Format), and these documents are transformed > to XHTML with XSLT stylesheets. >=20 > As this platform utilizes The Atom Syndication Format, there is > element "atom:link" which is almost identical to element "link" of > HTML. >=20 > The element "atom:link" is utilized to list related resources (i.e. > references) and attachments (i.e. enclosures). >=20 > I am interested to link to those links in a local fashion (i..e > utilizing the sign hash/number/pound (#), utilizing XSLT directives. >=20 > I have attached a reStructuredText file, a produced Atom file, and a > transformed HTML file, incliding an image of the section below the > content of an article. >=20 > If you are interested at the XSLT stylesheets, this is the link. >=20 > https://git.xmpp-it.net/sch/Rivista/src/branch/main/rivista/data/themes/v= ivista/xslt >=20 > > Thanks, > >=20 > > G=C3=BCnter > >=20 >=20 > Best, >=20 > Schimon --MP_/Nt34zMLNase+/83jeq.W9ib Content-Type: text/x-rst Content-Transfer-Encoding: quoted-printable Content-Disposition: attachment; filename=2004-09-09-trusted-computing-2004.rst .. authors: LAFKON Publishing ; mailto:[email protected] .. category: journal .. comments: true .. date: 2004-09-09 0:00:00 UTC .. description: This is a short animated video (3:30 minutes) about computers and trust. =E2=80=9CTrusted Computing=E2=80=9D - ever heard of it? This motion graphic style documentary explains what the term =E2=80=9Ctr= ust=E2=80=9D has in common with =E2=80=9CTrusted Computing=E2=80=9D and where you will meet = this so-called technology in the near future. Computers and Internet gave you freedom. TCPA is designed against freedo= m! It is crucial that you listen to it. .. enclosures: High quality ; magnet:?xt=3Durn:btih:7ea94c240691311dc0916a2a91eb7c3db2c= 6f3e4&dn=3Dtrusted-computing&xl=3D50834053 High quality ; ed2k://|file|TrustedComputing_LAFKON_HIGH.mov|50834053|68= D9B8032FCF0CA5A0515B65998F8376|p=3D60FB8D2997A845CF59958C82F64D6DDF:C840976= FCAE7E135822D2EC199C3FF07:370091DFCD81FE24CE9DB5E1E6B94A52:4458F2A40E2994BE= 223FB307F93E1EF3:B686A21D7E1A6A80E6C79377F812B81F:D6ECC86D9CE60973AD0189E5D= 5255075|h=3DRNVE65FIMBKLMFFKROVLP2ATPAUBBUO3|/|sources,84.155.16.23:4662|/ Medium quality ; ed2k://|file|TrustedComputing_LAFKON_MID.mov|25857760|2= 234D7B42350727F07B8B161C2E8D4B4|p=3D1BD783A917A7620B7A18709898512C55:23898C= C3088602C6E5A2411B987E3FB3:4EA88EDA1FA4CD82836AD96EAE3559EB|h=3DX36H2QQA4OB= 53C2IJQMGD5N4OGMDZHLK|/|sources,84.155.16.23:4662|/ Low quality ; ed2k://|file|trustedcomputing_lafkon_low.mov|6893165|de957= 39a5d295ccae0a65ea37d9fde30|h=3Dsibqxzrfa2azyr7spmh24ti5tvbtzi6h|/|sources,= 84.155.16.23:4662|/ More versions of this video ; https://ia800803.us.archive.org/23/items/T= rustedComputing/ .. link: 2004-09-09-trusted-computing-2004 .. related: 'Trusted Computing' Frequently Asked Questions ; https://www.cl.cam.ac.u= k/archive/rja14/tcpa-faq.html A movie about Trusted Computing. LAFKON. ; https://lafkon.net/tc/ Trusted Computing. LAFKON. ; https://lafkon.net/work/trustedcomputing/ About. LAFKON. ; https://lafkon.net/about/ Against TCPA ; http://againsttcpa.com .. slug: 2004-09-09-trusted-computing-2004 .. tags: control, computing, iot, lafkon, lagrande, longhorn, ngscb, owners= hip, palladium, privacy, security, surveillance, tc, tcg, tcpa, trust, trus= ted computing .. title: Trusted Computing (2004) .. type: text .. image:: https://lafkon.net/work/trustedcomputing.jpg :alt: Trusted Computing :loading: lazy :target: https://lafkon.net/work/trustedcomputing.jpg :width: 100% Computers and Internet gave you freedom. TCPA would TAKE your FREEDOM! .. raw:: html <video controls=3D"" poster=3D"https://ia800803.us.archive.org/23/items/TrustedComputing/Tr= ustedComputing_LAFKON_HIGH.gif" preload=3D"none" style=3D"width:100%;height:100%;"> <source src=3D"https://ia800803.us.archive.org/23/items/TrustedComputi= ng/TrustedComputing_LAFKON_HIGH_512kb.mp4"/> <source src=3D"https://ia800803.us.archive.org/23/items/TrustedComputi= ng/TrustedComputing_LAFKON_HIGH.mp4"/> <source src=3D"https://ia800803.us.archive.org/23/items/TrustedComputi= ng/TrustedComputing_LAFKON_HIGH.ogv"/> </video> `Trusted Computing (2004) video <https://ia800803.us.archive.org/23/items/T= rustedComputing/TrustedComputing_LAFKON_HIGH_512kb.mp4>`_ Please refer to the TORRENT and EDONKEY links at the end of this article. Transcript ---------- Trust. Trust is the personal belief in correctness of something; It is the deep conviction of truth and rightness, and cannot be enforced; If you gain someone's trust, you have established an interpersonal relation= ship, based on communication, shared values and experiences; Trust always depends on mutuality. This process has been reshaped by the computer industry; Now, a microchip does that task for you; The industry calls it: =E2=80=9CTrusted Computing=E2=80=9D; This chip will be in computers, notebooks, servers, PDAs, cell phones, game units, DVD players, set-top boxes, watches, mixers, steam irons, fridges, f= ire extinguishers, earplugs, toilets, dogs [...] game-units, and it will be in = your devices too. What has Trusted Computing to do with trust? Let us show you. In a Trusted Computing environment, the major goal is to protect us from potential threats; The original Trusted Computing idea is designed to let you decide what to consider as threat, and what to consider trustworthy; You can control by your own personal conviction. Trusted Computing. Sounds great. Doesn't it? The industry's interpretation of the Trusted Computing idea looks quite sim= ilar, aiming at the same, to fight threats and make computing trustworthy; The main difference is, that you cannot decide by your own what is trustwor= thy and what is not, because they already decided for you, and they already dec= ided not to trust you; So, if they don't trust you, why should you trust them? Trusted Computing. Sounds great. Is it? No more. People ------ Directed, animated and produced by `Lutz Vogel <http://lutzvogel.com>`_ and `Benjamin Stephan <http://lafkon.net>`_. Voiceover by Christian Hoening Sound by `Simon Mahler <http://fotone.net>`_ About ----- **Benjamin Stephan** studied graphic design and computer sciences at the Un= iversity of Applied Sciences Augsburg. **Christoph Haag** studied design at the Acad= emy of Media Arts Cologne / Department of Hybrid Space. Since 2001 they are working together as LAFKON Publishing, doing research, experimentation and and busi= ness commissioned design projects. Contact ------- LAFKON Publishing =C3=84u=C3=9Feres Pfaffeng=C3=A4=C3=9Fchen 30 86152 Augsburg =E2=80=93 Germany Phone `+49 821 8852255 <tel:+498218852255>`_ Mail `[email protected] <mailto:[email protected]>`_ .. epigraph:: The quest for creation not limited to the styling of surfaces has led to= a continous research on the application and bending of design technologies= as our access to visual form. -- LAFKON Publishing --MP_/Nt34zMLNase+/83jeq.W9ib Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline --MP_/Nt34zMLNase+/83jeq.W9ib Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline