🌱 a fast, batteries-included static-site generator that transforms Markdown content into fully functional websites
Go to file
Anton Bulakh 8651f887d9
feat: untangle quartz from local configs in least amount of changes
For the current setup where people have to fork or at least clone quartz
this changes nothing - but it allows you to install quartz as a
devDependency via npm and have it actually work.

One real change is switch from `.quartz-cache` to
`node_modules/.cache/quartz` for transpilation results, this is an
artifact from my previous attempts, I guess with this one I can change
it back - but `node_modules/.cache` feels more better imo idk.

edit: OTOH if you want to have quartz be a _completely_ separate binary
(which this also enables I think), having it create a node_modules
folder is weird, so I made a quick hack for that for now.

Example:
```bash
$ mkdir my-repo && cd my-repo
$ npm i quartz@necauqua/quartz#untangled # quartz@ prefix is important
$ cp node_modules/quartz/quartz.*.ts .   # copy the default configs
$ mkdir content && echo "# Hello World!" > content/index.md
$ npx quartz build --serve # this just works!
$ echo 'body { background: red !important; }' > styles.scss
```
Notice how I used my branch in the `npm i` line, ideally it'd be
`npm i quartz@jackyzho0/quartz`, or maybe we can somehow get the quartz
package on npm and it'll just be `npm i quartz`.
In the latter case `npx quartz build` will literally just work without
a local npm package at all?.

Having some support for components and plugins being in separate npm
packages instead of people copying code around is not out of the picture
with this too btw.

Closes #502

MOVE ME
2025-02-14 03:01:10 +02:00
.github chore(deps): bump sigstore/cosign-installer in the ci-dependencies group (#1762) 2025-02-11 01:27:43 -05:00
content re-add gitkeep to content 2023-12-11 15:34:21 -08:00
docs feat: untangle quartz from local configs in least amount of changes 2025-02-14 03:01:10 +02:00
quartz feat: untangle quartz from local configs in least amount of changes 2025-02-14 03:01:10 +02:00
.gitattributes add gitattributes for windows 2023-08-02 20:59:56 -07:00
.gitignore feat: support configurable ws port and remote development (#429) 2023-08-27 17:39:42 -07:00
.node-version build: add .node-version 2024-08-05 18:48:29 -07:00
.npmrc add engines field 2023-08-20 08:57:56 -07:00
.prettierignore fix notes 2023-08-07 23:57:24 -07:00
.prettierrc Use semi: false for prettier config 2022-05-02 08:57:25 -07:00
ambient.d.ts feat: untangle quartz from local configs in least amount of changes 2025-02-14 03:01:10 +02:00
CODE_OF_CONDUCT.md run prettier 2023-07-22 17:27:41 -07:00
Dockerfile fix(ci): run build on tags (#1483) 2024-10-06 22:34:31 -04:00
globals.d.ts refactor(comments): move script to files (#1308) 2024-08-05 15:17:11 -04:00
index.ts feat: untangle quartz from local configs in least amount of changes 2025-02-14 03:01:10 +02:00
LICENSE.txt add base structure 2021-07-18 09:35:42 -04:00
package-lock.json chore(deps): bump the production-dependencies group with 6 updates (#1761) 2025-02-11 01:28:02 -05:00
package.json feat: untangle quartz from local configs in least amount of changes 2025-02-14 03:01:10 +02:00
quartz.config.ts feat: untangle quartz from local configs in least amount of changes 2025-02-14 03:01:10 +02:00
quartz.layout.ts feat: untangle quartz from local configs in least amount of changes 2025-02-14 03:01:10 +02:00
README.md fix: remove quartz 3 references, update font style in popovers 2024-01-21 12:39:20 -08:00
tsconfig.json chore(deps-dev): bump prettier 2024-06-17 21:46:43 -07:00

Quartz v4

“[One] who works with the door open gets all kinds of interruptions, but [they] also occasionally gets clues as to what the world is and what might be important.” — Richard Hamming

Quartz is a set of tools that helps you publish your digital garden and notes as a website for free. Quartz v4 features a from-the-ground rewrite focusing on end-user extensibility and ease-of-use.

🔗 Read the documentation and get started: https://quartz.jzhao.xyz/

Join the Discord Community

Sponsors