<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet href="/rss.xsl" type="text/xsl"?>
<rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/">
  <channel>
   <title>The Plain Text Project</title>
   <link>https://plaintextproject.online</link>
   <description>Musings on living and working in plain text</description>
   
   <item>
  <title>Closing Shop</title>
 <link>https://plaintextproject.online/articles/2022/12/21/closing.html</link>
 <guid>https://plaintextproject.online/articles/2022/12/21/closing.html</guid>
  <pubDate>Wed, 21 Dec 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   The Plain Text Project is closing shop. Here's why
   ]]></description>
  <content:encoded><![CDATA[
   <p>After six years and I don’t know how many articles, it’s time to close shop. This is the last item I’ll be posting to The Plain Text Project. Ever.</p>
<p>Why? I’ve started to realize that over the last several months, I’ve been going in circles in this space. While the circle is a nice, safe, aesthetically-pleasing shape it’s not my favourite shape. I really don't see the point of continually treading the same path, no matter how comfortable doing that is.</p>
<p>Looking back at everything I’ve published here over the years, it’s dawned on me that I’ve said everything I <em>can</em> say about plain text. Everything I've <em>needed</em> to say about plain text. And everything I've <em>wanted</em> to say about plain text. There’s definitely more to write on this subject, but I’m not the one to do it.</p>
<p>The Plain Text Project isn’t going to disappear off the interwebs. I’m going to keep it alive for as long as I can. The domain’s registration is good until the end of May, 2023. On the off chance that I don’t renew the domain, <em>https://scottnesbitt.gitlab.io/</em> should continue to work.</p>
<p>Thanks for joining me on this journey. It’s been fun, interesting, and a great learning experience for me. I hope it's been that for you, too.</p>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Four Links - December 13, 2022</title>
 <link>https://plaintextproject.online/articles/2022/12/13/links.html</link>
 <guid>https://plaintextproject.online/articles/2022/12/13/links.html</guid>
  <pubDate>Tue, 13 Dec 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   Four links to articles that look at some interesting ways to use plain text
   ]]></description>
  <content:encoded><![CDATA[
   <ul>
<li><a href="https://rtzptz.xyz/posts/2021-09-29-blogging-with-org/" target="_blank">Publishing your own website with Emacs and hugo</a></li>
<li><a href="https://www.sitepoint.com/learn-markdown/" target="_blank">Learn Markdown: Structure, Syntax, and Conventions</a></li>
<li><a href="https://tobiasschmidt.me/posts/minimalist-meeting-minutes/" target="_blank">Minimalist Meeting Minutes</a></li>
<li><a href="https://helgeklein.com/blog/vs-code-as-markdown-note-taking-app/" target="_blank">VS Code as Markdown Note-Taking App</a></li>
</ul>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Taking Another Look at Obsidian</title>
 <link>https://plaintextproject.online/articles/2022/12/06/obsidian.html</link>
 <guid>https://plaintextproject.online/articles/2022/12/06/obsidian.html</guid>
  <pubDate>Tue, 06 Dec 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   A short chronicle of my second attempt at using the popular note taking (and more) tool Obsidian
   ]]></description>
  <content:encoded><![CDATA[
   <p>You might remember that I <a href="../../02/02/obsidian.html">took a look</a> at a popular piece of software called <a href="https://obsidian.md" target="_blank">Obsidian</a> earlier in 2022. That article provoked a few … shall we say <em>interesting</em> reactions from a couple or three fans of the application.</p>
<p>Jump forward a few months to September, 2022. While I did work with Obsidian for close to five weeks when I first gave it a test drive, I had a lingering feeling that I didn’t give Obsidian enough of a chance. And that I didn’t give it enough of a chance to grow on me. So, in late winter/early spring, 2022 (in the southern hemisphere), I decided to give Obsidian another go.</p>
<p>This time, my goal was to use Obsidian exclusively for my work — no dedicated <a href="https://gum.co/learnmarkdown" target="_blank">Markdown</a> editor, no dedicated note taking tool, outliner, journal, or task management app. Just Obsidian.</p>
<p>Here’s an account of how my second attempt at using Obsidian went.</p>
<h2 id="starting-with-a-plan">Starting with a Plan</h2>
<p>The problem with Obsidian, or any tool like it, is that it’s <em>too</em> flexible. You can do, and often try to do, <em>everything</em> with it. Trying to do everything with Obsidian leaves you overwhelmed by the possibilities.</p>
<p>In trying to do everything, you don’t do everything that you need to do. Not by a long shot. Instead, you get pulled into the vortex of test driving plugins, themes, and templates. You look for tips and tricks. You try out workflows that are often not right for your purposes. You twiddle and twern instead of doing the work.</p>
<p>I have to admit that’s kind of what happened to me during my first go ’round with Obsidian. This time, though, I started with a plan. Specifically, focusing on what I <em>needed</em> to do with the application rather than on everything that I <em>could</em> do with Obsidian.</p>
<p>Those tasks were:</p>
<ul>
<li>Taking notes.</li>
<li>Keeping a journal.</li>
<li>Creating outlines for my writing.</li>
<li>Writing drafts of blog posts and articles.</li>
<li>Maintaining my task list.</li>
<li>Creating my daily plan/schedule.</li>
</ul>
<p>I didn’t try to use Obsidian for life logging, for planning and tracking workouts, for quantifying myself, for saving recipes or articles or interesting quotes, or for capturing anything and everything. I didn’t think about functions that I never use, about use cases that aren't mine, or about how someone else uses Obsidian.</p>
<p>There are a few people who will say that the way in which I use Obsidian is <em>boring</em> and that I’m not using it <em>to its full potential</em> (whatever that means). That’s their opinion, but I don’t find tools to be an endless source of fascination or as lands of discovery. Nor do I try to tweak or push the tools that I use as far as I can take them. I don’t see any need to do that. I use tools to get things done with the minimum of effort. That’s it.</p>
<h2 id="getting-started">Getting Started</h2>
<p>As I did with my previous attempt at working with Obsidian, I set up a vault (in Obsidian’s parlance, <em>a local folder of plain text <a href="https://scottnesbitt.gumroad.com/l/learnmarkdown" target="_blank">Markdown</a> files</em>) in Nextcloud to sync my work and my application settings across my laptops. I also created a folder structure to better organize my work. That structure looked something like this:</p>
<p><img src="../../../../images/obsidian-redux/obsidian-folders.png" alt="Folders in my Obsidian vault" /><br />
</p>
<p>I dropped the templates that I use for blogging and writing into one of those folders, and also created templates for tasks, my daily schedule, and my weekly recaps.</p>
<p>With that out of the way, I installed and fired up Obsidian. When prompted, I pointed it to that vault and was ready to go.</p>
<p>I also installed or enabled a handful of plugins that I thought would be useful to me:</p>
<ul>
<li>Checklist</li>
<li>Better Word Count</li>
<li>Markdown Prettifier</li>
<li>Obsidian Tabs</li>
<li>Outline</li>
<li>Pandoc Plugin</li>
<li>Tasks</li>
</ul>
<p>I could have installed more, but the others that looked at (while interesting) weren’t much use to me. Looking back, there were probably a few plugins that I installed which I didn't actually need.</p>
<h2 id="getting-to-work">Getting to Work</h2>
<p>Once I had Obsidian set up, I removed <a href="../../01/04/apostrophe.html">Apostrophe</a> and <a href="../../../2018/03/01/standard.html">Standard Notes</a> from the dock on my desktop. Out of sight, out of mind and all that. I put Obsidian in the dock so it was front and centre.</p>
<p>For the first few days, firing up Obsidian as my go-to app was a bit harder than I expected. It really <em>is</em> difficult to shift habits … I’m not sure that using Obsidian became natural, but automatically turning to Obsidian became easier as time went on.</p>
<p>Working in Obsidian’s editor is just like working in any other <a href="https://gum.co/learnmarkdown" target="_blank">Markdown</a> or text editor. I tend to add formatting by hand, so I don’t miss toolbars or anything like that. Having said that, I couldn’t find a way to change the editor’s font — I prefer to work with a monospaced font rather than the default. I did try a plugin that offers more options to change Obsidian’s appearance but it suddenly stopped playing nicely with the application and I had to delete it.</p>
<p>Since I use <a href="../../../2019/01/02/writeas.html">Write.as</a> to do a lot of my web publishing, my workflow there didn’t change. I copied and pasted my posts from Obsidian into Write.as, in the same way I did when using Apostrophe.</p>
<p>Where things got a bit more convoluted was with articles for the Plain Text Project. I write those articles in Markdown and <a href="../../../2020/11/05/migration.html">use a script</a> to convert them to HTML. Getting those articles ready for publication required a couple of extra steps.</p>
<p>With everything else, using Obsidian was a mixed bag. I liked having, for example, my task lists and notes and schedules in one place. But that's something I can do with other applications, like Standard Notes or Joplin. In that way, Obsidian didn't offer any advantage over what I'm currently using.</p>
<h2 id="summing-up">Summing Up</h2>
<p>I ended my second experiment with Obsidian after just a little over eight weeks. I can’t say that Obsidian grew on me, or that I grew into it. I came to the same conclusion this time around as I did with my first experiment with Obsidian. It’s a solid solution for someone who needs a tool like this.</p>
<p>Aside from keeping everything in one place, Obsidian doesn’t offer me much beyond what I normally use to do my work. As I said in <a href="../../02/02/obsidian.html">my previous look</a> at Obsidian, it’s a solution for someone whose work and thinking has more scope than mine, is deeper than mine, which has more parts (moving and otherwise) than mine.</p>
<p>Obsidian just isn't for me. And I don't think it ever will be.</p>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Four Links - November 29, 2022</title>
 <link>https://plaintextproject.online/articles/2022/11/29/links.html</link>
 <guid>https://plaintextproject.online/articles/2022/11/29/links.html</guid>
  <pubDate>Tue, 29 Nov 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   Another set of four interesting links that look at using plain text
   ]]></description>
  <content:encoded><![CDATA[
   <ul>
<li><a href="https://47nil.com/plaintext.html" target="_blank">More on Plain Text</a></li>
<li><a href="https://jeffreymoro.com/blog/2020-09-21-how-i-write/" target="_blank">How I Write</a></li>
<li><a href="https://www.smashingmagazine.com/2022/02/thoughts-on-markdown/" target="_blank">Thoughts On Markdown</a></li>
<li><a href="https://www.marcusquinn.com/plain-text-markdown/" target="_blank">Plain Text &amp; Markdown #</a></li>
</ul>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Working in Plain Text with Geany</title>
 <link>https://plaintextproject.online/articles/2022/11/08/geany.html</link>
 <guid>https://plaintextproject.online/articles/2022/11/08/geany.html</guid>
  <pubDate>Tue, 08 Nov 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   A look at a programmer's text editor that anyone can use to work with plain text
   ]]></description>
  <content:encoded><![CDATA[
   <p>(<strong>Note:</strong> This article was first published, in a different form, at <a href="https://opensourcemusings.com/taking-another-look-at-geany" target="_blank">Open Source Musings</a> and appears here via a <a href="https://creativecommons.org/licenses/by-sa/4.0/" target="_blank">CC-BY-SA 4.0</a> license.)</p>
<p>In my work in <a href="https://plaintextproject.online" target="_blank">this space</a> and <a href="https://opensourcemusings.com" target="_blank">elsewhere</a> over the years, I’ve looked at … well, <em>a lot</em> of text editors. And when the fives of people who read what I write don’t see their favourite editor in an article, they suggest I include it.</p>
<p>Besides the usual suspects, one editor that keeps popping up is <a href="https://geany.org/" target="_blank">Geany</a>. While I haven’t written a lot about Geany, I’m not unfamiliar with it. Despite being aimed at developers, Geany was for years the editor I used when working with LaTeX documents.</p>
<p>Since it’s been quite some time since I’ve used it, I recently decided to give Geany another look. Let’s jump in.</p>
<h2 id="why-geany">Why Geany?</h2>
<p>When I mentioned that I was writing this post, a few people asked me why I was looking at a developer’s editor when I advocate using <a href="../../../2019/06/18/texted.html">simple text editors</a>. That’s a good question.</p>
<p>In my mind, Geany occupies an interesting middle ground. While it’s flexible enough for a number of development tasks, Geany is also light enough for anyone, regardless of their level of technical skill, to use for with their work in plain text. However simple or involved that work may be.</p>
<h2 id="getting-geany">Getting Geany</h2>
<p>If you’re a Linux user, try installing it using your distribution’s package manager. If you want to go all hardcore techie, then you can try <a href="https://www.geany.org/download/releases/" target="_blank">grabbing the source code</a> and compiling it yourself.</p>
<p>Geany isn’t only available for Linux. You can get installers for <a href="https://www.geany.org/download/releases/" target="_blank">Windows or macOS</a>. There’s even <a href="https://portableapps.com/apps/development/geany_portable" target="_blank">a version</a> of the editor for <a href="https://portableapps.com/" target="_blank">PortableApps</a> (a platform for running Windows applications off a USB flash drive).</p>
<p>Once you have it installed, fire up Geany.</p>
<h2 id="using-geany">Using Geany</h2>
<p>As you’ve probably guessed, using Geany is like using any other text editor. You create or open a text file and start typing. Nothing too fancy or complicated there. If the file you open uses a markup language, and that language is supported in the editor, Geany applies syntax highlighting to it.</p>
<figure>
<img src="../../../../images/geany/geany-syntax-highlighting.png" alt="A file in Geany with syntax highlighting" />
</figure>
<p>You can create a file based on one or more templates by selecting <strong>File &gt; New (with Template)</strong>. Most of the templates are for writing software, although there are templates for HTML, HTML5, and LaTeX documents, too. You can even add <a href="https://www.geany.org/manual/current/index.html#adding-file-templates" target="_blank">your own templates</a>. I haven’t tried that, if only because I have other templates that I use.</p>
<p>The editor also has a few other useful features, including word count, line wrapping, and a very good search and replace function. Geany doesn’t come with a spelling checker out of the box, but you can add one. More on this in a moment.</p>
<h2 id="configuring-geany">Configuring Geany</h2>
<p>Like most software these days, you can tweak Geany so that it’s to your liking. To do that, select <strong>Edit &gt; Preferences</strong>.</p>
<figure>
<img src="../../../../images/geany/geany-preferences.png" alt="Setting Geany’s preferences" />
</figure>
<p>You can change the editor’s <a href="../../../2020/03/03/fonts.html">font</a>, whether or not and what to display on the toolbar, change shortcut keys, and a whole lot more. Beyond setting the font and a couple of other options, I ignore most of the preferences. If you’re interested, you can learn more about Geany’s preferences in <a href="https://www.geany.org/manual/current/index.html#preferences" target="_blank">the editor’s documentation</a>.</p>
<p>On top of that, you can also <a href="https://geany.org/download/themes/" target="_blank">change the editor’s colour scheme</a>. You can, for example, add a dark theme or one to give Geany a theme that looks more like the ones used in Gedit or <a href="../../03/02/npp.html">Notepad++</a>.</p>
<h2 id="plugins">Plugins</h2>
<p>A few paragraphs ago, I mentioned that you can add a spelling checker to Geany. To do that, you need to install <a href="https://geany.org/support/plugins/" target="_blank">a plugin</a>. As you’ve probably guessed, plugins enable you to add to the editor’s functions.</p>
<p>When you install it, Geany comes with six plugins. They do a few basic things, like exporting files, enabling you to split windows, and to insert <a href="https://www.w3schools.com/html/html_entities.asp" target="_blank">HTML entities</a>. You can install <a href="https://plugins.geany.org/" target="_blank">other plugins</a>. Aside from spelling checker and LaTeX plugins, I have no use for the other plugins. Your mileage may vary.</p>
<p>After you’ve installed plugins, you can enable, disable, or configure them by selecting <strong>Tools &gt; Plugin Manager</strong>.</p>
<figure>
<img src="../../../../images/geany/geany-plugin-manager.png" alt="Geany’s plugin manager" />
</figure>
<h2 id="making-geany-look-a-little-less-techie">Making Geany (Look) a Little Less Techie</h2>
<p>Geany looks like this when you first fire it up after installation:</p>
<p><img src="../../../../images/geany/geany-first-start.png" alt="Geany after you first start it" /><br />
</p>
<p>If you aren’t a developer, there’s a lot of clutter there. At first sight, you might even think <em>This really isn’t for me</em>.</p>
<p>If you don’t need a lot of you see (and chances are you don’t), you can get rid of it. To do that, click the <strong>View</strong> menu and deselect these options:</p>
<ul>
<li>Show Line Numbers</li>
<li>Show Message Window</li>
<li>Show Sidebar</li>
</ul>
<p>You can also remove toolbar buttons you don’t use by right clicking on the toolbar and selecting <strong>Toolbar Preferences</strong>. In the window that displays, click <strong>Customize Toolbar</strong>.</p>
<p><img src="../../../../images/geany/geany-customize-toolbar.png" alt="Removing items from Geany’s toolbar" /><br />
</p>
<p>Select an item from the left column and click the <strong>&lt;</strong> button to remove it.</p>
<p>After you remove everything you don’t need, Geany has a slightly more streamlined look. This is what the editor looks like for me:</p>
<p><img src="../../../../images/geany/geany-without-extras.png" alt="Geany without the frills" /><br />
</p>
<h2 id="final-thoughts">Final Thoughts</h2>
<p>Although Geany is billed as a developer’s editor, it’s also a very good general purpose text editor. It’s surprisingly fast for an editor that packs the number of features that it does.</p>
<p>While I like Geany and find it useful, it’s not my editor of choice at the moment. But because I don’t use it doesn’t make Geany a bad editor. Far from it. Geany just doesn’t suit my needs right now. It might in the future, though. And it might meet <em>your</em> needs in a text editor now. The only way to find that out is to give Geany a serious test drive.</p>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Four Links - October 26, 2022</title>
 <link>https://plaintextproject.online/articles/2022/10/26/links.html</link>
 <guid>https://plaintextproject.online/articles/2022/10/26/links.html</guid>
  <pubDate>Wed, 26 Oct 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   Another batch of four links for your entertainment and edification
   ]]></description>
  <content:encoded><![CDATA[
   <ul>
<li><a href="https://dzone.com/articles/writing-in-markdown-an-introduction" target="_blank">Writing in Markdown: An Introduction</a></li>
<li><a href="https://www.macobserver.com/tips/quick-tip/5-plain-text-editors-ios/" target="_blank">Stay Productive With These 4 Plain Text Editors on iOS</a></li>
<li><a href="https://www.howtogeek.com/465420/what-is-plain-text/" target="_blank">What Is Plain Text?</a></li>
<li><a href="https://martinsketchley.com/2021/10/07/5307/" target="_blank">Ulysses &amp; iA Writer in Plain Text Duel!</a></li>
</ul>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Why Not Just Use ...</title>
 <link>https://plaintextproject.online/articles/2022/10/18/why.html</link>
 <guid>https://plaintextproject.online/articles/2022/10/18/why.html</guid>
  <pubDate>Tue, 18 Oct 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   Another attempt at tackling the power user fallacy around working with plain text
   ]]></description>
  <content:encoded><![CDATA[
   <p>Those are four words that regularly show up in the feedback I get about this site and about tools that I look at in this space. They’re four words that are invariably followed by name of the favourite tool for working with plain text of the person contacting me — usually something like Emacs and org-mode, Obsidian, Logseq, or vim.</p>
<p>Those folks don’t seem to realize that those applications, while a good fit for <em>them</em>, might not be as good a fit for someone else. Especially someone whose needs are simple or someone who doesn’t want or need to scale the learning curve of those applications.</p>
<p>Consider the combination of Emacs and org-mode. More than once, I’ve been accused of <em>hating</em> or <em>fearing</em> both. Far from either. Believe it or not, I actually do like them. Probably more than most techie tools I’ve tried over the years. For a space of about 27 months, I used Emacs and org-mode exclusively to take notes, to outline my writing, to manage my task lists, to keep a journal. And I used Emacs for much longer to do everyday text editing and writing, as well.</p>
<p>I don’t pretend to be an expert Emacs or org-mode user, but I’m definitely not unfamiliar with them. The combination of the two enabled me to do what I needed to do. In the end, though, I found both were just a bit too much for what I need to do. And then there were Emacs’ various quirks, both small and not-so-small. All of that convinced me to embrace something simpler, something better suited to me and to what I do.</p>
<p>As I pointed out in <a href="../../../2020/02/04/simple.html" target="_blank">a previous article</a>, not everyone’s needs are same when it comes to tools for working with plain text. Some people require the complexity of Obsidian or of an advanced text editor or of a convoluted toolchain. For others, using a text editor like Gedit or Notepad, bolstered maybe by some other simple application, fits their needs perfectly.</p>
<p>In the future, before you blurt out <em>Why not just use …</em> consider who you're saying that to. Take a moment to think about how their use cases, and their use of plain text in general, might differ from yours. You might discover that there’s a good reason someone opts for tools and applications other than your go-to solution.</p>
   ]]></content:encoded>
