1 files changed, 81 insertions, 0 deletions
diff --git a/js/src/doc/lib/make-bibliography.sh b/js/src/doc/lib/make-bibliography.sh
new file mode 100755
index 000000000..33068ca9c
--- /dev/null
+++ b/js/src/doc/lib/make-bibliography.sh
@@ -0,0 +1,81 @@
+#!/usr/bin/env bash
+
+# Generate a Markdown bibliography file --- that is, definitions for
+# reference-style link labels --- from a documentation directory's
+# config.sh file.
+#
+# Usage:
+#   make-bibliography.sh [--mdn] CONFIG CITING-URL
+#
+# where:
+# - CONFIG is the name of the config.sh file to process; and
+# - CITING-URL is the absolute URL at which the document using these labels
+#   will appear. The links we output use URLs relative to CITING-URL to
+#   refer to the URLs given in CONFIG.
+#
+# If given the --mdn flag, generate links that are correct for files
+# as they appear in format.sh's OUTPUTDIR, not for publishing on MDN.
+
+set -eu
+
+mdn=false
+
+while true; do
+    case "${1-}" in
+        '--mdn')
+            mdn=true
+            shift
+            ;;
+        *)
+            break
+            ;;
+    esac
+done
+
+lib=$(dirname $0)
+config=$1
+citing=$2
+
+source "$lib/common.sh"
+
+source "$lib/dummy-config.sh"
+
+label() {
+    local label=$1; shift
+    local fragment=
+    case "$1" in
+        '#'*)
+            fragment=$1; shift
+            ;;
+    esac
+    local title=${1:+ \"$1\"}
+
+    citing_prefix=$(dirname "$citing")/
+    if $mdn; then
+        echo "[$label]: $(relative "$citing_prefix" "$BASE_URL$RELATIVE_URL")$fragment$title"
+    else
+        echo "[$label]: ${INPUT_FILE/md/html}$fragment$title"
+    fi
+}
+
+absolute-label() {
+    local label=$1
+    local absolute_url=$2
+    local title=$3
+
+    echo "[$label]: $absolute_url${title:+ \"$title\"}"
+}
+
+resource() {
+    local label=$1 file=$2 absolute_url=$3
+
+    if [ -n "$label" ]; then
+        if $mdn; then
+            echo "[$label]: $absolute_url"
+        else
+            echo "[$label]: $file"
+        fi
+    fi
+}
+
+source "$config"