Compile-Document.ps1

#!/usr/bin/env pwsh

<#
    .SYNOPSIS
    Compiles TeX project into PDF document.

    .DESCRIPTION
    This script can be used to compile the LaTeX project.
    The main TeX file, the build directory and the name of the document can be specified.
    If parameters are omitted, useful defaults are taken (see parameter description).
    Even sub folders can be compiled into separate PDF file by specifying 
    the sub folders's TeX file.
    If the build path is not specified, a build folder named "build" will be created next to the
    TeX file.

    .INPUTS
    None. You cannot pipe objects into this script.

    .OUTPUTS
    None. The output is undefined.

    .LINK
    https://github.com/yax-lakam-tuun/maya-decipherment
#>

[CmdletBinding()]
param (
    [string]
    # The TeX file to be compiled.
    [Parameter(HelpMessage="Enter LaTeX file to compile.")]
    $TexFile = "$(Resolve-Path -Path $PSScriptRoot)/main.tex",

    [string]
    # The path to the TeX source files. Usually the root of a TeX project.
    [Parameter(HelpMessage="Enter path in which LaTeX sources are located.")]
    $SourcePath="$(Resolve-Path -Path $PSScriptRoot)",

    [string]
    # The path to the output directory. The final document will be placed there, too.
    [Parameter(HelpMessage="Enter path in which output files can be stored.")]
    $BuildPath="$(Resolve-Path -Path $(Get-Item $TexFile).Directory)/build",

    [string]
    # The file name of the PDF document.
    [Parameter(HelpMessage="Enter name of the final PDF document.")]
    $DocumentName="$((Get-Item $TexFile).BaseName)"
)

function Write-Summary {
    Write-Output "Compiling to $BuildPath/$DocumentName.pdf"
    Write-Output ""
    Write-Output "Settings:"
    Write-Output "  Name of document: $DocumentName"
    Write-Output "  Source path:      $SourcePath"
    Write-Output "  Build path:       $BuildPath"
    Write-Output "  Tex file:         $TexFile"
    Write-Output ""
    Write-Output "Invoking latexmk..."
    Write-Output ""
}

function Invoke-LaTeX {
    Set-Location -Path "$SourcePath"
    latexmk `
        -cd `
        -synctex=1 `
        -interaction=nonstopmode `
        -file-line-error `
        -pdf `
        -Werror `
        -jobname="$DocumentName" `
        -outdir="$BuildPath" `
        "$TexFile"
}

Write-Summary
Invoke-LaTeX