update from sparkleup
This commit is contained in:
parent
3cd889507d
commit
50ff459f1c
Binary file not shown.
|
After Width: | Height: | Size: 60 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 5.8 KiB |
Binary file not shown.
|
|
@ -12,19 +12,16 @@
|
|||
<h1>Zk | 2020-04-22</h1>
|
||||
</header>
|
||||
<article class="content">
|
||||
<p>and welcome! It is with no small sense of irony that I start of a writing SubscribeStar with a bit of writing tech rather than writing itself, but hey, it's the first thing I had on hand. I'll be posting more writing to welcome folks in the coming days, though.</p>
|
||||
<p># Markdown and writing tech</p>
|
||||
<p>Hello and welcome! It is with no small sense of irony that I start of a writing SubscribeStar with a bit of writing tech rather than writing itself, but hey, it's the first thing I had on hand. I'll be posting more writing to welcome folks in the coming days, though.</p>
|
||||
<h1 id="markdown-and-writing-tech">Markdown and writing tech</h1>
|
||||
<p>My entire writing setup has long since shifted over to Markdown. A lot of this started for two big reasons:</p>
|
||||
<ol>
|
||||
<li>I needed to be able to write in a text-only setting such as on a remote machine.</li>
|
||||
<li>
|
||||
<ol>
|
||||
<li>I started using static site generators (Jekyll at first, then Hugo) to host my content.</li>
|
||||
</ol>
|
||||
</li>
|
||||
<li>The latter is particularly relevant lately as I've started to move toward using a personal wiki for storing my writing. The reasoning for this is that it allows me to move between projects and files without leaving my editor. Sounds easy, until you remember point number 1! I've got a whole setup working now, and have gone into that in-depth elsewhere. I'll hold off on the nuts and bolts for now.
|
||||
Instead, I'd like to post about some recent writing tech projects in the form of three Markdown extensions.</li>
|
||||
</ol>
|
||||
<p>The latter is particularly relevant lately as I've started to move toward using a personal wiki for storing my writing. The reasoning for this is that it allows me to move between projects and files without leaving my editor. Sounds easy, until you remember point number 1! I've got a whole setup working now, and have gone into that in-depth elsewhere. I'll hold off on the nuts and bolts for now, but here's how it looks:</p>
|
||||
<p><img alt="Zk" src="/assets/zk.webm" /></p>
|
||||
<p>Instead, I'd like to post about some recent writing tech projects in the form of three Markdown extensions.</p>
|
||||
<h1 id="verse-extension">Verse extension</h1>
|
||||
<p>First, we have the Verse extension. It's dead simple: it looks for a block of text fenced in with triple single-quotes and wraps it in a <code><div class="verse"></code>. For example,</p>
|
||||
<div class="codehilite"><pre><span></span><code><span class="s1">'''</span>
|
||||
|
|
@ -53,16 +50,24 @@ garden in winter<span class="p"></</span><span class="nt">div</span><span cla
|
|||
<h1 id="vimwiki-extensions">Vimwiki extensions</h1>
|
||||
<p>Vimwiki, the personal wiki I use, has its own markup format which...is fine? Like, it's okay. the problem is that it's just dissimilar enough from Markdown that I have a hard time remembering the differences. Even if I were to remember them, when I transfer my files to hosting on a static site, they'd be in the wrong format.</p>
|
||||
<p>Notably, I want the six-level to-do lists - representing rejected, not started, three levels of incomplete, and complete tasks - and for the tags vimwiki uses - in the format :tag1:tag2:etc: - to be displayed properly. Thus:</p>
|
||||
<div class="codehilite"><pre><span></span><code><span class="o">*</span><span class="w"> </span><span class="o">[</span><span class="n"> </span><span class="o">]</span><span class="w"> </span><span class="n">Idea</span><span class="w"></span>
|
||||
<span class="o">*</span><span class="w"> </span><span class="o">[</span><span class="n"> </span><span class="o">]</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="o">[</span><span class="n">.</span><span class="o">]</span><span class="w"> </span><span class="n">Stub</span><span class="w"></span>
|
||||
<span class="o">*</span><span class="w"> </span><span class="o">[</span><span class="n"> </span><span class="o">]</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="o">[</span><span class="n">o</span><span class="o">]</span><span class="w"> </span><span class="n">Alpha</span><span class="w"></span>
|
||||
<span class="o">*</span><span class="w"> </span><span class="o">[</span><span class="n"> </span><span class="o">]</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="o">[</span><span class="n">O</span><span class="o">]</span><span class="w"> </span><span class="n">Beta</span><span class="w"></span>
|
||||
<span class="o">*</span><span class="w"> </span><span class="o">[</span><span class="n"> </span><span class="o">]</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="o">[</span><span class="n">X</span><span class="o">]</span><span class="w"> </span><span class="n">Released</span><span class="w"></span>
|
||||
<div class="codehilite"><pre><span></span><code><span class="o">*</span><span class="w"> </span><span class="o">[</span><span class="n">-</span><span class="o">]</span><span class="w"> </span><span class="n">Rejected</span><span class="w"></span>
|
||||
<span class="o">*</span><span class="w"> </span><span class="o">[</span><span class="n"> </span><span class="o">]</span><span class="w"> </span><span class="n">Idea</span><span class="w"></span>
|
||||
<span class="o">*</span><span class="w"> </span><span class="o">[</span><span class="n">.</span><span class="o">]</span><span class="w"> </span><span class="n">Stub</span><span class="w"></span>
|
||||
<span class="o">*</span><span class="w"> </span><span class="o">[</span><span class="n">o</span><span class="o">]</span><span class="w"> </span><span class="n">Alpha</span><span class="w"></span>
|
||||
<span class="o">*</span><span class="w"> </span><span class="o">[</span><span class="n">O</span><span class="o">]</span><span class="w"> </span><span class="n">Beta</span><span class="w"></span>
|
||||
<span class="o">*</span><span class="w"> </span><span class="o">[</span><span class="n">X</span><span class="o">]</span><span class="w"> </span><span class="n">Released</span><span class="w"></span>
|
||||
</code></pre></div>
|
||||
|
||||
|
||||
<p>Turns into:</p>
|
||||
<p><img alt="Rendered todo list" src="/assets/todo-rendered.png" /></p>
|
||||
<ul>
|
||||
<li class="rejected"> Rejected</li>
|
||||
<li class="done0"> Idea</li>
|
||||
<li class="done1"> Stub</li>
|
||||
<li class="done2"> Alpha</li>
|
||||
<li class="done3"> Beta</li>
|
||||
<li class="done4"> Released</li>
|
||||
</ul>
|
||||
<p>when rendered into HTML.</p>
|
||||
<h1 id="editing-extension">Editing extension</h1>
|
||||
<p>Probably the largest of the extensions, though, is the editing extension which allows me to put editing marks within Markdown similar to how "Track Changes" and comments in LibreOffice/Word work. I can insert, delete, and substitute text, as well as comment on a selected passage or add a single comment per line.</p>
|
||||
|
|
|
|||
Loading…
Reference in New Issue