# Create \`@raw\` blocks programmatically from Documenter.jl

**URL:** <https://discourse.julialang.org/t/create-raw-blocks-programmatically-from-documenter-jl/101522>\
**Category:** General Usage\
**Tags:** documentation, documenter, plots\
**Created:** [July 12, 2023, 9:21am UTC](https://discourse.julialang.org/t/create-raw-blocks-programmatically-from-documenter-jl/101522 "2023-07-12T09:21:42Z")\
**Posts on this page:** 1\
**Showing post:** 9

<div class="post-metadata">

**Author:** ![disberd](https://avatars.discourse-cdn.com/v4/letter/d/8edcca/32.png) [@disberd](https://discourse.julialang.org/u/disberd)\
**Post date:** [July 14, 2023, 12:09pm UTC](https://discourse.julialang.org/t/create-raw-blocks-programmatically-from-documenter-jl/101522/9 "2023-07-14T12:09:18Z")

</div>

After discussion on the PR I realized that this is mostly feasible by using `@example` blocks for the original purpose of creative interactive plotly plots within documenter.

I created a very small package to simplify the procedure here:

> **[GitHub - disberd/PlotlyDocumenter.jl: Show plotly plots in Documenter.jl as...](https://github.com/disberd/PlotlyDocumenter.jl)**
>
> Show plotly plots in Documenter.jl as static HTML. Contribute to disberd/PlotlyDocumenter.jl development by creating an account on GitHub.

which supports plot objects coming out of one of:

- PlotlyLight
- PlotlyBase
- PlotlyJS

If the [PR](https://github.com/JuliaDocs/Documenter.jl/pull/2182) ends up being merged succesfully it should also be possible to use this within `@eval` blocks to completely hide the generating code.

---

_[View the full topic](https://discourse.julialang.org/t/create-raw-blocks-programmatically-from-documenter-jl/101522)._