a

- Remove credit.html partial
- Reorganize summary template files
- Fix margin around post-title
- Remove series position indicator
- :3

.github/workflows/audit.yml

@@ -2,40 +2,88 @@ name: Audit
 
 on:
   push:
+  pull_request:
 
 jobs:
   lighthouse:
     runs-on: ubuntu-latest
     steps:
-      - name: Checkount
-        uses: actions/checkout@v2
-        with:
-          submodules: recursive
-          fetch-depth: 0
-          ref: ${{github.event.pull_request.head.ref}}
-          repository: ${{github.event.pull_request.head.repo.full_name}}
-
-      - name: Install Caddy
-        run: |
-          curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo tee /etc/apt/trusted.gpg.d/caddy-stable.asc
-          curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
-          sudo apt update
-          sudo apt install caddy
-          sudo systemctl disable --now caddy
-
       - name: Setup Hugo
         uses: peaceiris/actions-hugo@v2
         with:
           hugo-version: latest
           extended: true
 
-      - name: Build
-        run: hugo --printI18nWarnings --printPathWarnings --baseURL https://localhost
+      - name: Checkout (pull_request)
+        if: github.event.pull_request
+        uses: actions/checkout@v3
+        with:
+          submodules: recursive
+          fetch-depth: 0
+          ref: ${{ github.event.pull_request.base.ref }}
+
+      - name: Checkout (push)
+        if: github.event_name == 'push'
+        uses: actions/checkout@v3
+        with:
+          submodules: recursive
+          fetch-depth: 0
+          ref: ${{ github.event.before }}
+
+      - name: Build previous commit
+        run: |
+          hugo --buildDrafts --printI18nWarnings --printPathWarnings --baseURL https://localhost -d old/
+
+      - name: Checkout current commit
+        uses: actions/checkout@v3
+        with:
+          submodules: recursive
+          fetch-depth: 0
+          clean: false
+
+      - name: Build current commit
+        run: |
+          hugo --buildDrafts --printI18nWarnings --printPathWarnings --baseURL https://localhost
+          cp -r public/ new/
+          # copy, so that public/ stays, it will be needed for Caddy to serve
+
+      - name: Save full diff
+        run: diff -r old/ new/ | tee changes.diff || true
+
+      - name: Upload full diff
+        uses: actions/upload-artifact@v3
+        with:
+          name: diff
+          path: changes.diff
+
+      - name: Find changed URLs
+        id: changed_urls
+        env:
+          SCHEME: https
+          DOMAIN: localhost
+        run: |
+          urls="$(./changed-urls.sh)"
+          echo "urls<<EOM" >> $GITHUB_OUTPUT
+          echo "$urls" >> $GITHUB_OUTPUT
+          echo "EOM" >> $GITHUB_OUTPUT
+          echo -e "CHANGED:\n$urls"
+
+      - name: Install Caddy
+        if: "${{ steps.changed_urls.outputs.urls != '' }}"
+        run: |
+          sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
+          curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
+          curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
+          sudo apt update
+          sudo apt install caddy
+          sudo systemctl disable --now caddy
 
       - name: Compress
+        if: "${{ steps.changed_urls.outputs.urls != '' }}"
         run: time ./compress.sh
 
       - name: Audit using Lighthouse
+        if: "${{ steps.changed_urls.outputs.urls != '' }}"
         uses: treosh/lighthouse-ci-action@v9
         with:
           uploadArtifacts: true
@@ -43,14 +91,15 @@ jobs:
           runs: 3
           serverBaseUrl: https://lhci.bbaovanc.com/
           # this should be safe since it only allows adding (not deleting) data
-          serverToken: 926a24f2-90e4-48b1-809f-055b9408cf4b
+          serverToken: 2fca0410-95ae-4ea9-8dc6-687ed7843a3a
+          urls: ${{ steps.changed_urls.outputs.urls }}
 
 
   audit:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v3
         with:
           submodules: recursive
           fetch-depth: 0
@@ -65,7 +114,7 @@ jobs:
 
       - name: Build
         run: |
-          HUGO_MINIFY_TDEWOLFF_HTML_KEEPCOMMENTS=true HUGO_ENABLEMISSINGTRANSLATIONPLACEHOLDERS=true hugo --printI18nWarnings --printPathWarnings
+          HUGO_MINIFY_TDEWOLFF_HTML_KEEPCOMMENTS=true HUGO_ENABLEMISSINGTRANSLATIONPLACEHOLDERS=true hugo --buildDrafts --printI18nWarnings --printPathWarnings
 
       # For the following steps, see
       # https://discourse.gohugo.io/t/audit-your-published-site-for-problems/35184

.github/workflows/deploy.yml

@@ -14,7 +14,7 @@ jobs:
       url: https://bbaovanc.com
     steps:
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v3
         with:
           submodules: recursive
           fetch-depth: 0

.github/workflows/pull_request.yml

@@ -12,7 +12,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v3
         with:
           submodules: recursive
           fetch-depth: 0
@@ -36,7 +36,7 @@ jobs:
           extended: true
 
       - name: Build
-        run: hugo --printI18nWarnings --printPathWarnings --baseURL "https://demo.bbaovanc.com/pull_request/${{ github.event.number }}"
+        run: hugo --printI18nWarnings --printPathWarnings --baseURL "https://demo.bbaovanc.com/pull_request/${{ github.event.number }}" --buildDrafts
 
       - name: Compress
         run: |
@@ -91,5 +91,4 @@ jobs:
             A preview of this pull request is ready!
             See it at https://demo.bbaovanc.com/pull_request/${{ github.event.number }}/
             View the deploy log at https://github.com/BBaoVanC/bbaovanc.com/actions/runs/${{ github.run_id}}
-            Please note that currently the comment system is only operational on real deploys on bbaovanc.com. If you see an error, it's probably not your fault.
           edit-mode: replace

.github/workflows/pull_request_cleanup.yml

@@ -1,7 +1,7 @@
 name: Pull Request Cleanup
 
 on:
-  pull_request:
+  pull_request_target:
     types:
       - closed
 

CONTRIBUTING.md

@@ -2,9 +2,10 @@
 
 ## Where to put questions/issues/etc
 
