On 17/11/2015 6:56 PM, Henrik Bengtsson wrote:
When choosing source format, it's probably helpful to know that if you
work with a Markdown-based format (e.g. Rmarkdown) you'll be able to
generate either/both HTML or/and PDF documents, whereas if you work
with LaTeX-based formats (e.g. Sweave/knitr) you will only be able
output PDF documents (at least without great efforts).

One major advantage with HTML documents/reports is that they aren't
constrained by page breaks, e.g. you don't have to worry about
generating long tables that run across two or more pages. With LaTeX
that is often a great pain.  These days even mathematical equations
renders quite well in HTML.  I tend to use HTML output for everyday
analysis reports and PDF occasionally for more final artifacts such as
supplementary notes where I want to have full control of layout,
equations, figure sizes and bibliographies.

If you plan to write package vignettes using one of the above formats,
choice of vignette format does not matter these days.  They're all
equally easy to use and incorporate in packages.

Yes, I agree with everything you say. One additional thing: I've been working on the rgl package lately (for movable 3D graphics); it is possible to embed those in a PDF document, but not portably (i.e. the PDF viewer will matter); it is much easier to embed rgl graphics in HTML. So I tend to use Markdown input through knitr (which calls Rmarkdown).

Duncan Murdoch


Cheers,

Henrik

On Tue, Nov 17, 2015 at 11:09 AM, Duncan Murdoch
<murdoch.dun...@gmail.com> wrote:
On 17/11/2015 10:42 AM, Marc Schwartz wrote:


On Nov 17, 2015, at 9:21 AM, John Sorkin <jsor...@grecc.umaryland.edu>
wrote:

I am looking for a gentle introduction to SWEAVE, and would appreciate
recommendations.
I have an R program that I want to run and have the output and plots in
one document. I believe this can be accomplished with SWEAVE. Unfortunately
I don't know HTML, but am willing to learn. . . as I said I need a gentle
introduction to SWEAVE.
Thank you,
John



John,

A couple of initial comments.

First, you will likely get some recommendations to also consider using
Knitr:

    http://yihui.name/knitr/

which I do not use myself (I use Sweave), but to be fair, is worth
considering as an alternative.


He did, and I'd agree with them.  I've switched to knitr for all new
projects and some old ones.  knitr should be thought of as Sweave version 2.

Duncan Murdoch



Second, to create stand alone documents, as opposed to web based content,
you will likely want the output to be in TeX/LaTeX via Sweave, which can
then become PDF based documents via the post processing of the TeX/LaTeX
source. That is what I do for all of my analytic deliverables. You can also
use LaTeX classes like 'Beamer' to create Powerpoint-like slides for
presentation.

Fritz' web site for Sweave is here:

    http://www.statistik.lmu.de/~leisch/Sweave/

and there are some links to supporting materials there with very basic
examples.

Another resource is:

    https://beckmw.files.wordpress.com/2014/02/sweave_intro1.pdf

and if you Google for Sweave Introductions and Tutorials, there are a
myriad of others.

In conjunction with Sweave itself, there are a variety of supporting
packages on CRAN that have related functionality (e.g. formatted LaTeX
output) that are worth knowing about and are included in the Reproducible
Research task view:

    https://cran.r-project.org/web/views/ReproducibleResearch.html

Regards,

Marc Schwartz

______________________________________________
R-help@r-project.org mailing list -- To UNSUBSCRIBE and more, see
https://stat.ethz.ch/mailman/listinfo/r-help
PLEASE do read the posting guide
http://www.R-project.org/posting-guide.html
and provide commented, minimal, self-contained, reproducible code.


______________________________________________
R-help@r-project.org mailing list -- To UNSUBSCRIBE and more, see
https://stat.ethz.ch/mailman/listinfo/r-help
PLEASE do read the posting guide http://www.R-project.org/posting-guide.html
and provide commented, minimal, self-contained, reproducible code.

______________________________________________
R-help@r-project.org mailing list -- To UNSUBSCRIBE and more, see
https://stat.ethz.ch/mailman/listinfo/r-help
PLEASE do read the posting guide http://www.R-project.org/posting-guide.html
and provide commented, minimal, self-contained, reproducible code.

Reply via email to