Skip to content

Tips & Tricks

Cheatsheet

The ordered shortlist/cheatsheet for the workshop:

  • Fork and rename the repo
  • Edit _config.yml
  • Add a Bio to index.md
  • Upload new bio photo images/bio-photo.jpg

Reminders

  • Fork button in top right
  • Settings tab just below that
  • Don’t edit the _config.yml below the “DO NOT EDIT”
  • Is your website not updated?
    • Commit changes after editing
    • It might take a minute
  • Still not showing?
    • Try clearing your cache or Incognito Mode or Private Browsing in your web browser
  • Still stuck? Raise your hand!
  • Spaces are important in Markdown so make sure you’re using them correctly
    • [this is a link](https://google.com)
    • ![this is an image](images/bio-photo.jpg)

Here is where you can read more about customizing the jekyll-academic template that your site is based on:

https://ncsu-libraries.github.io/jekyll-academic-docs/

Markdown is not only useful for GitHub Pages. One markdown document can be translated into PDFs, HTML Slides, Word Documents, and a bunch of other formats. We talk about some of the uses here: http://laderast.github.io/magic-of-markdown

Extra Topics

Read on in the Extra Topics drop-down section on the left for commonly requested instructions of how to make more changes to this website template.