Add support for extracting the tags into JSON

Author: Timmmm

.gitmodules

@@ -1,3 +1,3 @@
 [submodule "docs-resources"]
 	path = docs-resources
-	url = https://github.com/riscv/docs-resources
+	url = https://github.com/Timmmm/docs-resources

Makefile

@@ -93,12 +93,16 @@ BUILD_DIR := build
 DOCS_PDF := $(addprefix $(BUILD_DIR)/, $(addsuffix .pdf, $(DOCS)))
 DOCS_HTML := $(addprefix $(BUILD_DIR)/, $(addsuffix .html, $(DOCS)))
 DOCS_EPUB := $(addprefix $(BUILD_DIR)/, $(addsuffix .epub, $(DOCS)))
+DOCS_TAGS := $(addprefix $(BUILD_DIR)/, $(addsuffix .tags.json, $(DOCS)))
 
 ENV := LANG=C.utf8
 XTRA_ADOC_OPTS :=
+
 ASCIIDOCTOR_PDF := $(ENV) asciidoctor-pdf
 ASCIIDOCTOR_HTML := $(ENV) asciidoctor
 ASCIIDOCTOR_EPUB := $(ENV) asciidoctor-epub3
+ASCIIDOCTOR_TAGS := $(ENV) asciidoctor --backend tags --require=./docs-resources/converters/tags.rb
+
 OPTIONS := --trace \
            -a compress \
            -a mathematical-format=svg \
@@ -108,6 +112,7 @@ OPTIONS := --trace \
            -a revnumber='$(DATE)' \
            -a revremark='$(RELEASE_DESCRIPTION)' \
            -a docinfo=shared \
+           -a tags-prefix=qx_ \
            $(XTRA_ADOC_OPTS) \
            -D build \
            --failure-level=ERROR
@@ -116,7 +121,7 @@ REQUIRES := --require=asciidoctor-bibtex \
             --require=asciidoctor-lists \
             --require=asciidoctor-mathematical
 
-.PHONY: all build clean build-container build-no-container build-docs build-pdf build-html build-epub submodule-check
+.PHONY: all build clean build-container build-no-container build-docs build-pdf build-html build-epub build-tags submodule-check
 
 all: build
 
@@ -132,6 +137,7 @@ build-docs: $(DOCS_PDF) $(DOCS_HTML) $(DOCS_EPUB)
 build-pdf: $(DOCS_PDF)
 build-html: $(DOCS_HTML)
 build-epub: $(DOCS_EPUB)
+build-tags: $(DOCS_TAGS)
 
 ALL_SRCS := $(shell git ls-files $(SRC_DIR))
 
@@ -150,6 +156,11 @@ $(BUILD_DIR)/%.epub: $(SRC_DIR)/%.adoc $(ALL_SRCS)
 	$(DOCKER_CMD) $(DOCKER_QUOTE) $(ASCIIDOCTOR_EPUB) $(OPTIONS) $(REQUIRES) $< $(DOCKER_QUOTE)
 	$(WORKDIR_TEARDOWN)
 
+$(BUILD_DIR)/%.tags.json: $(SRC_DIR)/%.adoc $(ALL_SRCS) docs-resources/converters/tags.rb
+	$(WORKDIR_SETUP)
+	$(DOCKER_CMD) $(DOCKER_QUOTE) $(ASCIIDOCTOR_TAGS) $(OPTIONS) $(REQUIRES) $< $(DOCKER_QUOTE)
+	$(WORKDIR_TEARDOWN)
+
 build: submodule-check
 	@echo "Checking if Docker is available..."
 	@if command -v docker >/dev/null 2>&1 ; then \

docs-resources

@@ -11,7 +11,7 @@
   snippets via Asciidoc's docbook output and parsing the XML.
 * Linking documentation (e.g. the implementation defined parameter list)
   to the spec.
-  
+
 This adds a subtle decoration to make it easier to find tagged text.
 */
 [id^="qx_"]:hover {