Hack your way to create a Website/Blog

How developers can use Github Pages and Jekyll to bring their personal, organisation or project websites up and running without any cost.

Transcript

1. Easy way to create a Website/Blog Wahib Ul Haq @wahibhaq Hack your
3. Jekyll Tom Preston-Werner created Jekyll in 2008 to enable people to blog using a simple static HTML website, with all of the content hosted and version-controlled on GitHub. The goal was to eliminate the complexity of other blogging platforms by creating a workflow that allows you to blog like a hacker. Jekyll takes your content written in Markdown → passes it through your templates → spits it out as a complete static website → ready to be served.
4. Advantages of Going Static Simplicity & Minimalism No database. No CMS. Fast. Minimal. Design control Security Convenient hosting
5. Github Pages Conveniently serves the website so that you don’t have to deal with any hosting There are usage limits involved Custom Domain Redirects is possible (e.g wahibhaq.com serving wahibhaq.github.io) You get one site per GitHub account and organization, and unlimited project sites
6. Good Collection of Themes Github Pages Jekyll Themes
7. User and Organization Pages Sites The source files live on the master branch in a dedicated repository named with the GitHub account name To create a User Pages site, name the repository using the naming scheme <username>.github.io e.g. wahibhaq.github.io To create an Organization Pages site, name the repository using the naming scheme <orgname>.github.io e.g. ki-labs.github.io
8. Project Pages Sites The source files live within the same repository as their project, and they are published from one of the following locations: • The master branch • The gh-pages branch • A folder named "docs" located on the master branch A Project Pages site for a personal account is available at http(s)://<username>.github.io/<projectname> e.g. https://wahibhaq.github.io/hodor A Project Pages site for an organization account is available at http(s)://<orgname>.github.io/<projectname> e.g. https://ki-labs.github.io/ki-university
9. What are your options? Default Theme Use Any existing Jekyll theme and Customize (Recommended) a. Fork repo and rename it to <whatever>.github.io b. Create master branch if not already c. Adjust _config.yml Follow all steps from adding-a-jekyll-theme-to-your-github- pages-site/ 1 2 3
10. Benefits for you Personal website/blog running & live #LessHassleNoCost Your commits = Better Github Contributions Chart #BeingActive Contribute to parent repo with your improvements #OpensourceLove Things are in your control #DevSatisfaction You can run and test locally as well $ jekyll serve --watch #Convenience
11. THANKS FOR LISTENING Any Questions? @wahibhaq http://wahibhaq.com
12. Resources https://guides.github.com/features/pages/ https://help.github.com/articles/configuring-a-publishing-source-for-github-pages/ https://help.github.com/articles/adding-a-jekyll-theme-to-your-github-pages-site/ https://help.github.com/enterprise/2.13/user/articles/user-organization-and-project-pages/ https://www.smashingmagazine.com/2014/08/build-blog-jekyll-github-pages/