# Documentation with interactive WGLMakie visualizations

**URL:** <https://discourse.julialang.org/t/documentation-with-interactive-wglmakie-visualizations/82300>\
**Category:** Visualization\
**Tags:** documenter, makie, wglmakie\
**Created:** [June 6, 2022, 11:03am UTC](https://discourse.julialang.org/t/documentation-with-interactive-wglmakie-visualizations/82300 "2022-06-06T11:03:35Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![juliohm](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/juliohm/32/215266_2.png) [@juliohm](https://discourse.julialang.org/u/juliohm)\
**Post date:** [June 6, 2022, 11:03am UTC](https://discourse.julialang.org/t/documentation-with-interactive-wglmakie-visualizations/82300/1 "2022-06-06T11:03:35Z")

</div>

I am trying to migrate all examples of Meshes.jl documentation to use WGLMakie.jl instead of CairoMakie.jl. When I generate the docs locally the visualizations show up and work nicely with interaction. However, on GitHub they don’t show up because there is no Julia process running.

I know that I need to create a Page with JSServe.jl but the tricky didn’t work in my experiments. My latest attempt is on the master branch of the Meshes.jl repo. What changes are needed to make it work? Appreciate any help.

> **[GitHub - JuliaGeometry/Meshes.jl: Computational geometry and meshing...](https://github.com/JuliaGeometry/Meshes.jl)**
>
> Computational geometry and meshing algorithms in Julia - GitHub - JuliaGeometry/Meshes.jl: Computational geometry and meshing algorithms in Julia

---

<div class="post-metadata">

**Author:** ![sdanisch](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/sdanisch/32/1406_2.png) [@sdanisch](https://discourse.julialang.org/u/sdanisch)\
**Post date:** [June 6, 2022, 1:08pm UTC](https://discourse.julialang.org/t/documentation-with-interactive-wglmakie-visualizations/82300/2 "2022-06-06T13:08:21Z")

</div>

What have you tried so far and how did error?

---

<div class="post-metadata">

**Author:** ![juliohm](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/juliohm/32/215266_2.png) [@juliohm](https://discourse.julialang.org/u/juliohm)\
**Post date:** [June 7, 2022, 2:00pm UTC](https://discourse.julialang.org/t/documentation-with-interactive-wglmakie-visualizations/82300/3 "2022-06-07T14:00:49Z")

</div>

Hi @sdanisch, I added `Page(offline=true, exportable=true)` as explained in the docs, but the visualizations don’t show up on Github. I am not sure if these JSServe pages should be created on each example block or on the main make.jl file in the docs folder.

For example, the examples in src/index.md are not showing up even when I add Page in the first example block: [Meshes.jl/index.md at master · JuliaGeometry/Meshes.jl · GitHub](https://github.com/JuliaGeometry/Meshes.jl/blob/master/docs/src/index.md)

---

<div class="post-metadata">

**Author:** ![sdanisch](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/sdanisch/32/1406_2.png) [@sdanisch](https://discourse.julialang.org/u/sdanisch)\
**Post date:** [June 7, 2022, 2:40pm UTC](https://discourse.julialang.org/t/documentation-with-interactive-wglmakie-visualizations/82300/4 "2022-06-07T14:40:06Z")

</div>

Can you point to a PR that shows exactly what you did?  
Page is a bit fragile, so it really needs to get **displayed** before anything else.  
As the name suggest, it needs to be inserted for every page, and also make sure there is only one `Page()` per page 😉

---

<div class="post-metadata">

**Author:** ![juliohm](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/juliohm/32/215266_2.png) [@juliohm](https://discourse.julialang.org/u/juliohm)\
**Post date:** [June 7, 2022, 2:58pm UTC](https://discourse.julialang.org/t/documentation-with-interactive-wglmakie-visualizations/82300/5 "2022-06-07T14:58:46Z")

</div>

Will try that and will report back if it doesn’t work. I think I didn’t display the Page object in any separate cell when I tried it the last time.

---

<div class="post-metadata">

**Author:** ![juliohm](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/juliohm/32/215266_2.png) [@juliohm](https://discourse.julialang.org/u/juliohm)\
**Post date:** [June 7, 2022, 8:03pm UTC](https://discourse.julialang.org/t/documentation-with-interactive-wglmakie-visualizations/82300/6 "2022-06-07T20:03:23Z")

</div>

Everything is working nicely now after displaying the Page object in a separate cell at the top of each page with examples. 💯