-
Notifications
You must be signed in to change notification settings - Fork 0
/
Tokyo_R_presentation.html
178 lines (147 loc) · 4.65 KB
/
Tokyo_R_presentation.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
<!DOCTYPE html>
<html>
<head>
<title>Creating your own website/ blog with R</title>
<meta charset="utf-8">
<meta name="author" content="Henning Bumann @ Tokyo.R" />
<link href="Tokyo_R_presentation_files/remark-css/example.css" rel="stylesheet" />
</head>
<body>
<textarea id="source">
class: center, middle, inverse, title-slide
# Creating your own website/ blog with R
## An intro to the <code>blogdown</code>-package
### Henning Bumann @ Tokyo.R
### 2017/04/01
---
# Many reasons to set up a website or blog
- document projects
- contribute to community
- build a portfolio
- practice writing
- learn about web technology
--
## But it should be simple...
- ... to set up,
- ... to use and
- ... to publish!
???
Why should you consider a blog?
- web is/ should be about collaboration, freedom and sharing (not surveillance)
- you want to contribute, you need some kind of plattform to do so.
- But it would be nice to be able to share R code with others!
- I guess, most of us use RStudio for working with R and many of us wil use git and github to control and possibly share our source code. RStudio provides extensive support for literate programming and reproducable research via the `knitr` and `rmarkdown` packages.
- easily contribute to R-bloggers or other blog aggregators
---
# Choose the right tool for the job!
.pull-left[
## Hugo
- *very fast* static site generator written in Go
- seperates content and design
- secure compared to CMS
- good performance
]
--
.pull-right[
## RMarkdown
- powerful literate programming tool
- almost native solution for RStudio
- offers *many* possible output formats
]
--
### 🢣 `blogdown`-package by [Yihui Xie](https://github.com/yihui)!
---
class: inverse, center
background-image: url(https://proquestionasker.github.io/blog/img/SiteTutorial.jpg)
background-size: 600px
# Demotime!
.footnote[
*Image-Credit: [Amber Thomas](https://proquestionasker.github.io/blog/Making_Site/)*
]
---
# (Creating a Website locally)
### Install Hugo
```r
devtools::install_github("Rstudio/blogdown")
library(blogdown)
install_hugo() # install Hugo
```
### Create Website
```r
new_site(theme = "frjo/hugo-theme-zen") # create website
new_post("tokyo.R", rmd = TRUE)
```
### Build (and publish)
```r
build_site()
```
???
- Create site needs a empty folder
- explain `options(servr.daemon = TRUE)`
---
# Why I like `blogdown`
.pull-left[
### great
- very easy to set up and use
- Hugo is very fast!
- allows to write blogposts from the comfort of your favorite editor. ;-)
- great variability of easy to install themes
- all the features of (html-)rmarkdown can be used
]
.pull-right[
### almost great
- publication could be even more streamlined
- not possible to add content outside of the editor
]
---
# I hope, you will build your own site soon!
<img src="images/any_questions_mem.jpeg" width="600px" style="display: block; margin: auto;" />
???
- I shope you will also create a blogdown page soon (and tell me about it)
- if you come to Germany in the future, please get in touch!
---
# References
- Github-repo for this talk: <br>
- https://github.com/henningsway/Tokyo.R
- `blogdown`-repo:
- https://github.com/rstudio/blogdown
- Blogposts on using blogdown:
- *Publishing to githubpages:* <br>
https://proquestionasker.github.io/blog/Making_Site/
- *2-repo-approach:* <br>
https://tclavelle.github.io/
- *Subtree-approach:* <br>
https://hjdskes.github.io/blog/update-deploying-hugo-on-personal-gh-pages/
- Hugo
- https://themes.gohugo.io/ (Themes)
- https://gohugo.io/overview/introduction/ (Documentation)
- RMarkdown:
- https://rmarkdown.rstudio.com/
</textarea>
<script src="https://remarkjs.com/downloads/remark-latest.min.js"></script>
<script>var slideshow = remark.create({
"highlightStyle": "github",
"highlightLines": true,
"countIncrementalSlides": false
});
if (window.HTMLWidgets) slideshow.on('showSlide', function (slide) {setTimeout(function() {window.dispatchEvent(new Event('resize'));}, 100)});</script>
<script type="text/x-mathjax-config">
MathJax.Hub.Config({
tex2jax: {
skipTags: ['script', 'noscript', 'style', 'textarea', 'pre']
}
});
</script>
<!-- dynamically load mathjax for compatibility with self-contained -->
<script>
(function () {
var script = document.createElement('script');
script.type = 'text/javascript';
script.src = 'https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML';
if (location.protocol !== 'file:' && /^https?:/.test(script.src))
script.src = script.src.replace(/^https?:/, '');
document.getElementsByTagName('head')[0].appendChild(script);
})();
</script>
</body>
</html>