# 다시 열기

수업이 끝나고 집에서 혼자 실습 웹을 다시 띄우는 순서입니다. 새로 설치하는 것이 아니라, 이미 있는 폴더를 찾아서 여는 것뿐입니다.

> [!TIP]
> 수업 뒤에 따로 해 보시라고 한 적은 없습니다. 안 열어 보셨어도 괜찮습니다. 이 글은 열어 보고 싶을 때 보는 것입니다.

## 1. 폴더를 찾습니다

포크한 저장소를 컴퓨터 어디에 두었는지 기억나지 않아도 됩니다. Cursor가 기억하고 있습니다.

1. Cursor를 엽니다.
2. **File → Open Recent** (한국어 메뉴는 **파일 → 최근 항목 열기**) 를 누릅니다.
3. 목록에 `opencircuit` 이 들어간 폴더가 있습니다. 그것을 고릅니다.

목록에 없으면 컴퓨터에서 폴더 이름으로 찾습니다.

- **Windows** — 파일 탐색기에서 `내 PC` 를 고르고 오른쪽 위 검색 칸에 `opencircuit` 을 칩니다.
- **Mac** — Finder에서 <kbd>⌘</kbd>+<kbd>F</kbd> 를 누르고 `opencircuit` 을 칩니다. 검색 범위를 **이 Mac** 으로 바꿉니다.

> [!WARNING]
> 이름이 같은 폴더가 두 개 보일 수 있습니다. 하나는 설치 프로그램이 만든 도구 폴더(`.opencircuit`), 다른 하나가 수업에서 clone한 내 포크입니다. 안에 `start.sh` 와 `web` 폴더가 같이 있는 쪽이 실습용입니다. 점으로 시작하는 `.opencircuit` 은 숨김 폴더라 평소에는 보이지 않습니다.

찾은 폴더는 다음에 또 헤매지 않도록 바탕화면에 바로가기를 만들어 두면 편합니다.

## 2. 실습 웹을 띄웁니다

Cursor에서 그 폴더를 연 상태로 터미널을 엽니다. <kbd>Ctrl/⌘</kbd>+<kbd>`</kbd> 입니다.

**Mac**

```bash
./start.sh
```

**Windows** — 터미널 오른쪽 위에서 **PowerShell** 을 고른 뒤

```powershell
.\start.ps1
```

처음 한 번은 부품을 내려받느라 몇 분 걸립니다. 두 번째부터는 빠릅니다.

`실습 웹: http://127.0.0.1:1234` 가 찍히고 브라우저가 저절로 열리면 된 것입니다. 안 열리면 그 주소를 브라우저에 직접 칩니다.

## 3. 그만할 때

터미널에서 <kbd>Ctrl</kbd>+<kbd>C</kbd> 를 누릅니다. 창을 그냥 닫아도 됩니다.

다시 하려면 2번만 반복하면 됩니다. 폴더를 다시 찾을 필요는 없습니다.

## 안 될 때

| 이런 일이 생기면 | 이렇게 합니다 |
| --- | --- |
| `command not found` 또는 `'.\start.ps1'을(를) 인식할 수 없습니다` | 폴더를 잘못 열었습니다. 그 폴더 안에 `start.sh` 가 보이는지 확인합니다 |
| Windows에서 `이 시스템에서 스크립트를 실행할 수 없으므로` | PowerShell에 `Set-ExecutionPolicy -Scope Process Bypass -Force` 를 먼저 칩니다. 이 창에서만 풀립니다 |
| 까만 창에 빨간 글씨가 잔뜩 나온다 | 그 글을 지우지 말고 그대로 복사해서 Cursor 채팅에 붙여 넣고 "오류를 해결해줘" 라고 합니다. [막힐 때](https://opencircuit.club/wiki/stuck) |
| 브라우저는 열리는데 화면이 비어 있다 | 주소가 `127.0.0.1:1234` 가 맞는지 보고, 새로고침합니다 |

혼자 풀지 못해도 괜찮습니다. 화면을 캡처해서 단톡방이나 배준형에게 보내 주세요.

## 띄우고 나서

무엇부터 할지는 [한 바퀴 돌기](https://opencircuit.club/wiki/start/run) 에 있습니다.
