dcrck
Hi, I’m working on a project that requires generating and serving a (potentially large) number of static HTML files. Since the project also uses Phoenix, I’d like to take advantage of Phoenix’s ability to quickly render HTML templates with layouts, sanitizing contents, etc.
I know I could classify these HTML files as templates and use Phoenix.View, pattern: "**/*", root: "path/to/generated/html" to find all of them, then use render to serve them, but that requires compiling each generated file into a template, and I’m guessing (big assumption, please tell me if I’m wrong) that it recompiles all of them whenever a new file is added. I think this would become unwieldy with large numbers of files and frequent changes.
Alternatively, I could forego the view/template system entirely and use EEX.eval_file/1 to create the static files and just serve them with send_file, but that would be throwing out most/all of the benefits that Phoenix templating provides.
My question: is there a middle ground that allows me to use Phoenix’s HTML rendering/sanitizing/more goodies without necessarily compiling a large number of frequently-changing static HTML files into templates every time a new file is added/changed? I’ve looked at the source code for Phoenix.View and it’s not clear if this is possible.
To be fair, as noted above I only briefly explored the “make every file a template” option, so I could be wrong about how Phoenix decides what to compile when something changes.
Where Next?
Trending in Questions
Other Trending Topics
Latest Phoenix Threads
Latest on Elixir Forum
Sponsor Spotlight
Producing high quality Elixir screencasts since 2017.
Categories:
Sub Categories:
Forums
Popular Tags
- #ecto
- #liveview
- #troubleshooting
- #learning-elixir
- #library
- #deployment
- #erlang
- #testing
- #genserver
- #mix
- #absinthe
- #remote-other
- #otp
- #plug
- #how-to-question
- #macros
- #postgres
- #elixirconf
- #channels
- #exunit
- #discussion
- #code-sync
- #podcasts
- #javascript
- #onsite
- #dialyzer
- #docker
- #authentication
- #umbrella
- #full-time-contract
- #podcasts-by-brainlid
- #ecto-query
- #elixirconf-us
- #ai
- #blog-post
- #elixir-ls
- #phoenix_html
- #iex
- #graphql
- #genstage
- #websockets
- #supervisor
- #advent-of-code
- #distillery
- #processes
- #api
- #forms
- #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.
Error tracking, logs, uptime, and Just Enough APM. Built for developers.
Elixir, Erlang & BEAM conferences from Code Sync - join us in 2026!
Practical resources that improve the lives of professional developers.
Bringing learning, work and compliance together since 1987.
**Building the future of software with AI, trust, and human connection.**
The team behind Membrane, Popcorn, LiveDebugger. Available for hire.
Courses that'll move you from confusion to "Aha, now I get it!"
Showing Posts 1 to 9- Show Best Posts
- Show All (oldest first)
- Show All (newest first)
LostKobrakai
Can you elaborate a bit more. What “benefits” would you think phoenix provides for static files? E.g. included handling of html entity encoding is really only useful for dynamic data. Static content is not affected by that.
I’d just use
Plug.Staticto serve static html and be done.derek-zhou
If you want to embed a html fragment inside your template as is, like a CMS, you can just read the file and
raw/1it. If you want to do some light templating and find the EEX too heavy/imposing for your liking, you can use bbmustache, which is just mustache so even non-Elixir people should feel comfortable with it.dcrck
I would like to wrap the static HTML in layouts for some consistent styling when it’s served, like how it’s done with . I know I could just do that with
EEx.eval_filewith the layout file once I have the static contents read, but I think when I do that I’m not taking advantage of the functionality Phoenix provides. I know I could also read the file, but some of these files are pretty big and I’d like to make serving them as fast as possible. I just want to know if there’s a middle ground somewhere, where I can render files within layouts without having toEEx.eval_filethem when they’re generated.l00ker
A while back I needed to do something similar in a project I was working on so I hacked together a simple way to serve static HTML & Markdown out of a
publicdirectory at the root of the app. Nothing too fancy, but it gets the job done.It could probably be improved but I haven’t really touched it much since I cooked it up. I haven’t tried to use it with really large pages, so YMMV.
I carved out the relevant code an pushed up a demo repo here:
In a release the settings in
config.exsare plucked out of the environment byruntime.exsso that way I can useApplication.put_env/3to add additional directories for the static assets etc.dcrck
I’ll take a look, thank you
derek-zhou
Earmark is not a very fast parser; I’ve seen it choke on some large files or pathetic cases. If you are going to serve in volume, it would be much faster to pre-render the html fragments and
raw/1them in the template.Exadra37
Did you have open an issue for this cases?
derek-zhou
Don’t get me wrong, I love earmark. I see it as a build time tool, not a runtime tool except on very short inputs. Markdown is a fantastic format as a source format, but a terrible format as an intermediate or serialization format. Parsing it repeatly is not the best use of cpu cycles.
l00ker
I agree. This particular solution was hacked together in a short time to solve an immediate problem and has been in use on a few small low volume pages, most all of which use HTML and not Markdown. The Markdown option was added at the time to make it a little easier for a client that was unfamiliar with HTML to be able to upload some content.
At the time I intended to re-visit the issue and come up with a better solution but… time hasn’t yet been on my side!