首页网站建设hexo

    我是基于 deepseek v3 的 AI 助手

    本文详细介绍了如何为Hexo博客安装和配置shoka主题。首先，文章指导用户如何从GitHub或Gitee克隆shoka主题到本地，并修改Hexo的配置文件以启用该主题。接着，文章详细说明了如何安装shoka主题所需的Markdown渲染插件，并提供了解决安装过程中可能遇到的错误的方案。 随后，文章介绍了如何配置shoka主题的Markdown渲染器，包括如何设置Markdown的渲染选项和插件，以及如何关闭Hexo自带的代码高亮功能。此外，文章还指导用户如何配置其他功能，如自动前缀、搜索功能和RSS订阅等。 在配置搜索功能部分，文章详细说明了如何通过Algolia服务为博客添加搜索功能，并提供了获取Algolia API密钥的步骤。最后，文章简要介绍了如何配置Hexo的基本设置，如站点信息、URL结构和SEO优化等。 本文为Hexo用户提供了全面的shoka主题安装和配置指南，适合希望为博客添加美观且功能丰富的主题的用户阅读。

    本文正在重写，现不建议阅读

    # 安装 shoka 主题

    克隆 shoka 主题到本地

    cd <your_blog>
    # git clone https://github.com/amehime/hexo-theme-shoka.git ./themes/shoka 作者提供的 github 源，需要网络较好
    git clone https://gitee.com/zkz0/hexo-theme-shoka.git ./themes/shoka #gitee 镜像源

    将文件夹改名为 shoka , 打开根目录 _config.yml
    更改为如下内容:

    # Extensions
    ## Plugins: https://hexo.io/plugins/
    ## Themes: https://hexo.io/themes/
    theme: shoka

    # 安装 shoka 的 md 渲染插件

    安装 shoka 主题的 md 渲染器插件:

    # cd <your_blog>
    yarn remove hexo-renderer-marked
    # cnpm i hexo-renderer-multi-markdown-it
    yarn add hexo-renderer-multi-next-markdown-it #博主制作的全新版本渲染器，建议安装

    如果报错替换为下列指令:

    如果安装 hexo-renderer-multi-next-markdown-it 则不会存在此问题

    cnpm i hexo-renderer-multi-markdown-it --ignore-scripts
    cnpm un puppeteer
    cnpm i puppeteer
    cnpm i bufferutil
    cnpm i utf-8-validate

    # 安装 shoka 的插件

    执行如下命令:

    yarn add hexo-autoprefixer
    yarn add hexo-algoliasearch
    yarn add hexo-symbols-count-time
    yarn add hexo-feed

    # 配置 shoka 主题

    # 配置 hexo-renderer-multi-markdown-it

    在根目录下 _config.yml 加入 md 配置和 minify 配置:

    markdown:
      render: # 渲染器设置
        html: false # 过滤 HTML 标签
        xhtmlOut: true # 使用 '/' 来闭合单标签 （比如 <br />）。
        breaks: true # 转换段落里的 '\n' 到 <br>。
        linkify: true # 将类似 URL 的文本自动转换为链接。
        typographer: 
        quotes: '“”‘’'
      plugins: # markdown-it 插件设置
        - plugin:
            name: markdown-it-toc-and-anchor
            enable: true
            options: # 文章目录以及锚点应用的 class 名称，shoka 主题必须设置成这样
              tocClassName: 'toc'
              anchorClassName: 'anchor'
        - plugin:
            name: markdown-it-multimd-table
            enable: true
            options:
              multiline: true
              rowspan: true
              headerless: true
        - plugin:
            name: ./markdown-it-furigana
            enable: true
            options:
              fallbackParens: "()"
        - plugin:
            name: ./markdown-it-spoiler
            enable: true
            options:
              title: "你知道得太多了"
    minify:
      html:
        enable: true
        exclude: # 排除 hexo-feed 用到的模板文件
          - '**/json.ejs'
          - '**/atom.ejs'
          - '**/rss.ejs'
      css:
        enable: true
        exclude:
          - '**/*.min.css'
      js:
        enable: true
        mangle:
          toplevel: true
        output:
        compress:
        exclude:
          - '**/*.min.js'
    随后关闭 hexo 自带代码高亮:
    

    highlight:
      enable: false
    prismjs:
      enable: false
    # 配置其他功能
    

    根目录 yaml 加入如下配置:
    

    autoprefixer:
      exclude:
        - '*.min.css'
    keywords: #站点关键词，用 “,” 分隔
    feed:
      limit: 20
      order_by: "-date"
      tag_dir: false
      category_dir: false
      rss:
        enable: true
        template: "themes/shoka/layout/_alternate/rss.ejs"
        output: "rss.xml"
      atom:
        enable: true
        template: "themes/shoka/layout/_alternate/atom.ejs"
        output: "atom.xml"
      jsonFeed:
        enable: true
        template: "themes/shoka/layout/_alternate/json.ejs"
        output: "feed.json"
    # 配置搜索功能
    

    在根目录 _config.yml  加入如下配置:
    

    algolia:
      appId: #Your appId
      apiKey: #Your apiKey
      adminApiKey: #Your adminApiKey
      chunkSize: 5000
      indexName: #"shoka"
      fields:
        - title #必须配置
        - path #必须配置
        - categories #推荐配置
        - content:strip:truncate,0,2000
        - gallery
        - photos
        - tags
    获取 APPID 步骤:
    
 进入 algolia , 点击右上角的 start free , 根据提示填入信息即可 
    
数据库位置可自行选择，随后创建应用，点击左下角齿轮，选择 api keys  
    
然后将 apikeys 填入对应选项:
    

    appId 对应 Application ID
    apiKey 对应 Search-Only API Key
    adminApiKey 对应 Admin API Key
    indexName 填入你的项目 index 名
    

    shoka 主题剩余配置可自行查看文档 
    
如遇到问题可以在评论区提问
    

    

    # 配置 hexo
    

    打开根目录 _config.yml
    

    

    仅关注站点配置部分，部署及增强日后再聊
    

    

    Site 部分:
    

    # Site
    title: #你的站点名 (中标题，大标题是主题的 alternate 选项)
    subtitle: #副标题 (小标题)
    description: #站点描述，不建议小于 15 字
    keywords: #关键字，用半角逗号分隔
    author: #作者名
    language: zh-CN #中文为 zh-CN
    timezone: 'Asia/Shanghai' #东八区时区
    url 部分:
    

    # URL
    ## Set your site url here. For example, if you use GitHub Page, set url as 'https://username.github.io/project'
    url: https://www.kaitaku.xyz #你的 url, 需要协议头
    # permalink: :year/:month/:day/:title/
    permalink: :title/ #推荐这样，有利于 SEO
    permalink_defaults:
    pretty_urls:
      trailing_index: true # Set to false to remove trailing 'index.html' from permalinks
      trailing_html: true # Set to false to remove trailing '.html' from permalinks
    推荐安装 hexo-filter-nofollow  优化 SEO:
    

    cnpm i hexo-filter-nofollow
    在根目录 config.yml  添加如下内容:
    

    nofollow:
      enable: true # 是否启用
      field: site #site 全站，post 仅文章
      exclude:
        - 'www.kaitaku.xyz' #例外网站