Install lightweight version of Emacs.

.github/workflows/publish.yml

@@ -33,7 +33,7 @@ jobs:
       - name: Install Deps
         run: |
           sudo apt-get update
-          sudo apt-get -y install emacs
+          sudo apt-get -y install emacs-nox
       - name: Checkout
         uses: actions/checkout@v3
         with:

build.el

@@ -8,8 +8,15 @@
   "Build wmedrano.dev website.
 
 The static site is output into the site directory."
-  (let ((org-publish-project-alist
-         '(("wmedrano-site" :components ("wmedrano-home" "wmedrano-posts"))
+  (let ((org-html-home/up-format "
+<div id=\"org-div-home-and-up\">
+ <!--%s-->
+ <a href=\"%s\">HOME</a> | <a href=\"/posts\">POSTS</a> | <a href=\"/about.html\">ABOUT</a>
+</div>
+")
+        (org-html-link-up "../") ;; Unused. Required for home/up to render.
+        (org-publish-project-alist
+         `(("wmedrano-site" :components ("wmedrano-home" "wmedrano-posts"))
            ("wmedrano-home"
             :base-directory "./src"
             :publishing-function org-html-publish-to-html
@@ -20,20 +27,21 @@ The static site is output into the site directory."
             :with-toc nil
             :section-numbers nil
             :html-link-home "./"
-            :html-link-up "./")
+            )
            ("wmedrano-posts"
             :base-directory "./src/posts"
             :publishing-function org-html-publish-to-html
             :publishing-directory "./site/posts"
             :recursive t
             :auto-sitemap t
+            :section-numbers nil
             :sitemap-title "Posts"
             :sitemap-filename "index.org"
-            :html-link-home "/.."
-            :html-link-up "./index.html")))
-        (org-html-head "<link rel=\"stylesheet\" type=\"text/css\" href=\"style.css\"/>")
+            :html-link-home "../"
+            )))
+        (org-html-head "<link rel=\"stylesheet\" type=\"text/css\" href=\"/style.css\"/>")
         (org-html-validation-link nil))
-    (org-publish-project "wmedrano-site" nil)
+    (org-publish-project "wmedrano-site" t)
     (copy-file "src/style.css" "site/style.css" t)))
 
 (build-wmedrano-dev-site)

src/about.org

@@ -2,48 +2,53 @@
 #+AUTHOR: Will Medrano
 #+DATE: [2024-05-12 Sun]
 
-* About Me
-:PROPERTIES:
-:CUSTOM_ID: AboutMe-o46g18m057k0
-:END:
 
-I'm Will and I work as a Software Engineer at Google. I deal with very big data during my day job. In my spare time I tinker with a variety of things like:
+I work as a Software Engineer at Google. I deal with very big data
+during my day job. In my spare time, I tinker with a variety of
+hobbies and tools like:
 
 - The Rust programming language.
-- Audio for music creation purposes.
+- Audio programming for music.
 - Ergonomic keyboards.
+- Tweaking Emacs.
+
 
 ** Notable Open Source Work
 :PROPERTIES:
 :CUSTOM_ID: AboutMeNotableOpenSourceWork-mpn568q057k0
 :END:
 
+
 *** Rust JACK
 :PROPERTIES:
 :CUSTOM_ID: AboutMeNotableOpenSourceWorkRustJACK-mqp568q057k0
 :END:
 
 https://github.com/rustaudio/rust-jack is a Rust wrapper over JACK. JACK is the recommended Realtime audio API for Linux.
 
+
 *** wmidi
 :PROPERTIES:
 :CUSTOM_ID: AboutMeNotableOpenSourceWorkwmidi-hsr568q057k0
 :END:
 
 https://github.com/rustaudio/wmidi is a midi encoding and decoding library. Midi is a widely used digital interface to communcate musical data such as note keypresses and parameter changes.
 
+
 *** livi-rs
 :PROPERTIES:
 :CUSTOM_ID: AboutMeNotableOpenSourceWorklivirs-ott568q057k0
 :END:
 
 https://github.com/wmedrano/livi-rs is a Rust library for hosting LV2 plugins.
 
+
 ** Links
 :PROPERTIES:
 :CUSTOM_ID: wmedranodotdevLinks-t35ajge047k0
 :END:
 
 - [[https://github.com/wmedrano][GitHub profile]]
-- [[https://github.com/wmedrano/wmedrano.dev][Source Code]]
-- [[https://ko-fi.com/wmedrano][Donate on Ko-Fi]]
+- [[https://github.com/wmedrano/wmedrano.dev][Blog Source]]
+- [[https://github.com/sponsors/wmedrano][Sponsor on GitHub]]
+- [[mailto:[email protected]][Email]]

src/posts/gitlab.org → src/posts/github-gitlab.org

@@ -1,16 +1,16 @@
-#+TITLE: GitLab for Hobby Projects
+#+TITLE: GitHub or GitLab for Hobby Projects
 #+AUTHOR: Will Medrano
 #+DATE: [2024-05-13 Mon]
 
 * Introduction
 :PROPERTIES:
-:CUSTOM_ID: GitLab-8nt9l58067k0
+:CUSTOM_ID: Introduction-2kba2r3087k0
 :END:
 
 GitHub and GitLab are code hosting platforms. After using both, I
 prefer to keep my solo development needs on GitHub. It's not that
 GitHub is significantly better than GitLab, but its slightly better
-and lets be get back to focusing on my dev work.
+and lets me get back to focusing on my dev work.
 
 * Basics
 :PROPERTIES:
@@ -35,33 +35,35 @@ For my hobbyist needs, they both:
 :CUSTOM_ID: Considerations-gackdb9067k0
 :END:
 
-** Speed
+** Latency
 :PROPERTIES:
 :CUSTOM_ID: CategoriesSpeed-d8ci1d9067k0
 :END:
 
 GitHub just feels snappier. I can't help but get annoyed at how
-sluggish page loads are in GitLab. Doing a quick comparison, I found
-that loading the "Changes" tab for a Merge Request takes about ~2.5s~
-before any reviewable code appears on the screen. Similarly, GitHub
-takes about ~1.0s~ to display code.
+sluggish page loads are in GitLab. Doing a quick comparison of the
+code review page, I found that GitLab takes about 2.5s while GitHub
+only takes around 1.0s before displaying any code.
 
 Really, this is the make or break feature for most of my usage. The
 sluggishness of GitLab gives my mind enough time to wander and get
 bored. This is especially bothersome for the moments where I'm locked
-in and highly productive.
+in and highly productive. Most people may not mind, but I'm pretty
+sensitive to latency.
 
 
 ** Community
 :PROPERTIES:
 :CUSTOM_ID: CategoriesCommunity-3eei1d9067k0
 :END:
 
-Community is pretty important for the small libraries I
-develop. Although I have no expectation that anyone will use my niche
-library, it does happen from time to time. Its always a good feeling
-when someone contributes back a great feature to even a niche library
-like [[https://github.com/wmedrano/livi-rs][livi-rs]].
+Surprisingly, some of the small libraries I use have had a small
+amount of success in the open source community. Although I had no
+expectation that anyone would find, or even use my libraries, it's
+satisfying when someone finds my library and finds it useful. It's
+even more satisfying when someone contributes back a good feature to
+even a small library like
+[[https://github.com/wmedrano/livi-rs][livi-rs]].
 
 GitHub's community eclipses GitLab. Anecdotally, I've noticed most
 projects I use or have had any contribution to tend to be on
@@ -74,12 +76,14 @@ appreciate contributors.
 :CUSTOM_ID: CategoriesCommunityLibraryEngagementCaveats-1nxih7a067k0
 :END:
 
-All of my libraries are on GitHub while I only have binaries on
-GitLab. Libraries tend to attract at least a few users so it may be
-worth it to experiment with the amount of engagement the equivalent
-GitLab package would have. Unfortunately, Open Source development is
-only a side project as my main job eats most of my development time
-and energy.
+All of my libraries are on GitHub while I only have few prototype
+binaries on GitLab. Libraries tend to attract at least a few users so
+it may be worth it to experiment with the amount of engagement the
+equivalent GitLab package would have. Unfortunately, Open Source
+development is only a side project as my main job eats most of my
+development time and energy. Despite this, it does feel like the
+libraries on find on GitHub tend to have more contributor than the
+ones on GitLab.
 
 
 ** CI
@@ -88,8 +92,7 @@ and energy.
 :END:
 
 The CI between GitHub and GitLab is pretty comparable. Both allow
-running builds, lints, tests, and other checks before comitting
-code.
+running builds, lints, tests, and other checks before committing code.
 
 
 GitHub's implementation (GitHub Actions) involves writing YAML
@@ -98,12 +101,12 @@ actions. I've imported other actions to checkout repos, set up caching
 for Rust, uploading coverage results to another provider, and probably
 a few other cases.
 
-GitLab's ecosystem is a bit more barebones. You write YAML that also
+GitLab's ecosystem is a bit more bare bones. You write YAML that also
 executes commands, but there is no ecosystem of actions/commands like
-GitHub. Unpopular opinion, but I prefer not having to import magical
-actions to accomplish tasks. GitLab also had the extra benefit that
-you can provide specific artifacts/files/directories and export
-them. I used this to surface code coverage and test
+GitHub. Unpopular opinion, but I prefer not using magical actions
+(specific to GitHub) to accomplish tasks. GitLab also had the extra
+benefit that you can provide specific artifacts/files/directories and
+export them. I used this to surface code coverage and test
 results. Additionally, I ran benchmarks in the CI which exported
 HTML. The frontend was then able to provide a link to the HTML.
 
@@ -121,9 +124,9 @@ request.
 
 I'm not an expert in security or reliability. I also don't use GitHub
 or GitLab at my professional work. However, I see more headlines about
-GitLab going down. Some famous incidents include GitLab calling
-deleting its database [[https://news.ycombinator.com/item?id=13537052][[hackernews post]​]] or tthe password reset exploit
-[[https://thehackernews.com/2024/05/cisa-warns-of-active-exploitation-of.htm][[hackernews post]​]].
+GitLab going down. Some infamous incidents include GitLab deleting its
+own database [[https://news.ycombinator.com/item?id=13537052][(hackernews post)]] or the password reset exploit
+[[https://news.ycombinator.com/item?id=39159002][(hackernews post)]].
 
 
 ** Features & UX
@@ -147,9 +150,9 @@ really holds the experience back for me.
 :END:
 
 While both GitHub and GitLab offer similar experiences for code
-hosting, I have a slight preferance for GitHub. I can't speak to how
-everyone else perceives GitLab, but the unresponsiveness of the
-website is a slight annoyance. Additionally, GitHub has the larger
-developer community which helps bolster the open source
-community. As the underdog, I hope GitLab can make strides to improve
-GitLab for solo and small open source development.
+hosting, I prefer for GitHub. I can't speak to how everyone else
+perceives GitLab, but the unresponsiveness of the website is a slight
+annoyance. Additionally, GitHub has the larger developer community
+which helps bring in open source contributors. As the underdog, I hope
+GitLab can make strides to improve GitLab for solo and small open
+source development.

src/posts/index.org

@@ -1,3 +1,3 @@
 #+TITLE: Posts
 
-- [[file:gitlab.org][Why I Don't Use GitLab]]
+- [[file:github-gitlab.org][GitHub or GitLab for Hobby Projects]]

src/style.css

@@ -1,3 +1,6 @@
-.content {
-    padding: 1rem
+body {
+    margin: auto;
+    max-width: 50rem;
+    padding: 1rem;
+    font-family: verdana, sans;
 }