chore: test docs publish

Signed-off-by: Moritz Johner <[email protected]>

Author: moritzjohner-form3

Diff for: .github/actions/mkdocs/action.sh

@@ -31,20 +31,29 @@ fi
 git config --global user.name "$GITHUB_ACTOR"
 git config --global user.email "$GITHUB_ACTOR@users.noreply.github.com"
 
-mkdocs build --config-file "${GITHUB_WORKSPACE}/docs/mkdocs.yml"
+docs_site_tmp_dir=$(mktemp -d)
+cd docs && mkdocs build --config-file "${GITHUB_WORKSPACE}/docs/mkdocs.yml" -d "${docs_site_tmp_dir}"
 
-git clone --branch=gh-pages --depth=1 "${remote_repo}" gh-pages
-cd gh-pages
+gh_pages_tmp_dir=$(mktemp -d)
+
+cd $gh_pages_tmp_dir
+git clone --branch=gh-pages --depth=1 "${remote_repo}" .
 
 # copy current index file index.yaml before any change
 temp_worktree=$(mktemp -d)
-cp --force "index.yaml" "$temp_worktree/index.yaml"
+if [ -f "index.yaml" ]; then
+    cp --force "index.yaml" "$temp_worktree/index.yaml"
+fi
 # remove current content in branch gh-pages
 git rm -r .
 # copy new doc.
-cp -r ../site/* .
+cp -r "${docs_site_tmp_dir}"/* .
+
 # restore chart index
-cp "$temp_worktree/index.yaml" .
+if [ -f "index.yaml" ]; then
+    cp "$temp_worktree/index.yaml" .
+fi
+
 # commit changes
 git add .
 git commit -m "Deploy GitHub Pages"

Diff for: .github/workflows/docs.yaml

@@ -49,4 +49,4 @@ jobs:
       - name: Deploy
         uses: ./.github/actions/mkdocs
         env:
-          PERSONAL_TOKEN: "${{ secrets.GITHUB_TOKEN }}"
+          PERSONAL_TOKEN: "${{ secrets.GITHUB_TOKEN }}"

Diff for: docs/Makefile

@@ -1,11 +1,3 @@
-.PHONY: check_dead_links
-check_dead_links: ## Check if the documentation contains dead links.
-	@docker run -t \
-	  -w /tmp \
-	  -v $$PWD:/tmp dkhamsing/awesome_bot:1.20.0 \
-	  --allow-dupe \
-	  --allow-redirect $(shell find $$PWD -mindepth 1 -name vendor -prune -o -name .modcache -prune -o -iname Changelog.md -prune -o -name "*.md" | sed -e "s#$$PWD/##")
-
 .PHONY: build-image
 build-image:
 	@docker build \
@@ -29,11 +21,3 @@ live-docs: build-image ## Build and launch a local copy of the documentation web
 		--entrypoint /bin/bash   \
 		xpdb-docs \
 		-c "pip install -r /docs/requirements.txt && mkdocs serve --dev-addr=0.0.0.0:8000"
-
-.PHONY: misspell
-misspell:  ## Check for spelling errors.
-	@go install github.com/client9/misspell/cmd/misspell@latest
-	misspell \
-		-locale US \
-		-error \
-		.

Diff for: docs/extra.css

@@ -3,7 +3,7 @@ repo_name: "form3tech-oss/x-pdb"
 repo_url: https://github.com/form3tech-oss/x-pdb
 site_url: https://form3tech-oss.github.io/x-pdb
 edit_uri: edit/main/docs/src
-docs_dir: "/docs/src"
+docs_dir: "src"
 
 # Extensions
 markdown_extensions:
@@ -63,8 +63,6 @@ plugins:
   - minify:
       minify_html: true
 
-extra_css: [extra.css]
-
 nav:
   - Introduction:
       - Overview: "index.md"