_config.yml

# Welcome to Jekyll!
#
# This config file is meant for settings that affect your whole blog.
#
# If you need help with YAML syntax, here are some quick references for you: 学习YAML语法请参考：
# https://learn-the-web.algonquindesign.ca/topics/markdown-yaml-cheat-sheet/#yaml
# https://learnxinyminutes.com/docs/yaml/

title: 虚谷计划之掌控板
description: 虚谷计划旗下的开源硬件项目。
github_username: xiezuoru  # 你的用户名
# you can comment the below line out if your repo name is not different than your baseurl
github_repo: "handpy" #你的仓库名

# OPTIONAL: override baseurl and url if using a custom domain 可选项，如果你有自己的域名，并且需要绑定到该网站
# Note: leave out the trailing / from this value.  写下域名，不要在最后加斜杠/ 
url: "" # the base hostname & protocol for your site, e.g. http://example.com

###########################################################
#########  Special Instructions for baseurl ###############
#
#### Scenario One: If you do not have a Custom Domain #####
#    -  if you are not using a custom domain, the baseurl *must* be set to your repo name 如果没有自己的域名，那么下面就写仓库名
# 
####  Scenario Two: If you have a Custom Domain #####
# 1. If your domain does NOT have a subpath, this leave this value as ""     如果有域名，且域名下没有子目录，则留空
# 2. If your domain does have a subpath, you must preceed the value with a / and NOT have a / at the end.  否则写子目录名
#      For example: 
#           "" is valid
#           "/blog"        is valid
#            "/blog/site/" is invalid  ( / at the end)
#            "/blog/site"  is valid
#            "blog/site"   is invalid  ( because doesn't begin with a /)
#
# 3. You must replace the parameter `baseurl` in _action_files/settings.ini with the same value as you set here but WITHOUT QUOTES.
#
baseurl: "/handpy" # the subpath of your site, e.g. "/blog".网站子路径，一般是仓库名或留空或子目录

# Github and twitter are optional:可以在网页底部显示自己的推特和github链接
minima:
    social_links:
    twitter: 
    github: xiezuoru

# Set this to true to get LaTeX math equation support 显示LaTeX数学符号
use_math: true

# Set this to true to display the summary of your blog post under your title on the Home page. 显示概要
show_description: true

# Set this to true to display image previews on home page, if they exist  显示图片
show_image: true

# Set this to true to display tags on each post 显示标签
show_tags: true

# Add your Google Analytics ID here if you have one and want to use it
google_analytics: 

exclude:
  - docker-compose.yml
  - action.yml
  - Makefile

# this setting allows you to keep pages organized in the _pages folder
include:
  - _pages

# This specifies what badges are turned on by default for notebook posts.是否启用以下的badges状态提示（以徽章形式显示在标题下方）
default_badges:
  github: true
  #链接到GitHub中的该文件
  binder: true
  #链接到binder，用于运行当前Jupyter文件，完全在云端运行。
  colab: true
  #Colaboratory 是一个免费的 Jupyter 笔记本环境，不需要进行任何设置就可以使用，并且完全在云端运行。由谷歌部署，国内用不了。
  #借助 Colaboratory，可以编写和执行代码、保存和共享分析结果，以及利用强大的计算资源，所有这些都可通过浏览器免费使用。
  #可以参考https://www.jianshu.com/p/a42d69568966

# Everything below here should be left alone. Modifications may break fastpages 以下请勿修改
future: true
theme: minima
plugins:
  - jekyll-feed
  - jekyll-gist
  - jekyll-octicons
  - jekyll-toc
  - jekyll-twitter-plugin
  - jekyll-relative-links
  - jekyll-seo-tag
  - jekyll-remote-theme
  - jekyll-paginate
  - jekyll-sitemap

# See https://jekyllrb.com/docs/pagination/
# For pagination to work, you cannot have index.md at the root of your repo, instead you must rename this file to index.html
paginate: 15
paginate_path: /page:num/

remote_theme: jekyll/minima

titles_from_headings:
  enabled:     true
  strip_title: true
  collections: true

highlighter: rouge
markdown: kramdown
kramdown:
  math_engine: katex
  input: GFM
  auto_ids: true
  hard_wrap: false
  syntax_highlighter: rouge