시작 페이지
시작 페이지: 자체 편집기 탭에 열리는 Aggrega 자체 페이지로, Aggrega가 무엇인지 설명한 다음 이 작업 영역에서 확장이 필요로 하는 것을 나열하고 각 조건을 Met 또는 To do로 표시합니다. 각 단계는 그것을 만드는 방법과 이미 있는 것을 가리키는 방법을 제공하고 조건을 설명하며, 이미 충족된 단계는 아무것도 묻지 않습니다. Met으로 표시된 단계는 조건이 사라지면 To do로 돌아갑니다. 이미 충족된 단계는 접힌 상태로 열리므로 페이지는 남은 작업을 보여 주며 열립니다. 각 단계는 현재 값(작업 영역 루트, 컴파일러, Release, 레지스트리)도 안내 문구보다 크고 굵게, Selected: 레이블을 앞에 붙여 표시합니다. 단계가 접혀 있으면 제목 아래에, 열려 있으면 버튼 바로 위에 표시되며, 아직 선택하지 않았으면 글로 그렇게 알립니다. 선택할 것이 있으면 None selected. 표시가, 선택할 것이 전혀 없으면 None available. 표시가 나타납니다. 하단에는 페이지를 시작 시 열지 결정하는 체크박스(설정 화면에 있는 것과 같은 스위치)가 있고, 그 아래에 실행 중인 확장과 컴파일러의 버전이, 마지막으로 언어 서버가 실행 중인지와 그것이 보고하는 버전이 있습니다. Commands 패널 제목 표시줄의 집 아이콘으로 언제든 다시 열 수 있습니다. Aggrega 보기의 공간은 차지하지 않습니다.
Welcome to Aggrega! 페이지는 자체 편집기 탭에서 열립니다. Aggrega가 무엇인지 설명한 다음, 열려 있는 작업 영역에서 확장이 필요로 하는 것을 나열합니다.
- Aggrega가 인식하는 작업 영역: 전제 조건에서 설명하는 검색 방식입니다.
- 이 편집기가 실행할 수 있는 컴파일러:
aggrega.server.binaryPath에 지정된aggrega바이너리입니다. - 작업 대상 Release: 빌드, 미리 보기, 토폴로지 그래프는 각각 하나의 Release를 대상으로 합니다.
- 해석에 사용할 레지스트리: 종속성 풀과 게시된 카탈로그 검색은 구성에서 지정한 레지스트리를 기준으로 해석됩니다.
각 단계는 그 조건이 무엇을 위한 것인지와 편집기가 어떻게 그 조건을 충족하는지 설명하므로, 이 페이지는 단순한 체크리스트가 아니라 제품에 관해 읽는 곳이기도 합니다.

각 단계는 진행 방법을 둘 이상 제공하며, 그중 하나는 항상 “이미 가지고 있음”입니다. 작업 영역 구성을 만들거나, 이미 구성이 있는 폴더를 편집기에 지정할 수 있습니다. PATH에 있는 컴파일러를 사용하거나, 다른 곳에 있는 빌드를 선택하거나, 다운로드할 수 있습니다. Release를 초안으로 작성하거나 가지고 있는 Release를 선택할 수 있습니다. 공식 허브를 초기 등록하거나, 자체 레지스트리를 지정하거나, 이미 있는 구성에 레지스트리를 추가할 수 있습니다. 파일 대화 상자만 건네고 단계는 여전히 미완료로 남겨 두는 막다른 길은 없습니다.
이미 충족한 단계는 체크 표시되며 아무것도 묻지 않습니다. 페이지는 모든 사람에게 같은 질문을 하는 대신 실제 상태를 읽으므로, 명령줄에서 구성을 만든 다음 편집기를 열었다면 모든 단계가 체크된 상태로 표시됩니다.
모든 단계는 접을 수 있으며, 페이지는 아직 필요한 것을 보여 주는 상태로 열립니다. 각 단계 오른쪽 위의 캐럿으로 단계를 열고 닫습니다. 조건이 이미 충족된 단계는 접힌 상태로 열리고, 충족되지 않은 단계는 설명이 보이는 상태로 열립니다. 따라서 읽는 내용은 이미 한 작업이 아니라 남은 작업에 관한 것입니다. 접힌 단계도 제목과 모든 버튼을 유지하며 설명만 숨깁니다. 단계의 목적을 알고 나면 설명을 다시 읽지 않고도 그 단계를 실행할 수 있습니다.
이 배치는 페이지가 만들어질 때 정해지며, 그 이후에는 사용자에게 맡겨집니다. 읽는 동안 충족된 단계는 표시가 업데이트되고 열린 상태로 유지됩니다. 커서 아래에서 접히지 않습니다. 또한 누른 캐럿은 주변에서 페이지가 몇 번 새로 고쳐지든 설정한 상태 그대로 유지됩니다. 페이지를 닫았다가 다시 열면 조건을 다시 읽고 배치도 새로 정해집니다. 편집기가 확장을 다시 시작할 때 열려 있던 페이지 대신 그려지는 페이지도 마찬가지입니다. 이는 폴더 하나가 열린 창에 폴더를 추가할 때처럼 일어납니다. 열려 있던 페이지는 닫히고, 페이지가 시작 시 열리도록 설정되어 있는지와 관계없이 같은 탭 그룹에 새 페이지가 그려집니다. 따라서 창에는 계속 페이지가 하나만 있고, 그 페이지는 현재 작업 영역을 따라갑니다.
각 단계는 현재 값도 표시하므로, 페이지는 여부뿐 아니라 어느 것인지에도 답합니다. 작업 영역 루트, 컴파일러, Release, 그리고 구성이 선언하는 레지스트리입니다. 값은 주변 설명보다 크고 굵게 표시됩니다. 많은 텍스트와 같은 굵기로 그려진 값은 찾아 헤매야 하기 때문입니다. 접힌 단계에서는 제목 아래에 표시되므로 아무것도 펼치지 않고 선택을 확인할 수 있습니다. 열린 단계에서는 설명 끝, 버튼 바로 위에 표시되어 실행하기 전에 마지막으로 읽는 내용이 됩니다. 선택된 값 앞에는 Selected: 레이블이 붙으며, 이 레이블은 값보다 작고 가늘게 표시되어 값과 경쟁하지 않고 값을 가리킵니다.

