Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 1 addition & 2 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,7 @@ hugo_stats.json
# Hugo lock file
.hugo_build.lock

# Node deps (Hugo Blox needs preact, tailwindcss, pagefind at build time —
# CI runs `npm install` to fetch them)
# Node dependencies used by Hugo Blox, Tailwind, and Pagefind
node_modules/

# Editor files
Expand Down
1 change: 1 addition & 0 deletions .nvmrc
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
22
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,16 +21,16 @@ Clone and run the site:
```sh
git clone https://github.com/HTMLTrust/htmltrust-website.git
cd htmltrust-website
npm ci
npm ci --ignore-scripts
npm run dev
```

Open <http://localhost:1313/>. Hugo downloads the pinned Hugo Blox modules on
the first run, so the initial build needs network access.

The `npm ci` command uses the committed `package-lock.json`. It installs the
Tailwind and Pagefind tools used by the build. `pnpm-lock.yaml` is retained for
Hugo Blox development, while CI and the documented path use npm.
Tailwind and Pagefind tools used by the build. npm is the repository's package
manager; the `package-lock.json` is the only JavaScript lockfile committed here.

## Build and checks

Expand Down Expand Up @@ -66,14 +66,14 @@ immutable `htmltrust-hugo` signer revision used in CI. Keep the key outside the
repository. From the repository root:

```sh
npm ci
npm ci --ignore-scripts
hugo --minify
go install github.com/HTMLTrust/htmltrust-hugo/cmd/htmltrust-sign@d39ef12d068d6028076d91eedf1a5f98abcd7b8d
export HTMLTRUST_SIGNING_KEY="$(cat /path/to/ed25519-private-key.pem)"
htmltrust-sign \
--dir public \
--keyid did:web:jason-grey.com \
--domain https://www.htmltrust.org
--domain www.htmltrust.org
```

The key must be a PEM-encoded PKCS#8 Ed25519 private key. The signer rewrites
Expand Down
4 changes: 2 additions & 2 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

6 changes: 3 additions & 3 deletions package.json
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
{
"name": "hugo-blox-documentation-starter",
"name": "htmltrust-website",
"version": "1.0.0",
"private": true,
"packageManager": "pnpm@10.14.0",
"description": "Documentation starter template for Hugo Blox with Tailwind CSS v4",
"packageManager": "npm@10.9.2",
"description": "HTMLTrust documentation and project website",
"scripts": {
"dev": "hugo server --disableFastRender",
"build": "hugo --minify && npm run pagefind",
Expand Down
Loading