이 글은 Today I Learn 시리즈의 202번째 기록입니다. (총 213개)

사용설명서를 만들자고 했다

도형 프리셋까지 붙이고 나니, 이것도 사용법을 설명하는 문서가 있으면 좋겠다 싶었다. 스크린샷까지 넣어서 PPT처럼 넘겨 보는 문서로 만들 수 있냐고 물었다.


사람이 찍은 스크린샷은 찍는 순간부터 낡는다

설명서에 그림을 넣으면 보통 화면을 캡처해 붙인다. 그 순간 문서는 제품과 떨어지고, 툴바가 한 번만 바뀌어도 문서는 조용히 틀린 말을 하게 된다. 다시 스물몇 장을 찍어야 하니 실제로는 갱신되지 않는다.

그래서 스크린샷을 사람이 찍지 않기로 했다. 이미 앱을 자동으로 눌러 보는 점검 도구가 있으니, 거기에 설명용 순서를 하나 더 태우면 그림이 나온다. 이 결정이 얼마나 컸는지는 같은 날 바로 드러났다 — 저녁에 화면을 아이콘 중심으로 바꿨고, 설명서 그림 24장이 명령 한 번에 새 화면으로 다시 찍혔다.

갱신이 사람 일로 남아 있는 문서는 결국 갱신되지 않는다. 문서를 만드는 게 아니라 제품에서 뽑아내게 해 두면 그 비용이 사라진다.


PPT 파일 대신 인쇄를 택했다

PPT처럼 보고 싶다고 했지만, 실제 .pptx 파일을 만드는 대신 웹 페이지 한 장을 슬라이드처럼 넘기게 하고, 인쇄하면 슬라이드 한 장이 A4 한 쪽이 되게 맞췄다. 브라우저의 인쇄 기능이 그대로 PDF 배포본을 만든다.

파일 형식을 하나 더 지원한다는 건 그걸 만드는 장치를 하나 더 오래 유지한다는 뜻이다. 이미 있는 길(인쇄)로 같은 결과가 나오면 그쪽이 싸다.


빨간 상자가 엉뚱한 데를 가리키고 있었다

설명서를 넘겨 보다가 20번 슬라이드의 1번 표시가 「내 도형」이 아니라 그 아래 「통로 폭 기준(참고)」에 가 있는 걸 봤다.

강조할 자리를 “팔레트의 마지막 제목”처럼 위치로 잡아 뒀기 때문이었다. 팔레트 아래에 참고표가 붙자 마지막 제목이 그쪽으로 바뀌었다. 그 자리에 고정 이름표를 붙이고 이름으로 부르게 바꿨다.

화면은 자란다. 위치로 가리키면 당장은 맞고 나중에 조용히 틀린다. 이름으로 가리키면 화면이 바뀌어도 따라온다. 강조 상자를 그림에 그려 넣지 않고 좌표로 얹게 한 것도 같은 이유다 — 그림을 다시 찍어도 강조가 따라온다.


샵으로 옮기겠다고 하자 문서의 조건이 바뀌었다

설명서를 로그스톤 샵(logstone.net) 쪽으로 옮기고 싶다고 했다. 앱과 다른 사이트에 올라가게 되니, 폴더 하나를 통째로 복사하면 되게 만들어야 했다. 위 폴더의 아이콘을 빌려 쓰지 않고 자기 파일을 갖고, 앱으로 돌아가는 링크는 전체 주소로 적고, 바깥에서 불러오는 것이 없게 했다. 도움말 버튼도 앞으로는 이 문서로 바로 가게 했다.

샵은 폴더를 1MB 아래로 넘겨 달라고 했다. 그림 24장이 PNG로 3.8MB였다. 보통은 “찍고 → 변환하고 → 원본을 지우는” 단계를 하나 더 붙이는데, 찍는 도구가 이미 WebP(용량이 작은 웹용 이미지 형식)로 찍을 수 있었다. 찍는 단계에서 형식만 바꾸니 변환 단계 없이 1MB 아래로 내려갔다.

새 단계를 붙이기 전에 앞 단계가 그 일을 이미 할 수 있는지 먼저 본다. 과정이 길어지는 건 대개 이걸 안 봐서다.


영어 버전을 위해 화면부터 바꿨다

