manbytesgnu_site

commit 2f052574447f02fbf6e9a7810b813b67847f8b5b
parent 08bdbcc1c21b5425007d0b142ac0010f9cd71578
Author: lash <dev@holbrook.no>
Date:   Sat,  1 Oct 2022 14:09:18 +0000

Add better info on how to acquire kitab

Diffstat:
M
content/20221001_kitab_libgen.rst
 | 
14
+++++++++-----

1 file changed, 9 insertions(+), 5 deletions(-)
diff --git a/content/20221001_kitab_libgen.rst b/content/20221001_kitab_libgen.rst
@@ -11,7 +11,7 @@ A portable book metadata exercise
 :lang: en
 :status: published
 
-One of the things I have been working on the last few weeks is a rust application I have dubbed `kitab <https://git.defalsify.net/kitab>`_.
+One of the things I have been working on the last few weeks is a rust application I have dubbed `kitab <https://git.defalsify.net/kitab>`_ [1]_.
 
 In short, the application makes it easy to extract literary metadata to a separate file structure.
 
@@ -49,7 +49,7 @@ Kitab (v0.0.2) is able to read metadata from both a bibtex source and xattr entr
 
 In kitab's data store, every media file entity in rdf-turtle is keyed with a `URN <https://www.rfc-editor.org/info/rfc8141>`_ specifying a digest for the file. 
 
-To see exactly what that looks like, let's download and import the bibtex metadata for the paper [1]_:
+To see exactly what that looks like, let's download and import the bibtex metadata for the paper [2]_:
 
 .. code:: bash
 
@@ -112,7 +112,7 @@ Conversely, the metadata can be re-imported directly from the extended attribute
 Level up
 ========
 
-Finally, a bash script [2]_ example that lets you retrieve and apply metadata for a batch of files found in the directory given as the *first positional arg*.
+Finally, a bash script [3]_ example that lets you retrieve and apply metadata for a batch of files found in the directory given as the *first positional arg*.
 
 This script even renames the files according to the metadata applied.
 
@@ -128,8 +128,12 @@ This last example will result in:
 
 ..
 
-        .. [1] The :code:`kitab` command in the script assumes you have built the *kitab binary* and made it available in your path.
+        .. [1] The relevant documentation for :literal:`kitab` at the time of writing is `here <https://defalsify.org/doc/crates/kitab/0.0.2/kitab/>`_. To build kitab, simply *clone* the repository and build with :code:`cargo build --all-features`.
 
 ..
 
-        .. [2] the script uses :code:`xmllint` which on archlinux is provided by the :literal:`libxml2` package.
+        .. [2] The :code:`kitab` command in the script assumes you have built the *kitab binary* and made it available in your path.
+
+..
+
+        .. [3] the script uses :code:`xmllint` which on archlinux is provided by the :literal:`libxml2` package.