Added a couple of AsciiDoc inspired extensions#1305
Open
nessan wants to merge 3 commits intoquarto-dev:mainfrom
Open
Added a couple of AsciiDoc inspired extensions#1305nessan wants to merge 3 commits intoquarto-dev:mainfrom
nessan wants to merge 3 commits intoquarto-dev:mainfrom
Conversation
I added links to a couple of AsciiDoc-inspired filters.
Collaborator
|
Thanks for the PR. I'm not sure I understand your first extension, though. If you use callouts, we render them to admonitions natively: |
Author
|
Hi Carlos:
Not using `format: asciidoc` — generally just rendering normal `qmd` straight to `html` and want to use a few AsciiDoc markups that I find to be a a bit cleaner than the equivalent Quarto ones (clean in terms of the markup I write).
So in my `qmd` file I might have:
NOTE: The cow couldn’t really jump over the moon!
Want to have that rendered to HTML something like the version AsciiDoctor might produce — a little one row, two cell table with a ‘note’ icon in the left cell and the note content in the right one. That is what the admonitions filter does.
AsciiDoctor is not involved in the process at all expect as an inspiration — the thing I mostly like is the simplicity and cleanliness of the markup.
Just a “NOTE:” followed by some text, which reads just fine without any rendering. Less cluttered markup is generally good.
Though to be fair I quite like the particular output from the filter with the icon and the slightly dimmed content text — very familiar from O’Reilly books etc. Obviously a filter could also take the same text and produce the equivalent Quarto callout block.
Anyway hope that helps.
Nessan
On Aug 26, 2024, at 6:49 PM, Carlos Scheidegger ***@***.***> wrote:
Thanks for the PR. I'm not sure I understand your first extension, though. If you use callouts, we render them to admonitions natively:
---
format: asciidoc
title: Callout Note test
---
::: callout-note
## A note title
Hello this is a note.
:::
$ quarto render test-asciidoc.qmd
...
$ cat test-asciidoc.qmd
= Callout Note test
[NOTE]
.A note title
====
Hello this is a note.
====
—Reply to this email directly, view it on GitHub, or unsubscribe.You are receiving this because you authored the thread.Message ID: ***@***.***>
|
Author
|
Bumped content to bottom of file — hope that is the correct ettiqute. |
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
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.
I added links to a couple of AsciiDoc-inspired filters.
Hopefully, they are of some use to others.