textshape (version 1.7.3)

split_match_regex_to_transcript: 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,
  ...
)

Value

Returns a data.frame of dialogue and people.

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.

Examples

if (FALSE) {
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)
}