0.3.4

What's Changed

• [BUGFIX] Anchor References may not have an interlink part by @linawolf in #845
• [FEATURE] Add line block support by @jaapio in #849
• [TASK] Issue warning if a document is not included in any toctree by @linawolf in #846
• [FEATURE] add youtube directive by @jaapio in #848
• [FEATURE] Add Meta-information markup by @linawolf in #850

Full Changelog: 0.3.3...0.3.4

0.3.3 Inline styles in code-block captions, unshortened version numbers

What's Changed

• [TASK] Forward directive options to node by @linawolf in #831
• Revert phpize for versions, never treat them like numbers by @wouterj in #836
• [FEATURE] Allow inline styles in code-block captions by @linawolf in #835
• Work with relative paths by @greg0ire in #833

Full Changelog: 0.3.2...0.3.3

Add getter for all variables to projectnode

What's Changed

• [TASK] Integration test version with trailing zero by @linawolf in #830
• [TASK] Add getter for all variables to projectnode by @linawolf in #832

Full Changelog: 0.3.1...0.3.2

0.3.1

What's Changed

• [!!!TASK] Make all classes final by @jaapio in #820
• [TASK] Warn when code-block has no content by @linawolf in #823
• Resolve path after checking it leads to an existing file by @greg0ire in #826
• [FEATURE] Enable relative menu entries by @linawolf in #828

Full Changelog: 0.3.0...0.3.1

v0.3.0

Stabilize and improve

In this new release of guides we have been focusing on the stabilization of the libraries and fixed a large number of bugs and adding missing features that were supported in sphinx. In colaboration with the Typo3 documentation team, and collaborators from doctrine and symfony we have been testing the library on real world documentation stacks.

Please not that we do not guarantee any backward compatibility in the current state, for normal usage you should not have many issues to solve when upgrading.

Guides cli

There has been done quite some work on the usability of the cli tool we provide. To make it easier to extend to also
to make it easier in use. Most important changes in the arguments we removed from the run command. New way to execute
the guides cli is:

    vendor/bin/guides --output=test <input>

We removed the mandatory output argument and made it an option, you can specify the output directory now in the
guides.xml, or use the option in cli.

• [FEATURE] Add option input-file to render a specific file by @linawolf in #599
• [FEATURE] show progressbar and output only when not quite by @jaapio in #648
• [!!!][TASK] Make output an option instead of argument by @linawolf in #650
• [DOCS] Clarify parameter usage for the "guides" binary] by @garvinhicking in #680
• [FEATURE] allow setting working dir by @jaapio in #691

Guides code

New added component to the guides family is the guides-code component. This component is used to highlight code blocks
in the documentation. This component is used by the guides cli and can be used standalone.

Guides core

Rendering has been revisited, previously the render context had connections with services and there was a
connection between the template engine and node renderers. This has been removed and the render context is now
a valueobject.

• !!![TASK] Remove all services from render context by @jaapio in #645

To speed up the renderer significantly we have added a cache for the node renderers. This cache is used to store
the node renderers for a specific node type. This cache is only used at runtime and is not persisted.

• Cache matching node renderers by @wouterj in #784

As a proof of concept we have added a latex renderer to the guides core. This renderer is not yet fully functional,
but it shows how to add a new renderer to the guides core.

• !!![FEATURE] enable basic latex rendering by @jaapio in #654

New in this version is the support for markdown files. This is a basic support, but it is possible to use markdown
files in your documentation, however concepts like table of contents and menu's are not yet supported.

• [FEATURE] Enable basic Markdown files by @linawolf in #640

Menu handling has been improved, the menus are now better handling the max depth. And collection of the menu items
have been improved.

Other notable changes:

• [BUGFIX] Fix parsing and rendering of code-block with line numbers by @linawolf in #685
• [FEATURE] make it easier to configure templates. by @jaapio in #663
• [BUGFIX] Let Image sources respect relative and absolute links config… by @linawolf in #695
• [BUGFIX] Allow tabs in line indentations by @linawolf in #745

ReStructuredText

We have done a lot of improvements in the way references are handled. This solves a lot of issues with references.

• [BUGFIX] Rename textrole template by @linawolf in #744
• [FEATURE] Introduce Toctree caption by @linawolf in #704
• [FEATURE] Display Caption of contents menu by @linawolf in #694
• [BUGFIX] Do not use local resolvers for interlinks by @linawolf in #701
• [BUGFIX] Allow angled content in references by @linawolf in #711
• [TASK] Improve reference warnings by @linawolf in #720
• [TASK] Split Anchor link resolvers by @linawolf in #719
• !!![TASK] Improve Reference parsing by @linawolf in #798
• !!![TASK] Warn only once when a reference cannot be resolved by @linawolf in #797
• !!![TASK] Restructure Menu handling by @linawolf in #799
• [BUGFIX] Generate Warning when menu entry was not found by @linawolf in #804