-Please use the [proper section on
-bobaforum](https://forum.bbaovanc.com/t/my-website) for issues, questions, or
-discussions.
+Use the [GitHub Discussions forum][github-discussions-url] for any questions,
+or ideas. Use the "Q&A" section for both questions and issues as well.
+
+[github-discussions-url]: https://github.com/BBaoVanC/bbaovanc.com/discussions
 
 ## Building
 

README.md

@@ -4,5 +4,5 @@ My personal website, generated using [Hugo](https://gohugo.io)
 
 ## Discussions
 
-Use [bobaforum](https://forum.bbaovanc.com) for questions, ideas, discussions,
-etc. relating to me or my website.
+Use [GitHub Discussions](https://github.com/BBaoVanC/bbaovanc.com/discussions)
+for questions, ideas, discussions, etc. relating to me or my website.

assets/css/comments.css

@@ -0,0 +1,121 @@
+/* Isso styling */
+h4.isso-thread-heading {
+    color: var(--text-0);
+    margin-bottom: 8px;
+}
+
+.isso-comment:not(:first-of-type),
+.isso-follow-up .isso-comment {
+    border-color: var(--background-3);
+}
+
+.isso-author,
+.isso-page-author-suffix,
+.isso-comment-footer,
+.isso-comment-footer .isso-votes {
+    color: var(--text-gray-0);
+}
+
+.isso-comment-header .isso-spacer,
+.isso-spacer:hover,
+.isso-permalink,
+.isso-permalink:hover {
+    color: var(--text-gray-1) !important;
+}
+a.isso-author:hover,
+.isso-permalink:hover {
+    text-decoration: underline !important;
+}
+
+.isso-comment.isso-is-page-author > .isso-text-wrapper {
+    background-color: var(--background-accent-1);
+}
+
+.isso-feedlink:hover,
+.isso-reply {
+    color: var(--link-0) !important;
+    text-shadow: unset !important;
+}
+.isso-reply:hover {
+    text-decoration: underline;
+}
+
+.isso-text pre,
+.isso-text :not(pre) > code {
+    background-color: var(--background-2);
+    border: none;
+    padding: 2px 4px;
+    border-radius: 5px;
+    /* thanks isso.css for setting this to 85% for whatever reason */
+    font-size: 0.75em;
+}
+
+.isso-input-wrapper input,
+.isso-post-action > input,
+.isso-textarea,
+.isso-preview {
+    color: var(--text-1);
+    background-color: var(--background-1);
+    border-color: var(--background-2) !important;
+}
+
+.isso-input-wrapper input:focus,
+.isso-textarea:focus {
+    border-color: var(--background-3) !important;
+}
+
+.isso-post-action > input:hover {
+    background-color: var(--background-2);
+}
+.isso-post-action > input:focus,
+.isso-post-action > input:active {
+    background-color: var(--background-3);
+}
+
+.isso-textarea {
+    margin-bottom: 4px;
+}
+.isso-input-wrapper {
+    display: inline-flex;
+    flex-direction: column;
+    margin-right: 4px;
+    max-width: 25%;
+}
+.isso-input-wrapper input {
+    order: 1;
+}
+.isso-input-wrapper label {
+    order: 2;
+    font-size: small;
+}
+.isso-post-action {
+    margin-left: 4px;
+    margin-top: 0;
+}
+@media screen and (max-width: 600px) {
+    .isso-input-wrapper {
+        display: block;
+        max-width: 100%;
+    }
+}
+
+@media print {
+    .comments {
+        break-before: always;
+    }
+    .isso-comment {
+        max-width: unset;
+    }
+    .isso-text-wrapper {
+        break-inside: avoid;
+    }
+
+    .isso-postbox,
+    .isso-feedlink {
+        display: none;
+    }
+}
+
+.isso-target {
+    animation: target-fade 10s ease-out; /* defined in bobatheme */
+}

changed-urls.sh

@@ -0,0 +1,8 @@
+#!/bin/sh
+
+diff -qrNtbB old/ new/ |
+    grep -oP '(?<=\s)new\/\S*' |
+    xargs -d '\n' ls -1d 2>/dev/null |
+    grep 'index.html$' |
+    sed 's/index.html$//' |
+    sed "s/^new/${SCHEME:=http}:\/\/${DOMAIN:=example.com}/"

config.yaml

@@ -1,7 +1,7 @@
 baseURL: https://bbaovanc.com
 theme: bobatheme
 defaultContentLanguage: en
-copyright: '&copy; 2021 bbaovanc <a rel="license" href="https://creativecommons.org/licenses/by/4.0/">CC BY 4.0</a>'
+copyright: '&copy; 2021-2023 bbaovanc <a rel="license" href="https://creativecommons.org/licenses/by/4.0/">CC BY 4.0</a>'
 sectionPagesMenu: main
 enableRobotsTXT: true
 paginate: 10
@@ -21,6 +21,8 @@ related:
   indices:
     #- name: keywords
     #  weight: 100
+    - name: categories
+      weight: 80
     - name: tags
       weight: 80
     - name: date
@@ -42,6 +44,7 @@ params:
   # used for "View source" (unset by default)
   gitFileURL: https://github.com/BBaoVanC/bbaovanc.com/blob/master
   gitFileIcon: code
+  gitHistoryURL: https://github.com/BBaoVanC/bbaovanc.com/commits/master
 
   # display a "Latest Posts" section on the homepage below its content
   homepageLatestPosts: true
@@ -53,9 +56,10 @@ params:
     linkedin: true
     reddit: true
     telegram: true
+    print: true
 
   # show "Latest Posts" section at bottom of content pages
-  latestPostsOnContent: true
+  # latestPostsOnContent: true
 
 
   footer: >-
@@ -75,10 +79,6 @@ languages:
     weight: 1
     menu:
       main:
-        - identifier: forum
-          name: Forum
-          url: https://forum.bbaovanc.com
-
         - identifier: status-page
           name: Status Page
           url: https://status.bbaovanc.com

content/authors/_index.md

@@ -0,0 +1,8 @@
+---
+
+title: Authors
+
+description: >-
+  List of authors on my website.
+
+---

content/authors/github-copilot/_index.md

@@ -1,6 +1,6 @@
 ---
 
-title: Github Copilot
+title: GitHub Copilot
 
 ---
 

content/blog/allow-non-root-processes-to-bind-to-privileged-ports/index.md

@@ -12,10 +12,14 @@ authors:
 aliases:
   - posts/allow-non-root-processes-to-bind-to-privileged-ports/
 
-tags:
-  - guide
+categories:
+  - guides
   - linux
 
+tags:
+  - gitea
+  - systemd
+
 ---
 
 In Linux, processes cannot bind to privileged ports (<=1024) unless they are

content/blog/auditing-with-google-lighthouse-and-github-actions/index.md

@@ -0,0 +1,144 @@
+---
+
+title: Using GitHub Actions to audit my website with Google Chrome Lighthouse
+date: 2022-05-07T00:54:11-05:00
+lastmod: 2022-05-08T16:16:02-05:00
+toc: true
+comments: true
+
+authors:
+  - bbaovanc
+
+categories:
+  - devops
+  - meta
+
+tags:
+  - caddy
+  - github-actions
+  - google-lighthouse
+
+# this will be shown for the article in list pages and in the page metadata
+# it can be either an image or video (this might change in the future, however)
+resources:
+  - name: feature
+    src: dashboard-performance-graph.webp
+    title: Picture of the `Performance` section on the Lighthouse CI dashboard
+
+  - name: youtube-embed-performance-comparison
+    src: youtube-embed-performance-comparison.webp
+    title: >-
+      Performance hit caused by adding a YouTube embed. You can see the
+      comparison itself [on this comparison
+      page](https://lhci.bbaovanc.com/app/projects/bbaovanc.com/compare/01d2064b6fac?baseUrl=https%3A%2F%2Flocalhost%2Fblog%2Fthe-redesign-of-my-website%2F&compareUrl=https%3A%2F%2Flocalhost%2Fblog%2Fyoutube-url-structures-you-should-know%2F&baseBuild=01d2064b-6fac-40df-b4e6-373037ae1f9e).
+
+---
+
+The other day I set up automatic testing of my website using [Google Chrome
+Lighthouse][google-lighthouse]. I'm also running my own Lighthouse CI server to
+store test result history and show trends. Here's an outline of what this means,
+some of the results I've obtained so far, and my thoughts on the usefulness of
+Lighthouse.
+
+[google-lighthouse]: https://developers.google.com/web/tools/lighthouse
+
+<!--more-->
+
+## What is Lighthouse?
+
+Lighthouse is a tool developed by Google which audits websites and gives them a
+score in four categories: *Performance*, *Accessibility*, *Best Practices*, and
+*SEO (search engine optimization)*. It's also built into the developer console
+in Chrome, so you can run it manually on any website you want directly inside
+your browser.
+
+I have already been using Lighthouse manually to do occasional tests on my
+website and its theme, [bobatheme][bobatheme]. However, I recently came across
+[this GitHub Action][lhci-action]. It caught my eye because I was [already using
+GitHub Actions][old-audit-workflow] to perform a few basic Hugo[^hugo]-related
+audits found [in a thread on the Hugo forum][hugo-audits-thread].
+
+[^hugo]: [Hugo](https://gohugo.io) is the framework that my website is built on. It's
+  a static site generator which generates my site according to my own custom
+  templates that make up my theme.
+
+[bobatheme]: https://github.com/BBaoVanC/bobatheme
+[lhci-action]: https://github.com/marketplace/actions/lighthouse-ci-action
+[old-audit-workflow]: https://github.com/BBaoVanC/bbaovanc.com/blob/31e25c2578a789afe71ce90352747eb427ca3c0e/.github/workflows/audit.yml#L31-L59
+[hugo-audits-thread]: https://discourse.gohugo.io/t/audit-your-published-site-for-problems/35184
+
+## Setting it all up
+
+My goal is to run Lighthouse's audits on an environment as similar to my real
+website's deployment as possible.
+
+First, I [created a separate `lighthouse` job on my audit
+workflow][lighthouse-actions-job] on GitHub Actions. This job will do all of the
+testing. Since it's a separate job, it runs in parallel with my existing audit
+task.
+
+[lighthouse-actions-job]: https://github.com/BBaoVanC/bbaovanc.com/blob/3668b6cfb11d09149b5da347219cdc75d0ce0985/.github/workflows/audit.yml#L7
+
+Next, I copied [my existing build steps verbatim][production-build-steps]. This
+makes the site effectively identical to my real deployment on bbaovanc.com. One
+of the crucial steps is to pre-compress all the files so their compressed
+versions can be served without the server having to compress them on-the-fly,
+saving valuable processing power.
+
+[production-build-steps]: https://github.com/BBaoVanC/bbaovanc.com/blob/db65e9fc23b840429f5c9ad2b43d7dd01a024f36/.github/workflows/deploy.yml#L22-L33
+
+Serving the compressed files is crucial because it simulates the real world
+transfer size of the files. In addition, Lighthouse will recommend that you
+serve the files compressed.
+
+Inside the audit environment I use the same webserver (Caddy) and a [similar
+configuration][audit-caddy-config] (compared to the [one running on
+bbaovanc.com][production-caddy-config]) to what I have running on bbaovanc.com.
+Caddy also is able to easily run the demo site with HTTPS, even on localhost.
+That allows it to test certain elements (such as the comment section) that
+wouldn't be allowed to load if it were plain, unsecured HTTP.
+
+[audit-caddy-config]: https://github.com/BBaoVanC/bbaovanc.com/blob/3668b6cfb11d09149b5da347219cdc75d0ce0985/Caddyfile
+[production-caddy-config]: https://git.bbaovanc.com/configs/caddy/src/commit/e3227eb2a2679e27545c2417c2565941f03fb744/conf.d/bbaovanc.com
+
+{{< see-also "/blog/caddy-is-the-best-webserver" >}}
+
+I selected [a few significant pages on my website][lighthouse-urls] so
+Lighthouse can test a wide range of the features in my website's theme. The
+results of these tests are then uploaded to [my Lighthouse CI
+server][lhci-dashboard]. There you can view the audit history and see
+differences in results between builds.
+
+[lighthouse-urls]: https://github.com/BBaoVanC/bbaovanc.com/blob/3668b6cfb11d09149b5da347219cdc75d0ce0985/lighthouserc.yaml#L4-L19
+[lhci-dashboard]: https://lhci.bbaovanc.com/app/projects/bbaovanc.com/dashboard
+
+## What I found from the tests
+
+### Performance impact of a YouTube video
+
+I found that embedding a YouTube video using the built-in shortcode in Hugo
+made the website drastically slower. It's a lot clearer in the audit environment
+where everything is throttled down a bunch, so the performance impact is more
+clear. Below is a screenshot of the difference in score between my blog post
+with a YouTube embed and a similarly sized blog post which has no video.
+
+{{< figure src="youtube-embed-performance-comparison" >}}
+
+I can probably optimize this a little by making a copy of the built-in Hugo
+YouTube shortcode, and modifying it to defer the loading of the remote scripts.
+That will have to be a future project, and I'll probably write a post if I ever
+end up testing it.
+
+## My thoughts on Lighthouse
+
+You can make the argument that the results from Lighthouse don't really mean
+much in the real world. On modern devices and a decent internet speed most
+websites will load just fine.
+
+Although most pages on my site have a perfect score from Lighthouse, I'm not
+going to go way out of my way in order to keep it that way. After all,
+Lighthouse is just a tool intended for "improving the quality of web
+pages."[^improve-quality-quote] That doesn't mean it needs to be perfect.
+
+[^improve-quality-quote]: Source: [Google
+  Developers](https://developers.google.com/web/tools/lighthouse)

content/blog/blog-post-newsletter/index.md

@@ -2,15 +2,19 @@
 
 title: Newsletter for my blog posts
 date: 2022-04-30T01:00:14-05:00
-lastmod: 2022-04-30T01:00:14-05:00
+lastmod: 2022-05-23T02:17:47-05:00
 toc: true
 comments: true
 
 authors:
   - bbaovanc
 
-tags:
+categories:
   - meta
+
+tags:
+  - bobanews
+  - listmonk
   - newsletter
 
 # this will be shown for the article in list pages and in the page metadata
@@ -33,6 +37,11 @@ notifications when I post new ones, so I have more than just an RSS feed.
 
 <!--more-->
 
+{{< aside warning >}}
+I decided that I didn't really want to deal with the extra work of managing a
+newsletter so I've removed it. (I didn't actually get any sign-ups).
+{{< /aside >}}
+
 **See the ["Signing Up" section]({{< ref "#signing-up" >}}) for instructions on
 how to sign up for the newsletter.**
 
@@ -69,6 +78,11 @@ website uses. Here's a screenshot of how it currently looks:
 
 ## Signing up
 
+{{< aside warning >}}
+I decided that I didn't really want to deal with the extra work of managing a
+newsletter so I've removed it. (I didn't actually get any sign-ups anyways.)
+{{< /aside >}}
+
 You can sign up to get emails about new posts on the [newsletter signup form
 here](https://lists.bbaovanc.com/subscription/form). Make sure the box next to
 the list labeled `bbaovanc.com Blog Posts` is checked. You'll need to provide an

content/blog/caddy-is-the-best-webserver/index.md

@@ -2,17 +2,21 @@
 
 title: Caddy is literally the best webserver
 date: 2021-11-13T00:43:35-06:00
-lastmod: 2022-05-02T00:54:43-05:00
+lastmod: 2023-01-16T20:57:00-06:00
 toc: true
 comments: true
 
 authors:
   - bbaovanc
 
-tags:
+categories:
   - linux
-  - webserver
+  - sysadmin
+  - software
+
+tags:
   - caddy
+  - webserver
 
 resources:
   - name: feature
@@ -91,9 +95,9 @@ configs.
 ### PHP (PrivateBin)
 
 The Caddy config for this example is the same as the [one used for
-bin.boba.best](https://git.boba.best/configs/caddy/src/commit/cd00151fbdd784979a8a181980cc36061be68c7d/conf.d/bin.boba.best).
+bin.boba.best](https://git.boba.best/boba.best/caddy/src/commit/cd00151fbdd784979a8a181980cc36061be68c7d/conf.d/bin.boba.best).
 I've stripped it down a bit by removing the [custom error
-pages](https://git.boba.best/configs/caddy/src/commit/cd00151fbdd784979a8a181980cc36061be68c7d/Caddyfile#L15-L24),
+pages](https://git.boba.best/boba.best/caddy/src/commit/cd00151fbdd784979a8a181980cc36061be68c7d/Caddyfile#L15-L24),
 [HSTS](https://en.wikipedia.org/wiki/HTTP_Strict_Transport_Security), [zstd
 compression](https://github.com/facebook/zstd), and logging.
 
@@ -133,7 +137,7 @@ server {
 ### Reverse proxy + static files (Gitea)
 
 This last example is based on
-[git.bbaovanc.com](https://git.bbaovanc.com/configs/caddy/src/commit/57c9f0011eae92ef5fa2992d99f01b0956802d64/conf.d/git.bbaovanc.com).
+[git.bbaovanc.com](https://git.bbaovanc.com/boba.best/caddy/src/commit/57c9f0011eae92ef5fa2992d99f01b0956802d64/conf.d/git.bbaovanc.com).
 Just like the last example, I've stripped off the custom error pages, HSTS, zstd
 compression, and logging.
 
@@ -200,7 +204,7 @@ entirely using Caddy's and Go templates![^caddy-templating]
 #### Error pages using HTTP Cats
 
 I use [this
-snippet](https://git.bbaovanc.com/configs/caddy/src/commit/57c9f0011eae92ef5fa2992d99f01b0956802d64/Caddyfile#L8-L15)
+snippet](https://git.bbaovanc.com/boba.best/caddy/src/commit/57c9f0011eae92ef5fa2992d99f01b0956802d64/Caddyfile#L8-L15)
 on both bbaovanc.com and boba.best to make custom error pages using images from
 [HTTP Cats](https://http.cat). It uses Caddy's template support to generate some
 simple HTML to show the error code, name, and cat image.

content/blog/checkra1n-gui-on-other-distros/index.md

@@ -12,11 +12,13 @@ authors:
 aliases:
   - posts/checkra1n-gui-on-other-distros/
 
-tags:
-  - guide
-  - linux
-  - archlinux
+categories:
+  - guides
   - jailbreak
+  - linux
+
+tags:
+  - arch-linux
   - checkra1n
 
 resources:

content/blog/copilot-post/index.md

@@ -2,14 +2,15 @@
 
 # this is the title it generated. not even joking
 title: Copilot
-date: 2021-11-07T16:17:15-06:00
-lastmod: 2021-11-07T16:17:15-06:00
+date: 2021-11-07T16:20:15-06:00
+lastmod: 2021-11-07T16:20:15-06:00
 toc: true
 comments: true
 
 authors:
   - GitHub Copilot
-  - bbaovanc
+
+categories:
 
 tags:
   - github-copilot
@@ -17,6 +18,9 @@ tags:
 series:
   - github-copilot-experiments
 
+_build:
+  list: never
+
 ---
 
 Did you know that Copilot is a command line interface for Copilot? It's a tool

content/blog/discord-sex-hack/index.md

@@ -0,0 +1,295 @@
+---
+
+title: How the "Discord sex" (`s/e/x`) hack works
+date: 2022-05-11T21:11:17-05:00
+lastmod: 2022-09-24T14:56:05-05:00
+toc: true
+comments: true
+
+authors:
+  - bbaovanc
+
+categories:
+  - tips-and-tricks
+
+tags:
+  - discord
+  - discord-tricks
+  - sed
+
+_build:
+  # won't appear on main Home page, but will in Blog
+  list: local
+
+# this will be shown for the article in list pages and in the page metadata
+# it can be either an image or video (this might change in the future, however)
+resources:
+  - name: feature
+    src: example.webp
+    title: Result after sending a GIF and then sending `s/e/x`.
+
+  - name: default-sex
+    src: default-sex.webp
+    title: Fallback image on `txnor.com`
+
+  - name: double-sex
+    src: double-sex.webp
+    title: Resulting image after typing `s/e/x` a second time.
+
+  - name: chess
+    src: chess.webp
+    title: This happens once you type `s/w/ag` after having done `s/e/x`.
+
+  - name: sword
+    src: sword.webp
+    title: This happens when you type `s/w/ord` after having done `s/e/x`.
+  - name: sword-atk
+    src: sword-atk.webp
+    title: This happens when you type `s/d/dATK`
+  - name: sword-def
+    src: sword-def.webp
+    title: This happens when you type `s/d/dDEF`
+  - name: sword-hug
+    src: sword-hug.webp
+    title: This happens when you type `s/d/dHUG`
+  - name: sword-win
+    src: sword-win.webp
+    title: Win screen on the `s/w/ord` game.
+  - name: sword-lose
+    src: sword-lose.webp
+    title: Lose screen on the `s/w/ord` game.
+
+  - name: 6969th
+    src: 6969th.webp
+    title: This happens on average (since it's randomized) every 6070th use.
+
+  - name: math-challenge
+    src: math-challenge.webp
+    title: Math challenge example
+
+---
+
+There's this trick going around on Discord recently where if you send any GIF
+from Tenor, and then type `s/e/x`, then it turns it into a different meme GIF.
+Here's how it works.
+
+<!--more-->
+
+{{< aside info >}}
+Credit goes to Rebane2001 (not me) for making this trick, and setting it up on
+`txnor.com`.
+{{< /aside >}}
+
+## The `sed` syntax
+
+For operating systems based on Unix or Linux, there's usually a simple terminal
+command included called [`sed`][sed-wikipedia], which is most commonly used to
+run text replacement commands. Here's a very simple example of what a basic
+`sed` command looks like:
+
+[sed-wikipedia]: https://en.wikipedia.org/wiki/Sed
+
+```bashsession
+$ sed 's/hello/goodbye/'
+```
+
+Discord likely implemented this in order to appeal to
+[IRC][irc-wikipedia][^irc-definition] users. Since IRC doesn't support editing
+messages, it's common for people to send messages in that format to tell people
+about changes to their previous message. Discord implemented this into both
+their web/desktop client and their iOS app, excluding the Android app.
+
+[irc-wikipedia]: https://en.wikipedia.org/wiki/Internet_Relay_Chat
+
+[^irc-definition]: IRC (Internet Relay Chat) is a simple text-based chat system.
+  It's a very old protocol, however its simplicity and minimalism is the main
+  reason people choose it. It's not very popular anymore.
+
+Note that while real `sed` commands can get much more complicated, Discord's
+implementation doesn't support those advanced features[^trailing-slash-note].
+
+[^trailing-slash-note]: Also note that in Discord's implementation, the trailing
+  slash (after `goodbye`) can be ommitted (making it just `s/hello/goodbye`),
+  but with the real `sed` command, it's required.
+
+{{< see-also "/blog/text-substitution-in-discord-using-sed" >}}
+
+## What does `s/e/x` do?
+
+When you send a GIF using the GIF picker on Discord, it actually sends the link
+to the GIF, which is served by [Tenor][tenor-website]. For example, here's a GIF
+sent from Tenor:
+
+[tenor-website]: https://tenor.com
+
+https://tenor.com/view/cat-massage-gif-24282757
+
+Running `s/e/x` will take the first occurrence of `e` and replace it with `x`.
+The link becomes the following (notice the bolded letter `x`):
+
+[https://t**x**nor.com/view/cat-massage-gif-24282757][example-1]
+
+[example-1]: https://txnor.com/view/cat-massage-gif-24282757
+
+Then, all that's left to do is to buy the domain `txnor.com`, and write a simple
+program to run on it. In fact, it looks like that domain was purchased purely in
+order to make this trick possible[^txnor-domain-date].
+
+[^txnor-domain-date]: According to [a quick WHOIS lookup][txnor-whois], the
+  domain was registered on May 3, 2022. That's the same day that [@Rebane
+  tweeted about the new feature][rebane-tweet] (~~going to https://txnor.com
+  redirects to this tweet~~ now the domain redirects to [Rebane's YouTube video
+  about the hack]({{< ref "#youtube-video" >}})), so I assume that this is the
+  only reason they bought the domain.
+
+[txnor-whois]: https://www.whois.com/whois/txnor.com
+[rebane-tweet]: https://twitter.com/rebane2001/status/1521544722875142145
+
+## How does it display on Discord without redirecting?
+
+When viewing any of the URLs on `txnor.com` in a normal web browser, you get
+[redirected to a tweet][rebane-tweet]. However, Discord is able to display the
+image without being redirected.
+
+When Discord loads a website to generate an embed, it uses a user
+agent[^user-agent-definition] (which is a little piece of text which tells the
+server what your browser is) which looks something like this:
+
+[^user-agent-definition]: If you actually care, there's a [Wikipedia
+  article](https://en.wikipedia.org/wiki/User_agent), and a [page on
+  WhatIsMyIPAddress.com](https://whatismyipaddress.com/user-agent) which also
+  explain what a user agent is.
+
+```text
+User-Agent: Mozilla/5.0 (compatible; Discordbot/2.0; +https://discordapp.com/)
+```
+
+The important part here is the word `Discord`. If you visit the website with
+your user agent set to anything containing `Discord`
+(case-insensitive)[^discord-user-agent], then it serves the image directly.
+
+[^discord-user-agent]: [According to the source code][user-agent-source-code],
+  it looks like `Intel Mac OS X 11.6; rv:92.0` also triggers the same response.
+
+[user-agent-source-code]: https://github.com/rebane2001/txnor-server/blob/26c7c279b0b4668c8a3b061692d83c507aeac7c5/txnor.nginx#L23-L27
+
+## Default image
+
+If you go to any URL on `txnor.com` that doesn't fit one of the existing
+patterns/games, then it returns this fallback image:
+
+{{< figure src="default-sex" >}}
+
+## Extra features
+
+### Double sex
+
+If you then run `s/e/x` a second time, then it changes to a different image:
+
+{{< figure src="double-sex" >}}
+
+This works in a simple way as well. The next `e` that appears in the URL is
+inside `/view/`. So, after typing `s/e/x` a second time, the URL becomes:
+
+[https://txnor.com/vi**x**w/cat-massage-gif-24282757][example-2]
+
+[example-2]: https://txnor.com/vixw/cat-massage-gif-24282757
+
+### Chess (`s/w/ag`)
+
+Another cool feature is that you can play chess by typing `s/w/ag` after typing
+the initial message of `s/e/x`.
+
+{{< figure src="chess" >}}
+
+### `s/w/ord`
+
+If you do `s/w/ord` after `s/e/x`, then it starts a fighting game (titled
+"Wumpagotchi Adventures". You can use three commands: s/d/d**ATK**,
+s/d/d**DEF**, and s/d/d**HUG**.
+
+Here are a few example images:
+
+#### Main `s/w/ord` screen
+
+{{< figure src="sword" >}}
+
+#### ATK command
+
+{{< figure src="sword-atk" >}}
+
+#### DEF command
+
+{{< figure src="sword-def" >}}
+
+#### HUG command
+
+{{< figure src="sword-hug" >}}
+
+#### Win screen
+
+{{< figure src="sword-win" >}}
+
+#### Lose screen
+
+{{< figure src="sword-lose" >}}
+
+### 6969th Discord Sexer
+
+If you happen to get a one in 6970 chance, it will instead return
+a special image:
+
+{{< figure src="6969th" >}}
+
+[6969th-source]: https://github.com/rebane2001/txnor-server/blob/26c7c279b0b4668c8a3b061692d83c507aeac7c5/sex.py#L130-L133
+
+Here's a [snippet of the code that handles this chance][6969th-source]:
+
+```python
+# 6969th winner image (disable for chess)
+if random.randint(0, 6969) == 6969 and "ag" not in name:
+    web.header('Cache-Control', 'no-store')
+    return six_nine
+```
+
+I believe it's supposed to be a 1/6969 chance, but `random.randint` in Python
+[includes both numbers][randint-inclusive]. That means that the possible numbers that it could pick
+would be 0, 1, ... 6968, 6969. If you were to count the numbers included in that
+sequence, it would total 6970.
+
+[randint-inclusive]: https://docs.python.org/3/library/random.html#random.randint
+
+### Math challenge
+
+Any URL that matches [this regular expression][math-challenge-regex] will
+instead return a randomized math challenge:
+
+[math-challenge-regex]: https://regex101.com/r/ddEkML/1
+
+{{< figure src="math-challenge" >}}
+
+What's special is that the math challenge is [set to not be
+cached][math-challenge-caching].
+
+[math-challenge-caching]: https://github.com/rebane2001/txnor-server/blob/26c7c279b0b4668c8a3b061692d83c507aeac7c5/sex.py#L137
+
+How it works is that when each person's Discord client sends a request to the
+Discord CDN to get the image, the client caches that image. That means each
+client will see the same challenge problem, even if the user restarts the
+client. But separate clients will not have it cached, so they'll request it
+again themselves, and different numbers will be generated.
+
+## Discord sex is open source
+
+Thanks to a [comment from Rebane on this post](#isso-16), I now know that the
+server running on `txnor.com` is open source. See
+[rebane2001/txnor-server][txnor-server-github].
+
+[txnor-server-github]: https://github.com/rebane2001/txnor-server
+
+## YouTube video
+
+Rebane also [made a YouTube video][txnor-youtube-video] about this trick. Make
+sure to check it out too!
+
+[txnor-youtube-video]: https://www.youtube.com/watch?v=km8CR-fdB7o

content/blog/edited-in-middle-of-message-discord/index.md

@@ -2,7 +2,7 @@
 
 title: How to put `(edited)` in the middle of a message in Discord
 date: 2021-03-25T18:48:34-05:00
-lastmod: 2022-04-08T23:29:41-05:00
+lastmod: 2022-12-06T19:59:22-06:00
 toc: true
 comments: true
 
@@ -12,8 +12,11 @@ authors:
 aliases:
   - posts/edited-in-middle-of-message-discord/
 
+categories:
+  - guides
+  - tips-and-tricks
+
 tags:
-  - tutorial
   - discord
   - discord-tricks
 
@@ -32,6 +35,11 @@ to any location inside the message.
 
 <!--more-->
 
+{{< aside note >}}
+This trick only works if you're on desktop/web, and will also only show to
+people on desktop/web.
+{{< /aside >}}
+
 ## Tutorial
 
 Before you start, copy the "right-to-left embedding" character

content/blog/github-copilot-experiments/index.md

@@ -1,6 +1,6 @@
 ---
 
-title: GitHub Copilot experiments
+title: Experimenting with GitHub Copilot
 date: 2021-11-06T23:56:47-05:00
 lastmod: 2021-11-08T21:46:39-06:00
 toc: true
@@ -9,6 +9,10 @@ comments: true
 authors:
   - bbaovanc
 
+categories:
+  - programming
+  - tinkering
+
 tags:
   - github-copilot
 

content/blog/swapfile-guide/index.md

@@ -0,0 +1,270 @@
+---
+
+title: How to create (or remove) a swapfile on Linux
+date: 2023-01-23T20:26:18-06:00
+lastmod: 2023-01-23T20:26:18-06:00
+toc: true
+comments: true
+draft: true
+
+authors:
+  - bbaovanc
+
+categories:
+  - guides
+  - linux
+  - tips-and-tricks
+
+tags:
+  - linux-swap
+  - swapfile
+
+series:
+  - swapfile-guide
+
+# this will be shown for the article in list pages and in the page metadata
+# it can be either an image or video (this might change in the future, however)
+resources:
+  - name: feature
+    src: something.webp
+    title: Some image (image format can be anything; webp is just an example)
+
+---
+
+This is a step-by-step tutorial on how to create or remove a swapfile on a Linux
+machine, and whether you should create swap space in the first place.
+
+Also included is the most correct `fstab` entry: most articles get this "wrong"
+(but it doesn't actually matter).
+
+<!--more-->
+
+## Should you use swap?
+
+A common misconception is that adding swap to your system can reduce
+performance. However, even if you aren't running out of RAM, it can still be
+beneficial to add swap.
+
+See these points according to [an article by Hayden James][always-add-swap]:
+
+> - Even if there is still available RAM, the Linux Kernel will **move memory
+>   pages that are hardly ever used** into swap space.
+>
+> - It’s better to swap out memory pages that have been inactive for a while,
+>   **keeping often-used data in cache**, and this should happen when the server
+>   is most idle, which is the aim of the Kernel.
+>
+> - Avoid setting your swap space too large if it will result in prolonging
+>   performance issues, outages, or your response time (without proper
+>   monitoring/alerts).
+
+[always-add-swap]: https://haydenjames.io/linux-performance-almost-always-add-swap-space/
+
+### Should you use a swap file or partition?
+
+Swap partitions should be preferred because swapfiles tend to be slower and
+slightly more complex to set up, especially if hibernating. A swapfile might be
+preferred due to its flexibility (ease to resize), but if you use
+[LVM][lvm-archwiki] then you can easily resize the swap partition anyways.
+
+[lvm-archwiki]: https://wiki.archlinux.org/title/LVM
+
+## Tutorial
+
+{{< include path="include/bashsession.md" markdown=true >}}
+
+### Step 1: Create the file
+
+The first step is to allocate the file.
+
+```bashsession
+# dd if=/dev/zero of=/swapfile bs=1M count=[size in MiB] status=progress
+```
+
+Replace `[size in MiB]` with the size of your swapfile in Mebibytes (MiB). You
+can use [this online converter](https://www.convertunits.com/from/GiB/to/MiB) to
+convert from Gibibytes (GiB, often confused with Gigabytes, but that's a
+misconception for another time) to MiB, which you can put in the command.
+
+Or you can look at this table for common sizes:
+
+{{< table >}}
+| GiB | MiB         |
+|-----|-------------|
+| 1   | count=1024  |
+| 2   | count=2048  |
+| 3   | count=3072  |
+| 4   | count=4096  |
+| 8   | count=8192  |
+| 16  | count=16384 |
+{{< /table >}}
+
+If you aren't sure how big your swapfile should be, take a look at [Table 15.1
+on this Red Hat documentation page][redhat-swap-table]. Remember that if your
+first swapfile isn't large enough, you can create another one.
+
+[redhat-swap-table]: https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/storage_administration_guide/ch-swapspace#tb-recommended-system-swap-space
+
+On my computer I have 32 GiB of RAM and a 16 GiB swap partition, rather than
+swapfile, because I can flexibly expand the swap partition using
+[LVM][lvm-archwiki].
+
+{{< aside example >}}
+
+To create a swapfile 4 GiB in size, you would run:
+
+```bashsession
+# dd if=/dev/zero of=/swapfile bs=1M count=4096 status=progress
+4096+0 records in
+4096+0 records out
+4294967296 bytes (4.3 GB, 4.0 GiB) copied, 0.960183 s, 4.5 GB/s
+```
+
+{{< /aside >}}
+
+### Step 2: Change swapfile permissions
+
+The swapfile should only be readable by the system (`root` user). Run this
+command to change it:
+
+```bashsession
+# chmod 600 /swapfile
+```
+
+### Step 3: Format the swapfile
+
+Use the `mkswap` command to format the file to be used as swap (basically just
+add a header to identify it):
+
+```bashsession
+# mkswap /swapfile
+Setting up swapspace version 1, size = 4 GiB (4294963200 bytes)
+no label, UUID=a0b87eca-b951-4344-be2d-020d77cdef48
+```
+
+### Step 4: Create an entry in `/etc/fstab`
+
+An entry needs to be added to `/etc/fstab` for the swapfile to be enabled during
+bootup. Open `/etc/fstab` in a text editor, and add this line to the end (add
+spaces to line up with other entries if you want, whitespace is ignored):
+
+```text
+/swapfile none swap sw 0 0
+```
+
+{{< aside note >}}
+
+Above, I have filled the "options" field with `sw`. This is actually a result of
+[cargo culting](https://en.wiktionary.org/wiki/cargo_culting). On Linux, the
+`sw` option (and the [options specified by the commonly used
+`defaults`][fstab-defaults-man]) [isn't valid for `swapon` and is
+ignored][swapon-options-source]. However, the field does need to be filled out
+with something, so feel free to put something funny (do let me know in the
+comments if this somehow breaks something though).
+
+[fstab-defaults-man]: https://man.archlinux.org/man/fstab.5#The_fourth_field_(%3Ci%3Efs_mntops%3C/i%3E).
+[swapon-options-source]: https://github.com/util-linux/util-linux/blob/2ea397239683270a0fc8cd3b72ed5457f52dbda8/sys-utils/swapon.c#L699
+
+If you're curious, this is my `fstab` entry (`UUID` is because I use a swap
+partition, rather than swapfile):
+
+```text
+# /dev/mapper/bobavg0-swap
+UUID=4f7c3ae8-839b-4474-b8a5-96bd78db06f8 none swap bobaswap 0 0
+```
+
+{{< /aside >}}
+
+### Step 5: Enable the swapfile
+
+Adding the `fstab` entry won't enable the swapfile until a reboot. To enable it
+now, use the `swapon` command.
+
+```bashsession
+# swapon /swapfile
+```
+
+### Finally: check the swap status
+
+Use `swapon` and `free` to verify that your new swapfile has been added:
+
+```bashsession
+$ swapon --show
+NAME       TYPE SIZE USED PRIO
+/swapfile  file   4G   0B   -2
+
+$ free -h
+               total        used        free      shared  buff/cache   available
+Mem:            31Gi       3.6Gi        20Gi       233Mi       6.9Gi        26Gi
+Swap:          4.0Gi          0B       4.0Gi
+```
+
+{{< aside note >}}
+
+If you get an error saying that the `swapon` command was not found, try running
+it as `root` (using `sudo`). On Debian-based distributions the `swapon` command
+is not available to regular users.
+
+```bashsession
+$ swapon --show
+bash: swapon: command not found
+
+# swapon --show
+NAME      TYPE SIZE USED PRIO
+/swapfile file   4G   0B   -2
+```
+
+{{< /aside >}}
+
+## Removing a swapfile
+
+{{< aside warning >}}
+
+Be careful that the swapfile isn't being highly used because once you run
+`swapoff`, it will dump the entire contents back into RAM and may cause you to
+run out of memory.
+
+{{< /aside >}}
+
+### Step 1: Disable/unload the swapfile
+
+```bashsession
+$ swapon --show
+NAME       TYPE SIZE USED PRIO
+/swapfile  file   4G   0B   -2
+
+$ # the path to the swapfile I want to remove is `/swapfile`
+
+# swapoff /swapfile
+```
+
+### Step 2: Remove the entry from `fstab`
+
+Open `/etc/fstab` in a text editor and find the line matching the swapfile you
+want to remove, and delete it. For example:
+
+```text
+/swapfile none swap sw 0 0
+```
+
+### Step 3: Delete the actual file
+
+```bashsession
+# rm /swapfile
+```
+
+## References
+
+### Use `dd` instead of `fallocate`
+
+See ["Files with holes" under the man page][swapon-holes-man].
+
+[swapon-holes-man]: https://man.archlinux.org/man/core/util-linux/swapon.8.en#Files_with_holes
+
+### The options field in fstab
+
+On Linux, `sw` doesn't mean anything for `swapon`, so it gets ignored. See:
+
+- [StackExchange answer 1](https://unix.stackexchange.com/a/365961/525130)
+- [StackExchange answer 2](https://unix.stackexchange.com/a/365954/525130)
+- [`parse_options` in the `swapon` source code](https://github.com/util-linux/util-linux/blob/2ea397239683270a0fc8cd3b72ed5457f52dbda8/sys-utils/swapon.c#L699)

content/blog/text-substitution-in-discord-using-sed/index.md

@@ -2,6 +2,7 @@
 
 title: Text substitution in Discord using `sed`
 date: 2021-03-25T18:48:15-05:00
+lastmod: 2021-10-19T14:02:08-05:00
 toc: false
 comments: true
 
@@ -12,10 +13,13 @@ aliases:
   - /blog/posts/sed-text-substitution-in-discord/
   - /blog/posts/text-substitution-in-discord-using-sed/
 
+categories:
+  - tips-and-tricks
+
 tags:
-  - tutorial
   - discord
   - discord-tricks
+  - sed
 
 resources:
   - name: feature

content/blog/the-redesign-of-my-website/index.md

@@ -9,10 +9,13 @@ comments: true
 authors:
   - bbaovanc
 
+categories:
+  - meta
+
 tags:
   - bobatheme
   - hugo
-  - meta
+  - web-development
 
 resources:
   - name: feature

content/blog/using-github-copilot-to-write-a-blog-post/index.md

@@ -9,8 +9,11 @@ comments: true
 authors:
   - bbaovanc
 
+categories:
+
 tags:
   - github-copilot
+  - markdown
 
 series:
   - github-copilot-experiments

content/blog/youtube-url-structures-you-should-know/index.md

@@ -2,16 +2,20 @@
 
 title: Youtube URL structures you should know
 date: 2021-10-30T21:20:38-05:00
-lastmod: 2022-05-02T00:59:25-05:00
+lastmod: 2023-01-16T21:04:09-06:00
 toc: true
 comments: true
 
 authors:
   - bbaovanc
 
+categories:
+  - tips-and-tricks
+
 tags:
-  - youtube
+  - query-parameters
   - url-structures
+  - youtube
 
 resources:
   - name: feature
@@ -24,7 +28,7 @@ resources:
       [What is a
       URL?](https://developer.mozilla.org/en-US/docs/Learn/Common_questions/What_is_a_URL#parameters)
       by [Mozilla
-      Contributors](https://developer.mozilla.org/en-US/docs/MDN/About/contributors.txt)
+      Contributors](https://developer.mozilla.org/en-US/docs/Learn/Common_questions/What_is_a_URL/contributors.txt)
       is licensed under [CC-BY-SA
       2.5](https://creativecommons.org/licenses/by-sa/2.5/)
 

content/categories/_index.md

@@ -0,0 +1,7 @@
+---
+
+title: Categories
+
+---
+
+List of categories on my website. These are different types or styles of posts.

content/categories/devops/_index.md

@@ -0,0 +1,11 @@
+---
+
+title: DevOps
+
+---
+
+Posts about toolchain and software pipeline stuff. The abbreviation means
+software development (Dev) plus IT operations (Ops). Includes things such as
+CI/CD (GitHub Actions).
+
+<!--more-->

content/categories/guides/_index.md

@@ -0,0 +1,9 @@
+---
+
+title: Guides
+
+---
+
+Any kind of guide or tutorial.
+
+<!--more-->

content/categories/jailbreak/_index.md

@@ -0,0 +1,9 @@
+---
+
+title: Jailbreak
+
+---
+
+Anything related to jailbreaking (iOS or other Apple devices).
+
+<!--more-->

content/categories/linux/_index.md

@@ -0,0 +1,9 @@
+---
+
+title: Linux
+
+---
+
+Anything relating to Linux (the kernel or operating systems).
+
+<!--more-->

content/categories/meta/_index.md

@@ -0,0 +1,9 @@
+---
+
+title: Meta
+
+---
+
+Posts talking about my website.
+
+<!--more-->

content/categories/programming/_index.md

@@ -0,0 +1,9 @@
+---
+
+title: Programming
+
+---
+
+Any posts relating to programming and/or software development.
+
+<!--more-->

content/categories/software/_index.md

@@ -0,0 +1,9 @@
+---
+
+title: Software
+
+---
+
+Posts that discuss/review various programs.
+
+<!--more-->

content/categories/sysadmin/_index.md

@@ -0,0 +1,10 @@
+---
+
+title: Sysadmin
+
+---
+
+Anything relating to managing servers (usually relating to Linux). "Sysadmin" is
+short for "system administrator".
+
+<!--more-->

content/categories/tinkering/_index.md

@@ -0,0 +1,9 @@
+---
+
+title: Tinkering
+
+---
+
+Posts where I experiment with things.
+
+<!--more-->

content/categories/tips-and-tricks/_index.md

@@ -0,0 +1,10 @@
+---
+
+title: Tips and Tricks
+
+---
+
+Random little tips and/or tricks that I want to share. Will probably be mostly
+short articles (but that's not a bad thing).
+
+<!--more-->

content/contact/index.md

@@ -16,5 +16,5 @@ description: >-
 - Email: bbaovanc@bbaovanc.com
   - If needed, encrypt your email with [my PGP
     key](https://keyserver.ubuntu.com/pks/lookup?search=bbaovanc%40bbaovanc.com&fingerprint=on&op=index)
-- bobaforum (ask me questions publicly, I guess like a Q&A):
-  https://forum.bbaovanc.com/t/ask-me
+- GitHub Discussions (Q&A):
+  https://github.com/BBaoVanC/bbaovanc.com/discussions/categories/q-a

content/links/index.md

@@ -26,7 +26,6 @@ description: >-
 - [bbaovanc.com source code](https://github.com/BBaoVanC/bbaovanc.com)
 - [bobatheme](https://github.com/BBaoVanC/bobatheme) - theme for this
   website
-- [bobaforum](https://forum.bbaovanc.com) - my public forum
 - [Searx Instance](https://search.bbaovanc.com/) - privacy-respecting search
   engine
 - [Gitea Instance](https://git.bbaovanc.com/) - mostly just mirrors of my GitHub

content/series/_index.md

@@ -0,0 +1,7 @@
+---
+
+title: Series
+
+---
+
+List of series, which are sequences of closely related posts.

content/series/github-copilot-experiments/_index.md

@@ -2,8 +2,9 @@
 
 title: Github Copilot Experiments
 
-description: >-
+---
+
 Make sure to read the last two posts where I made GitHub Copilot write a blog
 post itself.
 
----
+<!--more-->

content/series/swapfile-guide/_index.md

@@ -0,0 +1,10 @@
+---
+
+title: Swapfile Guide
+
+---
+
+A tutorial on how to set up a swapfile on Linux, but with some more depth than
+just a step-by-step.
+
+<!--more-->

content/tags/_index.md

@@ -0,0 +1,8 @@
+---
+
+title: Tags
+
+---
+
+List of tags on my website. These are specific things or ideas that I talk about
+in a post.

content/tags/arch-linux/_index.md

@@ -0,0 +1,10 @@
+---
+
+title: Arch Linux
+
+---
+
+A Linux distribution which aims to be lightweight, flexible, and simple. See
+https://archlinux.org for more information.
+
+<!--more-->

content/tags/bobanews/_index.md

@@ -0,0 +1,12 @@
+---
+
+title: bobanews
+
+---
+
+The main name for my newsletter. I recommend you read the [blog post I wrote
+about it][newsletter-post].
+
+[newsletter-post]: {{< ref "/blog/blog-post-newsletter" >}}
+
+<!--more-->

content/tags/bobatheme/_index.md

@@ -0,0 +1,12 @@
+---
+
+title: bobatheme
+
+---
+
+Posts about bobatheme, my custom [Hugo][hugo-website] theme which I use on this
+website.
+
+[hugo-website]: https://gohugo.io
+
+<!--more-->

content/tags/caddy/_index.md

@@ -0,0 +1,14 @@
+---
+
+title: Caddy
+
+---
+
+Caddy is a powerful and open source webserver written in [Golang][golang] which
+includes some fancy features such as built-in automatic HTTPS. It's by far my
+favorite webserver. See my [blog post about Caddy][caddy-blog-post] for why.
+
+[golang]: https://go.dev/
+[caddy-blog-post]: {{< ref "/blog/caddy-is-the-best-webserver" >}}
+
+<!--more-->

content/tags/checkra1n/_index.md

@@ -0,0 +1,13 @@
+---
+
+title: checkra1n
+
+---
+
+An [iOS jailbreak][ios-jailbreaking] which supports the iPhone 4s to the iPhone
+X. See the [official checkra1n website][checkra1n-website] for more information.
+
+[ios-jailbreaking]: https://en.wikipedia.org/wiki/IOS_jailbreaking
+[checkra1n-website]: https://checkra.in/
+
+<!--more-->

content/tags/discord-tricks/_index.md

@@ -0,0 +1,9 @@
+---
+
+title: Discord Tricks
+
+---
+
+Tips and tricks I have learned about Discord.
+
+<!--more-->

content/tags/discord/_index.md

@@ -0,0 +1,14 @@
+---
+
+title: Discord
+
+---
+
+An extremely popular chat platform. You have to live under a rock to not know
+what Discord is.
+
+<!--more-->
+
+See also: the [discord-tricks tag][discord-tricks-tag].
+
+[discord-tricks-tag]: {{< ref "/tags/discord-tricks/" >}}

content/tags/gitea/_index.md

@@ -0,0 +1,13 @@
+---
+
+title: Gitea
+
+---
+
+Gitea is a lightweight self-hosted Git service similar to GitHub. I use it on
+[bbaovanc's Gitea][bbaovanc-gitea] and [bobatea][bobatea].
+
+[bbaovanc-gitea]: https://git.bbaovanc.com
+[bobatea]: https://git.boba.best
+
+<!--more-->

content/tags/github-actions/_index.md

@@ -0,0 +1,11 @@
+---
+
+title: Github Actions
+
+---
+
+Any posts that talk about GitHub's CI/CD platform. This is what I use for
+automatic tasks on my website, such as automatic audits, and automatic building
+and deploying.
+
+<!--more-->

content/tags/github-copilot/_index.md

@@ -0,0 +1,14 @@
+---
+
+title: GitHub Copilot
+
+---
+
+An extension made by GitHub which provides artificial intelligence powered
+autocomplete, trained on real open source code. It is intended to give smarter
+results than a typical autocomplete solution can, such as automatically
+generating [boilerplate code][boilerplate-code].
+
+[boilerplate-code]: https://en.wikipedia.org/wiki/Boilerplate_code
+
+<!--more-->

content/tags/google-lighthouse/_index.md

@@ -0,0 +1,11 @@
+---
+
+title: Google Lighthouse
+
+---
+
+Lighthouse is a tool that can audit websites based on performance,
+accessibility, SEO, and more. It also provides useful suggestions on how a
+website can be improved.
+
+<!--more-->

content/tags/hugo/_index.md

@@ -0,0 +1,9 @@
+---
+
+title: Hugo
+
+---
+
+Hugo is a static site generator which I use to generate this website.
+
+<!--more-->

content/tags/linux-swap/_index.md

@@ -0,0 +1,13 @@
+---
+
+title: Swap (Linux)
+
+---
+
+Swap space is storage on your drive that can be used as virtual memory when the
+system is running low on physical memory (RAM). It is also used when hibernating
+(suspend to disk).
+
+More information: https://haydenjames.io/linux-performance-almost-always-add-swap-space/
+
+<!--more-->

content/tags/listmonk/_index.md

@@ -0,0 +1,12 @@
+---
+
+title: listmonk
+
+---
+
+A self-hosted newsletter manager which I use to handle my blog post newsletter.
+Read [this blog post][newsletter-blog-post] for more information.
+
+[newsletter-blog-post]: {{< ref "/blog/blog-post-newsletter" >}}
+
+<!--more-->

content/tags/markdown/_index.md

@@ -0,0 +1,11 @@
+---
+
+title: Markdown
+
+---
+
+Markdown is a simple and easy to use markup language which is actually used to
+write the content on this website. Writing it only requires learning a very
+basis syntax, and using a plain-text editor.
+
+<!--more-->

content/tags/newsletter/_index.md

@@ -0,0 +1,15 @@
+---
+
+title: Newsletter
+
+---
+
+Blog posts related to my newsletter.
+
+<!--more-->
+
+You can sign up for my newsletter [using this signup form][signup-form]. Make
+sure that you tick the box labeled `bbaovanc.com Blog Posts`. A nickname (or
+your real name if you prefer) is optional.
+
+[signup-form]: https://lists.bbaovanc.com/subscription/form

content/tags/query-parameters/_index.md

@@ -0,0 +1,16 @@
+---
+
+title: Query Parameters
+
+---
+
+Query parameters are a map of fields and values after the question mark in a
+URL.
+
+<!--more-->
+
+Optionally provide more information about the tag here. This part will only show
+on the tag page, not on the tags list page.
+
+If you delete this section, DO NOT delete the summary separator (`<!--more-->`)
+or else the summary won't be shown.

content/tags/sed/_index.md

@@ -0,0 +1,11 @@
+---
+
+title: sed
+
+---
+
+Short for "stream editor", `sed` is a utility used to edit text on Unix systems.
+It is usually used with regular expressions (regex for short). If you're
+interested, look up "regex basics" and "sed basics", or something similar.
+
+<!--more-->

content/tags/swapfile/_index.md

@@ -0,0 +1,11 @@
+---
+
+title: swapfile
+
+---
+
+A swapfile is a file that gives your system more [swap]({{< relref
+"../linux-swap" >}}) space, which is used when the system is running low on RAM,
+or when hibernating.
+
+<!--more-->

content/tags/systemd/_index.md

@@ -0,0 +1,10 @@
+---
+
+title: systemd
+
+---
+
+`systemd` is by far the most popular service manager (known as an "init system")
+used on Linux.
+
+<!--more-->

content/tags/url-structures/_index.md

@@ -0,0 +1,9 @@
+---
+
+title: URL Structures
+
+---
+
+Posts about URL conventions on certain websites or services.
+
+<!--more-->

content/tags/web-development/_index.md

@@ -0,0 +1,9 @@
+---
+
+title: Web Development
+
+---
+
+Posts about developing for the internet.
+
+<!--more-->

content/tags/webserver/_index.md

@@ -0,0 +1,9 @@
+---
+
+title: Webserver
+
+---
+
+Blog posts about webservers (software that runs websites).
+
+<!--more-->

content/tags/youtube/_index.md

@@ -0,0 +1,10 @@
+---
+
+title: YouTube
+
+---
+
+One of the most popular video and social media platforms. If you don't know what
+YouTube is, I don't know what to tell you.
+
+<!--more-->

include/bashsession.md

@@ -0,0 +1,32 @@
+{{< aside info >}}
+
+Commands in this article are prefixed them with a prompt symbol (either `$` or
+`#`) which is not part of the command. Lines with no prompt symbol are output
+from the command.
+
+The `#` means to run it as `root` (usually using `sudo`):
+
+```bashsession
+$ ls /var/lib/docker
+ls: cannot open directory '/var/lib/docker': Permission denied
+
+$ # this is a comment
+$ # regular users aren't allowed to view /var/lib/docker, we need root
+
+# ls /var/lib/docker
+builder   containerd  image    overlay2  runtimes  tmp	 volumes
+buildkit  containers  network  plugins	swarm	  trust
+
+$ # we can do the same thing using sudo
+
+$ sudo ls /var/lib/docker
+[sudo] password for bbaovanc:
+builder   containerd  image    overlay2  runtimes  tmp	 volumes
+buildkit  containers  network  plugins	swarm	  trust
+```
+
+If you want to copy just the commands (for example: pasting them into your own
+terminal to run them all), press the [Copy](javascript:void(0)) button in the top right of the code
+block.
+
+{{< /aside >}}

layouts/partials/additional-head.html

@@ -2,3 +2,5 @@
     <script defer data-domain="bbaovanc.com" src="https://plausible.bbaovanc.com/js/bobalytics.outbound-links.js"></script>
     <script>window.plausible = window.plausible || function() { (window.plausible.q = window.plausible.q || []).push(arguments) }</script>
 {{ end }}
+
+<link rel="me" href="https://procursus.social/@bbaovanc" />

layouts/partials/comments.html

@@ -1,61 +1,6 @@
-<!-- idk why this is even required
-    vim: ft=html
--->
-<style>
-#isso-thread > h4 {
-    color: var(--text-normal);
-}
-
-#isso-root .isso-comment:not(:first-of-type),
-.isso-follow-up .isso-comment {
-    border-color: var(--background-4);
-}
-
-.isso-comment > .isso-text-wrapper > .isso-comment-header .isso-author,
-.isso-comment > .isso-text-wrapper > .isso-comment-footer,
-.isso-comment > .isso-text-wrapper > .isso-comment-footer .isso-votes {
-    color: var(--text-normal);
-    opacity: 80%;
-}
-
-.isso-comment.isso-is-page-author > .isso-text-wrapper {
-    background-color: var(--background-accent);
-}
-.isso-comment.isso-is-page-author > .isso-text-wrapper > .isso-comment-header > .isso-author {
-    color: var(--link-color);
-}
-
-.isso-postbox > .isso-form-wrapper .isso-preview {
-    color: var(--text-normal);
-    background: var(--background-2);
-}
-
-.isso-comment > .isso-text-wrapper > .isso-comment-footer a,
-.isso-comment > .isso-text-wrapper > .isso-comment-footer a:hover {
-    color: var(--link-color) !important;
-}
-
-.isso-comment > .isso-text-wrapper > .isso-comment-footer a:hover {
-    text-decoration: underline;
-}
-
-.isso-postbox > .isso-form-wrapper > .isso-auth-section .isso-input-wrapper input,
-.isso-postbox > .isso-form-wrapper > .isso-auth-section .isso-post-action > input,
-#isso-thread .isso-textarea,
-.isso-postbox > .isso-form-wrapper .isso-preview {
-    color: var(--text-normal);
-    background-color: var(--background-2);
-    border-color: var(--background-4) !important;
-}
-
-.isso-postbox > .isso-form-wrapper > .isso-auth-section .isso-post-action > input:hover {
-    background-color: var(--background-4);
-}
-.isso-postbox > .isso-form-wrapper > .isso-auth-section .isso-post-action > input:active {
-    background-color: var(--background-5);
-}
-</style>
-
+{{ with resources.Get "css/comments.css" | fingerprint "sha512" }}
+    <link rel="stylesheet" type="text/css" href="{{ .Permalink }}" integrity="{{ .Data.Integrity }}" crossorigin="anonymous">
+{{ end }}
 
 <h2 style="margin-bottom: 0;">Comments</h2>
 <small>
@@ -91,7 +36,7 @@
         {{/*
         data-isso-vote-levels=""
         */}}
-        data-isso-feed="false"
+        data-isso-feed="true"
         data-isso-require-email="false"
         data-isso-reply-notifications="true"
         data-isso-reply-notifications-default-enabled="true"
@@ -110,4 +55,4 @@
         src="https://isso.bbaovanc.com/js/embed.min.js">
 </script>
 
-<section id="isso-thread"></section>
+<section id="isso-thread" data-title="{{ .Title }}"></section>

lighthouserc.yaml

@@ -1,15 +1,5 @@
 ci:
   collect:
-    url:
-      - https://localhost/ # homepage
-      - https://localhost/links/ # very simple page
-      - https://localhost/blog/ # list page
-      - https://localhost/blog/the-redesign-of-my-website/ # average post, but no footnotes
-      - https://localhost/blog/blog-post-newsletter/ # average post, but WITH footnotes
-      - https://localhost/blog/youtube-url-structures-you-should-know/ # youtube embed
-      - https://localhost/blog/copilot-post/ # lots of code blocks & text
-      - https://localhost/blog/github-copilot-experiments/ # heavy use of images
-      - https://localhost/blog/caddy-is-the-best-webserver/
     startServerCommand: sudo caddy run
     settings:
       chromeFlags: "--ignore-certificate-errors --throttling.cpuSlowdownMultiplier=2.4"