</item>

   <item>
  <title>Tools Roundup - October 5, 2022</title>
 <link>https://plaintextproject.online/articles/2022/10/05/tools.html</link>
 <guid>https://plaintextproject.online/articles/2022/10/05/tools.html</guid>
  <pubDate>Wed, 05 Oct 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   A quick look at three interesting tools for working with plain text
   ]]></description>
  <content:encoded><![CDATA[
   <p>Welcome to this edition of an irregular series of roundups that look at plain text tools I’ve found interesting but haven’t explored in depth. Let’s dive in!</p>
<h2 id="wordgrinder">WordGrinder</h2>
<p>A word processor at the command line? One that’s more than just a glorified text editor? That’s what you get with <a href="http://cowlark.com/wordgrinder/index.html" target="_blank">WordGrinder</a>.</p>
<p>WordGrinder doesn’t pack the features of, say, LibreOffice Writer but that doesn’t make it useless. It’s a great way to hammer out drafts. You can add formatting to text and create headings, craft lists, and even add code samples.</p>
<p>While WordGrinder saves documents in its own format, it can open HTML and plain text files. You can also export your work to <a href="https://gum.co/learnmarkdown" target="_blank">Markdown</a>, <a href="../../../2018/12/19/latex.html" target="_blank">LaTeX</a>, or troff (an older typesetting system).</p>
<h2 id="textnote">textnote</h2>
<p><a href="https://github.com/dkaslovsky/textnote" target="_blank">textnote</a> is a command line application for saving what its creator calls <em>daily notes</em> in plain text.</p>
<p>When you run textnote, it uses a simple template that creates a new file containing placeholders for your tasks and for your notes. That file opens in your default text editor.</p>
<p>You fill in the blanks throughout the day and then save the file. You can later <a href="https://github.com/dkaslovsky/textnote#open" target="_blank">open that day’s file</a> to look back your notes or check your task list in preparation of a review.</p>
<h2 id="nb">nb</h2>
<p><a href="https://github.com/xwmx/nb" target="_blank">nb</a> is a bit of a multitool for information in plain text. Not only can you take notes with it, you can also save bookmarks and create task lists. And, like the other applications in this roundup, nb is a command line application. Don’t let that scare you off, though. It’s quite user friendly.</p>
<p>nb also has a number of other features, including the ability to create multiple notebooks, add inline images, tag notes and search them, encrypt your information, and to store your notes as Markdown, <a href="https://orgmode.org/" target="_blank">Emacs org-mode</a>, or LaTeX files.</p>
<p>There’s a bit more to nb. If you’re a command line junkie, give it a peek.</p>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Four Links - September 28, 2022</title>
 <link>https://plaintextproject.online/articles/2022/09/28/links.html</link>
 <guid>https://plaintextproject.online/articles/2022/09/28/links.html</guid>
  <pubDate>Wed, 28 Sep 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   Another set of links about plain text
   ]]></description>
  <content:encoded><![CDATA[
   <ul>
<li><a href="https://plaintextaccounting.org/#plain-text-accounting-apps" target="_blank">Plain Text Accounting Apps</a></li>
<li><a href="https://castel.dev/post/lecture-notes-1/" target="_blank">How I’m able to take notes in mathematics lectures using LaTeX and Vim</a></li>
<li><a href="https://boris-marinov.github.io/text/" target="_blank">Human technology: Text files</a></li>
<li><a href="https://www.learnenough.com/text-editor-tutorial/vim" target="_blank">Learn Enough Text Editor to Be Dangerous</a></li>
</ul>
   ]]></content:encoded>
</item>
   
   <item>
  <title>A Few More Simple CSS Files</title>
 <link>https://plaintextproject.online/articles/2022/09/22/css.html</link>
 <guid>https://plaintextproject.online/articles/2022/09/22/css.html</guid>
  <pubDate>Thu, 22 Sep 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   A look at some simple CSS files that you can apply to your website to give it a clean, minimal look
   ]]></description>
  <content:encoded><![CDATA[
   <p>Once upon a time, web pages were functional. Functional but dull. Unless you used tricks like enclosing text in tables or you turned to the much-maligned <a href="https://www.w3schools.com/tags/tag_font.asp" target="_blank">&lt;FONT&gt; tag</a>, there wasn’t much could do about spicing up a page’s appearance.</p>
<p>Then along came <a href="https://en.wikipedia.org/wiki/CSS" target="_blank">Cascading Style Sheets</a> (CSS for short). CSS enables you to add consistent formatting to web pages — everything from changing the sizes of fonts to setting margins to setting colours and the alignment of text. And more. As the years went by, CSS became more complex to fit needs of people who needed more intricate layouts for their sites. To be blunt: CSS got more convoluted and difficult to use, whether you’re a web designer or not.</p>
<p>That doesn’t mean there isn’t a place for simple, clean CSS. Especially for those of us who are publishing small websites and blogs and the like. I looked at eight simple CSS files <a href="../../../2021/03/16/css.html">in a previous article</a>. Let’s look at some more CSS files that get the job done without adding too much weight to a web page or a website.</p>
<h2 id="simple.css">Simple.css</h2>
<p>The goal of <a href="https://simplecss.org/" target="_blank">this file</a>, created by <a href="https://kevq.uk/" target="_blank">Kev Quirk</a>, is to make HTML <em>look good, really quickly</em>. And Simple.css lives up to that billing.</p>
<figure>
<img src="../../../../images/css2/simplecss.png" alt="A web page styled with Simple.css" />
</figure>
<p>Simple.css offers clean, unadorned styling for not just text elements but also for forms, buttons, navigation menus, and tables. A page styled with Simple.css looks good but isn’t visually overwhelming. Plus pages are <a href="https://www.w3schools.com/html/html_responsive.asp" target="_blank">responsive</a>, so what you see renders nicely on smaller screens.</p>
<h2 id="axist">axist</h2>
<p>Weighing in at around 5 KB, <a href="https://ruanmartinelli.github.io/axist/" target="_blank">axist</a> packs a lot into that relatively small amount of CSS. You get large, easy-to-read text (which is great for those of us whose eyesight is in decline).</p>
<figure>
<img src="../../../../images/css2/axist.png" alt="axist in action" />
</figure>
<p>Tables, forms, and lists are also nicely formatted. There’s enough padding on either side of the screen so you don’t feel like you’re reading right across the screen (as you would have in, say, 1996). Like Simple.css, pages with axist applied to them are also responsive — I’d say they’re slightly easier to read on a smaller screen.</p>
<h2 id="spcss">SPCSS</h2>
<p>The <em>SP</em> in <a href="https://github.com/susam/spcss" target="_blank">SPCSS</a> stands for <em>simple and plain</em>. This stylesheet definitely lives up to that billing.</p>
<img src="../../../../images/css2/spcss.png" alt="A web page with SPCSS added to it" />
<p>In a lot of ways, SPCSS reminds me of Simple.css, but stripped back to even more of the basics. It’s not flashy, but it’s not dull either. And it has a <a href="https://www.forbes.com/uk/advisor/mobile-phones/what-is-dark-mode-and-should-you-be-using-it/" target="_blank">dark mode</a> if that’s your sort of thing. While responsive, the text is a bit smaller than Simple.css and axist. You can edit the stylesheet to change that if you like.</p>
<h2 id="bonus-100-bytes-of-css-100bytes">Bonus: 100 bytes of CSS</h2>
<p>If you don’t need to style every element (or even the main elements) on a web page, you’ll want to <a href="https://www.swyx.io/css-100-bytes/" target="_blank">check this out</a>. It’s a snippet of CSS that controls the maximum width of a web page, the size of fonts, the spacing between lines, and margins. Just that and nothing else.</p>
<figure>
<img src="../../../../images/css2/100b.png" alt="Simple styles in action" />
</figure>
<p>You can embed that snippet into a web page or put it in a separate CSS file so you can use it across multiple pages. The person behind this also offers <a href="https://www.swyx.io/css-100-bytes/#optional-100-more-bytes" target="_blank">another 100 bytes</a> of CSS that you can use to add margins to elements on a page and to change the text to a sans-serif font.</p>
<h2 id="final-thought">Final Thought</h2>
<p>CSS doesn’t need to be complex. It doesn’t need to be flashy. And you don’t need to become an expert web developer or designer to use it.</p>
<p>Using the CSS files (and one snippet) that this article introduces are a great way to quickly and attractively format a simple web page, a simple website, or a document formatted with HTML.</p>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Mobile Note Taking (and More) with GitJournal</title>
 <link>https://plaintextproject.online/articles/2022/09/07/gitjournal.html</link>
 <guid>https://plaintextproject.online/articles/2022/09/07/gitjournal.html</guid>
  <pubDate>Wed, 07 Sep 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   A look at using GitJournal to take notes and more using your Android device
   ]]></description>
  <content:encoded><![CDATA[
   <p>A while back, the developer of a mobile app called <a href="https://gitjournal.io/" target="_blank">GitJournal</a> got in touch, suggesting that I take a look at his creation. Took me a little while before I could get around to doing that but I did install the app on my phone.</p>
<p>The problem was that I couldn’t get it to work. So, I duly uninstalled GitJournal and forgot about it. Then, in late 2021, I found mention of GitJournal in some notes. This time ’round, I <em>was</em> able to get it up and running.</p>
<p>Let’s take a look at what I discovered.</p>
<h2 id="gitjournal">GitJournal?</h2>
<p>It’s one of I don’t know how many mobile note taking apps out there that support <a href="https://gum.co/learnmarkdown" target="_blank">Markdown</a>. But unlike many other apps, GitJournal doesn’t save your notes to some of the obvious places — like various boxes and drives online.</p>
<p>Instead, GitJournal synchronizes your notes with the hosting providers that support <a href="https://en.wikipedia.org/wiki/Git">git</a> (a tool that developers use to track changes to their code). You could be running your own instance of git somewhere, or you can use popular ones like <a href="https://gitlab.com" target="_blank">GitLab</a> or <a href="https://github.com" target="_blank">GitHub</a>.</p>
<h2 id="getting-started">Getting Started</h2>
<p>Install the app on your phone or device from either the <a href="https://play.google.com/store/apps/details?id=io.gitjournal.gitjournal" target="_blank">Google Play Store</a> or the Apple <a href="https://apps.apple.com/app/gitjournal/id1466519634" target="_blank">App Store</a>.</p>
<p>I’m not going into detail about connect GitJournal to a git. That process is a bit involved. You <em>will</em> need:</p>
<ul>
<li>An instance of git.</li>
<li>A repository for your notes.</li>
<li>An <a href="https://www.w3docs.com/learn-git/ssh-key.html#what-are-ssh-keys-1" target="_blank">SSH key</a> to securely connect GitJournal to that repository.</li>
</ul>
<h2 id="working-with-gitjournal">Working with GitJournal</h2>
<p>Here’s what GitJournal looks like when you fire it up:</p>
<p><img src="../../../../images/gitjournal/gitjournal-main.png" alt="The main screen of GitJournal" /><br />
</p>
<p>You can create these types of files with GitJournal:</p>
<ul>
<li>Notes</li>
<li>Journals</li>
<li>Checklists</li>
</ul>
<p>You can tap a button at the bottom of the screen to create each type of file.</p>
<p><img src="../../../../images/gitjournal/gitjournal-quick-access-toolbar.png" alt="The quick-access bar in GitJournal" /><br />
</p>
<p><strong>Note:</strong> Tapping the <strong>+</strong> button the main screen also creates a note.</p>
<p>Here’s what a new note looks like:</p>

<p><img src="../../../../images/gitjournal/gitjournal-new-note.png" alt="Creating a note in GitJournal" /><br />
</p>
<p>A new journal:</p>
<p><img src="../../../../images/gitjournal/gitjournal-new-journal.png" alt="Creating a journal entry in GitJournal" /><br />
</p>
<p>And a new list:</p>
<p><img src="../../../../images/gitjournal/gitjournal-new-list.png" alt="Creating a checklist in GitJournal" /><br />
</p>
<p>Tap in the editing area and start typing. You can add formatting, with <a href="https://gum.co/learnmarkdown" target="_blank">Markdown</a>, using the on-screen keyboard or using the formatting toolbar at the bottom of the screen. The formatting toolbar is limited in what it can do (for example, headings and lists), but it’s enough for most needs.</p>
<p><img src="../../../../images/gitjournal/gitjournal-editing.png" alt="Editing a file in GitJournal" /><br />
</p>
<p>You can preview or delete a file while editing it, as well as add a pointer to an image.</p>
<p><img src="../../../../images/gitjournal/gitjournal-preview.png" alt="Previewing a file in GitJournal" /><br />
</p>
<p>When you’re finished editing a file, tap the checkmark icon in the top left of the screen to save it. Doing that also synchronizes the file with your git repository.</p>
<h2 id="organizing-your-files">Organizing Your Files</h2>
<p>Out of the box, GitJournal saves all files in what it calls the <em>root folder</em>. That’s that top-level folder in your notes repository in git. If you create a lot of files, things get pretty messy pretty quickly.</p>
<p>To better organize your files, you can create folders — for example, one for notes, one for journals, and one for checklists. To do that, tap the stacker menu in the top-left corner of the main window and then tap <strong>Folders</strong>.</p>
<p>On the Folders screen, tap the <strong>+</strong> button, type a name for the folder, and then tap <strong>Create</strong>. You can add a file to a folder while editing it by tapping <strong>Root Folder</strong> at the bottom of the screen and then tapping the name of the folder into which you want to put the file.</p>
<h2 id="final-thoughts">Final Thoughts</h2>
<p>Even though it’s tied to a techie tool like git, I don’t class GitJournal as a techie tool. While setting it up is a bit involved, it doesn’t take much technical knowledge to do that. Once it’s set up, GitJournal is as easy to use as any other mobile note taking app.</p>
<p>That said, GitJournal’s not an app for everyone. Mainly because git isn’t part of everyone’s plain text workflow. If git <em>is</em> part of yours, then give GitJournal a peek. It’s a simple and effective mobile note taking tool that could well fit into <em>your</em> overall writing or productivity workflow.</p>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Four Links - 30 August, 2022</title>
 <link>https://plaintextproject.online/articles/2022/08/30/links.html</link>
 <guid>https://plaintextproject.online/articles/2022/08/30/links.html</guid>
  <pubDate>Tue, 30 Aug 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   Another set of four links about plain text
   ]]></description>
  <content:encoded><![CDATA[
   <ul>
<li><a href="https://www.phillipsj.net/posts/value-of-plain-text/" target="_blank">Value of Plain Text</a></li>
<li><a href="https://www.wired.com/story/how-to-use-markdown-google-docs/" target="_blank">How to Use Markdown in Google Docs</a></li>
<li><a href="https://becomeawritertoday.com/plain-text-vs-rich-text/" target="_blank">Plain Text Vs Rich Text Files: Explained</a></li>
<li><a href="https://mikebabb.com/blog/work-and-life-management-with-joplin/" target="_blank">Work and life management with Joplin</a></li>
</ul>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Taking a Look at Some Plain Text Myths</title>
 <link>https://plaintextproject.online/articles/2022/08/17/myths.html</link>
 <guid>https://plaintextproject.online/articles/2022/08/17/myths.html</guid>
  <pubDate>Wed, 17 Aug 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   Debunking a few myths around plain text that I've encountered over the life of this site
   ]]></description>
  <content:encoded><![CDATA[
   <p>Over the life of The Plain Text Project, I’ve received more than a bit of feedback. That feedback has been a mix of supportive, constructive, negative, and just plain … well, I’m not sure how to politely describe it.</p>
<p>In the latter bucket are emails that propagate what I consider myths surrounding plain text. Let’s take a look at a few of them.</p>
<h2 id="you-need-a-text-editor-packed-with-every-feature-to-use-plain-text-effectively">You Need a Text Editor Packed With Every Feature to Use Plain Text Effectively</h2>
<p>Usually, an editor like Emacs or Vim or VS Code is mentioned when someone states something like that. An editor that does so much, or can do so much, that people are always finding ways to push those editors to their limits.</p>
<p>I don’t believe that a powerful, feature-packed text editor is essential part of the plain text life. At least, not for everyone. More than a few people can do what they need to do in plain text, comfortably, using <a href="../../../2019/06/18/texted.html" target="_blank">a simple text editor</a>. And, anyway, what <em>using plain text effectively</em> means will vary from person to person. One size doesn't fit all.</p>
<h2 id="unless-youre-using-pandoc-youre-not-using-plain-text-properly">Unless You’re Using pandoc, You’re Not Using Plain Text Properly</h2>
<p>In 2019, I received an email pointedly telling me that 1) the site's <a href="../../../../tools.html" target="_blank">list of tools</a> didn’t include pandoc, and 2) the list was worthless without pandoc. I’ve heard that more than a couple of times since then.</p>
<p>And I’m calling you-know-what on that. There are some folks who might find this difficult to fathom, but not everyone needs to convert from plain text to other formats. There are, believe it or not, people who use only unadorned plain text. No markup languages. No conversion to anything required. Why would they need to use pandoc?</p>
<h2 id="you-need-more-than-one-tool-to-get-the-most-out-of-plain-text">You Need More Than One Tool to Get the Most Out of Plain Text</h2>
<p>Even before I started The Plain Text Project, I noticed that some people had built complicated toolchains and processes for their work with plain text. Sometimes, I think they’re making things a bit more difficult and a bit more fragile by introducing that much complexity into something that should be straightforward.</p>
<p>Those toolchains and processes might be what <em>they</em> need, but going back to myths above, they’re not essential for everyone. There are people who only need one or two tools to do what they want to do with plain text. That could be text editor and simple note taking tool. It could be plain text <a href="../../../2021/07/07/todo.html" target="_blank">todo list manager</a>. It could be an all-in-one application like <a href="../../02/02/obsidian.html" target="_blank">Obsidian</a>. It could be something more.</p>
<h2 id="you-need-to-use-markup-language-x">You <em>Need</em> to Use Markup Language <em>x</em></h2>
<p>Not necessarily. Some folks don’t want or need to learn, or use, a markup language. Working in vanilla plain text is enough for what they’re trying to do.</p>
<p>And one markup language doesn’t fit all tasks. Some of us only need <a href="https://gum.co/learnmarkdown" target="_blank">Markdown</a>, while others need the complexity of AsciiDoc or <a href="../../../2018/12/19/latex.html" target="_blank">LaTeX</a>. For some people, <a href="https://gum.co/learnhtml" target="_blank">HTML</a> is all they need. Others might need to use a couple or three markup languages, depending on what they’re doing at any one time.</p>
<h2 id="final-thought">Final Thought</h2>
<p>As with just about everything, there’s no one way to work with plain text. Don’t let anyone tell you otherwise.</p>
<p>How you work with plain text, and what you use to do it, is based on <em>your</em> needs. It's not based on the needs or methods or ideas of some so-called <em>power user</em> or <em>guru</em>. Or someone, like me, spouting off on their website or blog.</p>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Keeping a Plain Text Journal with jrnl</title>
 <link>https://plaintextproject.online/articles/2022/08/03/jrnl.html</link>
 <guid>https://plaintextproject.online/articles/2022/08/03/jrnl.html</guid>
  <pubDate>Wed, 03 Aug 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   Learn about using jrnl to keep a plain text diary at the command line
   ]]></description>
  <content:encoded><![CDATA[
   <p>(<strong>Note:</strong> This article was first published, in a slightly different form, at <a href="https://opensourcemusings.com/keeping-a-journal-at-the-command-line-with-jrnl" target="_blank">Open Source Musings</a> and appears here via a <a href="https://creativecommons.org/licenses/by-sa/4.0/" target="_blank">CC BY-SA 4.0</a> license.)</p>
<p>I’ve never been much good at keeping a journal. I’ve tried. Believe me, I’ve tried. It’s just never worked out. Chalk part of that up to laziness and part of that to the belief that little in my life is worth chronicling.</p>
<p>Every so often, though, I take another kick at the journalling can. This time around, I went back to a command line app that I tried and liked a few years ago. That app? <a href="https://jrnl.sh/" target="_blank">jrnl</a>. It’s a quick, easy, and minimalist way to keep a journal. Let’s take a look at it.</p>
<h2 id="getting-going">Getting Going</h2>
<p>To install jrnl, you’ll need Python and a tool called <a href="https://pypi.org/project/pip/" target="_blank">pip</a> installed on your computer. If they aren’t installed, do the deed using your Linux distribution’s package manager.</p>
<p>Open a terminal window and run the command <strong>pip install jrnl</strong>. It should only take a few seconds to install.</p>
<p>The first time you run, jrnl asks you where to store the file <em>journal.txt</em> (which stores your information). Out of the box, jrnl saves the file to the folder <em>.local/share/jrnl/</em> in your /home directory.</p>
<p>Next, jrnl asks if you want to password protect the file <em>journal.txt</em>. If you do, enter a password. Don’t forget the password — you must enter it <em>every</em> time you write an entry in your journal.</p>
<h2 id="writing-journal-entries">Writing Journal Entries</h2>
<p>You can do that in two ways. The first way is to type something like this at the command line:</p>
<pre><code>jrnl My insightful journal entry</code></pre>
<p>Of course, you’ll replace your text with what I wrote. I mean, what do I know about journalling? Press Enter to save the what you typed.</p>
<p>The other way is to type <strong>jrnl</strong> at the command line. This opens the file <em>journal.txt</em> in your default text editor. Type your entry, then save it.</p>
<p>Both methods have their advantages. Work straight from the command line enables to add a single-line entry quickly. By using a text editor, you can create an entry with multiple lines.</p>
<h3 id="adding-times-and-dates-to-your-journal-entries">Adding Times and Dates to Your Journal Entries</h3>
<p>When you create an entry, jrnl gives it a time and date — for example <em>2022-03-05 20:08</em>. You can change that by adding your own timestamp.</p>
<p>To do that, type something like this:</p>
<p><code>jrnl timestamp: Did stuff</code></p>
<p>Don’t forget the colon after the timestamp.</p>
<p>The timestamp can be, for example, <em>yesterday</em>, <em>Saturday at 8 am</em>, a date, or a date and time.</p>
<p>If you use a timestamp that specifies a day, jrnl converts that to its date format. For example, entering <em>last Monday</em> adds the date <em>2022-02-24</em> to your entry.</p>
<h3 id="adding-favourites-to-journal-entries">Adding Favourites to Journal Entries</h3>
<p>Maybe something big happened. Maybe something really good happened. Maybe you want to make sure it stands out in your journal. Do that by adding favourites to an entry. How? By adding an * — for example:</p>
<pre><code>jrnl *Got a pay rise!</code></pre>
<p>Make sure that there’s no space between the asterisk and the text.</p>
<h3 id="using-tags">Using Tags</h3>
<p>If you use jrnl daily (or more than once a day), you’ll wind up with more than a few entries. That can make things interesting when you want to go back over some of them.</p>
<p>While jrnl has a decent search function (more on this in a few paragraphs), you can use <em>tags</em> to categorize your entries. Using tags, you can have journal entries for work, your personal life, to keep an exercise log, or whatever else you need to keep a journal for.</p>
<p>Add tags to a journal entry using the *<span class="citation" data-cites="*">@*</span> sign, like this:</p>
<pre><code>jrnl Did a non-stop hour of bodyweight @exercise. I&#39;m tired!</code></pre>
<p>Just make sure that the tags mean something to you and that they’re easy to remember.</p>
<h2 id="viewing-your-journal-entries">Viewing Your Journal Entries</h2>
<p>So you’ve been using jrnl for a while. And now you want to go back and view some of the entries in your journal. You can do that in several ways.</p>
<p>One way is to tell jrnl to show you the last number of entries by typing:</p>
<pre><code>jrnl -n 8</code></pre>
<p>That will display the last eight entries in your journal. Specify a larger or smaller number as needed.</p>
<p>You can also use dates and date ranges. Let’s say you want to view all the journal entries from January of this year to today. Do that by typing:</p>
<pre><code>jrnl -from january</code></pre>
<p>To view a range of dates, use the <em>-from</em> option with the <em>-until</em> option. Let’s say you want to view your journal entries from March 1 to March 15, 2022. To do that, type:</p>
<pre><code>jrnl -from 2022-03-01 -until 2022-03-15</code></pre>
<h3 id="viewing-favourite-and-tagged-entries">Viewing Favourite and Tagged Entries</h3>
<p>View all of your favourite entries, type:</p>
<pre><code>jrnl -starred</code></pre>
<p>To view tagged entries, type:</p>
<pre><code>jrnl @yourTag</code></pre>
<p>You can include multiple tags if you need to. You can also specify a date or date range to view. You’ll need to add the <em>and</em> option to your search. For example, to view all entries tagged with <em><span class="citation" data-cites="cycling">@cycling</span></em> from June 1 to June 15, type:</p>
<pre><code>jrnl -from 2022-06-01 -until 2022-06-15 and @cycling</code></pre>
<h2 id="is-that-all-jrnl-can-do">Is That All jrnl Can Do?</h2>
<p>No. There’s a lot more this little utility can do. Read the documentation for more details about <a href="https://jrnl.sh/en/stable/overview/#import-and-export" target="_blank">importing and exporting</a> your journal and about some <a href="https://jrnl.sh/en/stable/advanced/" target="_blank">advanced options</a>.</p>
<p>While I’m not sure that jrnl will get me back on the journalling horse, I’m more comfortable using it than any other journal app on my desktop, on the web, or on a mobile device.</p>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Four Links - July 28, 2022</title>
 <link>https://plaintextproject.online/articles/2022/07/28/links.html</link>
 <guid>https://plaintextproject.online/articles/2022/07/28/links.html</guid>
  <pubDate>Thu, 28 Jul 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   A quartet of links that show how to use Obsidian as a writing tool
   ]]></description>
  <content:encoded><![CDATA[
   <p>The <em>writing with Obsidian</em> edition</p>
<ul>
<li><a href="https://medium.com/the-brave-writer/obsidian-is-the-practical-tool-you-need-to-transform-your-writing-process-bec20c01a430" target="_blank">Transform Your Writing Process with Obsidian</a></li>
<li><a href="https://eleanorkonik.com/obsidian-for-writing/" target="_blank">Using Obsidian For Writing Fiction &amp; Notes</a></li>
<li><a href="https://davidhoang.substack.com/p/writing-with-obsidian" target="_blank">Writing with Obsidian</a></li>
<li><a href="https://medium.com/talkingtech/why-obsidian-is-so-great-for-writing-4b3aef4a3bf9" target="_blank">Why Obsidian is so great for writing</a></li>
</ul>
   ]]></content:encoded>
