轻风记 风记得一朵花的香.
博主 轻风记
人类原创辽ICP备2022008387号-2

Surpport By 又拍云 × DogYun

博主 2天前 在线自豪地使用 Typecho 建站搭配使用 🌻Sunny 主题当前在线 1 人
歌曲封面 未知作品
  • 歌曲封面日落的告白Kui Kui

人类原创

辽ICP备2022008387号-2

Surpport By 又拍云 × DogYun

网站已运行 5 年 287 天 17 小时 36 分

Powered by Typecho & Sunny

2 online · 80 ms

Title

又一个静态博客部署方案:quick-markdown

Meteor

·

·

175次阅读
日常
Article

又一个静态博客部署方案:quick-Markdown

Quick-Markdown
  • 本文含有部署教程,代码众多建议PC端浏览

开源项目地址: https://github.com/mengrru/quick-markdown https://github.com/mengrru/hut
详细使用文档:点我进入
作者:@ mengru的空间

  偶然间发现了作者的博客,当时没觉得有什么奇怪的地方,直到发现下面用的是quick-markdown,看了他的部署博文,我才知道这是一个静态博客。与hexo相似的地方在于部署在github或gitlab(不知道hexo可不可以部署在这里)作者部署在gitlab所以速度上并不慢。早些时候也折腾过hexo,不能说麻烦吧,光是本地装软件,提交命令写博文就让我头大,即便后来出了一些自动化的教程,但还是喜欢不起来(我真觉得繁琐)。
  quick-markdown 是一个 markdown 展示工具,能够快速为你的 markdown 文件生成展示页面,也就是说将.md文件上传以后,直接访问这个文件这个项目便会将它解析成网页,那么便有了之后把它部署成博客的用处了(如果是跟作者一样用gitlab部署甚至不用下载任何软件上传文件等,直接就可以在gitlab写文发文)。

优点

  • 部署简单
  • 迁移简单,直接打包带走
  • 纯静态
  • 部署及运行不花一分钱(github/gitlab)
  • 一个markdown文件即是一个文章、页面(可以说是随意DIY)
  • 配合Markdown语法以及html+css就可以构建个性化页面
  • 内置7个主题,且主题编写也不麻烦仅有html,css,你可能会用到js

部署教程

作者的部署教程:https://mengru.space/?posts/2021/11/blog-with-markdown
[details sum="简化版"]
简化版版:
1.首先在你用这个项目之前你要有github账号,并建立 你的github ID.github.io仓库
2.fork项目到你刚才建立的那个仓库 项目地址https://github.com/mengrru/quick-markdown
3.选择Settings -> Pages,在 Source 一栏的 Branch 里勾选gh-pages,保存。然后选择上方菜单中的Actions,点击中间的绿色按钮打开 Action 功能,绑定自定义域名也在page页面里。
page
到这里实际上已经部署完成了。
  gitlab的部署办法可以参照作者的教程,相比于github的好处是它不会暴露博客原始仓库,Gitlab 原生提供 WebIDE可以直接当成博客后台用来发布文章,而且速度上也不需要什么特殊的东西
[/details]
  当时看到的是gitlab启动CI/CD -> Pipelines这个功能(类似action作用就是自动部署)需要验证信用卡来确保你是真人而不是机器人,这让我犯难,即便现在成年但确实也没办信用卡。看了文档后了解到,这个博客的首页文章列表就是依靠files-list 作者内置的文章列表插件,通过运行这个插件来对博客首页的文章列表进行更新,gitlab可以通过检测文件更新情况来启动运行提前设置好的插件命令。不能使用Gitlab那么同样的服务器也可以完成这个功能。

服务器部署

我用的环境是:Debian10,+宝塔纯净版7.6 +插件pm2 +计划任务
服务器部署就可以说是非常的简单了,虽然这个静态博客的初心是部署不用花一分钱,碍于github速度慢,而且我部署完发现相比前两个服务器似乎更加简单。
1.把项目下载到本地上传到服务器解压,将quick-markdown里面的所有文件剪切到网站根目录wwwroot里
2.博客核心配置文件是config.js ,这个文件里有设置主题,博客名字,博文存放目录等等具体参看下面的解释

♾️ html 代码:
var Config = {
    docRoot: 'pages/',              页面目录名
    homepage: 'blog/index.md',      page目录下,博客所显示的首页文档
    notFoundText: '404页面显示的文字',
    defaultTitle: '这里填你的博客名',
    notFoundPage: '404页面.md',
    theme: '主题名',
    showFooterText: true,           是否开启底部文字显示true/false
    footerText: '底部显示的文字',
    rootPath: '/'                    这里直接填/
}
Typora

