콘텐츠로 이동
Oleaflyv0.4.12

macOS, Windows, Linux에 Oleafly를 설치하고, 처음 사용할 때 앱이 무엇을 내려받을 수 있는지 알아봅니다.

Oleafly 설치는 내려받아 더블 클릭하는 것으로 끝납니다. 계정도, 로그인도, 별도의 LaTeX 배포판도 필요하지 않습니다. 컴파일러가 앱 안에 들어 있습니다.

릴리스 페이지 (새 탭에서 열림)에서 최신 설치 프로그램을 받거나, oleafly.com의 다운로드 버튼을 사용하세요. 가능하면 사용 중인 플랫폼에 맞는 설치 프로그램으로 연결됩니다.

플랫폼다운로드할 일
macOS (Apple Silicon)_aarch64.dmgM1 이상. dmg를 열고 Oleafly를 응용 프로그램 폴더로 끌어다 놓습니다.
macOS (Intel)_x64.dmgIntel Mac용. dmg를 열고 Oleafly를 응용 프로그램 폴더로 끌어다 놓습니다.
Windows (x86_64).msi 또는 -setup.exe둘 중 하나를 실행하고 안내를 따릅니다.
Linux (x86_64).AppImage, .deb 또는 .rpm대부분의 배포판에서는 AppImage를, Debian 계열 시스템에서는 Debian 패키지를, Fedora에서는 RPM을 사용합니다.
Linux (ARM64).AppImage, .deb 또는 .rpmARM64 Linux 시스템용 네이티브 패키지입니다.

Linux에서 Oleafly에는 glibc 2.35 이상이 필요합니다(2022년 이후 배포판: Ubuntu 22.04 이상, Fedora 36 이상, Debian 12 이상).

어떤 Mac인지 모르겠다면 Apple 메뉴에서 이 Mac에 관하여를 선택하세요. 칩 항목이 있으면 Apple Silicon이고, 프로세서 항목에 Intel이라고 표시되면 Intel Mac입니다.

현재 제공하는 대상은 macOS Apple Silicon, macOS Intel, Windows x64, Linux x64, Linux ARM64입니다. Windows on ARM용 네이티브 패키지는 아직 없습니다.

디스크 이미지를 열고 Oleafly를 응용 프로그램 폴더로 끌어다 놓은 다음 실행하세요. 공식 설치 프로그램을 사용하세요. macOS가 실행을 막으면 시스템 설정 → 개인정보 보호 및 보안에서 처음 실행 안내 메시지를 확인하세요.

MSI나 setup 실행 파일을 실행하고 설치 프로그램의 안내를 따르세요. Windows가 평판 경고를 표시하면, 계속하기 전에 공식 릴리스에서 받은 파일인지 확인하세요. 설치 프로그램은 Typst와 LaTeX 언어 서버에 필요한 Microsoft Visual C++ 런타임 파일을 앱 옆에 두므로 따로 설치하지 않아도 됩니다.

패키지 관리자로 Debian 또는 RPM 패키지를 설치하거나, AppImage에 실행 권한을 주고 여세요.

터미널 창
chmod +x Oleafly_*.AppImage
./Oleafly_*.AppImage

Oleafly에는 glibc 2.35 이상이 필요합니다. 컴퓨터의 아키텍처에 맞는 패키지를 고르세요.

.deb와 .rpm 패키지는 Oleafly 자체의 Tectonic, Pandoc, Typst를 /usr/libexec/oleafly에 두므로, 배포판의 Pandoc과 나란히 설치됩니다. AppImage를 시작하면 스스로를 애플리케이션 메뉴에 추가하는데, GNOME 같은 Wayland 데스크톱은 이 항목이 있어야 독에 아이콘을 표시합니다. 설치된 패키지나 다른 도구가 이미 Oleafly를 추가해 두었으면 메뉴를 건드리지 않으며, 항목을 삭제하면 삭제된 상태로 남습니다.

