michaelh/hugo-academic-mirror
1
0
Fork 0
mirror of https://github.com/gcushen/hugo-academic.git synced 2025-07-26 19:15:16 +02:00
Code Issues Projects Releases Packages Wiki Activity
No description
265 commits 2 branches 82 tags 139 MiB
Find a file
Serge Bibauw 45b2e054e7 Add time_format variable for customizing talk time (#353) 
* Add `time_format` variable to `config.toml`
   * Enables customizing talk time between am/pm or 24h format
* Correct Go date format URL in documentation
2017-10-26 19:33:02 +01:00
archetypes archetypes: Make hugo new home/<TITLE>.md use the custom widget 2017-10-22 16:02:25 +01:00
data contact widget: Add option to show Google Maps (Close #301) 2017-10-15 06:26:04 +01:00
exampleSite Add time_format variable for customizing talk time (#353) 2017-10-26 19:33:02 +01:00
i18n i18n: Update French and Spanish translations (#337) 2017-10-21 17:38:52 +01:00
images readme: Add theme previews 2017-10-04 01:05:21 +01:00
layouts Add time_format variable for customizing talk time (#353) 2017-10-26 19:33:02 +01:00
static project widget: Fix long title appearing on new line (Fix #324) 2017-10-19 19:58:16 +01:00
.editorconfig staticref shortcode: Fix formatting by removing whitespace (Fix #295) 2017-10-08 12:56:39 +01:00
academic.png Update Readme 2017-01-29 18:52:25 +00:00
LICENSE.md Initial commit 2016-04-27 12:26:40 +01:00
README.md docs: Update 📚 2017-10-22 16:46:52 +01:00
theme.toml Fix error if static/files/citations/ folder doesn't exist (Fix #329) 2017-10-19 19:00:27 +01:00

README.md

Academic: the personal website framework for Hugo

Academic is a framework to help you create a beautiful website quickly. Perfect for personal, student, or academic websites. Check out the latest demo of what you'll get in less than 10 minutes.

Screenshot

Key features:

  • Easily manage your homepage, blog posts, publications, talks, and projects
  • Configurable widgets available for Biography, Publications, Projects, News/Blog, Talks, and Contact
  • Need a different section? Just use the Custom widget!
  • 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
default theme ocean theme
forest coffee
forest theme coffee theme

Getting Started

  1. Install Hugo and create a new website by typing the following commands in your Terminal or Command Prompt app:

     hugo new site my_website
 cd my_website

  2. Install Academic with git:

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

    Or alternatively, download Academic and extract it into a themes/academic folder within your Hugo website.

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

     cp -av themes/academic/exampleSite/* .

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

     hugo server

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

  5. Customize your website and add your content by referring to the Academic documentation

  6. Build your site by running the hugo command. Then host it for free using Github Pages. Or alternatively, copy the generated public/ directory (by FTP, Rsync, etc.) to your production web server (such as your 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 Academic, it is recommended to make a backup of your entire website directory, or at least your themes/academic directory.

Before updating for the first time, the remote origin repository should be renamed to upstream:

$ cd themes/academic
$ git remote rename origin upstream

To list available updates:

$ cd themes/academic
$ git fetch upstream
$ git log --pretty=oneline --abbrev-commit --decorate HEAD..upstream/master

Then, update by running:

$ git pull upstream

If you have modified files in themes/academic, git will attempt to auto-merge changes. If conflicts are reported, you will need to manually edit the files with conflicts and add them back (git add <filename>).

If there are any issues after updating, you may wish to compare your site with the latest example site to check if any settings changed in config.toml or the +++ frontmatter of content files.

Feedback & Contributing

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

For general questions about Hugo, there is a Hugo discussion forum.

License

Copyright 2017 George Cushen.

Released under the MIT license.

Analytics