Files
drawing3d-web/guide/run.html
T
오문성andClaude Haiku 5.5 9068b6c7f2 공개용 정리본: 1차 제출본(도면 좌표·과업명 제거)으로 새 이력 시작 (SPEC 34장)
- 정리는 코치 세션이 저장소 밖 도구로 수행, 하이쿠 세션이 커밋.
- 옛 81커밋은 로컬에만 보존. 기록은 evidence/gitlog_v1.txt.
- F13 기준 변경: .gitignore 에 private/*.dwg·private/full.dxf 제외 (SPEC 34장 끝 문장).
- check.sh 결과: 결과: PASS 151 / FAIL 0 / SKIP 3 (검사 범위 F01~F46)

Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
2026-10-27 14:27:50 +09:00

46 lines
3.4 KiB
HTML

<!doctype html>
<html lang="ko">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>구동 설명서 — 구동</title>
<link rel="stylesheet" href="guide.css">
</head>
<body>
<nav class="top"><a class="back" href="../index.html">← 3D 화면으로 돌아가기</a></nav>
<main>
<h1>구동 — 여는 방법</h1>
<h2>여는 방법</h2>
<ol>
<li><code>drawing3d-web</code> 폴더의 <code>index.html</code> 을 더블클릭한다. 서버도 인터넷도 필요 없다.</li>
<li>브라우저는 Chrome 또는 Edge 를 쓴다.</li>
<li>보이는 3D 와 왼쪽 도면은 <b>도면(DWG)에서 도구가 만든 것</b>이다 — 3D 데이터 <code>model_extracted.js</code>, 도면 그림 <code>private/drawing_gen.svg</code>. 제출 압축에 들어 있다.</li>
<li>손으로 만든 정답 모델과 견주어 보려면 <code>answer.html</code>(정답지 화면)을 연다. 왼쪽은 원본 도면 그림(CAD 에서 내보낸 SVG) <code>private/drawing.svg</code> 이다. 두 화면은 같은 모양이어야 한다 — 다르면 검사(<code>check.sh</code>)가 먼저 알려 준다.</li>
</ol>
<h2>도면에서 다시 만들기</h2>
<p>도면이 바뀌면 WSL(Ubuntu)에서 한 줄로 다시 만든다. 준비: GNU LibreDWG 0.14(설치는 <code>README.md</code> 「변환 패키지」).</p>
<ol>
<li>원본 DWG 를 <code>private/drawing.dwg</code> 로 둔다.</li>
<li><code>bash tools/make_model.sh</code> 를 실행한다. DWG → DXF → 그림 범위 → SVG·3D 데이터가 차례로 만들어진다.</li>
</ol>
<table>
<tr><th>형식</th><th>파일</th><th>쓰임</th></tr>
<tr><td>DWG</td><td><code>private/drawing.dwg</code></td><td>설계도면을 주고받는 원본(바이너리)</td></tr>
<tr><td>DXF</td><td><code>private/full.dxf</code> → <code>private/drawing.dxf</code></td><td>글자로 된 도면. 전체에서 <code>tools/views.json</code> 의 그림 상자만 남겨 추출 도구가 읽는다</td></tr>
<tr><td>SVG</td><td><code>private/drawing_gen.svg</code></td><td>웹 왼쪽 칸에 보이는 도면 그림</td></tr>
<tr><td>JS</td><td><code>model_extracted.js</code></td><td>3D 데이터. 도면에 없는 사다리 위치·배관·색은 <code>tools/design_rules.json</code></td></tr>
</table>
<p>규칙은 이 도면 한 장에 맞춘 것이다. 다른 수직구 도면에 쓰려면 그림 상자(<code>tools/views.json</code>)를 바꾸고 검사로 결과를 확인해야 한다.</p>
<h2>잘 안 열릴 때</h2>
<table>
<tr><th>증상</th><th>할 일</th></tr>
<tr><td>왼쪽에 「도면 파일 없음」</td><td>안내에 나온 파일(<code>private/drawing_gen.svg</code>, 정답지 화면은 <code>private/drawing.svg</code>)이 있는지 본다. 없으면 <code>bash tools/make_model.sh</code> 로 만든다. 3D 는 도면 없이도 동작한다.</td></tr>
<tr><td>화면이 비어 있다</td><td>압축을 푼 폴더 안의 <code>index.html</code> 을 열었는지 본다(압축 파일 안에서 바로 열면 다른 파일을 못 읽는다).</td></tr>
<tr><td>화면이 느리다</td><td>3D 칸 오른쪽 위 「사람 ❚❚」로 두 사람을 멈추면 가벼워진다.</td></tr>
</table>
<p>연 다음에 할 일은 <a href="control.html">조작</a>과 <a href="purpose.html">3분 따라 하기</a>에 있다.</p>
</main>
<nav class="pager"><a href="purpose.html">← 이전: 목적</a><a href="index.html">목차</a><a href="control.html">다음: 조작 →</a></nav>
</body>
</html>