提交文章格式要求

本文最后更新于 2025年3月11日 晚上

提交文章格式要求

文章要求

使用 Markdown 书写,同时,我们使用了 Fluid 插件,支持 特殊语法,点击超链接查看。

front-matter 要求

文章开头,使用 --- 上下包裹。

1
2
3
4
5
6
7
8
9
---
title: {{ title }}
date: {{ date }}
tags:
categories:
author:
index_img:
banner_img:
---
  • title直接跟字符串名称,不需要引号,建议不要使用特殊符号、表情等

  • date格式符合 YYYY-MM-DD HH:mm:ss ,这个有很多工具可以生成

  • tags是标签,有多个需要采用数组写法

    1
    2
    3
    tags:
    - tag1
    - tag2
  • categories是分类,写法同上

  • author是作者,不支持多个,但其实逗号连接也行

  • index_img是封面,建议:国内图床 > 国外图床 >= 相对路径引用(可以留空)

  • banner_img是页面顶部大图,要求同上(可以留空)

注意

  • author 和 index_img 和 banner_img 可以为空
  • 有latex公式则需要添加 math: true
  • 需要引用的资源放入文章同名文件夹中,只能使用markdown语法,内嵌html标签可能无法正确引用资源

提交文章

  • Fork 源代码 并克隆到本地
  • 把你的文章加入 /source/_posts/,内置配图见上文
  • 检查是否渲染正确(可选, 建议)
    • 确保有 node 环境
    • 在博客 相对根目录 运行
      1
      2
      3
      4
      5
      npm install -g hexo-cli --save
      npm install
      hexo clean
      hexo g
      hexo s
    • 按照指示进入网页,检查你的文章是否有显示错误等等
  • 提交文章(二选一)
    • 在有上述 node 环境且有网页仓库权限的前提下运行 hexo d
    • 新建分支并在 GitHub 提交 PR

注意

  • 无特殊需求,禁止 对仓库的依赖进行更新

提交文章格式要求
http://ippclub.github.io/提交文章格式要求/
作者
何山
发布于
2024年10月3日
更新于
2025年3月11日
许可协议