首页>编程相关>其他源码
下载

基本上是基本的 Jekyll 主题

基本上 Basic 是一个 Jekyll 主题，旨在替代默认的 Minima，并添加了一些增强功能：

  • 简洁的响应式设计，具有六种可定制的皮肤
  • 由 JSON 数据支持的简历/简历布局
  • 关于页面布局
  • 由 Algolia 或 Lunr 提供的全站搜索。
  • Disqus 评论和 Google Analytics 支持
  • 通过 Jekyll SEO 标签进行 SEO 最佳实践

安装

如果您运行 Jekyll v3.5+ 并自托管，您可以快速将主题安装为 Ruby gem。如果您使用 GitHub Pages 托管，则可以安装为远程主题或直接将所有主题文件（请参阅下面的结构）复制到您的项目中。

红宝石宝石法

  1. 将此行添加到 Jekyll 站点的Gemfile中： 

     gem "jekyll-theme-basically-basic"

  2. 将此行添加到 Jekyll 站点的_config.yml文件中： 

     theme : jekyll-theme-basically-basic

  3. 然后运行 ​​Bundler 安装主题 gem 和依赖项： 

     bundle install

GitHub 页面方法

GitHub Pages 添加了对任何 GitHub 托管主题的全面支持。

  1. 将gem "jekyll"替换为： 

     gem "github-pages" , group : :jekyll_plugins

  2. 运行bundle update并验证所有 gem 是否正确安装。

  3. 将remote_theme: "mmistakes/[email protected]"添加到您的_config.yml文件中。删除任何其他theme:或remote_theme:条目。

注意：您的 Jekyll 站点应该可以立即在 http://USERNAME.github.io 上查看。如果不是，您可以通过自定义站点来强制重建（有关更多详细信息，请参阅下文）。

如果您在同一 GitHub 用户名下托管多个基于 Jekyll 的站点，则必须使用项目页面而不是用户页面。本质上，您将存储库重命名为USERNAME.github.io以外的名称，并在master上创建一个gh-pages分支。有关如何设置的更多详细信息，请查看 GitHub 的文档。

删除不需要的

如果您分叉或下载了jekyll-theme-basically-basic存储库，您可以安全地删除以下文件和文件夹：

  • .editorconfig
  • .gitattributes
  • .github
  • .scss-lint.yml
  • CHANGELOG.md
  • jekyll-theme-basically-basic.gemspec
  • LICENSE
  • Rakefile
  • README.md
  • screenshot.png
  • /docs
  • /example

升级中

如果您使用的是 Ruby Gem 或 Basic Basic 的远程主题版本，则升级相当轻松。

要检查您当前使用的版本，请查看您构建的网站的源代码，您应该看到类似以下内容： 

 <!--
    Basically Basic Jekyll Theme 1.4.5
    Copyright 2017-2018 Michael Rose - mademistakes.com | @mmistakes
    Free for personal and commercial use under the MIT license
    https://github.com/mmistakes/jekyll-basically-theme/blob/master/LICENSE
-->

在每个.html文件的顶部， /assets/css/main.css和/assets/js/main.js 。

红宝石

如果您使用 Bundler （有Gemfile ），则只需运行bundle update即可；如果没有，则运行gem update jekyll-theme-basically-basic 。

远程主题

验证您在_config.yml中分配了最新版本

 remote_theme: "mmistakes/[email protected]"

注意：如果省略@xxx则将使用主题的当前master分支。建议将remote_theme “锁定”在特定版本，以避免对您的站点引入重大更改。

下一步需要重建您的 GitHub Pages 站点，以便它可以下载最新的主题更新。这可以通过将提交推送到 GitHub 存储库来实现。

如果您目前没有任何内容要推送，则空提交也可以完成工作： 

 git commit --allow-empty -m "Force rebuild of site"

使用 Git

如果您想充分利用 Jekyll + GitHub Pages 工作流程，那么您需要使用 Git。要下拉主题更新，您必须首先确保有上游遥控器。如果您分叉了主题的存储库，那么您很可能就可以开始了。

