Angri450.Nong.Docx 3.1.0

Angri450.Nong.Docx

OpenXML Word generation library. Pure .NET, zero COM, single merged dependency. One-stop paper writing: create, fill, analyze, and diagnose.

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!;

// Styles from JSON template
var sp = main.AddNewPart<StyleDefinitionsPart>();
sp.Styles = new Styles();
StyleBuilder.BuildFromJson(sp.Styles, "formats/journal-paper.json");

// Chainable content
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.");

// Images
ImageEmbedder.EmbedImages(body, main, new[] { "fig1.png", "fig2.png" });

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

Core Capabilities

DocumentWriter — Chainable Builder

Format Templates — JSON-Driven Styling

// Swap JSON = swap format. Contest → journal → thesis in seconds.
StyleBuilder.BuildFromJson(sp.Styles, "formats/journal-paper.json");
var sectPr = StyleBuilder.LoadPageLayout("formats/journal-paper.json").Build();

Template Engine — Fill Placeholders

DocxTemplate.Fill("template.docx", "output.docx", new
{
    Name = "Zhang",
    Score = 95,
    Date = "2026-06-01"
});
// Supports: {{tag}} replacement, @if/@foreach blocks, table row data binding

Image Embedding

ImageEmbedder.EmbedImages(body, mainPart, new[] { "fig1.png", "fig2.png" });
// PNG/JPEG/GIF/BMP/TIFF — no external image library

SectionBuilder — Page Layout

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

Paper Analysis (16 Types)

var type = PaperTypeClassifier.Classify(text);              // Research design type
var structure = PaperStructureExtractor.BuildPaperStructure(text); // Section extraction
var variables = VariablePlanGenerator.GenerateVariablePlan(text);  // Variable table
var risks = ReferenceAnalyzer.CheckReferenceRisks(text);    // Reference quality
var result = PaperDiagnostics.DiagnosePaperQuality(text, ...);     // A-E grade
// Evidence chain (10 items) → data requirements (9 items) → gap → grade

Advanced Features

Comments, track changes, content controls, font embedding, document merge, document property management, read-only protection.

WordPreview — Generate + Diagnose

var r = WordPreview.Preview("paper.docx");
// Text preview + 7-step diagnostics + OOXML validation

Dependencies

• Angri450.Nong.ThirdParty — merged foundation (DocumentFormat.OpenXml + all transitive deps)

No System.Drawing.Common, no ImageSharp, no COM. Cross-platform.

API Reference

Source

https://github.com/angri450/Nong.NET — Issues and PRs welcome.

License

MIT