If you are reading this within your very own copy of this GitHub repository (because you followed the link from the github classroom), then read on. If you are reading this offline, then please set up the Github account before you do anything else.
Before you do anything with your new GitHub account do this:
You don’t need GitHub.com for the moment but you will need to recall your username and password during the next steps.
You will need a text editor that can show and preview web HTML. We now want you to download and install Atom. You can find this free open source editor here
This application will be placed inside your downloads folder, so you need to copy to your Applications folder inside you user account on the MAC. This means that you should try to use the same MAC in Tonge whenever possible.
You can also install this on your own computer at home.
Your Applications folder is inside your Home folder; find this by selecting Go from the finder menu. You can copy or move the Atom app from the downloads folder.
Atom will now be available but we now need to move to the next stage.
Atom is open source, so this means there are lots of packages that can be added to provide extra functionality. What follows is rather advanced, so don’t worry if you can’t do this; it is only another option.
Here are a few packages that will prove useful:
- Atom HTML Preview
- toolbar (suda)
You can optionally use Atom to update your GitHub repository that is online. To do this you need to install this package:
Then in the terminal window copy and paste this:
git config --global credential.helper osxkeychain
You should now be able to push your updates direct to GitHub and see the results on your web site.
The MACs have installed an application called GitHub Desktop. Find this in the launchpad. If you want to install this on your own computer, it is free and comes from here
Once you have done this you can now clone the repository that is in your GitHub account online by selecting the + sign. All being well you should see something similar to this here:
When you download this repository, you will find a variety of files, but the 2 important ones are inside the docs folder:
You can also have a look at the sample scene inside the sampleScene folder
Also inside the resources folder you will find various InDesign scripts. These scripts needs to go into your copy of InDesign. The instructions are available here.
Here are the steps to take:
In Atom it will look similar to this:
<body>opening and closing tag. You can make this easier by collapsing the body tag:
<body>tag as per the instructions in that file.
When you are happy with the look of these web pages then you can:
Make sure that you ‘commit’ your changes by writing something like first version in the message box.
And then make sure that you have highlighted the far right of the timeline. Please see these 2 images.
Filed under: Using GitHub