Boris Mann

Open Source. Community. Decentralized Web. Building dev tools at Fission. Cooks & eats.

Home

Colophon

  • Last Edit: December 19, 2020

Historically, a Colophon was “a statement at the end of a book, typically with a printer’s emblem, giving information about its authorship and printing” (via Google Dictionary).

So, I keep notes on what software and other tools I use, in part as notes to myself.

My Blog ColophonBlog Colophon
It’s archives all the way down! This is archive version of how I’ve run my blog over the years. The [[Colophon]] page covers “this” site, which is sort of a superset archive. The plan is I’ll keep it active from now on in this Digital Notes Garden format.
July 2020 - current
The long(er) form content from the (original) blog.bmannconsulting.com has all been imported here.
I swapped that blog domain to [[Micro.blog]], and that’s where I post photos and short content, and sort of more non tech ...
documents software & changes all the way to 2001.

This site was last built: January 10, 2021

Current

Simply JekyllSimply Jekyll
Highly customized JekyllJekyll
Set env variable PAGES_REPO_NWO to build on [[Netlify]]
Set the environment variable PAGES_REPO_NWO to a repo such as spadebuilders/EIPs if you want to have Jekyll sites build on Netlify.
Posts by Year
{% raw %}
{% for post in site.posts %}
{% capture current_year %}{{ post.date | date: "%Y" }}{% endcapture %}
{% if current_year != previous_year %}
{% unless forloop.first %}
</ul>
{% endunless %}
<h2>{{ current_year }}</h2>
<ul>
...
template that supports both posts and custom notes, with everything able to be linked together with [[backlinks]] and other features.
Found via @bopuc on Ton’s post.