샵에 올리려면 영어가 필요했다. 영어 버전을 만들고, 아이콘만으로 뜻이 통하는 버튼은 글자를 떼고, 위·아래·좌·우 같은 방향 버튼은 마름모로 배치해 달라고 했다.

아이콘 먼저, 번역은 나중

순서를 물어보길래 아이콘 정리를 먼저 하기로 했다. 버튼마다 붙은 글자는 화면만 좁히는 게 아니라, 언어를 늘릴 때 전부 번역해야 하는 문자열이 된다. 아이콘이 뜻을 지고 있으면 번역할 것 자체가 줄어든다. 순서를 바꿨다면 같은 문자열을 두 번 손댔을 것이다.

방향 버튼도 같은 이득이다. 네 개를 가로로 늘어놓으면 어느 게 어느 방향인지 글자를 읽어야 알지만, 마름모로 두면 배치가 곧 방향이라 글자도 번역도 필요 없다.


툴팁은 hover가 있는 곳에서만 존재한다

글자를 뗀 버튼은 툴팁(마우스를 올리면 뜨는 작은 설명)으로 뜻을 알린다. 그런데 툴팁은 hover — 마우스 포인터를 버튼 위에 올려 둔 상태 — 가 있어야 뜬다. 태블릿 같은 터치 화면에는 hover가 없어서, 툴팁만 남기면 그 버튼이 무엇인지 알 방법이 사라진다.

그래서 마우스가 있는 환경에서만 글자를 감추고, 터치 화면에서는 라벨을 그대로 보여 준다. 화면 크기가 아니라 입력 방식으로 갈라야 한다.


언어는 브라우저를 따르되, 고른 쪽이 이긴다

영어·한국어 전환 방식은 처음 방문할 때 브라우저 언어를 따르고, 한 번 바꾸면 그 선택을 기억하게 했다. 한국에서 영어 브라우저를 쓰는 사람도, 반대도 있으니 자동 감지는 출발점일 뿐이다.


남의 파일은 이번에도 그 프로젝트에만

영어와 함께 새로 넣은 「내 도형」(직접 그린 모양을 팔레트에 저장하는 기능)도, 남이 보낸 파일에 담겨 온 것은 그 프로젝트에서만 보이게 했다. 앞선 TIL 6에서 정한 원칙 — 파일을 여는 건 남의 데이터를 들이는 일이라 내 환경을 바꾸게 두지 않는다 — 을 새 기능에도 그대로 적용한 것이다.


Series: Today I Learn

