Creating Online Portfolio

To create an online portfolio based on a Quarto book, you need first to fork a template repository and publish it. Follow the steps below to do so:

  1. Navigate to this GitHub repository: https://github.com/mac-stat112/quarto-book
  2. Click Use this template –> Create a new repository
  3. Give your repository appropriate name, eg, 112-portfolio –> click Create repository
  4. Wait till GitHub create the repository under your account
  5. Click Settings –> Click Pages under the Code and automaton section on the left navigation bar –> under the Branch section, change None to Master, from the new dropdown menu that appears, select /docs –> click Save
  6. Wait a minute till GitHub publish your portfolio –> Refresh the page –> you will notice that a URL for your portfolio appears at the top of the page –> click it to browse into your portfolio (Hooray 🎉, your portfolio is now up and running and you can share it with the world) –> copy the link submit it via the Central Form using the approptiate option.

To customize your portfolio and add content, follow the steps below:

  1. Go back to main repository by clicking the Code tab
  2. Click Code button –> click Open with GitHub Desktop
  3. Select an appropriate Local path –> click Clone
  4. Select For my own purposes –> click Continue
  5. From the Repository menu –> select Show in Explorer/Finder
  6. From the opened menu, double-click the file ending in Rproj
  7. There are 3 places/files that you need to look at:
    1. the _quarto.ymm file. This file tells RStudio which files to add to the website when when hitting the Render Book button located in the Build pane located in the upper-right area of RStudio
    2. the .qmd files inside the activities and notes folders. You can modify or remove the sample files and add new ones. When adding or removing files, make sure to mention/un-mention them in the _quarto.yml file as well.
  8. After finishing a coherent part of an activity or note, hit the Render Book button and inspect the generated website. If satisfied, head to GitHub Desktop –> write a meaningful commit message, eg, Finish activity 3 –> commit –> push