根本原因是Hugo默认不处理assets目录的Sass/TS等源文件,也不自动注入CSS路径;它只原样复制static/内容,而模板中引用的assets/css/main.css实际不存在,导致404和无样式。
为什么 hugo build 生成的页面没有 CSS 样式
根本原因通常是
默认不处理
目录下的原始 Sass/SCSS、TypeScript 或未编译的 JS,也不自动注入 CSS 路径——它只把
下的文件原样复制过去,而主题或自定义模板里写的
链接如果指向了
这类路径,实际并不存在。
常见错误现象:
控制台报错找不到
;页面文字堆叠无排版;
本地预览正常但
后线上失效。
确认你用的是支持 Asset Pipeline 的主题(比如
),或者自己写了
流程
检查
中是否用了
这类调用,而不是直接写
确保
≥ 0.110,旧版本对
的支持不完整,尤其在 Windows 上容易静默失败
如何让 Markdown 中的代码块自动带语言标签和复制按钮
Hugo 本身不提供复制按钮,但可通过组合
+
+ 少量 JS 实现。关键不是“加功能”,而是避免把
配置写错导致语言名丢失。
使用场景:技术博客写 Go 示例时想显示
并允许读者一键复制;不想手动给每个代码块加
类名。
立即学习
“
go语言免费学习笔记(深入)
”;
在
中启用 Chroma:设置
和
Markdown 写法必须是
开头,不能写成
或
—— Chroma 只认标准别名,否则 fallback 成纯文本
复制按钮需自行引入轻量 JS,比如
,绑定到
元素;注意不要重复初始化,否则多个按钮点击都复制第一个块
content/ 下的 _index.md 不生效?
Hugo 把
当作“列表页内容”,但它只在目录有子页面或显式设置了
时才渲染。空目录下放
,默认被忽略。
使用HTML,CSS,JavaScript开发Android应用程序 英文文字pdf版附源文件
如果你了解HTML,CSS和JavaScript,您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造,可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Android友好的网络应用程序,然后转换与自由PhoneGap框架到一个原生的Android应用程序。了解为什么设备无关的移动应用是未来的潮流,并开始构建应用程序,提供更
下载
常见错误现象:访问
显示 404;
日志提示
;模板中
为空但你确信写了
。
确保该目录下至少有一个非
的 Markdown 文件(哪怕只是
),否则 Hugo 认为“这不是一个合法 section”
在
前置参数中显式写
,并确认
存在且能匹配这个 type
如果只想做单页介绍(如文档首页),改用
(根目录)或启用
在
中全局指定
部署到 GitHub Pages 后图片路径全 404
根本问题出在
:本地用
时默认
,但 GitHub Pages 是
,相对路径会错位。
性能影响不大,但兼容性极差——所有
会被解析成
,而实际路径是
。
构建前必须设
,不能依赖 config 中的默认值
更稳妥的做法是用
函数:把
改成
如果用了
,确保
中没误配
却忘了同步
到该目录
最常被忽略的是:GitHub Pages 的项目站点(
)和用户站点(
)对
的要求完全不同,写死一个值撑不过两种部署场景。
hugoassetsstatic/rel="stylesheet"assets/css/main.css404/css/main.csshugo serverhugo buildhugo-theme-keepresources.ExecuteAsTemplatelayouts/partials/head.html{{ $css := resources.Get "scss/main.scss" | resources.ToCSS }}hugo versionresourceshighlightchromahighlightfunc main()language-goconfig.yamlpygmentsCodeFences: truepygmentsUseClasses: true```go```golang```GOclipboard.jspre code_index.mdtype_index.md/posts/hugo serverSkipping empty section "posts".Pages_index.md_index.mdplaceholder.md_index.mdtype: "posts"layouts/_default/list.htmlcontent/_index.mdcascadeconfig.yamltypebaseURLhugo serverbaseURL = "http://localhost:1313/"https://.github.io// /img/foo.png//img/foo.png hugo --baseURL "https://username.github.io/repo/"absURLstatic/img/config.yamlpublishDir: "docs"static/username.github.io/repousername.github.iobaseURL