zoukankan      html  css  js  c++  java
  • 利用GitHub从零开始搭建一个博客

    一般我们要搭建一个个人的博客站点需要买服务器、域名,装各种运行环境等等,非常的费钱费力。

    其实就算没有这些,我们也是照样可以通过Hexo框架结合GitHub Pages搭建一个自己的博客站点的。

    Hexo 这个博客框架没有那么重量级,它是 MarkDown 直接写文章的,然后 Hexo 可以直接将文章编译成静态网页文件并发布,所以这样文章的内容、标题、标签等信息就没必要存数据库里面了,是直接纯静态页面了,这就解决了数据库的问题。

    1、准备条件

    • GitHub账号
    • 域名(可选)

    2、新建GitHub项目

    首先在 GitHub 新建一个仓库(Repository),名称为 {username}.github.io,注意这个名比较特殊,必须要是 github.io 为后缀结尾的。比如我的用户名是59devops,那么就新建一个59devops.github.io的仓库。

    3、为仓库配置SSH-Key

    因为后期我们更新文章或者提交代码需要有相应的权限才可以,通过用户名和密码不方便且不安全,所以非常有必要配置SSH-Key密钥。

    3.1 创建密钥对

    cd ~/. ssh
    ssh-keygen -t rsa -C "邮件地址"
    

    然后连续3次回车,最终会生成一个文件在用户目录下,打开用户目录,找到.sshid_rsa.pub文件,记事本打开并复制里面的内容,打开你的github主页,进入个人设置 -> SSH and GPG keys -> New SSH key:

    3.2 测试是否成功

    ssh -T git@github.com
    

    如上图显示,则表示SSH-Key配置成功!

    3.3 配置Git信息

    git config --global user.name "59devops"
    git config --global user.email  "59devops@gmail.com"
    

    4、安装环境

    4.1 安装Node.js

    首先在自己的电脑上安装 Node.js,下载地址:https://nodejs.org/zh-cn/download/,可以安装 Stable 版本。

    安装完毕之后,确保环境变量配置好,能正常使用 npm 命令。

    npm --version
    

    4.2 安装Hexo

    Hexo是一个博客框架,Hexo 官方还提供了一个命令行工具,用于快速创建项目、页面、编译、部署 Hexo 博客,所以在这之前我们需要先安装 Hexo 的命令行工具。

    sudo npm install -g hexo-cli
    

    安装完毕之后,确保环境变量配置好,能正常使用 hexo 命令。

    hexo --version
    

    5、初始化项目

    5.1 创建项目

    使用 Hexo 的命令行创建一个项目,并将其在本地跑起来,整体跑通看看。

    首先使用如下命令创建项目:

    hexo init {name}
    

    这里的name就是项目名,我这里要创建59devops的博客,我就把项目取名为59devops了,用了纯小写,命令如下:

    hexo init 59devops
    

    这样59devops文件夹下就会出现 Hexo 的初始化文件,包括 themes、scaffolds、source 等文件夹。

    5.2 编译生成HTML代码

    首先进入新生成的文件夹里面,然后调用 Hexo 的 generate 命令,将 Hexo 编译生成 HTML 代码,命令如下:

    hexo generate
    

    可以看到输出结果里面包含了 js、css、font 等内容,并发现他们都处在了项目根目录下的 public 文件夹下面了。

    5.3 本地运行项目

    利用 Hexo 提供的 serve 命令把博客在本地运行起来,命令如下:

    hexo serve
    

    项目成功运行在本地的4000端口上,浏览器访问http://localhost:4000

    6、部署项目

    将这个初始化的博客进行一下部署,放到 GitHub Pages 上面验证一下其可用性。成功之后我们可以再进行后续的修改,比如修改主题、修改页面配置等等。

    Hexo 已经给我们提供一个命令,利用它我们可以直接将博客一键部署,不需要手动去配置服务器或进行其他的各项配置。

    6.1 修改部署地址

    打开根目录下的 _config.yml 文件,找到 Deployment 这个地方,把刚才新建的 Repository 的地址贴过来,然后指定分支为 master 分支,最终修改为如下内容:

    # Deployment
    ## Docs: https://hexo.io/docs/deployment.html
    deploy:
      type: git
      repo: https://github.com/59devops/59devops.github.io.git
      branch: master
    

    6.2 安装Git部署插件

    需要额外安装一个支持 Git 的部署插件,名字叫做hexo-deployer-git,有了它我们才可以顺利将其部署到 GitHub 上面,如果不安装的话,在执行部署命令时会报如下错误:

    Deployer not found: git
    

    安装hexo-deployer-git插件的命令如下:

    npm install hexo-deployer-git --save
    

    6.3 部署项目

    安装成功后,执行部署命令:

    hexo deploy
    

    如果出现类似上面的内容,就证明我们的博客已经成功部署到 GitHub Pages 上面了,这时候我们访问一下 GitHub Repository 同名的链接,比如我的59devops博客的 Repository 名称取的是59devops.github.io,那我就访问 http://59devops.github.io,这时候我们就可以看到跟本地一模一样的博客内容了。

    查看一下GitHub上的内容:

    这些内容实际上是博客文件夹下面的 public 文件夹下的所有内容,Hexo 把编译之后的静态页面内容上传到 GitHub 的 master 分支上面去了。

    6.4 访问测试

    6.5 上传博客源码到GitHub仓库

    那我博客的源码也想放到 GitHub 上面怎么办呢?其实很简单,新建一个其他的分支就好了,比如我这边就新建了一个 source 分支,代表博客源码的意思。

    具体的添加过程就很简单了,参加如下命令:

    git init    # 初始化项目
    git checkout -b source    # 创建并切换到source分支
    git add -A    # 添加所有文件到暂存区
    git commit -m "init blog"    # 提交并注释
    git remote add origin git@github.com:59devops/59devops.github.io.git    # 添加到远程仓库
    git push origin source    # 将代码提交到远程的source分支
    

    在GitHub仓库中可以看到已经有两个分支:

    7、配置站点信息

    完成如上内容之后,实际上我们只完成了博客搭建的一小步,因为我们仅仅是把初始化的页面部署成功了,博客里面还没有设置任何有效的信息。下面就让我们来进行一下博客的基本配置,另外换一个好看的主题,配置一些其他的内容,让博客真正变成属于我们自己的博客吧。

    7.1 修改站点标题、关键字信息

    修改根目录下的 _config.yml 文件,找到 Site 区域,这里面可以配置站点标题 title、副标题 subtitle 等内容、关键字 keywords 等内容,比如我的就修改为如下内容:

    # Site
    title: 59Devops
    subtitle: 一个运维小菜鸡的个人博客网站。
    description: 记录学习、工作和生活中遇到的各种问题。
    keywords: "运维, Python, Shell, ..."
    author: StaryJie
    language: zh-CN
    timezone: Asia/Shanghai
    

    hexo serve在本地运行并在浏览器中打开测试:

    7.2 修改主题

    目前 Hexo 里面应用最多的主题基本就是 Next 主题了,个人感觉这个主题还是挺好看的,另外它支持的插件和功能也极为丰富,配置了这个主题,我们的博客可以支持更多的扩展功能,比如阅览进度条、中英文空格排版、图片懒加载等等。

    7.2.1 下载主题

    目前 Next 主题已经更新到 7.x 版本了,我们可以直接到 Next 主题的 GitHub Repository 上把这个主题下载下来。

    首先命令行进入到项目的根目录,执行如下命令即可:

    git clone https://github.com/theme-next/hexo-theme-next themes/next
    

    执行完毕之后 Next 主题的源码就会出现在项目的 themes/next 文件夹下。

    7.2.2 修改主题

    修改下博客所用的主题名称,修改项目根目录下的 _config.yml 文件,找到 theme 字段,修改为 next 即可,修改如下:

    theme: next
    

    7.2.3 本地预览

    然后本地重新开启服务,访问刷新下页面,就可以看到 next 主题就切换成功了,预览效果如下:

    7.3 配置主题

    现在我们已经成功切换到 next 主题上面了,接下来我们就对主题进行进一步地详细配置吧,比如修改样式、增加其他各项功能的支持。

    Next 主题内部也提供了一个配置文件,名字同样叫做 _config.yml,只不过位置不一样,它在 themes/next 文件夹下,Next 主题里面所有的功能都可以通过这个配置文件来控制,下文所述的内容都是修改的 themes/next/_config.yml 文件。

    7.3.1 样式

    Next 主题还提供了多种样式,风格都是类似黑白的搭配,但整个布局位置不太一样,通过修改配置文件的 scheme 字段即可,我选了 Pisces 样式,修改 _config.yml (注意是 themes/next/_config.yml 文件)如下:

    scheme: Pisces
    

    另外还有几个可选项,比如:

    # scheme: Muse
    #scheme: Mist
    scheme: Pisces
    #scheme: Gemini
    

    重新在本地运行,浏览器查看就已经变成Pisces样式了:

    7.4 favicon

    favicon 就是站点标签栏的小图标,默认是用的 Hexo 的小图标,如果我们有站点 Logo 的图片的话,我们可以自己定制小图标。

    7.4.1 获取图标

    但这并不意味着我们需要自己用 PS 自己来设计,已经有一个网站可以直接将图片转化为站点小图标,站点链接为:https://realfavicongenerator.net,到这里上传一张图,便可以直接打包下载各种尺寸和适配不同设备的小图标。

    7.4.2 更换图标

    图标下载下来之后把它放在 themes/next/source/images 目录下面。

    然后在配置文件里面找到 favicon 配置项,把一些相关路径配置进去即可,示例如下:

    favicon:
      small: /images/favicon-16x16.png
      medium: /images/favicon-32x32.png
      apple_touch_icon: /images/apple-touch-icon.png
      safari_pinned_tab: /images/safari-pinned-tab.svg
    

    配置完成之后刷新页面,整个页面的标签图标就被更新了。

    7.5 avatar

    avatar 这个就类似站点的头像,如果设置了这个,会在站点的作者信息旁边额外显示一个头像,比如我这边有一张 avatar.png 图片:

    将其放置到 themes/next/source/images/avatar.png 路径,然后在主题 _config.yml 文件下编辑 avatar 的配置,修改为正确的路径即可。

    # Sidebar Avatar
    avatar:
      # In theme directory (source/images): /images/avatar.gif
      # In site directory (source/uploads): /uploads/avatar.gif
      # You can also use other linking images.
      url: /images/avatar.png
      # If true, the avatar would be dispalyed in circle.
      rounded: true
      # If true, the avatar would be rotated with the cursor.
      rotated: true
    

    配置完成之后刷新页面,头像的图片就会显示出来。

    7.6 rss

    博客一般是需要 RSS 订阅的,如果要开启 RSS 订阅,这里需要安装一个插件,叫做 hexo-generator-feed,安装完成之后,站点会自动生成 RSS Feed 文件,安装命令如下:

    npm install hexo-generator-feed --save
    

    在项目根目录下运行这个命令,安装完成之后不需要其他的配置,以后每次编译生成站点的时候就会自动生成 RSS Feed 文件了。

    7.7 code

    作为一个为程序员,虽然代码敲的不咋样,但是代码块的显示还是需要很讲究的,默认的代码块我个人不是特别喜欢,因此我把代码的颜色修改为黑色,并把复制按钮的样式修改为类似 Mac 的样式,修改 _config.yml 文件的 codeblock 区块如下:

    codeblock:
      # Code Highlight theme
      # Available values: normal | night | night eighties | night blue | night bright | solarized | solarized dark | galactic
      # See: https://github.com/chriskempson/tomorrow-theme
      # highlight_theme: normal
      highlight_theme: night bright
      # Add copy button on codeblock
      copy_button:
        enable: true
        # Show text copy result.
        show_result: true
        # Available values: default | flat | mac
        style: mac
    

    修改样式前是这样的:

    修改完之后是这样的:

    7.8 top

    我们在浏览网页的时候,如果已经看完了想快速返回到网站的上端,一般都是有一个按钮来辅助的,这里也支持它的配置,修改 _config.yml 的 back2top 字段即可,我的设置如下:

    back2top:
      enable: true
      # Back to top in sidebar.
      sidebar: false
      # Scroll percent label in b2t button.
      scrollpercent: true
    

    enable 默认为 true,即默认显示。sidebar 如果设置为 true,按钮会出现在侧栏下方,个人觉得并不是很好看,就取消了,scrollpercent 就是显示阅读百分比,个人觉得还不错,就将其设置为 true。

    7.9 reading_process

    reading_process,阅读进度。大家可能注意到有些站点的最上侧会出现一个细细的进度条,代表页面加载进度和阅读进度,如果大家想设置的话也可以试试,我将其打开了,修改 _config.yml 如下:

    # Reading progress bar
    reading_progress:
      enable: true
      # Available values: top | bottom
      position: top
      color: "#222"
      height: 2px
    

    效果如下:

    7.10 bookmark

    书签,可以根据阅读历史记录,在下次打开页面的时候快速帮助我们定位到上次的位置,大家可以根据喜好开启和关闭,我的配置如下:

    bookmark:
      enable: true
      # Customize the color of the bookmark.
      color: "#222"
      # If auto, save the reading progress when closing the page or clicking the bookmark-icon.
      # If manual, only save it by clicking the bookmark-icon.
      save: auto
    

    7.11 github_banner

    在一些技术博客上,大家可能注意到在页面的右上角有个 GitHub 图标,点击之后可以跳转到其源码页面,可以为 GitHub Repository 引流,大家如果想显示的话可以自行选择打开,我的配置如下:

    # `Follow me on GitHub` banner in the top-right corner.
    github_banner:
      enable: true
      permalink: https://github.com/59devops/59devops.github.io.git
      title: Follow 59devops on GitHub
    

    效果如下:

    7.12 gitalk

    由于 Hexo 的博客是静态博客,而且也没有连接数据库的功能,所以它的评论功能是不能自行集成的,但可以集成第三方的服务。

    Next 主题里面提供了多种评论插件的集成,有 changyan | disqus | disqusjs | facebook_comments_plugin | gitalk | livere | valine | vkontakte 这些。

    1.12.1 注册OAuth Application

    首先需要在 GitHub 上面注册一个 OAuth Application,链接为:https://github.com/settings/applications/new,注册完毕之后拿到 Client ID、Client Secret 就可以了。

    1.12.2 修改配置

    首先需要在 _config.yml 文件的 comments 区域配置使用 gitalk:

    # Multiple Comment System Support
    comments:
      # Available values: tabs | buttons
      style: tabs
      # Choose a comment system to be displayed by default.
      # Available values: changyan | disqus | disqusjs | facebook_comments_plugin | gitalk | livere | valine | vkontakte
      active: gitalk
    

    主要是 comments.active 字段选择对应的名称即可。

    然后找打 gitalk 配置,添加它的各项配置:

    # Gitalk
    # Demo: https://gitalk.github.io
    # For more information: https://github.com/gitalk/gitalk
    gitalk:
      enable: true
      github_id: 59devops
      repo: 59devops.github.io
      client_id: cb34a61011c438548cec
      client_secret: 3d9c756a081ce2b91a6a286eb1a0a02a71ced6ca
      admin_user: 59devops
      distraction_free_mode: true # Facebook-like distraction free mode
      # Gitalk's display language depends on user's browser or system environment
      # If you want everyone visiting your site to see a uniform language, you can set a force language value
      # Available values: en | es-ES | fr | ru | zh-CN | zh-TW
      language: zh-CN
    

    进入文章之后,效果如下:

    GitHub 授权登录之后就可以使用了,评论的内容会自动出现在 Issue 里面。

    7.13 pangu

    如果你习惯在中文和英文之间留空格的话,pangu 就是来解决这个问题的,我们只需要在主题里面开启这个选项,在编译生成页面的时候,中英文之间就会自动添加空格,看起来更加美观。

    具体的修改如下:

    pangu: true
    

    7.14 math

    可能在一些情况下我们需要写一个公式,比如演示一个算法推导过程,MarkDown 是支持公式显示的,Hexo 的 Next 主题同样是支持的。

    Next 主题提供了两个渲染引擎,分别是 mathjax 和 katex,后者相对前者来说渲染速度更快,而且不需要 JavaScript 的额外支持,但后者支持的功能现在还不如前者丰富,具体的对比可以看官方文档:https://theme-next.org/docs/third-party-services/math-equations。

    这里选择了 mathjax,通过修改配置即可启用:

    math:
      enable: true
    
      # Default (true) will load mathjax / katex script on demand.
      # That is it only render those page which has `mathjax: true` in Front-matter.
      # If you set it to false, it will load mathjax / katex srcipt EVERY PAGE.
      per_page: true
    
      # hexo-renderer-pandoc (or hexo-renderer-kramed) required for full MathJax support.
      mathjax:
        enable: true
        # See: https://mhchem.github.io/MathJax-mhchem/
        mhchem: true
    

    mathjax 的使用需要我们额外安装一个插件,叫做 hexo-renderer-kramed,另外也可以安装 hexo-renderer-pandoc,命令如下:

    npm un hexo-renderer-marked --save
    npm i hexo-renderer-kramed --save
    

    另外还有其他的插件支持,大家可以到官方文档查看。

    7.15 pjax

    可能大家听说过 Ajax,没听说过 pjax,这个技术实际上就是利用 Ajax 技术实现了局部页面刷新,既可以实现 URL 的更换,有可以做到无刷新加载。

    要开启这个功能需要先将 pjax 功能开启,然后安装对应的 pjax 依赖库,首先修改 _config.yml 修改如下:

    pjax: true
    

    然后安装依赖库,切换到 next 主题下,然后安装依赖库:

    cd themes/next
    git clone https://github.com/theme-next/theme-next-pjax source/lib/pjax
    

    这样 pjax 就开启了,页面就可以实现无刷新加载了。

    7.16 其他配置

    参考官方文档:https://theme-next.org/docs/。

    8、文章

    8.1 新建文章

    Hexo默认安装完就会有一篇文章,我们需要借助hexo命令添加新的文章:

    hexo new hello-hexo
    

    创建的文章会出现在 source/_posts 文件夹下,是 MarkDown 格式。

    8.2 文章标签和分类

    在文章开头通过如下格式添加必要信息:

    ---
    title: 标题 # 自动创建,如 hello-world
    date: 日期 # 自动创建,如 2019-09-22 01:47:21
    tags: 
    - 标签1
    - 标签2
    - 标签3
    categories:
    - 分类1
    - 分类2
    ---
    

    开头下方撰写正文,MarkDown 格式书写即可。

    这样在下次编译的时候就会自动识别标题、时间、类别等等,另外还有其他的一些参数设置,可以参考文档:https://hexo.io/zh-cn/docs/writing.html。

    8.3 博客首页只显示文章标题和摘要

    默认情况下hexo博客(如本站)的首页显示的是完整的文章 – 而文章比较长的时候这无疑会带来诸多不便。只要加入一个<!-- more -->这样的占位符在文章正文里面即可:

    这就是一个简介
    <!-- more -->
    这里更多的内容
    

    本地运行刷新后效果如下:

    9、标签页

    现在我们的博客只有首页、文章页,如果我们想要增加标签页,可以自行添加,这里 Hexo 也给我们提供了这个功能,在根目录执行命令如下:

    hexo new page tags
    

    执行这个命令之后会自动帮我们生成一个 source/tags/index.md 文件,内容就只有这样子的:

    ---
    title: tags
    date: 2019-09-27 11:42:49
    ---
    

    我们可以自行添加一个 type 字段来指定页面的类型:

    type: tags
    comments: false
    

    然后再在主题的 _config.yml 文件将这个页面的链接添加到主菜单里面,修改 menu 字段如下:

    menu:
      home: / || home
      #about: /about/ || user
      tags: /tags/ || tags
      #categories: /categories/ || th
      archives: /archives/ || archive
      #schedule: /schedule/ || calendar
      #sitemap: /sitemap.xml || sitemap
      #commonweal: /404/ || heartbeat
    

    本地运行刷新后,界面如下:

    可以看到左侧导航也出现了标签,点击之后右侧会显示标签的列表。

    10、分类页

    分类功能和标签类似,一个文章可以对应某个分类,如果要增加分类页面可以使用如下命令创建:

    hexo new page categories
    

    然后同样地,会生成一个 source/categories/index.md 文件。

    我们可以自行添加一个 type 字段来指定页面的类型:

    type: categories
    comments: false
    

    然后再在主题的 _config.yml 文件将这个页面的链接添加到主菜单里面,修改 menu 字段如下:

    menu:
      home: / || home
      #about: /about/ || user
      tags: /tags/ || tags
      categories: /categories/ || th
      archives: /archives/ || archive
      #schedule: /schedule/ || calendar
      #sitemap: /sitemap.xml || sitemap
      #commonweal: /404/ || heartbeat
    

    刷新后页面如下:

    11、搜索页

    很多情况下我们需要搜索全站的内容,所以一个搜索功能的支持也是很有必要的。

    如果要添加搜索的支持,需要先安装一个插件,叫做 hexo-generator-searchdb,命令如下:

    npm install hexo-generator-searchdb --save
    

    然后在项目的 _config.yml 里面添加搜索设置如下:

    search:
      path: search.xml
      field: post
      format: html
      limit: 10000
    

    然后在主题的 _config.yml 里面修改如下:

    # Local Search
    # Dependencies: https://github.com/wzpan/hexo-generator-search
    local_search:
      enable: true
      # If auto, trigger search by changing input.
      # If manual, trigger search by pressing enter key or search button.
      trigger: auto
      # Show top n results per article, show all results by setting to -1
      top_n_per_article: 5
      # Unescape html strings to the readable one.
      unescape: false
      # Preload the search data when the page loads.
      preload: false
    

    这里用的是 Local Search,如果想启用其他是 Search Service 的话可以参考官方文档:https://theme-next.org/docs/third-party-services/search-services。

    12、404页面

    另外还需要添加一个 404 页面,直接在根目录 source 文件夹新建一个 404.md 文件即可,内容可以仿照如下:

    ---
    title: 404 Not Found
    date: 2019-09-27 12:21:37
    ---
    
    <center>
    对不起,您所访问的页面不存在或者已删除。
    您可以<a href="https://blog.59devops.com>">点击此处</a>返回首页。
    </center>
    
    <blockquote class="blockquote-center">
        59Dveops
    </blockquote>
    

    这里面的一些相关信息和链接可以替换成自己的。

    其实 Hexo 还有很多很多功能,可以直接参考官方文档:https://hexo.io/zh-cn/docs/ 查看更多的配置。

    15、部署脚本

    最后我这边还增加了一个简易版的部署脚本,其实就是重新 gererate 下文件,然后重新部署。在根目录下新建一个 deploy.sh 的脚本文件,内容如下:

    hexo clean
    hexo generate
    hexo deploy
    

    这样我们在部署发布的时候只需要执行:

    sh deploy.sh
    

    就可以完成博客的更新了,非常简单。

    16、自定义域名

    将页面修改之后可以用上面的脚本重新部署下博客,其内容便会跟着更新。

    另外我们也可以在 GitHub 的 Repository 里面设置域名,找到 Settings,拉到下面,可以看到有个 GitHub Pages 的配置项,如图所示:

    下面有个 custom domain 的选项,输入你想自定义的域名地址,然后添加 CNAME 解析就好了。

    另外下面还有一个 Enforce HTTPS 的选项,GitHub Pages 会在我们配置自定义域名之后自动帮我们配置 HTTPS 服务。刚配置完自定义域名的时候可能这个选项是不可用的,一段时间后等到其可以勾选了,直接勾选即可,这样整个博客就会变成 HTTPS 的协议的了。

    另外有一个值得注意的地方,如果配置了自定义域名,在目前的情况下,每次部署的时候这个自定义域名的设置是会被自动清除的。所以为了避免这个情况,我们需要在项目目录下面新建一个 CNAME 文件,路径为 source/CNAME,内容就是自定义域名。

    比如我就在 source 目录下新建了一个 CNAME 文件,内容为:

    blog.59devops.com
    

    这样避免了每次部署的时候自定义域名被清除的情况了。

  • 相关阅读:
    基本指令
    javascript event(事件对象)详解
    Sass进阶之路,之二(进阶篇)
    Sass进阶之路,之一(基础篇)
    原型链进阶
    数据类型检测
    JavaScript引用类型和值类型
    i.mx6 Android6.0.1分析input子系统:测试
    (三)JNI常用示例
    (二)JNI方法总结
  • 原文地址:https://www.cnblogs.com/jie-fang/p/13445913.html
Copyright © 2011-2022 走看看