blob: 2ddc51b12b11eabbe40fb33bb245d43f02ad48fa [file] [log] [blame]
brentthorneb2fdd572019-01-04 23:32:17 -05001---
brentthorne16e18402019-01-05 10:48:08 -05002#----ESSENTIALS----#
brentthornec7c1c5a2019-01-10 01:54:11 -05003title: '\fontfamily{phv}\selectfont Using posterdown to generate reproducible conference posters via RMarkdown > Knitr > Markdown > Pandoc > Latex > PDF workflow'
brentthorne16e18402019-01-05 10:48:08 -05004author: "Author One^1^ Author Two^2^"
brentthorne2d2faee2019-01-07 11:42:21 -05005affiliation: "^1^Department of Poster Layouts, University of Markdown; ^2^Deparment of Another Institution, Institution University"
brentthorneb2fdd572019-01-04 23:32:17 -05006
brentthorne16e18402019-01-05 10:48:08 -05007#----FONT STYLE----#
8font_size: "30pt" #sets '\normalsize' (sizes of the title and sections headings will adjust based on it)
brentthornec7c1c5a2019-01-10 01:54:11 -05009font_family: "palatino" # choose from typical latex fonts (example: "palatino")
brentthorneb2fdd572019-01-04 23:32:17 -050010
brentthorne16e18402019-01-05 10:48:08 -050011#----COLOURS----#
brentthorneb2fdd572019-01-04 23:32:17 -050012
brentthorne342f0e42019-01-08 14:56:27 -050013#Background/ Line Colours
14title_bgcol: "0b4545" #Hex colour for background of poster title section (default is blue)
15poster_bgcol: "ffffff" #colour of the poster main background
16cite_col: "CC0000" #colour of ciation elements
17url_col: "008080" #colour of url links
18link_col: "008080" #colour of other links within the poster
19columnline_col: "0b4545" #colour
20header_bgcol: "008080"
21
22#Text Colours
23title_textcol: "ffffff" #colour of title text
24author_textcol: "008080" # Colour of author text
25affiliation_textcol: "FFFFFF" # Colour of affiliation text
26body_textcol: "000000" # Colour of main text in the body of poster
27header_textcol: "CC0000" # Colour of the poster header titles
28footnote_textcol: "FFFFFF" # Colour of footnote text if used
29
30#----POSTER SIZE & COLUMN FORMATTING----#
brentthorneb2fdd572019-01-04 23:32:17 -050031poster_height: "38in" # height in inches of poster
32poster_width: "45in" # width in inches of poster
33column_numbers: 3 # Number of columns that the poster has
brentthorne342f0e42019-01-08 14:56:27 -050034column_margins: "10mm" # Margin spacing for columns
brentthorneb2fdd572019-01-04 23:32:17 -050035
brentthorne16e18402019-01-05 10:48:08 -050036#----OTHER----#
brentthorneb2fdd572019-01-04 23:32:17 -050037bibliography: MyLibrary # name of the .bib file used for referencing
brentthorne16e18402019-01-05 10:48:08 -050038output: posterdown::posterdown_pdf
brentthorneb2fdd572019-01-04 23:32:17 -050039---
40
41```{r, include=FALSE}
42knitr::opts_chunk$set(echo = FALSE, results = 'asis',fig.height = 3.5, fig.width = 4.5, out.width = "100%", warning = FALSE, fig.align = 'center', message = FALSE, dev='cairo_pdf')
43```
44
brentthorne16e18402019-01-05 10:48:08 -050045<!--
46Bellow you will find typical RMarkdown syntax which should fill in the columns for the poster from top to bottom left to right. The more information you have the more will be filled. Please let me know if you have feedback at brentthorne18@gmail.com or at github.com/brentthorne/posterdown
47
48ENJOY! XD
49-->
50
brentthorneb2fdd572019-01-04 23:32:17 -050051# Introduction
52
53Welcome to `posterdown` ! This is my attempt to provide a semi-smooth workflow for those who wish to take their `RMarkdown` skills to the conference world. Many creature comforts from `RMarkdown` are available in this package such as `Markdown` section notation, figure captioning, and even citations like this one [@holden_identifying_2012] The rest of this example poster will show how you can insert typical conference poster features into your own document.
54
55# Study Site
56
57Here is a map made to show the study site using `ggplot2`, `ggspatial`, and `sf`. Lorem ipsum dolor sit amet, [@middleton_geological_nodate] consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Phasellus vestibulum lorem sed risus ultricies tristique nulla. Mauris vitae ultricies leo integer malesuada nunc vel risus commodo. Suspendisse potenti nullam ac tortor vitae. Enim nunc faucibus a pellentesque sit amet porttitor eget. \vspace{15mm}
58
brentthornec7c1c5a2019-01-10 01:54:11 -050059## OTHER
60
brentthorne5d1588e2019-01-08 09:48:41 -050061```{r, fig.width=4.5, out.width="100%", fig.cap='Here is an example of a firgure using the iris dataset and ggplot2', cache=TRUE}
brentthorneb2fdd572019-01-04 23:32:17 -050062
brentthorne5d1588e2019-01-08 09:48:41 -050063plot(iris$Sepal.Length,iris$Sepal.Width, pch = 19)
brentthorneb2fdd572019-01-04 23:32:17 -050064
65```
66
67
68# Objectives
69
70\large
71
721. Easy to use reproducible poster design.
732. Integration with `RMarkdown`.
743. Easy transition from `posterdown` to `thesisdown` or `rticles`
75
76\small
77
78# Methods
79
80This package uses the same workflow approach as the `RMarkdown` you know and love. Basically it goes from RMarkdown > Knitr > Markdown > Pandoc > Latex > PDF
81
82# Results
83
84Usually you want to have a nice table displaying some important results that you have calcualated. In posterdown this is as easy as using the `kable` table formatting you are probably use to as per typical `RMarkdown` formatting. I suggesting checking out the `kableExtra` package and its in depth documentation on customizing these tables found [here](https://haozhu233.github.io/kableExtra/awesome_table_in_pdf.pdf).
85
86```{r}
87library(kableExtra)
88library(ggplot2)
89
90data("iris")
91
92kable(iris[1:4,],align = "c", caption = "Tables are a breeze with Kable and Kable extra package!", booktabs = TRUE) %>%
93 kable_styling(latex_options = "striped",full_width = TRUE, font_size = 25)
94
95```
96
97\vspace{1in}
98
99```{r, out.width='75%', fig.width=4, fig.height=3, fig.cap='A typical plot using ggplot using the classic iris dataset.'}
100
101library(ggplot2)
102library(ggthemes)
103
104ggplot(data = iris, aes(x = Sepal.Length, y = Sepal.Width, colour = Species)) +
105 geom_point() +
106 theme_fivethirtyeight() +
107 labs(x = "Sepal Length", y = "Sepeal Width") +
108 NULL
109
110```
111
112\vspace{1in}
113
114```{r, out.width='85%', fig.width=4.5, fig.height=4, fig.cap='Another typical plot using ggplot, this time with a different theme and r code chunk options for fig.width and fig.height.'}
115
116library(ggplot2)
117library(ggthemes)
118
119ggplot(data = iris, aes(x = Sepal.Length, y = Sepal.Width, colour = Species)) +
120 geom_point() +
121 theme_hc() +
122 labs(x = "Sepal Length", y = "Sepeal Width") +
123 NULL
124
125```
126
127\vspace{1in}
128
129```{r, out.width='80%', fig.width=4.5, fig.align='center', echo=TRUE, fig.height=5, fig.cap='Another figure showing how base R plots might look on this poster!'}
130
131# Here is some code for people
132# to look at and be in awe of!!!!
133library(ggplot2)
134library(ggthemes)
135
136ggplot(data=iris,
137 aes(x = Sepal.Width,
138 y = Sepal.Length,
139 colour = Species)) +
140 geom_point() +
141 theme_stata() +
142 NULL
143
144```
145
146
147# Next Steps
148
149There is still **A LOT** of work to do on this package which include (but are note limited to):
150
brentthorne16e18402019-01-05 10:48:08 -0500151- Better softcoding for front end user options in YAML
brentthorneb2fdd572019-01-04 23:32:17 -0500152- Images in the title section for logo placement which is a common attribut to posters as far as I have come to know.
153- Figure out compatiability with `natbib` which wasn't working during the initial set up.
154- MUCH BETTER PACKAGE DOCUMENTATION. For example, there is nothing in the README...
155- Include References section only if initiated by the user like in RMarkdown.
156
brentthornec7c1c5a2019-01-10 01:54:11 -0500157<!--- Here you can set the size of the citation text as well as remove the "References" section if you choose not to have one for some reason :) -->
158\small\printbibliography
159
160