褪色的抽象

Kaffa's blog

尝试用 Hugo 写简历

去年的回顾

2020 年是变化一言难尽的一年。占星学上,2018年以来的摩羯土星的旧本有机会转入水瓶的新,而一场新冠病毒就从底层认知上彻底改变了我们, 我们可能还需再花几年时间,才能从意识形态上转入后新冠时代。 从封城后空荡的街道,到春节前病毒式传播的“假新闻”,从寻求真相却难以求证的人群,到野草般生长的“偏执和怀疑论”,其后全世界范围内开始讨论和寻找零号病人和病毒起因。

在数据的曲线和数字背后,新冠带给一个一个真实的人和家庭的身心伤害在很大程度上被忽视了。其间,我们能看到的只是世界各方对新冠的表演式的应对。 当面对未知与不确定时,新冠有关的信息涡旋裹挟着群体的盲目与恐惧,被互联网的棱镜折射与放大,更清晰地呈现出人类的乐观和悲观情绪。 我们看见了无数人的尽力与无能为力,看见了战疫岗位上朴实无华的坚守,也看见善良和美德之光透过一颗颗平凡的心灵迸射出来, 同样被看见的还有自私与丑恶、傲慢与偏见,将全球数不清的尚未做好准备的人拉到了不得不面对的战场上。 这是个人命运的挫折,更是全人类的灾难,有些事实也许一年或几年还看不清,但当历史的车轮轧过后, 那些狭隘的自私的和虚伪的,都会标上的真实的价码,如同地质运动后的岩层一样戳破残破不堪的地表。

2021 年会更好的吗?我不知道,这一年木土在水瓶大合相,将开始全新的风象时代。这些时代讯息从去年的 "I can't breathe"(我需要风), "Black lives matter"(呼唤水瓶的平等)中已有体现,

为什么是 Hugo ?

为迎接上述转变,我计划将写作源从 reStructureText 转到更新的技术 MarkDown 上以呼应时代的机会。 源自 Python 的 reStructureText 完善稳定,是支撑 Python 众多文档的基础;新生的 MarkDown 基础格式统一,扩展标准兼容性有待完善, 但它有更适合这个风向时代的轻量和通用,在木星水瓶的第一个十年里,MarkDown 很有不断打磨自己和扩张的机会。

给自己的 Hugo 写简历不完全指南

我相信会有很多用 Hugo 写简历的文章,但如何写一篇不过时,不用频繁更新,有更持久意义的文章呢?我不知道。 但可以列出一些达到这个目的的原则:

  • 提供思路,而不是提供步骤
  • 提供方法,而不是提供结果
  • 提供核心,并谨慎提供细节
  • 提供关键字,但不列举资源

思路

一般会用 Hugo 的是 IT 人,大多会知道 Go 语言。 写简历就是使用 Hugo 和 Hugo Theme 来生成一个静态站点。 因此要懂得 Hugo 和 Hugo Theme 的基本用法,再将简历内容写到内容中。 如个人基本信息、联系方式、工作经验、项目经验、教育经历、证书奖励等

方法

可通过 Google 或 Bing 找到 Go 和 Hugo 的官方站点,Hugo 是一个静态站点生成软件,软件都有文档,文档中必然有它的安装和使用方法。

核心

使用软件的核心能力是文档阅读理解英语能力能帮上很大忙。 对于 Hugo 的文档,首先阅读介绍(Introduction),然后阅读安装(Install Hugo), 再阅读目录结构(Directory Structure),最后阅读配置(Configure Hugo)。

这里就不再把安装文档中的步骤摘录于此,因每种操作系统及发行版都提供了命令行软件包管理工具来管理常用软件。 不仅如此,现代软件都相互学习(借鉴)设计,命令行功能简洁易用,Hugo’s CLI 也属于此,但功能无外乎:

  1. hugo new site: 生成新站点
  2. hugo new: 增加新内容
  3. hugo server: 提供 http 服务以供本地测试
  4. hugo help: 其它先不用管功能

Section 我译它为章,即 content 目录下的目录,其中可能包含一组页面。

主要目录结构:很大程度上不会变,也意味着未来也许会改变。

├─ archetypes : 预定义的元数据定义 
├─ config.toml : 配置文件
├─ content : 所有的内容按目录分为章
├─ data : 可以理解为静态化的数据,可被模版使用
├─ layouts : 模版的目录,有默认的页面和模版,模版片段,单页模版等
├─ static : 静态文件
└─ themes : 主题文件

因此上述目录说明应去文档中查看,如果说 Hugo 模式是 MVC 那么 layouts 就是 V,content 和 data 就是 M,而 C 则是 Hugo 本身。 这里完成了 Hugo 的部分,其次就是在 Hugo themes 主题站中寻找 resume 相关的资源,挑选喜欢的款式来作为简历的主题,并配置到 config.toml 中

搜索关键字

Go, Hugo, Hugo Theme, hugo-devresume-theme, Hugo documentation

感谢阅读,希望上述简述和关键字补充了从标题到实践的指引,能指导读者用 Hugo 写简历。 如果您觉得本文有用,可以扫描我的二维码,打赏一杯咖啡。

我的赞赏码