English | 中文
Welcome to Tangerine! This is a Jekyll theme designed specifically for personal blogs.
You are free to use this blog theme for your own blog.
Before building, please install Ruby (≥ 3.4.0) and Jekyll, then install dependencies:
bundle installStart local server:
jekyll serveThen use Live Server to preview with live updates.
Most settings are in the _config.yml file, which you can modify according to your needs.
Blog posts are stored in the _posts folder, with naming format YYYY-MM-DD-title.md. Blog post headers should contain the following information:
layout: post
title: "Genshin Impact Gameplay Guide"
date: 2000-01-01 00:00:00 +0800
categories: Gaming // Only one category allowed
tags: Open-World RPG Genshin-Impact // Multiple tags separated by spaces
summary: "This article is a Genshin Impact gameplay guide, introducing basic gameplay, character development, resource acquisition, and more to help new players get started quickly." // Optional
comments: false // If set to true, comments section will be displayed; otherwise hidden
mathjax: true // Optional, defaults to false. If set to true, enables math formula support
mermaid: true // Optional, defaults to false. If set to true, enables flowchart support
copyrights: Original // If set to "Original", copyright notice will be displayed at the end; otherwise hidden
draft: true // Optional, defaults to false. If set to true, article won't appear on homepage
archived: true // Optional, defaults to false. If set to true, article will be marked as archivedYou may also need to modify workflow files in the .github folder, website icon favicon.svg, and CNAME to suit your needs.
Images in articles are stored in the assets/post/images folder. When referencing images, please use relative paths, for example:
The scripts folder provides scripts to help convert images to webp format and automatically identify and clean unused images. If you need to run scripts, please install the webp tool first.
You can use test articles in the _test folder for testing.
See Plugin Testing for details.
| Basic Features | Content Organization | User Experience | Enhanced Features | Extension Plugins |
|---|---|---|---|---|
| Custom Theme | Article Categories | Responsive Design | Code Highlighting | GitHub Plugin |
| RSS Feed | Article Tags | Theme Switching | Code Copy | Image Layout Plugin |
| Comment System | Article Series | Accessibility | Formula Support | iframe Plugin |
| SEO Optimization | Table of Contents | Article Search | Flowchart Support | Result Preview Plugin |
| Performance Optimization | Article Archive | Article Sharing | Content Folding | External Reference Plugin |
| Draft System | Copyright Notice | Article Summary | ||
| Article Recommendations | Fullscreen Display |
This blog is licensed under MIT.