문서 및 브라우저 탭

가운데 영역의 탭이 터미널만 있는 것은 아닙니다. 이 장에서는 다른 두 종류의 탭, 즉 문서 탭(내장 Markdown 및 코드 편집기)과 브라우저 탭(내장 웹 페이지)을 설명합니다. 두 탭은 세션 탭과 같은 탭 바를 사용하며, 세션을 열어도 이 탭들은 대체되지 않습니다.

1. 문서 탭

1.1 열기

다음과 같은 경우에 문서 탭이 열립니다.

• 세션에서 vopen <file>을 실행할 때(설정 ▸ 일반에서 "Vela Skills"를 설치하면 Claude Code 안에서 /vopen 스킬로도 같은 작업을 할 수 있음)
• 오른쪽 패널의 파일 탭에서 파일을 두 번 클릭하거나 "편집기에서 열기"를 선택할 때
• 지식 베이스에서 노트를 열 때(로컬 지식 베이스 참조)
• 탭 바 오른쪽 끝의 "새 문서"를 클릭할 때

보기는 파일 유형에 따라 선택됩니다.

1.2 Markdown 편집기

• 비주얼은 보이는 그대로 편집하는(WYSIWYG) 편집기입니다. /를 입력하면 삽입 메뉴(제목, 목록, 작업 목록, 인용문, 코드 블록, 표, 수식, 이미지, 구분선)가 열립니다. 펜스로 감싼 mermaid 코드 블록은 블록 아래에 다이어그램으로 렌더링됩니다.
• 소스는 YAML 머리말을 포함하여 파일에 저장된 텍스트를 그대로 표시하며, Markdown 구문 강조를 적용합니다.
• 비교는 비주얼과 소스를 나란히 표시하며, 어느 쪽을 편집하든 두 화면을 동기화합니다.
• ⌘/(Windows와 Linux에서는 Ctrl+/)를 누르면 비주얼 모드와 소스 모드가 전환됩니다. 편집하지 않고 모드만 전환하면 파일은 변경되지 않습니다.
• 저장된 문서에 이미지를 붙여 넣거나 끌어다 놓으면 문서 옆의 assets 폴더에 이미지가 저장되고, 해당 이미지에 대한 상대 링크가 삽입됩니다.

1.3 편집과 저장

• ⌘S를 누르거나 "저장" 버튼을 클릭하면 파일이 디스크에 저장됩니다. 탭의 점은 저장하지 않은 변경 사항이 있음을 나타냅니다.
• 활성 문서는 2초마다 디스크를 확인합니다. 다른 프로그램이 파일을 변경하면 "다시 불러오기"와 "무시" 버튼이 있는 배너가 표시되며, 저장하지 않은 편집 내용이 있으면 다시 불러오기 버튼이 "다시 불러오기 (내 변경 버리기)"로 바뀝니다. 편집을 시작한 뒤 디스크의 파일이 변경되었다면, 저장할 때 파일을 덮어쓰기 전에 "저장 충돌" 대화 상자에서 확인을 요청합니다.
• 저장하지 않은 변경 사항이 있는 탭을 닫으면 "저장하고 닫기", "저장하지 않고 닫기", "취소" 중에서 선택해야 합니다.
• ⌘F를 누르면 찾기, 바꾸기, 모두 바꾸기, "대/소문자 구분"이 있는 검색 표시줄이 열리며, 모든 모드에서 같은 방식으로 동작합니다.
• "사이드바" 버튼을 누르면 문서의 "개요"와 문서가 있는 폴더의 "파일 트리"가 표시되며, 파일 트리에서 파일을 클릭하면 해당 파일이 열립니다. 사이드바의 크기는 조절할 수 있습니다.
• 10MB보다 큰 파일은 읽기 전용으로 열리고 처음 10MB만 표시됩니다. 따라서 저장하더라도 파일의 나머지 부분이 잘리지 않습니다.
• 문서 탭을 마우스 오른쪽 버튼으로 클릭하면 일반적인 닫기 항목 외에 "파일 새로고침"이 표시되며, Markdown 문서에서는 "PDF로 내보내기"도 표시됩니다.

