Merge branch 'main' into main

Author: akifmt

.github/workflows/smoke.yaml

@@ -1,5 +1,6 @@
 # Smoke test across OSs: build a Docsy-based site from scratch,
 # using Docsy as hugo module and fetching Docsy via NPM.
+# cSpell:ignore docsy github
 
 name: smoke
 
@@ -29,22 +30,35 @@ jobs:
     if: github.event_name != 'push' || github.repository == 'google/docsy'
     steps:
       - uses: actions/checkout@v4
+
       - uses: actions/setup-node@v4
         with:
           node-version-file: .nvmrc
           cache: npm
           cache-dependency-path: package.json
-      - run: tools/install-hugo.sh
+
+      - name: Setup workspace
+        run: |
+          npm install
+          mkdir -p tmp && cd tmp && npm init -y
         shell: bash
+
       - name: Make site (non-PR)
         if: github.event_name != 'pull_request'
-        run: |
-          mkdir tmp && cd tmp && set -x
-          ../tools/make-site.sh -s ${{ matrix.docsy-src }} -r $BASE_REPO -v $SHA
+        working-directory: tmp
+        run: ../scripts/make-site.sh -s ${{ matrix.docsy-src }} -r $BASE_REPO -v $SHA
         shell: bash
+
       - name: Make site from PR
         if: github.event_name == 'pull_request'
-        run: |
-          mkdir tmp && cd tmp && set -x
-          ../tools/make-site.sh -s ${{ matrix.docsy-src }} -r $PR_REPO -v $BRANCH
+        working-directory: tmp
+        run: ../scripts/make-site.sh -s ${{ matrix.docsy-src }} -r $PR_REPO -v $BRANCH
         shell: bash
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: tmp-site-${{ matrix.os }}-${{ matrix.docsy-src }}
+          path: |
+            tmp
+            !**/node_modules
+            !**/resources

.github/workflows/test.yaml

@@ -1,4 +1,5 @@
-# Build Docsy & the User Guide and run all repo checks across OSs.
+# Build Docsy & the website and run all repo checks across OSs.
+# cSpell:ignore docsy
 
 name: test
 
@@ -19,13 +20,23 @@ jobs:
         os: [windows-latest, ubuntu-latest]
     steps:
       - uses: actions/checkout@v4
+
       - uses: actions/setup-node@v4
         with:
           node-version-file: .nvmrc
           cache: npm
           cache-dependency-path: package.json
+
       - run: npm install --omit=optional
+
       - if: runner.os != 'Windows'
-        run: npm run test:all
+        run: npm run ci:test
+
       - if: runner.os == 'Windows'
-        run: npm run ci:prepare && npm run cd:docs build && npm run ci:post
+        run: npm run ci:prepare && npm run cd:docsy.dev build && npm run ci:post
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: test-site-${{ matrix.os }}
+          path: |
+            docsy.dev/public

.gitignore

@@ -2,6 +2,10 @@ node_modules/
 package-lock.json
 /tmp
 
+# ScrollSpy patch related
+# Temporary files created by the patch command when it fails:
+assets/_cache/bootstrap/scrollspy-method.js.*
+
 # Hugo
 .hugo_build.lock
 /public

.markdownlint-cli2.yaml

@@ -0,0 +1,18 @@
+# cSpell:ignore docsy github lookandfeel iconsimages
+
+globs:
+  - '!node_modules/**'
+  - '!public/**'
+  - '!tmp/**'
+  - '!docsy.dev/**'
+  - docsy.dev/content/en/docs/content/iconsimages.md
+  - docsy.dev/content/en/docs/content/language.md
+  - docsy.dev/content/en/docs/content/lookandfeel.md
+  - docsy.dev/content/en/docs/content/navigation.md
+  # - docsy.dev/content/en/docs/content/repository-links.md
+  # - docsy.dev/content/en/docs/content/search.md
+  # - docsy.dev/content/en/docs/content/shortcodes.md
+  # - docsy.dev/content/en/docs/content/versioning.md
+  - docsy.dev/content/en/blog/2025/0.13.0.md
+config:
+  extends: .markdownlint.yaml

.markdownlint.yaml

@@ -0,0 +1,17 @@
+# See https://github.com/DavidAnson/markdownlint/blob/main/README.md#rules--aliases
+# cSpell:ignore docsy
+
+default: true
+
+blanks-around-fences: false
+emphasis-style: false
+first-line-h1: false
+line-length: false
+link-fragments: false
+list-marker-space: false
+no-emphasis-as-header: false
+no-hard-tabs: false
+no-inline-html: false
+no-trailing-punctuation: false
+no-trailing-spaces: {  br_spaces: 0, strict: true}
+# table-column-style: false 

.prettierignore

@@ -0,0 +1,12 @@
+# Note that Prettier ignore rules differ slightly from gitignore rules. The main
+# gotcha is that once a _directory_ is ignored, it's content cannot be
+# unignored.
+
+# Ignore all _files_ under assets
+/assets/**/*.*
+
+# Selectively unignore some files
+!/assets/scss/main.scss
+!/assets/scss/td/**/*
+
+/assets/scss/td/chroma/**/*

.vscode/cspell.json

@@ -3,15 +3,29 @@
   "version": "0.2",
   "caseSensitive": true,
   "words": [
+    "anchorize",
     "Docsy",
     "errorf",
+    "Gantt",
+    "GLFM",
+    "htmltest",
     "hugo",
+    "isset",
+    "markdownify",
+    "nvmrc",
+    "Occitan",
+    "refcache",
     "relref",
     "scrollspy",
     "shortcode",
     "shortcodes",
+    "subfolders",
     "tabpane",
+    "unmarshal",
     "upvote",
-    "warnf"
+    "viewports",
+    "warnf",
+    "warnidf",
+    "wrapup"
   ]
 }