# 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.

```r
data cleaning
```

## Styles

Title:

```r
###############################################################
###############################################################
######################## DATA CLEANING ########################
###############################################################
###############################################################
```

Subtitle:

```r
###############################################################
#---------------------- DATA CLEANING ------------------------#
###############################################################
```

Simple:

```r
# DATA CLEANING -----------------------------------------------
```

## Installation

Install the released version from CRAN:

```r
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:

```r
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:

```r
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:

```r
devtools::check()
```

Or from a terminal:

```sh
R CMD check --no-manual bolder
```
