Putting READMEs on your Static Site

TL;DR I’m happy to introduce RISS (README In Static Site), a tool that transform a README like this one and insert it on your website, like so. A README is a Project’s Cover Your GitHub README is what your visitors on GitHub will encounter first. Thus, it needs to efficiently describe your project. There are a lot of advice online on how to craft a great README. So you then go on and create a great README....

September 23, 2021 · 3 min

Configuration Management

TL;DR Chezmoi follows a declarative approach to configuration management. Even if you already use a configuration-management system, you should check out how it compares! A Custom Configuration Makes You Feel at Home Your git aliases, shell setup, keyboard shortcuts and even your favorite fonts are tweaked for your own needs and tastes. It’s part of what makes your computer, your computer. All this configuration evolves over years and is slowly refined over time....

September 3, 2021 · 4 min

README In Static Site (RISS)

 cljoly/readme-in-static-site This fast script allows you to insert your GitHub README in your static site and apply transformations. For instance, you can read this README on GitHub and on my website. Why? The GitHub README of your repo needs to efficiently describe your project to GitHub’s visitor. But featuring your project on your website allows you to (among other things): have more control on the theme and layout, insert scripts that GitHub would prohibit (like asciinema), have your project’s homepage independent of your hosting platform, if you wish to change at some point....

How I Got Started with NeoVim’s Lua Configuration

Four months ago I was still using SpaceVim when I stambled upon a blog post on how to configure NeoVim with Lua. I then started to create my own configuration. In this post I’ll share the learnings acquired in the process. I hope you will find this useful to create your own configuration! Why create your own Vim config from scratch? Vim has been my daily driver for about ten years....

July 18, 2021 · 9 min