From f52a4df9f87bb215f8520666b396c631008a64fc Mon Sep 17 00:00:00 2001 From: wmedrano Date: Mon, 13 May 2024 19:43:54 -0700 Subject: [PATCH] Install lightweight version of Emacs. --- .github/workflows/publish.yml | 2 +- build.el | 21 ++++-- src/about.org | 21 +++--- src/posts/{gitlab.org => github-gitlab.org} | 75 +++++++++++---------- src/posts/index.org | 2 +- src/style.css | 7 +- 6 files changed, 73 insertions(+), 55 deletions(-) rename src/posts/{gitlab.org => github-gitlab.org} (60%) diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml index a189720..f18296e 100644 --- a/.github/workflows/publish.yml +++ b/.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: diff --git a/build.el b/build.el index ebff610..b055c18 100644 --- a/build.el +++ b/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 " +
+ + HOME|POSTS|ABOUT +
+") + (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,7 +27,7 @@ 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 @@ -29,11 +36,11 @@ The static site is output into the site directory." :auto-sitemap t :sitemap-title "Posts" :sitemap-filename "index.org" - :html-link-home "/.." - :html-link-up "./index.html"))) - (org-html-head "") + :html-link-home "../" + ))) + (org-html-head "") (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) diff --git a/src/about.org b/src/about.org index 111d387..8f28dec 100644 --- a/src/about.org +++ b/src/about.org @@ -2,22 +2,23 @@ #+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 @@ -25,6 +26,7 @@ I'm Will and I work as a Software Engineer at Google. I deal with very big data 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 @@ -32,6 +34,7 @@ https://github.com/rustaudio/rust-jack is a Rust wrapper over JACK. JACK is the 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 @@ -39,11 +42,13 @@ https://github.com/rustaudio/wmidi is a midi encoding and decoding library. Midi 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:will.s.medrano@gmail.com][Email]] diff --git a/src/posts/gitlab.org b/src/posts/github-gitlab.org similarity index 60% rename from src/posts/gitlab.org rename to src/posts/github-gitlab.org index bae3757..47e0f15 100644 --- a/src/posts/gitlab.org +++ b/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,21 +35,21 @@ 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 @@ -57,11 +57,13 @@ in and highly productive. :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. diff --git a/src/posts/index.org b/src/posts/index.org index 9fe5d91..710e33b 100644 --- a/src/posts/index.org +++ b/src/posts/index.org @@ -1,3 +1,3 @@ #+TITLE: Posts -- [[file:gitlab.org][Why I Don't Use GitLab]] \ No newline at end of file +- [[file:github-gitlab.org][GitHub or GitLab for Hobby Projects]] \ No newline at end of file diff --git a/src/style.css b/src/style.css index 414b0a8..0d625a6 100644 --- a/src/style.css +++ b/src/style.css @@ -1,3 +1,6 @@ -.content { - padding: 1rem +body { + margin: auto; + max-width: 50rem; + padding: 1rem; + font-family: verdana, sans; }