diff --git a/meetups/May-2020.md b/meetups/May-2020.md new file mode 100755 index 0000000..cd013bd --- /dev/null +++ b/meetups/May-2020.md @@ -0,0 +1,97 @@ +# Resources on Static Blogs + +## GitHub pages & Travis CI + +### Ingredients: +* Hugo +* Hugo theme (https://themes.gohugo.io/) +* GitHub repo (x2) +* Travis-CI account + +### Steps: + +1. Start by building a simple Hugo blog +2. Choose a nice theme +> I personally use https://github.com/vjeantet/hugo-theme-casper because it has alot of good features out the box +3. Add original theme as a submodule (optional) +> This allows you to separate the original theme to continue receiving updates without merge conflicts. Copy the theme folder and rename it appropriately. Add the new theme name within config.toml + +> https://github.com/samus-aran/blog-resources/blob/master/.gitmodules + +4. Preview your new blog on localhost:1313 +> Awesome right?! +5. Push your new blog onto a GitHub repo +> I created a "blog-resources" repo. You can see my steps (and mistakes) via the commit history. + +> https://github.com/samus-aran/blog-resources + +> https://github.com/samus-aran/blog-resources/commits/master + +> Note: this repo does not include public as that would be moved to your new repo in the later steps so don't worry if you committed it at this stage. +6. Create another GitHub repo specific to GitHub pages (username) +> https://github.com/samus-aran/samus-aran.github.io + +> https://help.github.com/en/github/working-with-github-pages +7. Add the new repo as a submodule to your original repo (resources) +> See link to my repo .gitmodules + +8. Manually push /public to your GitHub pages repo - It's live! +> +9. Automate using Travis-CI using .travis.yml +> Travis-CI actually has a page on how to use it to deploy to GitHub Pages + +> https://docs.travis-ci.com/user/deployment/pages/ + +>Travis CI is a sandbox which runs the commands you want (great for testing and auto deploying) and in our case we want to ‘build’ hugo with the correct theme, deploy to a remote repo using our GitHub token. + +10. Set up Travis account and supply GitHub Access Token (safely) + +> Once you've ccreated your Access Token you can set the variable +> $GITHUB_TOKEN within Travis-CI's environment variable settings. + +> https://github.com/samus-aran/blog-resources/blob/master/.travis.yml + +> https://github.com/samus-aran/blog-resources/commit/154667675d9bb35d96bcf101db42cb9e3d2f3d79 + +> Note: DO NOT add this token within your git repo itself + +11. Push to your resources repo and watch it deply to your GitHub Pages! + +> You can see Travis-CI deploying within the commit itlsef with a green tick or red cross. On Travis-CI.org you can live track ow the deploying is running and if need to debug can view it's logs. + +### Resources: +* https://gohugo.io/getting-started/quick-start/ +* https://gohugo.io/getting-started/usage/#deploy-your-website +* https://github.com/vjeantet/hugo-theme-casper +* https://pages.github.com/ +* https://help.github.com/en/github/working-with-github-pages +* https://gohugo.io/hosting-and-deployment/hosting-on-github/ + +## Notion.so & custom domain + +### Ingredients: + +* Notion.so personal plan (currently free) +* custom domain +* Cloudflare account (free) +* follow clear instructions here to link them together +> https://fruitionsite.com/ + +### Examples + +* https://notion.melody.dev/Melody-s-Notion-5b64fdbb05404e708782f54d43ac21f5 +* http://nicolasgrenie.com/ +* https://dsa-magic-girl.com/ +* https://www.notion.so/ashleynicolson/ + +### Resources: + +* https://www.notion.so/personal +* https://fruitionsite.com/ + +## Netlify + +### Resources: + +* https://url.netlify.com/ByVW0bCF8 +