acad-homepage.github.io - GitLite

KO | EN

gitlite — search

#javascript #python #react #llm #golang #go #machine-learning #rust #deep-learning #linux #macos #awesome-list #pytorch #openai

acad-homepage.github.io

(★ 2,908)

AcadHomepage: A Modern and Responsive Academic Personal Homepage

File Explorer

Download Latest Version (.zip)

- - google_scholar_crawler.yaml
- FUNDING.yml
- navigation.yml
- - custom.html
- analytics.html
- author-profile.html
- browser-upgrade.html
- fetch_google_scholar_stats.html
- head.html
- masthead.html
- scripts.html
- seo.html
- sidebar.html
- default.html
- about.md
- _animations.scss
- _archive.scss
- _base.scss
- _buttons.scss
- _footer.scss
- _forms.scss
- _masthead.scss
- _mixins.scss
- _navigation.scss
- _notices.scss
- _page.scss
- _print.scss
- _reset.scss
- _sidebar.scss
- _syntax.scss
- _tables.scss
- _utilities.scss
- _variables.scss
- - academicons.css
  - academicons.min.css
  - collapse.css
  - main.scss
- - academicons.eot
  - academicons.svg
  - academicons.ttf
  - academicons.woff
  - fa-brands-400.eot
  - fa-brands-400.svg
  - fa-brands-400.ttf
  - fa-brands-400.woff
  - fa-brands-400.woff2
  - fa-regular-400.eot
  - fa-regular-400.svg
  - fa-regular-400.ttf
  - fa-regular-400.woff
  - fa-regular-400.woff2
  - fa-solid-900.eot
  - fa-solid-900.svg
  - fa-solid-900.ttf
  - fa-solid-900.woff
  - fa-solid-900.woff2
- - _main.js
  - collapse.js
  - main.min.js
- README-zh.md
- screenshot.png
- .gitignore
- main.py
- requirements.txt
- 500x300.png
- android-chrome-192x192.png
- android-chrome-512x512.png
- apple-touch-icon.png
- favicon-16x16.png
- favicon-32x32.png
- favicon.ico
- site.webmanifest
.gitignore
_config.yml
Gemfile
Gemfile.lock
LICENSE
README.md
run_server.sh

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">
AcadHomepage
</h1>

<div align="center">

[![](https://img.shields.io/github/stars/RayeRen/acad-homepage.github.io)](https://github.com/RayeRen/acad-homepage.github.io)
[![](https://img.shields.io/github/forks/RayeRen/acad-homepage.github.io)](https://github.com/RayeRen/acad-homepage.github.io)
[![](https://img.shields.io/github/issues/RayeRen/acad-homepage.github.io)](https://github.com/RayeRen/acad-homepage.github.io)
[![](https://img.shields.io/github/license/RayeRen/acad-homepage.github.io)](https://github.com/RayeRen/acad-homepage.github.io/blob/main/LICENSE)  | [中文文档](https://raw.githubusercontent.com/RayeRen/acad-homepage.github.io/main/docs/README-zh.md) 
</div>

<p align="center">A Modern and Responsive Academic Personal Homepage</p>

<p align="center">
    <br>
    <img src="docs/screenshot.png" width="100%"/>
    <br>
</p>

Some examples:
- [Demo Page](https://rayeren.github.io/acad-homepage.github.io/)
- [Personal Homepage of the author](https://rayeren.github.io/)

## 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 and rename to `USERNAME.github.io`, where `USERNAME` is your github USERNAME.
1. 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.
    1. 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`.
    1. Click the `Action` of the REPO website and enable the workflows by clicking *"I understand my workflows, go ahead and enable them"*. This github action will generate google scholar citation stats data `gs_data.json` in `google-scholar-stats` branch of your REPO. When you update your main branch, this action will be triggered. This action will also be trigger 08:00 UTC everyday.
1. Generate favicon using [favicon-generator](https://redketchup.io/favicon-generator) and download all generated files to `REPO/images`.
1. Modify the configuration of your homepage `_config.yml`:
    1. `title`: the title of your homepage
    1. `description`: the description of your homepage
    1. `repository`: USER_NAME/REPO_NAME  
    1. `google_analytics_id` (optional): google analytics ID
    1. SEO Related keys (optional): get these keys from search engine consoles (e.g. Google, Bing and Baidu) and paste here.
    1. `author`: the author information of this homepage, including some other websites, emails, city and univeristy.
    1. More configuration details are described in the comments.
1. Add your homepage content in `_pages/about.md`.
    1. You can use html+markdown syntax just same as jekyll.
    1. You can use a `<span>` tag with class `show_paper_citations` and attribute `data` to display the citations of your paper. Set the data to the google scholar paper ID. For
        ```html
        <span class='show_paper_citations' data='DhtAFkwAAAAJ:ALROH1vI_8AC'></span>
        ``` 
        > Q: How to get the google scholar paper ID?   
        > A: Enter your google scholar homepage and click the paper name. Then you can see the paper ID from `citation_for_view=XXXX`, where `XXXX` is the required paper ID.
1. Your page will be published at `https://USERNAME.github.io`.

## Debug Locally

1. Clone your REPO to local using `git clone`.
1. Install Jekyll building environment, including `Ruby`, `RubyGems`, `GCC` and `Make` following [the installation guide](https://jekyllrb.com/docs/installation/#requirements).
1. Run `bash run_server.sh` to start Jekyll livereload server.
1. Open http://127.0.0.1:4000 in your browser.
1. If you change the source code of the website, the livereload server will automatically refresh.
1. 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.