AcadHomepage:
A Modern and Responsive Acadamic Personal Homepage

| 中文文档

Some examples:

• Demo Page
• Personal Homepage of the author

Key Features

• Automatically update google scholar citations: using the google scholar crawler and github action, this REPO can update the author citations and publication citations automatically.
• Support Google analytics: you can trace the traffics of your homepage by easy configuration.
• Responsive: this homepage automatically adjust for different screen sizes and viewports.
• Beautiful and Simple Design: this homepage is beautiful and simple, which is very suitable for academic personal homepage.
• SEO: search Engine Optimization (SEO) helps search engines find the information you publish on your homepage easily, then rank it against similar websites.

Quick Start

1. Fork this REPO to USERNAME/USERNAME.github.io, where USERNAME is your USERNAME.
2. Configure the google scholar citation crawler:
   1. Find your google scholar ID in the url of your google scholar page (e.g., https://scholar.google.com/citations?user=SCHOLAR_ID), where SCHOLAR_ID is your google scholar ID.
   2. Set GOOGLE_SCHOLAR_ID variable to your google scholar ID in Settings -> Secrets -> Actions -> New repository secret of the REPO website with name=GOOGLE_SCHOLAR_ID and value=SCHOLAR_ID.
   3. Restart the failed Get Citation Data github action in Action of the REPO website. This action will generate google scholar citation stats data gs_data.json in google-scholar-stats branch of your REPO.
3. Generate favicon using favicon-generator and download all generated files to REPO/images.
4. Modify the configuration of your homepage _config.yml:
   1. title: the title of your homepage
   2. description: the description of your homepage
   3. repository: USER_NAME/REPO_NAME
   4. google_analytics_id (optional): google analytics ID
   5. SEO Related keys (optional): get these keys from search engine consoles (e.g. Google, Bing and Baidu) and paste here.
   6. author: the author information of this homepage, including some other websites, emails, city and univeristy.
   7. More configuration details are described in the comments.
5. Add your homepage content in _pages/about.md.
6. Your page will be published at https://USERNAME.github.io.

Debug Locally

1. Clone your REPO to local using git clone.
2. Install Jekyll building environment, including Ruby, RubyGems, GCC and Make following the installation guide.
3. Run bash run_server.sh to start Jekyll livereload server.
4. Open http://127.0.0.1:4000 in your browser.
5. If you change the source code of the website, the livereload server will automatically refresh.
6. When you finish the modification of your homepage, commit your changings and push to your remote REPO using git command.

Acknowledges

• AcadHomepage incorporates Font Awesome, which is distributed under the terms of the SIL OFL 1.1 and MIT License.
• AcadHomepage is influenced by the github repo (mmistakes/minimal-mistakes)[https://github.com/mmistakes/minimal-mistakes], which is distributed under the MIT License.
• AcadHomepage is influenced by the github repo (academicpages/academicpages.github.io)[https://github.com/academicpages/academicpages.github.io], which is distributed under the MIT License.