jekyll-theme-yat

机器翻译正文由机器翻译自项目原始文档（英文），排版经程序统一处理，可能存在偏差，请以原项目仓库为准。

Jekyll 主题，适合优雅的作家。

嘿，很高兴见到你，你找到了这个 Jekyll 主题。这里的 YAT（Yet Another Theme） 是一个现代响应式主题。对于作家和文章来说，它相当清晰、干净而整洁。如果你是一个优雅的作家并且专注于内容，不要错过它。

喜欢这个优雅的主题吗？你可以给它加星或赞助我！
我会尊重你重要的支持并说声谢谢你！

横幅

功能

• 支持漂亮的夜间模式。
• 现代响应式网页设计。
• 完整布局 home、post、tags、archive 和 about。
• 使用 Font Awesome 5 图标。
• 带有图片和视频的漂亮页面横幅。
• 使用 highlight.js 的漂亮语法高亮。
• 使用 PhotoSwipe 5 的漂亮图片图库预览。
• 使用 Jekyll Feed 插件支持 RSS。
• 使用 Jekyll Seo Tag 插件优化搜索引擎。
• 使用 Jekyll Sitemap 插件支持站点地图。
• 使用 Jekyll Spaceship 插件支持复杂而灵活的表格。
• 使用 Jekyll Spaceship 插件可选支持 MathJAX 和 LaTeX。
• 使用 Jekyll Spaceship 插件支持媒体（YouTube、Spotify 等）。
• 使用 Jekyll Spaceship 插件支持图表（PlantUML、Mermaid）。
• 支持谷歌翻译。
• 支持新文章标签。
• 支持置顶文章标签。

此外，请访问主题的 Live Demo 网站。

安装

有三种安装方式：

• 作为一个 基于 gem 的主题。
• 作为远程主题（兼容 GitHub Pages）。
• 通过分叉或直接复制所有主题文件到你的项目中。

基于 Gem 的主题方法

将此行添加到你的 Jekyll 网站的 Gemfile ：

gem "jekyll-theme-yat"

并将此行添加到你的 Jekyll 网站的 _config.yml ：

theme: jekyll-theme-yat

然后执行：

$ bundle

或者自己安装为：

$ gem install jekyll-theme-yat

使用 Jekyll Remote Theme 插件的远程主题方法

远程主题类似于基于 Gem 的主题，但不需要 Gemfile 的更改或白名单，使其非常适合托管在 GitHub Pages 的网站。

安装方法：

将此行添加到你的 Jekyll 网站的 Gemfile ：

gem "jekyll-remote-theme", group: :jekyll_plugins

并将此行添加到你的 Jekyll 网站的 _config.yml ：

# theme: owner/name --> Don't forget to remove/comment the gem-based theme option
remote_theme: "jeffreytse/jekyll-theme-yat"

# Add the following to activate the plugin
plugins:
  - jekyll-remote-theme

然后执行：

$ bundle

分叉/克隆项目

您需要更新 github workflow 文件 .github/workflows/build-jekyll.yml 的选项，尤其是确保 jekyll_baseurl 的值是正确的。

无限制的 GitHub Pages

GitHub Pages 在 safe 模式下运行，并且只允许 一组白名单插件/主题。换句话说，第三方 gems 无法正常工作。

要在 GitHub Pages 中无限制地使用第三方 gem：

这里有一个名为 jekyll-deploy-action 的 GitHub Action，可方便地用于 Jekyll 网站部署。👍

使用

添加或更新您可用的布局、包含文件、Sass和/或资源。

开发

要设置您的环境以开发此主题，请运行 bundle install 。

您的主题设置就像一个普通的 Jekyll 站点！要测试您的主题，请运行 bundle exec jekyll serve 并在浏览器中打开 http://localhost:4000 。这将使用您的主题启动一个 Jekyll 服务器。像平时一样添加页面、文档、数据等来测试您的主题内容。当您对主题和内容进行修改时，您的网站将重新生成，并且在刷新浏览器后应该会看到更改，就像平常一样。

当您的主题发布时，只有 _data、_layouts、_includes、_sass 和 assets 中通过 Git 跟踪的文件会被打包。要将自定义目录添加到您的主题 gem 中，请相应编辑 jekyll-theme-yat.gemspec 中的正则表达式。

贡献

问题和拉取请求非常受欢迎。如果你以前从未参与过开源项目，我非常乐意指导你如何创建一个拉取请求。

你可以通过创建一个问题来开始，描述你希望解决的问题，然后我们将从那里开始。

许可

本主题根据 MIT 许可证 授权 © JeffreyTse。