Week 13
From Notebooks to the Web: Github Pages

Github Pages Templates

• Option #1: https://github.com/MUSA-550-Fall-2021/github-pages-starter/
• Option #2: https://github.com/MUSA-550-Fall-2021/github-pages-single-page-starter/

Steps

• Click on the "Use this template" button to create a new repository.
• Choose a new name for your new repository
• Go to the Settings section of your new repository, scroll down to the "Github Pages" section, and select the "main" as the branch to be used for GitHub pages. This will automatically build the website.
• Customize your site
  • Enter your site name, description, etc by editing the _config.yml file.
  • There are two different ways that you can make changes to your blog's files:
    • Edit files within your in the browser at GitHub.com
    • Clone down your repository and make updates locally, then push them to your GitHub repository.
• Publish a post
  • Posts are written in Markdown and any files added to the _posts directory will be automatically uploaded and published
  • Useful resource: Markdown Cheatsheet