Skip to content

Commit

Permalink
New post - WordPress via RMarkdown
Browse files Browse the repository at this point in the history
  • Loading branch information
ds4ci committed Jul 2, 2016
1 parent 2cc0b6b commit 81d2939
Show file tree
Hide file tree
Showing 3 changed files with 120 additions and 1 deletion.
38 changes: 37 additions & 1 deletion R/WordPressPostsViaRMarkdown.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -2,12 +2,48 @@
title: "WordPress Posts via R Markdown"
author: "Jim Porzak"
date: "July 2, 2016"
output: html_document
output:
md_document:
variant: markdown_phpextra+backtick_code_blocks
---

```{r setup, include=FALSE}
knitr::opts_chunk$set(echo = TRUE)
```
I'm totally (re-)inspired with RMarkdown at useR! 2016. A lot going on including bookdown and markdown documents. The latter making WordPress blogging reasonable. Here is my first R Markdown generated post.

BTW, I'm putting the .Rmd's up on my [GitHub here](https://github.com/ds4ci/DS4CI-Posts)

The trick is WordPress will optionally accept .md files as input to the blog post edit window. To enable, follow the directions on the [WordPress Markdown page](http://en.support.wordpress.com/markdown/).

R Markdown can produce plain markdown files with variants for different dialects. See the [RStudio Markdown Documents page](http://rmarkdown.rstudio.com/markdown_document_format.html)

For WordPress, the YAML output parameter should read
```{}
output:
md_document:
variant: markdown_phpextra+backtick_code_blocks
```

The workflow is to knit your .Rmd, then copy the generated markdown and paste into your WordPress Blog Posts|Add|HTML tab.

There are two gotchas:

* "Note however that if you have embedded plots or other images you’ll need to upload them separately and fix up their URLs to point to the uploaded location." (from above RStudio page)
* WordPress does not seem to pick up .md title in its Title box. You will need to manually cut & paste the title.

# Default RStudio Boilerplate
As an example we use the RStudio boilerplate. The workflow is:

1. RStudio: Knit the `<MyPost>.Rmd`
1. WordPress|Dashboard|Media: Add image(s) from the `<MyPost>_files` folder to the WordPress Media Library.
1. WordPress|Dashboard|Posts|Add New: Copy the md text from RStudio & paste into **HTML** tab.
1. Copy title text from md to Text & delete title lines from the body.
1. For each image placeholder pointing to R project folder:
* Delete image placeholder
* Insert `<img src="...File URL from media library..." alt="...whatever..." />`
1. Don't forget to select categories and add tags.
1. WordPress: Publish & View Post

## R Markdown

Expand Down
83 changes: 83 additions & 0 deletions R/WordPressPostsViaRMarkdown.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,83 @@
I'm totally (re-)inspired with RMarkdown at useR! 2016. A lot going on
including bookdown and markdown documents. The latter making WordPress
blogging reasonable. Here is my first R Markdown generated post.

BTW, I'm putting the .Rmd's up on my [GitHub
here](https://github.com/ds4ci/DS4CI-Posts)

The trick is WordPress will optionally accept .md files as input to the
blog post edit window. To enable, follow the directions on the
[WordPress Markdown page](http://en.support.wordpress.com/markdown/).

R Markdown can produce plain markdown files with variants for different
dialects. See the [RStudio Markdown Documents
page](http://rmarkdown.rstudio.com/markdown_document_format.html)

For WordPress, the YAML output parameter should read

output:
md_document:
variant: markdown_phpextra+backtick_code_blocks

The workflow is to knit your .Rmd, then copy the generated markdown and
paste into your WordPress Blog Posts|Add|HTML tab.

There are two gotchas:

- "Note however that if you have embedded plots or other images you’ll
need to upload them separately and fix up their URLs to point to the
uploaded location." (from above RStudio page)
- WordPress does not seem to pick up .md title in its Title box. You
will need to manually cut & paste the title.

Default RStudio Boilerplate {#default-rstudio-boilerplate}
===========================

As an example we use the RStudio boilerplate. The workflow is:

1. RStudio: Knit the `<MyPost>.Rmd`
2. WordPress|Dashboard|Media: Add image(s) from the `<MyPost>_files`
folder to the WordPress Media Library.
3. WordPress|Dashboard|Posts|Add New: Copy the md text from RStudio &
paste into **HTML** tab.
4. Copy title text from md to Text & delete title lines from the body.
5. For each image placeholder pointing to R project folder:
- Delete image placeholder
- Insert
`<img src="...File URL from media library..." alt="...whatever..." />`

6. Don't forget to select categories and add tags.
7. WordPress: Publish & View Post

R Markdown {#r-markdown}
----------

This is an R Markdown document. Markdown is a simple formatting syntax
for authoring HTML, PDF, and MS Word documents. For more details on
using R Markdown see <http://rmarkdown.rstudio.com>.

When you click the **Knit** button a document will be generated that
includes both content as well as the output of any embedded R code
chunks within the document. You can embed an R code chunk like this:

``` r
summary(cars)
```

## speed dist
## Min. : 4.0 Min. : 2.00
## 1st Qu.:12.0 1st Qu.: 26.00
## Median :15.0 Median : 36.00
## Mean :15.4 Mean : 42.98
## 3rd Qu.:19.0 3rd Qu.: 56.00
## Max. :25.0 Max. :120.00

Including Plots {#including-plots}
---------------

You can also embed plots, for example:

![](WordPressPostsViaRMarkdown_files/figure-markdown_phpextra+backtick_code_blocks/pressure-1.png)

Note that the `echo = FALSE` parameter was added to the code chunk to
prevent printing of the R code that generated the plot.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 81d2939

Please sign in to comment.