要仔细检查，请运行git remote -v并验证您是否可以从origin https://github.com/mmistakes/jekyll-theme-basically-basic.git获取。

要添加它，您可以执行以下操作： 

 git remote add upstream https://github.com/mmistakes/jekyll-theme-basically-basic.git

下拉更新

现在您可以使用以下命令提取对主题的master分支所做的任何提交： 

 git pull upstream master

根据分叉后您进行的自定义数量，可能会出现合并冲突。处理任何冲突的文件 Git 标志，暂存您希望保留的更改，然后提交它们。

手动更新文件

处理更新的另一种方法是下载主题——手动用新的布局、包含内容和资源替换布局、包含内容和资源。为了确保您不会错过任何更改，最好查看主题的提交历史记录以了解此后发生的更改。

以下是您需要注意的重要文件夹/文件的快速清单：

姓名
_layouts全部更换。如果您自定义了任何布局，请应用编辑。
_includes全部更换。如果您自定义了任何包含内容，则应用编辑。
assets全部更换。如果您自定义了样式表或脚本，则应用编辑。
_sass全部更换。如果您自定义了 Sass 部分，则应用编辑。
_data/theme.yml安全保存。验证是否没有重大的结构变化或添加。
_config.yml安全保存。验证是否没有重大的结构变化或添加。

注意：如果您没有看到最新版本，请务必刷新浏览器和 CDN 缓存。根据您的托管环境，旧版本的/assets/css/main.css 、 /assets/js/main.js或*.html可能会被缓存。

结构

布局、包含、Sass 部分和数据文件都放置在其默认位置。样式表和脚本位于assets中，以及项目根目录中的一些开发相关文件。

请注意：如果您通过 Ruby Gem 方法安装 Basic Basic，则/_layouts 、 /_includes 、 /_sass和/assets中找到的主题文件将会丢失。这是正常的，因为它们与jekyll-theme-basically-basic gem 捆绑在一起。 

 jekyll-theme-basically-basic
├── _data                      # data files
|  └── theme.yml               # theme settings and custom text
├── _includes                  # theme includes and SVG icons
├── _layouts                   # theme layouts (see below for details)
├── _sass                      # Sass partials
├── assets
|  ├── javascripts
|  |  └── main.js
|  └── stylesheets
|     └── main.scss
├── _config.yml                # sample configuration
└── index.md                   # sample home page (all posts/not paginated)

全新开始

创建Gemfile并安装主题后，您需要添加和编辑以下文件：

  • _config.yml
  • /_data/theme.yml
  • index.md

注意：有关如何在主页启用分页功能的说明，请参阅下面的分页文档。

从jekyll new开始

使用jekyll new命令将使您能够以最快的速度启动并运行。

按照上面的说明编辑_config.yml并创建_data/theme.yml ，然后就可以开始了。

配置

站点范围的元素（ lang 、 title 、 description 、 logo 、 author等）的配置发生在项目的_config.yml中。请参阅此存储库中的示例配置以获取更多参考。

描述
lang用于指示文本的语言（例如 en-US、en-GB、fr）
title您网站的标题（例如，Dungan's Awesome Site）
description简短的网站描述（例如，关于grasshopper mash的博客）
url您网站的完整 URL（例如，https://groverloaf.org）
author全球作者信息（见下文）
logo站点范围徽标的路径 ~100x100px（例如，/assets/your-company-logo.png）
twitter_username站点范围内的 Twitter 用户名，用作侧边栏中的链接
github_username站点范围的 GitHub 用户名，用作侧边栏中的链接

有关更多配置选项，请务必查阅以下文档： jekyll-seo-tag 、 jekyll-feed 、 jekyll-paginate和jekyll-sitemap 。

皮肤

该主题有六种不同的皮肤（颜色变化）。要更改外观，请将以下内容之一添加到您的/_data/theme.yml文件中：

skin: default skin: night skin: plum
skin: sea skin: soft skin: steel

谷歌字体

该主题允许您在整个主题中轻松使用 Google 字体。只需将以下内容添加到您的/_data/theme.yml中，并相应地替换字体name和weights 。 

 google_fonts :
  - name : " Fira Sans "
    weights : " 400,400i,600,600i "
  - name : " Fira Sans Condensed "

