콘텐츠로 이동
Oleaflyv0.4.12

소스 편집과 비주얼 편집, 문서 도구, 초안 옆의 PDF와 함께 LaTeX, Typst, Markdown으로 글을 씁니다.

Oleafly는 소스 편집, 문서 탐색, PDF 미리보기를 하나의 작업 공간에 모았습니다. CodeMirror 기반 편집기는 LaTeX, Typst, Markdown을 지원합니다. 줄 번호, 괄호 일치 표시, 현재 줄 강조는 항상 켜져 있습니다. 긴 줄은 자동으로 줄바꿈되며, 설정 → 모양 → 편집기에서 긴 줄 접기를 끄면 줄바꿈하지 않습니다.

아래 단축키는 macOS 키를 먼저 적었습니다. Windows와 Linux에서는 ⌘를 Ctrl로 읽으세요.

Oleafly에서 LLaMA를 연 모습. 왼쪽에 파일 트리, 가운데에 LaTeX 소스, 오른쪽에 컴파일된 논문이 있습니다.
Oleafly에서 LLaMA를 연 모습. 왼쪽에 파일 트리, 가운데에 LaTeX 소스, 오른쪽에 컴파일된 논문이 있습니다. 전체 스크린샷 열기

문서 엔진마다 툴바와 소스 문법이 다릅니다. 아래 가이드는 모든 컨트롤을 설명하고, 붙여 넣어 바로 컴파일할 수 있는 원고도 담고 있습니다.

세 엔진의 툴바는 모두 같은 배치를 씁니다.

  • 코드 / 비주얼이 맨 앞에 있으며, 열려 있는 파일을 소스 편집과 비주얼 편집 사이에서 전환합니다.
  • 그다음에 실행 취소와 다시 실행이 있습니다. 취소하거나 다시 실행할 내용이 없으면 회색으로 표시됩니다.
  • 가운데에는 서식 버튼과 삽입 버튼이 놓입니다. 폭이 모자라 들어가지 않는 버튼은 어떤 폭에서도 추가 서식 옵션(…)으로 옮겨지므로, 편집기가 좁아져도 컨트롤을 잃지 않습니다.
  • 오른쪽 끝에는 문서 도구가 늘 보입니다. LaTeX 패키지 또는 Typst 패키지(패키지 참고), 문서 분석, 문서 설정, 프로젝트 정보, 찾기, PDF로 이동입니다.

Markdown에는 패키지 버튼이 없습니다. 이 도구들은 ⌘K 팔레트에서도 열 수 있습니다. LaTeX 패키지 찾아보기, Typst 패키지 찾아보기, 문서 분석, 문서 설정입니다.

고정 컨텍스트는 스크롤하는 동안 커서를 둘러싼 절이나 환경을 계속 화면에 보여 줍니다. Typst 파일에서는 커서 위쪽의 제목들이 같은 방식으로 고정됩니다. 설정 → 모양 → 편집기의 고정 스크롤에서 끌 수 있습니다.

.tex와 .typ 파일 위의 이동 경로 표시줄에는 파일 이름과 커서가 놓인 절이 표시됩니다. 항목을 클릭하면 해당 제목으로 이동합니다. 프로젝트 개요를 쓰면 장 사이를 쉽게 오갈 수 있고, 참조 및 인용 탐색을 쓰면 기호 뒤에 있는 소스로 이동합니다. 자동 완성은 패키지를 인식하는 LaTeX 명령, 수식 입력, 인용 상세 정보를 제공합니다.

사이드바의 각 보기는 프로젝트별로 스크롤 위치, 펼친 폴더, 열어 둔 섹션을 기억하므로 같은 자리로 돌아올 수 있습니다.

앱을 어두운 테마로 바꾼 뒤 소스와 PDF만 남는 Zen 모드로 전환하는 모습.
앱을 어두운 테마로 바꾼 뒤 소스와 PDF만 남는 Zen 모드로 전환하는 모습. 전체 스크린샷 열기

