Refnotes macro and text/asciidoc type

#1

I’m a big fan of using the asciidoc markup, but I’m trying to figure out how to use it with tiddlywiki macros.

I’m using

Is there a way to enable macros in tiddler types other than text/vnd.tiddlywiki ?

When I go to use something like:

<<ref my_bibtex_entry>>

in a text/asciidoc tiddler type, the macro is not invoked.

I’d really like to stay with asciidoc formatting because I use the content for targets other than tiddlywiki as well.

#2

@Eric_Simpson I am not familiar with ASCIIDOC but I am having a look now.

However I would point out Asciidoctor for TiddlyWiki — a demo of the Asciidoctor plugin for TiddlyWiki5 is providing an alternative markdown/up for tiddlers of type text/asciidoc see a few exceptions included in asciidoc $:/plugins/bimlas/asciidoctor Usage (Links and includes)

When the type field is empty or text/vnd.tiddlywiki it uses the default wikitext markup and macros are part of this markup so I think we have three options, of which only one is available now.

  • Extend the asciidoc parser to include more of the wikitext parser such as transclusions and macros (need to ask Bimlas)
  • Imbed asciidoc tiddlers in a wikitext tiddler with transclusion works
  • Imbed Wikitext tiddlers in a asciidoc tiddler with transclusion - Blimlas said he did not get it working.

Asciidoc in wikitext

\define mymacro()
!Wikitext

{{Example}}

!End of wikitext

Where the above tiddler has a blank type or text/vnd.tiddlywiki and “Example” tiddler has type=text/asciidoc

#3
  • Extend the asciidoc parser to include more of the wikitext parser such as transclusions and macros (need to ask Bimlas)

Yes, this is a tough one I guess. While I use asciidoc for most my writing markup, I am not familiar with its macro process.

I think this would require a syntax addition to call the appropriate macro and return its results in the formatted TW page?

For my current use case – I’m trying to use the refnotes macro directly in my asciidoc writeup inline. In this case I’m not sure it would be ergonomic to try and split this into its own tiddler and include it in the asciidoc page.

#4

Just as a follow up to this, I’ve decided to reverse course. It seems most of the TW ecosystem works better assuming a text/vnd.tiddlywiki type. This includes macro support, various transclusions and filters.

Instead I’ll have source text/vnd.tiddlywiki tiddlers that I can transclude into a destination tiddler I’ll use for exporting to other works. This destination tiddler I can use something like Pandoc - About pandoc to convert to my desired format.