hugo-academic

Hugo Academic

A personal academic theme for Hugo.

Key features:

• Suitable for academic staff, students, or general personal use
• Sections for Biography, Publications, Blog/News, Teaching, and Contact
• Responsive and mobile friendly
• Simple one page design
• Clean and refreshing theme
• Easy to customize

Quick start

1. Install with git:

   git clone git@github.com:gcushen/hugo-academic.git themes/hugo-academic
   

Or alternatively, install by downloading from Github into a themes/hugo-academic folder within your Hugo website.

1. If you are creating a new website, copy the contents of the exampleSite folder to your website root folder to get started, overwriting existing files if necessary. The exampleSite folder contains an example config file and content to help you get started.

2. Start the Hugo server from your website root folder:

   hugo server --watch
   

   Now you can go to localhost:1313 and your new Academic themed website should appear.

Customization

To change the biography text, edit content/home/about.md and/or the param variables in config.toml.

To create a new publication:

hugo new publications/my-paper-name.md

Then edit the default variables at the top of publications/my-paper-name.md to include the details of your publication. Note that the date variable for publications is the publish date in the format 2016-01-01.

To create a blog/news article:

hugo new blog/my-article-name.md

To remove content, simply delete the relevant file from your content/blog or content/publications folder. If you wish to remove the Teaching section from the home page, simply delete the content/home/teaching.md file. Then rebuild and view the updated website with the hugo and hugo server --watch commands.

To enable Google Analytics, add your tracking code to config.toml similarly to googleAnalytics = "UA-12345678-9".

Upgrading

Improvements to the theme will be recorded in the Github releases changelog. Feel free to star the project on Github and monitor the progress for updates.

Created by George Cushen.