I was asked to write something how I am doing my blogging.

Here it is :-)

My blogging story

I started with some blogs at blogspot.com, later on I switched to wordpress.com and created this blog. Few years ago I started using markdown as my main notation for making documentation and notes in work and in private live.

Few months ago I heard about the Jekyll which is the recommended framework for GitHub Pages.

I installed Jekyll and created this blog page (at FreeBSD) .

sudo pkg install ruby ruby26-gems
sudo gem install bundler jekyll

jekyll new jacekkowalczyk82.github.io

cd jacekkowalczyk82.github.io
bundle install

My platform

If you would like more details about how I setup the jekyll at FreeBSD you can check this notes.

My workflow

  • I start usually with making some markdown notes.
  • When I decide that the topic and notes are complete I start new post in my blog repository
cd jacekkowalczyk82.github.io
bundle exec jekyll post "My blogging platform and workflow"

  • I edit the new generated post file with editor and write with markdown :-)

  • I am checking the resulting blog post with jekyll development server and web browser pointed to http://localhost:4000/:

bundle exec jekyll serve

  • When post is ready I commit it to my github blog repo.

  • Finally I am creating new post at my wordpress blog and adding link to the new github blog post.

  • That is it. End of story :-)

No, no, not the end - UPDATE

My blogging platform is still jekyll but I am doing it from many machines and OSs: Ubuntu, Antix, FreeBSD, sOpenBSD.

Install development environment for blogging with jekyll on OpenBSD

sudo pkg_add ruby


sudo gem27 install bundler jekyll
#gem27 install bundler jekyll
cd <jekyll blog repository>
bundle27 config set path 'vendor/bundle'
bundle27 install
bundle27 exec jekyll serve

# diff tool 
sudo pkg_add kompare

Install development environment for blogging with jekyll on Ubuntu 20.04

  • https://jekyllrb.com/docs/installation/ubuntu/
sudo apt-get install ruby-full build-essential zlib1g-dev

echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc
echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc
echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

gem install jekyll bundler
  • to install dependencies/gems required by this blog
cd jacekkowalczyk82.github.io
bundle install
  • to start jekyll server
bundle exec jekyll serve
  • to create a new post
bundle exec jekyll post "My new post title"