Markdown博客系统的搭建与使用

版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/ZZY1078689276/article/details/84099649

搭建Markdown博客系统的好处

  传统的博客系统在搭建时往往比较复杂,除了搭建开发、运行环境之外,还得需要比较高深的相关编程语言,比如说前天用JS、CSS,后台用Java,数据库用MySQL等等等等。

  除了这些之外,我们还需要了解项目的基础框架,比如说现今流行的SSM(SpringMVC + Servlet + Mybatis)。

  还需要我们知道开发博客的业务逻辑,比如说我们得展示前台吧,这就需要前台的业务逻辑,而我们的前台数据是通过后台进行维护的,因而在后台有需要有一个后台管理的业务逻辑。

  在实际的项目开发过程之中,光了解上面的那些是远远不够的,因为一个系统最起码得有一个登陆吧,而登录这方面就需要RBAC权限管理的技术支持,否则谁都能操作后台,岂不乱了套了,诸如此类的技术还有很多,这我就不一一举例了。

  但是仔细一想的话,虽然搭建一个传统的博客网站系统其实就已经很复杂了,但是其实有很多的功能并不是我们一定需要的,有时我们仅仅只是用于记录日志,用于自己博客信息的展示,其不需要太多的功能,在实现自己基本需求的情况下,简洁而美观,使用搭建方便,这才是我们追求的目标,否则光一个博客系统的搭建就耗费大把的时间,恐怕很多的博客爱好者就会止步于此了。

  通过上述描述,我们基本上可以看出Markdown博客系统的优点,那就是基于现成的模版,搭建迅速,使用简单,并且易于维护。

模版的选择与使用

模版的选择

  由于该Markdown博客系统是基于现成的网站模版来搭建的,所以说我们可以随意的选择自己所喜爱的博客模板,比如说下面的就是如此:

  Markdown博客模版属于开源源码一类的项目,这种项目在全球最大的代码托管平台GitHub上很容易找到。

模板的使用

  由于Markdown博客模版属于静态网站项目,这意味着我们根本就不需要任何的数据库,我们编写的Markdown文本的内容其本身就属于源码中的一部分,因而我们需要将所选的项目Fork到自己的GitHub账号,然后再进行相应的修改,当然,这前提是自己还得有一个GitHub账号。

  只是简单的Fork上面的项目还不行,还得我们做一些其它的修改,比如说我们得修改Fork后的项目名,其项目名的命名方式为:

GitHub账号 + .github.io

  比如说我的GitHub账号的项目Fork后的项目名为:

zzy-lyc.github.io

  而修改项目名的地方如下:

在这里插入图片描述

使用GitHub Pages预览项目

  在项目Fork并修改项目名成功后,由于我们的项目是属于静态页面项目,而使用GitHub的GitHub Pages可以直接预览该项目的实际效果。

  访问Fork后的项目的选择页面与项目的项目名修改是在同一个页面,其就是位于该页面下部的GitHub Pages。

  在使用前,GitHub Pages需要我们选择一个预览的主题,如下:

在这里插入图片描述

  在主题页面,我们直接选择默认的即可。

在这里插入图片描述

  此时页面跳转回刚才的页面,在这里,我们可以看见图示的网站预览网址,如下:

在这里插入图片描述

  点击该网址,其显示的博客内容如下:

在这里插入图片描述

  我们可以看到,其首页的预览效果还是不错的。

本地开发环境的搭建

  我们在使用时肯定要删除原有的博客内容,然后发布自己的博客内容,因而这就需要用到相应的开发工具IDE的选择与项目运行环境的搭建。

IDE的选择

  编辑Markdown博客系统其实本质上就相当于项目开发,选择一款IDE就可以了,如果是使用新版本的IDEA,那就简单了,直接使用就可以,因为新版的IDEA中集成了MarkDown Support插件,因而可以直接拿来使用。而如果是其它的,那就需要下载相应的MarkDown Support插件,比如说在WebStorm中下载与安装MarkDown Support插件就是如此。

运行环境的搭建

