지원

자주 묻는 질문에 대한 답, 그리고 필요할 때는 실제 사람이 도와드립니다.

도움이 필요하신가요? 메시지를 보내 주세요. macOS 또는 iOS 버전과, 버그라면 문제가 생기기 직전에 무엇을 했는지 함께 적어 주세요. 대개 그것만으로도 문제를 재현해 빠르게 고칠 수 있습니다.

시작하기

Folio Writer 프로젝트란 정확히 무엇인가요?

프로젝트는 평범한 폴더(.folio 패키지)입니다. 문서는 일반 Markdown 및 Typst 파일로, 참고문헌은 .bib 파일로 들어 있고, 바인더 구조를 기록하는 작은 folio.json이 함께 있습니다. 데이터베이스에 숨겨진 것은 없습니다. 어떤 편집기로든 파일을 열고, 백업하고, 어디로든 옮길 수 있습니다.

프로젝트는 어떻게 만들거나 여나요?

처음 실행할 때 새 프로젝트를 선택하거나(템플릿과 위치 선택) 열기로 기존 .folio 폴더를 여세요. iPhone과 iPad에서는 프로젝트 선택기로 iCloud Drive, 나의 iPhone 또는 연결된 파일 위치에 프로젝트를 만들거나, 이미 있는 프로젝트를 열 수 있습니다.

기기 간 동기화

동기화는 어떻게 작동하나요?

프로젝트를 동기화되는 폴더(iCloud Drive, Dropbox 또는 모든 파일 제공자)에 두고 각 기기에서 여세요. Folio Writer는 파일을 그 자리에서 읽고 쓰며, 기기 간 이동은 클라우드 서비스가 맡습니다. 두 기기에서 동시에 한 편집은 겹치지 않으면 자동으로 병합되고, 진짜 충돌이 일어나면 밀려난 사본도 보존되므로(절대 버리지 않음) 복구할 수 있습니다.

문서를 삭제했는데 다시 나타나요. 또는 “다른 Mac에서 변경됨”이 표시돼요.

최근 버전에서 집중적으로 해결한 동기화의 예외적인 경우입니다. 모든 기기에서 최신 버전을 실행하고 있는지 확인한 다음, 각 기기에서 프로젝트를 한 번씩 열어 다른 기기의 변경 사항을 볼 수 있게 하세요. 그래도 계속되면 OS 버전과 사용하는 클라우드 서비스를 적어 이메일을 보내 주세요.

내 글이 Folio Writer 서버로 전송되나요?

아닙니다. Folio Writer에는 서버도 계정도 없습니다. 파일은 내 저장 공간에 그대로 있습니다. 자세한 내용은 개인정보 처리방침을 참고하세요.

인용 및 컴파일

인용은 어떻게 작동하나요?

.bib 파일을 프로젝트의 Bibliography 폴더에 넣으세요. 저자, 연도 또는 키로 인용을 삽입하면 편집기에서 인라인으로 렌더링되고, 컴파일할 때 서식화된 참고문헌 목록으로 해석됩니다. 묶음 인용과 쪽 위치 지정([@smith2020, p. 33])도 지원합니다.

어떤 형식으로 컴파일할 수 있나요?

pandoc과 Typst를 통해 PDF, Word(.docx), LaTeX, Typst, HTML, Markdown으로 컴파일할 수 있습니다. 표지, 그림, 상호 참조, 참고문헌이 일반 텍스트 소스에서 조립됩니다.

pandoc, LaTeX, Typst, Quarto로는 어떻게 컴파일하나요?

Folio Writer는 Apple의 샌드박스에서 실행되며, 샌드박스에서는 외부 프로그램을 직접 실행할 수 없습니다. 무료 Folio Helper를 설치하세요. Mac에 이미 있는 조판 도구(pandoc, pandoc-crossref, LaTeX, Typst, Quarto)를 Folio Writer 대신 실행해 주는 작은 도우미 앱입니다. 응용 프로그램 폴더에 넣고 한 번 열면, 컴파일 ▸ 외부 도구 설정…에 찾은 모든 도구가 표시됩니다.

아직 도구가 없나요? 터미널에서 명령 하나로 설치하세요. pandoc, pandoc-crossref, Quarto, Typst, LaTeX 엔진을 고를 수 있는 메뉴가 나타납니다.

curl -fsSL https://foliowriter.app/install-folio-tools.sh | bash

컴파일이 실패하거나 도구를 찾을 수 없어요.

컴파일 ▸ 외부 도구 설정…을 열고 다시 검사를 누르세요. 패널에 Folio Helper가 찾은 도구가 경로, 버전과 함께 나열되고, 여전히 실패하는 항목을 위한 진단 정보 복사 버튼도 있습니다. Homebrew, MacTeX, TinyTeX로 설치한 도구는 자동으로 찾습니다. 인용 참조가 해석되지 않으면 해당 키가 .bib 파일 중 하나에 있는지 확인하세요.

iPhone과 iPad 동반 앱

동반 앱으로 무엇을 할 수 있나요?

같은 프로젝트를 열고, Markdown 키 막대로 편집하고, 바인더를 탐색하고 재구성하고, 스냅샷을 찍고 복원하고, 여러 문서에 걸쳐 검색하고, 인용을 삽입하고, 렌더링된 문서를 (수식과 함께) 미리 볼 수 있습니다. PDF/Word로 컴파일하는 것은 Mac에서 합니다. 해당 도구들이 데스크톱 전용이기 때문입니다. 하지만 작성한 내용은 모두 곧바로 다시 동기화됩니다.

파일이 “다운로드 중…”으로 표시되고 열리지 않아요.

iCloud가 파일을 실제로 내려받는 중입니다. 연결 상태가 좋으면 보통 금방 해결됩니다. 멈춰 있다면 파일 앱에서 같은 폴더를 열어 다운로드를 재촉한 다음 Folio Writer로 돌아오세요.

여전히 해결되지 않나요?

버그를 신고하거나 기능을 요청하려면 어떻게 하나요?

문의 양식을 이용해 간단한 설명, OS 버전, 그리고 버그라면 문제를 일으킨 단계를 보내 주세요. 기능 요청은 실제로 꼼꼼히 읽으며, 다음에 무엇을 만들지 정하는 데 반영됩니다.