antony@notes:~/misc$ cat "Docusaurus-Installation.md"
Docusaurus Installation
Docusaurus Installation
Prerequest
- 在 Github 上已建立 Repo,並且已將主機的 SSH Public Key 匯入專案中
- 專案名稱需命名為 :
帳號.github.io
- 專案名稱需命名為 :
開始安裝 Docusaurus
## 安裝 node.js 管理工具
## Node.js version 18.0 or above
$ sudo apk add --update npm
## 新建專案
$ npx @docusaurus/init@latest init my-website classic
$ cd my-website/
## 修改設定檔,將 url、organizationName 和 projectName 改成對應的 github 上的資訊
$ nano docusaurus.config.js
(module.exports = {
url: 'https://nightmare315.github.io'
organizationName: 'nightmare315', // Usually your GitHub org/user name.
projectName: 'nightmare315.github.io', // Usually your repo name.
})
## 本機啟動網站測試
$ npm run start -- --host 0.0.0.0
## 部屬到 Github
$ USE_SSH=true GIT_USER=nightmare315 DEPLOYMENT_BRANCH=main npm run deploy