HugoBlox Academic CV 主题中 Preprint 预印本出版页面的完整配置指南-开发者社区

前端

【免费下载链接】hugo-theme-academic-cv

🎓 Academic portfolio that boosts citations. AI generates pages, you own as Markdown. BibTeX auto-import, Jupyter, LaTeX, slides, visual block editor — free to host forever. 学术主页，AI 生成，Markdown 拥有 👇

项目地址：https://gitcode.com/gh_mirrors/th/hugo-theme-academic-cv

点击查看免费下载

本指南以hugo-theme-academic-cv仓库中的示例预印本页面（content/publications/preprint/index.md）为核心，逐字段解析 HugoBlox Academic CV 主题下发表（publications）内容类型的 front matter 配置方法：从 CSL 标准出版类型、arXiv 自动链接、9 类关联链接，到 Cite 引用导出、首页聚合与幻灯片/项目关联。读完本文，你可以为任何一篇未正式发表的论文（working paper、预印本）搭建一个结构完整、可被 BibTeX 引用、可被搜索引擎与 LLM 正确解析的学术出版页面。

预印本页面在学术主页中的定位

在 HugoBlox Academic CV 主题中，所有出版成果统一存放在content/publications/目录下，每个出版项是一个独立目录，内含index.md（页面正文 + front matter），可选附带featured.jpg/png（封面图）与cite.bib（BibTeX 引用数据）。仓库内现有三类示例：

目录	出版类型（publication_types）	典型特征
`content/publications/preprint/`	`article`	无正式 venue，`publication`字段省略
`content/publications/conference-paper/`	`paper-conference`	有会议名与短名，含`cite.bib`
`content/publications/journal-article/`	`article-journal`	有期刊名、卷期号，含`cite.bib`

预印本（preprint / working paper）是尚未通过同行评审、未在正式期刊或会议发表的研究版本。它的页面元数据因此有两个显著特点：一是publication_types采用 CSL 标准中较宽泛的类型（示例中为article），二是不填写publication字段（即不声明正式出版渠道），正如示例 front matter 中的注释所写：

Preprints typically have no formal venue; omitpublicationuntil the work is accepted.

列表页content/publications/_index.md通过view: citation指定以学术引用视图渲染整个 publications 区块，该视图天然适合展示含完整元数据的出版项。

front matter 基础标识：标题、作者与日期

预印本页面的 front matter 以 YAML 键值对描述出版元数据，前四组字段负责身份标识：

title: "An example preprint / working paper" authors: - me date: "2019-04-07T00:00:00Z" # Schedule page publish date (NOT publication's date). publishDate: "2017-01-01T00:00:00Z"

title：论文标题，会显示在出版页面与引用条目中。
authors：作者列表，每一项填写content/authors/下的作者目录名（username），而非显示名。主题会自动将其替换为完整姓名并链接到作者个人资料页；仓库默认作者配置见 data/authors/me.yaml（其中name.display为 Dr. Alex Johnson）。需要区分贡献时，可像 conference-paper/index.md 那样额外使用author_notes（如 "Equal contribution"）。
date：论文的发表/发布日（即论文本身的时间）。
publishDate：页面被正式安排发布的时间，注释明确说明它不是论文的发表日期。两者分离的好处是：你可以在论文尚未公开时就提前准备好页面（publishDate设为未来时间），Hugo 会按计划自动上线，例如 netlify.toml 中的预览构建就使用了--buildFuture开关。

publication_types：遵循 CSL 标准的出版类型

# Publication type. # Accepts a single type but formatted as a YAML list (for Hugo requirements). # Enter a publication type from the CSL standard. publication_types: ["article"]

publication_types接受单个类型，但按 Hugo 的 requirement 必须格式化为 YAML 列表。取值来自CSL（Citation Style Language）标准，仓库中三个示例分别使用了：

article（预印本 / 一般文章）
paper-conference（会议论文）
article-journal（期刊论文）

值得注意的是，config/_default/hugo.yaml中将publication_type: publication_types注册为站点 taxonomy（分类法），因此该字段不仅用于渲染，还会成为内容分类维度，可支持按出版类型筛选聚合页面。

