Content over layout

Grading this course will not take into account how beautiful results of the work are formatted. We more easily focus on content by using Markdown, an increasingly popular language used to document code and/or write blogs published on the web.

Markdown is convenient as a tool to publish on the web, especially when used in combination with GitHub Pages and git. Equating webpages to files in a GitHub repository means that we edit and publish a website the exact same way as we version our code: git add, git commit, and git push the website, collaboratively and versioned. When setup correctly, a tool called Jekyll will automagically convert the markdown into HTML.

Github for Education

Did you already request your github student pack? Please go to github for education to get benefits like private repositories.

If you are not yet fluent in git and Github, then go ahead and study the online training material provided by Github. If you are unhappy working with the command line (a skill which I do recommend taking the effort to acquire), consider Github’s OS X or Windows tool suites (the Windows one is convenient).

How to Create a Blog Post

After familiarizing yourself with git (or refreshing your memory) with the resources above, continue to write a mockup blog post in Markdown syntax, as a model of the process of creating the results of an assignment.

Follow this link to the Classroom for Github Bigdata Blog 2018 assignment, login with your github account, and accept the assignment.

This creates a private repository under the rubigdata “organization”, specifically for this assignment. This newly created repository rubigdata/bigdata-blog-2018-USERNAME will contain an example blogpost in the README.md file.

In order to publish this page go to your Github repository on Github and go to the settings tab. Scroll down to the Github Pages settings and select master as source to enable Github pages. After a little delay your repository should appear on rubigdata.github.io/bigdata-blog-2018-USERNAME. If you would like your blog to look a bit better than plain HTML, you can select a theme in your repository settings after enabling Github Pages

Editing the Blog post

Now in order to add your own content you must clone the private repository and edit the contents of README.md

Finalize the test assignment

The goal in this first assignment is to just complete your first repository that contains a simple site, composed in Markdown, published online for free; with no actual content, just to make sure the process is familiar. You can use the results of this template as your own simple site, and deploy the same steps in the rest of the course to bootstrap new blog posts, one for every real course assignment.

See also

And