'RStudio' Add-Ins for Formatted Section Titles

Provides 'RStudio' add-ins and helper functions for converting the current editor line, or a supplied character string, into formatted section titles for 'R' scripts. When used as an add-in, it uses 'rstudioapi' to read the active document context and replace only the selected line, so users can bind the add-ins to keyboard shortcuts. The formatter trims common comment and heading markers, converts the label to uppercase, and renders three styles: a five-line boxed title, a framed subtitle, and a simple inline header. Generated titles are padded or centered to a configurable width, using the package-specific width option when set and the session display width otherwise, which helps keep analysis scripts visually consistent and easier to navigate.


bolder

bolder is a small RStudio add-in package for turning the current editor line into clean section headers for scripts.

Write a word or phrase, click the line, press a keyboard shortcut, and bolder replaces that line with an uppercase section title.

data cleaning

Styles

Title:

###############################################################
###############################################################
######################## DATA CLEANING ########################
###############################################################
###############################################################

Subtitle:

###############################################################
#---------------------- DATA CLEANING ------------------------#
###############################################################

Simple:

# DATA CLEANING -----------------------------------------------

Installation

Install the released version from CRAN:

install.packages("bolder")
library(bolder)

Restart RStudio after installing.

Keyboard Shortcuts

Configure shortcuts manually in RStudio:

Tools > Modify Keyboard Shortcuts

Search for bolder and assign your preferred shortcuts.

Suggested shortcuts:

  • Ctrl+B: bolder - Simple
  • Ctrl+Shift+B: bolder - Subtitle
  • Ctrl+Alt+B: bolder - Title

Usage

In an .R script, write a word or phrase:

final model

Click that line and press one of the shortcuts.

You can also run the add-ins from the RStudio Addins menu:

  • bolder - Simple
  • bolder - Subtitle
  • bolder - Title

Width

By default, bolder uses getOption("width") to decide how wide the generated title should be.

To set a custom width:

options(bolder.width = 90)

To make that width permanent, add the same line to your .Rprofile.

Troubleshooting

If the shortcuts do not appear or do not work:

  1. Close all RStudio windows.
  2. Open RStudio again.
  3. Go to Tools > Modify Keyboard Shortcuts.
  4. Search for bolder.

If one of the shortcuts is already used by RStudio, choose another shortcut that includes B.

Development

Check the package locally with:

devtools::check()

Or from a terminal:

R CMD check --no-manual bolder

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.

install.packages("bolder")

0.1.1 by Gabriel Curti, 5 months ago


Browse source code at https://github.com/cran/bolder


Authors: Gabriel Curti [aut, cre]


Documentation:   PDF Manual  


MIT + file LICENSE license


Imports rstudioapi


See at CRAN