ar.falsy.cat/content/notes/setup.md

37 lines
1.6 KiB
Markdown
Raw Normal View History

2021-07-18 15:54:00 +00:00
---
title: "Setup"
2021-12-27 02:13:21 +00:00
tags:
- setup
2022-06-30 00:03:41 +00:00
weight: -5
2021-07-18 15:54:00 +00:00
---
2021-07-18 19:19:58 +00:00
## Making your own Quartz
Setting up Quartz requires a basic understanding of `git`. If you are unfamiliar, [this resource](https://resources.nwplus.io/2-beginner/how-to-git-github.html) is a great place to start!
2021-07-18 15:54:00 +00:00
2021-07-18 19:19:58 +00:00
### Forking
> A fork is a copy of a repository. Forking a repository allows you to freely experiment with changes without affecting the original project.
2021-07-18 15:54:00 +00:00
2021-07-18 19:19:58 +00:00
Navigate to the GitHub repository for the Quartz project:
📁 [Quartz Repository](https://github.com/jackyzha0/quartz)
Then, Fork the repository into your own GitHub account. **Make sure that when you fork, you _uncheck_ the 'Copy the `hugo` branch only' option**.
If you don't have an account, you can make on for free [here](https://github.com/join). More details about forking a repo can be found on [GitHub's documentation](https://docs.github.com/en/get-started/quickstart/fork-a-repo).
![[notes/images/fork.png]]
2021-07-18 19:19:58 +00:00
### Cloning
After you've made a fork of the repository, you need to download the files locally onto your machine. Ensure you have `git`, then type the following command in your terminal replacing `YOUR-USERNAME` with your GitHub username.
2021-07-18 19:19:58 +00:00
```shell
git clone https://github.com/YOUR-USERNAME/quartz
2021-07-18 19:19:58 +00:00
```
## Editing
Great! Now you have everything you need to start editing and growing your digital garden. If you're ready to start writing content already, check out the recommended flow for editing notes in Quartz.
2022-06-29 23:57:36 +00:00
> ✏️ Step 2: [Editing Notes in Quartz](notes/editing.md)
2021-07-18 19:19:58 +00:00
2022-03-17 00:54:24 +00:00
Having problems? Checkout our [FAQ and Troubleshooting guide](notes/troubleshooting.md).