By Raghuveer S, [[@raghuveerdotnet on Github::https://github.com/raghuveerdotnet]].
Preview / example https://simply-jekyll.netlify.app/, available on Github https://github.com/raghuveerdotnet/simply-jekyll.
Tutorial [[How to setup Simply Jekyll]], which is basically clone the repo, connect to [[Netl...
theme for Jekyll. If you want to run it yourself, I’ve got some public work around this with the Simply Jekyll TemplateSimply Jekyll Template
Right now, it’s just my fork of the [[Simply Jekyll]] theme [[bmann/simply-jekyll::https://github.com/bmann/simply-jekyll/]].
I’ve done an initial setup of [[Forestry]] with it, and have it building to [[Netlify]]. My plan is to turn it into a Github template repository[[Github’s docs on template repos isn’t great. It’s to make a copy without forking that is ready to go right away.::rsn]], to make it very simple for people to run.
The theme itself is a bit too complicated and custom, so consi...
.

Using VSCode on my desktop to edit.

Hosting on FissionFission
Fission is the company I founded in June [[2019]] with [[Brooklyn Zelenka]].

https://fission.codes
twitter @fissioncodes
[[Discord]] chat https://fission.codes/discord
[[Discourse]] forum https://talk.fission.codes

. Cloudflare is powering the DNS and using Cloudflare IPFS GatewayCloudflare IPFS Gateway
Cloudflare has a Distributed Web Gateway page that covers both IPFSIPFS
InterPlanetary File System
website: https://ipfs.io
Originally created by [[Juan Benet]] who founded [[Protocol Labs]].
and [[Ethereum]].
Here is the extreme TLDR of using their IPFS gateway (if you already have your DNS hosted with Cloudflare):

Create a CNAME for your website that points to cloudflare-ipfs.com – in my case for my root domain, bmannconsulting.com
Create a TXT record at _dnslink.bmannconsulting.com
Enter in dnslink=/ipns/APPNAME.fission.app – from the FissionFission
Fission is the company I founded in June [[2019]] with [[Brooklyn Zelenka]].

https://fission.codes
twitter @fissioncodes
[[Discord]] chat https://fission.codes/discord
[[Discourse]] forum https://talk.fission.codes

Guide on controlling your own DNS

Unfortunately, Cloudf...
.

WIPWIP
Work-in-Progress

  • Add modified and date to notes as they are created / edited manually – the modified plugin doesn’t really seem to work at all
  • Rewrite the notes and link FeedsFeeds
    Don’t know what a feed is? Learn more on the About Feeds site.[[Or dive into more thoughts on Web Feeds.::rmn]]
    RSS Feeds
    [[There is no feed for the Archive other than newer blog posts. I don’t intend to create a feed for my Journal, you can come by and visit the site if you really want a peek.::lmn]]
    Recently Updated Notes
    Notes are the main wiki pages that I create here. This feed is sorted by last modified date, so items you’ve seen before will show up again when I re-edit them with more ...
    to use those values
  • the Links page will be articles – which have a published date – and Bookmark-style links, which have the date and/or modified. Will do a combined Links feed which uses date and modified – published can go inline

To Do

  • Look at side / margin notes and just use footnotes everywhere, possibly using BigfootJSBigfootJS
    A jQuery plugin for empowering footnotes.

    Bigfoot is a jQuery plugin that creates exceptional footnotes. Simply include the code on your pages and footnotes will be detected automatically and improved in the following ways:


    Links to footnotes will be replaced with clickable/ tappable buttons, making them substantially easier to hit.


    Footnote content will appear in a popover directly beside the footnote button when it is clicked/ tapped, which cuts out the annoying bouncing around the pag...
  • Sort /notes by modified
  • Add a third link type, for notes that contain github

Archive

bmannconsulting garden & gazebo (Sept 2020)

Well, WikiJS didn’t last long. The public site is back to running JekyllJekyll
Set env variable PAGES_REPO_NWO to build on [[Netlify]]
Set the environment variable PAGES_REPO_NWO to a repo such as spadebuilders/EIPs if you want to have Jekyll sites build on Netlify.
Posts by Year
{% raw %}
{% for post in site.posts %}
{% capture current_year %}{{ post.date | date: "%Y" }}{% endcapture %}
{% if current_year != previous_year %}
{% unless forloop.first %}
</ul>
{% endunless %}
<h2>{{ current_year }}</h2>
<ul>
...
, starting from the Digital Garden Jekyll TemplateDigital Garden Jekyll Template
This site started with this JekyllJekyll
Set env variable PAGES_REPO_NWO to build on [[Netlify]]
Set the environment variable PAGES_REPO_NWO to a repo such as spadebuilders/EIPs if you want to have Jekyll sites build on Netlify.
Posts by Year
{% raw %}
{% for post in site.posts %}
{% capture current_year %}{{ post.date | date: "%Y" }}{% endcapture %}
{% if current_year != previous_year %}
{% unless forloop.first %}
</ul>
{% endunless %}
<h2>{{ current_year }}</h2>
<ul>
...
template, created by [[Maxime Vaillancourt]]. The [[Colophon]] has more details about how it has evolved.
Below, the contents of the original “Your first seed” note, which I deleted along with cats and consistency:

Welcome!
This is your first note. You’ll find it in the notes/ directory.
Link syntax
To link to another note, you can use regular Markdown syntax for links, with a relative link to the other note, like this: this is a link to a note about ca...
and its custom BacklinksBacklinks
Are backlinks a feature or a product?
plugin.

The public site is the “garden”, which is in a public folder inside the “gazebo”, where I can keep private notes. Stored in a private Github repo.

Since I have my DNS on Cloudflare, ended up using the Cloudflare IPFS GatewayCloudflare IPFS Gateway
Cloudflare has a Distributed Web Gateway page that covers both IPFSIPFS
InterPlanetary File System
website: https://ipfs.io
Originally created by [[Juan Benet]] who founded [[Protocol Labs]].
and [[Ethereum]].
Here is the extreme TLDR of using their IPFS gateway (if you already have your DNS hosted with Cloudflare):

Create a CNAME for your website that points to cloudflare-ipfs.com – in my case for my root domain, bmannconsulting.com
Create a TXT record at _dnslink.bmannconsulting.com
Enter in dnslink=/ipns/APPNAME.fission.app – from the FissionFission
Fission is the company I founded in June [[2019]] with [[Brooklyn Zelenka]].

https://fission.codes
twitter @fissioncodes
[[Discord]] chat https://fission.codes/discord
[[Discourse]] forum https://talk.fission.codes

Guide on controlling your own DNS

Unfortunately, Cloudf...
to link my site up to where it is hosted on the FissionFission
Fission is the company I founded in June [[2019]] with [[Brooklyn Zelenka]].

https://fission.codes
twitter @fissioncodes
[[Discord]] chat https://fission.codes/discord
[[Discourse]] forum https://talk.fission.codes

platform. Which means the whole thing is on IPFSIPFS
InterPlanetary File System
website: https://ipfs.io
Originally created by [[Juan Benet]] who founded [[Protocol Labs]].
. You can browse the archive 2020 folder to see the bare IPFS directories underneath.

I build the site locally and then publish to Fission.

The Garden and the GazeboGarden and the Gazebo
My current setup for this site I’m calling the Garden and the Gazebo.1
The Garden is what you’re looking at and browsing: inter-linked notes, the portion of my [[Second Brain]] that I keep public.
The Gazebo is where I keep my private notes. A day-to-day [[Worklog]], TODOs, notes from meetings, and various notes to self.
Garden
I haven’t used my root bmannconsulting domain for things for a while. The ArchiveArchive
has 12 years of lightly pruned blog posts. I ran a separate wiki for a while, mos...
has a write up about the setup and the thinking behind what, why, and how.

bmann wiki, bmannconsulting.com WikiJS (May 2020)

As of May 2020:

  • Did some research on Markdown-based flat file / git wikis, thinking about integrating with my blog
  • After looking at the options, keeping the wiki separate and keeping it as WikiJS still makes sense; this was originaly wiki.bmann.ca (which now redirects here) and the bulk of it was food / travel stuff aka Duck Ramen WikiDuck Ramen Wiki
    Some of this content is from what I called the Duck Ramen Wiki, because I set it up right around the time we went on a trip to Victoria and I made duck ramen).
    I put food, travel, and related type stuff on the [[AllTheBestRecipes]] site now.
  • Imported the JekyllJekyll
    Set env variable PAGES_REPO_NWO to build on [[Netlify]]
    Set the environment variable PAGES_REPO_NWO to a repo such as spadebuilders/EIPs if you want to have Jekyll sites build on Netlify.
    Posts by Year
    {% raw %}
    {% for post in site.posts %}
    {% capture current_year %}{{ post.date | date: "%Y" }}{% endcapture %}
    {% if current_year != previous_year %}
    {% unless forloop.first %}
    </ul>
    {% endunless %}
    <h2>{{ current_year }}</h2>
    <ul>
    ...
    -based blog that was at bmannconsulting.com into the ArchiveArchive
    including bringing in some trimmed and posterous-era stuff back online

Still a WIP, and will write up a blog post once things have settled

wiki.bmann.ca WikiJS (Aug 2018)

As of August 6th, 2018:

  • Running on WikiJSWikiJS
    [[Wiki]] software built on [[NodeJS]]. Has great [[DeployToHeroku]] support

    Home page https://wiki.js.org/
    OpenCollective Donations https://opencollective.com/wikijs
    Github https://github.com/Requarks/wiki
    Deploy via Heroku https://github.com/Requarks/wiki-heroku

    An open source, modern and powerful wiki app built on Node.js, Git and Markdown. Can be maintained through a git repo (public or private, Github, Gitlab, etc) with standard git commits, as well as allowing edits through the front e...
  • Hosted on HerokuHeroku
    Heroku CLI https://devcenter.heroku.com/articles/heroku-cli
    Heroku Teams https://devcenter.heroku.com/articles/heroku-teams – it used to be awkward to “share” deployments, or have a fake company user that owned it; teams are free for up to 5 members, then $10 per month for more. Also no free dynos for teams.
    I have been using Heroku for many many years. Heroku was [[serverless]] (and containers) before either term existed. I have helped get a variety of open source software running on Heroku ...
    , initially installed using the Heroku deployment
  • Git is stored in a private Gitlab repo

wiki.bmann.ca Tiddlywiki (Nov 2016)

  • TiddlyWiki, on or around 5.1.13.
  • Running on Google AppEngine using Russ Cox’s tiddly Go server at wiki.bmann.ca
  • The Favicon is a bowl of Duck Ramen made in Victoria during a Nov 2016 visit: Duck Ramen WikiDuck Ramen Wiki
    Some of this content is from what I called the Duck Ramen Wiki, because I set it up right around the time we went on a trip to Victoria and I made duck ramen).
    I put food, travel, and related type stuff on the [[AllTheBestRecipes]] site now.