1.4 새 문서와 PDF 내보내기

• "새 문서"를 누르면 아직 디스크에 저장되지 않았고 프로젝트 트리에도 표시되지 않는 빈 초안이 열립니다. 처음 저장할 때 저장 위치를 묻습니다. 데스크톱 앱은 시스템의 다른 이름으로 저장 대화 상자를 사용하고, 브라우저 클라이언트와 원격 연결 창은 세션을 실행하는 컴퓨터에 저장하는 다른 이름으로 저장 대화 상자를 표시합니다. 구문 강조는 선택한 파일 이름에 따라 적용됩니다. 초안 탭을 마우스 오른쪽 버튼으로 클릭하면 "디스크에 저장…"도 선택할 수 있습니다.
• "PDF로 내보내기"는 Markdown 문서를 자동 페이지 나누기와 CJK 글꼴 포함을 적용한 벡터 PDF로 변환합니다. 데스크톱 앱은 파일을 저장할 위치를 묻고, 브라우저 클라이언트는 파일을 내려받습니다.

2. 브라우저 탭(데스크톱 앱 전용)

브라우저 탭은 VelaTerm 안에 실제 웹 페이지를 표시하므로, 기술 문서, 이슈 페이지, 로컬 미리 보기를 세션 옆에 띄워 두는 데 유용합니다. 브라우저 탭은 데스크톱 앱에서만 사용할 수 있으며, 브라우저 클라이언트, 원격 연결 창, 모바일 레이아웃에서는 사용할 수 없습니다.

브라우저 탭을 여는 방법:

• 탭 바 오른쪽 끝의 "내장 브라우저" 버튼
• ⌘⇧B 단축키
• 세션에서 vopen <URL> 실행
• 사이드바에서 프로젝트 또는 그룹의 컨텍스트 메뉴에 있는 "새 브라우저 페이지"

도구 모음: "뒤로", "앞으로", "새로고침"(페이지를 불러오는 동안에는 "로드 중지"), 주소 표시줄("URL 또는 검색어 입력", 주소가 아닌 텍스트는 Google에서 검색), "시스템 브라우저에서 열기", 그리고 ChatGPT, Claude, Gemini, Google이 있는 "빠른 실행" 행으로 구성됩니다.

두 가지 형태:

• 브라우저 탭: 버튼, ⌘⇧B 또는 vopen <URL>로 엽니다. 프로젝트 트리에 저장되지 않으며, 앱을 다시 시작하면 사라집니다.
• 브라우저 페이지 노드: "새 브라우저 페이지"로 만듭니다. 주소를 기억하는 프로젝트 트리의 노드이며, 앱을 다시 시작해도 남아 있습니다.

새 창을 여는 링크: 페이지가 링크를 새 창에서 열려고 하면(예: target="_blank" 링크) VelaTerm은 해당 링크를 새 브라우저 탭에서 엽니다.

독립 페이지: 탭 바 오른쪽 끝의 "게임 센터" 버튼을 누르면 VelaTerm 게임 센터가 독립 페이지로 열립니다. 독립 페이지에는 주소 표시줄과 빠른 실행 행이 없고 "뒤로", "앞으로", "새로고침"만 있으며, 페이지에서 여는 링크는 같은 탭에서 열립니다.

보안 경계: 내장 페이지는 일반 외부 웹사이트로 취급됩니다. VelaTerm의 권한이나 인증 정보를 전혀 받지 않으며, http 및 https 주소만 열 수 있습니다.

3. 여러 종류의 탭이 함께 동작하는 방식

• 세션 탭, 문서 탭, 브라우저 탭은 하나의 탭 바를 함께 사용하며, ⌘1–9로 모든 탭 사이를 전환할 수 있습니다.
• 트리에서 세션을 열 때는 세션 탭만 재사용하며, 문서 탭과 브라우저 탭은 대체되지 않습니다.
• 문서 탭과 브라우저 탭은 분할할 수 없습니다. ⌘W를 누르면 바로 닫힙니다(저장하지 않은 변경 사항이 있는 문서는 먼저 확인을 요청합니다).