Added directives:

• [FEATURE] Introduce only directive by @linawolf in #698
• [FEATURE] Introduce confval directive by @linawolf in #651
• [FEATURE] Introduce option directive by @linawolf in #636
• [FEATURE] add configuration block directive by @jaapio in #795
• [FEATURE] Support emphasize-lines in code-block directive by @linawolf in #690

Other notable changes:

• [FEATURE] Make relative, absolute and links relative to a base URL possible by @linawolf in #614
• [FEATURE] Support Hyperlinks to local pages in rst and md by @linawolf in #747
• [FIX]: be more strict on anonymous links by @jaapio in #628

General improvements

• Allow Symfony 7 by @greg0ire in #793

• [CI] start building on php 8.3 by @jaapio in #713

• Fix: allow absolute image urls by @jaapio in #626

• Allow setting a default language for literal blocks by @wouterj in #608

New Contributors

• @brotkrueml made their first contribution in #662
• @garvinhicking made their first contribution in #680

Full Changelog: 0.2.0...0.3.0

0.2.0

What's Changed

• [TASK] Add skipped test for field list in directive by @linawolf in #536
• [BUGFIX] Content of the code role must not be escaped by @linawolf in #533
• [DOCS] Document writing an extension by @linawolf in #526
• !!![TASK] Move LineIterators to Block Context by @linawolf in #538
• [FEATURE] introduce highlight directive by @linawolf in #534
• [FEATURE] Mark active and current menu entries by @linawolf in #537
• [FEATURE] Make logger messages more verbose by @linawolf in #543
• [BUGFIX] Prevent false positives for named references by @linawolf in #545
• [BUGFIX] Make underscores work as first sign in a code role by @linawolf in #546
• [Feature]: Add csv table directive by @jaapio in #548
• [FEATURE] Introduce Breadcrumb by @linawolf in #547
• Chore/phpstan strict by @jaapio in #479
• [BUGFIX] Handle footnotes and citations ins lists by @linawolf in #551
• !![TASK] Replace the subparser with a starting rule in directives by @linawolf in #553
• Endorse divergence from specification for links by @greg0ire in #554
• Unindent code blocks automatically by @greg0ire in #442
• [FEATURE] Facilitate Directive Creation by @linawolf in #557
• [BUGFIX] Handle numeric intersphinx links by @linawolf in #561
• [BUGFIX] Prevent fatal error caused by variables in tables by @linawolf in #560
• [TASK] Make Markdown a proper extension with DI by @linawolf in #564
• [FEATURE] Provide directive to display tabs in bootstrap theme by @linawolf in #566
• [TASK] Replace the subparser in the include directive by @linawolf in #556
• [FEATURE] Introduce quote like body directives by @linawolf in #562
• [TASK] Make Graphs a proper extension with DI by @linawolf in #563
• [BUGFIX] Replace special signs in directive template names by @linawolf in #565
• [BUGFIX] Allow hyperlinks to anchors by @linawolf in #572
• [BUGFIX] Make Email detection in lexer more strict by @linawolf in #573
• [BUGFIX] Allow Emails in anonymous links by @linawolf in #574
• Add support for extension configuration by @wouterj in #482
• [FEATURE] Make csv-table directive work with content by @linawolf in #575
• [FEATURE] Search for configuration in parent of vendor by @linawolf in #571
• Spell "repository" properly by @greg0ire in #585
• [FEATURE] Configure inventories via guides.xml by @linawolf in #586
• [FEATURE] Introduce table directive by @linawolf in #576
• [FEATURE] Introduce twig function to output menu by @linawolf in #578
• [BUGFIX] Fix generated menu when progress bar is active by @linawolf in #593
• [Task] organize directives by @linawolf in #596
• [BUGFIX] Make setting theme in guides.xml work by @linawolf in #592
• [FEATURE] Set console option defaults via guides.xml by @linawolf in #587
• [TASK] Reorganize Integration tests in subdirectories by @linawolf in #597
• [BUGFIX] Treat single output formats as array by @linawolf in #602
• [TASK] Make Markdown availible in integration tests by @linawolf in #600
• !!![TASK] Cleanup UrlGeneratorInterface by @linawolf in #605
• !!![TASK] Remove UrlGeneratorInterface::relativeURL by @linawolf in #606
• !![Task] move url calculation from render context by @linawolf in #607
• Feat: Add plantuml server rendering by @jaapio in #603

Full Changelog: 0.1.0...0.2.0

v0.1.0

First release of this library 🎉

This project aims to be a framework for text based formats to html. This version only includes ReStructuredText support. Consult the tests and docs for information about usage.

This first version can be seen as a stable release for development purposes, please be aware that the internals of this library might change between versions. According to semversion2 next release will contain breaking changes.

More documentation and tests will be added in next releases.