安装RubyInstaller

  此处我们的环境是搭建在Windows上的,所以说我们选择的开发环境工具也是属于Windows版本的。

  这里我们安装的是Ruby与Devkit。

  RubyInstaller有新老版本的区别,在老版本中Ruby与Devkit是分开的,我们需要分别下载与安装,但是在新版本中,其是合并在一起的,当然,这里使用的原则是则么简单怎么来,所以说我们直接下载最新版本的RubyInstaller,而我此时所选择的新版本为2.5.3。

  我们在安装RubyInstaller,使用默认配置是最简单的,所以说在同意了用户使用协议后,直接就一路Next,直至软件最终安装完成。

  安装完成后的结果如下所示:

在这里插入图片描述

  在这里,Ruby需要我们选择所想要安装的组件,其中有三个选择,但是最后其还给了一条提示信息,那就是如果不确定要选什么,那么直接点击回车键,此时我们就选择默认配置(也就是全选),直接按回车。

  之后Ruby会自动的下载并更新很多东西,如:

在这里插入图片描述

  在上面的过程执行结束后,Ruby接下来询问我们需要安装哪些组件,此时又给我们提供了一条默认信息,那就是如果不确定要选择什么,那就直接按回车键。那好,那我们就选择默认,直接点击回车即可:

在这里插入图片描述

  回车后,由于默认是什么都不安装,因而窗口直接退出。

查看安装后的软件版本号

Ruby

ruby -v

gem

gem -v

  安装完成后的版本号如下;

在这里插入图片描述

配置镜像

  我们的项目是在Jekyll中运行的,而此处的Jekyll属于Ruby中的一个依赖,因而我们就需要下载相应的软件依赖。

  和往常一样,由于你懂得的原因,网速始终是是个绕不开的问题,因而这就需要我们配置自己的本地镜像。

  在Ruby中,其镜像地址也有新老之别,基本上老的已经被废弃了,新版本的镜像地址已经托管到了Ruby China中,其网址如下:

  在这里,其在显眼位置已经说明了Ruby镜像源切换成国内镜像的地址与方式,那就是在控制台中执行如下代码;

gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/

  运行的结果如下:

在这里插入图片描述

安装依赖

  在安装依赖时,由于我们是用Jekyll来运行项目的,因而我们肯定要安装Jekyll依赖组件,因而我们要执行下面的语句:

gem install jekyll

  此时我们在控制台中会发现,其会下载大量的jekyll依赖组件乃至是依赖的依赖。

  上面的依赖组件是Jekyll默认的依赖组件,在项目的运行时,其还会加上项目中配置的依赖组件,也就是说需要下面的组件:

gem install bundler
gem install minima
gem install jekyll-theme-cayman
gem install jekyll-paginate

  从GitHub自己的账户下下载Markdown博客系统源码,并在项目的根目录中打开CMD控制台。

启动项目

  将控制台光标切换到项目根目录中,在此执行下面命令启动Jekyll:

jekyll serve

  其运行后展示的结果为:

在这里插入图片描述

  在上面的结果中,其为我们提供了项目的访问地址,如下:

http://127.0.0.1:4000/

  当我们在浏览器中输入该地址时,我们就可以看到相应的网站运行结果了,如下:

在这里插入图片描述

修改项目

编写博客内容

  在项目中,我们发表的日志与博文存放在_posts文件夹下,而图片存放在img文件夹下,我们可以直接将其中默认的博文直接删掉,然后编写自己的博文并上传自己的图片到img图片文件夹下。

修改package.json

  就是将下面的内容替换成自己的即可。

"name": "zhangzhenyi-blog",
    "title": "Zhangzhenyi Blog",
    "author": "zhangzhenyi <[email protected]>",
    "version": "1.7.0",
    "homepage": "https://zzy-lyc.github.io",
    "repository": {
        "type": "git",
        "url": "https://github.com/zzy-lyc/zzy-lyc.github.io"
    },
    "bugs": "https://github.com/zzy-lyc/zzy-lyc.github.io/issues",

修改_config.yml

  是Jekyll的项目配置文件,在这里的修改与上面的类似。其它的地方,主要是样式与风格,这个就需要大家去不断摸索了,这里就不一一说明了。

猜你喜欢

转载自blog.csdn.net/ZZY1078689276/article/details/84099649