docs: migrate documentation from hugo-book to Hextra theme

Migrate the documentation site from the hugo-book theme to the Hextra
theme by imfing. This includes a full replacement of the theme vendor
directory, new Hugo configuration (hugo.yaml replacing config.toml),
updated layouts and partials (sidebar, footer, mobile TOC, theme
toggle), custom CSS with a blue-cyan color scheme, callout styles, and
responsive design improvements.

Update Hugo version from 0.96.0 to 0.146.0. Reorganize documentation
content structure with improved navigation, cards, diagrams, and
interactive features. Optimize image assets, add favicon and web
manifest, and update the doc generation pipeline (.tekton/doc.yaml,
hack/gendocs.sh).

Signed-off-by: Chmouel Boudjnah <chmouel@redhat.com>

Author: chmouel

.gitignore

@@ -52,3 +52,4 @@ tags
 
 #Mac
 .DS_Store
+/.cursor/plans

.pre-commit-config.yaml

@@ -1,7 +1,7 @@
 # See https://pre-commit.com for more information
 # See https://pre-commit.com/hooks.html for more hooks
 default_install_hook_types: ["pre-push"]
-exclude: '(^docs/themes/hugo-book|^vendor|.*golden$|^\.vale)'
+exclude: '(^docs/_vendor|^docs/themes/hugo-book|^vendor|.*golden$|^\.vale)'
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
     rev: v6.0.0

.tekton/doc.yaml

@@ -16,7 +16,7 @@ spec:
     - name: revision
       value: "{{revision}}"
     - name: hugo_version
-      value: "0.96.0"
+      value: "0.146.0"
   pipelineSpec:
     params:
       - name: repo_url
@@ -76,9 +76,8 @@ spec:
                   echo "Hugo was not downloaded properly" && exit 1
                 }
                 cd $(git rev-parse --show-toplevel)/docs
-                sed -i '1acanonifyURLs = true' config.toml
                 url="${UPLOADER_PUBLIC_URL}/docs/{{ pull_request_number }}"
-                ${hugobin} --gc --minify -d {{ pull_request_number }} -b ${url}
+                ${hugobin} --gc --minify --canonifyURLs -d {{ pull_request_number }} -b ${url}
                 echo "Preview URL: ${url}"
             - name: upload-to-static-server
               # it has curl and we already pulled it

CLAUDE.md

@@ -0,0 +1,61 @@
+# Pipelines-as-Code Project Guide
+
+## Project Overview
+
+- Tekton pipeline integration with Git providers: GitHub, GitLab, Bitbucket, Gitea
+- Targets arm64 and amd64 architectures
+- Uses `ko` for building container images in development
+
+## Code Quality Workflow
+
+### After Editing Code
+
+**Go files**: `make fumpt` to format
+**Python files**: `make fix-python-errors`
+**Markdown files**: `make fix-markdownlint && make fix-trailing-spaces`
+
+### Before Committing
+
+1. `make test` - Run test suite
+2. `make lint` - Check code quality
+3. `make check` - Combined lint + test
+
+**Pre-commit hooks**: Install with `pre-commit install`
+
+- Runs on push (skip with `git push --no-verify`)
+- Linters: golangci-lint, yamllint, markdownlint, ruff, shellcheck, vale, codespell
+- Skip specific hook: `SKIP=hook-name git push`
+
+## Testing
+
+- **Unit tests**: Use `gotest.tools/v3` (never testify)
+- **E2E tests**: Require specific setup - always ask user to run and copy output
+- **Gitea tests**: Most comprehensive and self-contained
+- **Commands**: `make test-no-cache`, `make html-coverage`
+
+## Dependencies
+
+- Add: `go get -u dependency`
+- **Always run after**: `make vendor` (required!)
+- Update Go version: `go mod tidy -go=1.20`
+- Remove unnecessary `replace` clauses in go.mod
+
+## Documentation
+
+- Preview: `make dev-docs` (<http://localhost:1313>)
+- Hugo with hugo-book theme
+- Custom shortcodes: `tech_preview`, `support_matrix`
+
+## Useful Commands
+
+- `make help` - Show all make targets
+- `make all` - Build, test, lint
+- `make clean` - Clean artifacts
+- `make fix-linters` - Auto-fix most linting issues
+
+## Skills
+
+For complex workflows, use these repo-local skills:
+
+- **Commit messages**: Conventional commits with Jira integration, line length validation, required footers. Trigger: "create commit", "commit changes", "generate commit message"
+- **Jira tickets**: SRVKP story and bug templates with Jira markdown formatting. Trigger: "create Jira story", "create Jira bug", "SRVKP ticket"

CLAUDE.md

@@ -1,5 +1,5 @@
 TARGET_NAMESPACE=pipelines-as-code
-HUGO_VERSION=0.96.0
+HUGO_VERSION=0.146.0
 GOLANGCI_LINT=golangci-lint
 GOFUMPT=gofumpt
 TKN_BINARY_NAME := tkn
@@ -199,8 +199,8 @@ download-hugo: ## Download hugo software
 	./hack/download-hugo.sh $(HUGO_VERSION) $(TMPDIR)/hugo
 
 .PHONY: dev-docs
-dev-docs: download-hugo ## preview live your docs with hugo
-	@$(HUGO_BIN) server -s docs/ &
+dev-docs:
+	@hugo server -s docs/ &
 	@echo "Sleeping for 2s....";sleep 2 ; \
 	if type -p xdg-open 2>/dev/null >/dev/null; then \
 		xdg-open http://localhost:1313; \

Makefile

@@ -1,3 +1,6 @@
 resources/_gen/
 .hugo_build.lock
 public/
+content/ALLVERSIONS
+content/VERSION
+tmp/