harper
f5eb12a16d
Build and Test / build-and-test (ubuntu-latest) (push) Has been skipped
Build and Test / publish-tag (push) Has been skipped
Docker build & push image / build (push) Has been skipped
Build and Test / build-and-test (macos-latest) (push) Has been cancelled
Build and Test / build-and-test (windows-latest) (push) Has been cancelled
28 lines
1.0 KiB
Markdown
28 lines
1.0 KiB
Markdown
---
|
|
title: "Building your Quartz"
|
|
---
|
|
|
|
Once you've [[egf/docs/index#🪴 Get Started|initialized]] Quartz, let's see what it looks like locally:
|
|
|
|
```bash
|
|
npx quartz build --serve
|
|
```
|
|
|
|
This will start a local web server to run your Quartz on your computer. Open a web browser and visit `http://localhost:8080/` to view it.
|
|
|
|
> [!hint] Flags and options
|
|
> For full help options, you can run `npx quartz build --help`.
|
|
>
|
|
> Most of these have sensible defaults but you can override them if you have a custom setup:
|
|
>
|
|
> - `-d` or `--directory`: the content folder. This is normally just `content`
|
|
> - `-v` or `--verbose`: print out extra logging information
|
|
> - `-o` or `--output`: the output folder. This is normally just `public`
|
|
> - `--serve`: run a local hot-reloading server to preview your Quartz
|
|
> - `--port`: what port to run the local preview server on
|
|
> - `--concurrency`: how many threads to use to parse notes
|
|
|
|
> [!warning] Not to be used for production
|
|
> Serve mode is intended for local previews only.
|
|
> For production workloads, see the page on [[hosting]].
|