hugo-academic-mirror/README.md

54 lines
2.4 KiB
Markdown
Raw Normal View History

2016-04-27 12:26:40 +01:00
# Hugo Academic
A personal academic theme for [Hugo](https://gohugo.io).
[![Screenshot](https://raw.githubusercontent.com/gcushen/hugo-academic/master/images/screenshot.png)](https://github.com/gcushen/hugo-academic/)
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
2016-04-27 16:16:54 +01:00
1. Install with `git`:
2016-04-27 12:26:40 +01:00
2016-04-27 16:16:54 +01:00
git clone git@github.com:gcushen/hugo-academic.git themes/hugo-academic
2016-04-27 12:26:40 +01:00
2016-04-27 16:16:54 +01:00
Or alternatively, install by downloading from [Github](https://github.com/gcushen/hugo-academic/) into a `themes/hugo-academic` folder within your Hugo website.
2016-04-27 12:26:40 +01:00
2. 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.
3. Start the Hugo server from your website root folder:
``` sh
hugo server --watch
```
Now you can go to [localhost:1313](http://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](https://github.com/gcushen/hugo-academic/) and monitor the progress for updates.
Created by [George Cushen](http://www.cushen.me).