matthewsinclair
Nimble Publisher: how to hand image refs in markdown and how to control how HTML is emitted?
I have a couple of (relative) newb questions about Nimble Publisher that I can’t quite work out.
I have it (more or less) working but two questions remain:
-
What is the best way to handle a markdown file with an image ref in it? For example, let’s say that the original markdown file was in a directory called
dir/and in that directory is an image calleddir/image.png. If the markdown file is in the same directory (iedir/markdown.mdI could use the standard markdown image reference tagand the markdown viewer or renderer would create an<img src="./image.png">…tag from the markdown. However, because of the way that the routes are set up, that image url ends up being interpreted as an id for a blog post, which of course it can’t find. I can’t be the first person to ever try to do this so there must be an idiomatic way to handle URIs embedded in the markdown file or a way to configure the routes so that markdown is handled by nimble by images are and other content are treated as normal urls. -
I want to control the way that the HTML is emitted from the markdown processor so that I can style it. At the moment, a markdown
# Headingis being rendered simply as<h1>Heading</h1>. But what I need to do is control the styling of the emitted HTML. Again, I can’t be the first person who has ever needed to do this, but I can’t find from the docs what the best way to handle this would be.
Any ideas or even a link to an example or some docs for either problem would be very helpful. Thanks.
PS: I originally posted this on GitHub to the NimblePublisher repo here, but was asked to cross-post here by @josevalim.
Marked As Solved
billylanchantin
Here’s my approach for 2 (but with your styles substituted).
I’ve added the following to my post.ex:
def earmark_options do
Earmark.Options.make_options!(postprocessor: Earmark.AstTools.node_only_fn(&add_tag_class/1))
end
@tag_to_class %{
"h1" => "text-4xl font-bold tracking-tight text-zinc-800 sm:text-5xl dark:text-zinc-100",
"h2" => "text-m font-bold text-zinc-800 dark:text-zinc-100",
"h3" => "text-base font-semibold tracking-tight text-zinc-800 dark:text-zinc-100",
"h4" => "text-3xl tracking-tight text-zinc-800 sm:text-3xl dark:text-zinc-100",
"p" => "mt-6 text-base text-zinc-600 dark:text-zinc-400",
"a" => "text-m font-medium text-teal-500"
}
defp add_tag_class({tag, attrs, ignored, meta}) do
new_attrs = if class = @tag_to_class[tag], do: [{"class", class}], else: []
{tag, attrs ++ new_attrs, ignored, meta}
end
Then the following to my use NimblePublisher invocation:
use NimblePublisher,
# ...
earmark_options: Post.earmark_options(),
# ...
The postprocessor option gives you a hook which lets you work with the AST.
I also had to add this to my tailwind.config.js:
module.exports = {
content: [
// ...
"../lib/path/to/post.ex",
// ...
],
So it would pickup the new classes.
Also Liked
matthewsinclair
adamu
I don’t know if it’s the best way, but I store the images one directory below the markdown and serve them with Plug.Static.
My markdown is saved in priv/posts and rendered on the /blog/:title route.
I made priv/posts/images to store the images, and then set up a new Plug.Static in the endpoint to serve them on the same /blog scope:
plug Plug.Static,
at: "/blog/",
from: {:my_app, "priv/posts"},
gzip: false,
only: ["images"]
Then in your markdown:
If we place the image in priv/posts/images/lovely.jpg, it should load.
You can also use an <img> tag directly in the markdown if you need to control the width/height:
<img src="images/lovely.jpg" width="100px" height="50px" />
It’s worth mentioning that unfortunately we can’t get the benefits of Phoenix verified routes or mix.digest for the images, because the markdown is injected as raw HTML and not rendered by Phoenix, so unable to get the route information (theoretically it might be possible to do it, because both the markdown and HEEX templates are parsed at compile-time, but I didn’t try it…). This means that we have to directly link to the image and won’t get warnings for invalid image paths and may end up with broken images (like this dashbit post at the time of writing).
Last Post!
adamu
I don’t know if it’s the best way, but I store the images one directory below the markdown and serve them with Plug.Static.
My markdown is saved in priv/posts and rendered on the /blog/:title route.
I made priv/posts/images to store the images, and then set up a new Plug.Static in the endpoint to serve them on the same /blog scope:
plug Plug.Static,
at: "/blog/",
from: {:my_app, "priv/posts"},
gzip: false,
only: ["images"]
Then in your markdown:
If we place the image in priv/posts/images/lovely.jpg, it should load.
You can also use an <img> tag directly in the markdown if you need to control the width/height:
<img src="images/lovely.jpg" width="100px" height="50px" />
It’s worth mentioning that unfortunately we can’t get the benefits of Phoenix verified routes or mix.digest for the images, because the markdown is injected as raw HTML and not rendered by Phoenix, so unable to get the route information (theoretically it might be possible to do it, because both the markdown and HEEX templates are parsed at compile-time, but I didn’t try it…). This means that we have to directly link to the image and won’t get warnings for invalid image paths and may end up with broken images (like this dashbit post at the time of writing).
Popular in Questions
Other popular topics
Latest on Elixir Forum
Sponsor Spotlight
Phoenix, LiveView, multimedia pipelines, distributed systems. 400 engineers, Elixir since 2017. Available for hire.
Categories:
Sub Categories:
Forums
Popular Tags
- #ecto
- #liveview
- #troubleshooting
- #learning-elixir
- #deployment
- #library
- #erlang
- #testing
- #genserver
- #mix
- #absinthe
- #remote-other
- #otp
- #plug
- #how-to-question
- #macros
- #postgres
- #channels
- #elixirconf
- #exunit
- #discussion
- #code-sync
- #javascript
- #podcasts
- #onsite
- #dialyzer
- #docker
- #authentication
- #umbrella
- #full-time-contract
- #podcasts-by-brainlid
- #ecto-query
- #elixir-ls
- #phoenix_html
- #iex
- #blog-post
- #graphql
- #genstage
- #ai
- #websockets
- #supervisor
- #elixirconf-us
- #advent-of-code
- #distillery
- #processes
- #forms
- #api
- #metaprogramming
- #hex
- #security
Our Sponsors
Build Elixir applications with speed and confidence.
Supporting innovation across the BEAM ecosystem.
We build reliable cloud platforms for business-critical systems.
Catch errors, track performance, monitor hosts and more.
Error tracking for Elixir devs who love to ship. Start your free account.
Practical resources that improve the lives of professional developers.
Develop your skills with books, videos, and courses.
The deployment platform built for Elixir: PaaS ease, VPS control.
The team behind Membrane, Popcorn, LiveDebugger. Available for hire.
Courses that'll move you from confusion to "Aha, now I get it!"