RibbonDiff — 지원

문의

지원팀에 문의할 때는 macOS 버전과 다음 위치에 표시되는 앱 버전을 포함해 주세요: RibbonDiff → About (또는 App Store의 “Version History”).

Pro 접근 권한(Limited / Pro Trial / Pro Lifetime)

RibbonDiff는 무료로 다운로드할 수 있으며 Limited 모드에서는 입력하거나 붙여넣은 텍스트를 비교할 수 있습니다. 파일 열기/저장, Workspace 및 Workspace 파일 검색, Version History는 Pro에서 사용할 수 있습니다.

Limited(무료)

양쪽 페인에서 입력하거나 붙여넣은 텍스트를 비교하고 편집합니다.
실시간 diff 업데이트, 중앙 ribbon 연결선, 페인별 Find, word wrap, 테마를 제공합니다.

Pro(Trial 또는 Lifetime)

디스크에서 파일 열기(⌘O), Finder, Terminal 또는 드래그 앤 드롭
페인별 Save / Save As…(⌘S / ⇧⌘S)
폴더 또는 .rd-workspace 문서를 Workspace 사이드바에서 열고 Workspace 문서 저장(⇧⌥⌘S)
Find in Workspace…(⇧⌘F)로 열린 Workspace 안의 텍스트 검색, Option-click으로 결과를 다른 탭에서 열기
인라인 이름 변경으로 새 Workspace 파일 또는 폴더를 만든 다음 사이드바에서 이동, 삭제, Finder 표시, 경로 복사
Git 기반 Workspace 안의 파일에서 읽기 전용 과거 미리보기와 함께 Version History 사용
선택적 페인별 Line Endings 및 Encoding 컨트롤(Settings에서 활성화한 경우)

Pro Trial(7일) 시작하기

열기: RibbonDiff → Settings… → Pro를 연 다음 클릭: Start 7-Day Pro Trial. Trial은 1회 한정이며, 7일 동안 지속되고 자동 갱신되지 않습니다.

Pro Lifetime 잠금 해제하기

열기: RibbonDiff → Settings… → Pro를 연 다음 클릭: Unlock Pro Lifetime. 이는 1회성 구매입니다.

Restore Purchases

재설치하거나 Mac을 바꾼 뒤 Pro 접근 권한이 나타나지 않으면 다음으로 이동하세요: Settings → Pro → Restore Purchases.

이전 유료 고객: RibbonDiff가 유료 App Store 다운로드였을 때 구입했다면 같은 Apple ID에서 자동으로 Pro Lifetime 이 잠금 해제되어야 합니다. 그렇지 않으면 Restore Purchases.

빠른 도움말

전체 문서: 자세한 워크플로와 단축키는 사용자 가이드 에서 확인하세요.
단축키 목록: 선택: Help → RibbonDiff Help (⌘?)를 눌러 내장 단축키 참조 창을 엽니다.
텍스트 비교: 왼쪽과 오른쪽 페인에 붙여넣거나 입력합니다. diff는 자동으로 업데이트됩니다.
파일 열기 (Pro): 파일을 페인에 드래그 앤 드롭하거나 페인을 클릭한 다음 누릅니다: ⌘O.
새 비교: 선택: File → New Window (⌘N)로 새 독립 비교 창을 열고, File → New Window with Sidebar (⇧⌘N)로 Workspace 사이드바가 열린 창을 열거나, ⌘T 로 현재 창 그룹에 새 탭을 만듭니다.
Workspace (Pro): 사용: File → Open Workspace… (⇧⌘O)로 폴더 또는 .rd-workspace 문서를 새 독립 창에서 엽니다. 또는 사이드바의 Open Folder or Workspace File 동작으로 Workspace를 현재 창에 연결합니다.
Workspace 파일 검색 (Pro): Find → Find in Workspace…(⇧⌘F)를 선택해 열린 Workspace의 텍스트 파일을 검색합니다. View → Show File Tree(⌘1)와 View → Show File Search(⌘2)로 사이드바 모드를 전환합니다. 검색은 탭 사이를 이동해도 계속 표시되고, 검색어와 펼친 결과를 유지하며, Git 수정 파일에 M 표시를 보여 주고, Option-click으로 결과를 다른 탭에서 열 수 있습니다.
Workspace 파일 관리 (Pro): 사이드바 동작 메뉴 또는 폴더/파일 우클릭 메뉴에서 파일/폴더를 추가하고, 새 탭에서 파일을 열고, Finder에 항목을 표시하고, 상대 경로나 전체 경로를 복사하고, 여러 항목을 선택하고, 폴더로 드래그 이동하거나, 확인 후 삭제 항목을 휴지통으로 이동할 수 있습니다.
Version History (Pro): Git 기반 Workspace에서 파일을 연 다음 브랜치 및 버전 선택기를 사용해 현재 파일을 읽기 전용 과거 스냅샷과 비교합니다.
Save (Pro): 페인 안을 클릭해 활성화한 다음 사용: ⌘S / ⇧⌘S. 저장은 항상 활성 페인에 적용됩니다. Workspace 문서를 저장하려면 Save Workspace / Save Workspace As… 를 사용하세요.
디스크의 파일 변경: 열린 파일이 디스크에서 변경되면 미저장 편집이 없을 때 RibbonDiff가 자동으로 다시 읽고, 앱 안의 변경을 교체하기 전에는 확인을 요청합니다.
각 페인에서 찾기: 페인별 Find 필드를 사용하거나 ⌘F를 누른 다음, ⌘G/⇧⌘G로 일치 항목 사이를 이동합니다.
Word wrap: 긴 줄에서 가로 스크롤을 피하려면 wrap을 전환합니다.
Whitespace 필터: 사용: Whitespace 툴바 토글 또는 View → Whitespace Filters (⌃⌘I)로 저장된 들여쓰기/leading/trailing whitespace 비교 필터를 함께 켜거나 끕니다.
Line Endings / Encoding (선택): 다음에서 배지를 활성화하세요: Settings → General. 이 설정은 저장 시 파일이 기록되는 방식에 영향을 주지만, diff에서는 정규화됩니다(LF와 CRLF만으로는 보통 diff가 생기지 않습니다).
Themes: diff 색상/배경을 사용자화하고 테마를 JSON으로 가져오거나 내보냅니다.
여러 비교: 새 창이나 macOS 창 탭을 사용해 여러 diff를 열어 둘 수 있습니다. Workspace가 열려 있으면 해당 창의 모든 탭이 같은 사이드바와 프로젝트 트리를 공유합니다.

