summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorHombreLaser <buran@silosneeded.com>2025-06-18 19:32:09 -0600
committerHombreLaser <buran@silosneeded.com>2025-06-18 19:32:09 -0600
commitce7f8f9c3d3cfe0704e4b3d79a03b92ffba9aac3 (patch)
treead71a4c6583f62ee6f9adb75e7b985cb74f12344
parent85126d617b6edd3b96bb527559fe30cef196ce49 (diff)
Add apache jekyll tags article
-rw-r--r--_posts/en/2025-06-18-apache_jekyll_tags.md39
-rw-r--r--_posts/es/2025-06-18-apache_jekyll_tags.md42
2 files changed, 81 insertions, 0 deletions
diff --git a/_posts/en/2025-06-18-apache_jekyll_tags.md b/_posts/en/2025-06-18-apache_jekyll_tags.md
new file mode 100644
index 0000000..021fd1e
--- /dev/null
+++ b/_posts/en/2025-06-18-apache_jekyll_tags.md
@@ -0,0 +1,39 @@
+---
+layout: post
+title: "Fixing links to a jekyll-archive generated page in apache"
+lang: en
+date: 2025-06-18
+tags: ["Tutorials"]
+---
+
+As you can see, I've added a [page for navigating tags](/tags) on my site. For a couple of weeks it was broken though.
+
+This will be a simple post explaining how to fix this for posterity. Apache is at fault here: if you check your site's directory in `/var/www/html`,
+you'll see that Jekyll generates a directory with the following structure:
+
+```
+tags/
+|
+|-my_tag
+ |
+ |- index.html
+```
+<br>
+So the file we actually want to serve when someone navigates to `/tags/my_tag` is `/tags/my_tag/index.html`. Jekyll will usually link to the first
+route instead of the second one. And this is okay, the first URL is prettier and more restful and yadda-yadda than the second one.
+
+To fix this on Apache's side, we'll add the following rewrite rule:
+
+```apache
+<VirtualHost _default_:443>
+# Your site's config...
+ RewriteEngine On
+ # Perhaps some other rules...
+ RewriteRule ^/tags/(.+)$ %{DOCUMENT_ROOT}/tags/$1/index.html
+ # The rest of your config.
+</VirtualHost>
+```
+<br>
+That's it. Run `sudo systemctl reload apache2` if you're on Systemd to update your site and it should link correctly to every tag's page.
+
+P.S. yes, I took a rest of sorts on picoshock, working on it on and off. I hope I can have something (good or bad) to show for it the next week. Stay tuned.
diff --git a/_posts/es/2025-06-18-apache_jekyll_tags.md b/_posts/es/2025-06-18-apache_jekyll_tags.md
new file mode 100644
index 0000000..cde3151
--- /dev/null
+++ b/_posts/es/2025-06-18-apache_jekyll_tags.md
@@ -0,0 +1,42 @@
+---
+layout: post
+title: "Fixing links to a jekyll-archive generated page in apache"
+lang: en
+date: 2025-06-18
+tags: ["Tutoriales"]
+---
+
+Como han podido ver, he agregado una [página para navegar entre las etiquetas](/tags) en mi página. Aunque por un par de semanas no funcionaba.
+
+Este será un post simple explicando cómo arreglar esto, para la posteridad. La culpa es de Apache: si revisas el directorio de tu sitio en
+`/var/www/html`, verás que Jekyll genera un directorio con la siguiente estructura:
+
+```
+tags/
+|
+|-my_tag
+ |
+ |- index.html
+```
+<br>
+
+Así que el archivo que en realidad queremos servir cuando alguien navega a `/tags/my_tag` es `/tags/my_tag/index.html`. Jekyll usualmente enlazará
+a la primera ruta en vez de a la segunda. Y esto está bien, el primer URL está más bonito y es más restful y demás que el segundo.
+
+Para arreglar esto en el lado de Apache, agregaremos la siguiente _rewrite rule_:
+
+```apache
+<VirtualHost _default_:443>
+# Your site's config...
+ RewriteEngine On
+ # Perhaps some other rules...
+ RewriteRule ^/tags/(.+)$ %{DOCUMENT_ROOT}/tags/$1/index.html
+ # The rest of your config.
+</VirtualHost>
+```
+<br>
+Eso es todo. Ejecuta `sudo systemctl reload apache2` si usas Systemd para actualizar tu sitio y éste debería enlazar correctamente a la página de
+cada etiqueta.
+
+P.D. sí, tomé un descanso de picoshock, trabajando en él pausadamente. Espero tener algo (bueno o malo) para escribir otra entrada en el devlog la siguiente
+semana. Manténganse sintonizados.