mat-hek
How to add an .exs script to docs?
Hello, I have an .exs script with Mix.install in a repo and I’d like to include it in the docs. Putting it into extras throws an error that only markdown files are allowed. What’s the best way to include the script in the docs?
Most Liked
benwilson512
You’re trying to show the contents of the file in the docs? Would @moduledoc "#{File.read("script.exs")}" work?
christhekeele
AFAIK, while Earmark supports custom processing allowing you to do things like this, ExDoc does not.
I’d use @external_resource with @benwilson512’s approach to insert script code somewhere into module/function docs, or rework the script into a Livebook (which is publishable by ExDoc).
mat-hek
mat-hek
It’s not a hard requirement, it just feels right to me to have an exs script in an exs file. It’s not a big deal anyway 
Popular in Questions
Other popular topics
Latest on Elixir Forum
Sponsor Spotlight
We build reliable cloud platforms for business-critical systems.
Categories:
Sub Categories:
Forums
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.
Practical resources that improve the lives of professional developers.
Develop your skills with books, videos, and courses.
Producing high quality Elixir screencasts since 2017.
Courses that'll move you from confusion to "Aha, now I get it!"