Preferences / Settings

Settings 열기
메뉴 막대에서 선택: RibbonDiff → Settings… (단축키: ⌘,).

사용할 수 있는 섹션

Pro: 접근 수준을 확인하고, 포함된 기능을 보고, 7일 Trial을 시작하고, Pro Lifetime을 잠금 해제하거나 구입을 복원할 수 있습니다. Limited 모드에서 파일 열기/저장, Workspace 또는 Workspace 파일 검색, Version History 같은 Pro 전용 워크플로를 시도하면 RibbonDiff가 Pro 안내를 표시합니다.
General: 줄 번호(페인별), 기본 word wrap, 저장된 공백 필터 기본값, 선택적 Line Endings / Encoding 배지, Workspace 항목 크기와 줄 높이를 설정합니다.
Appearance: diff 하이라이트 색상(Added/Removed/Modified)과 중앙 연결선(“ribbon”) 색상을 조정합니다.
Backgrounds: 선택: System 배경(Light/Dark Mode를 따름) 또는 Custom 색상으로 전환합니다.
Syntax: 사용자 구문 색상을 활성화하고 Light/Dark 팔레트를 따로 편집합니다.
테마: 내장 테마와 직접 저장한 테마 사이를 전환합니다.

테마 가져오기(JSON)
이동: Settings → Theme에서 Import Theme…를 클릭한 다음 선택: .json 파일. 가져온 테마는 다음 아래에 표시됩니다: User Themes.

테마 내보내기(JSON)
이동: Settings → Theme에서 Export Theme…를 클릭하고 이름을 지정한 다음 저장할 위치를 선택합니다: .json 파일.

팁: 테마를 가져왔지만 목록에 보이지 않으면 Settings를 닫았다 다시 열고 Theme 섹션을 다시 확인하세요.

문제 해결

파일 열기 / 드래그 앤 드롭 / 저장, Workspace, Workspace 파일 검색 또는 Version History를 사용할 수 없습니다

파일 열기/저장, Workspace 사용, Workspace 파일 검색은 Pro 워크플로입니다. Version History도 Pro 전용이며 Git 기반 Workspace 안의 파일에만 나타납니다. RibbonDiff → Settings… → Pro에서 Pro Trial 또는 Pro Lifetime 상태인지 확인하세요. 이미 구입했다면 Restore Purchases를 사용하세요.

Pro Trial이 끝나면 어떻게 되나요?

7일 후 RibbonDiff는 Limited 모드로 돌아갑니다. 파일 열기/저장 워크플로, Workspace, Workspace 파일 검색, Version History는 다시 비활성화되지만 입력하거나 붙여넣은 텍스트 비교는 계속할 수 있고 Pro Lifetime을 잠금 해제할 수 있습니다.

Workspace가 접힌 상태로 있거나 업그레이드 안내가 표시됩니다

Workspace는 Pro 기능입니다. RibbonDiff가 업그레이드 안내를 표시하면 다음에서 Pro Trial을 시작하거나 Pro Lifetime을 잠금 해제하세요: RibbonDiff → Settings… → Pro. 현재 창에 Workspace가 이미 열려 있다면 탭마다 별도의 Workspace를 기대하지 말고 해당 공유 사이드바를 사용하세요.