</item>
<item>
  <title>Tools Roundup - July 13, 2022</title>
 <link>https://plaintextproject.online/articles/2022/07/13/tools.html</link>
 <guid>https://plaintextproject.online/articles/2022/07/13/tools.html</guid>
  <pubDate>Wed, 13 Jul 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   A quick look at three tools for working with plain text
   ]]></description>
  <content:encoded><![CDATA[
   <p>Welcome to this edition of an irregular series of roundups that look at plain text tools I’ve found interesting but haven’t explored in depth. Let’s dive in!</p>
<h2 id="notenik">Notenik</h2>
<p>Built for Macs, <a href="https://notenik.app/" target="_blank">Notenik</a> offers you a structured way of creating and maintaining your notes. All in plain text.</p>
<p>Unlike most note taking apps, which are freeform, Notenik’s editor uses fields to break down the elements of a note — for example, its title, the body, any tags or links, and even images associated with the note. That sounds restrictive, but it isn’t once you get used to it.</p>
<p>Notenik saves your notes as plain text, which you can format using <a href="https://gum.co/learnmarkdown" target="_blank">Markdown</a>. You can also put your notes into <em>collections</em>, which are folders that contain notes with a similar theme.</p>
<h2 id="weblorg">weblorg</h2>
<p>There are more than a couple of people who use the Emacs text editor and its <a href="https://orgmode.org/" target="_blank">org-mode</a> package to do … well, quite a few weird, wild, useful, and interesting things. That includes creating and maintaining websites and blogs.</p>
<p><a href="https://emacs.love/weblorg/" target="_blank">weblorg</a> is a <em>static HTML generator for Emacs and org-mode</em> that does what it says on the tin. It enables you to create and manage the pages for a website by editing files in org-mode’s <a href="https://orgmode.org/guide/Markup.html" target="_blank">markup language</a>.</p>
<p>When you’re ready to publish that site (or updates to the site), weblorg generates your site’s structure and the HTML files make it up. There’s a bit of setup involved, but once that’s out of the way it’s more or less push-button publishing from the editor.</p>
<h2 id="micro">micro</h2>
<p>I take a bit of heat every so often for not featuring (or even mentioning) text editors that run in a terminal window in this space. There’s a reason for that: I’ve never been able to forge a good relationship with one. That was the case until I ran into <a href="https://micro-editor.github.io/" target="_blank">micro</a>.</p>
<p>micro is like a desktop text editor that runs at the command line. You can use mouse with micro, but also common desktop keyboard shortcuts. You can also copy and paste between your desktop and the editor, as well as take advantage of some useful <a href="https://micro-editor.github.io/plugins.html" target="_blank">plugins</a>.</p>
<p>Read <a href="https://www.linux-magazine.com/Issues/2021/248/Micro" target="_blank">this article</a> at <em>Linux Magazine</em> for a more in-depth look at micro.</p>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Simple Tools for Taking Notes</title>
 <link>https://plaintextproject.online/articles/2022/07/05/notes.html</link>
 <guid>https://plaintextproject.online/articles/2022/07/05/notes.html</guid>
  <pubDate>Tue, 05 Jul 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   Not everyone needs a powerful, feature-packed tool for taking notes. Here are some solid, simple alternatives
   ]]></description>
  <content:encoded><![CDATA[
   <h1 class="title">Simple Tools for Taking Notes</h1>
<p class="author">by: Scott Nesbitt | 05 July 2022</p>
</header>
<p>There’s no single note taking tool to rule them all. Some of us need a tool with all of the bells and whistles. Some need a tool with a smaller number of those frills.</p>
<p>Then there are the folks who only need a basic application. Something bare bones. Text only. No linking, no images, no visualization, no multi-angle shower head. This article is for those people.</p>
<p>Let’s take a quick look at five simple tools for taking notes in plain text.</p>
<h2 id="nextcloud-notes">Nextcloud Notes</h2>
<p>If you’re not familiar with <a href="https://nextcloud.com" target="_blank">Nextcloud</a>, it’s a file syncing and storage application. Thanks to the various components that have been integrated into it, Nextcloud can also be a very effective <a href="https://opensourcemusings.com/using-nextcloud-as-a-personal-hub" target="_blank">personal productivity hub</a>. One of those components that make up the hub is Nextcloud Notes.</p>
<p>Notes is a simple tool, which enables you to quickly and easily take plain text notes. You can also format your notes with <a href="https://gum.co/learnmarkdown" target="_blank">Markdown</a> and organize them using <em>categories</em> (which are like folders that contain notes on a similar subject). There’s even a mobile app for Android.</p>
<p>You can read more about Nextcloud Notes <a href="../../02/15/notes.html" target="_blank">in this article</a>.</p>
<h2 id="simplenote">Simplenote</h2>
<p>For the longest time, <a href="https://simplenote.com" target="_blank">Simplenote</a> was my go-to application for taking notes. Why? It didn’t have any bells or whistles. It gave me a minimalist, blank canvas on which to write notes (and more). I didn’t need to worry about other features I’d never use.</p>
<p>While Simplenote has gotten a few additional features bolted on to it over the years, it's still minimal. It’s still easy to use. On top of that, it supports Markdown and has apps for the Linux, macOS, and Windows desktops along with apps for Android and Apple devices.</p>
<h2 id="notorious">Notorious</h2>
<p><a href="https://notorious.gabmus.org/" target="_blank">Notorious</a> is simple, keyboard-driven note take application for the Linux desktop. All you need to do is enter a title for your note, then start typing. You can’t get any simpler than that.</p>
<p>You can format your notes with Markdown, choose to save them with the extension .txt or .md, and you can specify where to save your notes. It’s simple, light, and quite snappy.</p>
<h2 id="auer-notes">Auer Notes</h2>
<p><a href="https://auernotes.com/" target="_blank">Auer Notes</a> is one of those tools that started life as a way to scratch <a href="https://auernotes.com/why.html" target="_blank">its creator’s itch</a>. That itch? To create a quick, simple, secure note taking application for macOS.</p>
<p>In a lot of ways, Auer Notes looks like the stock Notes app on the Mac desktop. That’s where the similarity (which is quite superficial) ends. Auer Notes saves your notes as text files, which you can keep on your hard drive or sync using a service like Nextcloud.</p>
<h2 id="your-favourite-minimal-text-editor">Your Favourite Minimal Text Editor</h2>
<p>Who says that you need a dedicated note taking app at all? Why not use a text editor? Like the one installed with your computer’s operating system.</p>
<p>Yes, even something as barebones as Windows Notepad. As long as it saves files as plain text and as long as you use a well-thought out <a href="../../../2019/11/05/folders.html" target="_blank">folder structure</a>, a simple, minimal text editor can be more than enough for your note taking needs.</p>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Four Links - June 29, 2022</title>
 <link>https://plaintextproject.online/articles/2022/06/29/links.html</link>
 <guid>https://plaintextproject.online/articles/2022/xx/xx/name.html</guid>
  <pubDate>Wed, 29 Jun 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   Another four links looking at the benefits of plain text
   ]]></description>
  <content:encoded><![CDATA[
   <ul>
<li><a href="https://smallsharpsoftwaretools.com/tutorials/create-html-from-multiple-markdown-files/" target="_blank">Creating an HTML Document from Multiple Markdown Files with Pandoc</a></li>
<li><a href="https://sive.rs/plaintext" target="_blank">Write plain text files</a></li>
<li><a href="https://baty.net/2022/plain-text-files-cant-save-you-if-you-lose-them/" target="_blank">Plain text can’t save you if you lose the files</a></li>
<li><a href="https://medium.com/produclivity/3-vital-mac-apps-in-my-plain-text-productivity-system-d92ebb095728" target="_blank">3 Vital Mac Apps in My Plain Text Productivity System</a></li>
</ul>
   ]]></content:encoded>
