less-style-please

Docs Language: 中文 | English

纯文本风格Jekyll博客主题，fork自rigggraz的no_style_please¹，具有基于分类的树形结构，可系统地组织关于不同主题的文章，支持手动索引外部平台的内容，可将你的全部创作统一整合为一个网站。

设计

继承

• 极简且克制的设计风格，适合主要专注于文本内容的网站
• 日夜主题

改进

• 配色方案改为低饱和度、低对比度的风格
• 表格自适应与隔行变色
• 自托管的中文webfont

字体搭配分为四个层次：

	首选字体	候补字体
通用内容	Avenir Next 苹方	Segoe UI, HarmonyOS Sans, Clear Sans🌐 思源黑体 (Noto Sans CJK SC), 思源黑体 CN (Noto Sans SC), 更纱黑体, sans-serif
文学性内容	EB Garamond🌐 思源宋体 (Noto Serif CJK SC)	Adobe Garamond Pro, Garamond, Palatino 思源宋体 CN🌐 (Noto Serif SC), serif
元数据 引用 注释	Ysabeau🌐 霞鹜文楷	霞鹜文楷轻便版🌐, 华文细黑, 冬青黑体, sans-serif
表格 代码	等距更纱黑体	Ubuntu Mono, Inconsolata, Iosevka, JetBrains Mono🌐, Monaco, Source Code Pro, 思源黑体HW (Noto Sans Mono CJK), 文泉驿等宽微米黑, monopace

标🌐的字体使用cn-font-split切割为细粒度webfont并托管在/assets/OpenFonts目录，以期获得稳定的跨平台效果。

考虑到流量消耗，各大系统均预装的黑体并未托管webfont。安卓Droid Sans Fallback缺字重的问题通过浏览器font-synthesis合成解决。Safari似乎有可变Webfont重复合成字重的bug，考虑到iOS预装的苹方不缺字重，干脆禁用了macOS与iOS的font-synthesis。

思源黑体HW (Noto Sans Mono CJK)与文泉驿等宽微米黑均未明显区分1ilIL、0O的等宽字体，不算特别适合代码显示。但考虑到本博客表格多于代码，等宽字族的设计主要以西文宽度等于0.5、0.6个中文字符为标准，以满足表格中文、数字、英文混排的对齐需求。

帖子语法

示例页面: markdown -> 网页

基础元数据

帖子必须按以下形式存储和命名: /category/sub-category/_post/yyyy-mm-dd-title.md

标题

文件名 yyyy-mm-dd-title.md 已包含帖子标题。可通过front matter中的声明覆盖：

---
title: yyyy-mm-dd
---

日期

文件名 yyyy-mm-dd-title.md 已包含创建日期。可通过front matter中的声明覆盖：

---
date: yyyy-mm-dd
---

帖子发布后，如需进一步编辑，请在正文中添加新语法：

---
last_modified_at: yyyy-mm-dd
---

如果定义了 last_modified_at，则更新日期将在帖子的元数据模块中呈现。这个属性对于sitemap²也非常实用

分类

建议用目录的层级设置类别： /category/sub-category/_post/yyyy-mm-dd-title.md

如果更喜欢全部帖子混在一块儿的管理方式，也可以在front matter定义类别：

---
categories: [category, sub-category]
---

标签

---
tags: [tags1, tags2]
---

按需设置。帖子的标签会在正文前的元数据模块呈现。

样式

---
layout: post
---

本主题定义了有五种样式

• 会出现在文章列表的样式
  • post：两端对齐，在正文前渲染元数据（标签、创建日期、更新日期、重定向链接）
  • poetry: 居中对齐，不渲染元数据
  • redirect: 以 page 为蓝本，重定向到 redirect_to 定义的地址。放置在_posts目录内，可以让站外内容以与 post 相同的优先级排列在文章列表
• 不出现在文章列表的样式
  • page：以 post为蓝本, 去掉元数据和目录
  • redirect: 以 page 为蓝本，重定向到 redirect_to 定义的地址。不放置在_posts目录内，可以作为不外显的跳转页使用
  • archive: 文章列表本身

目录³

---
toc: true
---

重定向

从本帖跳转到新URL

在跳出帖用如下语法定义

---
layout: redirect
redirect_to: /newdir/newpage
---

由于Github不支持服务器端的301重定向，这里提供三种客户端重定向方式：

• 利用 http refresh meta tag 重定向
• 利用 javascript 重定向
• 会在正文前渲染一个指向所设定URL的超链接，前两种方式都失效的情况下，用户依旧可以手动点击

