Publishing Your Site on GitHub Pages

After setting up your repository and configuring your project, you need to activate GitHub Pages to make your site publicly accessible on the web.

About GitHub Pages

GitHub Pages is a free hosting service that publishes websites directly from GitHub repositories. It’s perfect for project sites like Oral History as Data because:

  • It’s completely free
  • It integrates seamlessly with your repository
  • It automatically updates when you make changes
  • It provides a reliable, secure web presence

GitHub Actions

GitHub Actions allows you to use GitHub Pages to host an OHD site on GitHub that require custom plugins. This is important since the default GitHub Pages process doesn’t support plugins needed by CB-CSV.

Check out our Step by Step Tutorial to Learn More

  • Setup: Configure through repository Settings > Pages
  • Process: Creates a workflow file (.github/workflows/jekyll.yml) that builds your site with the correct Jekyll version
  • Benefits: Free hosting with the ability to use plugins
  • Documentation: GitHub Actions Guide

GitHub Pages Usage Guidelines

GitHub Pages is intended for documentation and small project sites. Keep these guidelines in mind:

  • Sites should be less than 1GB in total size
  • Monthly bandwidth limit is 100GB
  • Build limits: 10 builds per hour