You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
These are some notes as I brainstorm on the best workflow for documentation.
Current
Write documentation in Rrst.
Knit to rst.
Use sphinx to generate the documentation.
Since the pdf version does not pick up iframes, there is a manual step here that involves using SVG Crowbar to download a plot as svg, print it to pdf, crop out the non-chart portions, save it in the _downloads directory and add a link in the Rrst with the directive .. only:: latex.
The text was updated successfully, but these errors were encountered:
One possibility I have been toying around with is to separate the process of creating the charts from the actual documentation. While reproducible documentation is fun, I often find myself tweaking things indefinitely, which distracts away from the actual documentation. From a productivity perspective, I see merit in separating the writing from the coding, since the two tasks involve different approaches.
Here is one way to adopt this workflow.
Write examples in .R files.
Create HTML charts and either save them or upload to gist.
Create PDF/SVG version of charts for static documentation.
Put everything in a folder so that it becomes a self-contained example unit.
Now, I can write R code to read the example folder and generate the necessary reSt tags that would display the example optimally in multiple formats. This approach has the advantage that users can contribute simple examples that I can seamlessly integrate into my documentation.
These are some notes as I brainstorm on the best workflow for documentation.
Current
Rrst
.rst
.Since the pdf version does not pick up iframes, there is a manual step here that involves using SVG Crowbar to download a plot as svg, print it to pdf, crop out the non-chart portions, save it in the
_downloads
directory and add a link in theRrst
with the directive.. only:: latex
.The text was updated successfully, but these errors were encountered: