Installing the Software

Mon 02 July 2018 by authorname

Before you start you will need to download some software. Pelican is based on python and github.io uses git.

We recommend using the Anaconda install for python. You can download the installer here.

Once Anaconda is installed you can use the installers to install the rest of what you need:

conda install git

pip install pelican

pip install markdown

Now you should be able to clone this repository using the following commands:

git clone https://github.com/nolanfeeny/msupelican.git


Building your website

Sun 01 July 2018 by authorname

Once you have installed the required software and downloaded the repository, you should be able to now get this site running on your local machine. First change to the msupelican directory and run the following commands:

make html

make serve

If the above doesn't work it probably means you don't …

read more

Making your github.io repository

Sun 01 July 2018 by authorname

Running Pelican creates an docs folder with your static website. The next step is to take the contents of this folder and put it in a git repostiory named user.github.io where user is your github user name. That should be it.

  1. First you need a github account. You …
read more

Personalize Your Website

Fri 01 June 2018 by authorname

Now that you have a website it is time to make it your own. First thing you can do is edit the pelican.conf file. This file is used to set some variables related to your website. Read through the file and change what you think is appropriate Specifically change …

read more

Markdown File Tips & Tricks

Thu 31 May 2018 by authorname

You will probably be using markdown files to write your blogs. They are nice because they give you more freedom than simple text files, and are easier to work with than HTML files. However, you can still use raw HTML in your files and it'll work pretty well, which is …

read more

Making Additional Websites

Wed 30 May 2018 by authorname

Github Pages allows you to make unlimited websites linked to other repository projects.

For example, you have your main website user.github.io

If you have a separate github repository projectrepo, you can make a project column by going to the 'Projects' header and creating a new column. It can …

read more

First Post

Tue 29 May 2018 by authorname

This is a sample post: you can post anything you want, e.g. for a blog, research paper, or general news update.

Here's a sample picture of Lake Michigan:

lake michigen

This file is located at msupelican/content/Blog/firstpost.md and is written as a markdown file.

You probably will want …

read more

Adding Google Analytics to your site

Sun 02 July 2017 by authorname

Google Analytics allows you to track the traffic on your website.

1 . First, create a Disqus account here 2. Once you have a Disqus account create a "new site" and point it to your github.io website. Remember the site name you used. 3. Open up the pelican.conf file …

read more

Adding Comments to your Blog

Sat 01 July 2017 by authorname

Even though pelican generates static websites you can still have dynamic comments using a third party service called Disqus.

  1. First, create a Disqus account here
  2. Once you have a Disqus account create a "new site" and point it to your github.io website. Remember the site name you used.
  3. Open …
read more

Connecting your Blog to Social Media

Sat 01 July 2017 by authorname

Your blog can be used to automatically feed information into social media sites such as Twitter and facebook. This post will show you how to connect your github.io site to dlvrit.com, a service which can read your blog and post entries into your social media outlets.

  1. Create an …
read more