</item>
   
   <item>
  <title>3 More Fonts for Working with Plain Text</title>
 <link>https://plaintextproject.online/articles/2022/06/15/fonts.html</link>
 <guid>https://plaintextproject.online/articles/2022/06/15/fonts.html</guid>
  <pubDate>Wed, 15 June 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   Let's take a quick look at another three monospace fonts that are great for working in plain text
   ]]></description>
  <content:encoded><![CDATA[
   <p>A good monospace font can make plain text a lot easier to work with. Once upon a time, I didn’t believe that but as I got older and my eyesight got a bit weaker I found that using the <em>right</em> font in my text editor made all the difference. At least, the right font for me.</p>
<p>These days, we’re not just limited to plain old <a href="../../../2017/10/17/courier.html">Courier</a>. There are also <a href="../../../2020/03/03/fonts.html">other nice</a> monospace fonts out there. Let’s take a quick look at three more of them.</p>
<h2 id="overpass-mono">Overpass Mono</h2>
<p>Overpass Mono is, as you might have guessed, part of the <a href="https://overpassfont.org/" target="_blank">Overpass font</a> family. I came into contact with it thanks to a few people I know who work at Red Hat (a company that heavily uses Overpass for just about everything).</p>
<p><img src="../../../../images/fonts2/fonts-overpass-mono.png" alt="A sample of Overpass Mono" /><br />
</p>
<p>Overpass Mono is strong and striking. And, to my untrained eye, it looks as if it combines the best elements of both a monospace font and a sans-serif font. The characters have a pleasing shape, which contrasts nicely with their striking appearance.</p>
<h2 id="source-code-pro">Source Code Pro</h2>
<p>While aimed at coders (hence its name), anyone can use <a href="https://github.com/adobe-fonts/source-code-pro" target="_blank">Source Code Pro</a> for <em>any</em> plain text task &mdash; from writing in <a href="https://gum.co/learnhtml" target="_blank">HTML</a> or <a href="https://gum.co/learnmarkdown" target="_blank">Markdown</a>, to maintaining a task list, to taking notes, and anything else in between.</p>
<p><img src="../../../../images/fonts2/fonts-source-code-pro.png" alt="A sample of Source Code Pro" /><br />
</p>
<p>Source Code Pro is reminiscent of some other monospace fonts I’ve looked at in the past, like Hack and IBM Plex Mono. That said, Source Code Pro has its own personality. A personality that stands out, but which isn't jarring.</p>
<h2 id="space-mono">Space Mono</h2>
<p><a href="https://www.1001freefonts.com/space-mono.font" target="_blank">Space Mono</a> is another one of those fonts that really didn’t work for me at first. Don’t ask me why, but there was just something about the font that I just couldn’t put my finger on.</p>
<p><img src="../../../../images/fonts2/fonts-space-mono.png" alt="A sample of Space Mono" /><br />
</p>
<p>That slowly changed. And while it’s (still) not one of my favourite monospace fonts, I do find Space Mono a rather aesthetically pleasing one. That might be because the font has something of a retro futuristic look (of which I’m a fan).</p>
<h2 id="final-thought">Final Thought</h2>
<p>As with any of the other fonts that I’ve looked at in this space, the three above won’t appeal to everyone. While I don’t use Overpass Mono, Source Code Pro, or Space Mono regularly, that doesn’t mean I don’t like them. Or that they’re not good fonts. Give one or all of them a try. You just might find a new favourite monospace font in the bunch.</p>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Creating a Plain Text Day Planner</title>
 <link>https://plaintextproject.online/articles/2022/06/08/planner.html</link>
 <guid>https://plaintextproject.online/articles/2022/06/08/planner.html</guid>
  <pubDate>Wed, 08 Jun 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   A look at one way to use a simple text file to plan your day
   ]]></description>
  <content:encoded><![CDATA[
   <p>Despite seeming to have had their heyday in the 2010s, productivity blogs still continue to thrive. Not a lot of what they publish is really new, but they all seem to have a common thread: those blogs cycle through various tools and techniques — some simple, many complex — to try to teach their readers how to get things done.</p>
<p>You can be excused for thinking that people weren’t productive before the advent of the internet, with all the shiny productivity tools that it seemed to spawn. But that’s not the case.</p>
<p>One of the most productive people I’ve ever met was someone I encountered in the early 1990s. At that time, I was working as a writer at a mutual fund company. He was an older gent (well, older than I was at the time) who happened to be one of the company’s top salespeople.</p>
<p>He didn’t keep track of everything that he had to do using the nascent planning software of the day. Instead, he used a humble day planner. Yes, that busy sales agent got things done with pen and paper.</p>
<p>He kept it simple, pared everything back to the basics. It worked well for him, and you can apapt what he did to plain text.</p>
<p>Let’s take a look at one approach to creating a plain text day planner.</p>
<h2 id="why-use-plain-text-and-not-a-calendar">Why Use Plain Text and Not a Calendar?</h2>
<p>Admittedly, using a calendar application has its advantages. You can set up reminders and (fairly) easily share items in your calendar if you need to. To be honest, I find it faster and less tedious to add items into a plain text file than entering them into a calendar.</p>
<p>On top of that, if you need to you can share or sync a day planner file with others via your file syncing service or tool of choice.</p>
<h2 id="before-you-begin">Before You Begin</h2>
<p>This article won’t go into how to structure the folder in which you’ll (at least, in which you <em>should</em>) store your day planner files. Read <a href="../../../2019/11/05/folders.html" target="_blank">this article</a> if you need some advice about that.</p>
<p>However, you should decide if you want to use a single file per day, or one file per week (broken into sections for each day). In this article, I’m going to look at using a single file per day.</p>
<h2 id="creating-the-planner">Creating the Planner</h2>
<p>The structure of the file that I’m about to describe is based heavily on that of a traditional paper day planner.</p>
<p>Start by creating a text file and give it a descriptive name. I put the date in the file name, which looks like this: <em>dd-mm-yyyy-day-plan.txt</em> — for example, <em>08-06-2022-day-plan.txt</em>. Feel free to come up with a better naming convention for your files …</p>
<p>As with <a href="../../../../templates.html" target="_blank">other files</a> like this, I like to have some metadata at the top of the file to identify it at a glance when I’m working with it. Not just a date, but also a daily goal. Here’s an example:</p>
<pre><code>---
Date: 08-06-2022

Goal for today: Wrap up updates to the essay collection
---</code></pre>
<p>From there, enter what you have planned for today, broken down by blocks of time. That can be everything from meetings to appointments to break times to what you intend to learn or study. If it’s scheduled for that day, add it to your day planner file. I half-jokingly say that if it's not in my planner, it doesn't exist. At least, it's not going to happen.</p>
<p>Here’s an example:</p>
<pre><code>---
Date: 25-05-2022

Goal for Today: Wrap up draft of proposal and send it out for review
---

08:30 - 09:00 - Call with x to discuss y
09:00 - 10:00 - Demonstrate new workflow tool
10:00 - 10:15 - Break
10:15 - 12:30 - Work on draft of proposal
12:30 - 13:00 - Lunch
13:00 - 14:00 - Finish draft of proposal
14:00 - 15:00 - Weekly project update meeting
.
.
. </code></pre>
<p>If you need to add more information about an item, include it as a note below the item, preceded by a <strong>&gt;</strong>. Here’s an example:</p>
<pre><code>10:15 - 12:30 - Work on draft of proposal
&gt; Contact DK for additional information
.
.
.
14:00 - 15:00 - Weekly project update meeting
&gt; Meeting URL: https://meet.jit.si/12345
.
.
.</code></pre>
<p>I’ve created <a href="../../../../templates/day-planner.txt" target="_blank">a template</a> (under a <a href="https://creativecommons.org/share-your-work/public-domain/cc0/" target="_blank">CC0</a> license) that you can use and modify as you’d like.</p>
<h3 id="note-about-creating-a-weekly-file">Note About Creating a Weekly File</h3>
<p>A weekly planner file will look a lot like the example above. There will be a block in the file for each day of the week. If you need to, separate the blocks for each day using three dashes (<strong>—</strong>).</p>
<p>I’ve created <a href="../../../../templates/day-planner-for-week.txt" target="_blank">a template</a>, which you can modify as you see fit.</p>
<h2 id="final-thoughts">Final Thoughts</h2>
<p>Working with a plain text day planner can be a good antidote to dealing with an overloaded calendar. You lose automation and reminders, but you’re forced to become more aware and mindful rather than relying completely on technology to keep you on track.</p>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Four Links - May 26, 2022</title>
 <link>https://plaintextproject.online/articles/2022/05/26/links.html</link>
 <guid>https://plaintextproject.online/articles/2022/05/26/links.html</guid>
  <pubDate>Thu, 26 May 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   Four new links, this time about blogging and building websites with plain text
   ]]></description>
  <content:encoded><![CDATA[
   <p>The <em>Building blogs and websites with plain text</em> edition</p>
<ul>
<li><a href="https://danmackinlay.name/notebook/static_sites.html" target="_blank">Static websites</a></li>
<li><a href="https://www.vox.me.uk/post/2016/02/plain-text-blogging/" target="_blank">Plain Text Blogging</a></li>
<li><a href="https://problogger.com/html-for-bloggers/" target="_blank">Simple Guide to HTML for Bloggers</a></li>
<li><a href="https://awarm.space/fast/0000-org-and-pandoc-static-site" target="_blank">Org-mode and Pandoc as a static site generator</a></li>
</ul>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Three Text Editors for Chrome OS</title>
 <link>https://plaintextproject.online/articles/2022/05/18/chrome-editors.html</link>
 <guid>https://plaintextproject.online/articles/2022/05/18/chrome-editors.html</guid>
  <pubDate>Wed, 18 May 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   A look at three text editors that you can use on devices running ChromeOS
   ]]></description>
  <content:encoded><![CDATA[
   <p>Like them or not, you can’t deny that <a href="https://en.wikipedia.org/wiki/Chromebook" target="_blank">Chromebooks</a> (and other hardware running <a href="https://en.wikipedia.org/wiki/Chrome_OS" target="_blank">Chrome OS</a>) have carved themselves a niche in the computing world. Several niches, in fact.</p>
<p>Devices like the Chromebook, the Chromebase, and the Chromebox aren’t, as some people have labelled them, underpowered toy computers. You <em>can</em> do serious work with them. In a lot of ways, devices running Chrome OS are excellent examples of what I call <a href="https://weeklymusings.net/weekly-musings-145" target="_blank">technology for the masses, not the classes</a>.</p>
<p>And, yes, you can work in plain text on those devices using one of the several text editors available for Chrome OS. Let’s take a quick look at three of those editors. And, to push back against another long-held misconception about Chromebooks, you <em>can</em> use all of these editors without a connection to the internet.</p>
<h2 id="code-pad">Code Pad</h2>
<p><a href="https://chrome.google.com/webstore/detail/code-pad-text-editor/adaepfiocmagdimjecpifghcgfjlfmkh?hl=en-GB" target="_blank">Code Pad</a> is billed as a programmer’s editor. But don’t let that put you off. As with an editor like <a href="../../03/02/npp.html" target="_blank">Notepad++</a>, Code Pad is great for basic text editing tasks &mdash; and a few tasks that aren’t so basic, as well.</p>
<p>Like every good text editor out there, Code Pad supports syntax highlighting, autocompletion of text, <a href="https://en.wikipedia.org/wiki/Code_folding" target="_blank">folding</a>, and an assortment of customizations to the look and feel of the editor — including the ability to change fonts and to choose a different theme. The editor is <em>very</em> responsive; I didn’t notice any lag between keyboard and screen.</p>
<p>Code Pad has one annoyance: when you create a file by selecting <strong>File &gt; New</strong>, the editor creates an empty JavaScript file with its basic structure. If you want to create another type of file — like a <a href="https://gum.co/learnmarkdown" target="_blank">Markdown</a> or an <a href="https://gum.co/learnhtml" target="_blank">HTML</a> file — you neeed to select the file type from the <strong>+New</strong> dropdown list in the top-right corner of the editor window.</p>
<p><img src="../../../../images/chromebook/chromebook-codepad.png" alt="Editing text with Code Pad" /><br />
</p>
<h2 id="caret">Caret</h2>
<p>When I regularly used a Chromebook, <a href="https://chrome.google.com/webstore/detail/caret/fljalecfjciodhpcledpamjachpmelml?hl=en" target="_blank">Caret</a> was my go-to text editor. While its developer describes it a <em>professional text editing for Chrome and Chrome OS</em>, it does most basic text editing tasks quite nicely.</p>
<p>Caret’s creator based his tool on the popular Sublime Text editor. Don’t expect Caret to match Sublime feature for feature, though. You'll be disappointed. That said, Caret does have a number of useful functions. You can have multiple files open in separate tabs, the editor automatically applies <a href="https://en.wikipedia.org/wiki/Syntax_highlighting" target="_blank">syntax highlighting</a> to files based on their extension, and you can use Sublime Text’s keyboard shortcuts.</p>
<p>One <em>very</em> useful feature of Caret, especially if you prefer to let your fingers do the walking, is its *command palette. By pressing Ctrl+Shift+P, you can quickly access any of the editor’s commands.</p>
<p>As an editor, Caret works swiftly and smoothly. It packs a lot into a small package.</p>
<p><img src="../../../../images/chromebook/chromebook-caret.png" alt="Working with Caret on a Chromebook" /><br />
</p>
<h2 id="text">Text</h2>
<p>This is the editor that’s built into Chrome OS. It’s a lot like Notepad under Windows. Text is spare, with few features and functions. But it’s far from useless (as I’ve heard a couple or three people describe it).</p>
<p>To use it, you fire up Text and start typing. Or you can open a text file that you’ve saved to your Chromebook. The options are pretty rudimentary. You can change the size of fonts and tabs, convert tabs to spaces automatically, wrap lines, and the like. Nothing that a so-called power user would be interested in, but Text is great for simple, day-to-day text editing tasks.</p>
<p><img src="../../../../images/chromebook/chromebook-text.png" alt="Using the built-in editor on a Chromebook" /><br />
</p>
<h2 id="bonus-editor-emacs">Bonus Editor: Emacs</h2>
<p>Believe it or not, you can <a href="https://support.google.com/chromebook/answer/9145439?hl=en" target="_blank">turn on a Linux development environment</a> in newer versions of Chrome OS. Which, as you’ve probably guessed, enables you to install and run various Linux applications.</p>
<p>One of those applications is the Emacs text editor. While you might be able to install and run other Linux text editors, Emacs is the only one that I tried. It works quite well, too. And, yes, you can install org-mode along side it …</p>
<p>I didn’t stress test Emacs on the Chromebook I was using while writing this article, but for what I was doing it worked fairly smoothly and seamlessly.</p>
<h2 id="final-thoughts">Final Thoughts</h2>
<p>If you’re a Chromebook user, it <em>is</em> possible to comfortably live the plain text life on your device. You might not get all the features you find in the top-tier text editors on the Linux, macOS, or Windows desktops but chances are you won’t miss those features.</p>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Creating a Plain Text Contact List</title>
 <link>https://plaintextproject.online/articles/2022/05/04/contacts.html</link>
 <guid>https://plaintextproject.online/articles/2022/05/04/contacts.html</guid>
  <pubDate>Wed, 05 May 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   A look at how to list and manage your contacts using a plain text file
   ]]></description>
  <content:encoded><![CDATA[
   <p>Recently, one website I’ve come to enjoy reading is <a href="https://analogoffice.net" target="_blank">Analog Office</a>. I know … Analog is so far removed from plain text. But that doesn’t mean I can’t enjoy going (or just reading about going) old school every so often.</p>
<p>In one post, Anna Havron (the person behind that site) discusses <a href="https://analogoffice.net/2022/03/03/keep-a-canonical.html" target="_blank">keeping a canonical home address book</a> using pen and a notebook. That got me thinking about doing the something similar, but with plain text.</p>
<p>Why would I opt for plain text rather than going analog? As much as I enjoy using a notebook and a pen, my handwriting it bad. <em>Really</em> bad. So bad that I can barely read it sometimes. Also, plain text gives me a bit more flexibility Regardless, both approaches have their merits and their drawbacks. But since the name of this site is <em>The Plain Text Project</em>, I’m going to stay in my wheelhouse.</p>
<h2 id="why-do-this">Why Do This?</h2>
<p>When you can, for example, export your email address book in plain text formats like <a href="https://en.wikipedia.org/wiki/VCard" target="_blank">vcard</a>?</p>
<p>You might not want to save <em>every</em> contact you have, just the most important ones. Friends, family, colleagues you want to keep in touch with. And while you can open and view a vcard file in a text editor, the information isn’t exactly easy to read or scan, as you can gather from the sample below:</p>
<pre><code>BEGIN:VCARD
VERSION:4.0
N:Nakayama;Haruko;;
FN;PREF=1:Haruko Nakayama
ITEM1.EMAIL;TYPE=HOME;PREF=1:nakayamah@somedomain.co.jp
ITEM2.EMAIL;TYPE=x-OTHER;PREF=2:haruko@myemail.com
UID:53550e54-23d2-9701-6c84-d3be91419450
END:VCARD</code></pre>
<p>Creating a plain text contact list ensures that humans can easily read the contents of the file, without all the vcard cruft. And that the list is easy to share or print out when or if necessary.</p>
<h2 id="getting-going">Getting Going</h2>
<p>Before you create the list, think about the information that you want include in it. At very least, that information should be each entry’s:</p>
<ul>
<li>Name.</li>
<li>Address.</li>
<li>Email address(es).</li>
<li>Phone number(s).</li>
<li>Any other additional information that you think might be useful, like the person’s birthday.</li>
</ul>
<p>Here’s an example of the basic structure of that information:</p>
<pre><code>Name: [person&#39;s name]
Address:
   - Street address
   - Apartment/unit number (if applicable)
   - Town/City, State/Province/Prefecture, Postal/Zip Code
   - Country
Email:
   - personal:
   - secondary:
   - work:
Phone:
   - mobile:
   - home:
   - work: 
Additional Information:
   - birthday: 
   - spouse&#39;s/partner&#39;s name: 
   - anything else: </code></pre>
<p>And here’s an example of an entry containing (admittedly fake) contact information:</p>
<pre><code>Name: Lily Munster
Address:
   - 1313 Mockingbird Lane
   - Unit 631
   - Sometown, NSW 12345
   - Australia
Email:
   - personal: lily@myEmail.com
   - work: lmunster@herOffice.com.au
     &gt; prefers using personal email address
Phone:
   - mobile: +61 02-123-4567
   - home: +61 02-890-1234
     &gt; Call home first
Additional Information:
   - birthday: 01/01/1989
   - Don&#39;t talk about pineapple on pizza!</code></pre>
<p>In the example above, you might notice that I added notes below two of the indented items, denoted by a <em>&gt;</em>. That’s not necessary, but it can be useful to (as I did in the example above) to specify a person’s preferred method of contact.</p>
<p>This is a format that works for me. If it doesn’t work for you, feel free to chop and change it to your liking. I’ve created <a href="../../../../templates/contact-list.txt" target="_blank">a template</a> (under a <a href="https://creativecommons.org/share-your-work/public-domain/cc0/" target="_blank">CC0</a> license) with which you can do just that.</p>
<h2 id="one-file-or-multiple-files">One File or Multiple Files?</h2>
<p>That’s a question that crops up a lot in these parts, isn’t it?</p>
<p>Having a single file means you don’t need to jump around to find what you’re looking for. And it’s easier to keep track of the file. Using multiple files, on the other hand enables you to focus on one group of people per file, and can make your contact lists easier to scan.</p>
<p>If you decide to use one file, break it down into sections based on the type of contact — for example, <strong>Family</strong>, <strong>Friends</strong>, <strong>Colleagues</strong>. Start the heading for each section with a hashtag, and separate the sections using three dashes (<code>---</code>). Here’s an example:</p>
<pre><code># Family

[add entries here]

---
## Friends

[add entries here]

---
## Colleagues

[add entries here]
</code></pre>
<p>I’ve created <a href="../../../../templates/contact-list-with-sections.txt" target="_blank">a second template</a>, based on the example above (but with the actual structure), that you can use or modify as you need.</p>
<p>Whether use single or multiple files, name them in a way that makes sense to you. And if using multiple, think about how you plan to store those file and put them in a folder with a sensible name.</p>
<h2 id="final-thoughts">Final Thoughts</h2>
<p>Keeping a plain text contact list is a simple way to create a backup of information about your important connections. This type of file is definitely <em>not</em> a replacement for what you maintain in your email account, but it is something that you can refer to when offline or to ensure that you’re keeping up with the people you want and need to keep up with.</p>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Four Links - April 28, 2022</title>
 <link>https://plaintextproject.online/articles/2022/04/28/links.html</link>
 <guid>https://plaintextproject.online/articles/2022/04/28/links.html</guid>
  <pubDate>Thu, 28 Apr 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   Four links, this time about creating PDFs from plain text files
   ]]></description>
  <content:encoded><![CDATA[
   <li><a href="https://www.kabisa.nl/tech/good-looking-pdfs-with-css-for-paged-media-and-markdown/" target="_blank">Good-looking PDFs with CSS for Paged Media and Markdown</a></li>
<li><a href="https://hund.tty1.se/2021/07/14/how-i-create-fancy-pdf-documents-in-markdown.html" target="_blank">How I create fancy PDF-documents in Markdown</a></li>
<li><a href="https://jdhao.github.io/2019/05/30/markdown2pdf_pandoc/" target="_blank">Converting Markdown to Beautiful PDF with Pandoc</a></li>
<li><a href="https://kaptein.me/blog/markdown-to-pdf-without-latex/" target="_blank">Pandoc converting markdown to pdf without LaTeX</a></li>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Blogging in Plain Text with Bear</title>
 <link>https://plaintextproject.online/articles/2022/04/19/bear.html</link>
 <guid>https://plaintextproject.online/articles/2022/04/19/bear.html</guid>
  <pubDate>Tue, 19 Apr 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   A look at another minimalist blogging platform that's powered by plain text
   ]]></description>
  <content:encoded><![CDATA[
   <p>When WordPress took over a big chunk of the online world, blogging became a bit more complex than it needed to be. It definitely became more complex than some people needed it to be.</p>
<p>Writing blog posts took something of a back seat to dealing with themes, plugins, SEO, and various other arcana. The so-called <em>pro blogging</em> boom of the last decade and a half, fueled in large part by WordPress, resulted in hulking blogs laden with graphics and multimedia and ads and pop-ups and alla that stuff.</p>
<p>That approach is overkill for the blogger who’s <em>not</em> trying to take the web by storm. It’s overkill for the blogger who only wants to share thoughts and ideas with a smaller audience.</p>
<p>Instead of adding to the ever-increasing bulk of the web, why not take a <a href="https://mnmlist.com/tinyblog/" target="_blank">lean, minimal approach</a> instead? By that I mean blogging without weighing down a reader’s browser or popping up ads or reminders or anything else annoying. Blogging in a bare bones way, in which what you’re writing matters more than how your blog looks.</p>
<p>You can do that quickly and easily with <a href="https://bearblog.dev/" target="_blank">Bear</a>. Like Mataroa (which I <a href="../../../2021/11/03/mataroa.html">looked at in 2021</a>), Bear is a blogging platform that’s spare, that’s minimal. Which is definitely <em>not</em> a bad thing.</p>
<p>With Bear, you get up and running quickly. You focus on words and ideas. You’re publishing as if using, to quote Leo Babauta, a <em>marker and a publicly-posted piece of cardboard</em>. Bear gets rid of the frills and adornments. It enables you to write and publish with little or no friction.</p>
<p>Does that sound interesting? If it does, keep reading to learn more.</p>
<h2 id="getting-started">Getting Started</h2>
<p>Bear is hosted software, so you need to <a href="https://bearblog.dev/accounts/signup/" target="_blank">sign up</a> for an account. That account is free, but you can get a <a href="https://bearblog.dev/contribute/" target="_blank">paid</a> one ($5 a month or $50 a year). With paid account, you get features like newsletter subscriptions and the satisfaction of helping Bear’s creator keep the lights on.</p>
<p>To sign up, all you need to do is enter an email address or a password and you’re ready to get going.</p>
<h3 id="setting-up-your-blog">Setting Up Your Blog</h3>
<p>Once you’ve signed up, you’re taken to the <strong>Dashboard</strong> page. It’s on this page where you add basic information about your blog:</p>
<ul>
<li>The blog’s title — for example, <em>500 Words</em>.</li>
<li>Its subdomain — for example, <em>500Words</em> which becomes the URL <em>https://500Words.bearblog.dev</em>.</li>
<li>Text that appears on the blog’s landing page (more on this in a moment).</li>
<li>A short description of your blog.</li>
</ul>
<p>Here’s an example:</p>
<p><img src="../../../../images/bear/bear-blog-setup.png" alt="Dashboard page in Bear" /><br />
</p>
<h2 id="how-bear-structures-your-site">How Bear Structures Your Site</h2>
<p>When your site gets published, Bear creates a landing page. That page will contain links to your blog posts and whatever other pages you create. Here’s an example:</p>
<p><img src="../../../../images/bear/bear-blog-after-setup.png" alt="Landing page of a blog published with Bear" /><br />
</p>
<p>Bear adds these pages to your site automatically:</p>
<ul>
<li>Home.</li>
<li>Blog.</li>
<li>About.</li>
</ul>
<p><img src="../../../../images/bear/bear-blog-nav.png" alt="Adding links to other page in Bear" /><br />
</p>
<p>I’ll talk about <a href="#pages">adding more pages</a> in a moment.</p>
<h2 id="writing-your-first-post">Writing Your First Post</h2>
<p>To do that, click on <strong>Posts</strong> and then click <strong>New post</strong> to jump to the blog editor.</p>
<p><img src="../../../../images/bear/bear-blog-new-post.png" alt="Getting ready to write a new post in Bear" /><br />
</p>
<p>Bear’s editor isn’t going to win any design awards. It’s not ugly, just kind of old school — a set of fields rather than a more modern, minimal looking blank editing canvas as you’d find in, say, <a href="https://write.as" target="_blank">Write.as</a>.</p>
<p>To get started, give the post a <strong>Title</strong>. Then, type the body of your post. You can add formatting to that post using <a href="https://gum.co/learnmarkdown" target="_blank">Markdown</a>.</p>
<p>Here’s an example of post that’s in progress:</p>
<p><img src="../../../../images/bear/bear-blog-post-WIP.png" alt="Writing a post in Bear" /><br />
</p>
<p>When you’re done, click <strong>Publish</strong> (at the bottom of the editor page). Or, you can click <strong>Save as draft</strong> to continue working on the post later.</p>
<p>Here’s what a published post looks like:</p>
<p><img src="../../../../images/bear/bear-blog-published-post.png" alt="A post published with Bear" /><br />
</p>
<h3 id="other-information-you-can-add-to-a-blog-post">Other Information You Can Add to a Blog Post</h3>
<p>What I outlined above is the bare minimum required for a blog post. You can also add this information about the post:</p>
<ul>
<li>A <a href="https://en.wikipedia.org/wiki/Permalink" target="_blank">permalink</a>.</li>
<li>A <a href="https://ahrefs.com/blog/canonical-tags/#what-is-a-canonical-tag" target="_blank">canonical URL</a>.</li>
<li>A date in the future on which to publish the post.</li>
<li>A short description that search engines pick up when they spider your blog.</li>
<li><a href="https://github.com/HermanMartinus/bearblog/wiki/Meta-information#adding-a-meta-image" target="_blank">An image</a> that goes with the description.</li>
<li>Tags, which you can use to group your posts.</li>
</ul>
<h2 id="pages">Adding Pages</h2>
<p>Earlier in this article, I mentioned that Bear creates links to three pages on your blog automatically. But you can add other pages to your blog, too.</p>
<p>To do that, create a post. Add a title and some content, then click <strong>Is page</strong> (at the bottom of the editor). When you click <strong>Publish</strong>, Bear creates the page and adds it to your blog’s navigation bar.</p>
<h2 id="other-useful-features">Other Useful Features</h2>
<p>Bear also has a few other features that you might find useful. As I mentioned earlier, Bear supports <a href="https://gum.co/learnmarkdown" target="_blank">Markdown</a> — including images and tables. Images need to be hosted somewhere else on the web — you need to point to any images you want to use via Markdown’s image syntax:</p>
<pre><code>![Text to describe the image](https://some.where/MyNiftyImage.png)</code></pre>
<p>Bear also automatically generates an RSS feed for your blog. You can choose to exclude posts from your feed (and from Bear’s <a href="https://bearblog.dev/discover/" target="_blank">blog discovery page</a>) by deselecting the <strong>Show in feed</strong> option in the post editor.</p>
<p>Out of the box, a blog published with Bear is plain but serviceable. You can change the look of your blog by clicking <strong>Styling</strong> and then either:</p>
<ul>
<li>Pasting some CSS that you’ve crafted into that <strong>Custom styles</strong> box, or</li>
<li>Pointing to <a href="../../../2021/03/16/css.html">an existing CSS file</a> somewhere on the web in the <strong>External stylesheet</strong> field.</li>
</ul>
<p><img src="../../../../images/bear/bear-blog-custom-styling.png" alt="Custom styling added to a blog published with Bear" /><br />
</p>
<p>Here’s an example of a blog styled with the <a href="https://edwardtufte.github.io/tufte-css/" target="_blank">Tufte CSS</a> stylesheet:</p>
<p><img src="../../../../images/bear/bear-blog-styled.png" alt="Custom styling added to a blog published with Bear" /><br />
</p>
<h2 id="final-thoughts">Final Thoughts</h2>
<p>Like <a href="../../../2021/11/03/mataroa.html">Mataroa</a>, Bear brings minimalism back to blogging. It packs no frills, and yet you can use Bear for serious blogging. Or just occasional blogging. It’s up to you.</p>
<p>With Bear, you can quickly set up your blog and get publishing without worrying about ephemera like themes or plugins. You write. You publish. That’s it.</p>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Creating a Nice-Looking PDF with pandoc</title>
 <link>https://plaintextproject.online/articles/2022/04/06/pdf.html</link>
 <guid>https://plaintextproject.online/articles/2022/04/06/pdf.html</guid>
  <pubDate>Wed, 06 Apr 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   A quick look at how to convert a Markdown file to a nice-looking PDF using pandoc and CSS
   ]]></description>
  <content:encoded><![CDATA[
   <p>If you’re familiar with <a href="https://pandoc.org" target="_blank">pandoc</a>, you know how useful and flexible it is. One of the many formats that you can convert to using pandoc is PDF.</p>
<p>Before version 2 of the tool, you needed the TeX typesetting system (and the LaTeX extensions) installed on your computer to go directly to PDF. TeX is great, but it’s also quite big. And if you’re only producing the occasional PDF, then it’s overkill to have even a basic TeX system installed on your computer.</p>
<p>With version 2 of pandoc came a new option: <em>–pdf-engine</em>. That option lets you specify which tool to use when doing a conversion to PDF. While you can still use LaTeX (and a few other tools) to do the deed, you don’t need to bother with all that bulk.</p>
<p>Let’s take a look at how to create a PDF from a <a href="https://gum.co/learnmarkdown" target="_blank">Markdown</a> file using pandoc and a couple of lighter-weight utilities.</p>
<h2 id="getting-started">Getting Started</h2>
<p>You’ll need pandoc installed on your computer, along with one of these tools:</p>
<ul>
<li><a href="https://weasyprint.org/" target="_blank">WeasyPrint</a></li>
<li><a href="https://wkhtmltopdf.org/" target="_blank">wkhtmltopdf</a></li>
</ul>
<p>For our purposes, WeasyPrint and wkhtmltopdf are essentially the same, but there are a couple or three little differences. I’ll touch on one of those differences in a moment.</p>
<h2 id="doing-the-conversion">Doing the Conversion</h2>
<p>As I mentioned a few paragraphs ago, I’m going to look at how to create a PDF from a file formatted with Markdown. To do that, open a terminal window on your computer. Navigate to the folder containing the file that you want to convert to PDF and then type either:</p>
<p><code>pandoc [file-name].md --pdf-engine=weasyprint -o [file-name].pdf</code></p>
<p>or</p>
<p><code>pandoc [file-name].md --pdf-engine=wkhtmltopdf -o [file-name].pdf</code></p>
<p>Where <em>[file-name].md</em> is the name of the Markdown file that you want to convert.</p>
<p><strong>Note:</strong> Some people add the <em>-t html</em> option to those commands to create an HTML file that WeasyPrint and wkhtmltopdf then convert to PDF. The command also works without that option.</p>
<p>Here’s the result of a conversion using wkhtmltopdf:</p>
<figure>
<img src="../../../../images/pdf/wkhtmltopdf-conversion.png" alt="Markdown file converted to PDF with wkhtmltopdf" />
</figure>
<p>What you get looks pretty much the same when you use WeasyPrint to do the conversion. The result is functional, but it’s not the nice PDF file that I promised you in the title of this article. So let’s look at how to add a bit of visual flair to a PDF generated with pandoc.</p>
<h2 id="enter-print-css">Enter Print CSS</h2>
<p><a href="https://en.wikipedia.org/wiki/CSS" target="_blank">Cascading Style Sheets</a> (CSS for short) is a way to change the look and feel of a web page or website. Print CSS extends that to formatting a web page or website to be printed. It adds support for changing page sizes, adding page breaks, hiding elements that shouldn’t be printed, adding a cover page, and more.</p>
<p>I’m not going to into print CSS in any detail here, because it’s a big topic that my little brain has trouble wrapping itself around. However, I’m not going to leave you hanging. Here are some sources of information that can help you get started with print CSS:</p>
<ul>
<li><a href="https://www.print-css.rocks/" target="_blank">Introduction to PrintCSS and CSS Paged Media</a></li>
<li><a href="https://www.sitepoint.com/css-printer-friendly-pages/" target="_blank">How to Create Printer-friendly Pages with CSS</a></li>
<li><a href="https://www.jotform.com/blog/css-perfect-print-stylesheet-98272/" target="_blank">CSS: The Perfect Print Stylesheet</a></li>
</ul>
<h2 id="using-print-css-in-a-conversion">Using Print CSS in a Conversion</h2>
<p>Let’s say you’ve crafted your own print CSS file or begged/borrowed one from somewhere. To use it, you’ll need to add the <em>–css=</em> option to the string of options that you use with pandoc.</p>
<p>So, once again, open a terminal window on your computer. Navigate to the folder containing the file that you want to convert to PDF and then type either:</p>
<p><code>pandoc [file-name].md --pdf-engine=weasyprint --css=pdf-styles.css -o [file-name].pdf</code></p>
<p>or</p>
<p><code>pandoc [file-name].md --pdf-engine=wkhtmltopdf --css=pdf-styles.css -V papersize:a5 -o [file-name].pdf</code></p>
<p>Change <em>pdf-styles.css</em> to the name of your print CSS file. Here’s an example the output, via WeasyPrint, from a print CSS file that I use:</p>
<figure>
<img src="../../../../images/pdf/weasyprint-conversion.png" alt="Markdown file converted to PDF with WeasyPrint" />
</figure>
<p>My stylesheet, while fairly basic:</p>
<ul>
<li>Sets the size of the page to <a href="https://papersizes.io/a/a5" target="_blank">A5</a>.</li>
<li>Adds page breaks before every Heading 1.</li>
<li>Creates margins of 1 inch (2.5 cm) all around.</li>
<li>Uses the Overpass font for all text.</li>
</ul>
<p>The first point in the list above is one area in which WeasyPrint and wkhtmltopdf differ. wkhtmltopdf ignores page sizes that you specify in the CSS file. Instead, you need to specify the page size in the conversion command using the option <em>-V papersize:a5</em>.</p>
<p>The examples I’ve included in this article are fairly basic. But, I hope, they’ll help spark a few ideas for converting your documents formatted with Markdown (or another markup language) to PDF using pandoc.</p>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Four Links - March 29, 2022</title>
 <link>https://plaintextproject.online/articles/2022/03/29/links.html</link>
 <guid>https://plaintextproject.online/articles/2022/03/29/links.html</guid>
  <pubDate>Tue, 19 Mar 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   A set of links that look at scientific writing in plain text
   ]]></description>
  <content:encoded><![CDATA[
   <p>The <em>Scientific writing in plain text</em> edition</p>
<ul>
<li><a href="https://economicsfromthetopdown.com/2020/12/10/why-and-how-i-write-scientific-documents-in-plain-text/" target="_blank">Why and How I Write Scientific Documents in Plain Text</a></li>
<li><a href="https://jaantollander.com/post/scientific-writing-with-markdown/" target="_blank">Scientific Writing with Markdown</a></li>
<li><a href="https://medium.com/thoughts-philosophy-writing/writing-an-academic-paper-in-plain-text-and-sharing-everywhere-part-iv-of-the-series-774b4c02fe6f" target="_blank">Writing an academic paper in plain text and sharing everywhere</a></li>
<li><a href="https://scientificallysound.org/2021/02/09/markdown-for-science-and-academia-part-1/" target="_blank">Markdown for Science and Academia – Why?</a></li>
</ul>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Tools Roundup - March 16, 2022</title>
 <link>https://plaintextproject.online/articles/2022/03/16/tools.html</link>
 <guid>https://plaintextproject.online/articles/2022/03/16/tools.html</guid>
  <pubDate>Wed, 16 Mar 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   A quick look at three useful plain text tools
   ]]></description>
  <content:encoded><![CDATA[
   <p>Welcome to this edition of an irregular series of roundups that look at plain text tools I’ve found interesting but haven’t explored in depth. Let’s dive in!</p>
<h2 id="enter">Enter</h2>
<p>As you probably know, I’m a <a href="https://opensourcemusings.com" target="_blank">Linux guy</a>. I don’t use Cupertino’s fruit machines in my personal life. That said, there are some interesting plain text apps for the phones and tablets that the company puts out. One of them is <a href="https://entermaurs.com/pages/enter-home" target="_blank">Enter</a>.</p>
<p>It’s described as <em>a lightweight note-taking app</em>. It enables you to quickly take notes and add tags to those notes to organize and filter them. You can also lock notes to make them private, and archive (rather than delete) notes so you can dig them up later.</p>
<h2 id="bartib">Bartib</h2>
<p>Do you need to track the time that you spend working on tasks? And are you comfortable at the command line? Then you might want to give <a href="https://github.com/nikolassv/bartib" target="_blank">Bartib</a> a look.</p>
<p>The tool has a small set of <a href="https://github.com/nikolassv/bartib#command-overview" target="_blank">simple commands</a> which, among other things, lets you specify the times that you started and stopped a task, continue to track time against one you’ve stopped, and create reports on what you’ve been working on. You can also list all of the project you’re working on, all of the project you’ve worked on in the past, and even edit the text file containing all of your information in your editor of choice.</p>
<h2 id="plann">plann</h2>
<p><a href="https://plann.one/" target="_blank">plann</a> isn’t software. It’s a template (in the form of a text file) that you use to plan and track your activities for a given week. While it doesn’t have any moving parts, plann definitely fits my definition of a simple, useful tool.</p>
<p>All you need to do is <a href="https://plann.one/#download" target="_blank">download</a> the template (named <em>plann.txt</em>), save it with a different name, and open it in you favourite text editor. From there, you <em>list how many tasks you prefer and mark them with an “x” once completed.</em> Simple, straightforward productivity. As it should be.</p>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Working in Plain Text with Notepad++</title>
 <link>https://plaintextproject.online/articles/2022/03/02/npp.html</link>
 <guid>https://plaintextproject.online/articles/2022/03/02/npp.html</guid>
  <pubDate>Wed, 02 Mar 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   A look at a powerful and flexible text editor for Windows
   ]]></description>
  <content:encoded><![CDATA[
   <p>I’m a Linux user, and have been since late 1999/early 2000. Windows and MacOS don’t factor into my civilian life in any way.</p>
<p>But at several of the Day Job<sup>TM</sup>s I’ve held over the decades, I’ve had to use Windows on company-issued computers. In that situation, I try to use as much open source software as I can, even on closed platforms. That includes my text editor of choice on Windows. Which, for as long as I can remember, has been <a href="https://notepad-plus-plus.org/" target="_blank">Notepad++</a>. It’s a powerful, flexible open source editor, that’s kind of like Windows Notepad on all sorts of digital performance enhancers.</p>
<p>While billed as a source code editor, even non techies will find Notepad++ useful. I do, mainly using it to take notes, to write drafts, to maintain my <a href="../../../2021/07/21/timesheet.html">weekly timesheet</a>, to plan my work, and as a scratchpad.</p>
<p>Let’s take a quick look at working with Notepad++.</p>
<p><strong>Note:</strong> In the next several hundred words, I won’t be looking at all of the features of the editor or its features for coders. This article looks at Notepad++ from the perspective of how someone like me might use it.</p>
<h2 id="getting-going">Getting Going</h2>
<p>You can either download <a href="https://notepad-plus-plus.org/downloads/" target="_blank">an installer</a> from the Notepad++ website or get an unofficial fork of the editor from the Microsoft Store within Windows. If use Linux and want to give the editor a try, you can install a version from the <a href="https://snapcraft.io/notepad-plus-plus" target="_blank">Snap store</a>.</p>
<p>On Windows, installation is point and click. When it’s done, the installation process adds an icon to the Start menu and (optionally) to your desktop.</p>
<h2 id="getting-to-work">Getting to Work</h2>
<p>Fire up the editor. Looks kind of familiar, doesn’t it?</p>
<p><img src="../../../../images/npp/notepad++-first-startup.png" alt="Notepad++ when you first start it" /><br />
</p>
<p>Notepad++ is like a lot of editors out there, regardless of the operating system on which they run. You get a blank canvas on which to work, and you can have multiple text files open in their own tabs.</p>
<p>As with any text editor, you can either open an existing file or create one. From there, you start typing.</p>
<p><img src="../../../../images/npp/notepad++-editing-note.png" alt="Editing in Notepad++" /><br />
</p>
<p>When you save the file, Notepad++ applies <a href="https://en.wikipedia.org/wiki/Syntax_highlighting" target="_blank">syntax highlighting</a> to it based on the extension you give the file. Here’s an example of an HTML file, with syntax highlighting applied:</p>
<p><img src="../../../../images/npp/notepad++-syntax-highlighting.png" alt="An HTML file with syntax highlighting in Notepad++" /><br />
</p>
<p>You can change the highlighting by selecting one of the many options from the <strong>Language</strong> menu.</p>
<h2 id="using-the-editors-built-in-functions">Using the Editor’s Built-In Functions</h2>
<p>There are a lot of those, as can see from the toolbar:</p>
<p><img src="../../../../images/npp/notepad++-toolbar.png" alt="The toolbar in Notepad++" /><br />
</p>
<p>There are also quite a few more under the editor’s menus. To be honest, I don’t use even a quarter of those functions. The ones I do use include:</p>
<ul>
<li><strong>Edit &gt; Convert Case to</strong>, which changes the case of text you highlight — for example, to all caps, mixed case, or title case.</li>
<li><strong>Edit &gt; Line Operations</strong>, which does things like splitting and joining lines, removing empty lines, and sorting lines.</li>
<li>Search and replace, which does what it says on the tin (and does it quite well, too).</li>
<li>Run, which enables you to (among other things) open an HTML file in your web browser of choice.</li>
</ul>
<p>There are also a couple of other options enabled by <a href="#plugins">plugins</a> that I use regularly, which I’ll discuss in a moment.</p>
<h2 id="making-the-editor-your-own">Making the Editor Your Own</h2>
<p>While you can’t customize Notepad++ to the degree you can, say, with Emacs or <a href="../../../2018/05/21/atom.html">Atom</a>, you can make the editor your own. Let’s look at a few ways in which to do that.</p>
<h3 id="changing-preferences">Changing Preferences</h3>
<p>You find these under <strong>Settings &gt; Preferences</strong>. And there are more than a couple of options there.</p>
<p><img src="../../../../images/npp/notepad++-preferences.png" alt="Preferences in Notepad++" /><br />
</p>
<p>Some of those options include:</p>
<ul>
<li>Whether or not to display the toolbar, and how large the icons on the toolbar are.</li>
<li>The type of <a href="https://en.wikipedia.org/wiki/Newline" target="_blank">line endings</a> and the default programming or markup language of new files.</li>
<li>What types of files open in the editor when you double click them in your file manager or on the desktop.</li>
<li>The behaviour of syntax highlighting.</li>
<li>How <a href="https://en.wikipedia.org/wiki/Autocomplete" target="_blank">auto completion</a> behaves when you’re typing (or if it’s even enabled).</li>
</ul>
<p>You can also change your keyboard shortcuts — for example, to make Notepad++ behave like Emacs or Vim — by selecting <strong>Settings &gt; Shortcut Mapper</strong>.</p>
<h3 id="plugins">Using Plugins</h3>
<p>Like many editors, Notepad++ supports <a href="https://github.com/notepad-plus-plus/nppPluginList/blob/master/doc/plugin_list_x64.md" target="_blank">plugins</a> that expand its capabilities. Many of them are aimed at software developers, so I ignore them. Two that I find indispensable are:</p>
<ul>
<li><a href="https://github.com/Predelnik/DSpellCheck" target="_blank">DSpellCheck</a>, which helps pinpoint spelling mistakes.</li>
<li><a href="https://nea.github.io/MarkdownViewerPlusPlus/" target="_blank">MarkdownViewerPlusPlus</a>, which lets me preview files formatted with Markdown in a pane in the editor.</li>
</ul>
<p>Here’s an example of the latter in action:</p>
<p><img src="../../../../images/npp/notepad++-markdown-preview.png" alt="Previewing Markdown in Notepad++" /><br />
</p>
<h3 id="adding-syntax-highlighting">Adding Syntax Highlighting</h3>
<p>Out of the box, Notepad++ can apply syntax highlighting to … well, I don’t know how many programming and markup languages. But if there’s a language. But if a language that you’re working in isn’t supported, you can add it.</p>
<p>One way to do that is to create your own language settings by selecting <strong>Language &gt; Define your own language</strong>. There’s <a href="https://npp-user-manual.org/docs/user-defined-language-system/" target="_blank">documentation</a> around how to do that if you want to embrace your inner geek a bit.</p>
<p>The other way to add syntax highlighting for a language is to <a href="https://github.com/notepad-plus-plus/userDefinedLanguages/blob/master/udl-list.md" target="_blank">download</a> a language file and <a href="https://npp-user-manual.org/docs/user-defined-language-system/#import-a-udl" target="_blank">import it</a>.</p>
<h3 id="using-the-style-configurator">Using the Style Configurator</h3>
<p>What happens if you don’t quite like the way syntax highlighting for a particular language works? Select <strong>Settings &gt; Style Configurator</strong> and make some changes.</p>
<p><img src="../../../../images/npp/notepad++-style-configurator.png" alt="Style Configurator in Notepad++" /><br />
</p>
<p>You can change the highlighting colours of certain elements, the font used for those elements, and the file extensions that Notepad++ associates with the language.</p>
<h2 id="final-thoughts">Final Thoughts</h2>
<p>As I mentioned at the top of this article, I only use Notepad++ on computers supplied by my employers. Find it’s a great alternative to Windows’ stock Notepad editor, even if I don’t use all of its features. The ones I use, though, make working with plain text much, much easier.</p>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Four Links - February 23, 2022</title>
 <link>https://plaintextproject.online/articles/2022/02/23/links.html</link>
 <guid>https://plaintextproject.online/articles/2022/02/23/links.html</guid>
  <pubDate>Wed, 23 Feb 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   Four links, focusing on Markdown
   ]]></description>
  <content:encoded><![CDATA[
   <p>The <em>Yet more Markdown</em> edition:</p>
<ul>
<li><a href="https://sdsawtelle.github.io/blog/output/simple-markdown-resume-with-pandoc-and-wkhtmltopdf.html" target="_blank">The Simplest Markdown Resume Workflow</a></li>
<li><a href="https://writingcenter.appstate.edu/news/markup-markdown-write-elegant-plain-text" target="_blank">Markup, Markdown: Write In Elegant Plain Text</a></li>
<li><a href="https://www.devontechnologies.com/de/blog/tuesdaytipmakeplaintextprettywithmarkdown" target="_blank">Make Plain Text Pretty with Markdown</a></li>
<li><a href="https://microbiology.github.io/blog/cover-letter-template/" target="_blank">How to Write Your Next Letter Using Markdown</a></li>
</ul>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Taking Plain Text Notes with Nextcloud Notes</title>
 <link>https://plaintextproject.online/articles/2022/02/15/notes.html</link>
 <guid>https://plaintextproject.online/articles/2022/02/15/notes.html</guid>
  <pubDate>Tue, 15 Feb 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   A peek at using the Notes app in the online file syncing tool Nextcloud
   ]]></description>
  <content:encoded><![CDATA[
   <p>(<strong>Note:</strong> This article was first published, in a slightly different form, at <a href="https://opensourcemusings.com/taking-notes-with-nextcloud-notes" target="_blank">Open Source Musings</a> and appears here via a <a href="https://creativecommons.org/licenses/by-nc-sa/4.0/" target="_blank">Creative Commons BY-NC-SA 4.0</a> license.)</p>
<p>There are a myriad of note taking tools out there. And those tools cater to a variety of needs and to a variety of user bases. It isn’t a stretch to say that there’s a note taking application for just about everyone.</p>
<p>If you use <a href="https://opensourcemusings.com/using-nextcloud-as-a-personal-hub" target="_blank">Nextcloud</a>, you have a more-than-serviceable option in the form of (wait for it!) <a href="https://apps.nextcloud.com/apps/notes" target="_blank">Notes</a>. It’s worth a look if your note taking needs are simple and you want to work in plain text.</p>
<p>Let’s take that look, shall we?</p>
<h2 id="working-with-notes">Working with Notes</h2>
<p>Before you start, you’ll need an instance of Nextcloud. You can either host your own instance or get <a href="https://nextcloud.com/signup/" target="_blank">account with a provider</a>.</p>
<p>Notes should be enabled out of the box. If it isn’t, click the account icon in the top-right corner and then click <strong>+Apps</strong>. Find Notes in the list and click <strong>Enable</strong>. The <strong>Notes</strong> icon appears on the toolbar.</p>
<p><img src="../../../../images/notes/nextcloud-toolbar.png" alt="The Notes icon on the toolbar in Nextcloud" /><br />
</p>
<p>Click the <strong>Notes</strong> icon and then click <strong>New note</strong>. The editing space displays.</p>
<p><img src="../../../../images/notes/nextcloud-notes-editing.png" alt="Editing a note with Nextcloud Notes" /><br />
</p>
<p>The editor is simple and bare bones. But more than enough for most tasks.</p>
<p>To get to work, start typing. The first line of the note becomes its title in the sidebar. You can use Markdown to format your notes.</p>
<p><img src="../../../../images/notes/nextcloud-notes-example.png" alt="A note in Nextcloud Notes" /><br />
</p>
<p>Nextcloud saves your notes as you type to the folder <em>Notes</em>. You can change that folder. More on this in a moment.</p>
<h2 id="organizing-your-notes">Organizing Your Notes</h2>
<p>If you take a lot of notes, you’ll quickly wind up with a long list of notes in the sidebar. You can group your notes into <em>categories</em> to make them easier to manage.</p>
<p><img src="../../../../images/notes/nextcloud-notes-categories.png" alt="A list of Nextcloud Notes categories" /><br />
</p>
<p>To add a note to a category, click the ellipsis (<strong>…</strong>) in the top-right corner of the editing space and then click <strong>Details</strong>.</p>
<p><img src="../../../../images/notes/nextcloud-notes-details.png" alt="The details of a note in Nextcloud Notes" /><br />
</p>
<p>Click in the <strong>Category</strong> field and select the category to use.</p>
<p><img src="../../../../images/notes/nextcloud-notes-select-category.png" alt="Selecting a category in Nextcloud Notes" /><br />
</p>
<p>If a suitable category doesn’t exist, then type the name of a new one in the field and press Enter.</p>
<h2 id="other-features">Other Features</h2>
<p>Earlier, I mentioned that Nextcloud Notes is simple and fairly bare bones. That doesn’t mean it lacks features. Here are a few that you might be find useful.</p>
<h3 id="previewing-notes">Previewing Notes</h3>
<p>If you format your notes with <a href="https://gum.co/learnmarkdown" target="_blank">Markdown</a>, you can view how they’ll look when converted to HTML (or another format).</p>
<p>To do that, click the ellipsis in the top-right corner of the editing space and then click <strong>Preview</strong>.</p>
<p><img src="../../../../images/notes/nextcloud-notes-preview.png" alt="Previewing a note in Nextcloud Notes" /><br />
</p>
<p>You can go back to editing the note by clicking the ellipsis and then clicking <strong>Edit</strong>.</p>
<h3 id="creating-a-task-list-or-a-checklist">Creating a Task List or a Checklist</h3>
<p>You can also use to Nextcloud Notes as a plain text task list or checklist. Do that by creating a new note. Then, type this:</p>
<pre><code> * [ ]</code></pre>
<p>That immediately turns into a checkbox. Type a description of the task or the checklist item and then press Enter. Doing that adds a new item to the list.</p>
<p><img src="../../../../images/notes/nextcloud-notes-task-list.png" alt="Example of a task list in Nextcloud Notes" /><br />
</p>
<h3 id="changing-the-settings">Changing the Settings</h3>
<p>There are only two that you can change:</p>
<ul>
<li>The default extension of a file (this is <em>.md</em>), and</li>
<li>The folder in which Nextcloud saves your notes (the default is <em>Notes</em>).</li>
</ul>
<p>To change those options, click <strong>Settings</strong> in the sidebar.</p>
<figure>
<img src="../../../../images/notes/nextcloud-notes-settings.png" alt="Changing the settings of Nextcloud Notes" /><figcaption aria-hidden="true">Changing the settings of Nextcloud Notes</figcaption>
</figure>
<h2 id="going-mobile">Going Mobile</h2>
<p>You’re not stuck with working with Nextcloud Notes on your computer. If you’re using an Android-powered device, you can install the <a href="https://f-droid.org/en/packages/it.niedermann.owncloud.notes" target="_blank">Nextcloud Notes</a> app.</p>
<p>The mobile app Nextcloud Notes to your device. You can create and edit notes, add categories (and add notes to them), create task lists and checklists, preview your notes, and even use the mobile app with multiple Nextcloud accounts.</p>
<p>There’s also a widget that you can use to display notes on a home screen. Or you can pin a shortcut to a specific note on a home screen to get quick access to it.</p>
<p><img src="../../../../images/notes/nextcloud-notes-mobile.png" alt="The Nextcloud Notes mobile app in action" /><br />
</p>
<h2 id="final-thoughts">Final Thoughts</h2>
<p>Nextcloud Notes is a good choice if you need a way to quickly take notes and sync them between your devices. That Nextcloud Notes saves your notes as individual files, which you can work with using any text editor, is a bonus. As is its support for <a href="https://gum.co/learnmarkdown" target="_blank">Markdown</a>.</p>
<p>If that wasn’t enough, the Notes app is another way to enhance Nextcloud as your own <a href="https://opensourcemusings.com/using-nextcloud-as-a-personal-hub" target="_blank">productivity hub</a>.</p>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Thoughts About Using Obsidian</title>
 <link>https://plaintextproject.online/articles/2022/02/02/obsidian.html</link>
 <guid>https://plaintextproject.online/articles/2022/02/02/obsidian.html</guid>
  <pubDate>Wed, 02 Feb 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   Some thoughts inspired by my experiment with using Obsidian as a personal knowledge management tool
   ]]></description>
  <content:encoded><![CDATA[
   <p>(<strong>Note:</strong> Just so you know, I planned, outlined, and wrote the first couple of drafts of this article in Obsidian.)</p>
<p>Over the past 18 months or so, several readers of The Plain Text Project (as well as more than a couple of friends and folks I know) have been pointing me towards a certain piece of software. That software? <a href="https://obsidian.md" target="_blank">Obsidian</a>.</p>
<p>In addition to getting my ears (virtual and physical) filled with tales of Obsidian and what it can do for me, I read more than a bit about. By September, 2021 I was intrigued enough by Obsidian to cave into peer pressure.</p>
<p>I installed Obsidian on a laptop and spent about a month or so working with it. Not exclusively, mind you, but regularly and instead of certain other tools. Which leads us to the article that you’re reading now.</p>
<p>Here are a few of my thoughts about working with Obsidian.</p>
<h2 id="obsidian">Obsidian?</h2>
<p>Obsidian is a piece of software that bills itself as a <em>a powerful knowledge base on top of a local folder of plain text <a href="https://scottnesbitt.gumroad.com/l/learnmarkdown" target="_blank">Markdown</a> files.</em> It’s essentially a turbo-charged note taking tool.</p>
<p>The folder mentioned in the previous paragraph is called a <em>vault</em>. Each file in the vault is a <em>note</em>, which can be just that or an outline or a task list or … well, just about anything you want or need the file to be</p>
<p>You can have multiple vaults — one for each project you’re working on or for specific purposes — for example, research for a paper or a vault containing personal files.</p>
<p>You can also add more featured to Obsidian using <em>plugins</em>. There are several pre-installed, including ones to import files formatted with Markdown and for creating outlines. There are also hundreds of plugins that were created by Obsidian’s community of users. You can use those plugins to, for example, modify Obsidian’s appearance, export your notes to various formats using <a href="https://pandoc.org" target="_blank">pandoc</a>, generate a travel itinerary, add a Pomodoro time to Obsidian, and more.</p>
<p>Obsidian’s superpower, though, is its ability to link between notes. That enables you to quickly jump between them as needed. Obsidian can also generate a visual map of the links between notes.</p>
<h2 id="my-thoughts">My Thoughts</h2>
<p>As I mentioned at the top of this article, I used Obsidian for a month. I’m no expert with it, but I got a good feel for Obsidian and what it can do.</p>
<p>Obsidian is a solid tool, and I can see its usefulness. It’s not for me, though. Why? It’s ideal for bigger projects, for thinking in a grander way than I do or ever will. Obsidian can be useful for, say:</p>
<ul>
<li>Preparing a masters or Ph.D. thesis.</li>
<li>Organizing research for an investigative report.</li>
<li>Writing a long book.</li>
</ul>
<p>And more. That said, Obsidian doesn’t work in the way in which I work. My own projects are smaller in scope, with fewer connections and fewer moving parts. I tend to think in a more granular fashion. I look at and think about smaller pictures, not larger ones. I don’t stitch those smaller pictures into a larger, overarching one. When I try to use Obsidian, I feel like I’m trying to shoehorn the way in which I think and work into Obsidian’s framework. That's not a comfortable or efficient way to operate.</p>
<p>When I shared these thoughts with a few other people, they tried to convince me that I needed to delve deeper. They tried to convince me that Obsidian is a fresh, innovative tool. I’m not so sure about that. In many ways, I see Obsidian (and applications like it) as just the next step in the evolution of the wiki. A wiki with a few additional bits snapped on, but a wiki nonetheless.</p>
<h2 id="trying-to-be-everything">Trying to Be Everything</h2>
<p>Obsidian is one of those applications that people can use for everything. And, as I discovered, more than a handful do just that. In that way, it reminds me of <a href="https://evernote.com" target="_blank">Evernote</a> or <a href="https://orgmode.org/" target="_blank">Emacs org-mode</a>, and the ways in which many people use them.</p>
<p>You can use Obsidian to take notes, keep a journal, log your life, maintain task lists, organize your research, write, cultivate and publish a <a href="https://weeklymusings.net/weekly-musings-092" target="_blank">digital garden</a> and much, much more. I can’t even begin to scratch the surface of what Obsidian can do and what people use it for.</p>
<p>For me, for what I do, Obsidian is just a bit <em>too much</em>. I find that whatever I can do with Obsidian I can do comfortably using my favourite text editor, a set of text files, and a well-planned <a href="../../../2019/11/05/folders.html">folder structure</a>. Taking that route keeps everything fairly lean and simple, which is how I like it.</p>
<p>That’s not to say Obsidian is bad. Or <em>useless</em>. It’s far from either. I can see how some folks would find Obsidian to be a boon.</p>
<p>One advantage I see to Obsidian is that you can have everything in one place. And using the right plugins, you can turn Obsidian into a work hub — you don’t need to jump between applications.</p>
<h2 id="final-thoughts">Final Thoughts</h2>
<p>As I mentioned a few paragraphs ago, Obsidian just doesn’t fit into my way of working. For me, Obsidian offers little or no advantage over using plain text files and a simple text editor.</p>
<p>Features like Obsidian's map view and its abundance of plugins are interesting, but they really only get in my way. And since I don’t often link, or need to link, directly or explicitly between notes that isn’t a selling point for me.</p>
<p>I don’t have enough incentive to spend time adapting the way in which I work to Obsidian. I gave it a close look, but it didn’t work out.</p>
<p>Even though Obsidian isn’t for me, it might be for you. Here are some links to help you learn more about the software:</p>
<ul>
<li><a href="https://www.sitepoint.com/obsidian-beginner-guide/" target="_blank">A Guide to Obsidian: Local, Markdown-Powered Networked Notes</a></li>
<li><a href="https://www.keepproductive.com/blog/obsidian-beginners-guide" target="_blank">Your Beginner’s Guide to Obsidian</a></li>
<li><a href="https://atoughnut.com/a-beginners-guide-to-obsidian/" target="_blank">A Beginner’s Guide to Obsidian, the note-taking app that wants to be your Second Brain</a></li>
<li><a href="https://yordi.me/publish-your-obsidian-vault-to-your-digital-garden/" target="_blank">Publish your Obsidian Vault to your Digital Garden</a></li>
</ul>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Four Links - January 26, 2022</title>
 <link>https://plaintextproject.online/articles/2022/01/26/links.html</link>
 <guid>https://plaintextproject.online/articles/2022/01/26/links.html</guid>
  <pubDate>Wed, 26 Jan 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   Four links, this time about keeping a journal in plain text
   ]]></description>
  <content:encoded><![CDATA[
  <ul>
<li><a href="https://ryancollins.org/2019/12/30/start-journaling-with-a-simple-text-file/" target="_blank">Start journaling with a simple text file</a></li>
<li><a href="https://patdavid.net/2019/09/setting-up-jrnl-for-journaling/" target="_blank">Setting up jrnl for Journaling</a></li>
<li><a href="https://hund.tty1.se/2019/12/19/my-simple-plain-text-journal.html" target="_blank">My simple plain text journal</a></li>
<li><a href="https://sites.google.com/site/plaintextlife/that-all-important-journal-as-a-simple-text-file" target="_blank">That all important journal as a simple text file</a></li>
</ul>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Tools Roundup - January 12, 2022</title>
 <link>https://plaintextproject.online/articles/2022/01/12/tools.html</link>
 <guid>https://plaintextproject.online/articles/2022/01/12/tools.html</guid>
  <pubDate>Wed, 12 Jan 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
   A quick look at four useful plain text tools
   ]]></description>
  <content:encoded><![CDATA[
  <p>Welcome to this edition of an irregular series of roundups that look at plain text tools I’ve found interesting but haven’t explored in depth. Let’s dive in!</p>
<h2 id="code">Code</h2>
<p><a href="https://github.com/elementary/code" target="_blank">Code</a> is the text editor that comes with a Linux distribution called <a href="https://elementary.io" target="_blank">elementary OS</a>. It lies somewhere between a bare bones text editor and one packed with a pile of features. While Code probably isn’t going to appeal to the techies, it’s more than up to most everyday text editing tasks.</p>
<p>While Code doesn’t pack much in the way of features, what features it does have are better than pretty good. That includes syntax highlighting, an HTML previewer, along with a solid search and replace function. Code also comes with a set of extensions like a spelling checker, word completion, and bracket completion (useful if you’re working with a markup language).</p>
<h2 id="ts">ts</h2>
<p>A <a href="../../../2021/07/21/timesheet.html" target="_blank">while back</a>, I looked at how to create a plain text timesheet. What I described in that article was pretty basic. If you’re looking for more, then you’ll want to check out <a href="https://github.com/ses4j/ts" target="_blank">ts</a>.</p>
<p>ts is a <em>text-based timesheet parser</em>. You create your timesheet entries in a text files, using some simple formatting. Then, you run that file through ts to create your timesheet which includes the total number of hours that you worked. You can also generate a PDF that doesn’t look too bad.</p>
<h2 id="auer-notes">Auer Notes</h2>
<p>I can’t tell you how many note taking tools there are for macOS. Mainly because I don’t use the fruit company’s wares. Every so often, though, one of those note taking tools catches my interest. Recently, that was <a href="https://www.auernotes.com/" target="_blank">Auer Notes</a>.</p>
<p>Auer Notes is reminiscent of note taking app built into macOS Notes or something like <a href="https://www.get-notes.com/" target="_blank">Notes</a>, which I looked at in <a href="../../../2021/08/04/tools.html" target="_blank">a previous roundup</a>. Auer Notes saves your notes as individual text files, which are saved to your hard drive. The app’s interface is sparse and clean, making it easy to learn and to use.</p>
<h2 id="tomboy-notes-ng">Tomboy Notes NG</h2>
<p>Once upon a time (and that time was quite a few years ago), one of my favourite tools on the Ubuntu desktop was a note taking tool called Tomboy. Mainly because it combined the best aspects of a note taking tool with a wiki. For a variety of reasons, Tomboy fell off my radar. But it’s being revived (in a way) by the <a href="https://github.com/tomboy-notes/tomboy-ng/releases" target="_blank">tomboy-ng</a> project.</p>
<p>Like it’s predecessor, tomboy-ng enables you to quickly create and link between notes and easily add formatting to the text of a note. You can also <a href="https://github.com/tomboy-notes/tomboy-ng/wiki/File-Sync-with-tomboy-ng" target="_blank">sync files</a> between computers and create snapshots of your notes in case you need to go back to a previous version.</p>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Writing in Markdown with Apostrophe</title>
 <link>https://plaintextproject.online/articles/2022/01/04/apostrophe.html</link>
 <guid>https://plaintextproject.online/articles/2022/01/04/apostrophe.html</guid>
  <pubDate>Tue, 04 Jan 2022 19:00:00 GMT</pubDate>
  <description><![CDATA[
  An introduction to a lean, flexible Markdown editor
   ]]></description>
  <content:encoded><![CDATA[
   <p>(<strong>Note</strong>: This article was first published, in a slightly different form, at <a href="https://opensourcemusings.com/writing-in-markdown-with-apostrophe" target="_blank">Open Source Musings</a> and appears here via a <a href="https://creativecommons.org/licenses/by-nc-sa/4.0/" target="_blank">CC-BY-NC-SA 4.0</a> license.)</p>
<p>Once upon a time, I used a Linux distribution called Ubuntu quite extensively. One of my favourite apps for Ubuntu was a <a href="https://scottnesbitt.gumroad.com/l/learnmarkdown" target="_blank">Markdown</a> editor called UberWriter.</p>
<p>What made UberWriter a favourite tool was its minimalist design. The editor's interface was clean, with no distractions. It was easy to use. And UberWriter had several nice features that complemented its aesthetics.</p>
<p>Then, one day, UberWriter became practically unusable on my desktop — and not just for me, either. I uninstalled it, opting instead for a text editor. For several years, I never looked back.</p>
<p>That changed in early 2021 when <a href="https://semioticrobotic.info" target="_blank">a friend</a> pointed me in the direction of a Markdown editor called <a href="https://gitlab.gnome.org/World/apostrophe" target="_blank">Apostrophe</a>. After doing a bit of poking around, I learned that the editor is UberWriter in a new guise. Based on my past affinity for UberWriter, I immediately decided to give Apostrophe a go. Here's what happened.</p>
<h2 id="getting-apostrophe">Getting Apostrophe</h2>
<p>Since Apostrophe is a Linux application, you can check your distribution's package manager for it — You might be able to install the editor that way. If you can't, you can <a href="https://gitlab.gnome.org/World/apostrophe" target="_blank">download the source code</a> and compile it.</p>
<p>Compiling code isn't an option for everyone, though. An easier way to install Apostrophe is to use <a href="https://en.wikipedia.org/wiki/Flatpak" target="_blank">Flatpak</a>. Do that by running this command in a terminal window:</p>
<pre><code>flatpak install flathub org.gnome.gitlab.somas.Apostrophe</code></pre>
<p>You will, of course, need to <a href="https://www.flatpak.org/setup/" target="_blank">install Flatpak</a> on your computer first.</p>
<h2 id="getting-to-work">Getting to Work</h2>
<p>You've got Apostrophe installed. Now, start it up. As I mentioned at the beginning of this post, it's a minimalist editor.</p>
<p><img src="../../../../images/apostrophe/apostrophe-first-start.png" alt="Apostrophe after starting it for the first time" /></p>
<p>You can either open an existing file (move your mouse to the top of the window to display the header bar, which contains the <strong>Open</strong> button) or just start typing.</p>
<p><img src="../../../../images/apostrophe/apostrophe-in-action.png" alt="Apostrophe in action" /></p>
<p>Nothing really new or revolutionary there. It's just simple text editing which highlights Markdown formatting.</p>
<p>There's no formatting toolbar. You either need to know Markdown (<a href="https://scottnesbitt.gumroad.com/l/learnmarkdown" target="_blank">my book</a> is a great reference, by the way!) or you can use keyboard shortcuts to insert frequently-used formatting.</p>
<p><img src="../../../../images/apostrophe/apostrophe-markdown-shortcuts.png" alt="Markdown keyboard shortcuts in Apostrophe" /></p>
<h2 id="other-features">Other Features</h2>
<p>As I mentioned a couple of times already, Apostrophe is a fairly minimalist application. It does have some useful features, though. One of which is common to many a Markdown editor: a preview mode. Click the <strong>Preview</strong> button on the header.</p>
<p><img src="../../../../images/apostrophe/apostrophe-preview-button.png" alt="Preview button in Apostrophe" /></p>
<p>That switches to a view of your document as it would appear as a web page or a word processor document.</p>
<p><img src="../../../../images/apostrophe/apostrophe-preview.png" alt="Previewing a document in Apostrophe" /></p>
<p>Unfortunately, you can't change the look of the preview.</p>
<p>Apostrophe's search and replace function isn't too shabby, either. You can do case sensitive searches and use <a href="https://en.wikipedia.org/wiki/Regular_expression" target="_blank">regular expressions</a> to find words or phrases in a document.</p>
<p>Other than that, Apostrophe checks your spelling as you type and displays a running word count in the bottom right corner of the window. You can turn that automatic spell checking in the application's preferences. And if you click the word count, you also get a breakdown of the number of characters, sentences, and paragraphs in what you're writing as well as an estimated reading time.</p>
<p><img src="../../../../images/apostrophe/apostrophe-text-stats.png" alt="Text statistics in Apostrophe" /></p>
<h2 id="exporting-your-documents">Exporting Your Documents</h2>
<p><a href="https://scottnesbitt.gumroad.com/l/learnmarkdown" target="_blank">Markdown</a>'s great, but it's often not the final form for which something you're working on. When you need your document to take a different shape, you need to convert it.</p>
<p>One of UberWriter's strongest features was its ability to export Markdown documents to several other formats. Apostrophe has, not surprisingly, carried over that feature.</p>
<p>To export a file, click the <strong>Save</strong> button in the header and choose one of <strong>PDF</strong>, <strong>HTML</strong>, or <strong>ODT</strong>. That does a quick and dirty conversion to those formats. You'll need a TeX system installed on your computer to generate a PDF.</p>
<p>The default output is serviceable, though not fancy as you can see from this PDF:</p>
<p><img src="../../../../images/apostrophe/apostrophe-exported-pdf.png" alt="PDF file exported from Apostrophe" /></p>
<p>I hinted more output options, didn't I? Well, that's where the <strong>Advanced Export</strong> option under the <strong>Save</strong> menu comes in. You can use that to export your documents to these formats:</p>
<ul>
<li>PDF</li>
<li>LibreOffice Writer</li>
<li>Microsoft Word</li>
<li><a href="https://en.wikipedia.org/wiki/EPUB" target="_blank">EPUB</a></li>
<li>HTML5 slide shows (using either <a href="https://revealjs.com/" target="_blank">Reveal.js</a> or <a href="http://paulrouget.com/dzslides/" target="_blank">DZSlides</a>)</li>
<li><a href="https://en.wikipedia.org/wiki/Beamer_(LaTeX)" target="_blank">LaTeX Beamer</a> (another slide format)</li>
<li><a href="../../../2018/12/19/latex.html" target="_blank">LaTeX</a></li>
<li>HTML</li>
</ul>
<p>All those formats have several options, like including a table of contents, numbering sections, and changing the page size.</p>
<p><img src="../../../../images/apostrophe/apostrophe-advanced-export.png" alt="Advanced export options in Apostrophe" /></p>
<h2 id="a-small-annoyance">A Small Annoyance</h2>
<p>Because I've been staring at screens (often smaller ones) since the late 1980s, my eyesight has weakened. A little over nine years ago, I had to start wearing glasses while working at a computer. That also meant finding a suitable font, and increasing the size of the font, in the text editors that I use.</p>
<p>I can't do that with Apostrophe. And I tried to find a way to do the deed. It seems to be a <a href="https://gitlab.gnome.org/somas/apostrophe/-/issues/232" target="_blank">known issue</a> with the application. At the moment, not being able to change the font isn't a deal breaker for me, but I know a few people for whom it is. That said, I'd prefer to be able to use 16 point <a href="../../../2020/03/03/fonts.html#ibm-plex-mono" target="_blank">IBM Plex Mono</a> or <a href="../../../2020/03/03/fonts.html#hack" target="_blank">Hack</a> with Apostrophe.</p>
<h2 id="final-thoughts">Final Thoughts</h2>
<p>It's great to see that Apostrophe has taken up the mantle of UberWriter. The latter was an application that I enjoyed using and missed having on my Linux desktop.</p>
<p>I know that Apostrophe won't appeal to everyone — it lacks a lot of bells and whistles that some people expect a Markdown editor (or any editor, whether or not it supports Markdown) to have. Apostrophe is, though, worth a look if you're a Linux user who's looking for a minimalist Markdown editor with some useful features. An editor that lets you focus on your writing, rather than focusing on all the bells and whistles.</p>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Four Links - December 28, 2021</title>
 <link>https://plaintextproject.online/articles/2021/12/28/links.html</link>
 <guid>https://plaintextproject.online/articles/2021/12/28/links.html</guid>
  <pubDate>Tue, 28 Dec 2021 19:00:00 GMT</pubDate>
  <description><![CDATA[
   The last set of links for 2021!
   ]]></description>
  <content:encoded><![CDATA[
   <p>The <em>Markup languages</em> edition:</p>
<ul>
<li><a href="https://nudgedelastic.band/2021/08/markdown-vs-restructuredtext-for-teaching-materials/" target="_blank">Markdown vs reStructuredText for teaching materials</a></li>
<li><a href="https://www.overleaf.com/learn/latex/Learn_LaTeX_in_30_minutes" target="_blank">Learn LaTeX in 30 minutes</a></li>
<li><a href="https://opensource.com/article/21/7/what-xml" target="_blank">What is XML?</a></li>
<li><a href="https://www.freecodecamp.org/news/we-need-a-new-document-markup-language-c22e0ec44e15/" target="_blank">We need a new document markup language — here is why</a></li>
</ul>
   ]]></content:encoded>
</item>
   
   <item>
  <title>A Few Thoughts About Effectively Taking Notes with Plain Text</title>
 <link>https://plaintextproject.online/articles/2021/12/15/note-taking.html</link>
 <guid>https://plaintextproject.online/articles/2021/12/15/note-taking.html</guid>
  <pubDate>Wed, 15 Dec 2021 19:00:00 GMT</pubDate>
  <description><![CDATA[
   Some tips that might help you streamline your note taking using plain text
   ]]></description>
  <content:encoded><![CDATA[
   <p>Digital was supposed to have killed analog. But hasn’t stopped more and more people from taking notes using pen and paper. Even though sales of paper notebooks still seem to be brisk, I’m sure that more than a couple of folks out there take notes digitally.</p>
<p>I know I do.</p>
<p>Digital note taking has a lot going for it. It’s:</p>
<ul>
<li><strong>Convenient</strong> — you can create and access your notes anywhere, using a computer or a mobile device.</li>
<li><strong>Easy</strong> — since you can already use a keyboard and a mouse, you don’t need any new skills to do it.</li>
<li><strong>Flexible</strong> — you can include more than text in your notes.</li>
<li><strong>Paperless</strong> — you don’t have to worry about, for example, losing a notebook or spilling coffee on your notes.</li>
</ul>
<p>And while digital note taking is a lot like doing the deed the analog way, there are a few pieces of advice that I like the share with people who are moving their note taking to the digital realm.</p>
<h2 id="pick-your-tool">Pick Your Tool</h2>
<p>And stick with it. Learn that tool’s ins and outs, and how to use it efficiently on your desktop and on your mobile device.</p>
<p>What tool you use is up to you. My choice is <a href="../../../2018/03/01/standard.html" target="_blank">Standard Notes</a>. But I know that Standard Notes isn’t everyone’s cup of tea (or whatever hot beverage they prefer). Some of the other digital note taking tools I recommend are:</p>
<ul>
<li><a href="../../../2019/03/05/simplenote.html" target="_blank">Simplenote</a></li>
<li><a href="../../../2019/02/06/joplin.html" target="_blank">Joplin</a></li>
<li><a href="https://apps.nextcloud.com/apps/notes" target="_blank">Nextcloud Notes</a></li>
</ul>
<p>Why even use a service or an app? You can take notes using only a text editor and a set of plain text files.</p>
<h2 id="keep-your-notes-short">Keep Your Notes Short</h2>
<p>Or, as short as you can. One reason for that is many, many people use tablets or smartphones to take notes. But most of them can’t type as quickly on a tablet or on a phone keyboard as they can on a full-sized physical one. So, you should try to keep your notes concise.</p>
<p>As well, you’ll often use your notes as prompts. They’ll help remind you of details, of something that someone said, or of something you read. Then, you can fill in the blanks.</p>
<p>Write in point form or sentence fragments. A lot of the time, you don’t need to capture everything when taking notes — just the main idea or certain important bits of information.</p>
<p>That said, you have a bit more leeway when if comes to collecting quotes or passages. Instead of typing them out, you can easily copy and paste them into your tool. That saves a lot of time.</p>
<p>However, if you do that remember this important point:</p>
<h2 id="attribution-attribution">Attribution, Attribution</h2>
<p><strong>Always</strong> make a record of:</p>
<ul>
<li>The name of the person or people who said or wrote what you’re quoting.</li>
<li>Where you found that information. Include the URL, the name of the publication or blog, the title of the article/post/book containing the information you’re quoting.</li>
<li>The date on which it was published.</li>
</ul>
<p>That takes a little extra effort, but it can save you the pain of later having to track down that information later. And recording that information can ensure you don’t get stung by accusations of plagiarism or even libel.</p>
<h2 id="keep-your-notes-in-plain-text">Keep Your Notes in Plain Text</h2>
<p>Avoid, where possible, using markup to format your notes. At least when you’re taking those notes. If you’re trying to get things down quickly, using a markup language (even a lightweight one) just slows you down.</p>
<p>Later, if you need to add formatting, then I suggest doing that with <a href="https://gum.co/learnmarkdown" target="_blank">Markdown</a>.</p>
<h2 id="make-sure-you-can-get-to-your-notes">Make Sure You Can Get to Your Notes</h2>
<p>By that I mean no matter where you are, and no matter what kind of computer or device you’re using.</p>
<p>With the note taking tools that I mentioned earlier, doing that is easy. All you need to do is log into the websites of those tools and you’re set. You don’t need any desktop software. If you’re using a tablet or a smartphone, there are mobile apps available for those tools.</p>
<p>Text files and word processor documents are a slightly different story. But you’re not without hope. You can use other file sharing and syncing tools.</p>
<p>In the end, though, the quality of your notes depends on you. On your focus. On the depth of your research. While a good digital note taking tool can make taking notes more convenient, that tool won’t do the job for you.</p>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Choosing a Text Editor</title>
 <link>https://plaintextproject.online/articles/2021/12/06/choosing.html</link>
 <guid>https://plaintextproject.online/articles/2021/12/06/choosing.html</guid>
  <pubDate>Tue, 06 Dec 2021 19:00:00 GMT</pubDate>
  <description><![CDATA[
   Some advice that can help you choose the right text editor for you
   ]]></description>
  <content:encoded><![CDATA[
   <p>(<strong>Note</strong>: This article was first published, in a slightly different form, <a href="https://opensourcemusings.com/choosing-a-text-editor" target="_blank">at Open Source Musings</a> and appears here via a <a href="https://creativecommons.org/licenses/by-nc-sa/4.0/" target="_blank">CC BY-NC-SA 4.0 license</a>.)</p>
<p>The humble (and often, not-so-humble) text editor. It can be a wonderful thing. I know more than a few people who are zealous about their editors, and view them in the same way that they view their toothbrushes. Yes, they’re <em>that</em> hardcore.</p>
<p>Having said that, I know more than a few people who actually shy away from text editors. Why? Because they view editors as strictly a programmer’s tool. Nothing could be further from the truth. Even though I’m not a coder of any stripe, I find a text editor to be a valuable tool. More than that actually. For me, a good text editor is indispensable for leading a plain text life.</p>
<p>You might be writing an article, either in straight text or with a markup language like <a href="https://gumroad.com/l/learnmarkdown" target="_blank">Markdown</a>. You might be editing the <a href="https://scottnesbitt.gumroad.com/l/learnhtml"  target="_blank">HTML</a> of your web site. You might be peeking at a shell script. Or you might just be perusing a README file or change log for some software that you’re about to install. Pulling those kinds of files into a word processor is overkill.</p>
<p>Those are situations in which text editors are <em>very</em> handy. But with so many editors out there, how do you choose the one that’s for you? And by <em>you</em>, I mean someone who isn’t a software developer or (too much of) a techie. Someone who thinks that <em>C</em> is the third letter in the alphabet, for whom <em>regular expressions</em> mean an ordinary way of speaking.</p>
<p>Everyone has their own favourite editor. Here’s some advice I give to people who are looking for the right one for them.</p>
<h2 id="what-to-look-for">What to Look For</h2>
<p>Here are four things that I look for in a text editor. Your mileage (or whatever distance measurement you use) may vary.</p>
<p>First, the editor should pack some form of syntax highlighting — whether automatic or which you can turn on or off with a click or two. Why syntax highlighting? If you’re looking at any markup language (or even some code), black text on a white background tends to all look the same. It really helps if tags or comments or functions have different colours from the rest of the text. I can’t tell you how many times syntax highlighting helped me find unclosed tags in HTML.</p>
<p>Second, the editor should be fairly easy to extend. That includes</p>
<ul>
<li>I can add custom syntax highlighting definitions.</li>
<li>It’s easy to link the editor to an external program that can process or validate the file I’m working with.</li>
<li>The developers and/or user community supply plugins that can extend the editor in a variety of ways.</li>
</ul>
<p>Third, a spelling checker is a must, especially if you’re writing. Nothing more needs to be said about that.</p>
<p>Fourth, the interface should be clean. No ribbon a la Microsoft Word. Instead, it should have one toolbar and the ability to quickly show or hide side panes (which could contain anything from a list of files to additional commands). Also, I prefer an interface with tabs rather than an old school multiple document interface or a (gasp!) single document interface.</p>
<h2 id="some-suggestions">Some Suggestions</h2>
<p>So, what editors do I recommend? I mainly work on the Linux desktop, so here a few for that operating system. And you don’t have to be a coder to appreciate them.</p>
<p>First up, <a href="http://projects.gnome.org/gedit/" target="_blank">Gedit</a>. It took me a little while to warm up to Gedit, but when I did I couldn’t stop using it. Well, until I switched to <a href="https://opensourcemusings.com/making-the-switch-to-elementary-os" target="_blank">elementary OS</a> and started mainlining its default text editor. Gedit has the four main features that I look for in a text editor. What do I use it for? Mainly writing, with Markdown and without, and editing web pages. Gedit has nice Markdown and LaTeX plugins, and it also has a full-screen editing mode. Perfect for distraction-free writing.</p>
<p>Users of elementary OS have a simple but effective option editor that comes with the distribution called <a href="https://github.com/elementary/code" target="_blank">Code</a>. It's not the most feature-packed editor around, but it's great if your needs are simple. Code has several useful plugins &mdash; like a spelling checker, word completion, and browser preview of HTML files &mdash; along with syntax highlighting and a solid search and replace function.</p>
<p>I don’t use KDE anymore. But when I did, I used <a href="http://kate-editor.org/about-kate/" target="_blank">Kate</a> as my sole editor. All of my KDE-using friends do the same, and with good reason. Like Gedit, Kate has the four features that I look for in a text editor — its syntax highlighting, plugin support, and boomarking are great. As well, it’s clean and fast. While Kate isn’t enough to tempt me back to the KDE world, I’d definitely use it if I ever did go back.</p>
<p>While <a href="http://www.geany.org/Main/HomePage" target="_blank">Geany</a> is essentially a programmer’s tool, there’s a lot in it for the average user. And if you’re working with straight text or HTML or LaTeX, it’s a good choice. Geany also has a number of <a href="http://plugins.geany.org/" target="_blank">plugins</a> that can really beef up its set of features. Plus Geany supports Markdown, which is a nice bonus.</p>
<p>On other operating systems, I've enjoyed using <a href="https://www.barebones.com/products/bbedit/" target="_blank">BBEdit</a> for MacOS and <a href="https://notepad-plus-plus.org/" target="_blank">NotePad++</a> whenever I've had to use Windows. Both editors do a lot, but even for someone with simple needs BBEdit and NotePad++ can be great choices.</p>
<p>If you’re wondering why I didn’t mention Emacs or vi(m), I just <a href="http://en.wikipedia.org/wiki/Editor_war" target="_blank">didn’t want to go there</a>.</p>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Four Links - November 25, 2021</title>
 <link>https://plaintextproject.online/articles/2021/11/25/links.html</link>
 <guid>https://plaintextproject.online/articles/2021/11/25/links.html</guid>
  <pubDate>Thu, 25 Nov 2021 19:00:00 GMT</pubDate>
  <description><![CDATA[
   A set of four links to plain text resources for the end of November, 2021
   ]]></description>
  <content:encoded><![CDATA[
  <p>The <em>Tools</em> edition:</p>
<ul>
<li><a href="https://www.popularmechanics.com/technology/a26305987/word-processor-vs-text-editor-notepad-textedit/" target="_blank">Why You Should Ditch Microsoft Word for NotePad</a></li>
<li><a href="https://santiyounger.com/notes-journey" target="_blank">My Journey Into A Powerful Digital Note-taking System. From Paper to Plain-text</a></li>
<li><a href="https://macwright.com/2021/03/16/return-of-fancy-tools.html" target="_blank">The return of fancy tools</a></li>
<li><a href="https://www.sitepoint.com/obsidian-beginner-guide/" target="_blank">A Guide to Obsidian: Local, Markdown-Powered Networked Notes</a></li>
</ul>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Tools Roundup - November 17, 2021</title>
 <link>https://plaintextproject.online/articles/2021/11/17/tools.html</link>
 <guid>https://plaintextproject.online/articles/2021/11/17/tools.html</guid>
  <pubDate>Wed, 17 Nov 2021 19:00:00 GMT</pubDate>
  <description><![CDATA[
   A quick look at some plain text tools you might find interesting
   ]]></description>
  <content:encoded><![CDATA[
   <p>Welcome to this edition of an irregular series of roundups that look at plain text tools I’ve found interesting but haven’t explored in depth. Let’s dive in!</p>
<h2 id="imml">imml</h2>
<p>Putting together a small, simple web page or website doesn’t need to involve using a bulky <a href="https://en.wikipedia.org/wiki/Content_management_system" target="_blank">content management system</a> or a <a href="https://en.wikipedia.org/wiki/Web_framework" target="_blank">framework</a>. You don’t even need to code in <a href="https://scottnesbitt.gumroad.com/l/learnhtml" target="_blank">HTML</a>, either. All you need to know is a little Markdown and <a href="https://leoncvlt.github.io/imml/" target="_blank">imml</a> does the rest.</p>
<p>imml, which you can use <a href="https://leoncvlt.github.io/imml/" target="_blank">on the web</a> or at the <a href="https://leoncvlt.github.io/imml/#cli" target="_blank">command line</a> on your computer takes a file formatted with <a href="https://scottnesbitt.gumroad.com/l/learnmarkdown" target="_blank">Markdown</a> and converts it into a decent-looking web page. You can even create a multiple page site, all using a single file.</p>
<h2 id="gitjournal">GitJournal</h2>
<p>Want to take notes and/or keep a journal on your phone while embracing your inner geek a little? Then you might want to check out <a href="https://gitjournal.io/" target="_blank">GitJournal</a>.</p>
<p>It’s an Android app that uses <a href="https://en.wikipedia.org/wiki/Git" target="_blank">git</a> (a version control system that coders use) to store what you create. Once you hook GitJournal into whatever instance of git you’re using, it’s easy to write up daily journal entries or jot down notes. GitJournal supports <a href="https://scottnesbitt.gumroad.com/l/learnmarkdown" target="_blank">Markdown</a>, too.</p>
<p>(I’ll be taking a closer look at GitJournal in an upcoming article.)</p>
<h2 id="calendar.txt">Calendar.txt</h2>
<p>It’s not an application. Instead, <a href="https://terokarvinen.com/2021/calendar-txt/" target="_blank">Calendar.txt</a> is a simple, clever way to keep track of appointments, events, and the like using a plain text file.</p>
<p>Using Calendar.txt is shockingly simple. <a href="https://terokarvinen.com/2021/calendar-txt/#download-ready-made-calendar" target="_blank">Download</a> the calendar template (which is set up dates), open it in a text editor, and add to it. The file is small and you can share it between your computers and devices using your <a href="../../../2018/08/08/sync.html" target="_blank">sync tool</a> of choice.</p>
<h2 id="left">Left</h2>
<p>I can’t tell you how many <a href="https://opensourcemusings.com" target="_blank">open source</a> projects started life as a way to solve a problem their creators were facing. <a href="https://100r.co/site/left.html" target="_blank">Left</a> is one of those projects. It was developed to address the twin problems of using older hardware and living on a sailboat with a limited supply of electricity.</p>
<p>Left is a simple, useful distraction-free editor. It’s designed for writing longer-form documents — books, long essays, tracts. Anything broken into discrete sections. If you format what you’re working on using <a href="https://scottnesbitt.gumroad.com/l/learnmarkdown" target="_blank">Markdown</a>, Left generates a table of contents that lets you quickly jump to a section. It also has some nifty features like autocompletion and the ability to select a word’s synonym.</p>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Blogging in Plain Text with Mataroa</title>
 <link>https://plaintextproject.online/articles/2021/11/03/mataroa.html</link>
 <guid>https://plaintextproject.online/articles/2021/11/03/mataroa.html</guid>
  <pubDate>Wed, 03 Nov 2021 19:00:00 GMT</pubDate>
  <description><![CDATA[
   Learn about an ultra easy blogging platform that supports Markdown
   ]]></description>
  <content:encoded><![CDATA[
   <p>Blogging should be simple. Well, it is. Or, at least, it <em>can</em> be.</p>
<p>Most of us who blog, especially those of us who have personal blogs, can get away with a minimalist blog. Personal bloggers, unless they want to embrace their inner geeks, shouldn’t have to worry about confusing interfaces, about tweaking themes or messing with plugins, about twiddling and twerning the settings of a static site generator. They just need to type or drop post into an editor and click <strong>Publish</strong>.</p>
<p>A while back, I talked about <a href="../../../2019/01/02/writeas.html" target="_blank">a blogging platform</a> called Write.as (which I use extensively, in case you’re wondering) that does this <em>very</em> well. Believe it or not, you can make your blogging experience even simpler and more minimal with <a href="https://mataroa.blog" target="_blank">Mataroa</a></p>
<h2 id="getting-started">Getting Started</h2>
<p>Mataroa is a hosted service. Like any hosted service, you need to <a href="https://mataroa.blog/accounts/create/" target="_blank">sign up</a> to use it. It’s free, although you can later pay $9 (USD) a year which enables you to hook a custom domain into your blog and get automatic exports via email.</p>
<p>So you’ve signed up. Now what? Set up your blog. Do that by entering this information:</p>
<ul>
<li>User name (which becomes your subdomain). For example, if you enter <em>my blog</em>, your subdomain is <em>myblog.mataroa.blog</em>.</li>
<li>An email address (for recovering your password if you forget it).</li>
<li>Your blog’s name and a short tagline describing it.</li>
</ul>
<p>You can also enable comments on your blog and whether or not readers can receive your latest post via email. In case you’re wondering, the commenting system simple and baked into Mataroa. You get an email every time someone posts a comment.</p>
<p>Here’s an example of the settings of a blog I set up:</p>
<p><img src="../../../../images/mataroa/mataroa-sample-settings.png" alt="Sample settings for a Mataroa blog" /></p>
<h2 id="how-mataroa-structures-your-blog">How Mataroa Structures Your Blog</h2>
<p>Unlike some blogging platforms which display posts when you land on them, the front page of a blog on Mataroa displays links to your posts on the landing page.</p>
<p><img src="../../../../images/mataroa/mataroa-blog-front-page.png" alt="The front page of a Mataroa blog" /></p>
<p>The latest post appears at the top of the list. There’s no way to change the format of the front page.</p>
<h2 id="writing-and-publishing">Writing and Publishing</h2>
<p>After you’ve logged into Mataroa, click the <strong>New post</strong> link at the top of the screen. The <strong>Create a new post</strong> screen displays.</p>
<p><img src="../../../../images/mataroa/mataroa-new-post.png" alt="Getting ready to write a post in Mataroa" /></p>
<p>Enter a title for your post.</p>
<p>The <strong>Publication date</strong> field contains the current date. Keep that to publish the post today. If you want to schedule the post to publish in the future, enter a date in the <strong>Publication date</strong> field. Or leave it empty to save the post as a draft as you work on it.</p>
<p>Start typing in the <strong>Content</strong> field. Mataroa supports <a href="https://scottnesbitt.gumroad.com/l/learnmarkdown" target="_blank">Markdown</a> for formatting. You can also drag and drop images into the <strong>Content</strong> field to include then with a post.</p>
<p>Here’s an example of a post in Mataroa:</p>
<p><img src="../../../../images/mataroa/mataroa-sample-post-editing.png" alt="Editing a post in Mataroa" /></p>
<p>When you’re ready, click <strong>Save</strong> to publish the post. A link to the post is added to the front page of your blog.</p>
<h3 id="importing-posts">Importing Posts</h3>
<p>If you have one or more files formatted with Markdown, you can upload them by going to the Dashboard and clicking <strong>Import posts</strong>. Browse for the files that you want to import and then click <strong>Upload</strong>.</p>
<p>After you import the posts, Mataroa saves them as drafts.</p>
<p><img src="../../../../images/mataroa/mataroa-imported-posts.png" alt="Imported posts in Mataroa" /></p>
<p>Before publishing, you can edit the posts and add a publication date to them.</p>
<h2 id="adding-pages">Adding Pages</h2>
<p>By that, I mean an <a href="https://kevq.uk/the-importance-of-an-about-page/" target="_blank">About page</a>, a <a href="https://sive.rs/nowff" target="_blank">/now page</a>, a <a href="https://scottnesbitt.online/on-uses-pages" target="_blank">/uses page</a>, a contact page. Anything that supplements your blog or, if that’s your purpose, turns your Mataroa blog into a simple website.</p>
<p>To add a page, go to the Dashboard and click <strong>Pages</strong>. Then, click <strong>Create a new page</strong>.</p>
<p><img src="../../../../images/mataroa/mataroa-new-page.png" alt="Creating a page in Mataroa" /></p>
<p>Add a title and some text. When you save the page, Mataroa adds a link to the page in the footer of your blog’s main page and on every post.</p>
<p><img src="../../../../images/mataroa/mataroa-footer.png" alt="A footer in Mataroa showing links to pages" /></p>
<h2 id="an-annoyance">An Annoyance</h2>
<p>For me, this is the main one. That annoyance involves the footer on pages. the one I mentioned above, which contains links to the pages on you blog or site.</p>
<p>There doesn’t seem to be a way to change the position of that footer. You might want it centred on the page. You might want ti right aligned. Me? I’d prefer that the links to the pages be at the top of a blog, below the blog’s title. Sadly, you can’t move it.</p>
<h2 id="final-thoughts">Final Thoughts</h2>
<p>As you can see, Mataroa makes even something as stripped down as Write.as look bulky. It’s definitely the apotheosis of minimalist blogging.</p>
<p>Mataroa packs no frills. There are corners of the internet that would say the lack of frills is a weakness of Mataroa, that it makes the platform all but useless for <em>serious</em> blogging.</p>
<p>I disagree. That lack of frills is a strength. Using Mataroa, you can you can quickly and easily set up a simple blog or even a web site. Because it’s powered by plain text, Mataroa enables you to focus on your words and ideas. Its support for <a href="https://scottnesbitt.gumroad.com/l/learnmarkdown" target="_blank">Markdown</a> is a bonus.</p>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Four Links - October 27, 2021</title>
 <link>https://plaintextproject.online/articles/2021/10/27/links.html</link>
 <guid>https://plaintextproject.online/articles/2021/10/27/links.html</guid>
  <pubDate>Wed, 27 Oct 2021 19:00:00 GMT</pubDate>
  <description><![CDATA[
   Four new links about plain text
   ]]></description>
  <content:encoded><![CDATA[
   <ul>
<li><a href="https://www.artkpv.net/plain-text-organization/" target="_blank">Intro to plain text productivity</a></li>
<li><a href="https://senseopenness.com/blog/why-plaintext/" target="_blank">Why Plain Text?</a></li>
<li><a href="https://wippp.com/home/why-i-use-plaintext" target="_blank">Why I Use Plaintext</a></li>
<li><a href="https://hund.tty1.se/2020/10/28/my-plaintext-todo-list.html" target="_blank">My plaintext todo list</a></li>
</ul>
   ]]></content:encoded>
</item>
   
   <item>
  <title>Announcing the Third Edition of Learning Markdown</title>
 <link>https://plaintextproject.online/articles/2021/10/12/markdown.html</link>
 <guid>https://plaintextproject.online/articles/2021/10/12/markdown.html</guid>
  <pubDate>Tue, 12 Oct 2021 19:00:00 GMT</pubDate>
  <description><![CDATA[
   The new edition of Learning Markdown is (finally!) here
   ]]></description>
  <content:encoded><![CDATA[
   <p>It’s been in the works for a while, but I’m happy to announce that the third edition of my book <em>Learning Markdown</em> has finally hit the virtual shelves.</p>
<p>Here is what’s new in this edition:</p>
<ul>
<li>A new chapter that covers how to use pandoc to convert your files formatted with Markdown to HTML, word processor formats, and PDF files.</li>
<li>The list of tools for working with Markdown has been updated and expanded.</li>
<li>A number of general tweaks and minor changes and updates.</li>
</ul>
<p>If you purchased a previous edition of <em>Learning Markdown</em> at Gumroad, you’ll have received an email with information on how to get the new edition of the book for free. If you haven’t received that message, please <a href="https://plaintextproject.online/contact.html" target="_blank">contact me</a>.</p>
<p>If you <em>haven’t</em> bought the book, here’s your chance. You can read <a href="https://scottnesbitt.net/docs/Learning-Markdown-sample-chapter.pdf" target="_blank">a sample chapter</a> if you’re curious. And if you’re ready to buy the book, you can find EPUB and PDF versions on <a href="https://scottnesbitt.gumroad.com/l/learnmarkdown" target="_blank">Gumroad</a>.</p>
   ]]></content:encoded>
</item>
   
 <item>
  <title>How I Use LaTeX</title>
 <link>https://plaintextproject.online/articles/2021/10/05/latex.html</link>
 <guid>https://plaintextproject.online/articles/2021/10/05/latex.html</guid>
  <pubDate>Tue, 05 Oct 2021 19:00:00 GMT</pubDate>
  <description><![CDATA[
   A glimpse at the kinds of projects that I use LaTeX for
   ]]></description>
  <content:encoded><![CDATA[
   <p>My first brush with a markup language came in the early 1990s with <a href="https://en.wikipedia.org/wiki/TeX" target="_blank">TeX</a> — a typesetting system used extensively by mathematicians and researchers. How someone like me, with few technical or math skills, came to use TeX is a mildly amusing story. TeX gave me the ability to typeset documents without desktop publishing software that I couldn’t afford at the time.</p>
<p>While TeX is powerful, I found that I had to do quite a bit of fiddling to bend it to my will. Then, I discovered <a href="https://plaintextproject.online/articles/2018/12/19/latex.html" target="_blank">LaTeX</a>. LaTeX was a revelation, thanks to its tools (like pdflatex) and document classes that made using an attractive layout easier.</p>
<p>While I’ve been using LaTeX on and off since then, I don’t consider myself an expert or even highly proficient. I know enough to do what I need to do, and maybe a little more.</p>
<p>Here’s a quick look at how I use LaTeX.</p>
<h2 id="a-narrow-focus">A Narrow Focus</h2>
<p>Mainly, I use LaTeX to typeset:</p>
<ul>
<li><a href="https://scottnesbitt.net/ebooks.html" target="_blank">Books</a></li>
<li>My CV</li>
<li>The occasional report or letter</li>
</ul>
<p>There are a few other types of documents that I write and typeset using LaTeX, but I don’t work on them all that often. No matter what I’m working on, though, I use one template or another.</p>
<h2 id="templates-templates">Templates, Templates</h2>
<p>My templates include all the settings — like which document class to use, metadata for PDF files (where applicable), and page layout — for what I’m working on. I create a file and start typing. Where needed, I add LaTeX markup. In case you’re wondering, I take advantage of <a href="../../../2020/10/06/gedit.html" target="_blank">Gedit’s</a> LaTeX plugin to make that easier and faster.</p>
<p>If you’re wondering what one of those templates looks like, here’s a peek at one of the book templates that I use:</p>
<p><img src="../../../../images/latex2/latex-book-template.png" alt="An example of a LaTeX book template" /></p>
<h2 id="what-about-converting-from-markdown">What About Converting from Markdown?</h2>
<p>If what I’m writing will be in a format like PDF, then I stick to working solely in LaTeX. But if I’m publishing something, like an <a href="https://scottnesbitt.net/ebooks.html" target="_blank">ebook I’m selling</a>, then I’ll format the chapters with Markdown and convert the book to EPUB and LaTeX using Pandoc. From there, I’ll create the PDF from the LaTeX file.</p>
<p>For the conversion from Markdown, I have a separate template. That template contains all the setting I need, along with a bunch of Pandoc-specific directives that I don’t fully understand. That said, once I have the LaTeX file, I run the pdflatex command to create a nicely-typeset PDF file.</p>
<h2 id="final-thoughts">Final Thoughts</h2>
<p>A couple of three people have told me that the way in which I use LaTeX is a bit of a waste. That I’m not using LaTeX and its tools to their full potential.</p>
<p>So what?</p>
<p>While I can start with Markdown and go to LaTeX, there are times when I enjoy using LaTeX straight, no chaser. For me, it’s a bit of a challenge but one that keeps me sharp.</p>
   ]]></content:encoded>
</item>
   
   </channel>
</rss>
