Skip to content

GitHub Pages Tutorial

This workshop is documented in a readthedocs.org site. It has Pages on the left side, page level Table of contents on the right side, a Search bar in the top right, and Previous/Next navigation along the bottom.

There is a glossary at the end for common terms used throughout the content.

About BioData Club

BioData Club is an interdisciplinary community at OHSU dedicated to promoting a fun and supportive culture of co-learning in data science skills and open science principles. We host workshops and social events where attendees can learn and work on projects among friends and colleagues. Biodata Club welcomes everyone who wants to better their know-how in all things data, regardless of skill level. We want to replace statistics anxiety and code fear with inspiration and motivation to learn and share. BioData Club is supported by the OHSU Library and DMICE.

Code of Conduct

Please read and abide by our Code of Conduct, which describes the expectations for all who participate in BioData Club events and virtual spaces, and helps us to create a safe and positive experience for everyone.

You can report CoC violations to the session instructors or teaching assistants via chat or email. If you prefer to report a violation anonymously, please complete this form. Your code of conduct report will be forwarded to a BioData Club member responsible for monitoring for code of conduct violations and receiving reports, and we'll do our best to address the issue as soon as possible.

Workshop Agenda

  1. (5 min) What are you hoping to learn today?
  2. (20 min x4) 4 Lessons: lecture + hands-on + review
    • A Personal Website for Professional Outreach
    • Publishing a GitHub Page
    • The Magic of Markdown
    • Best Practices for Sharing Your Work
  3. (5 min) Open Questions

What are you hoping to learn today?

Let's take 5 minutes to discuss what you're hoping to learn today.

  1. Introduce yourself and what brought you here today
  2. Talk about what you're hoping to learn from this workshop

Attribution

This tutorial uses the jekyll-academic template.

This template was developed by NCSU Libraries and is tailored specifically for use within the academic community.

Contributors

Acknowledgements

This workshop uses talking points and images originally developed in collaboration with Letisha Wyatt, PhD, for the Impact Challenge workshop series developed by the OHSU Library.

Some of the content in this workshop was inspired by Stacy Konkiel’s work and instruction, most specifically her open access book the 30 Day Impact Challenge.

The gumball machine gif that appears in Lesson 4 was sourced from Giphy and created by Anchor Point.

The otter gif that appears in Lesson 4 was sourced from Giphy and created by @Justin.