Installation #

Install BasicTeX #

1. Install BasicTeX via Homebrew

   brew install --cask basictex
   

2. Add TeX binaries to your PATH

   • For Bash or Zsh

     export PATH="/Library/TeX/texbin:$PATH"
     

   • For Fish Shell

     set -U fish_user_paths /Library/TeX/texbin $fish_user_paths
     

3. Verify the installation

   xelatex --version
   

4. Install additional LaTeX packages

   • Update tlmgr

     sudo tlmgr update --self --all
     

   • Install common packages

     sudo tlmgr install collection-latex
     sudo tlmgr install collection-latexrecommended
     

   • Search for missing .sty files

     tlmgr search --global --file "<missing_file>.sty"
     

5. Install the necessary packages and test the template to ensure LaTeX is working correctly

   sudo tlmgr install fontspec
   sudo tlmgr install xecjk
   sudo tlmgr install xunicode-addon
   sudo tlmgr install greek-fontenc
   sudo tlmgr install geometry
   sudo tlmgr install fancyhdr
   sudo tlmgr install graphicx
   sudo tlmgr install float
   sudo tlmgr install subfigure
   sudo tlmgr install picinpar
   sudo tlmgr install adjustbox
   sudo tlmgr install amsmath
   sudo tlmgr install amssymb
   sudo tlmgr install mathtools
   sudo tlmgr install tabularx
   sudo tlmgr install hyperref
   sudo tlmgr install forest
   sudo tlmgr install multicol
   sudo tlmgr install enumitem
   sudo tlmgr install xcolor
   sudo tlmgr install listings
   

Configure LaTeX Workshop #

1. Install the LaTeX Workshop extension in Visual Studio Code

2. Add configuration in Visual Studio Code settings

   {
     "latex-workshop.latex.tools": [
       {
         "name": "xelatex",
         "command": "xelatex",
         "args": [
           "-synctex=1",
           "-interaction=nonstopmode",
           "-file-line-error",
           "%DOC%"
         ]
       }
     ],
     "latex-workshop.latex.recipes": [
       {
         "name": "xelatex",
         "tools": ["xelatex"]
       }
     ]
   }
   

Usage #

Create a new file named main.tex and enter the following content. Then click the green arrow at the top right to compile the project. After that, click the magnifying glass icon on the right to view the generated PDF file.

\documentclass{article}
\usepackage{xeCJK}

\begin{document}
   Hello World, this is \LaTeX

   \LaTeX 中文文字測試
\end{document}