LaTeX를 SVG로 변환

KaTeX가 서버에서 수식을 HTML로 조판한 다음, 도구가 그 HTML를 SVG foreignObject에 감싸고 KaTeX 스타일시트 및 수식에 필요한 woff2 글꼴 파일을 데이터 URL로 포함합니다. 너비와 높이는 KaTeX의 글꼴 메트릭과 해당 글꼴의 실제 글리프 너비를 기준으로 정해지므로, 캔버스가 수식에 작은 여백을 더한 크기로 맞춰집니다.

img 요소, CSS 배경, 인라인 SVG 마크업으로 사용하거나 파일을 직접 열 때, 그리고 브라우저 엔진을 기반으로 한 앱에서 Chrome, Edge, Firefox 및 Safari에서 올바르게 표시됩니다. Inkscape, Illustrator, Figma의 SVG 가져오기 기능, librsvg, resvg 같은 벡터 편집기와 변환기는 foreignObject 안의 HTML를 렌더링하지 않아 수식이 표시되지 않습니다.

이 도구의 스택에는 KaTeX의 수식을 글리프 윤곽선으로 배치하는 퍼미시브 라이선스 라이브러리가 없으며, 별도의 조판기를 사용하면 KaTeX의 출력과 일치하지 않습니다. 자체 HTML를 포함하면 정확한 간격과 글꼴이 유지됩니다. 벡터 편집기에서 윤곽선이 필요하다면 브라우저에서 SVG를 열고 PDF로 인쇄하세요. 수식이 편집기에서 가져올 수 있는 벡터 도형으로 유지됩니다.

디스플레이 모드는 수식을 독립된 방정식으로 조판합니다. 큰 연산자의 극한은 위아래에 배치되고, 분수는 원래 크기를 유지하며, \tag 번호를 사용할 수 있습니다. 인라인 모드는 문장 안의 수식에 적합한 간결한 텍스트 스타일을 사용하며, 분수는 더 작아지고 합과 적분의 극한은 옆에 배치됩니다.

수학 글꼴의 크기를 픽셀 단위의 정수로 설정하며, 범위는 8부터 200까지이고 기본값은 24입니다. SVG의 너비와 높이도 함께 조정되므로 48픽셀로 렌더링한 수식은 24픽셀로 렌더링한 수식보다 두 배 큽니다. 결과가 벡터 기반이므로 나중에 CSS로 크기를 조정할 수도 있습니다.

KaTeX 0.19.1에서 지원하는 모든 명령을 사용할 수 있습니다. 분수, 근호, 합과 적분, 행렬, aligned, cases, pmatrix, array 같은 환경, 악센트, 화살표, \mathbb, \mathcal, \mathfrak, \text, \color, \tag를 지원합니다. 수식 안에서 \def 또는 \newcommand로 매크로를 정의할 수도 있습니다. 전체 문서, \usepackage, TikZ 및 mhchem의 \ce 명령은 사용할 수 없습니다.

파일이 생성되지 않으며, 무엇이 잘못되었는지와 오류가 발생한 문자를 알려줍니다. 문자는 1부터 세며, 알 수 없는 명령, 짝이 맞지 않는 중괄호, 중복 위첨자, 인수가 빠진 명령 등을 표시하므로 해당 위치로 바로 이동해 수정할 수 있습니다.

수식은 최대 10,000자까지 가능하고, 매크로는 최대 1,000회까지 확장됩니다. \rule, \kern, \hspace 같은 명령에 지정하는 크기는 100em으로 제한됩니다. \href, \url, \includegraphics처럼 외부 콘텐츠를 불러오거나 연결하는 명령은 비활성화되어 지원되지 않는 빨간색 텍스트로 표시됩니다.

배경은 투명합니다. SVG 마크업을 HTML 페이지에 붙여 넣으면 수식은 주변 요소의 텍스트 색상을 따르고, 이미지 파일로 사용하면 검은색으로 그려집니다. 수식 안에서 \color 또는 \textcolor를 사용하면 어디서나 고정된 색상을 지정할 수 있습니다.

각 파일에는 약 24 KB의 KaTeX 스타일시트와 수식에 사용되는 모든 글꼴이 base64 woff2 형식으로 포함되므로 일반적인 수식의 크기는 75~150 KB입니다. \text 안의 중국어 또는 일본어처럼 KaTeX 글꼴에 없는 문자는 뷰어의 글꼴을 사용합니다. SVG에는 role img가 지정되며, LaTeX 소스가 제목과 스크린 리더용 aria-label로 포함됩니다.