给J小将的写博客指南

  1. Home
  2. posts
  3. hugo
  4. 007_how_to_setup_blog

剧情摘要：前些日子，帮J小将在主机上搭了博客，但是如何让她在另一台电脑也能写文章呢？

前提准备

下载Git

  1. 地址：https://git-scm.com/download/win
  2. 选择64-bit Git for Windows Setup
  3. 打开安装包，按照推荐项一路enter下去就好
  4. 在任意一个窗口地址栏输入cmd，按回车，输入git version，回车。若出现版本号则说明下载成功。

下载Hugo

方法一：二进制安装包

  1. 地址：https://github.com/gohugoio/hugo/releases
  2. 找到 hugo_extended_0.95.0_Windows-64bit.zip 安装包，下载。
  3. 创建文件夹
    • 创建一个新的文件夹，G:\Hugo
    • 创建一个新的文件夹，G:\Hugo\bin
  4. 确保 hugo.exe 文件在 G:\Hugo\bin 文件夹中
  5. 把 hugo.exe 可执行文件添加到你的 PATH路径中
    • 搜索：环境变量 - 编辑系统环境变量 - 高级 - 环境变量
    • 系统变量 - 找到path - 双击打开 - 新建变量 - 输入G:\Hugo\bin - 保存
  6. 运行hugo.exe
  7. 输入hugo version查看得到版本号就说明安装成功。

方法二：用chocoley安装

  1. 地址：https://chocolatey.org/install ,按照提示安装即可

  2. 运行 普通版本

    choco install hugo -confirm

extended版本：

choco install hugo-extended -confirm

下载 Visual Studio Code 编辑器

  1. 地址：https://code.visualstudio.com/

将博客文件clone到本地

配置git用户名和邮箱

  1. 找一个好记的地方，创建文件夹Hugo（或者随便一个什么名字），在地址栏输入cmd以打开命令行，输入下面指令：

    $ git config --global user.name "Username"
$ git config --global user.email you@example.com

查看设置好的邮箱和用户：

git config --global --list

从Github仓库Clone文件夹

  1. Clone存放博客源代码的仓库

    git clone https://github.com/janew14/blog-sources.git

    连接也许不稳定，试试连vpn或切换vpn，总之，坚持到提示完成。 （坚持住！）

  2. Clone完成后，你会发现多了一个blog-sources文件夹，点进去就是刚从仓库复制下来的文件，这会儿可以开始写博客了。

写文章

  1. 打开Visual Studio Code，在应用商店（左侧栏最下面一个图标）搜索chinese，下载中文字体包
  2. 点击文件 - 将文件夹添加到工作区 - 添加blog-sources文件夹
  3. 找到content/posts/，在需要的分类下创建新的 .md文档，就可以在里面写博客内容了。

  4. 在博客内容前加上一些front matter，设置基本信息，如

    ---
author:
- name: "Jane"  //作者的名字
date: 2022-03-19  // 时间格式
title: "今天"  // 文章标题
categories:
- "日记"  // 添加分类
tags:
- "博客"
- "个人"  // 添加标签
---

  5. 提交之前预览：

    hugo serve

推送提交到仓库

写好文章后，需要push到仓库，博客才会显示更新后的内容。 1. 在blog-sources文件夹打开cmd，输入:

hugo
git add .
git commit -m"任意的附注内容”
git push
  1. 因为网络问题，可以开关vpn多试几次。如果push显示403错误，可能出现验证问题，可能需要添加SSH KEY，到时候联系我。
  2. 因为已经配置好Github Action，所以只需要将源码推送，public的代码也会自动更新，而不需要推送两遍。