Academic: the website designer for Hugo

Academic is a framework to help you create a beautiful website quickly. Perfect for personal sites, blogs, or business/project sites. Check out the latest demo of what you'll get in less than 10 minutes. Then head on over to the Quick Start guide or take a look at the Release Notes.

Key features:

Easily manage various content including homepage, blog posts, publications, talks, and projects
Extensible via color themes and widgets/plugins
Write in Markdown for easy formatting and code highlighting, with LaTeX for mathematical expressions
Social/academic network linking, Google Analytics, and Disqus comments
Responsive and mobile friendly
Simple and refreshing one page design
Multilingual and easy to customize

Color Themes

Academic is available in different color themes and font themes.

`default`	`ocean`	`dark`

`forest`	`coffee` + `playfair` font	`1950s`

Install

You can choose from one of the following four methods to install:

one-click install using your web browser (recommended)
install on your computer using Git with the Command Prompt/Terminal app
install on your computer by downloading the ZIP files
install on your computer with RStudio

Quick install using your web browser

Install Academic with Netlify
- Netlify will provide you with a customizable URL to access your new site
On GitHub, go to your newly created academic-kickstart repository and edit config.toml to personalize your site. Shortly after saving the file, your site will automatically update
Read the Quick Start Guide to learn how to add Markdown content. For inspiration, refer to the Markdown content which powers the Demo

Install with Git

Prerequisites:

Fork the Academic Kickstart repository and clone your fork with Git:
```
git clone https://github.com/sourcethemes/academic-kickstart.git My_Website
```
Note that if you forked Academic Kickstart, the above command should be edited to clone your fork, i.e. replace sourcethemes with your GitHub username.

Initialize the theme:

cd My_Website
git submodule update --init --recursive

Install with ZIP

Download and extract Academic Kickstart
Download and extract the Academic theme to the themes/academic/ folder from the above step

Install with RStudio

View the guide to installing Academic with RStudio

Quick start

If you installed on your computer, view your new website by running the following command:
```
hugo server
```
Now visit localhost:1313 and your new Academic powered website will appear. Otherwise, if using Netlify, they will provide you with your URL.
Read the Quick Start Guide to learn how to add Markdown content, customize your site, and deploy it. For inspiration, refer to the Markdown content which powers the Demo
Build your site by running the hugo command. Then host it for free using Github Pages or Netlify (refer to the first installation method). Alternatively, copy the generated public/ directory (by FTP, Rsync, etc.) to your production web server (such as a university's hosting service).

Updating

Feel free to star the project on Github to help keep track of updates and check out the release notes prior to updating your site.

Before updating the framework, it is recommended to make a backup of your entire website directory (or at least your themes/academic directory) and record your current version number.

By default, Academic is installed as a Git submodule which can be updated by running the following command:

git submodule update --remote --merge

Check out the update guide for full instructions and alternative methods.

Feedback & Contributing

Please use the issue tracker to let me know about any bugs or feature requests, or alternatively make a pull request.

For support, head over to the Hugo discussion forum.

License

Released under the MIT license.

dschuermann/hugo-academic