使用Hugo搭建m10c主题博客的笔记
hugo框架下的各个目录说明
几个特殊目录说明:
config.toml>>>配置文件,配置主要用来配置主题,从下载的主题themes\m10c\exampleSite里面的config.toml文件进行适当修改复制到myblog目录下替换该目录的config.toml即可完成配置,不懂就看下载的主题说明,这里是m10c主题,就从主题那个网页看这个主题的说明
content>>>放置写的博客文件
public>>>用于将此文件夹下内容发布至github生成静态网页,过程看下面的说明
themes>>>放置主题文件
创建博客文件夹、下载主题、配置
在hugo框架目录下,运行cmd命令 hugo new site myblog >>>生成myblog博客文件夹,包含上述所说的几个目录
主题下载:在博客文件夹(myblog)下右键运行 git bush,命令
git clone https://github.com//vaga/hugo-theme-m10c.git themes/m10c
下载该主题至theme文件夹下面
配置主题:将theme->目标主题文件夹->exampleSite->config.toml的文件适当修改,然后复制到博客文件夹下替换这里的config.toml
创建文章、本地测试
创建文章文件:在博客文件夹(myblog)下运行cmd命令:hugo new post/first_blog.md >>>完成创建第一个博客文件,在myblog->post->first_blog.md
编辑文章:需要修改文章前三行的属性,draft: false>>>表示并非草稿/// title: “标题”>>> 标注文章的标题///然后在下面写markdown即可///tags:表示标签,文章点进去相同标签的可以分类,就按照以下代码块开头标注即可
title: "取一个文章标题"
date: 2019-07-09T19:22:47+08:00
draft: false
tags: ["标签1"]
本地测试:在博客文件夹目录下运行命令:hugo server –theme=m10c –buildDrafts –watch
浏览器访问http://localhost:1313 即可完成本地预览测试,查看效果
远程部署至github
一、在博客文件夹(myblog)目录下运行cmd命令:hugo –theme=m10c –baseUrl=“https://jacker2019.github.io/" –buildDrafts
即可完成声明,表示要发布网站,于是在myblog->public下面生成很多文件,public文件内的文件均是需要部署到github中的,关注public->post里面是否有个blog文件夹, 这个文件夹里面html文件是可以预览的博客,实际部署完就是这个界面。所以这个文件调试好看了,再去部署
二、github上创建仓库 jacker2019.github.io (用户名.github.io组成)
三、发布至github上:public文件夹内右键 git bush
输入分别输入以下命令:
git init >>>初始化,将public变成本地仓
git add . >>>本地仓所有文件加入暂存区
git commit -m “备注说明” >>>提交至远程仓库
git push https://github.com/jacker2019/jacker2019.github.io.git master >>>这样就上传到我的github中的仓库里面了
更新文件
!!!现在只知道1、将博客的那个仓库删了,重新创建空仓库。2、将public文件夹里面的内容清空,然后重新在post下创建索引页,然后重新进行远程部署至github操作(上一单元的操作)
博客网址
https://jacker2019.github.io/ 也就是仓库名,博客文件关联的目录是:仓库->post->blog->HTML文件
写在最后的注意!!!
创建博客从下载主题以后,配置主要还是按照博客文件夹下的themes文件夹内的主题模板进行配置。不同的主题配置完全不同。
路径:myblog\themes\m10c\exampleSite
按照模板去配置 static、content文件夹和config.tmol文件
一般头像这种等静态图片在static文件夹下
写的博客文件在content文件夹下,文件夹内设计也按照主题模板来设置
最后在附上几个网址:
教程网址:https://www.jianshu.com/p/475110a1c811
hugo命令说明:https://blog.51cto.com/michaelkang/2364096?source=dra
hugo中文文档https://www.gohugo.org/