about summary refs log tree commit diff
path: root/doc/build-aux/pandoc-filters/docbook-writer/labelless-link-is-xref.lua
diff options
context:
space:
mode:
authorpennae <github@quasiparticle.net>2023-06-23 00:26:52 +0200
committerpennae <github@quasiparticle.net>2023-07-01 20:59:30 +0200
commitf397309f4e6c7a219a7703b629f6a4e8d4e7a58b (patch)
tree3e35e4bdd23c091c925f92e8fb227371559f8481 /doc/build-aux/pandoc-filters/docbook-writer/labelless-link-is-xref.lua
parentbe4d19ff1a9a327ae805fdb344470ed6450256fc (diff)
downloadnixlib-f397309f4e6c7a219a7703b629f6a4e8d4e7a58b.tar
nixlib-f397309f4e6c7a219a7703b629f6a4e8d4e7a58b.tar.gz
nixlib-f397309f4e6c7a219a7703b629f6a4e8d4e7a58b.tar.bz2
nixlib-f397309f4e6c7a219a7703b629f6a4e8d4e7a58b.tar.lz
nixlib-f397309f4e6c7a219a7703b629f6a4e8d4e7a58b.tar.xz
nixlib-f397309f4e6c7a219a7703b629f6a4e8d4e7a58b.tar.zst
nixlib-f397309f4e6c7a219a7703b629f6a4e8d4e7a58b.zip
doc: remove remnants of docbook times
all xml-related tooling can go away. shell.nix is no longer useful since
the makefile is gone and the build runs entirely via a derivation, and
gitignore is thus also no longer that useful. it may filter out some
swap files, but its main reason to exist (keeping generated files out of
a concurrent build of the derivation) has gone away.
Diffstat (limited to 'doc/build-aux/pandoc-filters/docbook-writer/labelless-link-is-xref.lua')
-rw-r--r--doc/build-aux/pandoc-filters/docbook-writer/labelless-link-is-xref.lua34
1 files changed, 0 insertions, 34 deletions
diff --git a/doc/build-aux/pandoc-filters/docbook-writer/labelless-link-is-xref.lua b/doc/build-aux/pandoc-filters/docbook-writer/labelless-link-is-xref.lua
deleted file mode 100644
index fa97729a28bc..000000000000
--- a/doc/build-aux/pandoc-filters/docbook-writer/labelless-link-is-xref.lua
+++ /dev/null
@@ -1,34 +0,0 @@
---[[
-Converts Link AST nodes with empty label to DocBook xref elements.
-
-This is a temporary script to be able use cross-references conveniently
-using syntax taken from MyST, while we still use docbook-xsl
-for generating the documentation.
-
-Reference: https://myst-parser.readthedocs.io/en/latest/using/syntax.html#targets-and-cross-referencing
-]]
-
-local function starts_with(start, str)
-  return str:sub(1, #start) == start
-end
-
-local function escape_xml_arg(arg)
-  amps = arg:gsub('&', '&amp;')
-  amps_quotes = amps:gsub('"', '&quot;')
-  amps_quotes_lt = amps_quotes:gsub('<', '&lt;')
-
-  return amps_quotes_lt
-end
-
-function Link(elem)
-  has_no_content = #elem.content == 0
-  targets_anchor = starts_with('#', elem.target)
-  has_no_attributes = elem.title == '' and elem.identifier == '' and #elem.classes == 0 and #elem.attributes == 0
-
-  if has_no_content and targets_anchor and has_no_attributes then
-    -- xref expects idref without the pound-sign
-    target_without_hash = elem.target:sub(2, #elem.target)
-
-    return pandoc.RawInline('docbook', '<xref linkend="' .. escape_xml_arg(target_without_hash) .. '" />')
-  end
-end