docs(zh96): PG 9.6 中文文档翻译程序（50 commits，974 页 HTML）

bin/build_standalone_docsrc.sh

@@ -313,6 +313,16 @@ if [[ "${lang}" != "en" ]]; then
     "${work_tree}/doc/src/sgml/Makefile"
 fi
 
+# Pre-PG10 doc makefiles build HTML via DSSSL (jade) by default.  Reroute the
+# html target to the XSL pipeline (xslthtml-stamp, osx -> postgres.xml ->
+# xsltproc chunked HTML) that those makefiles already provide, matching what
+# PG10+ do natively.  The guard is a no-op for PG10 and later.
+if grep -q '^xslthtml-stamp:' "${work_tree}/doc/src/sgml/Makefile"; then
+  sed -i.bak \
+    -e 's/^html: html-stamp$/html: xslthtml-stamp/' \
+    "${work_tree}/doc/src/sgml/Makefile"
+fi
+
 # Incremental generated-text overlays are kept with each Chinese source.
 # Generate from the selected upstream inputs before applying exact-hash edits.
 if [[ "${lang}" == "zh" && -f "${doc_src_root}/localize-generated.py" ]]; then

zh/9.6/.gitignore

@@ -0,0 +1,24 @@
+# Stuff shipped in tarballs
+/html/
+/html-stamp
+/man1/
+/man3/
+/man7/
+/man-stamp
+# Other popular build targets
+/INSTALL
+/postgres-US.pdf
+/postgres-A4.pdf
+/postgres.html
+/postgres.txt
+# GENERATED_SGML
+/features-supported.sgml
+/features-unsupported.sgml
+/errcodes-table.sgml
+/version.sgml
+# Assorted byproducts from building the above
+/postgres.xml
+/INSTALL.html
+/INSTALL.xml
+/postgres-US.fo
+/postgres-A4.fo

zh/9.6/Makefile

