## 1. Project Overview & Quickstart (yutiansut/BEST_PRACTICES)

# BEST_PRACTICES

Open-source repository yutiansut/BEST_PRACTICES

### Repository Details
- **Repository:** [yutiansut/BEST_PRACTICES](https://github.com/yutiansut/BEST_PRACTICES)
- **Primary Language:** Code

*Note: High-volume repository documentation is actively indexed and synchronized by YakaAI.*

## 2. Official Technical Reference & Guides (yutiansut/yutiansut.github.io)

## File: README_de.md

### Diese Datei wird automatisch von [Google Translate](https://translate.google.com/) übersetzt. Wenn es Fehler gibt, lesen Sie bitte [die englische Version](https://github.com/yaoyao-liu/minimal-light/blob/master/README.md) und erstellen Sie eine [Pull-Anfrage](https://github.com/yaoyao-liu/minimal-light/pulls), um diese zu beheben. Vielen Dank.
# Das Minimal Light Thema

[](https://github.com/yaoyao-liu/minimal-light/blob/main/LICENSE)

\[[Demo](https://minimal-light-theme.yliu.me/)\]  \[[English](https://github.com/yaoyao-liu/minimal-light/blob/master/README.md) | [简体中文](https://github.com/yaoyao-liu/minimal-light/blob/master/README_zh_Hans.md) | [繁體中文](https://github.com/yaoyao-liu/minimal-light/blob/master/README_zh_Hant.md)\]
 
*Dies ist der Quellcode meiner Homepage. Ich baue diese Website basierend auf [minimal](https://github.com/orderedlist/minimal).*

*Sie können den Quellcode jederzeit verwenden und freigeben.*

## Eigenschaften

- Einfaches und elegantes persönliches Homepage-Thema
- Jekyll-Theme, wird automatisch von GitHub-Seiten bereitgestellt
- Grundlegende Suchmaschinenoptimierung
- Handyfreundlich
- Support Markdown 
- Unterstützt den dunklen Modus

## Verwendung

### Verwenden auf GitHub

Um dieses Thema zu verwenden, fügen Sie dem `_config.yml` Ihres Repositorys Folgendes hinzu:
```yaml
remote_theme: yaoyao-liu/minimal-light
```

Bitte beachten Sie, dass durch Hinzufügen der obigen Zeile alle Standardeinstellungen in diesem Repository direkt auf Ihre angewendet werden.

Wenn Sie Dateien bearbeiten möchten (z. B. `index.md`), müssen Sie sie dennoch in Ihr Repository kopieren. 

Sie können dieses Repository auch verzweigen (oder [Verwenden Sie dieses Repository als Vorlage](https://docs.github.com/de/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template)) und ändern Sie den Namen in `your-username.github.io`.

Dann müssen Sie die GitHub-Seiten für dieses Repository aktivieren, indem Sie die Schritte [hier](https://docs.github.com/de/pages/getting-started-with-github-pages/creating-a-github-pages-site#creating-your-site) ausführen.

### Lokal mit Jekyll verwenden

*Sie müssen [Ruby](https://www.ruby-lang.org/en/) und [Jekyll](https://jekyllrb.com/) fisrt installieren.*

Klonen Sie dieses Repository:

```bash
git clone https://github.com/yaoyao-liu/minimal-light.git
cd minimal-light
```
Installieren und ausführen:

```bash
bundle install
bundle exec jekyll server
```

Zeigen Sie die Live-Seite mit `localhost` an: 
<http://localhost:4000>. Sie können die HTML-Dateien im Ordner `_site` abrufen.

## Customizing

### Konfigurationsvariablen

Das Minimal Light-Thema berücksichtigt die folgenden Variablen, wenn es in der `_config.yml` Ihrer Site festgelegt ist:

  ```yaml
# Grundinformation
title: Ihren Namen
position: Ph.D. Student
affiliation: Ihre Zugehörigkeit
email: yourname (at) example.edu

# Suchmaschinenoptimierung (SEO)
# Die folgenden Informationen werden verwendet, um den Website-Traffic von Suchmaschinen, z. B. Google, zu verbessern.
keywords: minimal light
description: The Minimal Light is a simple and elegant jekyll theme for academic personal homepage.
canonical: https://minimal-light-theme.yliu.me/

# Verknüpfungen
# Wenn Sie eine davon nicht benötigen, können Sie die entsprechende Zeile löschen.
google_scholar: https://scholar.google.com/
cv_link: files/Curriculum_Vitae.pdf
github_link: https://github.com/
linkedin: https://www.linkedin.com/
twitter: https://twitter.com/

# Bilder (z. B. Ihr Profilbild und das Favicon Ihrer Website)
# "favicon" und "favicon_dark" werden für den Hell- bzw. Dunkelmodus verwendet.
avatar: ./assets/img/avatar.png
favicon: ./assets/img/favicon.png
favicon_dark: ./assets/img/favicon-dark.png

# Google Analytics ID
# Bitte entfernen Sie dies, wenn Sie Google Analytics nicht verwenden
google_analytics: UA-111540567-4
  ```
### Bearbeiten von `index.md`

Erstellen Sie `index.md` und fügen Sie Ihre persönlichen Daten hinzu (z. B. Veröffentlichungen, Recherchen).

### Stylesheet

Wenn Sie Ihre eigenen benutzerdefinierten Stile hinzufügen möchten:

1. Erstellen Sie auf Ihrer Site eine Datei mit dem Namen `/assets/css/style.scss`
2. Fügen Sie den folgenden Inhalt genau wie gezeigt oben in die Datei ein:

    ```scss
    ---
    ---

    @import "{{ site.theme }}";
    ```
3. Fügen Sie jedes benutzerdefinierte CSS (oder Sass, einschließlich Importe), das Sie möchten, unmittelbar nach der Zeile `@import` hinzu

### Layouts

Wenn Sie das HTML-Layout des Themas ändern möchten:

1. [Kopieren Sie die Originalvorlage](https://github.com/yaoyao-liu/minimal-light/blob/master/_layouts/homepage.html) aus dem Repository des Themas(*Tipp: Klicken Sie auf "raw", um das Kopieren zu vereinfachen*)
2. Erstellen Sie auf Ihrer Site eine Datei mit dem Namen `/_layouts/homepage.html`
3. Fügen Sie den im ersten Schritt kopierten Standardlayoutinhalt ein
4. Passen Sie das Layout nach Ihren Wünschen an

## Lizenz

Diese Arbeit unterliegt den Bestimmungen einer [Creative Commons Zero v1.0 Universal](https://github.com/yaoyao-liu/minimal-light/blob/master/LICENSE) Lizenz. 

## Danksagung

Unser Projekt verwendet den Quellcode aus den folgenden Repositorys:

* [pages-themes/minimal](https://github.com/pages-themes/minimal)

* [orderedlist/minimal](https://github.com/orderedlist/minimal)

* [al-folio](https://github.com/alshedivat/al-folio)

---

## File: README_zh_Hans.md

# Minimal Light 主题

[](https://github.com/yaoyao-liu/minimal-light/blob/main/LICENSE)

\[[在线演示](https://minimal-light-theme.yliu.me/)\] \[[繁體中文](https://github.com/yaoyao-liu/minimal-light/blob/master/README_zh_Hant.md) | [English](https://github.com/yaoyao-liu/minimal-light/blob/master/README.md) | [Deutsche](https://github.com/yaoyao-liu/minimal-light/blob/master/README_de.md)\]
 
*这个项目包含我主页的源代码. 基于 GitHub 官方主题之一 [minimal](https://github.com/orderedlist/minimal) 创建*

*如果您喜欢这个项目，欢迎您使用和分享*

## 项目特点

- 简单优雅的学术个人主页模板
- 基于 Jekyll, 可以在 GitHub Pages 服务下自动部署
- 基本的搜索引擎优化
- 移动端适配
- 支持 Markdown
- 支持自动的暗黑模式

## 使用指南
### 在GitHub上使用

只要在你的项目中添加如下内容的`_config.yml`文件，GitHub Pages 服务就会使用该主题部署网页:

```yaml
remote_theme: yaoyao-liu/minimal-light
```
请注意：添加上述内容到你的项目，会直接应用这个仓库的所有的默认设置。

如果你希望编辑任何文件（例如：`index.md`)，你仍需要把该文件拷贝到你的项目中。

你也可以直接 fork 这个仓库(或者[使用这个仓库作为模板](https://docs.github.com/cn/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template))，然后把名字改为`your-username.github.io`.

然后，你可以根据[这里的说明](https://docs.github.com/cn/pages/getting-started-with-github-pages/creating-a-github-pages-site#creating-your-site)开启这个仓库的GitHub Pages服务。

### 通过Jekyll在本地使用

*首先你需要安装 [Ruby](https://www.ruby-lang.org/en/) 和 [Jekyll](https://jekyllrb.com/).*

克隆这个项目:

```bash
git clone https://github.com/yaoyao-liu/minimal-light.git
cd minimal-light
```
安装并运行:

```bash
bundle install
bundle exec jekyll server
```
在`localhost`预览网页:
<http://localhost:4000>. 
你可以在`_site`文件夹中找到 html 文件.

## 自定义内容

### 配置变量

Minimal Light 主题有以下的变量, 你可以在`_config.yml`文件中修改:
  
  ```yaml
# 基本信息
title: 你的名字
position: Ph.D. Student
affiliation: 你的单位
email: yourname (at) example.edu

# 搜索引擎优化 (SEO)
keywords: minimal light
description: 在这里输入网页描述.
canonical: https://minimal-light-theme.yliu.me/

# 链接
google_scholar: https://scholar.google.com/
cv_link: files/Curriculum_Vitae.pdf
github_link: https://github.com/
linkedin: https://www.linkedin.com/
twitter: https://twitter.com/

# 图片路径
avatar: ./assets/img/avatar.png
favicon: ./assets/img/favicon.png
favicon_dark: ./assets/img/favicon-dark.png

# Google Analytics ID
google_analytics: UA-111540567-4
  ```
### 编辑 `index.md`

创建`index.md`并添加你的个人信息(如：发表的论文，研究课题等).

### 网页样式（CSS)

如果你需要修改网页的风格（基于 CSS）:

1. 在你的项目中创建`/assets/css/style.scss`文件
2. 在该文件的顶端加入如下内容:

    ```scss
    ---
    ---

    @import "{{ site.theme }}";
    ```
3. 在`@import`那一行添加自定义 CSS (或 Sass)格式

### 网页样式（基于 html）

如果你需要修改网页的 html 样式:

1. 从本项目中[复制原始模板](https://github.com/yaoyao-liu/minimal-light/blob/master/_layouts/homepage.html)(*小提示: 点击"raw"可以直接显示原始文件, 拷贝起来更方便*)
2. 在你的项目中创建`/_layouts/homepage.html`文件
3. 把第一步中复制的原始模板粘贴进去
4. 根据自己的需求修改 html 文件

## 许可证

这个项目使用 [Creative Commons Zero v1.0 Universal](https://github.com/yaoyao-liu/minimal-light/blob/master/LICENSE) 许可证.

## 致谢

我们的项目用到了以下项目的源代码:

* [pages-themes/minimal](https://github.com/pages-themes/minimal)

* [orderedlist/minimal](https://github.com/orderedlist/minimal)

* [al-folio](https://github.com/alshedivat/al-folio)

---

## File: README_zh_Hant.md

### 這份說明文檔僅將文字從簡體中文轉化為繁體中文，並沒有針對繁體中文地區的名詞和使用習慣進行優化。如果有錯誤或者表述不清楚的內容，可以參照[英文版本](https://github.com/yaoyao-liu/minimal-light/blob/main/README.md)。歡迎通過 [pull requests](https://github.com/yaoyao-liu/minimal-light/pulls) 更正該文檔。

# Minimal Light 主題

[](https://github.com/yaoyao-liu/minimal-light/blob/main/LICENSE)

\[[在線演示](https://minimal-light-theme.yliu.me/)\] \[[简体中文](https://github.com/yaoyao-liu/minimal-light/blob/master/README_zh_Hans.md) | [English](https://github.com/yaoyao-liu/minimal-light/blob/master/README.md) | [Deutsche](https://github.com/yaoyao-liu/minimal-light/blob/master/README_de.md)\]
 
*這個項目包含我主頁的源代碼. 基於 GitHub 官方主題之一 [minimal](https://github.com/orderedlist/minimal) 創建*

*如果您喜歡這個項目，歡迎您使用和分享*

## 項目特點

- 簡單優雅的學術個人主頁模板
- 基於 Jekyll, 可以在 GitHub Pages 服務下自動部署
- 基本的搜索引擎優化
- 移動端適配
- 支持 Markdown
- 支持自動的暗黑模式

## 使用指南
### 在GitHub上使用

只要在你的項目中添加如下內容的`_config.yml`文件，GitHub Pages 服務就會使用該主題部署網頁:

```yaml
remote_theme: yaoyao-liu/minimal-light
```
請注意：添加上述內容到你的項目，會直接應用這個倉庫的所有的默認設置。

如果你希望編輯任何文件（例如：`index.md`)，你仍需要把該文件拷貝到你的項目中。

你也可以直接 fork 這個倉庫(或者[使用這個倉庫作為模板](https://docs.github.com/cn/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template))，然後把名字改為`your-username.github.io`.

然後，你可以根據[這裡的說明](https://docs.github.com/cn/pages/getting-started-with-github-pages/creating-a-github-pages-site#creating-your-site)開啟這個倉庫的GitHub Pages服務。

### 通過Jekyll在本地使用

*首先你需要安裝 [Ruby](https://www.ruby-lang.org/en/) 和 [Jekyll](https://jekyllrb.com/).*

克隆這個項目:

```bash
git clone https://github.com/yaoyao-liu/minimal-light.git
cd minimal-light
```
安裝並運行:

```bash
bundle install
bundle exec jekyll server
```
在`localhost`預覽網頁:
<http://localhost:4000>. 
你可以在`_site`文件夾中找到 html 文件.

## 自定義內容

### 配置變量

Minimal Light 主題有以下的變量, 你可以在`_config.yml`文件中修改:

  ```yaml
# 基本信息
title: 你的名字
position: Ph.D. Student
affiliation: 你的單位
email: yourname (at) example.edu

# 搜索引擎優化 (SEO)
keywords: minimal light
description: 在這裡輸入網頁描述.
canonical: https://minimal-light-theme.yliu.me/

# 鏈接
google_scholar: https://scholar.google.com/
cv_link: files/Curriculum_Vitae.pdf
github_link: https://github.com/
linkedin: https://www.linkedin.com/
twitter: https://twitter.com/

# 圖片路徑
avatar: ./assets/img/avatar.png
favicon: ./assets/img/favicon.png
favicon_dark: ./assets/img/favicon-dark.png

# Google Analytics ID
google_analytics: UA-111540567-4
  ```
### 編輯 `index.md`

創建`index.md`並添加你的個人信息(如：發表的論文，研究課題等).

### 網頁樣式（CSS)

如果你需要修改網頁的風格（基於 CSS）:

1. 在你的項目中創建`/assets/css/style.scss`文件
2. 在該文件的頂端加入如下內容:

    ```scss
    ---
    ---

    @import "{{ site.theme }}";
    ```
3. 在`@import`那一行添加自定義 CSS (或 Sass)格式

### 網頁樣式（基于 html）

如果你需要修改網頁的 html 樣式:

1. 從本項目中[複製原始模板](https://github.com/yaoyao-liu/minimal-light/blob/master/_layouts/homepage.html)(*小提示: 點擊"raw "可以直接顯示原始文件, 拷貝起來更方便*)
2. 在你的項目中創建`/_layouts/homepage.html`文件
3. 把第一步中復制的原始模板粘貼進去
4. 根據自己的需求修改 html 文件

## 許可證

這個項目使用 [Creative Commons Zero v1.0 Universal](https://github.com/yaoyao-liu/minimal-light/blob/master/LICENSE) 許可證.

## 致謝

我們的項目用到了以下項目的源代碼:

* [pages-themes/minimal](https://github.com/pages-themes/minimal)

* [orderedlist/minimal](https://github.com/orderedlist/minimal)

* [al-folio](https://github.com/alshedivat/al-folio)