R: Split Text by Regex Into a Transcript

split_match_regex_to_transcript {textshape} | R Documentation

## Split Text by Regex Into a Transcript

### Description

A wrapper for `split_match_regex` and textreadr's `as_transript` to detect person variable, split the text into turns of talk, and convert to a data.frame with `person` and `dialogue` variables. There is a bit of cleansing that is closer to `as_transript` than `split_transcript`.

### Usage

    split_match_regex_to_transcript(x, person.regex = "^[A-Z]{3,}",
      col.names = c("Person", "Dialogue"), dash = "", ellipsis = "...",
      quote2bracket = FALSE, rm.empty.rows = TRUE, skip = 0, ...)

### Arguments

`x` | A vector with split points.
`person.regex` | A vector of places (elements) to split on or a regular expression if `regex` argument is `TRUE`.
`col.names` | A character vector specifying the column names of the transcript columns.
`dash` | A character string to replace the en and em dashes special characters (default is to remove).
`ellipsis` | A character string to replace the ellipsis special characters.
`quote2bracket` | logical. If `TRUE` replaces curly quotes with curly braces (default is `FALSE`). If `FALSE` curly quotes are removed.
`rm.empty.rows` | logical. If `TRUE` `read_transcript` attempts to remove empty rows.
`skip` | Integer; the number of lines of the data file to skip before beginning to read data.
`...` | ignored.

### Value

Returns a data.frame of dialogue and people.

### Examples

    ## Not run:
    system.file(
        "docs/Simpsons_Roasting_on_an_Open_Fire_Script.pdf",
        package = "textshape"
    ) %>%
        textreadr::read_document() %>%
        split_match_regex_to_transcript("^[A-Z]{3,}", skip = 2)

    ## End(Not run)

[Package textshape version 1.6.0 Index]