文本

要更改整个主题中的文本，请将以下内容添加到/_data/theme.yml文件并根据需要进行自定义。 

 t :
  skip_links : " Skip links "
  skip_primary_nav : " Skip to primary navigation "
  skip_content : " Skip to content "
  skip_footer : " Skip to footer "
  menu : " Menu "
  search : " Search "
  site_search : " Site Search "
  results_found : " Result(s) found "
  search_placeholder_text : " Enter your search term... "
  home : " Home "
  newer : " Newer "
  older : " Older "
  email : " Email "
  subscribe : " Subscribe "
  read_more : " Read More "
  posts : " Posts "
  page : " Page "
  of : " of "
  min_read : " min read "
  present : " Present "
  cv_awards : " Awards "
  cv_summary_contact : " Contact "
  cv_summary_contact_email : " Email "
  cv_summary_contact_phone : " Phone "
  cv_summary_contact_website : " Website "
  cv_location : " Location "
  cv_education : " Education "
  cv_education_courses : " Courses "
  cv_interests : " Interests "
  cv_languages : " Languages "
  cv_publications : " Publications "
  cv_references : " References "
  cv_skills : " Skills "
  cv_volunteer : " Volunteer "
  cv_work : " Work "

导航

默认情况下，所有带有title的内部页面都将添加到“画布外”菜单中。要更精细地控制和排序这些菜单链接：

  1. 通过将navigation_pages数组添加到/_data/theme.yml文件来创建自定义列表以覆盖默认设置。

  2. 按照您想要的顺序添加原始页面路径： 

     navigation_pages :
  - about.md
  - cv.md

每个菜单链接的标题和 URL 将分别根据其title和permalink进行填充。

分页

将帖子的主要列表分解为较小的列表，并通过启用分页将它们显示在多个页面上。

  1. 将jekyll-paginate插件包含在您的Gemfile中。 

     group :jekyll_plugins do
  gem "jekyll-paginate"
end

  2. 将jekyll-paginate添加到_config.yml文件中的gems数组以及以下分页设置： 

     paginate : 5  # amount of posts to show per page
paginate_path : /page:num/

  3. 在项目的根目录中创建index.html （或重命名index.md ）并添加以下前面的内容： 

     layout : home
paginate : true

搜索

要启用站点范围的搜索，请将search: true添加到您的_config.yml中。

伦尔（默认）

默认搜索使用Lunr构建所有文档的搜索索引。此方法与 GitHub Pages 上托管的网站 100% 兼容。

注意：只有帖子或页面正文内容的前 50 个单词才会添加到 Lunr 搜索索引中。在_config.yml中将search_full_content设置为true将覆盖此设置并可能影响页面加载性能。

阿尔戈利亚

为了更快、更相关的搜索（参见演示）：

  1. 将jekyll-algolia gem 添加到Gemfile的:jekyll_plugins部分。 

     group :jekyll_plugins do
  gem "jekyll-feed"
  gem "jekyll-seo-tag"
  gem "jekyll-sitemap"
  gem "jekyll-paginate"
  gem "jekyll-algolia"
end

    完成此操作后，通过运行bundle install下载所有依赖项。

  2. 在_config.yml文件中将搜索提供程序从lunr切换到algolia ： 

     search_provider : algolia

  3. 将以下 Algolia 凭据添加到您的_config.yml文件中。如果您没有 Algolia 帐户，您可以开设免费的社区计划。登录后，您可以从仪表板获取您的凭据。 

     algolia :
  application_id : # YOUR_APPLICATION_ID
  index_name : # YOUR_INDEX_NAME
  search_only_api_key : # YOUR_SEARCH_ONLY_API_KEY
  powered_by : # true (default), false

  4. 设置凭据后，您可以使用以下命令运行索引： 

     ALGOLIA_API_KEY=your_admin_api_key bundle exec jekyll algolia

    对于 Windows 用户，您必须使用set来分配ALGOLIA_API_KEY环境变量。 

     set ALGOLIA_API_KEY=your_admin_api_key
