- a developer, foodie, and generally a passionate human by heart.
- Intrigued by concept docs-as-code/docs like code, content-as-a-service
It was about time…
- getting ownership and control back from social medias like Facebook and Instagram.
- Now it’s my content and ownership and social media is just a platform for sharing mine
Last but not least…
- following my passions, sharing my notes for the ones it may help, and
- finding, getting connected, and share interests and thoughts with you !
- Sign up at GitHub.com
- There are about ~10 GitHub themes. More to find here: http://jekyllthemes.org
- My selected theme is TaylanTatli’s Moon theme
As described on GitHub pages you can setup an
- user site,
- organization site, or a
- project site.
In my case I go for a project site, namely ‘software-developer.org’. Its project repo goes to my GitHub user account. Since I prefer using git instead of clicking on GitHub around. I do this:
- create an empty GitHub repo e.g. ‘software-developer.org’
- do this on your shell:
# source: https://stackoverflow.com/a/19279822 # clone your selected theme under your project site's name e.g. 'software-developer.org' git clone https://github.com/TaylanTatli/Moon software-developer.org # remove origin and point it to your remote project/repo cd software-developer.org git remote remove origin git remote add origin https://github.com/taitruong/software-developer.org.git git push -u origin master
Depending on which theme you have selected, there is a setup guide. My choice is TaylanTatli’s beautiful Moon theme
So I did:
- edit _config.yml
- remove all sample posts from _posts folder
- edit index.md in about folder
Next you can publish your first post:
- write your post e.g. 2017-11-17-my-first-post.md and store it under _posts folder
- don’t forget to adjust README.md to your needs
If you are not familiar with Markdown, have a look here:
Enable your GitHub pages
All you need is to enable it:
- Go to your Git Hub repo settings, scroll down to GitHub pages
- select master branch
I have also installed an emoji plugin. All you need to do is editing your _config.yml file in your main/root folder. Add ‘jemoji’ in the plugins (or gems for Jekyll version < 3.5.0) entry:
... # Plugins plugins: - jekyll-mentions - jekyll-feed - jekyll-sitemap - jekyll-gist - jemoji ...
In case you find your _config.yml an gems entry than your theme is using an older Jekyll version < 3.5.0:
# Gems ... gems: - jekyll-mentions - jekyll-feed - jekyll-sitemap - jekyll-gist - jemoji ...
Here is an emoji cheat sheet. Go for it :clap! The only problem I have with this emoji plugin: Either the are way to big or it is because of this blog layout. I need to figure that out.
I have also started adding an atom/RSS feeds plugin. Like above add the ‘jekyll-feed’ into your _config.yml file under plugins resp. gems.
Fileformat: Markdown defined Front Matter
Just learning new things. Before I was only used to Markdown. Now with Jekyll I realized that the first lines in my markdown files must contain a front matter block beginning and ending with three dashes ‘—’:
--- layout: post title: Setting up a Blog Site using GitHub Pages and a Jekyll Theme date: 2017-11-17 01:18 excerpt: "A step-by-step guide for installing a blog site using git, GitHub, and Markdown." tags: [GitHubPages, Jekyll, Themes, GitHub, git, DocsLikeCode, DocsAsCode, ContentAsCode, Emoji, plugin, installation, FrontMatter,] comments: true ---
More info here on Jekyll’s Front Matter page.