Digital Publishing Hub
Help for publishers and students of publishing

Using a Git Repository to host your Shakespeare Play Web Site

On this Page

Using a Git Repository to host your Shakespeare Play Web Site

We are using GitHub pages to host a web site for the Shakespeare play. This page explains what we are going to do to get started.

You will need VS Code software

You will only need the application called VS Code and this free software is available for your platform here.

Now we need to create the Github repository

Here are the steps:

Create a Github Account (if you do not already have one) and login to the account.

If you already have an account then login at github.com

Now go to this page (put this into the URL box): https://github.com/publisha/shakespeareplay

You will see the green button Use this Template

Click the green button to grab the template

Use the template link to receive the repository in your own github account. Make sure that you choose the Public option. You will be asked to name the repository.

  • Go to settings and change the name of your repo (you should use the name of your play.

Change the name of your repo

What’s inside the repository?

When you download this repository, you will find a variety of files, but the 3 important ones are inside the docs folder:

  • index.html - this will become the home page for your play. This page will have the cover image.
  • play.html - this is where the text of the play will be. Linked from the home page above.
  • styles.css - this is where you define the styles for the elements in the play

You can also have a look at the sample scene inside the sampleScene folder.

Ok, so what do I do now?

You should now read the help document here, that explains how to generate the HTML files from InDesign.

Here are the basic steps

  • Open InDesign and find your final version of the play (only the play - not the Introduction)
  • Make any corrections that you like (consider the comments from the previous assignment)
  • If you created any new styles you will need to go to the style panel and configure the Export Tags feature, making sure that each style will export with an HTML tag.
  • As stated above - read the help document that I have provided - InDesign to HTML.
  • Follow those instructions to create the interactive table of contents.
  • Export your play InDesign document with settings in the instructions.
  • You will find that you have now got a new file saved wherever your InDesign file was saved. You can drag this file into the docs folder of your working copy of the repo that you have open in Atom. This file should be renamed play.html and will replace the existing placeholder file.

Note: if you included images in your play, you will need more work to get those into the appropriate location.

The Play

In VS Code it will look similar to this:

HTML version of the play

  • Open the play.html file that is inside the docs folder (that you have from your repository) with VS Code
  • Now edit the style.css file (again inside the docs folder) to style each of the elements in the play
  • Review in a web browser
  • Validate the HTML file here: https://html5.validator.nu
  • Validate the CSS file here: https://jigsaw.w3.org/css-validator/

The home page cover

  • You now need the cover image from the book.
  • You can open the PDF of the cover in Photoshop and crop down to the front of the cover. In other words, remove the back and spine.
  • The cover image needs to be 1400 pixels wide, because we need this later for the eBook.
  • save this image as a JPEG in the images folder within the docs folder in your repository that you downloaded from GitHub.
  • Now edit the index.html file and put the file name of the image where instructed in the markup. Also edit the ALT tag text.
  • When you view this index.html file the image will be very large, so you must edit the styles.css file to change the width of the image.
  • when viewed in a browser, this image will be a link to the play.
  • check that the link functions correctly.

Making the web site work

You can look at the web pages in the web browser by right clicking over the file and selecting Reveal in Finder and then double click the HTML file to open in your default browser. There is an extension for VS Code called Open Browser Preview which can make this easier.

When you are happy with the look of these web pages then you can:

  • Upload these new versions of these files to your GitHub repository
  • You do this by using the VS Code.
  • click Stage All (top right)
  • write a message in the commit box (what did you change)
  • Click commit
  • Click the Up Arrow
  • Click Push

You should now be able to push your updates direct to GitHub and see the results on your web site.

Push your changes to Github

Back to GitHub

Now we need make the web site live at github.com

Go there in your browser and login with the credentials that you put in before and find the repository that you have previously renamed.

  • Under GitHub Pages choose the docs folder for the source

You are telling GitHub to run the web site from the docs folder

  • Your web page for the play will be live!
  • When you have finished and are ready then post the URL of your site to the Moodle assignment location.

Summary

Ok, so I know this seems complicated. Let me write out a simple list with the steps. Make this into a check list and tick them off as you go!

  • Download VS Code and install in your Applications folder
  • Create an account on Github.com
  • Grab link on Moodle (week 1) for the GitHub template
  • Copy the link next to the Clone button
  • In Atom, use the icon bottom right to clone and use the window to paste in the link
  • Read the helper document about getting HTML from InDesign
  • Add the files into the local version of the repository and edit the HTML and CSS etc
  • Check that the site works (home page is the cover image with link to the play)
  • push the files to your GitHub repository
  • Configure your GitHub repository to use the docs folder to deliver the web site
  • Note the web address and finish

Filed under: HTML and CSS, Multi-Platform Publishing, GitHub

This page last edited on: 2019-10-08