bundle exec jekyll algolia

    请注意， ALGOLIA_API_KEY应设置为您的管理 API 密钥。

要将 Algolia 搜索与 GitHub Pages 托管站点一起使用，请遵循此部署指南。或者本指南用于在 Netlify 上进行部署。

注意： Jekyll Algolia 插件可以通过多种方式进行配置。请务必查看有关如何排除文件和其他有价值的设置的完整文档。

作者

作者信息用作“按行”帖子的元数据，并通过_config.yml中的以下前面内容传播 Twitter 摘要卡的creator字段： 

 author :
  name : John Doe
  twitter : johndoetwitter
  picture : /assets/images/johndoe.png

站点范围内的作者信息可以通过相同的方式在文档的前文中被覆盖： 

 author :
  name : Jane Doe
  twitter : janedoetwitter
  picture : /assets/images/janedoe.png

或者通过在文档的前面指定site.data.authors中存在的相应键。例如，文档的前面有以下内容： 

 author : megaman

_data/authors.yml中有以下内容： 

 megaman :
  name : Mega Man
  twitter : megamantwitter
  picture : /assets/images/megaman.png

drlight :
  name : Dr. Light
  twitter : drlighttwitter
  picture : /assets/images/drlight.png

目前， author.picture仅在layout: about中使用。建议尺寸为300 x 300像素。

阅读时间

要启用阅读时间计数，请将read_time: true添加到帖子或页面的 YAML Front Matter。

评论（来自 Disqus）

或者，如果您有 Disqus 帐户，则可以在每篇帖子下方显示评论部分。

要启用 Disqus 评论，请将您的 Disqus 短名称添加到项目的_config.yml文件中： 

  disqus :
    shortname : my_disqus_shortname

默认情况下启用注释，并且仅在使用以下环境值构建时才会出现在生产中： JEKYLL_ENV=production

如果您不想显示特定帖子的评论，可以通过在该帖子的前言中添加comments: false来禁用它们。

谷歌分析

要启用 Google Analytics，请将您的跟踪 ID 添加到_config.yml如下所示： 

  google_analytics : UA-NNNNNNNN-N

与评论类似，Google Analytics 跟踪脚本仅在使用以下环境值时才会出现在生产环境中： JEKYLL_ENV=production 。

版权

默认情况下，页脚中的版权行显示当前年份（在构建时），后跟网站的标题。例如© 2018 Basically Basic.

如果您想更改此设置，请使用适当的文本将copyright添加到您的_config.yml文件中： 

 copyright : " My custom copyright. "

布局

该主题提供了以下布局，您可以通过在每个页面上设置layout Front Matter 来使用这些布局，如下所示： 

---
layout : name
---

layout: default

此布局处理将页面内容放置在标头和页脚元素之间的所有基本页面脚手架。所有其他布局都继承此布局，并在{{ content }}块内提供额外的样式和功能。

layout: post

该布局包含以下前面的内容： 

 # optional alternate title to replace page.title at the top of the page
alt_title : " Basically Basic "

# optional sub-title below the page title
sub_title : " The name says it all "

