hugo中文手册

本手册是hugo中文手册,本站基于hugo建立。

hugo中文手册

hugo在线手册由“字母-原创设计技术”编写。本手册涵盖了hugo的方方面面,hugo吸引人的地方并不是它的技术和功能,而是思想。官方文档非常详尽,本手册不作翻译,而是真正的中文化,满足需求的系统手册,而非寥寥几篇文章而已。

一个CMS

首先hugo是一个CMS,就是内容管理系统。

它具备CMS的功能,它直接生成html文档,它使用文件进行数据存储。

快速的

hugo开发是快速的。搭建环境快速,在windows系统上它就一个exe文件,不用安装,不用服务器,不用数据库。

hugo运行是快速的。生成速度可以让你忽略它的存在。

学习hugo是快速的。hugo的学习曲线非常低,三分钟入门,一个小时上手,唯一的陡峭和核心技术就是模板制作。

改变您我的未来

hugo讲改变您我的未来的工作模式,也将带来全新的互联网开发模式,和一大批的原创作品。

现有CMS管理,基本模式是基于数据库的,各种数据关系代表了各种管理的功能,文章则通过js的编辑器,生成纯html代码,存入数据库中。任何一个操作都要浪费服务器资源,都要读写数据库。

hugo采用文档和markdown文件存储文章,不用js编辑器,支持标题、段落、列表、链接、图像这几种常见的格式,并且非常适合人工编写和阅读。它也支持html代码。

hugo在本地或者服务器上生成纯静态的html文件供访问,但它依旧可以方便的对各部分进行增加、修改、删除操作。

动着的的静态

本手册和站点尚处于主题模板制作中,内容也处于编著中。得益于hugo的静态化,所有这些都是html代码存放于服务器,对服务器不存在安全隐患,对用户也不存在使用隐患。

站点的内容和外观将在大家的见证下一步步的搭建起来,另外一大波入门的视频也将与大家见面,还没决定是否使用hugo?那就从安装hugo开始,自己试了才知道什么叫快速,什么叫“胡搞”。

实用简洁

任何的文本的东西都让人看了心烦,所以我们要简洁。大家有任何问题都可以到群里面讨论。

hugo中文交流群:494082870

hugo中文交流

中文化

文件名?目录?服务器?这些东西从一开始便和中文永远的诀别了。

本手册作为中文手册,最大程度的测试和推荐中文的支持:

中文排版推荐

段落缩进

段落缩进。中文段落空两字,CSS中写入:

/*css设置中文段落缩进*/
p{
    text-indent:2rem;
}

中文字体

很不幸的,操作系统和浏览器能用的中文字体非常的少,这个一般就不用特别考虑了,就那几个可用而已。

中文标题

一般的英文模板和css前端的中文标题(h1 h2到h5)字号变化都比较大,看上去非常不协调。

//本站的bootstrap的less文件(变量部分),标题字号:
@font-size-h1:            floor((@font-size-base * 1.618)); 
@font-size-h2:            floor((@font-size-base * 1.4635)); 
@font-size-h3:            ceil((@font-size-base * 1.309)); 
@font-size-h4:            ceil((@font-size-base * 1.1545)); 
@font-size-h5:            @font-size-base;
@font-size-h6:            ceil((@font-size-base * 0.8455)); 

以上为本站所用的中文标题大小,您可以根据需要适当修改。

中文行距

一般的,1.5到2倍的行距看上去比较舒服,这个英文来的模板都偏小。

几点建议

目录文件名

最好别用,在服务器大量支持的前提之前,否则链接会失效。

文件编码

一定要用UTF-8。推荐采用“UTF-8无BOM格式”编码。

套用模板

hugo官网具有很多漂亮的模板,你可以直接下载使用。但是这些模板都是英文的,看上去非常好看,用来显示中文会非常的别扭。

如果您有前端开发经验,建议和推荐使用“bootstrap”来制作自己的样式,这是现在的主流和趋势。