Zen 모드는 프로젝트 툴바, 사이드바, 어시스턴트, 터미널, 편집기 자체의 탭과 서식 표시줄을 숨깁니다. 글쓰기 화면만 남고, 편집기는 전체 폭을 그대로 씁니다.

macOS에서는 Ctrl+⌘⇧F, Windows와 Linux에서는 Shift+F11을 눌러 켭니다. 프로젝트 툴바의 배치 메뉴나 macOS 보기 메뉴에서 Zen 모드를 고르거나, ⌘K 팔레트에서 Zen 모드 전환을 실행해도 됩니다. 끄려면 같은 키를 다시 누르거나 Esc를 두 번 누르세요.

Zen 모드에서는 컴파일 버튼이 오른쪽 위 모서리에 놓입니다. PDF가 열려 있으면 PDF 위에 놓이고, 포인터가 가까이 가면 나타납니다. 빌드하는 동안에는 그 자리의 작은 알약 모양 표시에 컴파일 중이라고 나타납니다. 빌드가 실패하면 컴파일 실패라고 표시되며, 클릭하면 컴파일 로그를 보이거나 숨깁니다. ⌘↵로는 여전히 컴파일할 수 있고, ⌘⌥P로는 Zen 모드를 벗어나지 않고 PDF를 보이거나 숨길 수 있습니다.

옵션 두 가지는 설정 → 모양 → 프로젝트에 있습니다. 전체 화면으로 전환은 Zen 모드가 켜져 있는 동안 화면을 가득 채웁니다. 컴파일할 때 PDF 표시는 PDF가 숨겨져 있을 때 컴파일할 때마다 편집기 옆에 PDF를 엽니다. 켜는 키 자체는 설정 → 키보드 단축키에서 바꿀 수 있습니다.

앱이 라이트 모드일 때와 다크 모드일 때 편집기는 서로 다른 테마를 씁니다. 두 테마를 고르고, 소스의 각 부분 색을 바꾸고, 편집기 글꼴, 크기, 줄 높이, 자간, 커서를 설정 → 모양 → 편집기에서 정하세요. 별도의 CJK 글꼴은 한국어, 중국어, 일본어 문자의 글꼴을 정하므로 라틴 문자는 코딩용 글꼴로 둘 수 있습니다. 색은 LaTeX, Typst, Markdown에서 같은 뜻을 갖는 역할을 따릅니다. LaTeX에서는 절 명령과 그 제목이 모두 제목 색을 쓰고, 인용 키와 환경 이름은 해당 명령의 색을 따르며, 수식은 한 가지 색입니다. [@key]와 @key 같은 Markdown 인용은 링크가 아니라 인용으로 강조됩니다.

⌘F를 누르면 편집기 오른쪽 위 모서리에 VSCode 스타일 위젯이 나타납니다.

  • 대소문자 구분(Aa), 단어 단위로 일치(ab), 정규식 사용(.*) 토글
  • 실시간 일치 개수(3 of 41). No results와 Invalid 상태도 표시하며, 아주 큰 문서에서는 2000+까지만 센 뒤 멈춥니다
  • Enter는 다음 일치 항목으로, Shift+Enter는 이전 항목으로 이동하고, Esc는 위젯을 닫습니다
  • 일치 항목 모두 선택은 모든 일치 항목을 커서로 바꿔 동시에 편집할 수 있게 합니다
  • 화살표를 누르면 바꿀 내용 줄이 펼쳐집니다. 다음 항목 바꾸기, 모두 바꾸기, 그리고 원래 토큰의 대소문자를 바꿀 내용에 적용하는 대소문자 유지 토글이 있습니다(예를 들어 figure를 image로 바꾸면 Figure도 Image로 바뀝니다)

⌘A는 화면 밖으로 스크롤된 줄까지 포함해 파일 전체를 선택하므로, 이어서 복사하거나 삭제하면 전부 처리됩니다.