# optional intro text below titles, Markdown allowed
introduction : |
    Basically Basic is a Jekyll theme meant to be a substitute for the default --- [Minima](https://github.com/jekyll/minima). Conventions and features found in Minima are fully supported by **Basically Basic**.

# optional call to action links
actions :
  - label : " Learn More "
    icon : github  # references name of svg icon, see full list below
    url : " http://url-goes-here.com "
  - label : " Download "
    icon : download  # references name of svg icon, see full list below
    url : " http://url-goes-here.com "

image :  # URL to a hero image associated with the post (e.g., /assets/page-pic.jpg)

# post specific author data if different from what is set in _config.yml 
author :
  name : John Doe
  twitter : johndoetwitter

comments : false  # disable comments on this post

注意：英雄图像可以用透明的“强调”颜色覆盖，以将它们与主题的调色板统一。要启用，请使用以下 Sass 变量覆盖自定义 CSS： 

 $intro-image-color-overlay : true;

layout: page

从视觉上看，此布局的外观和行为与layout: post相同，但有两个细微差别。

  • 作者“按行”和出版日期被省略。
  • Disqus 注释被省略。

layout: home

此布局包含与layout: page ，并添加了以下内容： 

 paginate : true  # enables pagination loop, see section above for additional setup
entries_layout : # list (default), grid

默认情况下，帖子显示在列表视图中。要更改为网格视图，请将entries_layout: grid添加到页面的前面。

layout: posts

此布局显示按发布年份分组的所有帖子。它容纳与layout: page 。

默认情况下，帖子显示在列表视图中。要更改为网格视图，请将entries_layout: grid添加到页面的前面。

layout: categories

此布局显示所有分组类别的帖子。它容纳与layout: page 。

默认情况下，帖子显示在列表视图中。要更改为网格视图，请将entries_layout: grid添加到页面的前面。

layout: tags

此布局显示按标签分组的所有帖子。它容纳与layout: page 。

默认情况下，帖子显示在列表视图中。要更改为网格视图，请将entries_layout: grid添加到页面的前面。

layout: collection

此布局显示按特定集合分组的所有文档。它容纳与layout: page ，并添加了以下内容： 

 collection : # collection name
entries_layout : # list (default), grid
show_excerpts : # true (default), false
sort_by : # date (default) title
sort_order : # forward (default), reverse

要创建一个显示recipes集合中所有文档的页面，您需要在项目的根目录中创建recipes.md并添加以下前言： 

 title : Recipes
layout : collection
permalink : /recipes/
collection : recipes

默认情况下，文档以列表视图显示。要更改为网格视图，请将entries_layout: grid添加到页面的前面。如果您想按标题对集合进行排序，请添加sort_by: title 。如果要反向排序，请添加sort_order: reverse 。

layout: category

此布局显示按特定类别分组的所有帖子。它容纳与layout: page ，并添加了以下内容： 

 taxonomy : # category name
entries_layout : # list (default), grid

默认情况下，帖子显示在列表视图中。要更改为网格视图，请将entries_layout: grid添加到页面的前面。

要创建一个显示分配给类别foo所有帖子的页面，您需要在项目的根目录中创建foo.md并添加以下前言： 

 title : Foo
layout : category
permalink : /categories/foo/
taxonomy : foo

layout: tag

此布局显示按特定标签分组的所有帖子。它容纳与layout: page ，并添加了以下内容： 

 taxonomy : # tag name
entries_layout : # list (default), grid

默认情况下，帖子显示在列表视图中。要更改为网格视图，请将entries_layout: grid添加到页面的前面。

要创建一个显示分配给标签foo bar所有帖子的页面，您需要在项目的根目录中创建foo-bar.md并添加以下前言： 

 title : Foo Bar
layout : tag
permalink : /tags/foo-bar/
taxonomy : foo bar

layout: about

此布局容纳与layout: page ，并添加以下内容来显示作者图片： 

 author :
  name : John Doe
  picture : /assets/images/johndoe.png

建议的picture尺寸约为300 x 300像素。如果author对象没有在关于页面的前面明确设置，主题将默认为_config.yml中设置的值。

如果空白，则不会出现图像。

layout: cv

此布局容纳与layout: page 。它利用基于 JSON 的简历数据文件标准，轻松轻松地呈现简历或简历。

只需使用 JSON Resume 的浏览器内简历生成器即可导出 JSON 文件并以_data/cv.json形式保存到您的项目中。

图片

建议的图像尺寸（以像素为单位）如下：

图像描述尺寸
page.image.path大型全角文档图像。高的图像会将内容向下推到页面上。 1600 x 600是一个很好的中间尺寸。
page.image单独使用时page.image.path的简写（不带thumbnail 、 caption或其他变量）。与page.image.path相同
page.image.thumbnail网格视图中使用的小文档图像。 400 x 200
author.picture作者页面图像。 300 x 300

定制化

可以通过以下两种方式覆盖和自定义该主题的默认结构、样式和脚本。

覆盖包含和布局

可以通过将同名文件放入项目的_includes或_layouts目录来覆盖主题默认值。例如：

  • 要指定_includes/head.html文件的自定义样式路径或元数据，请在项目中创建_includes目录，将_includes/head.html从 Basic Basic 的 gem 文件夹复制到<your_project>/_includes并开始编辑该文件。

专业提示：要在计算机上找到主题文件，请运行bundle info jekyll-theme-basically-basic 。这将返回基于 gem 的主题文件的位置。

自定义 Sass (SCSS)

要覆盖默认的 Sass（位于主题的_sass目录中），请执行以下操作之一：

  1. 直接从Basic Basic gem 复制

    • 转到本地的 Basic Basic gem 安装目录（运行bundle info jekyll-theme-basically-basic以获取它的路径）。
    • 将/assets/stylesheets/main.scss的内容从那里复制到<your_project> 。
    • 在<your_project>/assets/stylesheets/main.scss中自定义您想要的内容。

  2. 从此存储库复制。

    • 将 asset/stylesheets/main.scss 的内容复制到<your_project> 。
    • 在<your_project/assets/stylesheets/main.scss中自定义您想要的内容。

注意：要进行更广泛的更改并自定义 gem 中捆绑的 Sass 部分。由于 Jekyll 当前读取这些文件的方式，您需要将_sass目录的完整内容复制到<your_project> 。

要对主题样式进行基本调整，可以通过添加到<your_project>/assets/stylesheets/main.scss来覆盖 Sass 变量。例如，要更改整个主题中使用的强调色，请添加以下内容： 

 $accent-color : red ;

自定义 JavaScript

要覆盖主题中捆绑的默认 JavaScript，请执行以下操作之一：

  1. 直接从Basic Basic gem 复制

    • 转到本地的 Basic Basic gem 安装目录（运行bundle info jekyll-theme-basically-basic以获取它的路径）。
    • 将/assets/javascripts/main.js的内容从那里复制到<your_project> 。
    • 在<your_project>/assets/javascripts/main.js中自定义您想要的内容。

  2. 从此存储库复制。

    • 将 assets/javascripts/main.js 的内容复制到<your_project> 。
    • 在<your_project>/assets/javascripts/main.js中自定义您想要的内容。

SVG 图标

该主题使用社交网络徽标和其他保存为 SVG 的图像，以提高性能和灵活性。所述 SVG 位于_includes目录中，并以icon-为前缀。每个图标的大小和设计都适合16 x 16视图框，并使用 SVGO 进行了优化。

图标文件名
图标-箭头-left.svg
图标-箭头-right.svg
图标-bitbucket.svg
图标日历.svg
图标-codepen.svg
图标下载.svg
图标-dribbble.svg
图标-电子邮件.svg
图标-facebook.svg
图标-flickr.svg
图标-github.svg
图标-gitlab.svg
图标-googleplus.svg
图标-instagram.svg
图标-lastfm.svg
图标-linkedin.svg
图标-pdf.svg
图标-pinterest.svg
图标-rss.svg
图标-soundcloud.svg
图标-stackoverflow.svg
图标-秒表.svg
图标-tumblr.svg
图标-twitter.svg
图标-xing.svg
图标-youtube.svg

填充颜​​色在_sass/basically-basic/_icons.scss部分中定义，并使用.icon-name设置，其中类名与相应的图标匹配。

例如，Twitter 图标的填充颜色为#1da1f2 ，如下所示： 

 < span class =" icon icon--twitter " > {% include icon-twitter.svg %} </ span >

除了 SVG 资源之外，还有图标助手可帮助生成社交网络链接。

包含参数描述必需的
username给定社交网络上的用户名必需的
label用于超链接的文本可选，默认为username

例如，以下icon-github.html包括： 

{% include icon-github . html username = jekyll label = 'GitHub' %}

将输出以下 HTML： 

 < a href =" https://github.com/jekyll " >
  < span class =" icon icon--github " > < svg viewBox =" 0 0 16 16 " xmlns =" http://www.w3.org/2000/svg " fill-rule =" evenodd " clip-rule =" evenodd " stroke-linejoin =" round " stroke-miterlimit =" 1.414 " > < path d =" M8 0C3.58 0 0 3.582 0 8c0 3.535 2.292 6.533 5.47 7.59.4.075.547-.172.547-.385 0-.19-.007-.693-.01-1.36-2.226.483-2.695-1.073-2.695-1.073-.364-.924-.89-1.17-.89-1.17-.725-.496.056-.486.056-.486.803.056 1.225.824 1.225.824.714 1.223 1.873.87 2.33.665.072-.517.278-.87.507-1.07-1.777-.2-3.644-.888-3.644-3.953 0-.873.31-1.587.823-2.147-.09-.202-.36-1.015.07-2.117 0 0 .67-.215 2.2.82.64-.178 1.32-.266 2-.27.68.004 1.36.092 2 .27 1.52-1.035 2.19-.82 2.19-.82.43 1.102.16 1.915.08 2.117.51.56.82 1.274.82 2.147 0 3.073-1.87 3.75-3.65 3.947.28.24.54.73.54 1.48 0 1.07-.01 1.93-.01 2.19 0 .21.14.46.55.38C13.71 14.53 16 11.53 16 8c0-4.418-3.582-8-8-8 " > </ path > </ svg > </ span >
  < span class =" label " > GitHub </ span >
</ a >

自定义侧边栏内容

发展

要设置您的环境来开发此主题：

  1. 克隆这个仓库
  2. cd进入/example并运行bundle install 。

要在更改主题时在本地测试主题：

  1. cd到存储库的根文件夹（例如jekyll-theme-basically-basic ）。
  2. 运行bundle exec rake preview并打开浏览器访问http://localhost:4000/example/ 。

这将使用主题的文件和example/目录的内容启动 Jekyll 服务器。进行修改后，刷新浏览器以查看任何更改。

贡献

在文档中发现拼写错误？有兴趣添加功能或修复错误吗？然后一定要提交问题或尝试提交拉取请求。如果这是您的第一个拉取请求，阅读 GitHub Flow 可能会有所帮助。

请求请求

提交拉取请求时：

  1. 克隆存储库。
  2. 从master中创建一个分支，并给它一个有意义的名称（例如my-awesome-new-feature ）并描述功能或修复。
  3. 在 GitHub 上打开拉取请求。

如果您想解决任何“容易实现的目标”（例如修复拼写错误、错误语法等），可以在/docs和/example文件夹中找到示例页面。

制作人员

创作者

迈克尔·罗斯

  • https://mademistakes.com
  • https://twitter.com/mmistakes
  • https://github.com/mmistakes

图标+演示图像：

  • 简单的图标
  • 名词项目
  • 未飞溅

其他：

  • 杰基尔
  • 苏西
  • 断点

执照

麻省理工学院许可证 (MIT)

版权所有 (c) 2017-2021 Michael Rose 和贡献者

特此免费授予获得本软件及相关文档文件（“软件”）副本的任何人不受限制地使用本软件，包括但不限于使用、复制、修改、合并的权利、发布、分发、再许可和/或销售软件的副本，并允许向其提供软件的人员这样做，但须满足以下条件：

上述版权声明和本许可声明应包含在本软件的所有副本或主要部分中。

本软件按“原样”提供，不提供任何明示或暗示的保证，包括但不限于适销性、特定用途的适用性和不侵权的保证。在任何情况下，作者或版权持有者均不对因本软件或本软件中的使用或其他交易而产生或与之相关的任何索赔、损害或其他责任负责，无论是合同、侵权行为还是其他行为。软件。

基本基本包含了名词项目中的图标。图标根据 Creative Commons Attribution 3.0 United States (CC BY 3.0 US) 进行分发。

基本上 Basic 包含来自 Unsplash 的照片。

基本上 Basic 包含 Susy，版权所有 (c) 2017，Miriam Eric Suzanne。 Susy 是根据 BSD 3 条款“新”或“修订”许可证的条款分发的。

基本上Basic包含了Breakpoint。 Breakpoint 是根据 MIT/GPL 许可证的条款分发的。

展开
附加信息
相关应用
为您推荐
相关资讯 全部