mirror of
https://github.com/jackyzha0/quartz.git
synced 2026-03-24 23:15:46 -05:00
Update README.md
This commit is contained in:
parent
11b23f2e4a
commit
6a52d43cb8
149
README.md
149
README.md
@ -6,38 +6,6 @@
|
||||
|
||||
[](https://forgetfulnotes.com/) [](https://forgetful-notes.vercel.app/)
|
||||
|
||||
## 📑 Table of Contents
|
||||
|
||||
- [🌱 Forgetful Notes](#-forgetful-notes)
|
||||
- [📑 Table of Contents](#-table-of-contents)
|
||||
- [⚡ Quick start](#-quick-start)
|
||||
- [✨ Features](#-features)
|
||||
- [👨🏼💻 Useful Commands](#-useful-commands)
|
||||
- [🎨 Customization](#-customization)
|
||||
- [📁 Folder Structure](#-folder-structure)
|
||||
- [🛠️ Technology](#️-technology)
|
||||
- [© License](#-license)
|
||||
|
||||
## ⚡ Quick start
|
||||
|
||||
**1. Clone repo**
|
||||
|
||||
```bash
|
||||
git clone https://github.com/semanticdata/forgetful-notes.git
|
||||
```
|
||||
|
||||
**2. Install dependencies**
|
||||
|
||||
```sh
|
||||
pnpm install
|
||||
```
|
||||
|
||||
**3. Run the project locally**
|
||||
|
||||
```sh
|
||||
pnpm start
|
||||
```
|
||||
|
||||
## ✨ Features
|
||||
|
||||
- Fast Natural-Language Search
|
||||
@ -47,21 +15,41 @@ pnpm start
|
||||
- Markdown Links and Wikilinks Support
|
||||
- Latex Support
|
||||
|
||||
## ⚡ Quick start
|
||||
|
||||
### 1. Clone repo
|
||||
|
||||
```sh
|
||||
git clone https://github.com/semanticdata/forgetful-notes.git
|
||||
```
|
||||
|
||||
### 2. Install dependencies
|
||||
|
||||
```sh
|
||||
pnpm install
|
||||
```
|
||||
|
||||
### 3. Run the project locally
|
||||
|
||||
```sh
|
||||
pnpm start
|
||||
```
|
||||
|
||||
## 👨🏼💻 Useful Commands
|
||||
|
||||
**Update Quartz**
|
||||
### Update Quartz
|
||||
|
||||
```sh
|
||||
npm run update
|
||||
```
|
||||
|
||||
**Sync changes**
|
||||
### Sync changes
|
||||
|
||||
```sh
|
||||
npm run sync
|
||||
```
|
||||
|
||||
**Read about a command**
|
||||
### Read about a command
|
||||
|
||||
```sh
|
||||
npx quartz <command> --help
|
||||
@ -69,104 +57,17 @@ npx quartz <command> --help
|
||||
|
||||
## 🎨 Customization
|
||||
|
||||
### Stylesheets
|
||||
|
||||
You can add custom CSS code within `/quartz/styles/custom.scss`. You will then need to uncomment line 4 of `/quartz/styles/base.scss` to have it take effect.
|
||||
|
||||
### Fonts
|
||||
|
||||
| Used in: | Font Family | Previous Font |
|
||||
| --- | :-: | :-: |
|
||||
| Headers | [Bitter](https://fonts.google.com/specimen/Bitter) | [Schibsted Grotesk](https://fonts.google.com/specimen/Schibsted+Grotesk) |
|
||||
| Body | [Poppins](https://fonts.google.com/specimen/Poppins) | [Source Sans Pro](https://fonts.google.com/specimen/Source+Sans+3) |
|
||||
| Code | [Fira Mono](https://fonts.google.com/specimen/Fira+Mono) | [IBM Plex Mono](https://fonts.google.com/specimen/IBM+Plex+Mono) |
|
||||
|
||||
## 📁 Folder Structure
|
||||
|
||||
<details>
|
||||
<summary>Show/Hide</summary>
|
||||
|
||||
```plaintext
|
||||
.
|
||||
├── .github/
|
||||
│ └── workflows/
|
||||
│ ├── build.yml
|
||||
│ └── deploy.yml
|
||||
├── content/
|
||||
│ ├── notes.md
|
||||
│ ├── pages.md
|
||||
│ └── ...
|
||||
├── docs/
|
||||
│ ├── documentation.md
|
||||
│ └── ...
|
||||
├── quartz/
|
||||
│ ├── cli/
|
||||
│ │ ├── args.js
|
||||
│ │ ├── constants.js
|
||||
│ │ ├── handlers.js
|
||||
│ │ └── helpers.js
|
||||
│ ├── components/
|
||||
│ │ ├── pages/
|
||||
│ │ ├── scripts/
|
||||
│ │ ├── styles/
|
||||
│ │ ├── Backlinks.tsx
|
||||
│ │ ├── Explorer.tsx
|
||||
│ │ └── ...
|
||||
│ ├── plugins/
|
||||
│ │ ├── emitters/
|
||||
│ │ ├── filters/
|
||||
│ │ ├── transformers/
|
||||
│ │ ├── index.ts
|
||||
│ │ ├── types.ts
|
||||
│ │ └── vfile.ts
|
||||
│ ├── processors/
|
||||
│ │ ├── emit.ts
|
||||
│ │ ├── filter.ts
|
||||
│ │ └── parse.ts
|
||||
│ ├── static/
|
||||
│ │ ├── favicon.ico
|
||||
│ │ ├── site.manifest
|
||||
│ │ └── ...
|
||||
│ ├── styles/
|
||||
│ │ ├── base.scss
|
||||
│ │ ├── callouts.scss
|
||||
│ │ ├── custom.scss
|
||||
│ │ ├── syntax.scss
|
||||
│ │ └── variables.scss
|
||||
│ ├── util/
|
||||
│ │ ├── theme.ts
|
||||
│ │ ├── jsx.tsx
|
||||
│ │ └── ...
|
||||
│ ├── bootstrp.cli.mjs
|
||||
│ ├── bootstrap-worker.njs
|
||||
│ ├── build.ts
|
||||
│ ├── cfg.ts
|
||||
│ └── worker.ts
|
||||
├── .gitattributes
|
||||
├── .gitignore
|
||||
├── .npmrc
|
||||
├── .prettierignore
|
||||
├── .prettierrc
|
||||
├── Dockerfile
|
||||
├── LICENSE
|
||||
├── README.md
|
||||
├── globals.d.ts
|
||||
├── index.d.ts
|
||||
├── package-lock.json
|
||||
├── package.json
|
||||
├── quartz.config.ts
|
||||
├── quartz.layout.ts
|
||||
├── screenshot.png
|
||||
└── tsconfig.json
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
## 🛠️ Technology
|
||||
|
||||
The site uses various technologies cobbled together. It's powered by [Quartz](https://github.com/jackyzha0/quartz/) and [Obsidian](https://obsidian.md). You can read the [Documentation](https://quartz.jzhao.xyz/), and join the [Discord Community](https://discord.gg/cRFFHYye7t).
|
||||
|
||||
Here's some of them:
|
||||
The site uses various technologies cobbled together. Here's a few of them:
|
||||
|
||||
- [Quartz](https://github.com/jackyzha0/quartz): a fast, batteries-included static-site generator.
|
||||
- [Prettier](https://github.com/prettier/prettier): an opinionated code formatter.
|
||||
@ -175,8 +76,6 @@ Here's some of them:
|
||||
|
||||
All content for the site is written in _Markdown_ within [Obsidian](https://obsidian.md/)—an extensible, flexible note-taking app. To export the notes from Obsidian, I rely on the [GitHub Publisher](https://github.com/ObsidianPublisher) plugin.
|
||||
|
||||
The website has gone through many changes. I have ran my notes through [Jekyll](https://jekyllrb.com/), [Hugo](https://gohugo.io/), [MkDocs](https://squidfunk.github.io/mkdocs-material/), [Zola](https://www.getzola.org/), and most recently [11ty](https://11ty.dev).
|
||||
|
||||
## © License
|
||||
|
||||
Source code in this repository is available under the [MIT License](LICENSE).
|
||||
|
||||
Loading…
Reference in New Issue
Block a user