Skip to content
Public template

About

A simple and elegant Jekyll theme for an academic personal website

Topics

Resources

Stars

1.1k stars

Watchers

4 watching

Forks

Repository files navigation

The Minimal Light Theme

LICENSE

[Demo the theme] [简体中文 | 繁體中文 | Deutsch]

This is the source code of my homepage. I built this website based on minimal.
Feel free to use and share the source code anywhere you like.

The latest version of my homepage is available here:
https://github.com/yaoyao-liu/yaoyaoliu-homepage

Features

  • Simple and elegant personal homepage theme
  • Jekyll theme, automatically deployed by GitHub Pages
  • Basic search engine optimization
  • Mobile-friendly
  • Supports Markdown
  • Supports dark mode

Project Architecture

.
├── _data
|   └── publications.yml                      # the YAML file for publications
├── _includes
|   ├── publications.md                       # the Markdown file for publications
|   └── service.md                            # the Markdown file for services
├── _layouts
|   └── homepage.html                         # the HTML template for the homepage
├── _sass
|   ├── minimal-light.scss                    # this file will be compiled into a CSS file to control the style of the page
|   ├── minimal-light-no-dark-mode.scss       # this file is similar to minimal-light.scss, with the dark mode disabled
|   ├── minimal-light-publications.scss       # the styles of the publication list
|   └── minimal-light-variables.scss          # the color variables and the dark-mode switch shared by the stylesheets
├── assets                                    # static files (CSS, JavaScript, images, and PDFs)
├── html_source_file                          # compiled HTML files
├── .gitignore                                # this file specifies intentionally untracked files that Git should ignore
├── CNAME                                     # the custom domain, used by the GitHub Pages service
├── Gemfile                                   # the file that lists the required Ruby gems
├── LICENSE                                   # the license file
├── README.md                                 # the readme file (English)
├── README_de.md                              # the readme file (German)
├── README_zh_Hans.md                         # the readme file (Simplified Chinese)
├── README_zh_Hant.md                         # the readme file (Traditional Chinese)
├── _config.yml                               # the Jekyll configuration file, including some options of the page
└── index.md                                  # the content of the index page, written in Markdown

Getting Started

This template can be used in the following two ways:

  • Using with the GitHub Pages service. GitHub will provide you with a server to generate and host web pages.
  • Using locally with Jekyll. You may install Jekyll on your own computer and generate static web pages (i.e., HTML files) with this template. After that, you may upload the HTML files to your server.

The detailed instructions are available below.

Using with the GitHub Pages Service

There are two ways to use this template on GitHub:

Forking this repository

Using this repository as a remote theme

To use this theme, add the following to your repository's _config.yml:

remote_theme: yaoyao-liu/minimal-light

Please note that adding the above line will directly apply all the default settings in this repository to yours.

If you want to edit any files (e.g., index.md), you still need to copy them to your repository.

Using Locally with Jekyll

First, install Ruby and Jekyll. The installation instructions can be found here: https://jekyllrb.com/docs/installation/#guides

Then, clone this repository:

git clone https://github.com/yaoyao-liu/minimal-light.git
cd minimal-light

Install the dependencies and run the server:

bundle install
bundle exec jekyll server

View the live page at http://localhost:4000. You can find the generated HTML files in the _site folder.

Using the HTML Version

The compiled HTML files are available in the html_source_file folder. If you don't like Jekyll, you may directly edit and use the HTML version.

Customizing

Configuration variables

The Minimal Light theme will respect the following variables, if set in your site's _config.yml:

# Basic Information
title: Your Name
position: Ph.D. Student
affiliation: Your Affiliation
affiliation_link: https://www.example.edu/
email: yourname (at) example.edu

# Search Engine Optimization (SEO)
# The following information is used to improve the website traffic from search engines, e.g., Google.
keywords: minimal light
description: The Minimal Light is a simple and elegant Jekyll theme for an academic personal homepage.
canonical: https://minimal-light-theme.yliu.me/

# Links
# If you don't need one of them, you may delete the corresponding line.
google_scholar: https://scholar.google.com/
cv_link: assets/files/curriculum_vitae.pdf
github_link: https://github.com/
linkedin: https://www.linkedin.com/
twitter: https://twitter.com/

# Images (e.g., your profile picture and your website's favicon)
# "favicon" and "favicon_dark" are used for the light and dark modes, respectively.
avatar: ./assets/img/avatar.png
favicon: ./assets/img/favicon.png
favicon_dark: ./assets/img/favicon-dark.png

# Footnote
# You may use this option to disable the footnote, "Powered by Jekyll and Minimal Light theme."
enable_footnote: true

# Auto Dark Mode
# You may use this option to disable the automatic dark theme.
auto_dark_mode: true

# Font
# You may use this option to choose between Serif and Sans Serif fonts.
font: "Serif" # or "Sans Serif"

# Google Analytics ID
# Uncomment the line below and fill in your Google Analytics 4 measurement ID (G-XXXXXXXXXX) to enable it.
# google_analytics: G-XXXXXXXXXX

Edit index.md

Create index.md and add your personal information. It supports Markdown and HTML syntax.

Edit included files

Two Markdown files are included in index.md: _includes/publications.md and _includes/service.md. These two files also support Markdown and HTML syntax. If you don't want to include these two files, you may remove the following lines in index.md:

minimal-light/index.md

Lines 21 to 23 in b38070c

{% include_relative _includes/publications.md %}
{% include_relative _includes/services.md %}

If you want to edit the publication list without changing the format, you may edit _data/publications.yml:

- title: Continual Learning for Abdominal Multi-Organ and Tumor Segmentation
authors: Yixiao Zhang, Xinyi Li, Huimiao Chen, Alan Yuille, <strong>Yaoyao Liu*</strong>, Zongwei Zhou* (*Corresponding authors)
conference_short: MICCAI
conference: International Conference on Medical Image Computing and Computer-Assisted Intervention <strong>(MICCAI)</strong>, 2023.
pdf: https://arxiv.org/pdf/2306.00988.pdf
code: https://github.com/MrGiovanni/ContinualLearning
bibtex: https://bib.yliu.me/MICCAI23.txt
image: ./assets/img/teaser_example_2.png
notes: Early Accept

Stylesheet

If you'd like to add your own custom styles, you may edit _sass/minimal-light.scss.

Layouts

If you'd like to change the theme's HTML layout, you may edit _layouts/homepage.html.

License

This work is licensed under a Creative Commons Zero v1.0 Universal License.

Acknowledgements

This project uses the source code from the following repositories:

About

A simple and elegant Jekyll theme for an academic personal website

Topics

Resources

Stars

1.1k stars

Watchers

4 watching

Forks

Releases

Packages

Used by

Contributors

Languages