• 使用CHCA搭建静态博客


    chca是一个使用golang开发的静态博客生成器,简单、方便、快捷,抛弃每次都需要使用命令编译文件,采用文件监听方式编译,作者只需把markdown文件放到配置中的markdown文件夹下就能自动生成html了。

    chca源码地址: https://github.com/num5/chca

    如果你是个不懂程序的小白,chca更加适合你,只需要修改少量配置就可以搭建一个属于自己的博客了。最重要的是,如果你没有自己的服务器,可以将其搭建在github pages上,完全免费的哦。

    关于为什么要开博客?可以看看这篇文章《为什么你要写博客?》

    关于如何在github上搭建博客,网上有很多教程,就不在赘述了。

    必要步骤

    下载chca

    Windows:http://golune.qiniudn.com/chca-win64.tar.gz

    Linux:http://golune.qiniudn.com/chca-linux64.tar.gz

    Mac:http://golune.qiniudn.com/chca-darwin64.tar.gz

    下载平台对应的程序,新建一个文件夹来存放chca所有的文件,并将chca解压到本文件夹下

    如果打算将博客搭建在github上,还需要下载git和申请一个github账号

    go 源码安装

    go get -v github.com/num5/chca
    

    下载chca模板

    下载地址:http://golune.qiniudn.com/default-theme.tar.gz

    关于模板语法说明,请参照:chca模板语法说明

    使用步骤

    chca只需要两步就可以创建一个带有独立web服务器的博客

    第一步:初始化

    打开命令终端,出入命令:

    chca init
    

    这一步会创建 markdown 文件夹和 config.yml 文件,markdown 文件夹用于存放博客的源markdown文件,config.yml是配置文件

    config.yml配置内容如下:

    # config.yml
    
    # 站点信息
    title: 我的网站
    subtitle: 网站标题
    description: mate-description
    keywords: mate-keywords
    summary_line: 10 // 首页文章行数
    home_art_num: 30 // 首页文章数量
    
    # 文件夹相关
    theme: theme/blog //网站模板
    markdown: markdown //博客markdown文件存放文件夹
    html: /data/www/html //博客html文件存放文件夹
    storage: storage //数据存放文件夹,暂时未用到
    
    # 作者信息
    author: your name
    avatar: /assets/avatar.png  //头像连接,一般放到assets或者avatar文件夹里
    github: https://github.com/num5  //github主页
    weibo: http://weibo.com/golune  //微博主页
    mail: 378999587@qq.com  //email 地址
    zhihu: https://www.zhihu.com/people/golune  //知乎主页
     
    # 监听信息配置
    paths:  // 监听文件夹
      - markdown
    exts:  // 监听后缀名
      - md
    
    # 上传信息
    upload_theme: theme/upload  // 上传模版地址
    
    # 自定义标题,可不配置,使用chca设置好的标题
    home_title:     //主页标题
    archive_title:  //文章归档标题
    tag_title:      //标签导航页面标题
    cate_title:     //分类导航页面标题
    about_title:    //简历页面标题
    article_title:  //文章标题标头
    
    

    根据自己需求修改配置文件

    初始化以后需要在config.yml文件同目录下创建theme文件夹用于存放模板文件

    第二步:运行chca

    chca run [port]
    

    打开chca服务,这一步自动打开监听器和内置webserver,默认webserver端口9900,端口可自定义,浏览器输入 http://localhost:9900 就能访问博客了。
    监听器监听markdown文件夹下的以 .md 为后缀的文件,可配置(参照上一步配置中监听信息配置)。当markdown文件夹下的md文件有变动时就会触发编译命令,自动将自动编译markdown文件,生成静态页面。

    其他命令

    新建 markdown 文件

    chca new filename
    

    markdown文件需要以 --- 开头进行说明:

    ---
    date: 2017-01-01
    title: 我的第一篇博客
    categories:
    - 技术
    tags:
    - golang
    - chca
    ---
    

    建议使用 chca new 命令创建markdown文件

    about.md文件是存放作者简历的文件,存放在markdown文件夹,另外readme.md和about.md不会被文章解析器解析

    生成静态页面

    chca complate (或chca c)
    

    这条命令用于编译markdown文件生成静态html页面

    开启文件监听器

    chca watch (或者chca w)
    

    开启文件监听器,监听文件夹和文件后缀名在config.yml里配置

    打开内部服务器

    chca http [port]
    

    打开内部服务器,端口可选,默认监听端口9900


    Markdown语法参考链接: Markdown 语法说明 (简体中文版)

  • 相关阅读:
    dsu on tree
    bzoj3527 [Zjoi2014]力
    bzoj3527 [Zjoi2014]力
    114.遍历文件夹并批量修改文件名
    25.八皇后问题
    24.C语言最全排序方法小结(不断更新)
    112.备忘录设计模式
    110.文件搜索,系统大小获取,以及病毒行为
    109.vprintf vfprintf vscanf vfscanf
    108.sqllite3(C语言数据库库)详解
  • 原文地址:https://www.cnblogs.com/guhao/p/7289691.html
Copyright © 2020-2023  润新知