1- # senaite3 .com
1+ # senaite .com
22
33Source for the [ SENAITE] ( https://www.senaite.com ) website, built with
44[ Docusaurus v3] ( https://docusaurus.io ) .
@@ -51,23 +51,23 @@ npm run serve
5151## Project structure
5252
5353```
54- senaite3 .com/
55- ├── docs/ Documentation pages (Markdown)
56- │ ├── installation.md Bare-metal installation guide
57- │ ├── docker.md Docker installation guide
58- │ └── upgrade.md Upgrade guide
54+ senaite .com/
55+ ├── docs/ Documentation pages (Markdown)
56+ │ ├── 01- installation.md Bare-metal installation guide
57+ │ ├── 02- docker.md Docker installation guide
58+ │ └── 03- upgrade.md Upgrade guide
5959├── src/
6060│ ├── css/
61- │ │ └── custom.css Global styles and brand tokens
61+ │ │ └── custom.css Global styles and brand tokens
6262│ └── pages/
63- │ ├── index.js Homepage
64- │ ├── features.js Features overview
65- │ └── enterprise.js Professional services / providers
63+ │ ├── index.js Homepage
64+ │ ├── features.js Features overview
65+ │ └── enterprise.js Professional services / providers
6666├── static/
67- │ ├── img/ Images and SVG illustrations
68- │ └── logos/ Customer and partner logos
69- ├── docusaurus.config.js Site configuration
70- └── sidebars.js Documentation sidebar structure
67+ │ ├── img/ Images and SVG illustrations
68+ │ └── logos/ Customer and partner logos
69+ ├── docusaurus.config.js Site configuration
70+ └── sidebars.js Documentation sidebar structure
7171```
7272
7373
@@ -80,22 +80,20 @@ which serves the live site.
8080
8181See ` .github/workflows/deploy.yml ` for the full workflow definition.
8282
83- ### Deploy key setup
83+ ### Personal access token setup
8484
85- The workflow authenticates to ` senaite/senaite.github.io ` using an SSH
86- deploy key . This is a one-time setup.
85+ The workflow authenticates to ` senaite/senaite.github.io ` using a GitHub
86+ Personal Access Token (PAT) . This is a one-time setup.
8787
88- Generate a key pair :
88+ Generate a classic PAT at ` https://github.com/settings/tokens ` :
8989
90- ``` bash
91- ssh-keygen -t ed25519 -C " senaite3.com deploy" -f senaite3_deploy
92- ```
90+ - Note: ` senaite.com deploy `
91+ - Scope: ` repo ` (full control of private repositories)
9392
94- Add the ** public key** (` senaite3_deploy.pub ` ) as a deploy key on
95- ` senaite/senaite.github.io ` with write access.
93+ Add the token as a repository secret on ` senaite/senaite.com ` :
9694
97- Add the ** private key ** ( ` senaite3_deploy ` ) as the ` DEPLOY_KEY ` secret
98- on ` senaite/senaite3.com ` .
95+ - Name: ` PERSONAL_TOKEN `
96+ - Value: the token string
9997
10098Once the secret is in place, every push to ` main ` triggers a build and
10199publishes the result.
0 commit comments