aboutsummaryrefslogtreecommitdiff
path: root/build/jekyll-sourcehut/index.html
diff options
context:
space:
mode:
Diffstat (limited to 'build/jekyll-sourcehut/index.html')
-rw-r--r--build/jekyll-sourcehut/index.html32
1 files changed, 2 insertions, 30 deletions
diff --git a/build/jekyll-sourcehut/index.html b/build/jekyll-sourcehut/index.html
index 9584014..2b41a53 100644
--- a/build/jekyll-sourcehut/index.html
+++ b/build/jekyll-sourcehut/index.html
@@ -3,11 +3,12 @@
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta name="color-scheme" content="dark light">
<link rel="icon" href="data:,">
<title>Hosting a Jekyll Site on Sourcehut</title>
<link href="/atom.xml" type="application/atom+xml" rel="alternate" title="Atom feed for blog posts" />
<link href="/rss.xml" type="application/rss+xml" rel="alternate" title="RSS feed for blog posts" />
-<style>*{box-sizing:border-box;}body{font-family:sans-serif;line-height:1.33;margin:0 auto;max-width:650px;padding:1rem;}img{max-width:100%;}pre{border:1px solid;overflow:auto;padding:5px;}table{text-align:left;width:100%;}.footnotes{font-size:90%;}</style>
+<style>*{box-sizing:border-box;}body{font-family:sans-serif;line-height:1.33;margin:0 auto;max-width:650px;padding:1rem;}blockquote{background:rgba(0,0,0,0.1);border-left:4px solid;padding-left:5px;}img{max-width:100%;}pre{border:1px solid;overflow:auto;padding:5px;}table{text-align:left;width:100%;}.footnotes{font-size:90%;}</style>
</head>
<nav>
@@ -16,17 +17,11 @@
<main>
<h1 id="hosting-a-jekyll-site-on-sourcehut">Hosting a Jekyll Site on Sourcehut</h1>
-
<p>2021-12-06</p>
-
<p>I recently decided to switch my personal, static site&#8217;s hosting from Netlify to <a href="https://srht.site">sourcehut pages</a>. The process went <em>fairly</em> smoothly with only a couple minor hiccups; nothing rage-inducing. After everything was up and running smoothly, I figured writing out a step-by-step tutorial might help others who are thinking of doing a similar switch (or looking to host their first static site).</p>
-
<p>But first, let me briefly explain why I made the switch in the first place&#8230;</p>
-
<h2 id="why-sourcehut-pages">Why sourcehut pages?</h2>
-
<p>Using Netlify as your static host is simple, intuitive and comes packed with a great deal of extra functionality you can easily add-on. So, why would I decide to switch over to sourcehut? The best answer comes directly off the main homepage of <a href="https://sourcehut.org">sourcehut.org</a>:</p>
-
<ul>
<li>Absolutely no tracking or advertising</li>
<li>All features work without JavaScript</li>
@@ -34,17 +29,11 @@
<li>The fastest &#38; lightest software forge</li>
<li>100% free and open source software</li>
</ul>
-
<p>After realizing all that, it&#8217;s pretty difficult to stick with Netlify&#8217;s <em>proprietary</em> stack&#8230;</p>
-
<h2 id="free-but-not-free">Free but not <em>&#8220;free&#8221;</em></h2>
-
<p>I should note that using sourcehut pages <em>does</em> require you to be a contributing (read: paying) member on the platform. I&#8217;m a cheapo and selected the $2&#47;month option but you might be inclined to donate more. Paying this &#8220;fee&#8221; is perfectly fine for me, considering the hosting quality (speed and storage) it affords me. It also doesn&#8217;t hurt that I get the &#8220;feel good vibes&#8221; of supporting an important, open source product.</p>
-
<p>Keeping that in mind, let&#8217;s get into setting up our static site!</p>
-
<h2 id="setting-up-your-repo-locally">Setting up your repo locally</h2>
-
<ol>
<li>Create a new account on <a href="https://sourcehut.org">sourcehut</a> (or log in to an existing one)</li>
<li>Setup your billing to contribute monthly (tier amount is up to you)</li>
@@ -52,13 +41,9 @@
<li>Connect this repo locally (as you would via any other git host)</li>
<li>In this new local directory, place all your Jekyll files as you would with any other static hosting provider</li>
</ol>
-
<h2 id="the-sourcehut-build-file">The sourcehut build file</h2>
-
<p>In order to have your Jekyll site build and push the correct files live, you will need to use sourcehut&#8217;s build system. This will run every time you push out a new change to your repo (new blog post, page content changes, styling updates).</p>
-
<p>To make things easier, you can copy the build file below (remember to use your <em>own</em> information for usernames, git repo naming etc):</p>
-
<pre><code>image: debian&#47;stable
oauth: pages.sr.ht&#47;PAGES:RW
packages:
@@ -81,34 +66,21 @@ tasks:
- upload: |
acurl -f https:&#47;&#47;pages.sr.ht&#47;publish&#47;$site -Fcontent=@site.tar.gz
</code></pre>
-
<p>Save this file as <code>.build.yml</code> and place it in the root directory of your Jekyll source code.</p>
-
<p>Then, you just need to push your changes to the repo. If everything was setup properly, you&#8217;ll be able to see your live site at <code>https:&#47;&#47;yourusername.srht.site</code> (just give it a little bit of time to run the full build process)</p>
-
<h2 id="custom-domains">Custom Domains</h2>
-
<p>If you&#8217;re like me and want to use your own custom domain - have no fear! This process is actually quite easy.</p>
-
<p>First, add a new A Record through your domain provider:</p>
-
<pre><code>@ IN A 173.195.146.139
</code></pre>
-
<p>Then change the following <code>environment</code> parameter inside your existing <code>.build.yml</code> file:</p>
-
<pre><code>environment:
site: yourcustomdomain.com
</code></pre>
-
<p>And that&#8217;s it - custom domain set! If you run into any issues check out the <a href="https://srht.site/custom-domains">official documentation on custom domains</a>.</p>
-
<h2 id="wrapping-up">Wrapping Up</h2>
-
<p>Hopefully this helps to streamline the process for others to host their static sites through sourcehut. Having open and healthy competition among host providers and <code>git</code> workflows is essential to avoiding vendor lock-in. </p>
-
<p>Even low-effort support for open-source products (like where you host your static site or FOSS projects) can go a long way. Just some food for thought.</p>
-
<div class="footnotes">
<hr/>
<ol>