Skip to content

Home

Jump to bottom
Sam Osborne edited this page Jun 18, 2020 · 11 revisions

The series of pages hosted here document the 2019 rebuild of the theatre website. The content and template of the site is stored here on GitHub in a Git repository. We use the Jekyll static site generator.

This project was started in 2016 by Will Pimblett and picked up in 2019 by Sam Osborne

Editing

There are several options for editing site content.

  • Forestry (/admin): Probably the simplest. All the technical bits of the repo are hidden away.

When using Forestry, you have access to Snippets which can be accessed using the {} button at the bottom of the editor. These can be used to add the Includes for things like show resources and committee roles.

  • GitHub: This site, navigate to a page and click the pencil.
  • You can also edit pages on your local machine using a git client.

Pages and posts are written in Markdown. Markdown is "a lightweight and easy-to-use syntax for styling all forms of writing". See this GitHub guide for the basics, as we use the Kramdown variant see their docs for more advanced topics.

HTML can and is interspersed in our Markdown files.

Project structure

Content is stored in a number of directories in the project repo.

  • _content is for site pages
  • _data holds data files for the committee, key dates and show resources.

Page files are stored hierarchically, therefore to find the page for /get-involved/ would be _content/get-involved.md.

Page structure

Pages consist of front-matter and content. The front-matter is at the top surrounded by three dashes ---, the content follows. See the example below.

---
title: Get Involved
section: get-involved
---

Lorem ipsum dolor sit amet

The front-matter allows specifying meta-data for the page, such as the title, what section the page belongs e.t.c. Everything that comes after is the page content.

Clone this wiki locally