This tutorial introduces GitHub as a free static website publishing platform. No installation of additional software is required, however, you will need a GitHub account. By the end of this tutorial, you will have your own version of an open textbook template available for further editing. This tutorial is estimated to take between 30 and 60 minutes to complete.
This tutorial will teach you the basics of using a static site generator. We will be using Hugo to build our demonstration site. We’ll play the role of a scholarly communications librarian. We’ll be using a command line terminal to install software and run commands and a text editor to edit and save plain text files. This in-depth tutorial is estimated to take between three and four hours to complete.
While we will be using Hugo as our static site generator, this tutorial is not intended to be a cover the depth and breadth of Hugo. For that, I refer you to the Hugo documentation and community. Rather, this tutorial is about using static site generators in a library-publishing context.
Websites for scholarly publications and digital scholarship are expected to be stable for long-term access, citation, and archiving. Static websites provide a durable and low-cost solution for making and distributing scholarly works. In library and academic contexts, static websites have been used for conference websites, digitization projects, archival metadata, academic journals, edited monographs, and open textbooks. The resources presented here introduce this powerful technology for scholarly communications librarianship.
Contents include: a lesson plan for learning about static web publishing for digital scholarship projects; an annotated bibliography of articles, tutorials, and podcasts about static websites in academic contexts; a quick demonstration of GitHub as a static website hosting platform; an introduction to static site generators tutorial.
This annotated bibliography provides an overview of how static websites can be used for scholarly purposes. It includes publications representing a variety of communities, including libraries, digital humanities, and open source software. The citations included in this bibliography –with few exceptions– focus on librarians and scholars who use static websites for their work.
This lesson plan provides an assortment of learning modules for teaching static web technologies for digital scholarship and scholarly communications librarianship. Each topic includes a learning objective and recommended readings, viewings, or tutorials for use in workshops or seminars.