tl;dr
I share my RStudio setup and some features of the IDE I often use. Tell me about your setup.
Configuration IDEation
R has a decent community online. People love to share opinions about design, customisation and workflow efficiencies. Why is there little at the intersection?
What I do see is people excited to hear about a checkbox or shortcut they never knew existed. I also hear from colleagues who are learning R and want to know more about customising their experience.
So, this post covers some elements of my personal RStudio setup and some bits and bobs about how I use some of the features.1 It’s utterly non-exhaustive, but may be useful for someone. I may add some things every now and again.
Click a section header to jump:
- Theme
- Font
- Layout
- Addins
- Other GUI elements and settings
- Document outline
- Magic wand
- Keyboard shortcuts
- .RData
- Odds and ends
How to
These boxes appear throughout this post to tell you how to change your RStudio settings.
Theme
![Some liens of code that are syntax-highlighted, where functions, strings, comments and package names are in different styles.](/post/2020-09-15-rstudio-settings_files/syntax-highlight.png)
Syntax highlighting in action with viridis.
I’m using the viridis theme by Cédric Scherer. It’s based on the viridis colour palette by David Cooley, which is designed with colour blindness in mind.
How to
You can change to an inbuilt theme at Tools > Global options > Appearance > Editor theme. Add a new theme by clicking Add… and provide a new .tmtheme or .rstheme from file. You can find and tweak examples using the online tmTheme Editor tool by Allen Bargi.
I’m red-green colourblind and the syntax highlighting of this theme lets me distinguish easily between the different code elements. I also like the de-emphasised look of the comments, which are italicised and less bright, making it easier to focus on the code.
How to
I also use syntax highlighting in the console. You can get this by checking the box at Tools > Global Options > Code > Display > Show syntax highlighting in console input.
Sometimes I switch to a light theme, like the default one, when writing text-rich blog posts. Syntax highlighting is less important for me in these instances and dark-on-light text can be easier to read.
Font
I’m using FiraCode, an extension of the Fira typeface designed originally by Carrois Type Design. I installed this to my machine after downloading from Google Fonts).
How to
Set the font in RStudio at Tools > Global Options > Appearance > Editor font.
I find FiraCode easy to read for both coding and for writing prose. It’s monospaced, of course, but gets away with being a decent sans-serif for longer text blocks too.
![A line of code showing ligatures for the assignment arrow and 'not equal to'.](/post/2020-09-15-rstudio-settings_files/ligatures.png)
The assignment arrow and ‘not equal to’ characters are smushed into ligatures.
FiraCode’s main draw is its ligatures. This is when certain sets of adjacent characters are combined to appear as a single character. For example, the assignment operator gets condensed from <
and -
to a single, unbroken arrow character. This helps me locate and parse expressions more easily, but ligatures are certainly a Marmite topic.
Layout
I have the console pane on the right-hand side rather than the default of being on the left (see the image at the top of this post). I tend to want to maximise the script and console panes side-by-side so I can focus purely on inputs and outputs.
How to
You can change this setting by clicking the Workspace Panes button (looks like a window) on the ‘taskbar’ at the top of the interface, to the left of the Addins menu. From there you can change the individual tabs of the panes too, by clicking Pane Layout….
I don’t see a lot people doing this, but I think this kind of view is favoured in IDEs like VSCode.
![The dropdown menu for altering the layout of pane sin RStudio, showing options for putting the console on the left or right.](/post/2020-09-15-rstudio-settings_files/panes.png)
Are you right-paned or left-paned?
I also like to maximise the amount I can see on my screen by zooming out and reducing the font size.
How to
You can set font size at Tools > Global Options > Appearance > Editor font size and Zoom is in the same location.
Addins
![The RStudio addins dropdown menu showing options from the 'annotator' addin.](/post/2020-09-15-rstudio-settings_files/addins.png)
Addins: exactly what it says on the tin.
RStudio has a system of ‘addins’ that act as extensions for RStudio. They let you execute shortcuts and other commands via a dropdown menu in the GUI or a keyboard shortcut. Often these are functions that relate to the GUI in some way, like modifying selected text.
How to
Addins are delivered in R packages. You can access them from the Addins dropdown menu. There’s no official catalogue, but see a list of addins in the readme for {addinslist} by Dean Attali, which can also be installed as an addin that adds-in addins, capiche?
I have many, many addins, but want to point out a few I use often:
- {blogdown} by Yihui Xie has an addin with selections for new posts and serving the site, which I use frequently
- {remedy} by ThinkR has a bunch of useful Markdown-insertion functions, while my {blogsnip} package has a few functions for helping me write {blogdown} posts (e.g. inserting code for an accessible image)2
- {datapasta} by Miles McBain lets me add data copied from elsewhere into R, with a handy function for pasting in as a vector
- {annotater} by Luis Verde adds a comment next to your
library()
calls to indicate packages’ purposes and versions, which I find useful when writing ad hoc scripts in a team that includes people who aren’t necessarily familiar with the packages being used
How to
You can set keyboard shortcuts for addins with Tools > Modify Keyboard Shortcuts….
Other GUI elements and settings
Document outline
RStudio has a feature that lets you use comments with multiple hyphens to signal breaks in your code, which make it easier to visually separate different sections. You can insert one of these section breaks with Shift + Cmd + R, which provides a prompt for you to name the section.
![The RStudio sctip pane showing the document outline panel and jump to menu, which both show the name of the sections that have been inserted into the file.](/post/2020-09-15-rstudio-settings_files/sections.png)
Not one, but two ways of navigating between sections.
The names of the sections can then be accessed from:
- the document outline panel, which can be accessed by clicking the stacked-lines button in the top-right of the script pane (Shift + Cmd + O)
- the ‘jump to’ menu in the lower left of the script pane, which also has a little icon to show you what type of section your cursor is in (for example, it’ll show an ‘f’ if you’re in a function definition)
Magic wand
![The 'magic wand' dropdown menu opened from the script pane.](/post/2020-09-15-rstudio-settings_files/wand.png)
Sleight-of-cursor.
The ‘magic wand’ menu is available in the script pane and has some features that act a bit like addins. Some frequently-used tools in there for me are:
- Reflow comment to break a long, ragged comment across multiple lines so it fits into the conventional 80-character width limit (also Ctrl + Shift + /)
- Insert roxygen skeleton to insert a basic {roxygen2} function-documentation block above your function when your cursor is inside it (also Alt + Shift + Cmd + R)
- Rename in scope, which selects all instances of the given object name that you’ve highlighted in the script, which means you can then change them all at once without getting into the potential danger of a find-and-replace-all (also Alt + Shift + Cmd + M)
Keyboard shortcuts
RStudio has modifiable keyboard shortcuts. There’s a number of default shortcuts that I use frequently:
Keys | Action |
---|---|
Cmd + M | Insert a {magrittr} pipe (%>% ) |
Cmd + - | Insert an assignment arrow (<- ) |
Cmd + Shift + Fn + F10 | Restart RStudio |
Cmd + Shift + C | Comment out a selected block |
Cmd + I | Auto-indent a line |
Cmd + Shift + R | Add a section label |
Cmd + D | Document an in-development package |
Cmd + L | Load an in-development package |
Some shortcuts require you to be an octopus to reach all the keys (I’m looking at you, shortcut-to-restart-RStudio), so modifying your frequently used shortcuts might be a good idea. I’ve got a keyboard with F13 to F15 keys that are otherwise going to waste and as of a recent update, these can be used as mappable RStudio keys.
How to
You can see the keyboard shortcuts at Tools > Keyboard Shortcuts Help and modify them in Tools > Modify Keyboard Shortcuts….
.RData
I like to restart RStudio every few minutes so I know that my environment is empty. This stops me from modifying objects and forgetting about it, which could result in erroneous output.
There are default settings that let RStudio open from where you left off, so that the contents of your environment are intact. I don’t like this and it’s advised against in places like the R for Data Science book by Wickham and Grolemund.
How to
You can turn off this behaviour in Tools > Global Options > General > Basic > Workspace by unchecking Restore .Rdata on startup and setting Save workspace to .RData on exit to Never.
Odds and ends
Rapid fire! I also like:
- the 80-character-width guide to show me where to set a line break (Tools > Code > Display > Show margin)
- to be able to scroll beyond the end of a script, so the last line can be seen further up the page (Tools > Code > Display > Allow scroll past end of document)
- to see
.Last.value
in the environment pane so I can see the most recently created object (Tools > Global options > Advanced > Show .Last.value in environment listing) - to click the little RStudio cube-logo in the upper-right of the file pane to return to the working directory
- the spellcheck function (see the ‘ABC-and-tick’ button at the top of the scripting window)
- using multiple cursors by holding Alt and dragging down, which makes insertion and deletion across multiple lines much easier
You can learn more tips and tricks from:
It never ends
Themes and fonts can always be tweaked. You’ll get bored of them at some point, or something better will come along. RStudio’s customisability and ongoing development also means that’s a constant stream of new addins and discovered tricks.
I don’t really make use of snippets and I haven’t really mapped any new keyboard shortcuts. I want to look into Garrick Aden-Buie’s {shrtcuts} package (blog, package site) in particular.
I tend to use the terminal window for everything Git-based and I know very little of the Git GUI built into RStudio. I’m comfortable with that, but many I’d like to learn a bit more so I can help colleagues transition more easily into using version control.
Let me know about your themes, fonts, layouts, settings and tips and tricks for RStudio or whatever other IDE you use.
Note that I do most of my day-to-day coding on a work machine: a MacBook Air 13-inch (2017) running macOS Sierra with R v3.6.1 and RStudio v1.3.1073. Things may differ for you compared to what I write here.↩︎
I wrote about {blogsnip} in another post.↩︎