<!DOCTYPE html> <html><head><title>README</title><meta charSet="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0"/><meta property="og:title" content="README"/><meta property="og:description" content="本仓库用于备份本地 Obsidian 的笔记文件，用于管理，组织个人笔记。为保证数据的兼容性，所有笔记尽量只使用 Markdown 的标准语法。 下面介绍我的笔记发布流程。整个过程大致如下： Obsidian 中编辑内容 -&gt; 推送至私有仓库 -&gt; 触发 action，将内容过滤筛选后以覆盖的形式推送至私有 quartz 仓库 -&gt; 再次触发 action 构建页面并发布至 github page。 其中只有最后的 github page 仓库是 public 的，这样做是为了避免对外展示不必要的内容。同时如果你的 Obsidian 的 valut 中包含很多体积较大的文件，那么可能并不适合使用 github 的个人免费版本，因为 lfs 的容量是有限的，可考虑搭建自己的 git 服务器。 文章的发布使用了 quartz 项目，它可以将 md 文章生成静态页面，该项目基于 hugo，相比传统 hugo 主题，最大的不同是与 obsidian 的设计理念类似，以链接的形式串联你的知识。 使用 quartz 时，若不希望文章被发布可在 md 中添加 metadata，这也是我使用最多的方式，其它方式可参考 Ignoring Notes。 draft: true 为什么我没有选择直接将原本的存放笔记的仓库和 quartz 合并？ 主要目的是不想改变已有的笔记仓库的结构，其次拆分增加了可操作性，毕竟目前 quartz 项目还处于快速迭代的阶段，可能会有许多问题。."/><meta property="og:image" content="https://quartz.jzhao.xyz/static/og-image.png"/><meta property="og:width" content="1200"/><meta property="og:height" content="675"/><link rel="icon" href="./static/icon.png"/><meta name="description" content="本仓库用于备份本地 Obsidian 的笔记文件，用于管理，组织个人笔记。为保证数据的兼容性，所有笔记尽量只使用 Markdown 的标准语法。 下面介绍我的笔记发布流程。整个过程大致如下： Obsidian 中编辑内容 -&gt; 推送至私有仓库 -&gt; 触发 action，将内容过滤筛选后以覆盖的形式推送至私有 quartz 仓库 -&gt; 再次触发 action 构建页面并发布至 github page。 其中只有最后的 github page 仓库是 public 的，这样做是为了避免对外展示不必要的内容。同时如果你的 Obsidian 的 valut 中包含很多体积较大的文件，那么可能并不适合使用 github 的个人免费版本，因为 lfs 的容量是有限的，可考虑搭建自己的 git 服务器。 文章的发布使用了 quartz 项目，它可以将 md 文章生成静态页面，该项目基于 hugo，相比传统 hugo 主题，最大的不同是与 obsidian 的设计理念类似，以链接的形式串联你的知识。 使用 quartz 时，若不希望文章被发布可在 md 中添加 metadata，这也是我使用最多的方式，其它方式可参考 Ignoring Notes。 draft: true 为什么我没有选择直接将原本的存放笔记的仓库和 quartz 合并？ 主要目的是不想改变已有的笔记仓库的结构，其次拆分增加了可操作性，毕竟目前 quartz 项目还处于快速迭代的阶段，可能会有许多问题。."/><meta name="generator" content="Quartz"/><link rel="preconnect" href="https://fonts.googleapis.com"/><link rel="preconnect" href="https://fonts.gstatic.com"/><link href="./index.css" rel="stylesheet" type="text/css" spa-preserve/><link href="https://cdn.jsdelivr.net/npm/katex@0.16.0/dist/katex.min.css" rel="stylesheet" type="text/css" spa-preserve/><link href="https://fonts.googleapis.com/css2?family=IBM Plex Mono&family=Schibsted Grotesk:wght@400;700&family=Source Sans Pro:ital,wght@0,400;0,600;1,400;1,600&display=swap" rel="stylesheet" type="text/css" spa-preserve/><script src="./prescript.js" type="application/javascript" spa-preserve></script><script type="application/javascript" spa-preserve>const fetchData = fetch(`./static/contentIndex.json`).then(data => data.json())</script></head><body data-slug="README"><div id="quartz-root" class="page"><div id="quartz-body"><div class="left sidebar"><h1 class="page-title"><a href=".">🪴 Quartz 4.0</a></h1><div class="spacer mobile-only"></div><div class="search"><div id="search-icon"><p>Search</p><div></div><svg tabIndex="0" aria-labelledby="title desc" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 19.9 19.7"><title id="title">Search</title><desc id="desc">Search</desc><g class="search-path" fill="none"><path stroke-linecap="square" d="M18.5 18.3l-5.4-5.4"></path><circle cx="8" cy="8" r="7"></circle></g></svg></div><div id="search-container"><div id="search-space"><input autocomplete="off" id="search-bar" name="search" type="text" aria-label="Search for something" placeholder="Search for something"/><div id="results-container"></div></div></div></div><div class="darkmode"><input class="toggle" id="darkmode-toggle" type="checkbox" tabIndex="-1"/><label id="toggle-label-light" for="darkmode-toggle" tabIndex="-1"><svg xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink" version="1.1" id="dayIcon" x="0px" y="0px" viewBox="0 0 35 35" style="enable-background:new 0 0 35 35;" xmlSpace="preserve"><title>Light mode</title><path d="M6,17.5C6,16.672,5.328,16,4.5,16h-3C0.672,16,0,16.672,0,17.5 S0.672,19,1.5,19h3C5.328,19,6,18.328,6,17.5z M7.5,26c-0.414,0-0.789,0.168-1.061,0.439l-2,2C4.168,28.711,4,29.086,4,29.5 C4,30.328,4.671,31,5.5,31c0.414,0,0.789-0.168,1.06-0.44l2-2C8.832,28.289,9,27.914,9,27.5C9,26.672,8.329,26,7.5,26z M17.5,6 C18.329,6,19,5.328,19,4.5v-3C19,0.672,18.329,0,17.5,0S16,0.672,16,1.5v3C16,5.328,16.671,6,17.5,6z M27.5,9 c0.414,0,0.789-0.168,1.06-0.439l2-2C30.832,6.289,31,5.914,31,5.5C31,4.672,30.329,4,29.5,4c-0.414,0-0.789,0.168-1.061,0.44 l-2,2C26.168,6.711,26,7.086,26,7.5C26,8.328,26.671,9,27.5,9z M6.439,8.561C6.711,8.832,7.086,9,7.5,9C8.328,9,9,8.328,9,7.5 c0-0.414-0.168-0.789-0.439-1.061l-2-2C6.289,4.168,5.914,4,5.5,4C4.672,4,4,4.672,4,5.5c0,0.414,0.168,0.789,0.439,1.06 L6.439,8.561z M33.5,16h-3c-0.828,0-1.5,0.672-1.5,1.5s0.672,1.5,1.5,1.5h3c0.828,0,1.5-0.672,1.5-1.5S34.328,16,33.5,16z M28.561,26.439C28.289,26.168,27.914,26,27.5,26c-0.828,0-1.5,0.672-1.5,1.5c0,0.414,0.168,0.789,0.439,1.06l2,2 C28.711,30.832,29.086,31,29.5,31c0.828,0,1.5-0.672,1.5-1.5c0-0.414-0.168-0.789-0.439-1.061L28.561,26.439z M17.5,29 c-0.829,0-1.5,0.672-1.5,1.5v3c0,0.828,0.671,1.5,1.5,1.5s1.5-0.672,1.5-1.5v-3C19,29.672,18.329,29,17.5,29z M17.5,7 C11.71,7,7,11.71,7,17.5S11.71,28,17.5,28S28,23.29,28,17.5S23.29,7,17.5,7z M17.5,25c-4.136,0-7.5-3.364-7.5-7.5 c0-4.136,3.364-7.5,7.5-7.5c4.136,0,7.5,3.364,7.5,7.5C25,21.636,21.636,25,17.5,25z"></path></svg></label><label id="toggle-label-dark" for="darkmode-toggle" tabIndex="-1"><svg xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink" version="1.1" id="nightIcon" x="0px" y="0px" viewBox="0 0 100 100" style="enable-background='new 0 0 100 100'" xmlSpace="preserve"><title>Dark mode</title><path d="M96.76,66.458c-0.853-0.852-2.15-1.064-3.23-0.534c-6.063,2.991-12.858,4.571-19.655,4.571 C62.022,70.495,50.88,65.88,42.5,57.5C29.043,44.043,25.658,23.536,34.076,6.47c0.532-1.08,0.318-2.379-0.534-3.23 c-0.851-0.852-2.15-1.064-3.23-0.534c-4.918,2.427-9.375,5.619-13.246,9.491c-9.447,9.447-14.65,22.008-14.65,35.369 c0,13.36,5.203,25.921,14.65,35.368s22.008,14.65,35.368,14.65c13.361,0,25.921-5.203,35.369-14.65 c3.872-3.871,7.064-8.328,9.491-13.246C97.826,68.608,97.611,67.309,96.76,66.458z"></path></svg></label></div></div><div class="center"><div class="page-header"><div class="popover-hint"><h1 class="article-title">README</h1><p class="content-meta">Oct 31, 2023, 3 min read</p><ul class="tags"><li><a href="./tags/readme" class="internal tag-link">#readme</a></li></ul></div></div><article class="popover-hint"><p>本仓库用于备份本地 <code>Obsidian</code> 的笔记文件，用于管理，组织个人笔记。为保证数据的兼容性，所有笔记尽量只使用 <code>Markdown</code> 的标准语法。</p> <p>下面介绍我的笔记发布流程。整个过程大致如下：</p> <ul> <li><code>Obsidian</code> 中编辑内容 -></li> <li>推送至私有仓库 -></li> <li>触发 <code>action</code>，将内容过滤筛选后以覆盖的形式推送至私有 <code>quartz</code> 仓库 -></li> <li>再次触发 <code>action</code> 构建页面并发布至 <a href="https://trganda.github.io/" class="external">github page</a>。</li> </ul> <p>其中只有最后的 <a href="https://github.com/trganda/trganda.github.io" class="external">github page</a> 仓库是 <code>public</code> 的，这样做是为了避免对外展示不必要的内容。同时如果你的 <code>Obsidian</code> 的 <code>valut</code> 中包含很多体积较大的文件，那么可能并不适合使用 <code>github</code> 的个人免费版本，因为 <code>lfs</code> 的容量是有限的，可考虑搭建自己的 <code>git</code> 服务器。</p> <p>文章的发布使用了 <a href="https://github.com/jackyzha0/quartz" class="external">quartz</a> 项目，它可以将 <code>md</code> 文章生成静态页面，该项目基于 <code>hugo</code>，相比传统 <code>hugo</code> 主题，最大的不同是与 <code>obsidian</code> 的设计理念类似，以链接的形式串联你的知识。</p> <p>使用 <a href="https://github.com/jackyzha0/quartz" class="external">quartz</a> 时，若不希望文章被发布可在 <code>md</code> 中添加 <code>metadata</code>，这也是我使用最多的方式，其它方式可参考 <a href="https://quartz.jzhao.xyz/notes/ignore-notes/" class="external">Ignoring Notes</a>。</p> <pre><code>draft: true </code></pre> <p>为什么我没有选择直接将原本的存放笔记的仓库和 <a href="https://github.com/jackyzha0/quartz" class="external"><code>quartz</code></a> 合并？</p> <p>主要目的是不想改变已有的笔记仓库的结构，其次拆分增加了可操作性，毕竟目前 <a href="https://github.com/jackyzha0/quartz" class="external"><code>quartz</code></a> 项目还处于快速迭代的阶段，可能会有许多问题。</p></article></div><div class="right sidebar"><div class="graph"><h3>Graph View</h3><div class="graph-outer"><div id="graph-container" data-cfg="{"drag":true,"zoom":true,"depth":1,"scale":1.1,"repelForce":0.5,"centerForce":0.3,"linkDistance":30,"fontSize":0.6,"opacityScale":1}"></div><svg version="1.1" id="global-graph-icon" xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink" x="0px" y="0px" viewBox="0 0 55 55" fill="currentColor" xmlSpace="preserve"><path d="M49,0c-3.309,0-6,2.691-6,6c0,1.035,0.263,2.009,0.726,2.86l-9.829,9.829C32.542,17.634,30.846,17,29,17 s-3.542,0.634-4.898,1.688l-7.669-7.669C16.785,10.424,17,9.74,17,9c0-2.206-1.794-4-4-4S9,6.794,9,9s1.794,4,4,4 c0.74,0,1.424-0.215,2.019-0.567l7.669,7.669C21.634,21.458,21,23.154,21,25s0.634,3.542,1.688,4.897L10.024,42.562 C8.958,41.595,7.549,41,6,41c-3.309,0-6,2.691-6,6s2.691,6,6,6s6-2.691,6-6c0-1.035-0.263-2.009-0.726-2.86l12.829-12.829 c1.106,0.86,2.44,1.436,3.898,1.619v10.16c-2.833,0.478-5,2.942-5,5.91c0,3.309,2.691,6,6,6s6-2.691,6-6c0-2.967-2.167-5.431-5-5.91 v-10.16c1.458-0.183,2.792-0.759,3.898-1.619l7.669,7.669C41.215,39.576,41,40.26,41,41c0,2.206,1.794,4,4,4s4-1.794,4-4 s-1.794-4-4-4c-0.74,0-1.424,0.215-2.019,0.567l-7.669-7.669C36.366,28.542,37,26.846,37,25s-0.634-3.542-1.688-4.897l9.665-9.665 C46.042,11.405,47.451,12,49,12c3.309,0,6-2.691,6-6S52.309,0,49,0z M11,9c0-1.103,0.897-2,2-2s2,0.897,2,2s-0.897,2-2,2 S11,10.103,11,9z M6,51c-2.206,0-4-1.794-4-4s1.794-4,4-4s4,1.794,4,4S8.206,51,6,51z M33,49c0,2.206-1.794,4-4,4s-4-1.794-4-4 s1.794-4,4-4S33,46.794,33,49z M29,31c-3.309,0-6-2.691-6-6s2.691-6,6-6s6,2.691,6,6S32.309,31,29,31z M47,41c0,1.103-0.897,2-2,2 s-2-0.897-2-2s0.897-2,2-2S47,39.897,47,41z M49,10c-2.206,0-4-1.794-4-4s1.794-4,4-4s4,1.794,4,4S51.206,10,49,10z"></path></svg></div><div id="global-graph-outer"><div id="global-graph-container" data-cfg="{"drag":true,"zoom":true,"depth":-1,"scale":0.9,"repelForce":0.5,"centerForce":0.3,"linkDistance":30,"fontSize":0.6,"opacityScale":1}"></div></div></div><div class="backlinks"><h3>Backlinks</h3><ul class="overflow"><li><a href="." class="internal">Trganda's Site</a></li></ul></div></div></div><footer><hr/><p>Created with <a href="https://quartz.jzhao.xyz/">Quartz v4.0.9</a>, © 2024</p><ul><li><a href="https://github.com/trganda">GitHub</a></li><li><a href="https://twitter.com/MarrowSix">Twitter</a></li></ul></footer></div></body><script type="application/javascript">// quartz/components/scripts/quartz/components/scripts/callout.inline.ts function toggleCallout() { const outerBlock = this.parentElement; outerBlock.classList.toggle(`is-collapsed`); const collapsed = outerBlock.classList.contains(`is-collapsed`); const height = collapsed ? this.scrollHeight : outerBlock.scrollHeight; outerBlock.style.maxHeight = height + `px`; let current = outerBlock; let parent = outerBlock.parentElement; while (parent) { if (!parent.classList.contains(`callout`)) { return; } const collapsed2 = parent.classList.contains(`is-collapsed`); const height2 = collapsed2 ? parent.scrollHeight : parent.scrollHeight + current.scrollHeight; parent.style.maxHeight = height2 + `px`; current = parent; parent = parent.parentElement; } } function setupCallout() { const collapsible = document.getElementsByClassName( `callout is-collapsible` ); for (const div of collapsible) { const title = div.firstElementChild; if (title) { title.removeEventListener(`click`, toggleCallout); title.addEventListener(`click`, toggleCallout); const collapsed = div.classList.contains(`is-collapsed`); const height = collapsed ? title.scrollHeight : div.scrollHeight; div.style.maxHeight = height + `px`; } } } document.addEventListener(`nav`, setupCallout); window.addEventListener(`resize`, setupCallout); </script><script type="module"> import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.esm.min.mjs'; const darkMode = document.documentElement.getAttribute('saved-theme') === 'dark' mermaid.initialize({ startOnLoad: false, securityLevel: 'loose', theme: darkMode ? 'dark' : 'default' }); document.addEventListener('nav', async () => { await mermaid.run({ querySelector: '.mermaid' }) }); </script><script src="https://cdn.jsdelivr.net/npm/katex@0.16.7/dist/contrib/copy-tex.min.js" type="application/javascript"></script><script src="./postscript.js" type="module"></script></html>