From 9fb94c2549622b0b75e78a4cc2df041e8acc9e67 Mon Sep 17 00:00:00 2001 From: Ian Andwati Date: Sun, 27 Aug 2023 15:49:13 +0300 Subject: [PATCH] format article --- content/posts/a-fresh-coat-of-paint.md | 21 ++++++++++----------- 1 file changed, 10 insertions(+), 11 deletions(-) diff --git a/content/posts/a-fresh-coat-of-paint.md b/content/posts/a-fresh-coat-of-paint.md index f41b783..023380f 100644 --- a/content/posts/a-fresh-coat-of-paint.md +++ b/content/posts/a-fresh-coat-of-paint.md @@ -11,18 +11,17 @@ Using Zola as my preferred static site generator -After using Hugo for over eight months I got tired of it and looked for other alternatives. Thats when I stumbled upon Zola. -Zola is a static site generator (SSG), similar to [Hugo](https://gohugo.io/), [Pelican](https://blog.getpelican.com/), and [Jekyll](https://jekyllrb.com/). +After using Hugo for over eight months I got tired of it and looked for other alternatives. That's when I stumbled upon Zola. Zola is a static site generator (SSG), similar to [Hugo](https://gohugo.io/), [Pelican](https://blog.getpelican.com/), and [Jekyll](https://jekyllrb.com/). -It is written in Rust and uses the Tera template engine, which is similar to Jinja2, Django templates, Liquid, and Twig. SSGs use dynamic templates to transform content into static HTML pages. Static sites are thus very fast and require no databases, making them easy to host. +It is written in Rust and uses the Tera template engine, similar to Jinja2, Django templates, Liquid, and Twig. SSGs use dynamic templates to transform content into static HTML pages. Static sites are thus very fast and require no databases, making them easy to host. -My previous Hugo site used a theme because I wasn't really ready to learn Go's template engine. I'm already familiar with Python Django and its template system so using Tera wasn't hard because its similar to jinja2 and the Django template syntax. +My previous Hugo site used a theme because I wasn't really ready to learn Go's template engine. I'm already familiar with Python Django and its template system so using Tera wasn't hard because it's similar to jinja2 and the Django template syntax. -Content is written in [CommonMark](https://commonmark.org/), a strongly defined, highly compatible specification of [Markdown](https://www.markdownguide.org/). Zola uses [pulldown-cmark](https://github.com/raphlinus/pulldown-cmark#pulldown-cmark) to parse markdown files. The goal of this library is 100% compliance with the CommonMark spec. It adds a few additional features such as parsing footnotes, Github flavored tables, Github flavored task lists and strikethrough. +Content is written in [CommonMark](https://commonmark.org/), a strongly defined, highly compatible specification of [Markdown](https://www.markdownguide.org/). Zola uses [pulldown-cmark](https://github.com/raphlinus/pulldown-cmark#pulldown-cmark) to parse markdown files. The goal of this library is 100% compliance with the CommonMark spec. It adds a few additional features such as parsing footnotes, Github-flavored tables, Github-flavored task lists, and strikethrough. -Zola comes with built-in syntax highlighting but you first need to enable it in the configuration file. +Zola comes with built-in syntax highlighting, but you must first enable it in the configuration file. -Zola is very minimalistic, its installed only as a single binary, no extra dependencies needed. It is configured in `toml` and you only use what is needed. For example here is the configuration for this site `config.toml`: +Zola is very minimalistic, it is installed only as a single binary, with no extra dependencies needed. It is configured in `toml` and you only use what is needed. For example here is the configuration for this site `config.toml`: ```toml title = "Ian Andwati" @@ -49,12 +48,12 @@ author = "Ian Andwati" ## Inspiration -The motivation to use zola also came from my decision to move from independently developed themes. I decided to write the html and css myself and endeavour to maintain the site individually. The base css is borrowed from [Reilly Tucker Siemens](https://tuckersiemens.com/) who had created a nice gruvbox palette for his site. +The motivation to use Zola also came from my decision to move from independently developed themes. I decided to write the html and css myself and endeavor to maintain the site individually. The base CSS is borrowed from [Reilly Tucker Siemens](https://tuckersiemens.com/) who had created a nice gruvbox palette for his site. -I improved on it by adding an archive page, pagination, a comment system and google analytics(more of these in later posts). I also implemented article read time and word count. +I improved on it by adding an archive page, pagination, a comment system, and google analytics(more of these in later posts). I also implemented article read time and word count. ## What next -The site is a working progress and is far from polished. I plan on implementing a newsletter to notify readers of new posts. The site is primarily a dark theme, in the future Ill also add theme toggling and maybe different palettes. +The site is a working progress and is far from polished. I plan on implementing a newsletter to notify readers of new posts. The site is primarily a dark theme, in the future I'll also add theme toggling and maybe different palettes. -You can subscribe to the sites rss feed at [https://andwati.com/rss.xml](https://andwati.com/rss.xml). +You can subscribe to the site's RSS feed at [https://andwati.com/rss.xml](https://andwati.com/rss.xml). \ No newline at end of file