diff --git a/.hugo_build.lock b/.hugo_build.lock
new file mode 100644
index 0000000..e69de29
diff --git a/content/posts b/content/posts
deleted file mode 100644
index 8b13789..0000000
--- a/content/posts
+++ /dev/null
@@ -1 +0,0 @@
-
diff --git a/content/posts/hard-problem.md b/content/posts/hard-problem.md
new file mode 100644
index 0000000..8045109
--- /dev/null
+++ b/content/posts/hard-problem.md
@@ -0,0 +1,73 @@
++++
+date = '2024-11-13T14:24:21+01:00'
+draft = true
+title = 'Hard Problem: Invalidating the browser cache'
++++
+
+**I had a bit of an issue with my [website](https://demos.ajstepien.xyz) recently.**
+
+I pushed some changes incorporating images for the first time (I know, very swish), and everything seemed to be working just fine, but when I loaded the production site in Firefox, the images were not styled. Stranger still, they *were* styled when I loaded the same page in Chrome.
+
+The experienced computer touchers amongst you will be saying "this is obviously a cache problem", and you're right, it is obviously a cache problem. Pressing `CTR + SHIFT + R` (which forces Firefox to clear the cache and do a full reload) proved this thesis, and solved the problem handily for me, on my machine. But what about other people's machines?
+
+## Invalidating cached HTML
+
+The best way to deal with this problem is to tell the browser not to cache our HTML in the first place. We can achieve this by adding the following meta tag to `index.html`, and any other HTML files we don't want cached.
+
+```html
+
+```
+
+## Invalidating cached CSS
+
+A quick google search revealed that the best way to invalidate browser cache is by changing the url of the file you're telling it to load. So we would change this:
+
+```html
+
+```
+
+to this:
+
+```html
+
+```
+
+and the browser would recognize this as new file and load it from the server. Problem solved! Of course, you would have to change the file name too...
+
+```bash
+mv css/defaults.css css/defaults-2.css
+```
+
+... and this would get tedious very quickly. Furthermore, it's going to make a mess of your version history if, as far as Git is concerned, you're deleting the CSS file and writing a new one with every deployment. Surely there's a better way?
+
+### Using a query
+
+Of course there is. Look at this:
+
+```html
+
+```
+
+As we're requesting the file via http, we can append a query. Awesome. Not awesome enough though. I'm too lazy to do this every time I push a commit, and, being human, I'll probably forget at a critical moment. This can only mean one thing. It's time to bash (🤣) out a quick build script!
+
+```bash
+#!/usr/bin/env bash
+COMMIT="$(git rev-parse HEAD)"
+sed -i "s/css?=\w*/css?v=${COMMIT}/g" index.html
+```
+
+Let's talk real quick about what's happening here:
+
+`COMMIT="$(git rev-parse HEAD)"` gets the commit id from Git and assigns it the variable `$COMMIT`.
+
+Then, `sed -i "s/css?=\w*/css?v=${COMMIT}/g" index.html` does a find and replace on `index.html`. The regular expression `css?=\w*` matches 'css?=' plus any number of contiguous alphanumeric characters (everything until the next quote mark, basically) before replacing these alphanumeric characters with the commit id. The flag `-i` tells sed to edit the file in place. The `g` tells it to perform the operation on the whole file.
+
+Now, whenever we push a new commit, any CSS imports in `index.html` will be changed to something like this:
+
+```html
+
+```
+
+Pretty neat, huh?
+
+There's just one thing bugging me: surely I do actually want the CSS to be cached *sometimes*. Caching exists for a reason, and I don't want to sacrifice performance. Maybe I can modify the build script so that it only updates the CSS imports when the CSS files have changed... Sounds like a topic for another blogpost!
diff --git a/content/posts/permissions-strike-again.md b/content/posts/permissions-strike-again.md
new file mode 100644
index 0000000..cf04a05
--- /dev/null
+++ b/content/posts/permissions-strike-again.md
@@ -0,0 +1,37 @@
++++
+date = '2024-11-13T11:53:13+01:00'
+draft = false
+title = 'Permissions Strike Again'
++++
+
+# It's always permissions
+
+Configuring Apache really isn't rocket science. There are a wealth of great tutorials online, the documentation is very well documented, and the defaults work more or less out of the box. But it's one of those jobs that I do just infrequently enough that I always forget things in the interim, and end up making the same old mistakes.
+
+**And it almost always has to do with permissions.**
+
+So, I'm writing this post both as a means of christening this devlog ([Hi! I'm Andrzej! Hire me!](https://demos.ajstepien.xyz)) and also as a reminder to myself that *the home folder is not executable by default.*
+
+Please, Andrzej. Please. The next time you're building a website, be it for a client or for yourself, and you find yourself scratching your head, wondering what error you may have made in the `.confs`, checking the permissions of your symlink again and again, ask yourself: is my symlink pointing to a directory in the home folder? Because Apache can't open the home folder until you change the permissions!
+
+## What?
+
+In Linux we open directories by 'executing' them. A directory is an executable that lists part of file-system for us, basically. Now, by default, the home directory is only executable by its owner. This makes sense when you think about it -- you don't want your sister, or co-worker, or (more likely) whatever barely-audited application you're installing today, to be able to open that directory. But you probably do want your webserver to be able to open it, especially if you are symlinking to it from `/var/www`.
+
+[Hugo](https://gohugo.io/) (the framework I'm using to build this blog) likes to deploy to the home directory by default. In fact there are lots of reasons why you'd want to deploy there. I do this exact same thing with [Jenkins](https://jenkins.io), and I wasted an hour troubleshooting this exact same problem when I set up that server too.
+
+So, Andrzej of the future (did anyone non-ghoulish win an election yet?), for future reference, let's say you're deploying to `/home/devlog/website`:
+
+1. Add Apache to the 'devlog' user group.
+```
+sudo usermod -aG devlog www-data
+```
+2. Change the permissions on /home/devlog to allow group members to open it.
+```
+sudo chmod 710 /home/devlog
+```
+
+IT'S THAT EASY.
+
+
+
diff --git a/public/categories/index.html b/public/categories/index.html
new file mode 100644
index 0000000..f754d5b
--- /dev/null
+++ b/public/categories/index.html
@@ -0,0 +1,47 @@
+
+
+
+
+
+Categories | My New Hugo Site
+
+
+
+
+
+
+
+
+
+
+
My New Hugo Site
+
+
+
+
+
+
+
+
Categories
+
+
+
+
+
+
+
diff --git a/public/categories/index.xml b/public/categories/index.xml
new file mode 100644
index 0000000..216aed4
--- /dev/null
+++ b/public/categories/index.xml
@@ -0,0 +1,11 @@
+
+
+
+ Categories on My New Hugo Site
+ http://localhost:1313/categories/
+ Recent content in Categories on My New Hugo Site
+ Hugo
+ en-us
+
+
+
diff --git a/public/css/main.css b/public/css/main.css
new file mode 100644
index 0000000..166ade9
--- /dev/null
+++ b/public/css/main.css
@@ -0,0 +1,22 @@
+body {
+ color: #222;
+ font-family: sans-serif;
+ line-height: 1.5;
+ margin: 1rem;
+ max-width: 768px;
+}
+
+header {
+ border-bottom: 1px solid #222;
+ margin-bottom: 1rem;
+}
+
+footer {
+ border-top: 1px solid #222;
+ margin-top: 1rem;
+}
+
+a {
+ color: #00e;
+ text-decoration: none;
+}
diff --git a/public/favicon.ico b/public/favicon.ico
new file mode 100644
index 0000000..67f8b77
Binary files /dev/null and b/public/favicon.ico differ
diff --git a/public/index.html b/public/index.html
new file mode 100644
index 0000000..1262745
--- /dev/null
+++ b/public/index.html
@@ -0,0 +1,71 @@
+
+
+
+
+
+
+My New Hugo Site
+
+
+
+
+
+
+
+
+
+
+
My New Hugo Site
+
+
+
+
+
+
+
+
Laborum voluptate pariatur ex culpa magna nostrud est incididunt fugiat
+pariatur do dolor ipsum enim. Consequat tempor do dolor eu. Non id id anim anim
+excepteur excepteur pariatur nostrud qui irure ullamco.
I pushed some changes incorporating images for the first time (I know, very swish), and everything seemed to be working just fine, but when I loaded the production site in Firefox, the images were not styled. Stranger still, they were styled when I loaded the same page in Chrome.
+
The experienced computer touchers amongst you will be saying “this is obviously a cache problem”, and you’re right, it is obviously a cache problem. Pressing CTR + SHIFT + R (which forces Firefox to clear the cache and do a full reload) proved this thesis, and solved the problem handily for me, on my machine. But what about other people’s machines?
Configuring Apache really isn’t rocket science. There are a wealth of great tutorials online, the documentation is very well documented, and the defaults work more or less out of the box. But it’s one of those jobs that I do just infrequently enough that I always forget things in the interim, and end up making the same old mistakes.
Occaecat aliqua consequat laborum ut ex aute aliqua culpa quis irure esse magna dolore quis. Proident fugiat labore eu laboris officia Lorem enim. Ipsum occaecat cillum ut tempor id sint aliqua incididunt nisi incididunt reprehenderit. Voluptate ad minim sint est aute aliquip esse occaecat tempor officia qui sunt. Aute ex ipsum id ut in est velit est laborum incididunt. Aliqua qui id do esse sunt eiusmod id deserunt eu nostrud aute sit ipsum. Deserunt esse cillum Lorem non magna adipisicing mollit amet consequat.
Anim eiusmod irure incididunt sint cupidatat. Incididunt irure irure irure nisi ipsum do ut quis fugiat consectetur proident cupidatat incididunt cillum. Dolore voluptate occaecat qui mollit laborum ullamco et. Ipsum laboris officia anim laboris culpa eiusmod ex magna ex cupidatat anim ipsum aute. Mollit aliquip occaecat qui sunt velit ut cupidatat reprehenderit enim sunt laborum. Velit veniam in officia nulla adipisicing ut duis officia.
+
Exercitation voluptate irure in irure tempor mollit Lorem nostrud ad officia. Velit id fugiat occaecat do tempor. Sit officia Lorem aliquip eu deserunt consectetur. Aute proident deserunt in nulla aliquip dolore ipsum Lorem ut cupidatat consectetur sit sint laborum. Esse cupidatat sit sint sunt tempor exercitation deserunt. Labore dolor duis laborum est do nisi ut veniam dolor et nostrud nostrud.
Tempor proident minim aliquip reprehenderit dolor et ad anim Lorem duis sint eiusmod. Labore ut ea duis dolor. Incididunt consectetur proident qui occaecat incididunt do nisi Lorem. Tempor do laborum elit laboris excepteur eiusmod do. Eiusmod nisi excepteur ut amet pariatur adipisicing Lorem.
+
Occaecat nulla excepteur dolore excepteur duis eiusmod ullamco officia anim in voluptate ea occaecat officia. Cillum sint esse velit ea officia minim fugiat. Elit ea esse id aliquip pariatur cupidatat id duis minim incididunt ea ea. Anim ut duis sunt nisi. Culpa cillum sit voluptate voluptate eiusmod dolor. Enim nisi Lorem ipsum irure est excepteur voluptate eu in enim nisi. Nostrud ipsum Lorem anim sint labore consequat do.
+
+
+
+
+
+
diff --git a/public/index.xml b/public/index.xml
new file mode 100644
index 0000000..215d191
--- /dev/null
+++ b/public/index.xml
@@ -0,0 +1,47 @@
+
+
+
+ Home on My New Hugo Site
+ http://localhost:1313/
+ Recent content in Home on My New Hugo Site
+ Hugo
+ en-us
+ Wed, 13 Nov 2024 14:24:21 +0100
+
+
+ Hard Problem: Invalidating the browser cache
+ http://localhost:1313/posts/hard-problem/
+ Wed, 13 Nov 2024 14:24:21 +0100
+ http://localhost:1313/posts/hard-problem/
+ <p><strong>I had a bit of an issue with my <a href="https://demos.ajstepien.xyz">website</a> recently.</strong></p>
<p>I pushed some changes incorporating images for the first time (I know, very swish), and everything seemed to be working just fine, but when I loaded the production site in Firefox, the images were not styled. Stranger still, they <em>were</em> styled when I loaded the same page in Chrome.</p>
<p>The experienced computer touchers amongst you will be saying “this is obviously a cache problem”, and you’re right, it is obviously a cache problem. Pressing <code>CTR + SHIFT + R</code> (which forces Firefox to clear the cache and do a full reload) proved this thesis, and solved the problem handily for me, on my machine. But what about other people’s machines?</p>
+
+
+ Permissions Strike Again
+ http://localhost:1313/posts/permissions-strike-again/
+ Wed, 13 Nov 2024 11:53:13 +0100
+ http://localhost:1313/posts/permissions-strike-again/
+ <h1 id="its-always-permissions">It’s always permissions</h1>
<p>Configuring Apache really isn’t rocket science. There are a wealth of great tutorials online, the documentation is very well documented, and the defaults work more or less out of the box. But it’s one of those jobs that I do just infrequently enough that I always forget things in the interim, and end up making the same old mistakes.</p>
<p><strong>And it almost always has to do with permissions.</strong></p>
+
+
+ Post 3
+ http://localhost:1313/posts/post-3/
+ Wed, 15 Mar 2023 11:00:00 -0700
+ http://localhost:1313/posts/post-3/
+ <p>Occaecat aliqua consequat laborum ut ex aute aliqua culpa quis irure esse magna dolore quis. Proident fugiat labore eu laboris officia Lorem enim. Ipsum occaecat cillum ut tempor id sint aliqua incididunt nisi incididunt reprehenderit. Voluptate ad minim sint est aute aliquip esse occaecat tempor officia qui sunt. Aute ex ipsum id ut in est velit est laborum incididunt. Aliqua qui id do esse sunt eiusmod id deserunt eu nostrud aute sit ipsum. Deserunt esse cillum Lorem non magna adipisicing mollit amet consequat.</p>
+
+
+ Post 2
+ http://localhost:1313/posts/post-2/
+ Wed, 15 Feb 2023 10:00:00 -0700
+ http://localhost:1313/posts/post-2/
+ <p>Anim eiusmod irure incididunt sint cupidatat. Incididunt irure irure irure nisi ipsum do ut quis fugiat consectetur proident cupidatat incididunt cillum. Dolore voluptate occaecat qui mollit laborum ullamco et. Ipsum laboris officia anim laboris culpa eiusmod ex magna ex cupidatat anim ipsum aute. Mollit aliquip occaecat qui sunt velit ut cupidatat reprehenderit enim sunt laborum. Velit veniam in officia nulla adipisicing ut duis officia.</p>
<p>Exercitation voluptate irure in irure tempor mollit Lorem nostrud ad officia. Velit id fugiat occaecat do tempor. Sit officia Lorem aliquip eu deserunt consectetur. Aute proident deserunt in nulla aliquip dolore ipsum Lorem ut cupidatat consectetur sit sint laborum. Esse cupidatat sit sint sunt tempor exercitation deserunt. Labore dolor duis laborum est do nisi ut veniam dolor et nostrud nostrud.</p>
+
+
+ Post 1
+ http://localhost:1313/posts/post-1/
+ Sun, 15 Jan 2023 09:00:00 -0700
+ http://localhost:1313/posts/post-1/
+ <p>Tempor proident minim aliquip reprehenderit dolor et ad anim Lorem duis sint eiusmod. Labore ut ea duis dolor. Incididunt consectetur proident qui occaecat incididunt do nisi Lorem. Tempor do laborum elit laboris excepteur eiusmod do. Eiusmod nisi excepteur ut amet pariatur adipisicing Lorem.</p>
<p>Occaecat nulla excepteur dolore excepteur duis eiusmod ullamco officia anim in voluptate ea occaecat officia. Cillum sint esse velit ea officia minim fugiat. Elit ea esse id aliquip pariatur cupidatat id duis minim incididunt ea ea. Anim ut duis sunt nisi. Culpa cillum sit voluptate voluptate eiusmod dolor. Enim nisi Lorem ipsum irure est excepteur voluptate eu in enim nisi. Nostrud ipsum Lorem anim sint labore consequat do.</p>
+
+
+
diff --git a/public/js/main.js b/public/js/main.js
new file mode 100644
index 0000000..dd7dc87
--- /dev/null
+++ b/public/js/main.js
@@ -0,0 +1,4 @@
+(() => {
+ //
+ console.log("This site was generated by Hugo.");
+})();
diff --git a/public/posts/hard-problem/index.html b/public/posts/hard-problem/index.html
new file mode 100644
index 0000000..c7626f3
--- /dev/null
+++ b/public/posts/hard-problem/index.html
@@ -0,0 +1,81 @@
+
+
+
+
+
+Hard Problem: Invalidating the browser cache | My New Hugo Site
+
+
+
+
+
+
+
+
+
+
+
I pushed some changes incorporating images for the first time (I know, very swish), and everything seemed to be working just fine, but when I loaded the production site in Firefox, the images were not styled. Stranger still, they were styled when I loaded the same page in Chrome.
+
The experienced computer touchers amongst you will be saying “this is obviously a cache problem”, and you’re right, it is obviously a cache problem. Pressing CTR + SHIFT + R (which forces Firefox to clear the cache and do a full reload) proved this thesis, and solved the problem handily for me, on my machine. But what about other people’s machines?
+
Invalidating cached HTML
+
The best way to deal with this problem is to tell the browser not to cache our HTML in the first place. We can achieve this by adding the following meta tag to index.html, and any other HTML files we don’t want cached.
+
<metahttp-equiv="pragma"content="no-cache" />
+
Invalidating cached CSS
+
A quick google search revealed that the best way to invalidate browser cache is by changing the url of the file you’re telling it to load. So we would change this:
and the browser would recognize this as new file and load it from the server. Problem solved! Of course, you would have to change the file name too…
+
mv css/defaults.css css/defaults-2.css
+
… and this would get tedious very quickly. Furthermore, it’s going to make a mess of your version history if, as far as Git is concerned, you’re deleting the CSS file and writing a new one with every deployment. Surely there’s a better way?
As we’re requesting the file via http, we can append a query. Awesome. Not awesome enough though. I’m too lazy to do this every time I push a commit, and, being human, I’ll probably forget at a critical moment. This can only mean one thing. It’s time to bash (🤣) out a quick build script!
Let’s talk real quick about what’s happening here:
+
COMMIT="$(git rev-parse HEAD)" gets the commit id from Git and assigns it the variable $COMMIT.
+
Then, sed -i "s/css?=\w*/css?v=${COMMIT}/g" index.html does a find and replace on index.html. The regular expression css?=\w* matches ‘css?=’ plus any number of contiguous alphanumeric characters (everything until the next quote mark, basically) before replacing these alphanumeric characters with the commit id. The flag -i tells sed to edit the file in place. The g tells it to perform the operation on the whole file.
+
Now, whenever we push a new commit, any CSS imports in index.html will be changed to something like this:
There’s just one thing bugging me: surely I do actually want the CSS to be cached sometimes. Caching exists for a reason, and I don’t want to sacrifice performance. Maybe I can modify the build script so that it only updates the CSS imports when the CSS files have changed… Sounds like a topic for another blogpost!
+
+
+
+
+
+
+
+
diff --git a/public/posts/index.html b/public/posts/index.html
new file mode 100644
index 0000000..50d7c37
--- /dev/null
+++ b/public/posts/index.html
@@ -0,0 +1,69 @@
+
+
+
+
+
+Posts | My New Hugo Site
+
+
+
+
+
+
+
+
+
+
+
My New Hugo Site
+
+
+
+
+
+
+
+
Posts
+
Tempor est exercitation ad qui pariatur quis adipisicing aliquip nisi ea consequat ipsum occaecat. Nostrud consequat ullamco laboris fugiat esse esse adipisicing velit laborum ipsum incididunt ut enim. Dolor pariatur nulla quis fugiat dolore excepteur. Aliquip ad quis aliqua enim do consequat.
I pushed some changes incorporating images for the first time (I know, very swish), and everything seemed to be working just fine, but when I loaded the production site in Firefox, the images were not styled. Stranger still, they were styled when I loaded the same page in Chrome.
+
The experienced computer touchers amongst you will be saying “this is obviously a cache problem”, and you’re right, it is obviously a cache problem. Pressing CTR + SHIFT + R (which forces Firefox to clear the cache and do a full reload) proved this thesis, and solved the problem handily for me, on my machine. But what about other people’s machines?
Configuring Apache really isn’t rocket science. There are a wealth of great tutorials online, the documentation is very well documented, and the defaults work more or less out of the box. But it’s one of those jobs that I do just infrequently enough that I always forget things in the interim, and end up making the same old mistakes.
Occaecat aliqua consequat laborum ut ex aute aliqua culpa quis irure esse magna dolore quis. Proident fugiat labore eu laboris officia Lorem enim. Ipsum occaecat cillum ut tempor id sint aliqua incididunt nisi incididunt reprehenderit. Voluptate ad minim sint est aute aliquip esse occaecat tempor officia qui sunt. Aute ex ipsum id ut in est velit est laborum incididunt. Aliqua qui id do esse sunt eiusmod id deserunt eu nostrud aute sit ipsum. Deserunt esse cillum Lorem non magna adipisicing mollit amet consequat.
Anim eiusmod irure incididunt sint cupidatat. Incididunt irure irure irure nisi ipsum do ut quis fugiat consectetur proident cupidatat incididunt cillum. Dolore voluptate occaecat qui mollit laborum ullamco et. Ipsum laboris officia anim laboris culpa eiusmod ex magna ex cupidatat anim ipsum aute. Mollit aliquip occaecat qui sunt velit ut cupidatat reprehenderit enim sunt laborum. Velit veniam in officia nulla adipisicing ut duis officia.
+
Exercitation voluptate irure in irure tempor mollit Lorem nostrud ad officia. Velit id fugiat occaecat do tempor. Sit officia Lorem aliquip eu deserunt consectetur. Aute proident deserunt in nulla aliquip dolore ipsum Lorem ut cupidatat consectetur sit sint laborum. Esse cupidatat sit sint sunt tempor exercitation deserunt. Labore dolor duis laborum est do nisi ut veniam dolor et nostrud nostrud.
Tempor proident minim aliquip reprehenderit dolor et ad anim Lorem duis sint eiusmod. Labore ut ea duis dolor. Incididunt consectetur proident qui occaecat incididunt do nisi Lorem. Tempor do laborum elit laboris excepteur eiusmod do. Eiusmod nisi excepteur ut amet pariatur adipisicing Lorem.
+
Occaecat nulla excepteur dolore excepteur duis eiusmod ullamco officia anim in voluptate ea occaecat officia. Cillum sint esse velit ea officia minim fugiat. Elit ea esse id aliquip pariatur cupidatat id duis minim incididunt ea ea. Anim ut duis sunt nisi. Culpa cillum sit voluptate voluptate eiusmod dolor. Enim nisi Lorem ipsum irure est excepteur voluptate eu in enim nisi. Nostrud ipsum Lorem anim sint labore consequat do.
+
+
+
+
+
+
diff --git a/public/posts/index.xml b/public/posts/index.xml
new file mode 100644
index 0000000..7941845
--- /dev/null
+++ b/public/posts/index.xml
@@ -0,0 +1,47 @@
+
+
+
+ Posts on My New Hugo Site
+ http://localhost:1313/posts/
+ Recent content in Posts on My New Hugo Site
+ Hugo
+ en-us
+ Wed, 13 Nov 2024 14:24:21 +0100
+
+
+ Hard Problem: Invalidating the browser cache
+ http://localhost:1313/posts/hard-problem/
+ Wed, 13 Nov 2024 14:24:21 +0100
+ http://localhost:1313/posts/hard-problem/
+ <p><strong>I had a bit of an issue with my <a href="https://demos.ajstepien.xyz">website</a> recently.</strong></p>
<p>I pushed some changes incorporating images for the first time (I know, very swish), and everything seemed to be working just fine, but when I loaded the production site in Firefox, the images were not styled. Stranger still, they <em>were</em> styled when I loaded the same page in Chrome.</p>
<p>The experienced computer touchers amongst you will be saying “this is obviously a cache problem”, and you’re right, it is obviously a cache problem. Pressing <code>CTR + SHIFT + R</code> (which forces Firefox to clear the cache and do a full reload) proved this thesis, and solved the problem handily for me, on my machine. But what about other people’s machines?</p>
+
+
+ Permissions Strike Again
+ http://localhost:1313/posts/permissions-strike-again/
+ Wed, 13 Nov 2024 11:53:13 +0100
+ http://localhost:1313/posts/permissions-strike-again/
+ <h1 id="its-always-permissions">It’s always permissions</h1>
<p>Configuring Apache really isn’t rocket science. There are a wealth of great tutorials online, the documentation is very well documented, and the defaults work more or less out of the box. But it’s one of those jobs that I do just infrequently enough that I always forget things in the interim, and end up making the same old mistakes.</p>
<p><strong>And it almost always has to do with permissions.</strong></p>
+
+
+ Post 3
+ http://localhost:1313/posts/post-3/
+ Wed, 15 Mar 2023 11:00:00 -0700
+ http://localhost:1313/posts/post-3/
+ <p>Occaecat aliqua consequat laborum ut ex aute aliqua culpa quis irure esse magna dolore quis. Proident fugiat labore eu laboris officia Lorem enim. Ipsum occaecat cillum ut tempor id sint aliqua incididunt nisi incididunt reprehenderit. Voluptate ad minim sint est aute aliquip esse occaecat tempor officia qui sunt. Aute ex ipsum id ut in est velit est laborum incididunt. Aliqua qui id do esse sunt eiusmod id deserunt eu nostrud aute sit ipsum. Deserunt esse cillum Lorem non magna adipisicing mollit amet consequat.</p>
+
+
+ Post 2
+ http://localhost:1313/posts/post-2/
+ Wed, 15 Feb 2023 10:00:00 -0700
+ http://localhost:1313/posts/post-2/
+ <p>Anim eiusmod irure incididunt sint cupidatat. Incididunt irure irure irure nisi ipsum do ut quis fugiat consectetur proident cupidatat incididunt cillum. Dolore voluptate occaecat qui mollit laborum ullamco et. Ipsum laboris officia anim laboris culpa eiusmod ex magna ex cupidatat anim ipsum aute. Mollit aliquip occaecat qui sunt velit ut cupidatat reprehenderit enim sunt laborum. Velit veniam in officia nulla adipisicing ut duis officia.</p>
<p>Exercitation voluptate irure in irure tempor mollit Lorem nostrud ad officia. Velit id fugiat occaecat do tempor. Sit officia Lorem aliquip eu deserunt consectetur. Aute proident deserunt in nulla aliquip dolore ipsum Lorem ut cupidatat consectetur sit sint laborum. Esse cupidatat sit sint sunt tempor exercitation deserunt. Labore dolor duis laborum est do nisi ut veniam dolor et nostrud nostrud.</p>
+
+
+ Post 1
+ http://localhost:1313/posts/post-1/
+ Sun, 15 Jan 2023 09:00:00 -0700
+ http://localhost:1313/posts/post-1/
+ <p>Tempor proident minim aliquip reprehenderit dolor et ad anim Lorem duis sint eiusmod. Labore ut ea duis dolor. Incididunt consectetur proident qui occaecat incididunt do nisi Lorem. Tempor do laborum elit laboris excepteur eiusmod do. Eiusmod nisi excepteur ut amet pariatur adipisicing Lorem.</p>
<p>Occaecat nulla excepteur dolore excepteur duis eiusmod ullamco officia anim in voluptate ea occaecat officia. Cillum sint esse velit ea officia minim fugiat. Elit ea esse id aliquip pariatur cupidatat id duis minim incididunt ea ea. Anim ut duis sunt nisi. Culpa cillum sit voluptate voluptate eiusmod dolor. Enim nisi Lorem ipsum irure est excepteur voluptate eu in enim nisi. Nostrud ipsum Lorem anim sint labore consequat do.</p>
+
+
+
diff --git a/public/posts/permissions-strike-again/index.html b/public/posts/permissions-strike-again/index.html
new file mode 100644
index 0000000..6c2d7bb
--- /dev/null
+++ b/public/posts/permissions-strike-again/index.html
@@ -0,0 +1,71 @@
+
+
+
+
+
+Permissions Strike Again | My New Hugo Site
+
+
+
+
+
+
+
+
+
+
+
My New Hugo Site
+
+
+
+
+
+
+
+
Permissions Strike Again
+
+
+
+
+
+
It’s always permissions
+
Configuring Apache really isn’t rocket science. There are a wealth of great tutorials online, the documentation is very well documented, and the defaults work more or less out of the box. But it’s one of those jobs that I do just infrequently enough that I always forget things in the interim, and end up making the same old mistakes.
+
And it almost always has to do with permissions.
+
So, I’m writing this post both as a means of christening this devlog (Hi! I’m Andrzej! Hire me!) and also as a reminder to myself that the home folder is not executable by default.
+
Please, Andrzej. Please. The next time you’re building a website, be it for a client or for yourself, and you find yourself scratching your head, wondering what error you may have made in the .confs, checking the permissions of your symlink again and again, ask yourself: is my symlink pointing to a directory in the home folder? Because Apache can’t open the home folder until you change the permissions!
+
What?
+
In Linux we open directories by ’executing’ them. A directory is an executable that lists part of file-system for us, basically. Now, by default, the home directory is only executable by its owner. This makes sense when you think about it – you don’t want your sister, or co-worker, or (more likely) whatever barely-audited application you’re installing today, to be able to open that directory. But you probably do want your webserver to be able to open it, especially if you are symlinking to it from /var/www.
+
Hugo (the framework I’m using to build this blog) likes to deploy to the home directory by default. In fact there are lots of reasons why you’d want to deploy there. I do this exact same thing with Jenkins, and I wasted an hour troubleshooting this exact same problem when I set up that server too.
+
So, Andrzej of the future (did anyone non-ghoulish win an election yet?), for future reference, let’s say you’re deploying to /home/devlog/website:
+
+
Add Apache to the ‘devlog’ user group.
+
+
sudo usermod -aG devlog www-data
+
+
Change the permissions on /home/devlog to allow group members to open it.
+
+
sudo chmod 710 /home/devlog
+
IT’S THAT EASY.
+
+
+
+
+
+
+
+
diff --git a/public/posts/post-1/index.html b/public/posts/post-1/index.html
new file mode 100644
index 0000000..3530de5
--- /dev/null
+++ b/public/posts/post-1/index.html
@@ -0,0 +1,61 @@
+
+
+
+
+
+Post 1 | My New Hugo Site
+
+
+
+
+
+
+
+
+
+
+
My New Hugo Site
+
+
+
+
+
+
+
+
Post 1
+
+
+
+
+
+
Tempor proident minim aliquip reprehenderit dolor et ad anim Lorem duis sint eiusmod. Labore ut ea duis dolor. Incididunt consectetur proident qui occaecat incididunt do nisi Lorem. Tempor do laborum elit laboris excepteur eiusmod do. Eiusmod nisi excepteur ut amet pariatur adipisicing Lorem.
+
Occaecat nulla excepteur dolore excepteur duis eiusmod ullamco officia anim in voluptate ea occaecat officia. Cillum sint esse velit ea officia minim fugiat. Elit ea esse id aliquip pariatur cupidatat id duis minim incididunt ea ea. Anim ut duis sunt nisi. Culpa cillum sit voluptate voluptate eiusmod dolor. Enim nisi Lorem ipsum irure est excepteur voluptate eu in enim nisi. Nostrud ipsum Lorem anim sint labore consequat do.
+
+
+
+
+
+
diff --git a/public/posts/post-2/index.html b/public/posts/post-2/index.html
new file mode 100644
index 0000000..2e77b60
--- /dev/null
+++ b/public/posts/post-2/index.html
@@ -0,0 +1,62 @@
+
+
+
+
+
+Post 2 | My New Hugo Site
+
+
+
+
+
+
+
+
+
+
+
My New Hugo Site
+
+
+
+
+
+
+
+
Post 2
+
+
+
+
+
+
Anim eiusmod irure incididunt sint cupidatat. Incididunt irure irure irure nisi ipsum do ut quis fugiat consectetur proident cupidatat incididunt cillum. Dolore voluptate occaecat qui mollit laborum ullamco et. Ipsum laboris officia anim laboris culpa eiusmod ex magna ex cupidatat anim ipsum aute. Mollit aliquip occaecat qui sunt velit ut cupidatat reprehenderit enim sunt laborum. Velit veniam in officia nulla adipisicing ut duis officia.
+
Exercitation voluptate irure in irure tempor mollit Lorem nostrud ad officia. Velit id fugiat occaecat do tempor. Sit officia Lorem aliquip eu deserunt consectetur. Aute proident deserunt in nulla aliquip dolore ipsum Lorem ut cupidatat consectetur sit sint laborum. Esse cupidatat sit sint sunt tempor exercitation deserunt. Labore dolor duis laborum est do nisi ut veniam dolor et nostrud nostrud.
+
+
+
+
+
+
diff --git a/public/posts/post-3/bryce-canyon.jpg b/public/posts/post-3/bryce-canyon.jpg
new file mode 100644
index 0000000..9a923be
Binary files /dev/null and b/public/posts/post-3/bryce-canyon.jpg differ
diff --git a/public/posts/post-3/index.html b/public/posts/post-3/index.html
new file mode 100644
index 0000000..d6ecda0
--- /dev/null
+++ b/public/posts/post-3/index.html
@@ -0,0 +1,64 @@
+
+
+
+
+
+Post 3 | My New Hugo Site
+
+
+
+
+
+
+
+
+
+
+
My New Hugo Site
+
+
+
+
+
+
+
+
Post 3
+
+
+
+
+
+
Occaecat aliqua consequat laborum ut ex aute aliqua culpa quis irure esse magna dolore quis. Proident fugiat labore eu laboris officia Lorem enim. Ipsum occaecat cillum ut tempor id sint aliqua incididunt nisi incididunt reprehenderit. Voluptate ad minim sint est aute aliquip esse occaecat tempor officia qui sunt. Aute ex ipsum id ut in est velit est laborum incididunt. Aliqua qui id do esse sunt eiusmod id deserunt eu nostrud aute sit ipsum. Deserunt esse cillum Lorem non magna adipisicing mollit amet consequat.
+
+
Sit excepteur do velit veniam mollit in nostrud laboris incididunt ea. Amet eu cillum ut reprehenderit culpa aliquip labore laborum amet sit sit duis. Laborum id proident nostrud dolore laborum reprehenderit quis mollit nulla amet veniam officia id id. Aliquip in deserunt qui magna duis qui pariatur officia sunt deserunt.
Occaecat aliqua consequat laborum ut ex aute aliqua culpa quis irure esse magna dolore quis. Proident fugiat labore eu laboris officia Lorem enim. Ipsum occaecat cillum ut tempor id sint aliqua incididunt nisi incididunt reprehenderit. Voluptate ad minim sint est aute aliquip esse occaecat tempor officia qui sunt. Aute ex ipsum id ut in est velit est laborum incididunt. Aliqua qui id do esse sunt eiusmod id deserunt eu nostrud aute sit ipsum. Deserunt esse cillum Lorem non magna adipisicing mollit amet consequat.
+
+
+
+
+
+
diff --git a/public/tags/blue/index.xml b/public/tags/blue/index.xml
new file mode 100644
index 0000000..aee0e76
--- /dev/null
+++ b/public/tags/blue/index.xml
@@ -0,0 +1,19 @@
+
+
+
+ Blue on My New Hugo Site
+ http://localhost:1313/tags/blue/
+ Recent content in Blue on My New Hugo Site
+ Hugo
+ en-us
+ Wed, 15 Mar 2023 11:00:00 -0700
+
+
+ Post 3
+ http://localhost:1313/posts/post-3/
+ Wed, 15 Mar 2023 11:00:00 -0700
+ http://localhost:1313/posts/post-3/
+ <p>Occaecat aliqua consequat laborum ut ex aute aliqua culpa quis irure esse magna dolore quis. Proident fugiat labore eu laboris officia Lorem enim. Ipsum occaecat cillum ut tempor id sint aliqua incididunt nisi incididunt reprehenderit. Voluptate ad minim sint est aute aliquip esse occaecat tempor officia qui sunt. Aute ex ipsum id ut in est velit est laborum incididunt. Aliqua qui id do esse sunt eiusmod id deserunt eu nostrud aute sit ipsum. Deserunt esse cillum Lorem non magna adipisicing mollit amet consequat.</p>
+
+
+
diff --git a/public/tags/green/index.html b/public/tags/green/index.html
new file mode 100644
index 0000000..6529e43
--- /dev/null
+++ b/public/tags/green/index.html
@@ -0,0 +1,54 @@
+
+
+
+
+
+Green | My New Hugo Site
+
+
+
+
+
+
+
+
+
+
+
Occaecat aliqua consequat laborum ut ex aute aliqua culpa quis irure esse magna dolore quis. Proident fugiat labore eu laboris officia Lorem enim. Ipsum occaecat cillum ut tempor id sint aliqua incididunt nisi incididunt reprehenderit. Voluptate ad minim sint est aute aliquip esse occaecat tempor officia qui sunt. Aute ex ipsum id ut in est velit est laborum incididunt. Aliqua qui id do esse sunt eiusmod id deserunt eu nostrud aute sit ipsum. Deserunt esse cillum Lorem non magna adipisicing mollit amet consequat.
Anim eiusmod irure incididunt sint cupidatat. Incididunt irure irure irure nisi ipsum do ut quis fugiat consectetur proident cupidatat incididunt cillum. Dolore voluptate occaecat qui mollit laborum ullamco et. Ipsum laboris officia anim laboris culpa eiusmod ex magna ex cupidatat anim ipsum aute. Mollit aliquip occaecat qui sunt velit ut cupidatat reprehenderit enim sunt laborum. Velit veniam in officia nulla adipisicing ut duis officia.
+
Exercitation voluptate irure in irure tempor mollit Lorem nostrud ad officia. Velit id fugiat occaecat do tempor. Sit officia Lorem aliquip eu deserunt consectetur. Aute proident deserunt in nulla aliquip dolore ipsum Lorem ut cupidatat consectetur sit sint laborum. Esse cupidatat sit sint sunt tempor exercitation deserunt. Labore dolor duis laborum est do nisi ut veniam dolor et nostrud nostrud.
+
+
+
+
+
+
diff --git a/public/tags/green/index.xml b/public/tags/green/index.xml
new file mode 100644
index 0000000..4d5f10b
--- /dev/null
+++ b/public/tags/green/index.xml
@@ -0,0 +1,26 @@
+
+
+
+ Green on My New Hugo Site
+ http://localhost:1313/tags/green/
+ Recent content in Green on My New Hugo Site
+ Hugo
+ en-us
+ Wed, 15 Mar 2023 11:00:00 -0700
+
+
+ Post 3
+ http://localhost:1313/posts/post-3/
+ Wed, 15 Mar 2023 11:00:00 -0700
+ http://localhost:1313/posts/post-3/
+ <p>Occaecat aliqua consequat laborum ut ex aute aliqua culpa quis irure esse magna dolore quis. Proident fugiat labore eu laboris officia Lorem enim. Ipsum occaecat cillum ut tempor id sint aliqua incididunt nisi incididunt reprehenderit. Voluptate ad minim sint est aute aliquip esse occaecat tempor officia qui sunt. Aute ex ipsum id ut in est velit est laborum incididunt. Aliqua qui id do esse sunt eiusmod id deserunt eu nostrud aute sit ipsum. Deserunt esse cillum Lorem non magna adipisicing mollit amet consequat.</p>
+
+
+ Post 2
+ http://localhost:1313/posts/post-2/
+ Wed, 15 Feb 2023 10:00:00 -0700
+ http://localhost:1313/posts/post-2/
+ <p>Anim eiusmod irure incididunt sint cupidatat. Incididunt irure irure irure nisi ipsum do ut quis fugiat consectetur proident cupidatat incididunt cillum. Dolore voluptate occaecat qui mollit laborum ullamco et. Ipsum laboris officia anim laboris culpa eiusmod ex magna ex cupidatat anim ipsum aute. Mollit aliquip occaecat qui sunt velit ut cupidatat reprehenderit enim sunt laborum. Velit veniam in officia nulla adipisicing ut duis officia.</p>
<p>Exercitation voluptate irure in irure tempor mollit Lorem nostrud ad officia. Velit id fugiat occaecat do tempor. Sit officia Lorem aliquip eu deserunt consectetur. Aute proident deserunt in nulla aliquip dolore ipsum Lorem ut cupidatat consectetur sit sint laborum. Esse cupidatat sit sint sunt tempor exercitation deserunt. Labore dolor duis laborum est do nisi ut veniam dolor et nostrud nostrud.</p>
+
+
+
diff --git a/public/tags/index.html b/public/tags/index.html
new file mode 100644
index 0000000..1b4310f
--- /dev/null
+++ b/public/tags/index.html
@@ -0,0 +1,56 @@
+
+
+
+
+
+Tags | My New Hugo Site
+
+
+
+
+
+
+
+
+
+
+
Occaecat aliqua consequat laborum ut ex aute aliqua culpa quis irure esse magna dolore quis. Proident fugiat labore eu laboris officia Lorem enim. Ipsum occaecat cillum ut tempor id sint aliqua incididunt nisi incididunt reprehenderit. Voluptate ad minim sint est aute aliquip esse occaecat tempor officia qui sunt. Aute ex ipsum id ut in est velit est laborum incididunt. Aliqua qui id do esse sunt eiusmod id deserunt eu nostrud aute sit ipsum. Deserunt esse cillum Lorem non magna adipisicing mollit amet consequat.
Anim eiusmod irure incididunt sint cupidatat. Incididunt irure irure irure nisi ipsum do ut quis fugiat consectetur proident cupidatat incididunt cillum. Dolore voluptate occaecat qui mollit laborum ullamco et. Ipsum laboris officia anim laboris culpa eiusmod ex magna ex cupidatat anim ipsum aute. Mollit aliquip occaecat qui sunt velit ut cupidatat reprehenderit enim sunt laborum. Velit veniam in officia nulla adipisicing ut duis officia.
+
Exercitation voluptate irure in irure tempor mollit Lorem nostrud ad officia. Velit id fugiat occaecat do tempor. Sit officia Lorem aliquip eu deserunt consectetur. Aute proident deserunt in nulla aliquip dolore ipsum Lorem ut cupidatat consectetur sit sint laborum. Esse cupidatat sit sint sunt tempor exercitation deserunt. Labore dolor duis laborum est do nisi ut veniam dolor et nostrud nostrud.
Tempor proident minim aliquip reprehenderit dolor et ad anim Lorem duis sint eiusmod. Labore ut ea duis dolor. Incididunt consectetur proident qui occaecat incididunt do nisi Lorem. Tempor do laborum elit laboris excepteur eiusmod do. Eiusmod nisi excepteur ut amet pariatur adipisicing Lorem.
+
Occaecat nulla excepteur dolore excepteur duis eiusmod ullamco officia anim in voluptate ea occaecat officia. Cillum sint esse velit ea officia minim fugiat. Elit ea esse id aliquip pariatur cupidatat id duis minim incididunt ea ea. Anim ut duis sunt nisi. Culpa cillum sit voluptate voluptate eiusmod dolor. Enim nisi Lorem ipsum irure est excepteur voluptate eu in enim nisi. Nostrud ipsum Lorem anim sint labore consequat do.
+
+
+
+
+
+
diff --git a/public/tags/red/index.xml b/public/tags/red/index.xml
new file mode 100644
index 0000000..91982eb
--- /dev/null
+++ b/public/tags/red/index.xml
@@ -0,0 +1,33 @@
+
+
+
+ Red on My New Hugo Site
+ http://localhost:1313/tags/red/
+ Recent content in Red on My New Hugo Site
+ Hugo
+ en-us
+ Wed, 15 Mar 2023 11:00:00 -0700
+
+
+ Post 3
+ http://localhost:1313/posts/post-3/
+ Wed, 15 Mar 2023 11:00:00 -0700
+ http://localhost:1313/posts/post-3/
+ <p>Occaecat aliqua consequat laborum ut ex aute aliqua culpa quis irure esse magna dolore quis. Proident fugiat labore eu laboris officia Lorem enim. Ipsum occaecat cillum ut tempor id sint aliqua incididunt nisi incididunt reprehenderit. Voluptate ad minim sint est aute aliquip esse occaecat tempor officia qui sunt. Aute ex ipsum id ut in est velit est laborum incididunt. Aliqua qui id do esse sunt eiusmod id deserunt eu nostrud aute sit ipsum. Deserunt esse cillum Lorem non magna adipisicing mollit amet consequat.</p>
+
+
+ Post 2
+ http://localhost:1313/posts/post-2/
+ Wed, 15 Feb 2023 10:00:00 -0700
+ http://localhost:1313/posts/post-2/
+ <p>Anim eiusmod irure incididunt sint cupidatat. Incididunt irure irure irure nisi ipsum do ut quis fugiat consectetur proident cupidatat incididunt cillum. Dolore voluptate occaecat qui mollit laborum ullamco et. Ipsum laboris officia anim laboris culpa eiusmod ex magna ex cupidatat anim ipsum aute. Mollit aliquip occaecat qui sunt velit ut cupidatat reprehenderit enim sunt laborum. Velit veniam in officia nulla adipisicing ut duis officia.</p>
<p>Exercitation voluptate irure in irure tempor mollit Lorem nostrud ad officia. Velit id fugiat occaecat do tempor. Sit officia Lorem aliquip eu deserunt consectetur. Aute proident deserunt in nulla aliquip dolore ipsum Lorem ut cupidatat consectetur sit sint laborum. Esse cupidatat sit sint sunt tempor exercitation deserunt. Labore dolor duis laborum est do nisi ut veniam dolor et nostrud nostrud.</p>
+
+
+ Post 1
+ http://localhost:1313/posts/post-1/
+ Sun, 15 Jan 2023 09:00:00 -0700
+ http://localhost:1313/posts/post-1/
+ <p>Tempor proident minim aliquip reprehenderit dolor et ad anim Lorem duis sint eiusmod. Labore ut ea duis dolor. Incididunt consectetur proident qui occaecat incididunt do nisi Lorem. Tempor do laborum elit laboris excepteur eiusmod do. Eiusmod nisi excepteur ut amet pariatur adipisicing Lorem.</p>
<p>Occaecat nulla excepteur dolore excepteur duis eiusmod ullamco officia anim in voluptate ea occaecat officia. Cillum sint esse velit ea officia minim fugiat. Elit ea esse id aliquip pariatur cupidatat id duis minim incididunt ea ea. Anim ut duis sunt nisi. Culpa cillum sit voluptate voluptate eiusmod dolor. Enim nisi Lorem ipsum irure est excepteur voluptate eu in enim nisi. Nostrud ipsum Lorem anim sint labore consequat do.</p>
+
+
+
