Primer 主题使用教程

Primer 主题使用教程

primer Primer is a Jekyll theme for GitHub Pages 项目地址: https://gitcode.com/gh_mirrors/pri/primer

1. 项目介绍

Primer 是一个为 GitHub Pages 设计的 Jekyll 主题。它旨在为 GitHub Pages 用户提供一个快速、简单的方式来创建他们的第一个（或第 100 个）网站。Primer 主题满足大多数用户的需求，同时提供了用户自定义的机会，如添加自定义 CSS 或修改默认布局。

2. 项目快速启动

2.1 安装依赖

首先，确保你已经安装了 Ruby 和 Bundler。然后，克隆项目到本地：

git clone https://github.com/pages-themes/primer.git
cd primer

2.2 配置 _config.yml

在你的站点根目录下，创建或编辑 _config.yml 文件，添加以下内容：

remote_theme: pages-themes/primer@v0.2.0
plugins:
  - jekyll-remote-theme

2.3 预览站点

在本地预览你的站点：

bundle exec jekyll serve

然后在浏览器中访问 http://localhost:4000 查看效果。

3. 应用案例和最佳实践

3.1 自定义样式

如果你想添加自定义样式，可以在站点根目录下创建 /assets/css/style.scss 文件，并添加以下内容：

---
---
@import "{{ site.theme }}";

// 添加你的自定义 CSS 或 Sass

3.2 修改布局

如果你想修改主题的 HTML 布局，可以复制原始模板并进行自定义。例如，创建 /layouts/default.html 文件，并粘贴原始布局内容进行修改。

4. 典型生态项目

4.1 GitHub Pages

GitHub Pages 是一个静态站点托管服务，直接从 GitHub 仓库托管你的个人、组织或项目页面。Primer 主题是 GitHub Pages 的官方主题之一，适合用于个人博客、项目文档等。

4.2 Jekyll

Jekyll 是一个简单的、博客感知的静态站点生成器。Primer 主题是基于 Jekyll 构建的，适合用于生成静态网站。

4.3 GitHub Actions

GitHub Actions 是一个持续集成和持续交付 (CI/CD) 平台，可以自动化你的软件开发工作流程。你可以使用 GitHub Actions 来自动化构建和部署你的 Jekyll 站点。

通过以上步骤，你可以快速启动并自定义 Primer 主题，用于你的 GitHub Pages 站点。

primer Primer is a Jekyll theme for GitHub Pages 项目地址: https://gitcode.com/gh_mirrors/pri/primer