Particlex 主题使用说明

2022/5/10 工具 Hexo 主题

Hexo ParticleX 主题，诞生原因是因为原来的 Particle 主题不维护了，但是我觉得还是很可以的
原来用的是 Vue2 + AntdVue1，现更新到 Vue3，去除 AntdVue 采用自定义样式，图标更改为 FontAwesome 6，将不能用的 JsDelivr 改为 Staticfile CDN

吐槽一句：我改原项目 README 的时候看到的，看：

目前有 full、night 和 maiden 两个主题样式

~~虽然更改后只有一种了，如果你想改颜色就在 particlex.css 里 Ctrl+F 替换吧~~

演示地址（我自己的博客）

Github Pages：https://argvchs.github.io
Netlify 加速：https://argvchs.netlify.app
Vercel 加速：https://argvchs.vercel.app

主题安装

进入主题目录后，克隆此仓库

git clone https://github.com/argvchs/hexo-theme-particlex.git themes\particlex

关闭 Hexo 自带 highlight

到博客根目录下的 _config.yml，找到 highlight 和 prismjs 参数，设置为如下：

highlight:
    enable: false
    line_number: true
    auto_detect: false
    tab_replace: ""
    wrap: true
    hljs: false
prismjs:
    enable: false
    preprocess: true
    line_number: true
    tab_replace: ""

修改完请清除缓存：hexo cl

配置文件说明

language: # Language
head_img: # Avatar URL
head_block_enable: true
home_background: # Background URL

导航栏配置
为了方便，主题使用的图标是 FontAwesome 6 图标，地址为：https://fontawesome.com/search/

menu:
    home:
        name: house
        theme: solid
        src: /
    about:
        name: id-card
        theme: solid
        src: /about
    archives:
        name: box-archive
        theme: solid
        src: /archives
    categories:
        name: bookmark
        theme: solid
        src: /categories
    tags:
        name: tags
        theme: solid
        src: /tags
    # Example:
    # <name>:
    #     name: <icon-name>
    #     theme: <icon-theme>
    #     src: <link-url>

主页信息卡片
和导航栏配置差不多
如果图标链接或友链为空，请在 icon_links: 或 friend_links: 后添加一个 []

card:
    enable: true
    description: ["Description..."] # You can add more
    icon_links:
        github:
            name: github
            theme: brands
            link: https://github.com/argvchs
        # Example:
        # <name>:
        #    name: <icon-name>
        #    theme: <icon-theme>
        #    link: <link-url>
    friend_links:
        # Example:
        # <name>: <link-url>

页脚配置
考虑到博客部署在服务器并使用自己域名的情况，按国家规定需要在网站下边添加备案消息
如没有需要显示备案消息的可以关闭
```
footer:
    since: 20xx
    ICP:
        enable: true
        code: 粤ICP备xxxxxx号
```

Gitalk
本主题引入的是 Gitalk 评论系统，默认开启
考虑到博客可能部署到多个网站同步评论，但 OAuth APP 只能有一个回调 URL，所以添加了 sites 参数用于其他网站的评论，请注册多个 Oauth APP
同样如果没有其他网站，请在 sites: 后添加一个 []

gitalk:
    enable: true
    clientID: # Default ClientID
    clientSecret: # Default ClientSecret
    repo: # The name of repository of store comments
    owner: # GitHub repo owner
    admin: # GitHub repo owner and collaborators, only these guys can initialize github issues
    language: zh-CN # en, zh-CN, zh-TW, es-ES, fr, ru, de, pl and ko are currently available.
    sites:
        # Example:
        # <www.example.com>:
        #    clientID: <client-id>
        #    clientSecret: <client-secret>

写在最后

本项目采用 MIT 开源许可证，欢迎大家贡献，你可以随意打开一个 Issue 来进行提问，有任何改进想法都可以进行 Fork，期待您的 Pull Request

LOADING...