full-stop

full-stop

My once-private tech blog. Uses a revived version of Naringu, a dark theme for Jekyll.

praepunctis + Naringu

This is a small blog built using a revived version of Naringu, a dark Jekyll theme.

How to Update This Blog

  • Make a new markdown file in _posts/. Follow the rxisting format for naming, tags, etc.
  • As of 1/11/24, Github Pages deploys straight from main upon publish. This means that when a change is pushed to the main branch of this repo, it'll go live basically immediately.
    • This is convenient for now, but you may want to consider having Github Pages deploy from a different branch in the future, to add a buffer for spotting typos, etc.

How I Fixed Naringu

With no updates in the last few years, Naringu required a little work out of the box.

The crux of the problem was the deprecated relative permalink configuration setting.

  • All permalinks to posts/pages everywhere broke.
  • I updated the site.baseurl field in the _config.yml file.
  • I had to add a permalink: field to the front matter in each post, and fix broken links in the HTML code for various layouts (generated by paginator).

At the moment, things seem to work ok. Follow the existing front matter pattern for posts, and you should be good to go.

Naringu's original README is below.


Naringu

Naringu is dark jekyll theme that provide fully furnished jekyll setup, come with contact form, #6DD HTML color schema, and more features. It's based on Poole, the Jekyll butler.

Contents

Usage

Just download and start the Jekyll server or fork this repo.

Create a list of nav links in the sidebar by assigning each Jekyll page the correct layout in the page's front-matter.

---
layout: page
title: About
---

Why require a specific layout? Jekyll will return all pages, including the atom.xml, and with an alphabetical sort order. To ensure the first link is Home, we exclude the index.html page from this list by specifying the page

Reverse layout

Reverse the page orientation with a single class.

<body class="layout-reverse">
  ...
</body>

Contact Form

Using formspree to enable contact form in static site.

Go a head contact/index.html just change the email in the code

<form action="http://formspree.io/youremail@yourdomain.com" role="form" method="POST">

Comments

Using disqus to enable comments in static site.

Just edit variable disqus in _config.yml to your disqus link.

Development

Naringu come with two branches :.

  • master for active development.
  • gh-pages for preview of Naringu

Author

Rizky Ariestiyansyah

Contributors

Gildásio Júnior - a.k.a. @gjuniioor

License

Open sourced under the MIT license.

jekyll logo

Want a Jekyll website built?

Hire a Jekyll developer