AcademiaLight

A clean, lightweight, and elegant Hugo theme for academic profiles. The UI design is inspired by minimal-light theme.

Demo | 中文文档

Prerequisites

Install Hugo:

# macOS (Homebrew)
brew install hugo

# Windows (Chocolatey)
choco install hugo-extended

# Linux (Snap)
snap install hugo

Verify installation:

hugo version

Make sure you have Hugo Extended version 0.80.0 or later.

Quick Start

Method 1: Using the Example Site

1. Clone the repository:

git clone https://github.com/zdong1995/AcademiaLight.git

2. Start Hugo server:

hugo server --source=exampleSite

Your site should now be available at http://localhost:1313

Method 2: Using with Your Site

1. Create a new Hugo site (skip if you already have one):

hugo new site my-academic-site
cd my-academic-site
git init

2. Add the theme as a submodule:

git submodule add https://github.com/zdong1995/AcademiaLight.git themes/AcademiaLight

3. Configure in config.yaml:

baseURL: "https://example.com"
theme: "AcademiaLight"

4. Start Hugo server:

hugo server

Your site should now be available at http://localhost:1313

Configuration

Basic Settings

params:
  # Basic Information
  author: "Your Name"
  position: "Assistant Professor"
  affiliation: "Your University"
  email: "your.email@university.edu"
  avatar: "/images/avatar.png"
  
  # Clustrmaps Configuration
  clustrmaps:
    enable: true
    widget_id: "YOUR_WIDGET_ID"
    
  # Social Links
  social:
    googleScholar: "https://scholar.google.com/citations?user=xxx"
    github: "https://github.com/username"
    linkedin: "https://linkedin.com/in/username"

Content Structure

data/
├── about.yaml         # About information
├── publications.yaml  # Publications list
├── talks.yaml        # Talks and presentations
├── services.yaml     # Academic services
├── news.yaml         # News and updates
└── contacts.yaml     # Contact information

Social Links

The theme supports various social media and academic profile links. Configure them in config.yaml:

params:
  social:
    googleScholar: "https://scholar.google.com/citations?user=xxx"
    github: "https://github.com/username"
    linkedin: "https://linkedin.com/in/username"
    twitter: "https://twitter.com/username"
    x: "https://x.com/username"      # X (formerly Twitter)
    orcid: "https://orcid.org/xxxx-xxxx-xxxx-xxxx"
    researchgate: "https://www.researchgate.net/profile/username"
    blog: "https://example.com/blog"
    cv: "/files/cv.pdf"             # Local PDF file

Each social link can be enabled/disabled by adding or removing it from the configuration.

Color Theme

Edit assets/scss/_variables.scss:

// Colors
$primary-color: #13294B;
$secondary-color: #39c;
$text-color: #595959;

Layout Structure

The theme uses a modular SCSS structure:

• _variables.scss: Global variables
• _base.scss: Base styles
• _layout.scss: Layout structure
• _components.scss: Component styles
• _sections.scss: Section styles
• _dark.scss: Dark mode styles

Contributing

Pull requests and issues are welcome!

License

This project is licensed under the MIT License - see the LICENSE file for details