vrod
Using Mermaid with ex_doc?
I saw a few thread about mermaid – it is a markdown way to make some charts and diagrams. I think it can be very useful for documentations. Does anyone know if ex_doc has “hooks” where something like this could be used? I’m not sure if I follow the ex_doc documentation, but hopefully someone knows if this might be possible! Thank you!
Marked As Solved
hauleth
Yes, in mix help docs:
:javascript_config_path- Path of an additional JavaScript file to be
included on all pages to provide up-to-date data for features like the
version dropdown - See the “Additional JavaScript config” section. Example:
"../versions.js"
So you can write script that will process Mermaid blocks in your documentation on the FE side. Alternatively you can write use options/custom wrapper for the Markdown parser, so you will be able to statically generate images basing on the returned data.
Also Liked
ityonemo
I think you can generate the @moduledoc as part of @before_compile. The Macro.Env.t term passed into the before_compile callback should have information about what functions exist in the module.
hauleth
Well, if you meant GenStage.init/1 callback then it can return different values depending on passed arguments. So unless you return always the same value, then it is not possible to achieve what you want. If you always return the same value, independently of the argument, then you can do:
defmodule A do
@init_return …
@moduledoc """
#{make_mermaid_chart(@init_return)}
"""
def init(_), do: @init_return
end








