Code Externalization

You do not have to put the R code in the input document; with knitr, you can separate your input document with the R script (think the reverse of Stangle).

There are several advantages of separating the main document with the R script(s), e.g., R code can be reusable across several documents, and you can run the R code continuously in a separate file (if you embed the code in the document, you often have to jump through texts); this feature is especially useful for LyX users, and it saves a huge amount of time since you do not have to re-compile the whole document to see the results; instead, you can tune your R code freely in another R session.

The function read_chunk() was designed for this feature. For example, if the R code is in 113-foo.R, you can use read_chunk('113-foo.R') to read the code into the input document in an early chunk. In the R script, you have to annotate the code with comments of the form ## ---- label, where label is the chunk label that you use in the report, e.g. if you have a line ## ---- test in the script, you should also have a chunk <<test>>= in the report, and knitr will match the labels and insert external code.

It is possible to use multiple external R scripts in an input document (just call read_chunk() for multiple times), or share a single script across multiple input documents (all of them read this script).

Note this function should only be used in an uncached chunk, e.g.

<<external-code, cache=FALSE>>=
read_chunk('foo-bar.R')
@

See the examples #113 in the knitr-examples repo.

Donate

As a freelancer (currently working as a contractor) and a dad of three kids, I truly appreciate your donation to support my writing and open-source software development! Your contribution helps me cope with financial uncertainty better, so I can spend more time on producing high-quality content and software. You can make a donation through methods below.

• Venmo: @yihui_xie, or Zelle: xie@yihui.name

• Paypal

  • If you have a Paypal account, you can follow the link https://paypal.me/YihuiXie or find me on Paypal via my email xie@yihui.name. Please choose the payment type as “Family and Friends” (instead of “Goods and Services”) to avoid extra fees.

  • If you don’t have Paypal, you may donate through this link via your debit or credit card. Paypal will charge a fee on my side.

• Other ways:

  WeChat Pay (微信支付：谢益辉)	Alipay (支付宝：谢益辉)

When sending money, please be sure to add a note “gift” or “donation” if possible, so it won’t be treated as my taxable income but a genuine gift. Needless to say, donation is completely voluntary and I appreciate any amount you can give.

Please feel free to email me if you prefer a different way to give. Thank you very much!

I’ll give back a significant portion of the donations to the open-source community and charities. For the record, I received about $30,000 in total (before tax) in 2024-25, and gave back about $15,000 (after tax).