Diagrams inside Nanoc markdown

[Pito Salas]

I would like to make it easy and clean to embed diagrams (ala graphviz or mermaid) right inside my Nanoc markdown. Has anyone done this who can share their experience?

-- Pito

[Denis Defreyne]

Hey Pito,

I am not aware of a way to embed diagrams directly into Markdown, though what you could do is add raw HTML to your Markdown files and have it be rendered via e.g. mermaid. Here’s an example of what I came up with:

https://github.com/ddfreyne/nanoc-mermaid-example/commit/a8b86ada347a6c3f8a9340d259176ebedd518e03

https://github.com/ddfreyne/nanoc-mermaid-example/commit/c1056e7edf731b4f397191a9d3a4742e0d50065c

I imagine that with other tools (other than mermaid) you could have a similar experience.

Hope this helps,

Denis

On Sun, Aug 11, 2019 at 8:22 PM Pito Salas <pito...@gmail.com> wrote:

I would like to make it easy and clean to embed diagrams (ala graphviz or mermaid) right inside my Nanoc markdown. Has anyone done this who can share their experience?

-- Pito

--
You received this message because you are subscribed to the Google Groups "nanoc" group.
To unsubscribe from this group and stop receiving emails from it, send an email to nanoc+un...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/nanoc/CA%2B%2B7fQxbmcXwYbEf3bGWibXaLSkUUpJjWJo6P7fnEzHZRoSZEg%40mail.gmail.com.

[Pito Salas]

Thanks! I never gave much thought to filters. But could I write one myself? For example to recognize a special symbol I invent (e.g. $$mermaid and $$end) to make it prettier? Just musing, not sure it would be worth the trouble anyway. 

But continuing on that thread, my coursegen package has tons of “macros” which I write 10 times a day such as

<%= include_topic :writing_macros %>

Which would be much cooler if written

$$include_topic :writing_macros

Would it be easy to write a filter in nanoc to do that?

Thanks again,

Pito

Sent from my iPad

To view this discussion on the web visit https://groups.google.com/d/msgid/nanoc/CALjsL%3D0mSLd6Lphs_u57mqNq88jCHHrL9b9yWcDhx2xs8dtYOQ%40mail.gmail.com.

[Denis Defreyne]

Hey Pito,

A late reply, my apologies! You certainly can create a filter for that. Off the top of my head:

    Nanoc::Filter.define(:handle_shortcodes) do |content, _params = {}|

      content.gsub(/^\$\$include_topic :(\w+)$/) { "<%= include_topic(#{$1}) %>" }

    end

($1 is the first matched regex group.)

This filter turns e.g.

    $$include_topic :writing_macros

into

    <%= include_topic :writing_macros %>

Now, right before filter :erb you call filter :handle_shortcodes. That should get you what you want!

Denis

To view this discussion on the web visit https://groups.google.com/d/msgid/nanoc/583BD3E5-F9B3-4ACF-8D95-21BC94AC6FDB%40gmail.com.

--

Denis Defreyne

+49 1573 1969 173

de...@denis.ws

[Pito Salas]

Hi Denis

This is the slowest moving glacial conversation ever!!! Do you remember writing this almost 2 years ago? Well, I finally got to it. Question, where would I put the code snippet Nanoc::Filter.define? In Rules? If it doesn't matter, then where would you put it, idiomatically? THanks,

Pito Salas
Faculty, Computer Science
Brandeis University

> To view this discussion on the web visit https://groups.google.com/d/msgid/nanoc/CALjsL%3D1yOGJc_PE-dy5ADvzyMjPZyWi24yEj_d-OtA3pDhRYXg%40mail.gmail.com.

[google...@ml.th-h.de]

On Friday, 26 February 2021 at 16:46:13 UTC+1 pito...@gmail.com wrote:

Question, where would I put the code snippet Nanoc::Filter.define?

In a file in /lib, see https://nanoc.ws/doc/sites/#directory-structure

Documentation on writing filters is found at https://nanoc.ws/doc/filters/#writing-filters

[Denis Defreyne]

Hey both,

Thomas is correct — anywhere in lib/ will do.

My preference is to use the naming scheme lib/filters/FILTERNAME.rb. For your case, I’d therefore have a file lib/filters/handle_shortcodes.rb containing the Nanoc::Filter.define(…) code.

Cheers,

Denis Defreyne

[dəˈni] • pronouns: he/him

+49 1573 1969 173

de...@denis.ws

https://denis.ws

--

You received this message because you are subscribed to the Google Groups "nanoc" group.

To unsubscribe from this group and stop receiving emails from it, send an email to nanoc+un...@googlegroups.com.

To view this discussion on the web visit https://groups.google.com/d/msgid/nanoc/c07ab138-e66b-481a-b777-f514a6a58f93n%40googlegroups.com.