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
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:
If the above doesn't work it probably means you don't …read more
Making your github.io repository
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.
- First you need a github account. You …
Personalize Your Website
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 …
Markdown File Tips & Tricks
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
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
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:
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
Adding Comments to your Blog
Even though pelican generates static websites you can still have dynamic comments using a third party service called Disqus.
- First, create a Disqus account here
- Once you have a Disqus account create a "new site" and point it to your github.io website. Remember the site name you used.
- Open …