Cadmus Migration

Tools for migrating (importing/exporting) Cadmus data. Export tools also include "preview", i.e. a human-friendly, highly customizable output for each Cadmus object, to be integrated in the editor itself.

• Documentation

👀 Cadmus Page

Cadmus.Export

General purpose components used to export Cadmus data.

Cadmus.Export.ML

Markup related components used to export Cadmus data into some markup language, typically XML.

Cadmus.Import

Core components for thesauri import.

Cadmus.Import.Excel

Excel (XLSX or XLS) thesauri importers.

Cadmus.Import.Proteus

Proteus-based components for importing Cadmus items and parts from sources handled with Proteus readers.

History

4.0.17

• 2023-02-10: updated packages.

4.0.16

• 2023-01-31: updated packages.

4.0.14

• 2024-01-26:
  • added CadmusEntrySetContextPatcher.
  • added ThesaurusEntryMap.

4.0.10

• 2024-01-26: added more options to MdDumpEntrySetExporter.

4.0.9

• 2024-01-26:
  • more functions for CadmusEntrySetContext.
  • updated packages.

4.0.7

• 2024-01-19: refactored exporter to use true items.

4.0.6

• 2024-01-19: updated packages.

4.0.4

• 2024-01-18: updated packages.
• 2024-01-05: added MdDumpEntrySetExporter.

4.0.3

• 2024-01-03:
  • updated packages.
  • added Cadmus.Import.Proteus project for Proteus-based import. This provides a generic Cadmus entry set context to collect items with their parts, without requiring any part-specific dependencies as parts are represented as JSON objects. Also, a MongoEntrySetExporter is provided to export the context to a MongoDB Cadmus database.

4.0.2

• 2023-11-21: updated packages.

4.0.1

• 2023-11-18: ⚠️ Upgraded to .NET 8.

3.0.8

• 2023-09-04: updated packages.

3.0.7

• 2023-06-27: added logger to IItemComposer.

3.0.6

• 2023-06-24:
  • updated packages.
  • fixed tests.

3.0.5

• 2023-06-21: fixed missing options in JSON thesaurus reader.

3.0.3

• 2023-06-21: completed Excel thesaurus reader.
• 2023-06-20:
  • added CSV thesaurus reader.
  • adding XLS(X) thesaurus reader.
• 2023-06-19: more tests.
• 2023-06-18: adding import.

3.0.2

• 2023-06-16: updated packages.

3.0.1

• 2023-06-02: updated packages.

3.0.0

• 2023-05-23: updated packages (breaking change in general parts introducing AssertedCompositeId).

2.0.4

• 2023-05-12: updated packages.

2.0.3

• 2023-02-05: updated packages.

2.0.2

• 2023-02-01: migrated to new components factory. This is a breaking change for backend components, please see this page. Anyway, in the end you just have to update your libraries and a single namespace reference. Benefits include:
  • more streamlined component instantiation.
  • more functionality in components factory, including DI.
  • dropped third party dependencies.
  • adopted standard MS technologies for DI.

1.0.0

• 2022-11-10: upgraded to NET 7.

0.1.1

• 2022-11-04: updated packages.

0.1.0

• 2022-11-04: updated packages (nullability enabled in Cadmus core).

0.0.21

• 2022-11-03: updated packages.

0.0.20

• 2022-10-24: refactored block ID for TEI standoff export (Cadmus.Export.ML).
• 2022-10-14: fixes to render items command.

0.0.19

• 2022-10-11: updated Cadmus packages.

0.0.18

• 2022-10-10:
  • use XSLT script settings in XSLT JSON renderer.
  • updated packages.

0.0.17

• 2022-10-08: fix to array wrapper in XSLT JSON renderer.

0.0.16

• 2022-10-08: added ISO639 filter.
• 2022-10-07: added array wrapping to XSLT JSON renderer.
• 2022-10-06:
  • fixes to TEI standoff item composer.
  • minor refactorings to renderer context.

0.0.15

• 2022-10-04: moved repository dependency out of database-dependent filters. The repository is now a property of the renderer context.

0.0.14

• 2022-10-04: added item ID to previewer and context to its filters.

0.0.13

• 2022-10-02: added TextTemplate to MongoTokenExtractorRendererFilter.

0.0.12

• 2022-10-01:
  • added MongoTokenExtractorRendererFilter.
  • more methods in CadmusPreviewer.
• 2022-08-26: completing TeiStandoffApparatusJsonRenderer.

0.0.11

• 2022-08-22: refactored sentence splitter.

0.0.10

• 2022-08-22: added flags matching.

0.0.9

• 2022-08-21: added sentence splitter filter (used to extract Sidonius Apollinaris from its Cadmus project).
• 2022-08-19: adding CLI infrastructure and refactored item composer API.
• 2022-08-19: item ID collectors.
• 2022-08-17: more conceptual documentation.

0.0.8

• 2022-08-15: essential TEI renderer components.
• 2022-08-14:
  • adding IItemComposer.
  • BuildTextBlocks added assigned layer IDs.

0.0.6

• 2022-08-11:
  • refactoring JSON renderers for configurable filters.
  • added thesaurus renderer filters.

0.0.5

• 2022-08-08: added Markdown support.