거터의 화살표를 클릭하면 접힙니다.

  • LaTeX에서는 \begin…\end 환경이 하나의 블록으로 접히고(중첩을 인식합니다), 절은 같거나 더 높은 수준의 다음 절까지 접힙니다.
  • Typst에서는 제목이 같거나 더 높은 수준의 다음 제목까지 접힙니다. {…} 코드 블록, […] 콘텐츠 블록, 인수 목록, 수식, raw 블록, 블록 주석도 접힙니다.

뒷부분을 편집하는 동안 앞의 장은 접어 두세요.

⌘/를 누르면 현재 줄이나 선택한 줄을 주석 처리하거나 주석을 풉니다. LaTeX 줄에는 %가, Typst 줄에는 //가 붙습니다. 편집기 밖에서는 같은 키가 단축키 참조를 엽니다.

편집기는 여러 선택 영역을 지원합니다. Alt-드래그로 직사각형(열) 선택을 하고, 찾기 위젯의 일치 항목 모두 선택으로 일치 항목마다 커서를 하나씩 둘 수 있습니다. 모든 커서가 함께 입력하고, 삭제하고, 붙여 넣습니다.

편집기는 입력하는 동안 자동으로 들여씁니다. 한 단계에 공백 네 칸이며, 설정 → 모양 → 편집기의 탭 크기에서 바꿀 수 있습니다. Tab은 들여쓰거나, 열려 있는 자동 완성 제안을 수락합니다. 괄호와 따옴표는 자동으로 닫히고, 백스페이스는 짝을 함께 지우며, 커서 위치에서 짝이 되는 괄호가 강조됩니다.

