Dev/0.5 - #2
Merged
Merged
Conversation
The convert_html and bootstrap! methods now convert <dl>/<dt>/<dd> to Markdown by default. Terms render as italic with colon; definitions are indented 3 spaces, and nested content (lists, code blocks) is recursively downgraded. Opt out per-list with the .no-markdown class on the <dl> or its wrapper div to maintain semantic HTML tags. Force conversion when the global default is off with .to-markdown. Set dls-to-markdown in YAML frontmatter to control conversion for an entire document. Pass convert_dls_to_markdown: false to bootstrap! or convert_html to change the global default. README updated to document the new default and all override controls, including <table> processing.
…ata from AsciiDoc
- Add CLAUDE.md and gems/docopslab-dev/README.adoc from synced templates. - Note lib/asciidoctor/ in AGENTS.md's project layout. - Exclude BILL_OF_MATERIALS.adoc and generated docs partials from Vale.
- Add a YARD-based RubySkimmer for classes, modules, and methods. - Wire :ruby format support into SourceSkim.skim_string. - Add a descriptions: option to include YARD docstrings in output. - Add the yard runtime dependency.
…em build - Override Jekyll's inspect filter with a format arg (html/yaml/json). - Port 4 Liquid filters missing from Liquid 4 (remove_last, replace_last, squish, sum); add BILL_OF_MATERIALS.adoc for their Shopify provenance. - Fix slugify, which used the literal string "kebab" instead of "-". - Add specs/data/liquid-filters.yml as the canonical filter registry, with specs that render and assert every example. - Add a generate:docs Rake task and docs/templates/liquid-filters-ref.adoc.liquid to build lib/sourcerer/_docs/partials/*.adoc from that registry. - Add Rendering.render_outputs vars: support for parameterized templates. - Wire doc generation into the gem build task and CI/build.sh.
…wnGrade - Stop indenting blank lines when nesting definition content; nested DLs were compounding a single blank line into runs of whitespace-only lines. - Add a normalize_blank_lines backstop that collapses stray runs to one. - Convert horizontal ([horizontal]) AsciiDoc dlists (rendered as a table, not a <dl>) the same way as regular DLs, honoring the same conversion mode and per-node overrides. - Make AsciiDoc.mark_down_grade's markdown_converter: keyword optional. - Remove a stale README example and fix a "Behaviour" typo.
Pulls in the new git-lint tool declaration and commit-conventions config-pack from docopslab-dev, generating this repo's local override files and ignoring the derived `.config/git-lint.yml`.
Adds an `includes` skim category that scans the raw source (outside listing/literal blocks) for `include::` directives, capturing their target path plus any `tags`/`leveloffset` attributes, whether or not Asciidoctor actually resolved them. Also fixes a related title bug: an unresolved include can disrupt Asciidoctor's header parsing so the `title` document attribute never gets set, silently falling back to the first section's title. Detect that specific failure mode (missing `title` attribute) and recover the real title from a raw `= Title` source line instead.
Points the dev/test group at the sibling ../lab checkout instead of a published gem version, so changes to docopslab-dev (git-lint, commit-conventions) can be exercised here without a release round trip. Regenerates the lockfile accordingly.
The local path override was for the git-lint/commit-conventions dev loop; this repo releases against the published docopslab-dev, not a sibling checkout. Regenerates the lockfile conservatively (only docopslab-dev and its now-dropped git-lint transitive deps change).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.