콘텐츠로 이동
Oleaflyv0.4.12

문서 도구

CTAN에서 LaTeX 패키지를, Typst Universe에서 Typst 패키지를 검색한 다음 편집기 도구 모음에서 문서에 추가합니다.

LaTeX와 Typst 문서는 추가 기능의 대부분을 패키지에서 얻습니다. 편집기 도구 모음 오른쪽 끝의 패키지 버튼은 프로젝트 언어에 맞는 검색 가능한 목록을 열고, 패키지를 불러오는 줄을 대신 작성해 줍니다. Markdown 프로젝트에는 패키지 버튼이 없습니다.

⌘K 팔레트에서 LaTeX 패키지 찾아보기나 Typst 패키지 찾아보기로도 목록을 열 수 있습니다.

LaTeX 프로젝트에서는 LaTeX 패키지를 선택하세요. CTAN을 패키지 이름이나 설명으로 검색합니다. CTAN에 연결할 수 없거나 오프라인이면 대화상자가 그렇다고 알려 주고 Oleafly 내장 목록을 대신 표시합니다. 새로 고치지 못한 목록에는 내려받은 날짜가 표시됩니다.

각 행에는 다음 레이블이 표시될 수 있습니다.

  • 문서에서 사용 중: 메인 파일이 이미 이 패키지를 불러옵니다.
  • 문서 클래스: 이 항목은 패키지가 아니라 클래스입니다. 클래스는 \documentclass로 지정하므로, 이 행에서는 그 줄을 복사할 수 있지만 추가할 수는 없습니다.
  • 설치됨: TeX 배포판에 이미 이 패키지가 있습니다.

각 행에는 다음 컨트롤도 있습니다.

  • 옵션: margin=2cm 같은 패키지 옵션을 입력하는 필드입니다. 중괄호가 짝을 이뤄야 하고, ]와 %는 쓸 수 없습니다.
  • 프리앰블에 추가: 메인 파일의 프리앰블에 \usepackage[options]{name}을 씁니다. 파일이 이미 패키지를 불러온다면 아무것도 바뀌지 않고 대화상자가 알려 줍니다.
  • 줄 복사: 같은 \usepackage 줄을 복사하며, 클래스라면 \documentclass 줄을 복사합니다.
  • CTAN: CTAN의 해당 패키지 페이지를 엽니다.
  • 설치: TeX 배포판에 없는 패키지용입니다. 아래를 참고하세요.

“설치됨”의 의미는 프로젝트가 컴파일되는 방식에 따라 다릅니다.

  • 내장 컴파일러인 Tectonic은 문서가 처음 사용할 때 패키지를 내려받습니다. 설치할 것이 없으며, 대화상자 맨 위에 그렇게 표시됩니다.
  • TeX Live나 TinyTeX의 latexmk: TeX 배포판에 tlmgr가 있으면 Oleafly가 어떤 패키지가 있는지 확인해 설치됨으로 표시하고 나머지에는 설치를 제공합니다. 설치는 그 패키지 하나에 대해 tlmgr를 실행합니다.
  • Debian, Ubuntu, Fedora의 TeX Live: 시스템 패키지 관리자가 소유하므로, 대화상자는 apt나 dnf로 패키지를 설치하라고 안내하며 설치 버튼은 없습니다.
  • MiKTeX 같은 그 밖의 TeX 환경: Oleafly가 어떤 패키지가 있는지 알 수 없으므로 행에 설치 상태가 표시되지 않습니다. MiKTeX는 MiKTeX Console을 사용하세요.

TeX Live나 TinyTeX에서는 파일을 찾지 못한 컴파일이 오류에 찾아서 설치를 제공하며, 이 버튼은 그 파일이 어느 패키지에 속하는지 알아냅니다. 누락된 파일 복구를 참고하세요.

다시 컴파일 옆의 화살표에서 컴파일러를 고르세요. LaTeX 엔진을 참고하세요.

Typst 프로젝트에서는 Typst 패키지를 선택해 Typst Universe를 둘러보세요. 이름, 키워드, 분류로 검색하거나 분류 칩으로 목록을 좁힐 수 있습니다. 대화상자는 한 번에 최대 100개 패키지를 표시하므로 목록이 길면 검색하세요.

각 행에는 패키지 이름, 최신 버전, 템플릿 패키지에 붙는 템플릿 배지, 짧은 설명이 표시됩니다. 패키지에 프로젝트가 쓰는 것보다 새로운 Typst가 필요하면 행에 필요한 버전이 표시됩니다.

  • import 문 삽입은 열려 있는 .typ 파일 맨 위의 import 문 뒤에 #import "@preview/name:version": *를 추가합니다. 파일이 이미 그 패키지를 가져온다면 버전 번호만 바뀝니다. 편집기에 Typst 파일이 열려 있어야 합니다.
  • import 문 복사는 같은 줄을 복사합니다.

파일의 @preview import가 Typst Universe의 최신 릴리스보다 오래되었으면, 편집기는 “cetz 0.4.2을(를) 쓸 수 있습니다. 이 import 문은 0.3.4을(를) 씁니다.” 같은 힌트로 버전을 표시합니다. 힌트의 0.4.2(으)로 업데이트 동작은 그 자리에서 번호를 바꿉니다.

패키지를 프로젝트와 함께 보관

섹션 제목: “패키지를 프로젝트와 함께 보관”

Typst는 프로젝트가 처음 가져올 때 패키지를 공용 캐시에 내려받습니다. 프로젝트가 자체 사본을 갖게 하려면 대화상자 맨 아래의 프로젝트 패키지를 사용하세요.

  • 프로젝트 폴더의 패키지 사용은 Typst가 프로젝트의 typst-packages 폴더를 먼저 찾게 합니다. 이렇게 설정한 프로젝트는 오프라인에서도 다른 컴퓨터에서도 컴파일됩니다.
  • 패키지를 프로젝트에 포함은 프로젝트가 가져오는 모든 패키지를 캐시에서 typst-packages로 복사합니다. 패키지가 아직 캐시에 없다면 온라인일 때 한 번 컴파일한 다음 다시 포함하세요.

둘 다 Typst 0.12 이상이 필요합니다. Typst 0.11로 고정한 프로젝트에서는 이 섹션이 그렇게 알려 줍니다.

이 섹션에는 프로젝트가 가진 패키지 수도 표시됩니다.

오프라인 모드가 켜져 있으면 대화상자는 마지막으로 내려받은 패키지 목록과 그 날짜를 표시합니다. 내려받은 목록이 한 번도 없다면 온라인이 되기 전까지 표시할 수 없습니다.

  • 편집기: 편집기 도구 모음의 나머지
  • 컴파일: 빌드 중에 패키지를 가져오는 방식
  • 문서 설정: 패키지 코드를 쓰지 않고 바꾸는 용지 크기, 여백, 글꼴
이미지 미리보기

AI 답변을 불러오지 못했습니다

다시 시도하거나 문서를 검색하세요.