npm 包 vuepress-theme-blog 使用教程

阅读时长 5 分钟读完

在前端开发中,我们常常需要搭建个人博客或者团队博客网站,vuepress-theme-blog 是一个基于vuepress的npm包,它可以帮助我们快速搭建一个美观简洁的博客网站。

安装

安装 vuepress-theme-blog 可以使用 npm 或者 yarn 安装。

或者

使用

在使用 vuepress-theme-blog 搭建博客网站时,我们需要先在项目中引入该主题,然后按照该主题的具体配置进行设置。

  1. 在项目的 docs/.vuepress/config.js 文件中,引入该主题,具体的配置如下:
-- -------------------- ---- -------
-------------- - -
  ------ --- ------
  ------------ --- ------
  ------ ----------------------
  ------------ -
    -- --- ----
    ----- ------------
    -- -----
    ----- -
      -- -----
      --------- -----------
      -- -----
      ---- ------
      -- -----
      ----- ---------
      -- -------
      ------- ------
    --
    -- ----
    ------------ --
      ------ ---- ------
      ----- -----------------------
    ---
    -- ----
    ------------ --
      ------ ----------
      ----- ----------------------
    ---
    -- ------ --
    ------- -
      --------- ------
      ----- ----------------------
      --------- ----- ----------
      ------------- ----- -------------
    -
  -
-
  1. 在项目中创建 .md 文件用来发布博客,在 docs/blog 目录下创建分类和标签,博客文件中的 frontmatter 部分需要加入 categorytags 信息。示例如下:
-- -------------------- ---- -------
---
------ ----
----- ----------
------------ ----
--------- --
-----
  - ---
  - ---
---

-------- --
  1. 如果要在博客中添加评论,可以注册一个 Github 应用程序并使用 vuepress-plugin-comment 插件,具体步骤如下:

    a. 在 Github 上注册一个新的 OAuth 应用程序,在 Settings > Developer settings > OAuth Apps 界面下,选择 New OAuth App 创建一个新的 OAuth 应用程序。

    b. 在输入应用程序名称 / 主页 url / 授权回调 URL 后,点击 Register application

    c. 在应用程序设置页中获取 client IDclient Secret 信息。

    d. 在 docs/.vuepress/config.js 文件中添加如下配置:

    -- -------------------- ---- -------
    -------------- - -
      ----
      -------- -
        -
          -------------------------------
          -
            --------- ---------
            ------ ----- ----------
            ----- ----- ------
            --------- ----- ----------
            ------------- ----- --------------
            ---------------- ----
          -
        -
      -
    -

    注意需要把 your usernameyour repo 更换成你自己的账号和所在的仓库名称。

    e. 在 .md 文件中添加 Toc 快捷指令,用于生成评论区。

    -- -------------------- ---- -------
    ---
    ------ ----
    ----- ----------
    ------------ ----
    --------- --
    -----
      - ---
      - ---
    -------- ----
    ---- ----
    ---
  2. 运行本地服务,在终端命令中输入以下命令:

  1. 构建部署,在终端命令中输入以下命令:

构建成功后,生成的静态网站可自行上传到服务器上进行部署,也可以将代码上传到 GitHub 上,通过 GitHub Pages 进行在线浏览博客。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60065b41c6eb7e50355dbcf9

纠错
反馈