@@ -0,0 +1,78 @@
+# zh/9.6/Makefile
+
+REPO_ROOT := $(abspath $(CURDIR)/../..)
+DOC_VERSION := $(notdir $(CURDIR))
+PG_VERSION ?= 9.6.24
+# Official 9.6.24 release package, checksum pinned from en/SOURCES.json.
+PGDOC_SOURCE_ARCHIVE ?= $(REPO_ROOT)/.cache/upstream/postgresql-9.6.24.tar.bz2
+PGDOC_SOURCE_SHA256 ?= aeb7a196be3ebed1a7476ef565f39722187c108dd47da7489be9c4fcae982ace
+export PGDOC_SOURCE_ARCHIVE PGDOC_SOURCE_SHA256
+# PG9.x uses DocBook SGML 4.2 and OpenSP; its doc makefile defaults html to
+# DSSSL/jade, so build_standalone_docsrc.sh reroutes html to the XSL pipeline.
+PGDOC_SGML_DEPS := $(REPO_ROOT)/tmp/pg10-13-from-14/20260909-150220/agents/archive_build/deps
+OSX ?= $(PGDOC_SGML_DEPS)/bin/osx
+NSGMLS ?= $(PGDOC_SGML_DEPS)/bin/onsgmls
+SGML_CATALOG_FILES ?= $(PGDOC_SGML_DEPS)/sgml-unicode.catalog
+SP_ENCODING ?= UTF-8
+SP_CHARSET_FIXED ?= YES
+export OSX NSGMLS SGML_CATALOG_FILES SP_ENCODING SP_CHARSET_FIXED
+DOC_LANG := $(notdir $(abspath $(CURDIR)/..))
+
+BUILD_SCRIPT := $(REPO_ROOT)/bin/build_standalone_docsrc.sh
+PDF_SCRIPT := $(REPO_ROOT)/bin/build_standalone_pdfsrc.sh
+DEFAULT_BUILD_OUT := $(CURDIR)/html
+BUILD_OUT ?= $(DEFAULT_BUILD_OUT)
+PAPER ?= A4
+PDF_OUT ?= $(REPO_ROOT)/tmp/pdf/$(DOC_LANG)/postgresql-$(DOC_VERSION)-$(DOC_LANG)-$(PAPER).pdf
+PYTHON ?= python3
+HOST ?= 127.0.0.1
+PORT ?= 8000
+
+# Files generated during build (not checked into repo)
+GENERATED_FILES := version.sgml pgdoccn-notes.sgml postgres-full.xml
+
+.PHONY: all html pdf clean clean-pdf distclean s serve check-deps show-config
+
+all: html
+
+html:
+	@"$(BUILD_SCRIPT)" "$(CURDIR)" "$(DOC_LANG)" "$(PG_VERSION)" "$(BUILD_OUT)"
+
+pdf:
+	@"$(PDF_SCRIPT)" "$(CURDIR)" "$(DOC_LANG)" "$(PG_VERSION)" "$(PDF_OUT)" "$(PAPER)"
+
+distclean: clean clean-pdf
+
+s: serve
+serve:
+	@echo "Serving $(BUILD_OUT) at http://$(HOST):$(PORT)/"
+	@cd "$(BUILD_OUT)" && "$(PYTHON)" -m http.server "$(PORT)" --bind "$(HOST)"
+
+c: clean
+clean:
+	rm -rf "$(BUILD_OUT)"
+
+clean-pdf:
+	rm -f "$(PDF_OUT)"
+
+check-deps:
+	@echo "Checking build dependencies ..."
+	@command -v xmllint  >/dev/null 2>&1 || { echo "MISSING: xmllint  (brew install libxml2)"; exit 1; }
+	@command -v xsltproc >/dev/null 2>&1 || { echo "MISSING: xsltproc (brew install libxslt)"; exit 1; }
+	@command -v rsync    >/dev/null 2>&1 || { echo "MISSING: rsync"; exit 1; }
+	@command -v java     >/dev/null 2>&1 || { echo "MISSING: java"; exit 1; }
+	@command -v fc-match >/dev/null 2>&1 || { echo "MISSING: fc-match (brew install fontconfig)"; exit 1; }
+	@echo "All dependencies found."
+
+show-config:
+	@echo "doc_dir=$(CURDIR)"
+	@echo "lang=$(DOC_LANG)"
+	@echo "version=$(DOC_VERSION)"
+	@echo "pg_version=$(PG_VERSION)"
+	@echo "pgdoc_source_archive=$(PGDOC_SOURCE_ARCHIVE)"
+	@echo "pgdoc_source_sha256=$(PGDOC_SOURCE_SHA256)"
+	@echo "build_out=$(BUILD_OUT)"
+	@echo "pdf_out=$(PDF_OUT)"
+	@echo "paper=$(PAPER)"
+	@echo "host=$(HOST)"
+	@echo "port=$(PORT)"

zh/9.6/README.links

@@ -0,0 +1,46 @@
+<!-- doc/src/sgml/README.links -->
+
+Linking within SGML documents can be confusing, so here is a summary:
+
+
+Intra-document Linking
+----------------------
+
+<xref>
+	use to get chapter/section number from the title of the target
+	link, or xreflabel if defined at the target, or refentrytitle if target
+        is a refentry;  has no close tag
+	http://www.oasis-open.org/docbook/documentation/reference/html/xref.html
+
+<link>
+	use to supply text for the link, requires </link>
+	http://www.oasis-open.org/docbook/documentation/reference/html/link.html
+
+linkend=
+	controls the target of the link/xref, required
+
+endterm=
+	for <xref>, allows the text of the link/xref to be taken from a
+	different link target title
+
+
+External Linking
+----------------
+
+<ulink>
+	like <link>, but uses a URL (not a document target);  requires
+	</ulink>; if no text is specified, the URL appears as the link
+	text
+	http://www.oasis-open.org/docbook/documentation/reference/html/ulink.html
+
+url=
+	used by <ulink> to specify the URL, required
+
+
+Guidelines
+----------
+
+o  If you want to supply text, use <link>, else <xref>
+o  Do not use text with <ulink> so the URL appears in printed output
+o  Specific nouns like GUC variables, SQL commands, and contrib modules
+   usually have xreflabels