关于 academic-paper
academic-paper 是用于学术文档的技能和可运行起始工作区,面向研究者及 Agent 的起草与迭代。它提供学术排版规则和 React/MDX 示例文件,但不适合作为可直接投稿的 IEEE 或 ACM 格式。
主要功能
- 01A4 单栏学术版式
- 02罗马数字章节与斜体子标题
- 03摘要、索引词和数字引用
- 04图表自动编号
- 05可运行的 React/MDX 起始工作区
适用场景
- 01在 LaTeX 排版前起草研究论文
- 02迭代会议论文内容
- 03准备期刊预印本或 arXiv 风格草稿
- 04撰写课程论文、实验报告或论文各章
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ quan0715/ open-press --skill academic-paper安装后在 Claude Code 中输入/academic-paper确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
starter/package.openpress.jsonstarter/press/design.mdstarter/press/academic-paper/press.tsxstarter/press/academic-paper/chapters/01-introduction/content/01-introduction.mdxstarter/press/academic-paper/chapters/02-methods/content/01-methods.mdxstarter/press/academic-paper/chapters/03-results-and-discussion/content/01-results.mdxstarter/press/academic-paper/chapters/04-acknowledgment/content/01-acknowledgment.mdxstarter/press/academic-paper/chapters/05-references/content/01-references.mdxstarter/press/academic-paper/components/Page.tsxstarter/press/academic-paper/components/ChapterOpenerVisual/index.tsxstarter/press/academic-paper/components/TokenSwatchGrid/index.tsxstarter/press/academic-paper/components/TypeSpecimen/index.tsxstarter/press/academic-paper/media/figure-placeholder.svgREADME.mdstarter/press/academic-paper/theme/fonts.cssREADME.mdtokens.cssstarter/press/academic-paper/theme/base/page-contract.cssprint.csstypography.cssstarter/press/academic-paper/theme/page-surfaces/back-cover.csschapter-opener.csscover.csstoc.css详细介绍
学术论文
一种用于研究风格写作的文档样式:衬线标题、摘要块、编号章节(I、II、III)、斜体小节标题(A、B、C)、编号图表,以及 [N] 数字引用。灵感来自 IEEE 会议版式,但采用单栏布局并兼顾屏幕阅读器体验——专为起草/预印本/迭代阶段设计,不适用于生成可提交给 IEEEtran 的输出。
这是一项包含起步模板的技能:它提供 SKILL 规则,以及一个可运行的 starter/ 工作区(React/MDX 入口、主题、设计文档、示例章节)。使用 openpress 初始化 OpenPress 运行时工作区;此技能负责提供学术论文起步文件和设计规则。
视觉特征
- 字体:全文使用衬线字体(Source Serif 4 / Noto Serif TC)。标题采用大号展示字重;正文阅读字号约为 10.5pt。
- 章节:顶级章节使用罗马数字 + 小型大写字母(
I. INTRODUCTION);小节使用斜体句首字母大写格式(A. Maintaining the Integrity…);次小节使用行内斜体(a) Positioning Figures and Tables:)。 - 摘要:行内粗体标签
**Abstract**—,正文为斜体,正文开始前有全宽色带。 - 索引词:行内粗体标签
**Index Terms**—,正文为斜体,紧接摘要下方。 - 参考文献:使用
[1]、[2]数字样式,并采用悬挂缩进。 - 图/表:自动编号;图注置于图下方/表注置于表上方;使用窄细线边框。
- 版式:A4 单栏。双栏论文需要专用的页面/框架组件;此起步模板不保证生成出版商最终版的 IEEE/ACM 版式。
适用场景
- 研究论文草稿(LaTeX 排版前)
- 会议论文迭代(转换为 IEEEtran 并提交之前)
- 期刊预印本/arXiv 风格草稿
- 课程学期论文、实验室报告、技术说明
- 论文各章节(按章节编写,或采用扩展结构编写完整论文)
不适用场景
- IEEE / ACM 会议最终投稿——此类投稿需要使用出版商的 LaTeX 类文件。可在起草和 Agent 协作阶段使用此起步模板;提交时需手动导出为 LaTeX。
- 营销或以设计为主导的文档——其字体排版节奏适用于学术文本,而非宣传文案。
- 幻灯片或单页文档。
如何应用(套用到新工作區)
当用户说“use academic-paper”或“start a research paper”时,运行:
npm create @open-press <target> -- --type slides
cd <target>
rm -rf press
cp -R <this-skill>/starter/press press
<this-skill> 表示已安装的技能目录,或此仓库中的
skills/academic-paper 目录。OpenPress 不会为你获取此起步模板;
Agent 会读取该技能并复制或调整其中的文件。
然后:
- 在
press/<slug>/press.tsx中<Press>属性以及封面 JSX 里的title/subtitle(论文的运行副标题)/organization(院系、机构)/author填入相应内容。将starter/package.openpress.json合并到工作区package.json的"openpress"字段中,以配置部署/PDF 设置。 - 起步模板附带了一个基于 IEEE 会议模板的示例结构(
Introduction、Methods/Ease of Use、Results/Prepare Your Paper、Acknowledgment、References)。请将各章节替换为自己的内容。 - 编辑
press/design.md,设置项目专属规范(例如首选引用样式、缩写规则)。 - 编辑完成后运行
npm run build,以验证并渲染。
应做与避免
应做:
- 为每个图和表编号;在正文中用
Fig. N/Table N引用。 - 用
[N]引用文献;在参考文献章节中按统一格式汇总参考文献。 - 公式单独成行,编号采用右对齐的
(1)样式;表格前使用<TableCaption>。 - 首次使用时定义缩写——即使在摘要中已经用过,也要定义。
避免:
- 除非确实无法避免,否则不要在标题或主要标题中使用缩写。
- 不要在摘要或参考文献列表中加入脚注。
- 不要用
Eq. (1)或equation (1)进行括号内引用——只用(1)。仅在句首使用Equation (1)。 - 不要把每个段落都编号成一个章节。H4 用于区分不同技术或子流程,而不是调节行文节奏。
深层设计规则
详细的排版层级、间距、编号规则和 CSS 层职责见 starter/press/design.md——将 starter 复制到工作区后,该文件便成为面向用户和 Agent 的项目级设计规范。
评论
支持 Markdown