此语法不仅适用于重定向网站内的页面，还可以用于重定向网站外的文章，以便外部内容可以获得与网站上的帖子相同的元数据索引，并显示在同一帖子列表中。当您想要将在不同平台上发布的所有内容合并到一个地方时，它可能会非常方便。

从站内旧URL跳转到本帖

在目标帖用如下语法定义

---
redirect_from:
  - https://example.com/oldurl
  - /old-dir/old-url-1
  - /old-dir/old-url-2
---

适合修改过目录名称、或者把以前在站外发布的内容重新搬回站内的场景

这个功能依赖jekyll-redirect-from插件⁴。同时会在帖子元数据模块中创建日期的位置渲染一个指向第一行URL的超链接。

阻止搜索引擎编入索引

noindex 是一个包含 meta 标记或 HTTP 响应标头的规则集，用于防止支持 noindex 规则的搜索引擎（例如 Google）将内容编入索引。当 Googlebot 抓取该网页并发现该标记或标头时，Google 就会完全阻止该网页出现在 Google 搜索结果中，不论是否有其他网站链接到该网页。

---
noindex: true
---

首字下沉

---
dropcap: true
---

指定帖子语言

如果文章使用的语言不是 _config.yml 中默认的语言，可以在 front matter 定义 locale：

---
locale: en
---

在 Html 头部插入任何字符串

通过 custom_head 语法定义的任意字符串都将插入到渲染的 html 文件头。

---
custom_head: ""
---

例如，如果您希望帖子不要被搜索引擎收录，只需在 front matter 输入 custom_head: "<meta name='robots' content='noindex'>"

站点配置

编辑根目录下的 /_config.yml 以进行网站配置

站点基础信息

请阅读 jekyll-seo-tag 文档⁵

PWA

图标和Manifest.json

• 从您的设计软件中导出应用图标（或使用在线工具生成它们）
  • 矢量图标 favicon.svg 🛠️在线生成
  • 32x32 favicon.ico, iOS使用的 180x180 png 🛠️在线生成
  • chrome PWA 使用的 192x192 and 512x512 png 🛠️在线生成
• 将图标放在项目的根目录下
• 在 _config.yml 按实际情况修改图标的文件名

favicon_legacy: "/favicon.ico" # legacy 'favicon.ico' at the root folder of your site, it is highly recommended not changing this name
favicon_svg_xml: "/favicon.svg" # name+extension of modern vector favicon
favicon_ios: "/apple-touch-icon.png" # icon for Safari
webmanifest: "/site.webmanifest" # icon config file for Chrome. and don't forget to check the favicon names at webmanifest.
ms_tile_color: "#da532c" # hex background for windows 8.1~10 tile. and don't forget to configure your tile icons at "/browserconfig.xml"

Service-Worker.js

请阅读jekyll-pwa-workbox文档⁶

文章列表

在 /category/index.md 创建每个分类的文章列表，使用以下front matter：

---
layout: archive
which_category: category name
title: page title
---
[optional]you could add some content here, it will be rendered before post list

存档页面的模板存储在 _layouts/archive.html

首页

首页内容存储在项目根目录下的 /index.md 中。

---
layout: home
---
[optional]you could add some content here, it will be rendered after menu

首页的列表存储在 /_data/menu.yml，您可以从主页设置到指向存档页面的链接，详细步骤请阅读 no-style-please 上的原始文档¹。

Markdown 解析器

Jekyll默认的kramdown⁷引擎有一个bug，会将任何未转义的 | 渲染为单行表，该错误已经存在了 [数十年](https://stackoverflow.com/questions/23751917/how-do-you-disable-tables-in-kramdown）。在 kramdown 和 jekyll 的存储库中，时不时都会出现提及该错误的 issue，其中大多数都因超时而关闭。考虑到该 bug 修复基本无望，我的主题版本中默认的 markdown 引擎设置为redcarpet⁸。

默认启用 6 种非标准标记符语法："tables", "autolink", "strikethrough", "highlight", "footnotes", "with_toc_data"。更多用法请阅读redcarpet⁸上的原始文档。

---

Footnotes

1. no_style_please ↩ ↩²

2. jekyll-sitemap ↩

3. jekyll-toc ↩

4. jekyll-redirect-from ↩

5. jekyll-seo-tag ↩

6. jekyll-pwa-workbox ↩

7. kramdown-parser-gfm ↩

8. redcarpet ↩ ↩²