This is a small blog built using a revived version of Naringu, a dark Jekyll theme.
- 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 themain
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.
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 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.
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 the page orientation with a single class.
<body class="layout-reverse">
...
</body>
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">
Using disqus to enable comments in static site.
Just edit variable disqus
in _config.yml
to your disqus link.
Naringu come with two branches :.
master
for active development.gh-pages
for preview of Naringu
Rizky Ariestiyansyah
Gildásio Júnior - a.k.a. @gjuniioor
Open sourced under the MIT license.