Adoc.Net/Directory.Build.props at main · sonatique/Adoc.Net · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
<Project>
  <PropertyGroup>
    <TargetFramework>net10.0</TargetFramework>
    <!-- Use the latest released C# version, not 'preview'. Preview language features have no
         compatibility guarantee, and shipping a 1.x library built with them is a red flag for
         teams with a no-preview policy. -->
    <LangVersion>latest</LangVersion>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
    <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
    <Deterministic>true</Deterministic>
  </PropertyGroup>


  <!-- NuGet package metadata (shared across all packable projects) -->
  <PropertyGroup>
    <Version>1.0.23</Version>
    <Authors>Sylvain Fasel</Authors>
    <Copyright>Copyright (c) Sylvain Fasel</Copyright>
    <PackageLicenseExpression>MIT</PackageLicenseExpression>
    <PackageProjectUrl>https://github.com/sonatique/Adoc.Net</PackageProjectUrl>
    <RepositoryUrl>https://github.com/sonatique/Adoc.Net</RepositoryUrl>
    <RepositoryType>git</RepositoryType>
    <PackageTags>asciidoc;parser;ast;html;pdf;epub;docbook;docx;word;import;documentation;lsp;avalonia;layout</PackageTags>
    <PackageReadmeFile>README.md</PackageReadmeFile>
    <PackageReleaseNotes>v1.0.23: Word (.docx) import. Adds AdocNet.Importers.Docx — a pure-managed WordprocessingML reader that maps a .docx package onto the Adoc.Net AST, which the emitter serialises to AsciiDoc — and the docx2adoc tool (AdocNet.Docx). Mapped: sections from heading styles, lists with nesting and numbering style, tables with grid widths, header rows and gridSpan/vMerge spans, images with captions and sizes, text boxes as sidebars, hyperlinks, bookmarks and cross references, footnotes and endnotes, fields, quote and listing blocks, admonitions, page and thematic breaks, tracked changes, and core properties; character formatting maps to AsciiDoc markup with underline/strikethrough/caps/colour kept as roles. DocxImportReport lists everything approximated or lost with a content-mapping fidelity ratio (99.8% weighted over a 69-document corpus, 62 of them at 100%). Literal text is protected by a match-driven escaper verified by a round-trip harness. No dependency on the Open XML SDK or System.IO.Packaging, so netstandard2.0 is unaffected. Also fixes two emitter bugs: nested lists lost their numbering-style attribute line, and a cell specifier after an empty spanned cell was read as content, shortening the row. See CHANGELOG.md and docs/DOCX_IMPORT.md.</PackageReleaseNotes>
  </PropertyGroup>

  <!-- Symbol packages for debugging. Embeds portable PDBs in .snupkg files. -->
  <PropertyGroup Condition="'$(IsPackable)' != 'false' and '$(IsTestProject)' != 'true'">
    <IncludeSymbols>true</IncludeSymbols>
    <SymbolPackageFormat>snupkg</SymbolPackageFormat>
    <EmbedUntrackedSources>true</EmbedUntrackedSources>
  </PropertyGroup>

  <!-- XML documentation for public API surfaces.
       CS1591 (missing XML comment) is suppressed so that TreatWarningsAsErrors
       does not block builds for undocumented members. Documentation is added
       incrementally as API surfaces stabilise. -->
  <PropertyGroup Condition="'$(IsPackable)' != 'false' and '$(IsTestProject)' != 'true'">
    <GenerateDocumentationFile>true</GenerateDocumentationFile>
    <NoWarn>$(NoWarn);CS1591</NoWarn>
  </PropertyGroup>
</Project>