Angri450.Nong.Docx 3.1.1

Angri450.Nong.Docx

纯 .NET Word 文档引擎。angri450 从零构建 —— 链式写入、JSON 模板驱动样式、模板填充、图片嵌入、论文诊断、OCR 转 Word，一套包搞定。零 COM、零 ImageSharp、跨平台。

Supported Platforms

.NET 8.0 and above (net8.0, net9.0, net10.0, net11.0). Windows, macOS, Linux.

Install

dotnet add package Angri450.Nong.Docx

Quick Start

using DocumentFormat.OpenXml.Packaging;
using DocumentFormat.OpenXml.Wordprocessing;
using DocxCore;

using var doc = WordprocessingDocument.Create("paper.docx",
    WordprocessingDocumentType.Document);
var main = doc.AddMainDocumentPart();
main.Document = new Document(new Body());
var body = main.Document.Body!;

// JSON 模板定义样式
var sp = main.AddNewPart<StyleDefinitionsPart>();
sp.Styles = new Styles();
StyleBuilder.BuildFromJson(sp.Styles, "formats/journal-paper.json");

// 链式写入内容
var w = new DocumentWriter(body);
w.Title("Research on Photosynthesis")
 .Abstract("This study investigates...")
 .Keywords("photosynthesis; chlorophyll; light")
 .Heading("Introduction", 1)
 .Body("Photosynthesis is the process by which plants...")
 .Heading("Methods", 1)
 .Body("Samples were collected from...")
 .Table("Growth Data", 1, new[] { "Day", "Height (cm)", "Leaf Count" },
     new[] { new[] { "1", "2.3", "4" }, new[] { "7", "5.1", "8" } })
 .TableStyle(TableStyles.LightGridAccent1)
 .BibHeading()
 .References("Smith J. Photosynthesis review[J]. Nature, 2025.");

// 图片嵌入
ImageEmbedder.EmbedImages(body, main, new[] { "fig1.png", "fig2.png" });

body.Append(StyleBuilder.LoadPageLayout("formats/journal-paper.json").Build());
main.Document.Save();

Core Capabilities

DocumentWriter — 链式构建器

angri450 设计的链式 API，覆盖论文写作全流程：

格式模板 — JSON 驱动样式

angri450 设计：换一个 JSON 文件 = 换一套格式。竞赛论文 → 期刊 → 毕业论文，秒切换。

StyleBuilder.BuildFromJson(sp.Styles, "formats/journal-paper.json");
var sectPr = StyleBuilder.LoadPageLayout("formats/journal-paper.json").Build();

模板引擎 — 占位符填充

DocxTemplate.Fill("template.docx", "output.docx", new
{
    Name = "Zhang",
    Score = 95,
    Date = "2026-06-01"
});
// 支持: {{tag}} 替换、@if/@foreach 块、表格行数据绑定

图片嵌入

ImageEmbedder.EmbedImages(body, mainPart, new[] { "fig1.png", "fig2.png" });
// PNG/JPEG/GIF/BMP/TIFF — 无需外部图片库

SectionBuilder — 页面布局

var sectPr = new SectionBuilder()
    .A4()
    .Margins("3cm", "2.5cm", "2.5cm", "2cm")
    .Build();

论文分析（16 种类型 + A-E 评级）

angri450 实现的论文诊断管线：

var type = PaperTypeClassifier.Classify(text);              // 研究设计类型
var structure = PaperStructureExtractor.BuildPaperStructure(text); // 章节提取
var variables = VariablePlanGenerator.GenerateVariablePlan(text);  // 变量表
var risks = ReferenceAnalyzer.CheckReferenceRisks(text);    // 参考文献质量
var result = PaperDiagnostics.DiagnosePaperQuality(text, ...);     // A-E 评级
// 证据链（10 项）→ 数据需求（9 项）→ 缺口 → 等级

高级特性

批注、修订模式、内容控件、字体嵌入、文档合并、文档属性管理、只读保护。

WordPreview — 生成 + 诊断

var r = WordPreview.Preview("paper.docx");
// 文本预览 + 7 步诊断 + OOXML 验证

Dependencies

• Angri450.Nong.ThirdParty — 合并基础库（DocumentFormat.OpenXml + 全部传递依赖）

无 System.Drawing.Common、无 ImageSharp、无 COM。跨平台。

API Reference

Author

Built by angri450. Source: Nong.NET.

License

Apache-2.0