P<semantic: XXX> injects XXX into the Table of Contents at the position in the text.
fix nested (and custom blocks) which were incorrectly rendering trailing lists.
fixed semantic blocks
moved VERSION DESCRIPTION AUTHOR SUMMARY into Semantic blocks, but treat them as if
:hidden is set
- fix table to pass on caption and target.
=HTML so that it is not processed like a SEMANTIC block
fix error arising from making heading unique, and a forward reference is made.
=comment in procedural table
disallow blocks without .name, eg.,
=head in p-tables
Add extra functionality to
=table as per RakuDoc
Add table tests without needing HTML tests.
Remove embedded code test from HTML table - was marked as TODO.
Add BadCommand exception for when procedural table not followed by cell/row/column
Make automatic id's for headings unique
Handle SEMANTIC blocks as per RakuDoc requirements
- leave VERSION DESCRIPTION AUTHOR SUMMARY as before in meta part of HTML
add tests for undefined SEMANTIC blocks, and defined SEMANTIC block
add test when undefined $=pod is passed to render-block.
- fix formatcodes N and C to add context correctly.
:cumulative-number to header and item
:$context to all templates, so that
:allow can be properly accessed in templates.
- Add node.config to parameters passed to Code
:!toc the default for
Para blocks are treated as Custom block apart from this.
:toc-caption as a possible metadata for a block, to include that string in the TOC
:!toc as alias to <:headlevel(0)> for named blocks
when --verbose is set, the Block's config data is given as well as the scope config
'para' & 'Para' added to custom handle so its not added to TOC.
error in Samples.rakudoc fixed
=nested blocks to match Pod documentation.
refactored tests to take the required templates from the SetupTemplates role.
make tests for input/output/nested.
- set input / output to todo.
add meta to format-x, format-l and format-p to be available for template.
change META6 for fez review
change doc.perl.org to docs.raku.org in test
change id processing X in headers
- add flag to glossary entry if the target is in a heading, so that the entries can be filtered out by the template if desired.
- fix highlight resource name
add debug information to Templating
add separate template debug flag
fixing link error - external flag not being set properly
- Provide parameter type to template with values internal, external, local
guarantee empty contents when format-code has zero content, eg.,
=config directive to alter lexical level, not its own.
add tests for config params sent to templates
refactor Templating to eliminate two copies of tmpl
include tests for remembering prior formats
fix Mustache renderer to work with memory variant
- handle end of linked list better. prior returns Nil not .cell
- fix error - namespace not in header handler.
make sure all necessary Pod-blocks can take :template & :name-space meta-data, and pass name-space data to template. Previously this was only done for named blocks.
implementing =config directive.
change 'unknown-name' template so that we can format unknown format codes properly
change handler of FormatCode so that 'unknown-name' is called with :format-code.
default templates for footer needs changing to generate a time
default navigation template to remove tags if no TOC or Glossary.
add-plugins to P2HTML2 so that new plugins can added to the distributed ones.
Samples.rakudoc for image
allow for data object to be rewritten by add-plugin. Use case: the name-space for a plugin needs to be available for the plugin's callables, as it contains config data needed by plugin callables
Created a Samples.rakudoc file for Rakudoc-to-html Example
rewrote sample plugins for HTML2 from Collection variants.
wrote new core plugin move-assets for HTML2 to mimic Collection render milestone functionality
rewrote BUILD.pm to copy all plugins from resources to a local default directory
basic node2html and pod2html options tested. Uses Rakuclosure, so no mustache options.
Refactor HTML2 to
rely on and accept custom plugins
remove all template reliant tests to Pod-Render folder
introduce Rakudoc-to-html utility to render a single Rakudoc file to html into current directory
Change name of MarkDown to MarkDown2
Change params of Link FormatCode. Now both local and internal may have targets, the template must handle both. The character # designating a target must be added by a template. Before there was a flag defining local/internal/external, a parameter for contents, and a parameter for target (the file | page name). Now there is an extra parameter
location defining the location inside the file|page.
rename mandatory template
unknown-name, which is called when an unknown named Pod::Block is used.
refactor modify-templates for plugins, in order to allow for multiple templating in plugins.
A plugin template file may evaluate to a hash of hashes if the key
RakuClosureTemplater (case insensitive) exists as a first level key
Each primary key then refers to a templating engine,
the second level keys are the template names.
a plugin's templates are only added to the instance of ProcessedPod using
modify-templates is called for a plugin, it checks whether the default
RakuClosureTemplater key is present.
If so, the templates pointed to by
.templater.Str in the plugin's templates are used, and if not present, then an Exception is thrown.
If not, the plugin is using Rakuclosure templates, so if
.templater.Str is not
RakuClosureTemplater then an Exception is thrown
remove ExtractPod as Pod::Load is Raku canonical
- minor changes to README, update CHANGELOG
Add a check to detect templater that looks for
_templater in the template hash and if it exists, then it must contain the name of the templater class.
add test file to verify the auto-detect and
_templater key to HTML and MarkDown renderers
Change behaviour of css-text. It now over-rides the css template, not the css-text template.
The test suite sometimes fails at or after
xt/100-html/015-css-addition.t The tests individually pass.
added :type to Pod::To::HTML that indicates which templating system to use, the default is 'closure' because crotmp causes random test failures.
changes to way badge path is calculated, from META6.json & .github directory
simplified CI setup
modification to templates
refactored the templating system
move-templating out of ProcessedPod
created an array of tests to identify the templating engine
made templating engines into classes, rather than roles
new error occurred where role supplied a BagHash and a new did not initialise it
- added a method to the role to reinitialise it.
begun to add Cro Web templates as possible option
refactored the highlighting system
moved highlighting from templates
created possibility for alternate highlighting engine
made autodetection of template engine into a role
refactored Exceptions, putting all exceptions associated with ProcessedPod into one file
refactored path names, creating
RenderPod folder, moved files to more intuitive places
renamed pm6 to rakumod
renamed sanity tests to make order more logical, testing base roles/classes first
- trim white space in head texts (occurs if head text is also indexed)
- add page-data key to be passed to template 'file-wrap'. This is config in first
- add link text to link registration for improved error tracing
- add change of '::' token to '/' in links. This is (previously) undocumented behaviour of
correct HTML rendering of targets in local files. eg href="filen.html#internal-link"
change test accordingly
change type of templates-used in PodFile from BagHash to %, and adjust gist.
fixed persistent Templates-used error, not emptying.
moved functionality of test-templates to pm6
added test functions templates-present, templates-match, extra-templates-match
rewrite / refactor Documentation files
- resolved issue with passing legacy css tests
- empty BagHash of templates-used correctly with default, not Nil.
- fixed non-standard FC error when not specially templated, added test.
- to get Cro, require rakudo-star:2020.01, but that doesn't like set op (==), so use different test in test-templates
PodFile gist written, started on ProcessedPod gist
fixed failing tests due to renderedtime and path changes
HTML2 templates improved and removed need for separate wrap-source function.
refactored to move all pod-file related variables out to a class that is reinstantiated
changed tests because an object not a hash is returned.
refactored to change rules for plugin and namespaces. Plugins can add their configs to their namespace
namespaces cannot be written to more than once.
- refactoring in emit-... function.
fixed test-templates, which had suffered bit-rot
improved test-templates, so that it now gives more feedback on template contents that are not returned
fixed html templates that new test-template feed-back showed were erroneous.
fixed and updated RakuClosureTemplates.pod6
fix default Markdown template of metadata
fix default Markdown of =defn blocks
change Perl 6 => Raku in tests, except non-breaking space
add $.templs-used to Template manager. records each time a template is used during rendering. The intention is to make the information available for debugging when dealing with multiple files.
test added to xt/030* for templates-used
extend to other named & header Pod::Blocks the ability to use another template if given as a config variable.
- change META6.json to ensure module passes tests with prove6 -I.
added CHANGELOG.pod6 / CHANGELOG.md
Added functionality to Unused FormatCodes
Codes such as L and X have the form
CodeLetter<some content | data ; more data>
Pod::Block then provides some content as
contents and then
meta is a list of 'data', 'more data'
This syntax is applied to all non-standard format codes
added new test for formatting
modified xt/100-html/150* to not run unless SHELL_TEST environment set
spun off Extractor to a different module 'raku-pod-extraction'
- Changed all documentation references to Extractor
removal of Extractor removes dependence on GTK::Simple
- resolves issue regarding GTK::Simple
- resolved issue relating to name. Changed Pod::To::HTML to Pod::To::HTML2
Prior to 2021-01-17
Rendered from CHANGELOG at 2023-07-31T22:03:44Z