首页 Hexo

参考链接

https://shoka.lostyu.me/categories/computer-science/note/theme-shoka-doc/

# 配置搭建

在根目录下的站点配置文件，_config.yml 中修改

# 写作设置
new_post_name: :title.md # 默认的文件名称
default_layout: post     # 默认的文章类型
titlecase: false # Transform title into titlecase
# 是否允许文章中放置外部链接
external_link:
  enable: true 
  field: site 
  exclude: ''
filename_case: 0
render_drafts: false
# 创建文章的同时创建一个同名文件夹，用于存放文章中所引用的图片
post_asset_folder: true
marked:
  prependRoot: true
  postAsset: true
# 这里配置分类与标签
default_category: uncategorized
# 这些分类对应 source/_posts 文件夹下对应的子文件夹
category_map:
  计算机科学: CS
  C++: cpp
  算法: Algorithms
  数据库: DB
  Hexo-Shoka: hexo

# 开始写作

# 创建首页分类

在上面的配置分类中新增关键字以及创建对应的_posts 下子文件夹，再将该分类的 md 文件都放置在子文件夹中即可

# 创建页面

在根目录下主题配置文件，_config_shoka.yml 文件中修改

# 菜单与社交按钮
# || 分割符用于切割为链接，图标，颜色
menu:
  # home: / || home
  文章:
    default: / || feather
    分类: /categories/ || th
    标签: /tags/ || tags
  关于: /about/ || user
  直达: /links/ || plane
# 魔法: /magic/ || magic  
social:
  #边栏头像下显示的各种网页地址
  github: https://github.com/LoveArrowShoot || github || "#191717"
  twitter: https://twitter.com/lxx159110 || twitter || "#00aff0"
  zhihu: https://www.zhihu.com/people/marvelfg || zhihu || "#1e88e5"

在根目录的命令行下输入 hexo new page 页面名称，此时会在 source 文件夹下生成一个该名称命名的文件夹及页面文件

如 hexo new page magic, 则会出现 source/magic 文件夹以及内部一个 index.md 文件

在此文件中对页面进行布局，再将该文件夹及对应名称如上方注释写入 yml 配置即可，在顶框和边栏就会出现对应按钮以及相应的跳转功能

# 创建文章

在根目录的命令行下输入 hexo new post -p 相对目录 / 文件名称.md 文章名称

此时会在 source/_posts/ 相对路径 文件夹下生成一个 md 文件和同名文件夹

md 文件中的 title 为文章名称，tag 为标签，categories 为分类，配置好后在分隔符下方根据 md 格式编写文章即可，文章所引用到的图片放在文章同名文件夹下即可

# 文章首页置顶

在文章头部分隔线内加入 sticky: true 即可，若有多篇置顶，则根据发布日期倒序排列，不参与分页

# Shoka 主题常用特色功能

在 md 文件中按照如下格式编写

# 链接块

{ %links%}
- site: #站点名称
  owner: #管理员名字
  url: #站点网址
  desc: #简短描述
  image: #一张图片
  color: #颜色代码
{ %endlinks%}

# 文字特效

若要组合使用，则在同一个大括号中用空格隔开即可

++下划线++
++波浪线++{.wavy}
++着重点++{.dot}
++紫色下划线++{.primary}
++绿色波浪线++{.wavy .success}
++黄色着重点++{.dot .warning}
~~删除线～～
~~红色删除线～～{.danger}
==荧光高亮==
[赤橙黄绿青蓝紫]{.rainbow}
[红色]{.red}
[粉色]{.pink}
[橙色]{.orange}
[黄色]{.yellow}
[绿色]{.green}
[靛青]{.aqua}
[蓝色]{.blue}
[紫色]{.purple}
[灰色]{.grey}
快捷键 [Ctrl]{.kbd} + [C]{.kbd .red}
// 化学式
H~2~0
// 指数
29^th^
// 黑幕文字，触碰后显示
!!文字!!
// 模糊文字，选中后显示
!!文字!!{.bulr]

# 折叠块

+++颜色 名称
这里是折叠块的内容
+++

# 标签卡

ID 用于标识是否在同一行下显示

;;;ID 标签名称
卡的内容
;;;
更新于