hugo是什么
hugo是高性能静态网页生成软件，可以将markdown文档转为静态网页。
如果你也习惯用markdown写作，那么使用hugo可以方便的将文档转为网站。
Quick start
hugo的使用非常简单，没有比官方文档更简单的介绍了。
这里的tips：
hugo new生成的markdown文档默认是不发布的，需要将文档中的draft: true改为draft: false，有些文章让你删掉这行，是错误的。
hugo生成的静态网站部署到github上
背景
github提供了静态网站托管功能，即代码库中的静态文件作为静态网站内容，可以作为一个静态网站进行展示。配置方式如下：
github-pages.png
github提供两种配置方式：
- 使用master分支：图中第三步；以根目录作为网站根目录或者以docs作为网站根目录，图中第四步
- 使用gh-pages branch，本文不对这种方式进行介绍（还没测试过）
选择的目录结构
hugo将markdown转换为静态网站，网页源代码在markdown文件中，即content目录，而生成的静态网站在docs目录。我需要网页源代码与生成的网站在同一个repository下。
因此选择github pages配置为使用master分支下得docs目录，hugo要做如下修改：
- 修改生成静态网站的路径，默认路径是public。 增加 publishDir = "docs" 配置到config.toml文件中
- 修改baseUrl，即网站root url。网页上有一个链接可以跳转回网站根目录，baseUrl即为网站根目录地址，配置为github pages的地址即可。
真的需要hugo吗
在我测试完hugo后，我决定放弃hugo了。原因有如下几点：
- 图片的使用还是有些繁琐，image processing，shortcode等概念学习使用起来费劲。
- 技术博客需要与网友交流，因此评论是非常重要的功能
- 图片因为使用了image processing等概念，不兼容typora等原生markdown，在本地用typora编辑无法预览图片
- theme的设置还是有点复杂
- github托管静态网站，应该没办法支持搜索，文章多了的话，没有搜索还是挺麻烦的
- 写博客也不知道能否坚持下去，有折腾的功夫，不如多码点字
对我来说，核心的需求很简单：
- 可以用markdown写作，最好是原生markdown语法，这样可以使用typora等软件进行撰写。
- 可以在线展示：工作中与同事协同可以方便的贴个链接过去，比如iperf的使用方法
- 输出高质量的内容，当然希望有更多的人看到，在国内，不得不考虑github和类似简书这样的平台被搜索引擎收录的情况
- 可以在多个平台同步，简书写一份，知乎写一份。要修改文章时同步起来就费劲了，这点目前无解
所以我放弃了hugo，如果你真的想用hugo，建议：
- 是否能够接受无法通过评论与网友交流，部署到github不支持站内搜索
- 是否能够自己折腾主题，定制各种高大上的功能，比如目录，比如tag
如果只是想通过markdown码子的话，建议还是算了。简书挺好，除了编辑器不支持typora这种模式除外。