开放性与资金元数据

预印本页面用三个布尔/文本字段描述其学术伦理与合规属性：

peer_reviewed: false open_access: true license: CC-BY-4.0 funding: - funder: "Wellcome Trust" grant: "WT-219123/Z/19/Z"

peer_reviewed：是否经过同行评审，预印本通常为false；正式发表后应更新为true（参见 conference-paper 与 journal-article 示例）。
open_access：是否开放获取，预印本一般为true。
license：内容许可协议，示例采用CC-BY-4.0。
funding：资助方与项目编号列表。注释指出该字段是许多资助机构（如 Wellcome Trust）要求用于合规申报的（"Required by many funders for compliance reporting"），每个条目包含funder（资助机构名）与grant（项目编号）两个键。

abstract、summary、tags 与 featured

abstract: Lorem ipsum dolor sit amet, consectetur adipiscing elit. ... # Summary. An optional shortened abstract. summary: Lorem ipsum dolor sit amet, consectetur adipiscing elit. ... tags: - Large Language Models featured: true

abstract：论文摘要，将出现在页面与引用数据中。
summary：可选的摘要精简版，用于列表卡片等场景。
tags：主题标签（同样注册为 taxonomy），便于按研究方向归档。
featured：是否作为精选内容置顶。该标记直接驱动首页的Featured Publications区块——见 content/_index.md 中collection区块的featured_only: true过滤条件，只有featured: true的出版项才会进入该区块。

arXiv 标准标识符：自动链接的关键

hugoblox: ids: arxiv: 1512.04133v1

这是预印本页面最有辨识度的字段之一。hugoblox.ids用于存放标准标识符（Standard identifiers）以实现自动链接，示例中给出 arXiv 编号1512.04133v1。同类机制也体现在 conference-paper/index.md 中（doi: 10.5555/123456）。可以推断，ids支持按标识符类型（arxiv、doi 等）自动生成指向对应权威平台的链接，无需手写 URL。使用时直接照抄 arXiv 的 ID（含版本号）即可。

links：面向读者的 9 类关联资源

links是预印本页面的资源导航核心，示例完整列举了主题支持的各类链接形态：

links: - type: preprint provider: arxiv id: 1512.04133v1 - type: code url: https://github.com/HugoBlox/kit - type: slides url: https://www.slideshare.net/ - type: dataset url: "#" - type: poster url: "#" - type: source url: "#" - type: video url: https://youtube.com - type: custom label: Custom Link url: http://example.org

各类型含义与用法如下表：

type	用途	示例中的写法
`preprint`	预印本链接，可用`provider`+`id`结构化描述	`provider: arxiv`、`id: 1512.04133v1`
`code`	论文配套代码仓库	`url: https://github.com/HugoBlox/kit`
`slides`	演讲/演示幻灯片	`url: https://www.slideshare.net/`
`dataset`	数据集	`url: "#"`（占位）
`poster`	会议海报	`url: "#"`（占位）
`source`	论文 LaTeX 源文件	`url: "#"`（占位）
`video`	讲解/演示视频	`url: https://youtube.com`
`custom`	自定义链接，需同时给`label`	`label: Custom Link`、`url: http://example.org`

两种字段模式值得注意：preprint采用provider+id的组合（由主题负责拼装链接），其余类型直接给url；未就绪的资源先用"#"占位，正式公开后替换为真实地址。对比 journal-article/index.md 可看到pdf、project等其他类型的存在，说明links的 type 集合覆盖了学术成果的完整资源谱系。

封面图、关联项目与幻灯片

front matter 末尾三组字段负责页面呈现与交叉引用：

image: caption: 'Image credit: [**Unsplash**](https://unsplash.com/photos/s9CC2SKySJM)' focal_point: "" preview_only: false projects: - internal-project slides: ""

