quarto-web icon indicating copy to clipboard operation
quarto-web copied to clipboard

Added a couple of AsciiDoc inspired extensions

Open nessan opened this issue 1 year ago • 3 comments

I added links to a couple of AsciiDoc-inspired filters. Hopefully, they are of some use to others.

nessan avatar Aug 26 '24 13:08 nessan

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.
====

cscheid avatar Aug 26 '24 17:08 cscheid

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: @.***>

nessan avatar Aug 26 '24 18:08 nessan

Bumped content to bottom of file — hope that is the correct ettiqute.

nessan avatar Aug 29 '24 11:08 nessan