Prerequisites

Make sure you have a version of git installed and have a github account. Also install please pandoc from https://pandoc.org/installing.html (or via your operating system's package manager if such a one exists).

Download

First obtain a copy of the current Einstein Toolkit website and tool to transfer trac tickets to github:

mkdir spin_exercise
cd spin_exercise
git clone https://bitbucket.org/einsteintoolkit/www.git website

which downloads a copy of the Einstein Toolkit's website.

Exercise

The exercise is to re-create the front-page of the Einstein Toolkit website as a github pages page in a repository of your own on github and to transfer some tickets from trac to github's issue system.

  1. First create a new github repository et_spin2018 in your account,
  2. clone it to your laptop and
  3. copy and commit the files required to render the Einstein Toolkit front page http://www.einsteintoolkit.org into a branch gh-pages.

  4. Push your gh-pages branch to github using

    git push --set-upstream origin gh-pages

  5. Create a wiki for your github repo and clone the wiki repo to your laptop

    git clone https://github.com/YOUR_USERNAME/et_spin2018.wiki.git

  6. use pandoc to convert the ET wiki starting page https://docs.einsteintoolkit.org to github flavored markdown and commit and push it as a page index.md to the wiki repo. To do so, first copy and paste the (updated: 2018-06-27T13:17CDT) wiki (end updated: 2018-06-27T13:17CDT) source code of the wiki page into a file index.wiki then run that file through pandoc.

Once done, please send me the URL of your repository on github using my rhaas@ncsa.illinois.edu email address.

Hint

pandoc can tell you what you need to do using its --help option.

You can preview the ET website that you cloned, as well as your proposed one for gh-pages, by opening the file index.html as a local file in your web-browser.

Solution

If you get stumped with the exercise, here's what my repository looks like. Obviously you cannot send me this one before the interview (smile).



 
 
  • No labels