关于config.js作者文档:https://mengrru.github.io/quick-markdown/?docs/usage
3.定时任务
在此之前,在软件商店下载pm2插件部署nodejs环境
在网站根目录或者你喜欢的目录,新建一个文件后缀为.sh例如up.sh
内容填写如下

♾️ html 代码:
#/
cd /www/wwwroot/xxxx.cn/
node plugins/index.js

cd后面的路径就是你网站根目录路径
4.打开宝塔计划任务,任务名称随便,时间我设定的是每1小时运行一次,当然也可以设定4个定时任务时间分别是早上八点中午十二点下午六点和凌晨12点,这样不需要一直执行,在四个时间段内写文章都会在这几个时间点刷新文章列表。
脚本内容填写

♾️ html 代码:
. /www/wwwroot/xxxx.cn/up.sh

注意这里不能使用sh命令以及单独指向sh文件,都不会生效。路径是sh文件所在位置。虽然仅仅一行代码,但是这个脚本内容却折腾我两天,这个定时任务就是去运行列表插件用来更新首页文章列表,尝试了好几种写法用终端运行命令生效但是用计划任务始终不生效。后来发现那个index.js用绝对路径不好使,才有了cd命令的尝试。(还是太菜了)

[tip type="blue"]在这里你可能会遇到计划任务提示node 命令没找到,只需要在终端执行which node,复制那个路径再执行
ln -s /www/server/nvm/versions/node/v14.19.0/bin/node /usr/bin/node
就可以了(都是宝塔前面的node路径基本一样就是注意版本号){/cat_tips_warning}
5.到此为止部署结束

写博文

一个Markdown文件在开头加上

♾️ html 代码:
<!--
title: <标题>
time: <时间>
tags: <标签;多个标签用空格分开>
abstract: <摘要>
-->

然后下面写正文即可,作者也融合了其他功能,两个样式的提示框,文章大纲(目录)短代码
具体参看文档https://mengrru.github.io/quick-markdown/?docs/usage

注意

按照上面的config.js配置
博文就存放在page/blog/post目录下,其他页面放在blog/目录下就可以。像作者那样的显示首页,项目等在主题更改即可。
有人觉得繁琐,实际上无论是手机还是电脑的markdown编辑器比如电脑上的typora,写完文章后配合XFTP或其他ftp软件便可以直接上传过去,gitlab更是可以直接发布。没有多余的东西,那些万年不变的地方改一次就行。

部署小结

一个装了宝塔的服务器,加一个pm2插件,写一个sh文件,添加一个计划任务。

结语

虽然主题是html和css但是对于小白来说可能还是不太友好,但是这个项目无人问津也没人开发主题。
我觉得这个项目特别适合纯写作记录生活的人使用,纯静态文件速度也飞快。想象着晚上在家一个人用typora记录一些事情,保存以后直接丢服务器上,甚至可以写完保存睡觉下次写完把好几个文件一起丢上去,由于不需要数据库以后想要迁移直接打包带走。

没什么其他复杂的配置,只是重拾写作的乐趣,文件决定页面,高度自定义

推荐指数:⭐⭐⭐⭐⭐

现在已有 3 条评论,0 人点赞
Author:Meteor
作者
又一个静态博客部署方案:quick-markdown
当前文章累计共 3926 字,阅读大概需要 5 分钟。
Hello World
2018年12月31日 · 0评论
在学校过的端午
2021年6月14日 · 6评论
一岁一祈万事胜意
2021年10月13日 · 12评论
Comment:共3条
发表
  1. 头像
    @
    [secret]  哈哈~又发现一个折腾的好东西。[/secret]
    · Chrome

    👍

    💖

    💯

    💦

    😄

    🪙

    👍 0 💖 0 💯 0 💦 0 😄 0 🪙 0
  2. 头像
    @
    大佬有空帮我安排上:@(击掌)
    · Chrome

    👍

    💖

    💯

    💦

    😄

    🪙

    👍 0 💖 0 💯 0 💦 0 😄 0 🪙 0
    1. 头像
      @
      :&(蛆音娘_不愧是我)小事一桩
      · Chrome

      👍

      💖

      💯

      💦

      😄

      🪙

      👍 0 💖 0 💯 0 💦 0 😄 0 🪙 0
搜 索 消 息 足 迹
你还不曾留言过..
你还不曾留下足迹..
博主 不再显示
博主