https://github.com/bryanwilhite/songhay.publications

Core reusable definitions for Songhay Studio Publications
https://github.com/bryanwilhite/songhay.publications

cloneextensions csharp eleventy epub-generation markdig markdown songhaycore

Last synced: about 1 month ago
JSON representation

Core reusable definitions for Songhay Studio Publications

• Host: GitHub
• URL: https://github.com/bryanwilhite/songhay.publications
• Owner: BryanWilhite
• License: mit
• Created: 2019-11-20T17:27:31.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2024-06-29T03:35:45.000Z (7 months ago)
• Last Synced: 2024-12-21T21:36:30.278Z (about 2 months ago)
• Topics: cloneextensions, csharp, eleventy, epub-generation, markdig, markdown, songhaycore
• Language: C#
• Size: 2.33 MB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# Songhay.Publications

**NuGet package 📦:** [`Songhay.Publications`](https://www.nuget.org/packages/Songhay.Publications/)

**Documentation 📚:** [`Songhay.Publications` API](https://bryanwilhite.github.io/Songhay.Publications/api/)

## core reusable definitions for Songhay Studio Publications

Selected Songhay Studio Publications are based on automation ‘pipelines’ for static HTML and EPUB. The fundamental document format of these pipelines is markdown. It follows that the `MarkdownEntry` [class](./Songhay.Publications/Models/MarkdownEntry.cs) is a core definition of this studio.

Architecturally, the `MarkdownEntryExtensions` [class](./Songhay.Publications/Extensions/MarkdownEntryExtensions.cs) augment the `MarkdownEntry` to define [eleventy](https://www.11ty.io/)-flavored methods for generating a draft and publishing.

## `GenericWeb` models and extensions

This repo also contains the historical class definitions for a Studio project called `GenericWeb`. This was a turn-of-century, static-file generation solution using SQL-Server-based XML as a fundamental document format.

The SQL Server _schema_ for `GenericWeb` features:

- the `Segment` [[class](./Songhay.Publications/Models/Segment.cs)]

- the `Document` [[class](./Songhay.Publications/Models/Document.cs)]

- the `Fragment` [[class](./Songhay.Publications/Models/Fragment.cs)]

These class definitions are still useful (without much SQL Server or Entity Framework). In fact, the Front Matter of `MarkdownEntry` is based on the GenericWeb Document.

## Studio packages dependent on `Songhay.Publications`

```mermaid

graph BT

    pubs[`Songhay.Publications`]

    pubs-->1[`Songhay.Player`]

    pubs-->2[`Songhay.Publications.Analytics`]

    pubs-->3[`Songhay.Publications.KinteSpace`]

```

@[BryanWilhite](https://twitter.com/BryanWilhite)