Hello. I apologize if this question isn’t well-formed for the forums.
I am wondering what the state of the art is for mixed plot/results-and-text documents intended for display as HTML (web) or PDF.
In the old days, before I ever used Julia, I had two workflows that I would have used to answer this question relative to R:
- Write your document in R Sweave / eventually in knitr, .Rmd, compile it to HTML, post to web
- Write your document in R Sweave / eventually in knitr .Rmd, compile to TeX then pdflatex to PDF.
Since then I’ve been overwhelmed by the apparent explosion in options. I think this is really cool; it seems like more things offer more support for more other embedded things. E.g., a Jupyter notebook can have Markdown and LaTeX and even both embedded R and Julia. The Pluto.jl platform has built-in interactivity. And this is only scratching the surface.
What I am wondering is if someone far more knowledgeable about (a) the breadth of these solutions and (b) the state of the art can offer a somewhat opinionated summary of the current state of the art workflow for various tasks.
For example, suppose my main desire is to write a blog post that is primarily words for a non-technical audience, but include a couple of Julia-generated graphs. A valid claim would be “don’t try to embed anything, just generate your graphs outside the post and write the post in text, copy the images in.” Another might be “Don’t be silly, such-and-such workflow is the perfect workflow for this,” e.g. write it in some Julia analogue of R markdown (of which I’m unaware) and only in a couple places will I have to fence off some Julia that generates the graph.
Suppose separately my main desire is to write a PDF that is primarily math-heavy. One valid claim would be “write it in TeX and name your included images intelligently, write the Julia script to generate those images”; another would be “here is the right workflow for generating TeX->PDF outputs from a mixed Julia-and-TeX file.”
I hope this question makes sense. I’m open to pushback on it; essentially my challenge here is that I think I’ve failed to keep up with all the developments in integrated document, online, notebook formats, etc.