-
Notifications
You must be signed in to change notification settings - Fork 481
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Possible feature: integrate Pluto pages. #2575
Comments
I would also find it very cool!
|
Something like that is exactly what I was thinking, except integrated to Documenter. It may be that a function that converts a Pluto notebook in a regular markdown (Pluto has one?), then used within the |
Related: fonsp/PlutoUtils.jl#6 |
I don't think that documenter is the place to add extensions like this. Documenter accepts Markdown. It is the responsibility of other packages to prepare that Markdown. This is what Literate.jl and Weave.jl do. It has been working well, so I don't think we need something special for Pluto. Related: #1129 |
Yes, I think it is fair that a package external to Documenter should create the markdown. But what about linking raw html pages, as a complete html generated by Pluto? (What makes Pluto special here is how popular it is, to be honest. Maybe there's nothing to to on this side, but we should think about the possibilities) |
As a complete raw page? You can currently link to an HTML page. You can also use the
There is an open issue for links in the sidebar: #344 |
(Edit)
That works, but needs some work:
![image](https://github.com/user-attachments/assets/cf2de9ff-01b4-4038-9ae7-f219172e53ce)
The height of the page needs to be tuned. I'll see if I get that right.
|
The discussion here might also have some relevant tips: fonsp/Pluto.jl#1345 (reply in thread) iirc, they do mention a javascript library to adjust the height of the iframe |
This is supported by PlutoStaticHTML.jl: https://plutostatichtml.huijzer.xyz/stable/#Documenter.jl This page for example is a Pluto notebook: https://sirus.jl.huijzer.xyz/dev/binary-classification/. You can click on the “view source” button on that page to see the Pluto notebook. |
I used PlutoSliderServer in combination with iframes:
Let me know if you have any further questions! |
Oh, that's nice, definitely that is what I was searching for. I tried to use it now and had some issues, but I'll post them there. I'll close the issue here. |
I'm fantasizing about the possibility of integrating Pluto pages with Documenter.
The idea would be that a menu entry of a Documenter page displayed in the content tab the static html of a Pluto notebook.
The degree of integration could vary:
The utility of this in creating example pages and tutorials would be enormous.
The text was updated successfully, but these errors were encountered: