Convert R Markdown to a PDF book with Thai Language Compatibility

Description

Thai language supported conversion of R Markdown to a PDF after resolving the special tokens of bookdown (e.g., the tokens for references and labels) to native LaTeX commands. It is a wrapper around bookdown::pdf_book() with argument base_format set to thaipdf_document().

Usage

thaipdf_book(...)

Arguments

Value

An S3 object of class "rmarkdown_output_format" to pass to rmarkdown::render()

See Also

• How to use bookdown::pdf_book(), please see official documentation

• How to use thaipdf_document().

Examples

## Not run: 
 library(rmarkdown)

 # Simple Conversion
 render("input.Rmd", output_format = thaipdf::thaipdf_book())

 # Render with Thai font "Laksaman" and font size 10pt
 render("input.Rmd",
        output_format = thaipdf::thaipdf_book(
          thai_font = "Laksaman", # you must have this font in your system
          pandoc_args = pandoc_metadata_arg("fontsize", "10pt")
        ))

## End(Not run)

Convert to a PDF/LaTeX document with Thai Language Compatibility

Description

Thai language supported conversion of R Markdown to a PDF or LaTeX document. It is a wrapper around rmarkdown::pdf_document().

Usage

thaipdf_document(thai_font = "TH Sarabun New", line_spacing = 1.5, ...)

Arguments

Details

To achieve Thai language compatibility for LaTeX, This function injects preamble fragment of Thai LaTeX typesetting into the preamble of output LaTeX via includes argument, and set latex_engine to "xelatex".

Value

An S3 object of class "rmarkdown_output_format" to pass to rmarkdown::render()

See Also

• How to use rmarkdown::pdf_document, please see official documentation.

• How to use thaipdf_book().

Examples

## Not run: 
library(rmarkdown)

 # Simple Conversion
 render("input.Rmd", output_format = thaipdf::thaipdf_document())

 # Render with Thai font "Laksaman", font size 10pt, enable table of contents
 render("input.Rmd",
        output_format = thaipdf::thaipdf_document(
          thai_font = "Laksaman", # you must have this font in your system
          toc = TRUE,
          pandoc_args = pandoc_metadata_arg("fontsize", "10pt")
        ))

## End(Not run)

Create a LaTeX Preamble for Thai Language in R Markdown

Description

This function creates LaTeX preamble file needed to render Thai language in R Markdown to a PDF document.

Usage

use_thai_preamble(
  name = "thai-preamble.tex",
  thai_font = "TH Sarabun New",
  line_spacing = 1.5,
  open = FALSE,
  overwrite = FALSE
)

Arguments

Details

Here is the steps:

1. Call use_thai_preamble(). You can set other file name by name argument and Thai font to use by thai_font argument.

2. Follow the instructions printed to R console.

   • File thai-preamble.tex should be created in the current working directory (by default).

   • (If not already) Create R Markdown file with ⁠pdf_document:⁠ or bookdown::pdf_document2 format.

   • Modify YAML header in ⁠pdf_document:⁠ or bookdown::pdf_document2 option. Set latex_engine to xelatex and set to include path to the LaTeX preamble file.

   • Add LaTeX macro ⁠\sloppy⁠ to the beginning of the body of R Markdown (just after YAML header).

3. Write some Thai language in R Markdown then knit to PDF. It's DONE!

Value

(Invisible) A path to LaTeX preamble being created.

Examples

## Not run: 
 # Running this will write `thai-preamble.tex` to your working directory
 use_thai_preamble()
 # Write `thai-preamble.tex` under pre-tex/ directory (a directory must exist)
 use_thai_preamble(name = "pre-tex/thai-preamble.tex")
 # Specify Thai font to use
 use_thai_preamble(thai_font = "Laksaman")

## End(Not run)

 # Example
 .old_wd <- setwd(tempdir())
 use_thai_preamble()
 setwd(.old_wd)