文章目录
  1. 步骤
  2. Hexo使用
    1. 1. 部署
    2. 2. 命令
      1. init
      2. new
      3. generate
      4. publish
      5. server
      6. deploy
      7. render
      8. migrate
      9. clean
      10. list
      11. version
    3. 其他选项
      1. Safe 模式
      2. Debug 模式
      3. Silent 模式
      4. 定制配置文件路径
  • 3. 发布新文章
  • 参考
  • 步骤

    1. 注册Github
    2. 使用Github Pages建立博客
    3. 下载安装Git、Nodejs、npm、Hexo
    4. 用Hexo克隆主题
    5. 注册域名
    6. 将域名与Github Pages空间绑定

      Hexo使用

    1. 部署

    1
    2
    3
    hexo init <folder>
    cd <folder>
    hexo install

    会生成如下项目文件夹

    1
    2
    3
    4
    5
    6
    7
    8
    9
    .
    ├── _config.yml
    ├── package.json
    ├── scaffolds
    ├── scripts
    ├── source
    | ├── _drafts
    | └── _posts
    └── themes
    • _config.yml负责blog的全局配置,使用YAML格式,注意不能使用tab,使用空格代替,冒号后面要有一个空格
      • Site: title, subtitle, description, author, email, language
      • URL: url, root, permalink, tag_dir, archive_dir, category_dir, code_dir。如果blog是放在子目录下面,如http://yoursite.com/blog,则设置url为http://yoursite.com/blog,设置root为/blog/
      • Writing: new_post_name, default_layout, auto_spacing, titlecase, external_link, filename_case, render_drafts, post_asset_folder, relative_link, highlight
      • Category & Tag: default_category, category_map, tag_map
      • Archives: archive, category, tag,取值2表示启用分页,1表示停用分页,0表示完全停用,默认是2
      • Server: port, logger, logger_format, server_ip
      • Date / Time Format: 用Moment.js解析日期,date_format, time_format
      • Pagination: per_page, pagination_dir
      • Comment: disqus_shortname
      • Extensions: theme, exclude_generator
    • source文件夹是发布文章的地方,以下划线 “_” 开头的文件/文件夹(除了_posts)、隐藏文件都会被忽略。Markdown和HTML文件会被处理后发布到public文件夹下面,其他文件则是简单的拷贝过去。

    2. 命令

    init
    1
    hexo init [folder]

    初始化一个站点,如果没有指定folder,则初始化当前目录为站点

    new
    1
    2
    hexo new [layout] <title>
    hexo n [layout] <title>

    新写一篇文章,如果layout不指定,则默认使用_config.yml中的default_layout配置,如果标题title超过1个字符,需使用引号括起来

    generate
    1
    2
    hexo generate
    hexo g

    生成静态文件,可选项:
    -d, —deploy, 生成后发布
    -w, —watch, 观察变化的文件

    publish
    1
    2
    hexo publish [layout] <filename>
    hexo p [layout] <filename>

    发布一个草稿

    server
    1
    2
    hexo server
    hexo s

    启动服务,可选项:
    -p, —port, 覆盖默认端口
    -s, —static, 只服务静态文件
    -l, —log, 启用日志,覆盖默认的日志格式
    -d, —drafts, 把草稿当做新发布文章

    deploy
    1
    2
    hexo deploy
    hexo d

    发布站点,可选项:
    —setup,不发布的安装
    -g, —generate, 在发布前生成静态文件
    -m, —message, 定制提交信息

    render
    1
    hexo render <file1> [file2]

    渲染文件,可选项:
    -o, —output, 输出的目的地址

    migrate
    1
    hexo migrate <type>

    从其他的博客系统迁移过来

    clean
    1
    hexo clean

    清除缓存文件(db.json)和生成文件(public)

    list
    1
    hexo list <type>

    列出站点的所有路径

    version
    1
    hexo version

    显示版本信息

    其他选项

    Safe 模式
    1
    hexo --safe

    插件和脚本在启用该模式时不会被加载,可以在安装新插件遇到问题时使用

    Debug 模式
    1
    hexo --debug

    在终端显示详细信息,同时保存日志到debug.log

    Silent 模式
    1
    hexo --silent

    隐藏终端的输出

    定制配置文件路径
    1
    hexo --config custom.yml

    定制配置文件,替代_config.yml

    3. 发布新文章

    参考

    如何搭建一个独立博客——简明Github pages与Hexo教程

    文章目录
    1. 步骤
    2. Hexo使用
      1. 1. 部署
      2. 2. 命令
        1. init
        2. new
        3. generate
        4. publish
        5. server
        6. deploy
        7. render
        8. migrate
        9. clean
        10. list
        11. version
      3. 其他选项
        1. Safe 模式
        2. Debug 模式
        3. Silent 模式
        4. 定制配置文件路径
  • 3. 发布新文章
  • 参考