静态站点前端开发工具【免费下载链接】kit Describe your site, AI builds it, you own it as Markdown. Snap together Tailwind blocks like Lego — landing pages, blogs, portfolios, docs more. No AI slop. Free to deploy anywhere 项目地址https://gitcode.com/gh_mirrors/hu/kit点击查看免费下载导读本指南以 modules/blox-bootstrap/archetypes/publication/index.md 为核心文档面向在 Hugo BloxAcademic 主题继任者上搭建学术简历、研究组或出版物列表页的开发者完整讲解出版物publication内容类型的全部前置元数据字段、出版物类型编码表、DOI 与自定义链接、附件按钮机制以及封面图、关联项目、演讲幻灯片的配置方式。读完本文你将掌握如何零配置创建一篇结构化、可被引用Cite、可被列表过滤与搜索引擎收录的学术论文页面并能理解这些字段背后在 单页模板、引用视图 与 链接按钮 中的实际渲染逻辑。一、出版物内容类型在 Hugo Blox 中的定位Hugo Blox 的内容由内容类型驱动。每个内容类型都对应一个 archetype内容骨架模板当开发者执行hugo new publication/xxx/index.md时Hugo 会复制 publication/index.md 到目标目录自动生成一篇带完整 YAML 前置元数据front matter的论文页面。整个出版物模块的渲染链路为publication/single.html单篇论文详情页section/publication.html出版物归档列表页带 Isotope 过滤、年份与类型下拉筛选views/citation.html列表页中的 APA/MLA 引用样式条目partials/page_links.htmlPDF、代码、数据集、海报、视频等按钮组。因此archetype 中每一个字段都不是装饰性的它们最终都会被上述模板消费并渲染成真实的页面元素。二、创建一篇出版物文章在站点根目录执行假设内容根目录为content/hugo new publication/conference-paper/index.mdHugo 会读取archetypes/publication/index.md将其中{{ .Name }}、{{ .Date }}等模板变量替换为实际值title取目录名并转为标题格式conference-paper→Conference Paperdate与publishDate取当前时间。之后编辑该文件填充各字段即可。若使用默认 starter如 starters/academic-cv可参考其示例论文publication/conference-paper/index.md、publication/journal-article/index.md、publication/preprint/index.md快速了解完整写法。三、出版物类型编码表publication_typesarchetype 中通过注释明确给出了九类出版物的数字编码编码类型i18n 键en.yaml0Uncategorized未分类默认回退值1Conference paper会议论文pub_paper_conference2Journal article期刊论文pub_article_journal3Preprint / Working Paper预印本/工作论文pub_article4Report报告pub_report5Book专著pub_book6Book section书籍章节pub_chapter7Thesis学位论文pub_thesis8Patent专利pub_patent类型名称的本地化映射定义于 modules/blox-bootstrap/i18n/en.yaml同一文件在 i18n 目录下还有 40 余种语言的副本。渲染时单页模板 会读取第一个publication_types值构造pub_类型的 i18n 键并显示类型行归档列表页 则用它生成pubtype-编码的 Isotope 过滤类与年份筛选组合使用。注意archetype 默认值是[0]字符串数组。如果设置publication_types: [0]详情页会按注释约定隐藏类型行Uncategorized 不显示。四、核心元数据字段逐项解析4.1 基本标识title: {{ replace .Name - | title }} authors: [] date: {{ .Date }} doi: titleHugo 模板函数自动生成也可手写覆盖authors作者列表对应作者页如content/authors/admin详情页经 page_metadata.html 与page_metadata_authors渲染为带链接的作者行date出版物的内容创建日期doi数字对象标识符。填入后 page_links.html 会渲染一个指向https://doi.org/DOI的 DOI 按钮。4.2 发布调度# Schedule page publish date (NOT publications date). publishDate: {{ .Date }}publishDate用于调度页面何时对外发布区别于论文本身的date。Hugo 在构建时不会输出publishDate晚于当前时间的页面可用于预约上线。4.3 出处信息publication: publication_short: publication完整出处期刊名、会议名等详情页渲染在Publication行publication_short缩写出处。列表页page_metadata.html与引用视图citation.html优先显示缩写版。4.4 摘要与分类abstract: summary: tags: [] categories: [] featured: falseabstract论文摘要详情页渲染为独立的Abstract标题区single.htmlsummary列表/卡片视图中的可选简短摘要tags/categories标签与分类用于页面聚合与过滤featured设为true后可在首页精选出版物集合中置顶展示。五、自定义链接与附件按钮archetype 提供了两类外链机制。5.1 自定义 links 列表# Custom links (optional). # Uncomment and edit lines below to show custom links. # links: # - name: Follow # url: https://twitter.com # icon_pack: fab # icon: twitter取消注释后每条链接由name按钮文字、url地址、icon_pack图标包fab/fas/far/fal、icon图标名组成。其渲染逻辑位于 page_links.html无协议的url会被当作站内资源解析优先匹配页面 Resource否则转相对链接http/https链接则自动添加target_blank与relnoopener。5.2 标准附件字段url_pdf: url_code: url_dataset: url_poster: url_project: url_slides: url_source: url_video:这些字段的作用机制一致若值匹配页面目录下的同名 Resource 文件则生成该资源的相对链接否则按站内相对 URL 处理page_links.html。此外PDF 还有两条隐式约定若页面目录中存在与页面同名的*.pdf如conference-paper.pdfpage_links.html 会自动生成 PDF 按钮无需配置url_pdf若存在cite.bib文件会渲染一个触发 BibTeX 弹窗的Cite按钮page_links.html。附件是否存在由 functions/has_attachments.html 判定决定列表页是否展示按钮组。从源码看page_links.html 中标注了url_preprint已被废弃的计划deprecation TODO推荐直接使用url_pdf或publication_types: [3]表示预印本。六、封面图与焦点位置# Featured image # To use, add an image named featured.jpg/png to your pages folder. # Focal points: Smart, Center, TopLeft, Top, TopRight, Left, Right, BottomLeft, Bottom, BottomRight. image: caption: focal_point: preview_only: false使用方法在文章目录放置featured.jpg或featured.png即自动成为列表与详情页封面focal_point焦点位置可选Smart、Center、TopLeft、Top、TopRight、Left、Right、BottomLeft、Bottom、BottomRight决定图片裁剪时保留的主体区域caption图片说明文字preview_only设为true时封面仅出现在列表/缩略场景不在详情页顶部展示。七、关联项目与演讲幻灯片# E.g. internal-project references content/project/internal-project/index.md. projects: [] # E.g. slides: example references content/slides/example/index.md. slides: projects将论文关联到一个或多个项目页。填写项目目录名不含扩展名列表页会渲染Project按钮若同时存在url_project则优先使用项目按钮组page_links.htmlslides关联 reveal.js 幻灯片如slides: example对应content/slides/example/index.md在详情页渲染Slides按钮。八、实战完整示例与归档页效果结合 starters/academic-cv/content/publication/conference-paper/index.md 等真实示例一篇典型的论文前置元数据如下--- title: An Example Conference Paper authors: - admin date: 2019-04-07T00:00:00Z doi: 10.1000/example publishDate: 2019-04-07T00:00:00Z publication_types: [1] publication: Proceedings of the Example Conference publication_short: Ex. Conf. abstract: This is an example abstract. summary: A short summary of the paper. tags: [] categories: [] featured: false url_pdf: example.pdf url_code: https://github.com/example/code url_slides: image: caption: focal_point: Smart projects: [] slides: ---归档页 section/publication.html 会自动按年份倒序排列论文提供关键词搜索框、类型下拉pubtype-*与年份下拉year-*组合过滤使用view参数默认compact渲染列表条目支持card、citation、masonry、showcase等视图见 layouts/partials/views。九、小结与最佳实践类型编码务必与 i18n 键对应publication_types的数字编码直接决定详情页类型行与列表过滤分类编码错误会导致类型显示异常善用同名 PDF 与 cite.bib 隐式约定把paper.pdf与cite.bib放在文章目录即可免配置获得 PDF 与引用按钮优先使用url_pdf而非url_preprint后者已在源码中标记为计划废弃DOI 直接填写编号模板会自动拼接https://doi.org/前缀无需手写完整链接让封面图可控利用focal_point指定图片焦点避免裁剪丢失关键内容。通过 archetype 的标准骨架你可以让团队内每一篇论文页面结构一致、字段完整同时获得引用、筛选、附件、项目联动等全套学术站点能力——这正是 Hugo Blox 将内容即 Markdown理念落到学术场景的最佳实践。赞分享静态站点前端开发工具【免费下载链接】kit Describe your site, AI builds it, you own it as Markdown. Snap together Tailwind blocks like Lego — landing pages, blogs, portfolios, docs more. No AI slop. Free to deploy anywhere 项目地址https://gitcode.com/gh_mirrors/hu/kit点击查看免费下载相关推荐终极指南5步让老旧Mac重获新生免费体验最新macOS系统终极指南5步让老旧Mac重获新生免费体验最新macOS系统 你是否有一台被苹果官方抛弃的老旧Mac看着它性能依然强劲却无法升级到最新的macOS系统静态站点前端开发工具Project Graph 教程:免费跨平台节点图工具,10 分钟画出第一张拓扑图Project Graph 教程:免费跨平台节点图工具,10 分钟画出第一张拓扑图 Project Graph 是一款免费开源的节点图绘制桌面工具,你用鼠标直接静态站点前端开发工具Hugo Blox 学术模板出版物页面配置实战以 Journal Article 示例为蓝本Hugo Blox 学术模板出版物页面配置实战以 Journal Article 示例为蓝本 在 Hugo BloxHugo Blox Builder的静态站点前端开发工具上一篇7步精通Unity游戏本地化XUnity.AutoTranslator完整实践指南下一篇Wails3 应用徽章Badge实战跨平台 Dock/Taskbar 角标服务使用指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
