← 09. Test Site: node20.v4.sohophp.app11. Docs Auto Publish: publish-docs-site →返回首页
源文件：10-docs-site-docs.v4.sohophp.app.md

# 10. Docs Site: docs.v4.sohophp.app

This document records the live documentation site built from the Node toolkit.

# Site identity

  • domain: docs.v4.sohophp.app
  • Node version: 22
  • selected port: 22102
  • repo: /srv/git/docs.v4.sohophp.app
  • site root: /var/www/node22/docs.v4.sohophp.app
  • service: node-site@docs.v4.sohophp.app.service
  • provisioning path: create-node-site + custom docs app repo

# Files

  • env metadata: /etc/node-sites/docs.v4.sohophp.app.env
  • nginx vhost: /etc/nginx/conf.d/docs.v4.sohophp.app.conf
  • shared env: /var/www/node22/docs.v4.sohophp.app/shared/.env.local
  • cert live path: /etc/letsencrypt/live/docs.v4.sohophp.app/

# App behavior

The site renders toolkit docs from the exported directory and provides direct downloads for migration artifacts.

# Main routes

Route Purpose
/ docs homepage with navigation cards
/search?q=keyword server-side search results
/doc/<filename>.md rendered markdown page
/download/node-cicd-toolkit.tar.gz bundle download
/download/node-cicd-toolkit.sha256 checksum file
/download/manifest.txt manifest file
/healthz runtime health endpoint

# Enhanced UI features

  • client-side nav search box on every page
  • heading anchors and generated table of contents on doc pages
  • markdown table rendering
  • blockquote rendering
  • horizontal rule rendering
  • previous/next document navigation
  • richer homepage cards with snippets

# Verified behavior

The site has been verified to return:

  • Node version v22.22.3
  • docs count 12
  • toolkit root /usr/local/share/sohophp/node-cicd
  • features list including search, anchors, toc, tables
  • HTTPS homepage content
  • rendered README doc page
  • downloadable checksum and manifest

# Example validation commands


curl -fsS https://docs.v4.sohophp.app/


curl -fsS 'https://docs.v4.sohophp.app/search?q=publish'


curl -fsS https://docs.v4.sohophp.app/doc/README.md


curl -fsS https://docs.v4.sohophp.app/download/node-cicd-toolkit.sha256


curl -fsS https://docs.v4.sohophp.app/download/manifest.txt


curl -fsS http://127.0.0.1:22102/healthz

# Why this site matters

It provides a human-readable front-end for the exported Node CI/CD toolkit so future maintenance and VPS migration no longer require shell-only browsing of the docs directory.

目录