아직 선택하지 않은 경우 단계는 빈 줄을 남기지 않고 글로 그렇게 알립니다. 빈 줄은 페이지가 그려지지 못한 것처럼 보이기 때문입니다. 또한 읽는 사람이 서로 다르게 대응하는 두 상태를 구별합니다. None selected. 표시는 선택할 것이 있지만 아무것도 선택하지 않았다는 뜻입니다. None available. 표시는 선택할 것이 전혀 없다는 뜻이므로, 단계의 “I already have one”을 눌러도 빈 목록만 보일 뿐이고 필요한 것은 다른 진행 방법입니다. None available. 표시가 나타날 수 있는 것은 목록을 제공하는 두 단계, 즉 작업 영역과 Release뿐입니다. 컴파일러는 이름으로 지정되고 레지스트리는 바로 등록되므로, 두 단계 모두 비어 있을 수 있는 목록이 없습니다. 레지스트리 단계에는 세 번째 표시인 Not read yet. 표시가 있으며, 컴파일러에 물어볼 수 없었을 때 사용됩니다. 아무것도 답할 수 없었는데 아무것도 구성하지 않았다고 알리면 페이지가 아는 것 이상을 말하게 되기 때문입니다.
단계의 표시는 양방향으로 조건을 따릅니다. 각 단계는 표시 옆에 상태를 글로 나타냅니다(Met 또는 To do). 표시 자체는 글리프이며, 글리프만으로는 의미를 추측에 맡기게 되기 때문입니다. 조건이 참이 되면 단계는 Met으로 표시되고, 나중에 조건이 사라지면 다시 To do로 표시됩니다. 예를 들어 컴파일러가 응답을 멈추거나 Release 선택이 해제된 경우입니다. 페이지는 한때 참이었던 것을 기억하는 대신 새로 고칠 때마다 실제 상태를 읽으므로, 그 후에 잃어버린 것을 보고하는 일은 없습니다. 조건이 사라진 것이 중요한 경우에는 이미 보고 있는 곳에서도 알려 줍니다. 상태 표시줄은 응답을 멈춘 컴파일러를 표시하고, Commands 패널 상단의 Project folder, Aggrega workspace, Release 행은 현재 선택을 나타냅니다.
이것이 대화 상자가 아니라 일반 편집기 탭인 것은 의도된 것입니다. 각 단계는 작업 영역의 무언가를 가리키도록 요청하는데, 대화 상자는 답이 담긴 파일을 가리게 됩니다. 또한 Aggrega 보기가 아닌 편집기 영역에 있으므로 사이드바 공간을 차지하지 않고, 좁은 열에는 담을 수 없는 제품 설명을 할 수 있습니다. 이것은 Aggrega 자체의 탭으로 자체 방식으로 열고 닫히며, 편집기 자체의 시작 페이지로 가는 경로는 제공하지 않습니다.
페이지 하단 가운데에 그 결정이 있고, 명령 팔레트에도 있습니다. 둘 다 하나의 설정 aggrega.getStarted.show를 바꾸며, 이 설정은 사용자 설정에 기록됩니다. 저장소에는 절대 기록되지 않으므로, 선택한 내용이 저장소를 여는 다른 사람에게 전달되지 않습니다. 하단의 컨트롤은 Show Aggrega welcome page on startup이라는 체크박스로, 페이지가 시작 시 열리는 동안 체크되어 있습니다. 즉, 설정을 바꾸는 동작을 제시하는 것이 아니라 설정의 현재 상태를 보고합니다. 설정 화면에서 끄면 체크박스가 따라가고, 체크박스를 누르면 설정 화면이 따라갑니다. 두 개의 스위치가 아니라 두 곳에 있는 하나의 스위치입니다. 체크박스는 눌린 후에도 키보드 포커스를 유지하므로 Space 키로 체크와 해제를 번갈아 할 수 있습니다.
끄더라도 페이지가 시작 시 열리지 않을 뿐 페이지에 접근할 수 없게 되는 것은 아니며, 일방통행도 아닙니다. 명령 팔레트의 Aggrega: Get started는 설정을 다시 켜고 페이지를 열며, Aggrega: Stop opening the welcome page on startup은 명령 팔레트에서 같은 설정으로 가는 방법입니다.
Commands 패널에는 톱니바퀴 옆에 페이지로 돌아가는 방법이 있습니다. 오른쪽 위의 집 아이콘이며, 도구 설명은 Open the welcome page입니다. 따라서 페이지로 돌아가는 방법은 입력할 줄 알아야 하는 것이 아니라 Aggrega 보기를 보면 찾을 수 있는 것입니다. 이 아이콘은 페이지를 열고 시작 설정은 설정한 그대로 둡니다. 페이지를 다시 본다고 설정이 다시 켜지지는 않습니다. 설정을 다시 켜는 것은 명령 팔레트의 명령입니다. 다시 켜는 것은 잠깐 보는 것이 아니라 결정이기 때문입니다.
페이지 하단에는 실행 중인 것이 표시됩니다. 버전 표시가 두 개 있습니다. Extension은 편집기가 불러온 이 확장의 빌드이고, Compiler는 언어 서버가 실행하는 aggrega 바이너리가 스스로에 관해 보고하는 내용입니다. Extension 표시는 확장이 빌드될 때, 그 시점의 소스 상태로부터, 컴파일러 자체 빌드가 버전에 사용하는 것과 같은 형식으로 기록됩니다. 따라서 개발 창, 설치된 사본, 편집된 트리에서 패키징한 사본은 각각 자신이 어느 것인지 나타냅니다.
0.2.0처럼 릴리스 태그만 있으면 빌드가 정확히 그 릴리스라는 뜻입니다.0.2.0-3-g1a2b3c4처럼 태그 뒤에 개수와 커밋이 오면 그 릴리스로부터 커밋 세 개 뒤인 커밋1a2b3c4에서 만든 빌드라는 뜻이며,1a2b3c4처럼 커밋만 있으면 앞선 릴리스가 없는 그 커밋에서 만든 빌드라는 뜻입니다.- 이 중 어느 것에든
-dirty접미사가 붙으면, 커밋되지 않은 변경 사항이 있는 소스 사본에서 빌드가 만들어졌다는 뜻입니다. dev는 소스의 기록을 읽을 수 없는 곳에서 빌드가 만들어졌다는 뜻입니다.
두 표시 모두 페이지에 기록되어 있지 않으며, 페이지가 그려질 때 읽힙니다. 따라서 개발 빌드는 아무것도 표시하지 않는 대신 개발 빌드라고 보고하며, 다른 컴파일러로 다시 시작하면 표시도 바뀝니다. 표시를 얻을 수 없는 경우(확장이 어떤 빌드인지 기록하지 않고 빌드되었거나, 물어볼 대상이 실행 중이 아니거나, 실행 중인 것이 응답하지 않은 경우) 레이블은 남아 버전이 보고되지 않았다고 표시하므로, 표시가 없는 것을 놓친 표시로 착각하는 일은 없습니다.
페이지의 마지막 줄은 언어 서버가 실행 중인지와 어떤 빌드인지 알려 줍니다. 표시는 Language server running, starting, not running, failed to start 중 하나이며, 상태 표시줄과 알림이 사용하는 것과 같은 말입니다. failed to start는 가장 최근의 시작 시도가 실패했고 그 이후 아무것도 실행되지 않았다는 뜻입니다. 이유는 Aggrega 출력 채널에 표시되며, 첫 시작이나 다시 시작이 실패할 때 나타나는 알림에도 표시됩니다. 서버가 실행되는 동안 이 줄에는, 확장이 서버에 연결할 때 실행 중인 서버가 스스로에 관해 보고한 버전이 Compiler 표시가 버전을 쓰는 방식대로 덧붙여집니다. 그 위의 Compiler 표시는 다른 사실입니다. 그것은 서버를 시작한 바이너리가 질문을 받았을 때 답하는 내용이며, 그 경로의 파일이 교체되었는데 그 파일로 시작한 서버가 계속 실행 중이면 두 값이 달라지므로 페이지는 둘 다 표시합니다. 자체 버전을 보고하지 않는 언어 서버는 바이너리의 버전을 빌리지 않고 그 자리에 version not reported로 표시됩니다. 이 줄과 그 위의 두 표시는 페이지를 다시 열지 않아도 서버의 시작, 중지, 다시 시작, 실패를 따라가며, 단계들은 다시 시작하는 동안에도 표시를 유지합니다.