Typst 파일에는 몇 가지 전용 도우미가 있습니다.

  • $를 입력하면 닫는 $가 함께 들어갑니다. 빈 쌍 안에서 Space를 누르면 디스플레이 수식 $ … $로 바뀝니다. 빈 쌍 안에서 Backspace를 누르면 두 기호가 함께 지워집니다.
  • 텍스트를 선택하고 *, _, `, $를 입력하면 각각 굵은 글씨, 기울임, raw 텍스트, 수식으로 감쌉니다.
  • 목록 항목에서 Enter를 누르면 같은 마커(-, +, /, 또는 숫자)로 다음 항목이 시작됩니다. Shift+Enter는 항목 안에서 새 줄을 시작하고, 빈 마커 바로 뒤의 Backspace는 마커를 지웁니다. Tab은 항목을 한 단계 안쪽으로 중첩하고 Shift+Tab은 다시 바깥으로 꺼냅니다.
  • 줄 맨 앞이나 공백 뒤에 /를 입력하면 Typst 스니펫이 열립니다. 제목, 그림, 표 그림, 표, 수식, 번호 있는 수식, 각주, 인용문, 코드, 개요, 참고문헌, 쪽 나눔, 단, 그리드, 링크, 그리고 세 가지 목록입니다.
  • ⇧⌥F(Shift+Alt+F)는 typstyle로 파일의 서식을 정리합니다. 설정 → 모양 → 편집기의 Typst 아래에서 저장할 때 서식 정리를 켜면 ⌘S를 누를 때마다 서식을 정리합니다. 자동 저장은 서식을 다시 정리하지 않습니다.

$ 짝 맞춤에는 괄호 자동 닫기와 수식 자동 닫기가 모두 필요하고, 선택 영역 감싸기에는 괄호 자동 닫기가 필요합니다. 두 스위치는 모두 설정 → 모양 → 편집기에 있습니다. 목록 키는 항상 켜져 있습니다. 자동 완성, 이름 바꾸기, 정의로 이동, 시그니처 도움말은 Typst 언어 서버가 제공합니다. 자동 완성과 코드 인텔리전스를 참고하세요.

Typst에서 그림, 표, 참조 삽입하기

섹션 제목: “Typst에서 그림, 표, 참조 삽입하기”

Typst에도 LaTeX와 같은 삽입 도구가 있으며, 각 도구는 Typst 코드를 씁니다. Typst 툴바와 편집기의 오른쪽 클릭 메뉴에 있습니다.

  • 그림 삽입은 그림 대화 상자를 엽니다. 프로젝트에서 이미지를 고르거나 가져온 다음 너비, 캡션, 레이블, 대체 텍스트, 배치를 정하세요. 커서가 기존 #figure 안에 있으면 같은 버튼이 그림 편집을 열어 이 항목들을 바꿀 수 있습니다.
  • 이미지 파일을 편집기에 붙여 넣거나 끌어다 놓으세요. Oleafly는 프로젝트에 figures/ 폴더가 있으면 그곳에, 없으면 메인 문서 옆에 이미지를 저장하고 그 이미지를 쓰는 그림을 삽입합니다.
  • 표 삽입은 고른 크기의 빈 표를 추가합니다. 오른쪽 클릭 메뉴의 CSV/XLSX에서 표 만들기… 항목은 CSV, TSV, Excel, JSON 파일을 가져오며, 캡션과 레이블은 선택 사항입니다. 데이터 파일과 연결 유지를 켜면 Oleafly가 데이터를 프로젝트의 data 폴더에 복사합니다. 표는 컴파일할 때마다 그 파일을 읽으므로, 데이터를 고치면 표도 따라 바뀝니다.
  • 프로젝트에서 인용은 프로젝트 참고문헌의 항목에 해당하는 @key를 씁니다. 문서에 #bibliography가 아직 없으면 Oleafly가 하나 추가합니다.
  • 레이블 추가는 커서 위치의 제목, 그림, 수식에 레이블을 붙이거나, 이미 있는 레이블을 선택합니다. 상호 참조 삽입은 프로젝트의 레이블을 나열하고 @label을 씁니다.
  • 수식 버튼은 인라인 수식, 디스플레이 수식, 레이블이 있는 번호 있는 수식, 정렬된 수식을 삽입합니다. 문서에 수식 번호 규칙이 없으면 안내 메시지가 규칙 추가를 제안합니다.
  • 기호는 각 기호를 Typst 이름으로 삽입합니다.

각 툴바 버튼은 Typst로 쓰기에서 다룹니다.

모든 LaTeX, Typst, Markdown 파일의 툴바 맨 앞에는 코드 / 비주얼 스위치가 있습니다. 새 프로젝트는 코드 모드로 열리고, 프로젝트마다 마지막으로 쓴 모드를 기억합니다. Markdown에는 둘 다도 있어서 소스와 서식이 적용된 텍스트를 위아래 또는 좌우로 나란히 보여 줍니다.

LaTeX와 Typst에서 비주얼 모드는 마크업을 제자리에서 그려 주는 같은 편집기입니다. 커서를 제목, 수식, 명령 안에 두면 그 줄에서 소스가 다시 나타납니다. 커서를 옮기면 렌더링된 모습이 돌아옵니다. 파일이 여전히 유일한 원본이므로 줄 번호, 접기, 찾기 및 바꾸기, 맞춤법 검사, 컴파일 오류가 계속 동작합니다. 모든 툴바 버튼은 코드 모드에서 쓰는 것과 같은 소스를 씁니다.

Typst 파일에서 비주얼 모드가 보여 주는 것은 다음과 같습니다.

  • 제목, 굵은 글씨와 기울임 글씨, raw 텍스트, 링크, 색이 있는 텍스트
  • 마커가 있는 글머리표 목록, 번호 목록, 용어 목록
  • Typst가 그리는 인라인 수식과 디스플레이 수식
  • 이미지와 그림(캡션은 일반 텍스트로 표시)
  • 직접 입력할 수 있는 격자 형태의 표. 셀을 선택하면 테두리, 정렬, 행과 열 추가 및 삭제, 표 제거를 위한 툴바가 나타납니다.
  • 칩으로 표시되는 참조와 인용, 작은 표시로 나타나는 각주

Typst 파일 맨 위의 #set, #show, #import, #let 줄은 문서 설정 표시 표시줄로 접힙니다. 클릭하면 그 자리에서 펼쳐집니다. LaTeX 프리앰블도 같은 방식으로 접힙니다.

비주얼 모드는 글을 다듬는 작업에 알맞습니다. 구조를 바꾸거나 사용자 정의 명령을 다룰 때는 코드 모드로 전환하세요. 비주얼 모드가 그리지 못하는 것은 편집 가능한 소스로 화면에 그대로 남습니다.

커서를 수식 안에 두면 렌더링된 결과가 바로 위에 나타납니다. LaTeX 수식은 KaTeX가, Typst 수식은 Typst가 그립니다. 미리보기의 메뉴에서 수식을 벗어날 때까지 숨기거나 아예 끌 수 있습니다. 설정 → 모양 → 편집기의 수식 미리보기에서 다시 켤 수 있습니다.

Typst 파일에 $\frac{a}{b}$ 같은 LaTeX 수식이나 equation 환경을 붙여 넣으면 그 아래에 Typst 수식으로 붙여 넣기 버튼이 나타납니다. 클릭하면 붙여 넣은 내용이 Typst 수식으로 바뀌고, Esc를 누르면 LaTeX 그대로 둡니다. 이미 파일에 있는 수식은 선택한 뒤 오른쪽 클릭 메뉴에서 LaTeX 수식을 Typst로 변환을 고르세요.

컴파일이 실패하면 각 오류가 해당 파일에서 밑줄로 표시됩니다. Typst에서는 밑줄이 Typst가 보고한 정확한 범위를 덮고, 패키지 안에서 발생한 오류는 그것을 호출한 내 파일의 줄을 가리킵니다. 밑줄에 포인터를 올리면 메시지를 읽을 수 있습니다. 알 수 없는 이름, 없는 파일이나 패키지, 닫히지 않은 괄호 같은 흔한 Typst 오류에는 무엇이 잘못되었고 무엇을 확인해야 하는지 쉬운 설명이 함께 나옵니다.

로그 창에는 모든 오류가 소스 줄과 Typst의 힌트와 함께 나열됩니다.

편집기는 입력하는 동안, 컴파일하기 전에 LaTeX 파일의 구조적 문제를 검사합니다.

  • 짝이 되는 \begin이 없는 \end{itemize}, 또는 짝이 맞지 않는 쌍(expected \end{figure}, got \end{table})
  • 닫히지 않은 환경
  • 중복된 \label{} 키
  • 한 줄에 $가 홀수 개 있는 경우(거의 항상 수식 구분자를 빠뜨린 것입니다)

오류에는 빨간 물결선, 경고에는 주황색 물결선이 붙고 거터에 표시가 나타납니다. 린터는 LaTeX만 읽으므로 Typst나 Markdown 컴파일을 막는 일은 없습니다. 실제 LaTeX 실행에서 나온 컴파일 오류는 로그 창에 따로 나타나며, 프리플라이트는 소스 수준의 검사를 인라인으로 덧붙입니다.

활성 파일의 단어, 문자, 줄 수는 ⌘K 팔레트에서 단어 수를 실행해 확인합니다. Typst 파일은 Typst의 규칙으로 세므로 코드와 주석은 합계에서 빠집니다.

설정 → 모양 → 편집기의 키 바인딩에서 Vim 또는 Emacs를 고르거나, ⌘K 팔레트에서 Vim 모드 켜기를 실행하세요. Vim에서는 hjkl, 연산자와 텍스트 객체(dd, ciw), :w, 비주얼 모드를 쓸 수 있습니다. 변경은 바로 적용되며, 이 페이지의 Oleafly 단축키도 함께 계속 동작합니다.

파일은 확장자에 맞는 구문 강조로 열립니다. BibTeX, Markdown, JSON, YAML, TOML, CSS, 셸 스크립트 등이 있습니다. 이미지와 PDF는 텍스트가 아니라 렌더링된 보기로 열리고, 바이너리 형식은 실수로 손상되지 않도록 보호됩니다. 파일과 폴더를 참고하세요.

저장하지 않은 편집 내용이 있는 파일이 디스크에서 바뀌면 파일 이름을 알려 주는 배너가 나타나고 비교, 내 버전 유지, 다시 불러오기를 선택할 수 있습니다. LaTeX, Typst, Markdown 파일 모두 이 배너가 나옵니다.

이미지 미리보기

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

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