image：页面封面图。将命名为featured.jpg或featured.png的图片放入该页面目录（如 content/publications/preprint/featured.jpg）即可被识别；caption写图片署名，focal_point可指定焦点位置，preview_only: false表示封面同时用于预览与页面。
projects：关联项目列表。注释给出了明确约定——"Simply enter your project's folder or file name without extension"，即填入content/projects/下项目目录名即可建立关联；无关联则写projects: []（见 journal-article 的写法）。当前仓库中的真实项目示例为 content/projects/pandas/index.md、pytorch、scikit 等。
slides：关联的 Markdown 幻灯片。填入content/slides/下幻灯片目录名（不含扩展名）；不需要则留空字符串""。幻灯片的完整写法可参考 content/slides/example/index.md（含 reveal.js 主题、Mermaid 图、品牌水印等配置）。

正文：前文引用、提示框与全文/补充材料

front matter 之后是页面正文（Markdown 内容）。示例正文展示了预印本页面的典型内容组织方式：

This work is driven by the results in my previous paper on LLMs. > [!NOTE] > Create your slides in Markdown - click the *Slides* button to check out the example. Add the publication's **full text** or **supplementary notes** here. You can use rich formatting such as including [code, math, and images](https://docs.hugoblox.com/content/writing-markdown-latex/).

第一行通过站内链接引用先前工作（/publications/conference-paper/，对应仓库 content/publications/conference-paper/index.md），建立论文间的继承关系。
> [!NOTE]是 GitHub 风格告示框语法，用于引导读者查看幻灯片示例。
模板提示将全文或补充说明写入正文，并支持富文本（代码、数学公式、图片）。数学渲染的全局开关位于 config/_default/params.yaml 的hugoblox.content.math.enable。

Cite 按钮与 BibTeX 引用导出

预印本页面的价值还体现在引用生态上。虽然示例 preprprint 目录未放置cite.bib，但同仓库的 conference-paper 与 journal-article 页面均有配套 BibTeX 文件，且其正文中的 NOTE 明确说明了 Cite 按钮的作用：

Click theCitebutton above to demo the feature to enable visitors to import publication metadata into their reference management software.

以 content/publications/conference-paper/cite.bib 为例，BibTeX 条目与 front matter 一一对应：

@inproceedings{example1, title={An example conference paper}, author={Bighetti, Nelson and Ford, Robert}, booktitle={Source Themes Conference}, pages={1--6}, year={2013}, organization={IEEE} }

README 将 "BibTeX / DOI auto-import" 列为核心特性：丢入.bib文件即可自动生成含正确引用的出版页面。读者在页面上点击Cite按钮即可把出版元数据导入 Zotero、EndNote 等文献管理软件。引用的输出样式由 config/_default/params.yaml 中hugoblox.content.citations.style控制，可选值注释为apa | mla | chicago | ieee（默认apa）。

页面聚合：列表视图与首页精选

出版项配置完成后，会通过两级聚合机制呈现在站点中：

Publications 列表页：content/publications/_index.md以view: citation渲染整个出版集合（cms_exclude: true表示不由 CMS 管理）。
首页区块：content/_index.md 中定义了id: papers的 Featured Publications 区块（view: article-grid、featured_only: true，仅展示精选）与 Recent Publications 区块（view: citation），两者都通过filters.folders: [publications]指向content/publications/目录；tags、publication_type等 taxonomy（见 config/_default/hugo.yaml）还可进一步做细粒度过滤。

导航菜单（config/_default/menus.yaml）中的 Papers 项以/#papers锚点直接链接到首页精选出版区块，确保访客最快触达你的成果列表。

结语：一套即可复制的预印本发布模板

通过content/publications/preprint/index.md这份示例，HugoBlox Academic CV 主题把预印本发布抽象为一套清晰的元数据约定：CSL 出版类型声明来源、arXiv ID 自动链接公开访问渠道、9 类links覆盖代码/数据/海报/视频等完整资源、funding满足资助合规、featured与 collection 区块联动实现首页精选、Cite 按钮 + BibTeX 打通引用导出。实际使用时，只需复制该页面的 front matter 骨架，替换标题、作者、日期、arXiv ID 与正文，即可在数分钟内上线一篇结构完整、可被引用与检索的预印本页面。