1 C++ 자료형(Data Type) 2 MD5 vs pHash 3 C++에서 함수의 선언과 정의 4 Tkinter padx, pady 5 메모리와 포인터 변수 6 Call by Value, Call by Reference, Call by Pointer 비교 7 const 8 Gemfile — Jekyll 프로젝트의 의존성 파일 9 kramdown-parser-gfm — Jekyll의 GFM 파서 10 파서(Parser) 11 AHU vs OHU 12 I might try it vs I'll try it 뉘앙스 차이 13 SESSION_EXPIRE_AT_BROWSER_CLOSE=True 14 configuration key 15 Git stash vs discard 16 subprocess.Popen으로 Windows 탐색기에 명령어를 전달 17 Post 잔디 분석하기 18 Google Sheets Sync 최적화 19 DSL (Domain Specific Language)과 GPL (General Purpose Language) 20 마크다운 표 그리는 방법 21 쿼리 파라미터(Query Parameter). 기존 QR코드 재활용 22 Django 보안 취약점 점검 및 수정 23 OOP Object-Oriented Programming 객체 지향 프로그래밍 24 Fernet 대칭 암호화 25 Jekyll 코드블록 안의 Liquid 태그 26 습관만들기 Pawbit TIL 1 27 insertOnConflictUpdate vs DoUpdate(target) 28 세션 필터 29 아코디언(Accordiaon) UI를 펼친상태로 만들기 30 input의 step 31 습관만들기 Pawbit TIL 2 32 습관만들기 Pawbit TIL 3 33 Word Cloud 34 Google Sheets를 데이터 버스로(with AppSheet) 35 Django 모델 텍스트 필드 자동 수집 패턴 36 localStorage로 섹션 토글 상태 유지 37 순차 ID 생성(`select_for_update()` + `max()` 조합) 38 역참조 검색과 distinct() 39 xlsx 다운로드와 로딩 오버레이 충돌 40 Android 파일 공유 MIME 타입 41 AssetManifest — Flutter 빌드 타임 asset 목록 런타임 조회 42 크레센도 Phaser + TypeScript TIL 1 43 크레센도 Phaser + TypeScript TIL 2 44 크레센도 Phaser + TypeScript TIL 3 45 크레센도 Phaser + TypeScript TIL 4 46 크레센도 Phaser + TypeScript TIL 5 47 여둘까 Office Layout TIL 1 48 습관만들기 Pawbit TIL 4 49 여둘까 Office Layout TIL 2 50 여둘까 Office Layout TIL 3 51 크레센도 Phaser + TypeScript TIL 6 52 UTF-8 BOM과 PowerShell 파일 쓰기 53 소리꽃 KeyBloom TIL 1 54 습관만들기 Pawbit TIL 5 55 여둘까 Office Layout TIL 4 56 소리꽃 KeyBloom TIL 2 57 소리꽃 KeyBloom TIL 3 58 메트로놈 Simple Metronome TIL 1 59 소리꽃 KeyBloom TIL 4 60 메트로놈 Simple Metronome TIL 2 61 소리꽃 KeyBloom TIL 5 62 습관만들기 Pawbit TIL 6 63 크레센도 Phaser + TypeScript TIL 7 64 메트로놈 Simple Metronome TIL 3 65 소설 타임라인 관리 도구 Lumior TIL 1 66 습관만들기 Pawbit TIL 7 67 정적 블로그 SEO 정비와 Pagefind 검색 도입 68 크레센도 Phaser + TypeScript TIL 8 69 메트로놈 Simple Metronome TIL 4 70 습관만들기 Pawbit TIL 8 71 안드로이드 AudioTrack 연속 재생, 실측 피커 정렬, 카메라 토치 플래시 72 메트로놈 Simple Metronome TIL 5 73 모래게임 Sandrop TIL 1 74 습관만들기 Pawbit TIL 9 75 메트로놈 Simple Metronome TIL 6 76 모래게임 Sandrop TIL 2 77 모래게임 Sandrop TIL 3 78 습관만들기 Pawbit TIL 10 79 습관만들기 Pawbit TIL 11 80 메트로놈 Simple Metronome TIL 7 81 모래게임 Sandrop TIL 5 82 모래게임 Sandrop TIL 4 83 습관만들기 Pawbit TIL 12 84 모래게임 Sandrop TIL 6 85 소리꽃 KeyBloom TIL 6 86 모래게임 Sandrop TIL 7 87 모래게임 Sandrop TIL 8 88 소리꽃 KeyBloom TIL 7 89 모래게임 Sandrop TIL 9 90 소리꽃 KeyBloom TIL 8 91 모래게임 Sandrop TIL 10 92 소리꽃 KeyBloom TIL 9 93 콘티온 ContiOn TIL 1 94 소리꽃 KeyBloom TIL 10 95 콘티온 ContiOn TIL 2 96 습관만들기 Pawbit TIL 13 97 콘티온 ContiOn TIL 3 98 모래게임 Sandrop TIL 11 99 소리꽃 KeyBloom TIL 11 100 여둘까 Office Layout TIL 5 101 모래게임 Sandrop TIL 12 102 모래게임 Sandrop TIL 13 103 콘티온 ContiOn TIL 4 104 모래게임 Sandrop TIL 14 105 소리꽃 KeyBloom TIL 12 106 습관만들기 Pawbit TIL 14 107 모래게임 Sandrop TIL 15 108 모래게임 Sandrop TIL 16 109 소리꽃 KeyBloom TIL 13 110 온실 GreenHouse TIL 1 111 콘티온 ContiOn TIL 5 112 모래게임 Sandrop TIL 17 113 소리꽃 KeyBloom TIL 14 114 온실 GreenHouse TIL 2 115 콘티온 ContiOn TIL 6 116 모래게임 Sandrop TIL 18 117 콘티온 ContiOn TIL 7 118 모래게임 Sandrop TIL 19 119 소리꽃 KeyBloom TIL 15 120 모래게임 Sandrop TIL 20 121 모래게임 Sandrop TIL 21 122 소리꽃 KeyBloom TIL 16 123 소리꽃 KeyBloom TIL 17 124 소리꽃 KeyBloom TIL 18 125 여둘까 Office Layout TIL 6 126 소리꽃 KeyBloom TIL 19 127 소리꽃 KeyBloom TIL 20 128 콘티온 ContiOn TIL 8 129 콘티온 ContiOn TIL 9 130 로그스톤 상표 셀프 출원 TIL 1 131 소리꽃 KeyBloom TIL 21 132 로그스톤 샵 LogStone Shop TIL 1 133 소리꽃 KeyBloom TIL 22 134 로그스톤 샵 LogStone Shop TIL 2 135 소리꽃 KeyBloom TIL 23 136 모래게임 Sandrop TIL 22 137 모래게임 Sandrop TIL 23 138 소리꽃 KeyBloom TIL 24 139 로그스톤 샵 LogStone Shop TIL 3 140 모래게임 Sandrop TIL 24 141 소리꽃 KeyBloom TIL 25 142 모래게임 Sandrop TIL 25 143 MiniMacro TIL 1 144 모래게임 Sandrop TIL 26 145 콘티온 ContiOn TIL 10 146 Astro가 무엇인지, 왜 옮기는지 147 모래게임 Sandrop TIL 27 148 소리꽃 KeyBloom TIL 26 149 MiniMacro TIL 2 150 로그스톤 샵 LogStone Shop TIL 4 151 메트로놈 Simple Metronome TIL 8 152 모래게임 Sandrop TIL 28 153 여둘까 Office Layout TIL 7 154 메트로놈 Simple Metronome TIL 9 155 블로그 Astro 이관 TIL 156 여둘까 Office Layout TIL 8 157 로그스톤 샵 LogStone Shop TIL 5 158 모래게임 Sandrop TIL 29 159 오픈데이 Openday TIL 1 160 로그스톤 샵 LogStone Shop TIL 6 161 모래게임 Sandrop TIL 30 162 오픈데이 Openday TIL 2 163 모래게임 Sandrop TIL 31 164 Unreal Engine MCP TIL 1 165 모래게임 Sandrop TIL 32 166 소리꽃 KeyBloom TIL 27 167 콘티온 ContiOn TIL 11 168 오픈데이 Openday TIL 3 169 로그스톤 샵 LogStone Shop TIL 7 170 모래게임 Sandrop TIL 33 171 소리꽃 KeyBloom TIL 28 172 오픈데이 Openday TIL 4 173 여둘까 Office Layout TIL 9 174 오픈데이 Openday TIL 5 175 ScorePlayer TIL 1 176 모래게임 Sandrop TIL 34 177 BuildingHub TIL 1 178 ScorePlayer TIL 2 179 여둘까 Office Layout TIL 10 180 BuildingHub TIL 2 181 ScorePlayer TIL 3 182 Unreal Engine MCP TIL 2 183 궁 미로 PalaceMaze TIL 1 184 메트로놈 Simple Metronome TIL 10 185 메트로놈 Simple Metronome TIL 11 186 오픈데이 Openday TIL 6 187 BuildingHub TIL 3 188 Obsidian vault에서 코드만 빼기 — directory junction 189 ScorePlayer TIL 4 190 여둘까 Office Layout TIL 11 191 오픈데이 Openday TIL 7 192 URL은 바뀔 수 있는 것에 묶지 않는다 193 도구는 기능이 아니라 내 일에 맞는지로 고른다 194 돌이키기 힘든 변경은 작게 먼저 확인한다 195 궁 미로 PalaceMaze TIL 2 196 궁 미로 PalaceMaze TIL 3 197 소리꽃 KeyBloom TIL 29 198 오픈데이 Openday TIL 8 199 BuildingHub TIL 4 200 ScorePlayer TIL 5 201 로그스톤 샵 LogStone Shop TIL 8 202 여둘까 Office Layout TIL 12 읽는 중 203 오픈데이 Openday TIL 9 204 BuildingHub TIL 5 205 MiniMacro TIL 3 206 소리꽃 KeyBloom TIL 30 207 오픈데이 Openday TIL 10 208 여둘까 Office Layout TIL 13 209 소리꽃 KeyBloom TIL 31 210 궁 미로 PalaceMaze TIL 4 211 로그스톤 샵 LogStone Shop TIL 9 212 로그스톤 샵 LogStone Shop TIL 10 213 소리꽃 KeyBloom TIL 32