Skip to contents

Convert a Single PDF to DOCX Using the Best Available Backend

Source: R/pdf_to_docx.R
convert_pdf_to_docx.Rd

Convenience wrapper around [convert_pdfs_to_docx()] for one file. Its src, dest signature fits the docx_from_pdf callback of [zip_reports()].

Usage

convert_pdf_to_docx(
  src,
  dest = sub("\\.pdf$", ".docx", src, ignore.case = TRUE),
  backend = "auto",
  strict = TRUE,
  timeout = 600
)

Arguments

src

Path to the input PDF file.

dest

Path for the output DOCX file. Defaults to src with .pdf replaced by .docx.

backend

One of "auto", "python", "libreoffice", "word_com".

strict

If TRUE (default), stop at the first bad row and, when every row is fine, error with an actionable message if no backend is available. Set FALSE to warn and skip instead; a skipped row comes back with converted = FALSE.

timeout

Seconds a converter may take on one file before it is stopped; it applies to every backend (python, LibreOffice and Word COM). A file that times out gets a warning that says so and comes back with converted = FALSE (the python backend then retries it once with LibreOffice, which gets its own timeout). Stopping a converter stops the process that was started; any process that one started in turn (LibreOffice's soffice.bin, or the Word instance behind Word COM) may keep running and has to be closed by hand.

Value

Invisibly, dest on success, or FALSE if conversion failed.

Examples

if (FALSE) { # \dontrun{
convert_pdf_to_docx("report.pdf")
zip_reports(reports, output_formats = c("pdf", "docx"), docx_from_pdf = convert_pdf_to_docx)
} # }