Debian 패키지에는 설명이 들어 있어서 Ubuntu의 App Center가 설치 전에 Oleafly가 무엇인지 보여 줍니다. AppStream 데이터도 들어 있어서 설치한 뒤에는 소프트웨어 센터가 아이콘, 라이선스, 스크린샷, 버전을 표시합니다. 앱은 앱 메뉴의 Office 아래에 나타납니다. Linux에서는 Windows와 마찬가지로 Oleafly가 자체 제목 표시줄을 그립니다. 도구 모음이 최소화, 최대화, 닫기 버튼과 함께 맨 위에 있습니다. 도구 모음을 끌면 창이 이동하고, 더블 클릭하면 최대화되며, 가장자리나 모서리를 끌면 크기가 바뀝니다.

첫 컴파일에서 TeX 패키지를 내려받습니다

섹션 제목: “첫 컴파일에서 TeX 패키지를 내려받습니다”

번들된 Tectonic 엔진으로 문서를 처음 컴파일하면 그 문서에 필요한 패키지를 내려받아 캐시합니다. 한 컴퓨터에서 처음 컴파일할 때는 자주 쓰는 패키지도 한꺼번에 가져오므로 이후 문서가 더 빨리 시작됩니다. 네트워크 연결이 필요하며 느린 회선에서는 몇 분쯤 걸릴 수 있습니다. 패키지가 아직 도착하는 동안에는 컴파일 제한 시간이 늘어나며, Oleafly의 패키지 미러가 실패하면 컴파일이 업스트림 소스로 넘어갑니다. 같은 문서를 이후에 컴파일하면 빠르고 오프라인에서도 됩니다. 아직 캐시하지 않은 패키지가 필요한 문서는 한 번 더 내려받게 됩니다. 엄격한 오프라인 모드를 포함해 컴파일을 참고하세요.

Tectonic으로 대부분의 문서를 다룰 수 있습니다. 프로젝트에 pdfLaTeX, upLaTeX 또는 전체 TeX 배포판의 다른 컴파일러가 필요하면, Oleafly는 컴퓨터에 이미 있는 MacTeX, TeX Live, MiKTeX, TinyTeX를 씁니다. 없으면 설정 → 엔진 → LaTeX에서, 또는 컴파일 오류에서 바로 TinyTeX를 설치할 수 있습니다. TinyTeX는 관리자 권한이 필요 없고, 다운로드는 약 250 MB이며, Oleafly는 여유 디스크 공간 약 2 GB를 요구합니다.

  • Linux에서 TinyTeX는 시스템 Perl을 씁니다. 없다면 먼저 설치하세요. sudo apt install perl, sudo dnf install perl, sudo pacman -S perl 중 하나입니다.
  • Windows에서 MiKTeX가 latexmk를 실행하려면 Perl이 필요합니다. Strawberry Perl을 설치하거나, 자체 Perl이 딸린 TinyTeX를 설치하세요.
  • Debian, Ubuntu, Fedora에서 apt나 dnf로 설치한 TeX Live는 LaTeX 패키지도 apt나 dnf로 받습니다. Oleafly는 무엇을 설치할지 알려 줄 뿐 직접 바꾸지는 않습니다.

LaTeX 엔진과 패키지를 참고하세요.

파일은 디스크에 일반 폴더로 남습니다. 토큰과 AI 키는 소유자만 접근할 수 있는 암호화된 로컬 파일에 저장됩니다. 온라인 기능에는 호스팅된 AI, GitHub 동기화, 패키지 다운로드, 인용 조회, 업데이트 확인이 있습니다. Oleafly를 만드는 이유를 참고하세요.

Oleafly는 서명된 릴리스 피드를 확인하고, 릴리스 노트를 보여 주고, 확인하면 제자리에서 설치합니다. Linux에서는 AppImage로 설치한 경우 자동 교체가 동작합니다. 설정 → 도움말 및 정보에서 직접 확인할 수도 있습니다. 업데이트를 참고하세요.

전제 조건, 엔진 다운로드, 로컬 빌드는 데스크톱 개발 가이드 (새 탭에서 열림)를 따르세요.

  • 빠른 시작: 첫 프로젝트에서 첫 PDF까지 몇 분이면 됩니다.
  • 템플릿: 번들된 스타터와 내려받을 수 있는 팩.
  • Oleafly Learn: 웹에서 보는 무료 LaTeX 및 연구 글쓰기 교육 과정.
  • 명령줄 도구: 터미널에서 프로젝트를 빌드, 점검, 동기화하고 코딩 에이전트를 연결합니다.
이미지 미리보기

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

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