Skip to content

RMITLibrary/WARC-Example-App

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 

Repository files navigation

WARC Hosting Project (Example Test)

This project provides an example test for deploying WARC (Web ARChive) files using GitHub Pages and ReplayWeb.page to make archived web content accessible online.

Purpose

  • Overview: Demonstrate a simple solution to host and access WARC files for public browsing using GitHub Pages as part of an example test.
  • Version: 1.0.0

Features

  • Host WARC files publicly on GitHub Pages.
  • Utilise ReplayWeb.page to enable seamless browsing of archived content.
  • Easy setup and configuration tailored for non-technical users.

System Requirements

  • Homebrew: Latest version
  • Python: 3.x
  • wget: Latest version
  • Git: Latest version
  • GitHub Account
  • Internet Access

Installation

  1. Install wget using Homebrew:
    brew install wget
  2. Clone the repository:
    git clone https://github.com/YOUR_USERNAME/YOUR_REPOSITORY.git

Configuration

  1. Local Server Setup: Use Python to host your local files.
  2. WARC Capture: Capture your site into a WARC file using wget.
  3. GitHub Pages Setup: Configure your repository settings to enable Pages.
  • Database configuration: Not applicable
  • CMS/Static Site Setup: Ensure your local static site is ready.
  • Environment Variables: Not required

Environments

  • Development: http://localhost:8000
  • Testing: This is part of an example test, not applicable.
  • Staging: Not applicable
  • Production: Your GitHub Pages URL (e.g., https://yourusername.github.io/yourrepository)

Testing and Deployment

  • Testing: Use local server environment to ensure all content is captured correctly. This is an example test scenario.
  • Deployment: Push your WARC and HTML setup to GitHub and enable GitHub Pages.

Contribution

  • Writing tests: Ensure local server and capture process are correctly configured.
  • Code reviews: Collaborate via GitHub issues and pull requests.

Authors and Acknowledgements

  • Developed and maintained by RMIT University Library Digital Learning Team.

Licence

Licensed under MIT Licence.

© RMIT University Library

Developed by RMIT Library Digital Learning

Contact

Resources

Releases

No releases published

Packages

 
 
 

Contributors