anthus-markus 0.5.1__tar.gz

anthus_markus-0.5.1/.gitignore

@@ -0,0 +1,23 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+.eggs/
+dist/
+build/
+.venv/
+venv/
+.env
+.python-version
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+pretty.output
+_site/
+site/_build/
+*.html
+!src/markusmd/static/*.html
+project/.overlay/
+project/.cache/

anthus_markus-0.5.1/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## 0.1.0
+
+- Initial Markus language: GFM baseline, YAML front matter, and a small
+  semantic directive registry.
+- HTML renderer with bundled CSS.
+- `markus` CLI: `convert`, `ast`, `validate`, `preview`, `site`.
+- GitHub Pages demo generated from Markus sources in `site/`.

anthus_markus-0.5.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Anthus AI Solutions
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

anthus_markus-0.5.1/PKG-INFO

@@ -0,0 +1,135 @@
+Metadata-Version: 2.5
+Name: anthus-markus
+Version: 0.5.1
+Summary: Markus: GitHub-flavored Markdown with semantic layout directives.
+Project-URL: Homepage, https://github.com/AnthusAI/Markus
+Project-URL: Documentation, https://github.com/AnthusAI/Markus#readme
+Project-URL: Repository, https://github.com/AnthusAI/Markus
+Project-URL: Issues, https://github.com/AnthusAI/Markus/issues
+Author-email: Anthus AI Solutions <info@anthus.ai>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: commonmark,directives,gfm,layout,markdown,publishing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Markup
+Classifier: Topic :: Text Processing :: Markup :: Markdown
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: markdown-it-py[linkify]<5,>=3.0
+Requires-Dist: mdit-py-plugins<1,>=0.4.0
+Requires-Dist: pydantic<3,>=2.0
+Requires-Dist: pyyaml<7,>=6.0
+Provides-Extra: dev
+Requires-Dist: behave>=1.2.6; extra == 'dev'
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: pre-commit; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Requires-Dist: tox; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Markus
+
+**GitHub-flavored Markdown with a small vocabulary for layout intent.**
+
+Markus keeps Markdown as the content language, then adds colon-fenced
+directives for the things GFM cannot say: *this is a pull quote*, *these
+items are peer cards*, *these two views belong together*. Authors encode
+meaning. The renderer turns that meaning into accessible HTML and responsive
+CSS — or, later, print, EPUB, or email.
+
+## Install
+
+```bash
+pip install anthus-markus
+```
+
+Python 3.10 or newer.
+
+## Convert a page
+
+```bash
+markus convert examples/getting-started.md -o page.html
+markus validate examples/getting-started.md
+markus ast examples/getting-started.md
+```
+
+Python API:
+
+```python
+from markusmd import convert
+
+html = convert(open("page.md", encoding="utf-8").read())
+```
+
+## Directives
+
+```md
+:::pull-quote{attribution="Engineering principle" tone="primary"}
+The best system is often the one whose failure modes you can explain.
+:::
+
+:::feature-grid{columns=3}
+:::feature-card{icon="bolt"}
+## Low latency
+Keep common interactions local.
+:::
+:::
+```
+
+The 0.1 vocabulary:
+
+| Directive | Intent |
+| --- | --- |
+| `callout` (`note`, `warning`, `tip`, `caution`) | Status or editorial note |
+| `pull-quote` | Editorial quotation |
+| `card-grid` / `card` | Peer items |
+| `two-up` / `column` | A conceptual pair |
+| `figure` | Media with caption and credit |
+| `details` | Progressive disclosure |
+| `aside` | Supporting, non-linear material |
+| `metric` | A labeled fact (`::metric{...}`) |
+
+Unknown names and unknown attributes fail validation. That is intentional:
+Markus must not decay into an untyped CSS API. See
+[docs/LANGUAGE.md](docs/LANGUAGE.md) for the full contract.
+
+## Demo site
+
+**[anthusai.github.io/Markus/](https://anthusai.github.io/Markus/)** — written in
+Markus and built by Markus.
+
+To run the same site locally:
+
+```bash
+pip install -e ".[dev]"
+markus site site --out _site --serve --port 43147
+```
+
+## Preview locally
+
+```bash
+markus preview examples/getting-started.md
+```
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+behave          # Gherkin behavior specs
+ruff check src features
+python -m build
+```
+
+## License
+
+MIT © Anthus AI Solutions

anthus_markus-0.5.1/README.md

@@ -0,0 +1,96 @@
+# Markus
+
+**GitHub-flavored Markdown with a small vocabulary for layout intent.**
+
+Markus keeps Markdown as the content language, then adds colon-fenced
+directives for the things GFM cannot say: *this is a pull quote*, *these
+items are peer cards*, *these two views belong together*. Authors encode
+meaning. The renderer turns that meaning into accessible HTML and responsive
+CSS — or, later, print, EPUB, or email.
+
+## Install
+
+```bash
+pip install anthus-markus
+```
+
+Python 3.10 or newer.
+
+## Convert a page
+
+```bash
+markus convert examples/getting-started.md -o page.html
+markus validate examples/getting-started.md
+markus ast examples/getting-started.md
+```
+
+Python API:
+
+```python
+from markusmd import convert
+
+html = convert(open("page.md", encoding="utf-8").read())
+```
+
+## Directives
+
+```md
+:::pull-quote{attribution="Engineering principle" tone="primary"}
+The best system is often the one whose failure modes you can explain.
+:::
+
+:::feature-grid{columns=3}
+:::feature-card{icon="bolt"}
+## Low latency
+Keep common interactions local.
+:::
+:::
+```
+
+The 0.1 vocabulary:
+
+| Directive | Intent |
+| --- | --- |
+| `callout` (`note`, `warning`, `tip`, `caution`) | Status or editorial note |
+| `pull-quote` | Editorial quotation |
+| `card-grid` / `card` | Peer items |
+| `two-up` / `column` | A conceptual pair |
+| `figure` | Media with caption and credit |
+| `details` | Progressive disclosure |
+| `aside` | Supporting, non-linear material |
+| `metric` | A labeled fact (`::metric{...}`) |
+
+Unknown names and unknown attributes fail validation. That is intentional:
+Markus must not decay into an untyped CSS API. See
+[docs/LANGUAGE.md](docs/LANGUAGE.md) for the full contract.
+
+## Demo site
+
+**[anthusai.github.io/Markus/](https://anthusai.github.io/Markus/)** — written in
+Markus and built by Markus.
+
+To run the same site locally:
+
+```bash
+pip install -e ".[dev]"
+markus site site --out _site --serve --port 43147
+```
+
+## Preview locally
+
+```bash
+markus preview examples/getting-started.md
+```
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+behave          # Gherkin behavior specs
+ruff check src features
+python -m build
+```
+
+## License
+
+MIT © Anthus AI Solutions

anthus_markus-0.5.1/behave.ini

@@ -0,0 +1,6 @@
+[behave]
+paths = features
+show_skipped = false
+stdout_capture = false
+log_capture = false
+format = pretty

anthus_markus-0.5.1/docs/LANGUAGE.md

@@ -0,0 +1,80 @@
+# Markus language
+
+Markus is **GitHub Flavored Markdown** plus a small registry of colon-fenced
+semantic directives. Authors encode intent. The renderer chooses layout.
+
+## Document metadata
+
+Optional YAML front matter:
+
+```md
+---
+title: The future of local inference
+authors:
+  - Ada
+date: 2026-09-04
+---
+```
+
+## Container directives
+
+```
+:::name{key="value" flag other=1}
+Markdown, including nested directives.
+:::
+```
+
+| Name | Meaning | Notable attributes |
+| --- | --- | --- |
+| `callout` | Note, warning, tip, or caution | `kind`, `title` |
+| `note`, `warning`, `tip`, `caution` | Aliases for `callout` | `title` |
+| `pull-quote` | Editorial quotation | `attribution`, `source`, `tone`, `align` |
+| `card-grid` / `feature-grid` | Peer cards | `label`, `columns` (hint) |
+| `card` / `feature-card` | One peer item | `icon`, `title`, `span` (`1`–`6` or `full`) |
+| `two-up` | A conceptual pair | `ratio` (`1:1`, `2:1`, `1:2`), `align` |
+| `column` | One side of `two-up` | — |
+| `figure` | Media with caption | `src`, `alt`, `caption`, `credit` |
+| `details` | Progressive disclosure | `summary`, `open` |
+| `aside` | Supporting, non-linear material | `title` |
+| `tabs` | Tabbed container | `label` |
+| `tab` | One tab panel | `label` |
+| `step-list` | Ordered sequence of steps | — |
+| `step` | Single step | — |
+| `timeline` | Chronological sequence | `label` |
+| `timeline-event` | Single event in a timeline | `date`, `time`, `title`, `icon` |
+
+A trailing kramdown-style attribute list is also accepted inside a directive:
+
+```md
+:::pull-quote
+> Measure what matters.
+{: attribution="Editorial principle" }
+:::
+```
+
+## Leaf directives
+
+```
+::metric{value="12" unit="ms" label="p95 latency" delta="-8%"}
+::video{src="screencast.mp4" title="Walkthrough"}
+```
+
+| Name | Meaning | Notable attributes |
+| --- | --- | --- |
+| `metric` | Key metric fact | `value`, `unit`, `label`, `delta` |
+| `video` | Video player | `src`, `title`, `poster` |
+
+## Nesting rules
+
+- `card-grid` may contain only `card` (or the `feature-card` alias)
+- `two-up` must contain exactly two `column` children
+- `tabs` may contain only `tab`
+- `step-list` may contain only `step`
+- `timeline` may contain only `timeline-event`
+- Other containers may nest Markdown and further directives
+- Fenced code blocks are not scanned for directives
+
+## What does not belong in source
+
+Do not add `margin`, `width`, `font-size`, or other presentation keys.
+Unknown directive names and unknown attributes fail validation.

anthus_markus-0.5.1/examples/getting-started.md

@@ -0,0 +1,51 @@
+# Getting started with Markus
+
+Markus is GitHub Flavored Markdown plus colon-fenced directives that name
+layout *intent* rather than CSS.
+
+:::pull-quote{attribution="Engineering principle" tone="primary"}
+The best system is often the one whose failure modes you can explain.
+:::
+
+:::feature-grid{columns=3}
+:::feature-card{icon="bolt"}
+## Low latency
+
+Keep common interactions local to minimize round trips.
+:::
+
+:::feature-card{icon="lock"}
+## Private by default
+
+Do not transmit user data unless the task requires it.
+:::
+
+:::feature-card{icon="gauge"}
+## Measurable cost
+
+Track tokens, watts, requests, and time-to-result.
+:::
+:::
+
+:::two-up{ratio="1:1" align="start"}
+:::column
+## What changes
+
+- A local model lowers marginal request cost
+- Deployment becomes a systems problem
+:::
+
+:::column
+## What remains
+
+- Evaluation
+- Retrieval quality
+- UX
+- Observability
+:::
+:::
+
+:::callout{kind="note" title="Editorial guidance"}
+Use `two-up` to express a conceptual pairing, not merely because two
+paragraphs happen to fit beside each other.
+:::

anthus_markus-0.5.1/features/cli.feature

@@ -0,0 +1,81 @@
+Feature: Markus command line
+  As a writer in a terminal
+  I want to convert, validate, and inspect Markus files
+  So that I can publish HTML without embedding the library myself
+
+  Scenario: Convert a file to HTML
+    Given a Markus file "page.md" with:
+      """
+      # Hello Markus
+      """
+    When I run "markus convert page.md --fragment --no-css"
+    Then the command should succeed
+    And stdout should contain "<h1>Hello Markus</h1>"
+
+  Scenario: Validate a well-formed file
+    Given a Markus file "ok.md" with:
+      """
+      :::tip
+      Ship the small vocabulary first.
+      :::
+      """
+    When I run "markus validate ok.md"
+    Then the command should succeed
+    And stdout should contain "ok"
+
+  Scenario: Validate rejects unknown directives
+    Given a Markus file "bad.md" with:
+      """
+      :::carousel
+      Nope.
+      :::
+      """
+    When I run "markus validate bad.md"
+    Then the command should fail
+    And stderr should contain "Unknown directive 'carousel'"
+
+  Scenario: Print a JSON AST
+    Given a Markus file "quote.md" with:
+      """
+      :::pull-quote{attribution="Ada"}
+      Make it matter.
+      :::
+      """
+    When I run "markus ast quote.md"
+    Then the command should succeed
+    And stdout should contain "pull-quote"
+    And stdout should contain "Ada"
+
+  Scenario: Convert a file to HTML with minified CSS
+    Given a Markus file "styled.md" with:
+      """
+      # Styled Page
+      """
+    When I run "markus convert styled.md --minify-css"
+    Then the command should succeed
+    And stdout should contain "<h1>Styled Page</h1>"
+    And stdout should contain "<style>"
+    And stdout should not contain "/* Markus default presentation layer"
+    And stdout should contain ":root{"
+
+  Scenario: Convert with minified CSS and no-css omits CSS
+    Given a Markus file "plain.md" with:
+      """
+      # Plain Page
+      """
+    When I run "markus convert plain.md --minify-css --no-css"
+    Then the command should succeed
+    And stdout should contain "<h1>Plain Page</h1>"
+    And stdout should not contain "<style>"
+
+  Scenario: Convert fragment with minified CSS
+    Given a Markus file "frag.md" with:
+      """
+      # Fragment
+      """
+    When I run "markus convert frag.md --fragment --minify-css"
+    Then the command should succeed
+    And stdout should contain "<style>"
+    And stdout should not contain "/* Markus default presentation layer"
+    And stdout should contain "markus-document"
+    And stdout should contain "<h1>Fragment</h1>"