Workspace 파일 관리가 완료되지 않습니다

새 Workspace 항목 이름은 비워 둘 수 없고, /를 포함할 수 없으며, 같은 폴더의 다른 항목과 중복될 수 없습니다. 드래그 이동 대상은 Workspace 안의 폴더여야 합니다. RibbonDiff는 변화 없는 이동, 항목 자기 자신이나 하위 폴더로의 이동, 중복 이름 충돌을 막습니다. 삭제는 확인된 파일과 폴더를 휴지통으로 이동합니다.

Workspace 파일 검색에 결과가 없습니다

Workspace 파일 검색은 열린 Workspace가 필요하며 해당 Workspace 안의 텍스트 파일을 검색합니다. Pro Trial 또는 Pro Lifetime 상태인지, Workspace가 열려 있는지, 검색 텍스트가 읽을 수 있는 텍스트 파일 안에 있는지 확인하세요. 탭 사이를 이동하거나 파일 트리에서 돌아와도 RibbonDiff는 현재 검색어, 결과, 펼친 파일, 스크롤 위치를 유지합니다. 바이너리, 읽을 수 없는 파일 또는 매우 큰 파일은 건너뛸 수 있습니다.

Version History를 사용할 수 없습니다

Version History는 Pro 전용 Workspace 기능. 현재 파일이 다음 안에 있을 때만 나타납니다: Git 기반 Workspace. 파일이 Workspace 밖에 있거나 Workspace가 Git 기반이 아니면 브랜치 및 버전 선택기가 나타나지 않을 수 있습니다.

Open Workspace…가 새 창을 열었습니다

이는 정상 동작입니다. File → Open Workspace… 는 항상 선택한 폴더 또는 .rd-workspace 문서를 새 독립 창에서 엽니다. 대신 현재 창의 비교를 Workspace로 교체하려면 사이드바의 Open Folder or Workspace File 동작을 사용하거나 폴더 / .rd-workspace 파일을 사이드바에 놓으세요.

Wrap / Whitespace / Swap / Clear가 사라졌습니다

상단 툴바 행이 숨겨져 있을 수 있습니다. 선택: View → Show Toolbar 또는 누르기: ⌥⌘T 을 눌러 다음을 포함해 복원합니다: Whitespace 토글. 편집기 내용, Workspace, diff는 변경되지 않습니다.

열려 있는 동안 디스크의 파일이 변경되었습니다

RibbonDiff는 이제 다음 상태일 때 변경된 파일을 자동으로 다시 읽습니다: 미저장 편집 없음 앱 안에 미저장 편집이 있는 경우 RibbonDiff는 앱 안의 변경을 새 디스크 내용으로 교체하기 전에 확인을 요청합니다.

Restore Purchases로 Pro가 잠금 해제되지 않았습니다

이 Mac에서 원래 구입에 사용한 동일한 Apple ID 로 로그인되어 있는지 확인하세요. 그런 다음 RibbonDiff를 종료했다 다시 실행하고 다음을 다시 시도하세요: Settings → Pro → Restore Purchases 그래도 실패하면 앱 버전과 macOS 버전을 포함해 지원팀에 이메일을 보내세요(민감한 데이터는 필요하지 않습니다).

파일을 연 뒤 텍스트가 깨져 보입니다(mojibake)

파일이 잘못된 인코딩으로 디코딩되었을 수 있습니다. Encoding 배지를 다음에서 활성화하세요: Settings → General에서 다른 인코딩을 선택한 다음 파일을 다시 여세요.

Line Endings 또는 Encoding을 변경해 파일이 다시 기록되었지만 텍스트는 같아 보입니다

이는 정상 동작입니다. RibbonDiff는 내부적으로 줄 끝/인코딩을 정규화하므로, 배지만 변경해도 보이는 텍스트는 바뀌지 않으면서 파일 저장 세부 정보가 다시 기록될 수 있습니다.

큰 내용을 붙여넣은 뒤 텍스트가 동기화되지 않은 것처럼 보입니다

페인을 클릭한 뒤 한 번 스크롤하거나 Word Wrap을 껐다 켜 레이아웃을 새로고침해 보세요.

매우 큰 텍스트에서의 성능

매우 큰 비교는 계산에 시간이 걸릴 수 있습니다. 느리게 느껴지면 더 작은 섹션을 비교하거나 입력을 나누어 보세요.

테마 가져오기/내보내기 문제

파일이 유효한 JSON이고 RibbonDiff의 테마 형식과 일치하는지 확인하세요. 테마를 가져왔지만 보이지 않으면 Settings를 다시 열고 Theme 메뉴를 확인하세요.

기능 요청 및 피드백

제안은 다음으로 보내 주세요: ribbon@craftclay.com. 가능하면 민감하지 않은 짧은 예제 입력과 기대한 결과를 함께 보내 주세요.