mirror of
https://github.com/alrayyes/wiki.git
synced 2024-11-22 19:46:23 +00:00
Merge branch 'hugo' of https://github.com/bur3ku/quartz into hugo
This commit is contained in:
commit
1fc2da4fe2
11 changed files with 246 additions and 221 deletions
2
.github/workflows/deploy.yaml
vendored
2
.github/workflows/deploy.yaml
vendored
|
@ -12,7 +12,7 @@ jobs:
|
||||||
- uses: actions/checkout@v2
|
- uses: actions/checkout@v2
|
||||||
|
|
||||||
- name: Build Link Index
|
- name: Build Link Index
|
||||||
uses: jackyzha0/hugo-obsidian@v2.3
|
uses: jackyzha0/hugo-obsidian@v2.4
|
||||||
with:
|
with:
|
||||||
index: true
|
index: true
|
||||||
input: content
|
input: content
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
# Quartz
|
# Quartz
|
||||||
Simple second brain and digital garden.
|
Host your own second brain and digital garden for free.
|
||||||
|
|
||||||
> “He who works with the door open gets all kinds of interruptions, but he also occasionally gets clues as to what the world is and what might be important.” — Richard Hamming
|
> “[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
|
||||||
|
|
||||||
🔗 Get Started: https://quartz.jzhao.xyz/
|
🔗 Get Started: https://quartz.jzhao.xyz/
|
|
@ -280,7 +280,8 @@ header {
|
||||||
left: 0;
|
left: 0;
|
||||||
top: 0;
|
top: 0;
|
||||||
width: 100vw;
|
width: 100vw;
|
||||||
height: 100vh;
|
height: 100%;
|
||||||
|
overflow: scroll;
|
||||||
display: none;
|
display: none;
|
||||||
backdrop-filter: blur(4px);
|
backdrop-filter: blur(4px);
|
||||||
-webkit-backdrop-filter: blur(4px);
|
-webkit-backdrop-filter: blur(4px);
|
||||||
|
@ -324,7 +325,18 @@ header {
|
||||||
border: 1px solid var(--outlinegray);
|
border: 1px solid var(--outlinegray);
|
||||||
border-bottom: none;
|
border-bottom: none;
|
||||||
|
|
||||||
&:hover {
|
// normalize button props
|
||||||
|
font-family: inherit;
|
||||||
|
font-size: 100%;
|
||||||
|
line-height: 1.15;
|
||||||
|
margin: 0;
|
||||||
|
overflow: visible;
|
||||||
|
text-transform: none;
|
||||||
|
text-align: left;
|
||||||
|
background: var(--light);
|
||||||
|
outline: none;
|
||||||
|
|
||||||
|
&:hover, &:focus {
|
||||||
background: rgba(180, 180, 180, 0.15);
|
background: rgba(180, 180, 180, 0.15);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
|
@ -1,23 +1,18 @@
|
||||||
# 🌱 Quartz
|
---
|
||||||
## v2.0
|
title: 🪴 Quartz v2.1
|
||||||
|
---
|
||||||
Simple second brain and [digital garden](https://jzhao.xyz/posts/digital-gardening).
|
Host your second brain and [digital garden](https://jzhao.xyz/posts/digital-gardening) for free. Quartz features
|
||||||
|
1. Extremely fast full-text search by pressing `/`
|
||||||
## Why Quartz?
|
2. Beautiful, out-of-the-box website creation and deployment
|
||||||
Hosting a public digital garden isn't easy. There are an overwhelming number of tutorials, resources, and guides for tools like [Notion](https://www.notion.so/), [Roam](https://roamresearch.com/), and [Obsidian](https://obsidian.md/), yet none of them have super easy to use *free* tools to publish that garden to the world.
|
3. Display for backlinks of each note
|
||||||
|
4. A customizable graph view
|
||||||
I've personally found that
|
5. Endlessly powerful page and theme customization
|
||||||
1. It's nice to access notes from anywhere
|
|
||||||
2. Having a public digital garden invites open conversations
|
|
||||||
3. It makes keeping personal notes and knowledge *playful and fun*
|
|
||||||
|
|
||||||
> “He who works with the door open gets all kinds of interruptions, but he also occasionally gets clues as to what the world is and what might be important.” — Richard Hamming
|
|
||||||
|
|
||||||
I was really inspired by [Bianca](https://garden.bianca.digital/) and [Joel](https://joelhooks.com/digital-garden)'s digital gardens and wanted to try making my own.
|
|
||||||
|
|
||||||
**The goal of Quartz is to make hosting your own public digital garden free and simple.** You don't even need your own website. Quartz does all of that for you and gives your own little corner of the internet.
|
|
||||||
|
|
||||||
## Get Started
|
## Get Started
|
||||||
The entire Quartz documentation is fully hosted using Quartz! To get started, let's visit the main directory.
|
> 📚 [Setup your own digital garden using Quartz](notes/setup.md)
|
||||||
|
|
||||||
👉 [Directory](moc/directory.md)
|
Not convinced yet? Look at some [community digital gardens](moc/showcase) built with Quartz, or read about [why I made Quartz](notes/philosophy.md) to begin with!
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
- 🚧 [Troubleshooting and FAQ](notes/troubleshooting.md)
|
||||||
|
- 🐛 [Submit an Issue](https://github.com/jackyzha0/quartz/issues)
|
|
@ -1,19 +0,0 @@
|
||||||
---
|
|
||||||
title: "Quartz Documentation"
|
|
||||||
---
|
|
||||||
|
|
||||||
## Setup
|
|
||||||
Welcome to Quartz! Whether you're setting up a website and project for the first time or a seasoned digital gardener, I hope that you'll find something useful about this project.
|
|
||||||
|
|
||||||
Let's get to business and get you started!
|
|
||||||
|
|
||||||
- 📚 [Setup your own digital garden using Quartz](notes/setup.md)
|
|
||||||
- 🔗 [Linking with an Obsidian Vault](notes/obsidian.md)
|
|
||||||
- 🎨 [Customizing and Styling Quartz](notes/config.md)
|
|
||||||
- 🌍 [Hosting Quartz online!](notes/hosting.md)
|
|
||||||
|
|
||||||
Not convinced yet? Look at some [community digital gardens](moc/showcase) built with Quartz!
|
|
||||||
|
|
||||||
## Troubleshooting
|
|
||||||
- 🚧 [Troubleshooting and FAQ](notes/troubleshooting.md)
|
|
||||||
- 🐛 [Submit an Issue](https://github.com/jackyzha0/quartz/issues)
|
|
|
@ -11,5 +11,6 @@ Want to see what Quartz can do? Here are some cool community gardens :)
|
||||||
- [Shihyu's PKM](https://shihyuho.github.io/pkm/)
|
- [Shihyu's PKM](https://shihyuho.github.io/pkm/)
|
||||||
- [Chloe's Garden](https://garden.chloeabrasada.online/)
|
- [Chloe's Garden](https://garden.chloeabrasada.online/)
|
||||||
- [SlRvb's Site](https://slrvb.github.io/Site/)
|
- [SlRvb's Site](https://slrvb.github.io/Site/)
|
||||||
|
- [Course notes for Information Technology Advanced Theory](https://a2itnotes.github.io/quartz/)
|
||||||
|
|
||||||
If you want to see your own on here, submit a [Pull Request adding yourself to this file](https://github.com/jackyzha0/quartz/blob/hugo/content/moc/showcase.md)!
|
If you want to see your own on here, submit a [Pull Request adding yourself to this file](https://github.com/jackyzha0/quartz/blob/hugo/content/moc/showcase.md)!
|
||||||
|
|
|
@ -80,6 +80,6 @@ Don't want to use GitHub Pages? Hugo builds everything for you! Everything is a
|
||||||
|
|
||||||
Now that your Quartz is live, let's figure out how to make Quartz really *yours*!
|
Now that your Quartz is live, let's figure out how to make Quartz really *yours*!
|
||||||
|
|
||||||
🎨 [Customizing Quarts](notes/config.md)
|
🎨 [Customizing Quartz](notes/config.md)
|
||||||
|
|
||||||
Having problems? Checkout our [FAQ and Troubleshooting guide](notes/troubleshooting.md).
|
Having problems? Checkout our [FAQ and Troubleshooting guide](notes/troubleshooting.md).
|
|
@ -15,6 +15,15 @@ ignoreFiles = [
|
||||||
```
|
```
|
||||||
|
|
||||||
`ignoreFiles` supports the use of Regular Expressions (RegEx) so you can ignore patterns as well (e.g. ignoring all `.png`s by doing `\\.png$`).
|
`ignoreFiles` supports the use of Regular Expressions (RegEx) so you can ignore patterns as well (e.g. ignoring all `.png`s by doing `\\.png$`).
|
||||||
|
To ignore a specific file, you can also add the tag `draft: true` to the frontmatter of a note.
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
---
|
||||||
|
title: Some Private Note
|
||||||
|
draft: true
|
||||||
|
---
|
||||||
|
...
|
||||||
|
```
|
||||||
|
|
||||||
More details in [Hugo's documentation](https://gohugo.io/getting-started/configuration/#ignore-content-and-data-files-when-rendering).
|
More details in [Hugo's documentation](https://gohugo.io/getting-started/configuration/#ignore-content-and-data-files-when-rendering).
|
||||||
|
|
||||||
|
|
17
content/notes/philosophy.md
Normal file
17
content/notes/philosophy.md
Normal file
|
@ -0,0 +1,17 @@
|
||||||
|
---
|
||||||
|
title: Quartz Philosophy
|
||||||
|
---
|
||||||
|
|
||||||
|
> “[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
|
||||||
|
|
||||||
|
## Why Quartz?
|
||||||
|
Hosting a public digital garden isn't easy. There are an overwhelming number of tutorials, resources, and guides for tools like [Notion](https://www.notion.so/), [Roam](https://roamresearch.com/), and [Obsidian](https://obsidian.md/), yet none of them have super easy to use *free* tools to publish that garden to the world.
|
||||||
|
|
||||||
|
I've personally found that
|
||||||
|
1. It's nice to access notes from anywhere
|
||||||
|
2. Having a public digital garden invites open conversations
|
||||||
|
3. It makes keeping personal notes and knowledge *playful and fun*
|
||||||
|
|
||||||
|
I was really inspired by [Bianca](https://garden.bianca.digital/) and [Joel](https://joelhooks.com/digital-garden)'s digital gardens and wanted to try making my own.
|
||||||
|
|
||||||
|
**The goal of Quartz is to make hosting your own public digital garden free and simple.** You don't even need your own website. Quartz does all of that for you and gives your own little corner of the internet.
|
|
@ -24,5 +24,5 @@
|
||||||
{{partial "footer.html" .}}
|
{{partial "footer.html" .}}
|
||||||
</div>
|
</div>
|
||||||
</body>
|
</body>
|
||||||
|
|
||||||
</html>
|
</html>
|
||||||
|
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
<div id="search-container">
|
<div id="search-container">
|
||||||
<div>
|
<div id="search-space">
|
||||||
<input autocomplete="off" id="search-bar" name="search" type="text" aria-label="Search" placeholder="Search for something...">
|
<input autocomplete="off" id="search-bar" name="search" type="text" aria-label="Search" placeholder="Search for something...">
|
||||||
<div id="results-container">
|
<div id="results-container">
|
||||||
</div>
|
</div>
|
||||||
|
@ -68,12 +68,10 @@
|
||||||
</script>
|
</script>
|
||||||
<script>
|
<script>
|
||||||
const contentIndex = new FlexSearch.Worker({
|
const contentIndex = new FlexSearch.Worker({
|
||||||
tokenize: "strict",
|
tokenize: "reverse",
|
||||||
charset: "latin:advanced",
|
charset: "latin:extra",
|
||||||
context: true,
|
|
||||||
depth: 3,
|
|
||||||
cache: 10,
|
|
||||||
suggest: true,
|
suggest: true,
|
||||||
|
cache: 10,
|
||||||
})
|
})
|
||||||
|
|
||||||
const scrapedContent = {{$.Site.Data.contentIndex}}
|
const scrapedContent = {{$.Site.Data.contentIndex}}
|
||||||
|
@ -81,12 +79,11 @@
|
||||||
contentIndex.add(key, value.content)
|
contentIndex.add(key, value.content)
|
||||||
}
|
}
|
||||||
|
|
||||||
const stopwords = ['i','me','my','myself','we','our','ours','ourselves','you','your','yours','yourself','yourselves','he','him','his','himself','she','her','hers','herself','it','its','itself','they','them','their','theirs','themselves','what','which','who','whom','this','that','these','those','am','is','are','was','were','be','been','being','have','has','had','having','do','does','did','doing','a','an','the','and','but','if','or','because','as','until','while','of','at','by','for','with','about','against','between','into','through','during','before','after','above','below','to','from','up','down','in','out','on','off','over','under','again','further','then','once','here','there','when','where','why','how','all','any','both','each','few','more','most','other','some','such','no','nor','not','only','own','same','so','than','too','very','s','t','can','will','just','don','should','now']
|
|
||||||
const highlight = (content, term) => {
|
const highlight = (content, term) => {
|
||||||
const highlightWindow = 15
|
const highlightWindow = 20
|
||||||
const tokenizedTerm = term.split(/\s+/).filter(t => t !== "")
|
const tokenizedTerm = term.split(/\s+/).filter(t => t !== "")
|
||||||
const splitText = content.split(/\s+/).filter(t => t !== "")
|
const splitText = content.split(/\s+/).filter(t => t !== "")
|
||||||
const includesCheck = (token) => tokenizedTerm.some(term => token.toLowerCase().includes(term.toLowerCase()))
|
const includesCheck = (token) => tokenizedTerm.some(term => token.toLowerCase().startsWith(term.toLowerCase()))
|
||||||
|
|
||||||
const occurrencesIndices = splitText
|
const occurrencesIndices = splitText
|
||||||
.map(includesCheck)
|
.map(includesCheck)
|
||||||
|
@ -97,7 +94,7 @@
|
||||||
for (let i = 0; i < Math.max(occurrencesIndices.length - highlightWindow, 0); i++) {
|
for (let i = 0; i < Math.max(occurrencesIndices.length - highlightWindow, 0); i++) {
|
||||||
const window = occurrencesIndices.slice(i, i + highlightWindow)
|
const window = occurrencesIndices.slice(i, i + highlightWindow)
|
||||||
const windowSum = window.reduce((total, cur) => total + cur, 0)
|
const windowSum = window.reduce((total, cur) => total + cur, 0)
|
||||||
if (windowSum > bestSum) {
|
if (windowSum >= bestSum) {
|
||||||
bestSum = windowSum
|
bestSum = windowSum
|
||||||
bestIndex = i
|
bestIndex = i
|
||||||
}
|
}
|
||||||
|
@ -119,23 +116,32 @@
|
||||||
}
|
}
|
||||||
|
|
||||||
const resultToHTML = ({url, title, content, term}) => {
|
const resultToHTML = ({url, title, content, term}) => {
|
||||||
const md = content.split("---")[2]
|
const text = removeMarkdown(content)
|
||||||
const text = removeMarkdown(md)
|
|
||||||
const resultTitle = highlight(title, term)
|
const resultTitle = highlight(title, term)
|
||||||
const resultText = highlight(text, term)
|
const resultText = highlight(text, term)
|
||||||
return `<div class="result-card" id="${url}">
|
return `<button class="result-card" id="${url}">
|
||||||
<h3>${resultTitle}</h3>
|
<h3>${resultTitle}</h3>
|
||||||
<p>${resultText}</p>
|
<p>${resultText}</p>
|
||||||
</div>`
|
</button>`
|
||||||
|
}
|
||||||
|
|
||||||
|
const redir = (id, term) => {
|
||||||
|
window.location.href = "{{.Site.BaseURL}}" + `${id}#:~:text=${encodeURIComponent(term)}`
|
||||||
}
|
}
|
||||||
|
|
||||||
const source = document.getElementById('search-bar')
|
const source = document.getElementById('search-bar')
|
||||||
const results = document.getElementById("results-container")
|
const results = document.getElementById("results-container")
|
||||||
|
let term
|
||||||
|
source.addEventListener("keyup", (e) => {
|
||||||
|
if (e.key === "Enter") {
|
||||||
|
const anchor = document.getElementsByClassName("result-card")[0]
|
||||||
|
redir(anchor.id, term)
|
||||||
|
}
|
||||||
|
})
|
||||||
source.addEventListener('input', (e) => {
|
source.addEventListener('input', (e) => {
|
||||||
const term = e.target.value
|
term = e.target.value
|
||||||
contentIndex.search(term, {
|
contentIndex.search(term, {
|
||||||
limit: 5,
|
limit: 15,
|
||||||
depth: 3,
|
|
||||||
suggest: true,
|
suggest: true,
|
||||||
}).then(searchResults => {
|
}).then(searchResults => {
|
||||||
const resultIds = [...new Set(searchResults)]
|
const resultIds = [...new Set(searchResults)]
|
||||||
|
@ -159,9 +165,7 @@
|
||||||
.join("\n")
|
.join("\n")
|
||||||
const anchors = document.getElementsByClassName("result-card");
|
const anchors = document.getElementsByClassName("result-card");
|
||||||
[...anchors].forEach(anchor => {
|
[...anchors].forEach(anchor => {
|
||||||
anchor.onclick = () => {
|
anchor.onclick = () => redir(anchor.id, term)
|
||||||
window.location.href = `${anchor.id}#:~:text=${encodeURIComponent(term)}`
|
|
||||||
}
|
|
||||||
})
|
})
|
||||||
}
|
}
|
||||||
})
|
})
|
||||||
|
@ -203,6 +207,12 @@
|
||||||
searchButton.addEventListener('keydown', (evt) => {
|
searchButton.addEventListener('keydown', (evt) => {
|
||||||
openSearch()
|
openSearch()
|
||||||
})
|
})
|
||||||
|
searchContainer.addEventListener('click', (evt) => {
|
||||||
|
closeSearch()
|
||||||
|
})
|
||||||
|
document.getElementById("search-space").addEventListener('click', (evt) => {
|
||||||
|
evt.stopPropagation()
|
||||||
|
})
|
||||||
})
|
})
|
||||||
|
|
||||||
</script>
|
</script>
|
Loading…
Reference in a new issue