zaine/quartz
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: updated CI guides

Browse Source
This commit is contained in:
saberzero1
2026-04-03 14:18:43 +02:00
parent c0d3a30fdd
commit 785ac92347
2 changed files with 11 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
docs/getting-started/upgrading.md
View File

@@ -26,7 +26,7 @@ To update your installed plugins separately, use:
npx quartz plugin install --latest npx quartz plugin install --latest
``` ```
See the [[cli/update|CLI reference for update]] and [[cli/upgrade|CLI reference for upgrade]] for more details on available flags. See the [[cli/upgrade|CLI reference for upgrade]] for more details on available flags.
### Cleaning Up Unused Plugins ### Cleaning Up Unused Plugins

19
docs/hosting.md
View File

@@ -13,7 +13,7 @@ However, if you'd like to publish your site to the world, you need a way to host
> Some Quartz features (like [[RSS Feed]] and sitemap generation) require `baseUrl` to be configured properly in your [[configuration]] to work properly. Make sure you set this before deploying! > Some Quartz features (like [[RSS Feed]] and sitemap generation) require `baseUrl` to be configured properly in your [[configuration]] to work properly. Make sure you set this before deploying!
> [!tip] Keeping plugins in sync > [!tip] Keeping plugins in sync
> All hosting examples below use `npx quartz plugin install` to install plugins from the lockfile. If contributors may add plugins to `quartz.config.yaml` without updating the lockfile, add `npx quartz plugin install --from-config` after `restore` in your build command to install any missing plugins. See [[cli/plugin#resolve|plugin resolve]] for details. > All hosting examples below use `npx quartz plugin install` to install plugins from the lockfile. If contributors may add plugins to `quartz.config.yaml` without updating the lockfile, add `npx quartz plugin install --from-config` after `install` in your build command to install any missing plugins. See [[cli/plugin#install|plugin install]] for details.
## Cloudflare Pages ## Cloudflare Pages
@@ -36,7 +36,7 @@ To add a custom domain, check out [Cloudflare's documentation](https://developer
> Cloudflare Pages performs a shallow clone by default, so if you rely on `git` for timestamps, it is recommended that you add `git fetch --unshallow &&` to the beginning of the build command (e.g., `git fetch --unshallow && npx quartz plugin install && npx quartz build`). > Cloudflare Pages performs a shallow clone by default, so if you rely on `git` for timestamps, it is recommended that you add `git fetch --unshallow &&` to the beginning of the build command (e.g., `git fetch --unshallow && npx quartz plugin install && npx quartz build`).
> [!note] > [!note]
> For more detailed CI/CD configuration including caching and plugin management, see [[ci-cd]]. > For more detailed CI/CD configuration including caching and plugin management, see [[getting-started/migrating#Updating Your CI/CD|the migration guide]].
## GitHub Pages ## GitHub Pages
@@ -211,11 +211,14 @@ stages:
- build - build
- deploy - deploy
image: node:22 image: node:24
cache: # Cache modules in between jobs cache:
key: $CI_COMMIT_REF_SLUG - key: npm-$CI_COMMIT_REF_SLUG
paths: paths:
- .npm/ - .npm/
- key: plugins-$CI_COMMIT_REF_SLUG
paths:
- .quartz/plugins/
build: build:
stage: build stage: build
@@ -230,8 +233,6 @@ build:
artifacts: artifacts:
paths: paths:
- public - public
tags:
- gitlab-org-docker
pages: pages:
stage: deploy stage: deploy