Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .php-cs-fixer.dist.php
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
$header = <<<'EOF'
This file is part of the ALTO Commonmark package.

© 2025–present Simon André
© 2025-Present Simon André

For full copyright and license information, please see
the LICENSE file distributed with this source code.
Expand Down
2 changes: 1 addition & 1 deletion src/Extension/CodeBlockTitle/CodeBlockTitleExtension.php
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
/*
* This file is part of the ALTO Commonmark package.
*
* © 2025–present Simon André
* © 2025-Present Simon André
*
* For full copyright and license information, please see
* the LICENSE file distributed with this source code.
Expand Down
2 changes: 1 addition & 1 deletion src/Extension/CodeBlockTitle/CodeBlockTitleRenderer.php
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
/*
* This file is part of the ALTO Commonmark package.
*
* © 2025–present Simon André
* © 2025-Present Simon André
*
* For full copyright and license information, please see
* the LICENSE file distributed with this source code.
Expand Down
2 changes: 1 addition & 1 deletion src/Extension/CodeBlockTitle/InfoStringParser.php
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
/*
* This file is part of the ALTO Commonmark package.
*
* © 2025–present Simon André
* © 2025-Present Simon André
*
* For full copyright and license information, please see
* the LICENSE file distributed with this source code.
Expand Down
4 changes: 2 additions & 2 deletions src/Extension/CodeBlockTitle/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## Summary

The detail that signals craft. Adds a `title="..."` attribute to any fenced code block info string and wraps the result in a semantic `<figure>`/`<figcaption>` pair. A small delta but the kind of finish that separates a polished documentation site from a functional one.
The detail that signals craft. Adds a `title="..."` attribute to any fenced code block info string and wraps the result in a semantic `<figure>`/`<figcaption>` pair. A small delta -- but the kind of finish that separates a polished documentation site from a functional one.

## Installation

Expand Down Expand Up @@ -55,4 +55,4 @@ This extension is actively developed in the [`alto/commonmark`](https://github.c

## License

MIT License [Simon André](https://smnandre.dev) & [Alto](https://github.com/PhpAlto)
MIT License -- [Simon André](https://smnandre.dev) & [Alto](https://github.com/PhpAlto)
7 changes: 3 additions & 4 deletions src/Extension/CodeBlockTitle/composer.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,14 +4,13 @@
"license": "MIT",
"type": "library",
"keywords": [
"commonmark",
"commonmark-extension",
"markdown",
"commonmark",
"code-block",
"title",
"code-title",
"figcaption",
"figure",
"fenced-code",
"commonmark-extension",
"php",
"alto"
],
Expand Down
2 changes: 1 addition & 1 deletion src/Extension/ContentSlicer/ContentSlicerExtension.php
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
/*
* This file is part of the ALTO Commonmark package.
*
* © 2025–present Simon André
* © 2025-Present Simon André
*
* For full copyright and license information, please see
* the LICENSE file distributed with this source code.
Expand Down
4 changes: 2 additions & 2 deletions src/Extension/ContentSlicer/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## Summary

Genuinely rare in the CommonMark ecosystem. Most processors stop at rendering headings as `<h1>`…`<h6>` tags this one goes further and restructures the document into a properly nested `<section>` tree that mirrors the heading hierarchy. The result is semantic HTML you can actually target with CSS, query with JavaScript, and traverse with accessibility tooling. No custom syntax required.
Genuinely rare in the CommonMark ecosystem. Most processors stop at rendering headings as `<h1>`…`<h6>` tags -- this one goes further and restructures the document into a properly nested `<section>` tree that mirrors the heading hierarchy. The result is semantic HTML you can actually target with CSS, query with JavaScript, and traverse with accessibility tooling. No custom syntax required.

## Installation

Expand Down Expand Up @@ -55,4 +55,4 @@ This extension is actively developed in the [`alto/commonmark`](https://github.c

## License

MIT License [Simon André](https://smnandre.dev) & [Alto](https://github.com/PhpAlto)
MIT License -- [Simon André](https://smnandre.dev) & [Alto](https://github.com/PhpAlto)
2 changes: 1 addition & 1 deletion src/Extension/ContentSlicer/SectionNode.php
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
/*
* This file is part of the ALTO Commonmark package.
*
* © 2025–present Simon André
* © 2025-Present Simon André
*
* For full copyright and license information, please see
* the LICENSE file distributed with this source code.
Expand Down
2 changes: 1 addition & 1 deletion src/Extension/ContentSlicer/SectioningListener.php
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
/*
* This file is part of the ALTO Commonmark package.
*
* © 2025–present Simon André
* © 2025-Present Simon André
*
* For full copyright and license information, please see
* the LICENSE file distributed with this source code.
Expand Down
7 changes: 3 additions & 4 deletions src/Extension/ContentSlicer/composer.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,14 +4,13 @@
"license": "MIT",
"type": "library",
"keywords": [
"commonmark",
"commonmark-extension",
"markdown",
"commonmark",
"section",
"sectioning",
"heading",
"hierarchy",
"semantic-html",
"document-structure",
"commonmark-extension",
"php",
"alto"
],
Expand Down
2 changes: 1 addition & 1 deletion src/Extension/HeadingLevel/HeadingLevelExtension.php
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
/*
* This file is part of the ALTO Commonmark package.
*
* © 2025–present Simon André
* © 2025-Present Simon André
*
* For full copyright and license information, please see
* the LICENSE file distributed with this source code.
Expand Down
2 changes: 1 addition & 1 deletion src/Extension/HeadingLevel/HeadingLevelProcessor.php
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
/*
* This file is part of the ALTO Commonmark package.
*
* © 2025–present Simon André
* © 2025-Present Simon André
*
* For full copyright and license information, please see
* the LICENSE file distributed with this source code.
Expand Down
4 changes: 2 additions & 2 deletions src/Extension/HeadingLevel/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## Summary

The one you don't need until you really do then it's irreplaceable. Transforms heading levels after parsing so that content written for one heading context can be safely embedded in another without hierarchy collisions. Supports fixed shifting, explicit level remapping, and a callback option that gives you complete control over every heading in the document.
The one you don't need until you really do -- then it's irreplaceable. Transforms heading levels after parsing so that content written for one heading context can be safely embedded in another without hierarchy collisions. Supports fixed shifting, explicit level remapping, and a callback option that gives you complete control over every heading in the document.

## Installation

Expand Down Expand Up @@ -51,4 +51,4 @@ This extension is actively developed in the [`alto/commonmark`](https://github.c

## License

MIT License [Simon André](https://smnandre.dev) & [Alto](https://github.com/PhpAlto)
MIT License -- [Simon André](https://smnandre.dev) & [Alto](https://github.com/PhpAlto)
8 changes: 3 additions & 5 deletions src/Extension/HeadingLevel/composer.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,14 +4,12 @@
"license": "MIT",
"type": "library",
"keywords": [
"commonmark",
"commonmark-extension",
"markdown",
"commonmark",
"heading",
"heading-level",
"shift",
"transform",
"document-composition",
"heading-shift",
"commonmark-extension",
"php",
"alto"
],
Expand Down
2 changes: 1 addition & 1 deletion src/Extension/Import/ImportExtension.php
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
/*
* This file is part of the ALTO Commonmark package.
*
* © 2025–present Simon André
* © 2025-Present Simon André
*
* For full copyright and license information, please see
* the LICENSE file distributed with this source code.
Expand Down
4 changes: 2 additions & 2 deletions src/Extension/Import/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## Summary

Solves the copy-paste drift problem between documentation and source code. `@import` directives pull external file content directly into fenced code blocks at parse time with optional line-range selection, language hinting, and indentation control. Your code samples stay in sync with the actual source by definition, not by discipline.
Solves the copy-paste drift problem between documentation and source code. `@import` directives pull external file content directly into fenced code blocks at parse time -- with optional line-range selection, language hinting, and indentation control. Your code samples stay in sync with the actual source by definition, not by discipline.

## Installation

Expand Down Expand Up @@ -53,4 +53,4 @@ This extension is actively developed in the [`alto/commonmark`](https://github.c

## License

MIT License [Simon André](https://smnandre.dev) & [Alto](https://github.com/PhpAlto)
MIT License -- [Simon André](https://smnandre.dev) & [Alto](https://github.com/PhpAlto)
6 changes: 3 additions & 3 deletions src/Extension/Import/composer.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,13 @@
"license": "MIT",
"type": "library",
"keywords": [
"commonmark",
"commonmark-extension",
"markdown",
"commonmark",
"import",
"file-embed",
"code-embed",
"directive",
"snippet",
"commonmark-extension",
"php",
"alto"
],
Expand Down
2 changes: 1 addition & 1 deletion src/Extension/Include/IncludeExtension.php
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
/*
* This file is part of the ALTO Commonmark package.
*
* © 2025–present Simon André
* © 2025-Present Simon André
*
* For full copyright and license information, please see
* the LICENSE file distributed with this source code.
Expand Down
4 changes: 2 additions & 2 deletions src/Extension/Include/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## Summary

The backbone of large documentation sets. `@include` directives pull in external markdown fragments and fully parse them inline making one-file-per-section composition possible without a build system. Supports optional line-range selection for embedding partial files, with circular-include protection to keep deeply nested setups safe.
The backbone of large documentation sets. `@include` directives pull in external markdown fragments and fully parse them inline -- making one-file-per-section composition possible without a build system. Supports optional line-range selection for embedding partial files, with circular-include protection to keep deeply nested setups safe.

## Installation

Expand Down Expand Up @@ -53,4 +53,4 @@ This extension is actively developed in the [`alto/commonmark`](https://github.c

## License

MIT License [Simon André](https://smnandre.dev) & [Alto](https://github.com/PhpAlto)
MIT License -- [Simon André](https://smnandre.dev) & [Alto](https://github.com/PhpAlto)
6 changes: 3 additions & 3 deletions src/Extension/Include/composer.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,13 @@
"license": "MIT",
"type": "library",
"keywords": [
"commonmark",
"commonmark-extension",
"markdown",
"commonmark",
"include",
"file-include",
"directive",
"partials",
"document-composition",
"commonmark-extension",
"php",
"alto"
],
Expand Down
2 changes: 1 addition & 1 deletion src/Extension/LinkRewriter/LinkRewriterExtension.php
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
/*
* This file is part of the ALTO Commonmark package.
*
* © 2025–present Simon André
* © 2025-Present Simon André
*
* For full copyright and license information, please see
* the LICENSE file distributed with this source code.
Expand Down
2 changes: 1 addition & 1 deletion src/Extension/LinkRewriter/LinkRewriterProcessor.php
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
/*
* This file is part of the ALTO Commonmark package.
*
* © 2025–present Simon André
* © 2025-Present Simon André
*
* For full copyright and license information, please see
* the LICENSE file distributed with this source code.
Expand Down
2 changes: 1 addition & 1 deletion src/Extension/LinkRewriter/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,4 +52,4 @@ This extension is actively developed in the [`alto/commonmark`](https://github.c

## License

MIT License [Simon André](https://smnandre.dev) & [Alto](https://github.com/PhpAlto)
MIT License -- [Simon André](https://smnandre.dev) & [Alto](https://github.com/PhpAlto)
2 changes: 1 addition & 1 deletion src/Extension/LinkRewriter/Rewriter.php
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
/*
* This file is part of the ALTO Commonmark package.
*
* © 2025–present Simon André
* © 2025-Present Simon André
*
* For full copyright and license information, please see
* the LICENSE file distributed with this source code.
Expand Down
10 changes: 4 additions & 6 deletions src/Extension/LinkRewriter/composer.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,15 +4,13 @@
"license": "MIT",
"type": "library",
"keywords": [
"commonmark",
"commonmark-extension",
"markdown",
"commonmark",
"link",
"url",
"rewrite",
"image",
"url-rewrite",
"base-uri",
"redirect",
"image",
"commonmark-extension",
"php",
"alto"
],
Expand Down
4 changes: 2 additions & 2 deletions src/Extension/Source/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## Summary

The flagship of the set. `@source` directives embed a real file not a copy into your documentation at parse time, with automatic syntax class detection, precise line-range selection, optional line numbers, and per-line highlighting. Your docs and your source stay in sync by construction.
The flagship of the set. `@source` directives embed a real file -- not a copy -- into your documentation at parse time, with automatic syntax class detection, precise line-range selection, optional line numbers, and per-line highlighting. Your docs and your source stay in sync by construction.

## Installation

Expand Down Expand Up @@ -52,4 +52,4 @@ This extension is actively developed in the [`alto/commonmark`](https://github.c

## License

MIT License [Simon André](https://smnandre.dev) & [Alto](https://github.com/PhpAlto)
MIT License -- [Simon André](https://smnandre.dev) & [Alto](https://github.com/PhpAlto)
2 changes: 1 addition & 1 deletion src/Extension/Source/SourceExtension.php
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
/*
* This file is part of the ALTO Commonmark package.
*
* © 2025–present Simon André
* © 2025-Present Simon André
*
* For full copyright and license information, please see
* the LICENSE file distributed with this source code.
Expand Down
6 changes: 2 additions & 4 deletions src/Extension/Source/composer.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,15 +4,13 @@
"license": "MIT",
"type": "library",
"keywords": [
"commonmark",
"commonmark-extension",
"markdown",
"commonmark",
"source",
"source-code",
"syntax-highlight",
"code-block",
"file-embed",
"directive",
"commonmark-extension",
"php",
"alto"
],
Expand Down
4 changes: 2 additions & 2 deletions src/Extension/TableOfContents/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## Summary

A must-have for any document longer than a page. Place `@toc` where you want the contents list and the extension takes care of the rest: headings are collected, anchor IDs are assigned, and a navigable nested list is rendered with filtering by level and configurable output style.
A must-have for any document longer than a page. Place `@toc` where you want the contents list and the extension takes care of the rest: headings are collected, anchor IDs are assigned, and a navigable nested list is rendered -- with filtering by level and configurable output style.

## Installation

Expand Down Expand Up @@ -59,4 +59,4 @@ This extension is actively developed in the [`alto/commonmark`](https://github.c

## License

MIT License [Simon André](https://smnandre.dev) & [Alto](https://github.com/PhpAlto)
MIT License -- [Simon André](https://smnandre.dev) & [Alto](https://github.com/PhpAlto)
2 changes: 1 addition & 1 deletion src/Extension/TableOfContents/TableOfContentsExtension.php
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
/*
* This file is part of the ALTO Commonmark package.
*
* © 2025–present Simon André
* © 2025-Present Simon André
*
* For full copyright and license information, please see
* the LICENSE file distributed with this source code.
Expand Down
Loading
Loading