쌓여 있는 문서는 변환기로 글을 꺼내고 기록장에서 내 생각을 더해 서로 이어 둡니다. 나누고 싶은 기록은 사이트 만들기로 엮어 웹 페이지로 만듭니다.
세 도구 모두 깃허브에 공개되어 있어서 주소로 바로 열어 쓰거나 내 계정으로 가져갈 수 있습니다.
설치도 로그인도 필요 없습니다. 가상 기록 48개가 들어 있는 체험 서재에서 먼저 이것저것 눌러 보고 내 기록은 그다음에 시작하면 됩니다.
자료가 흘러가는 순서대로 놓았습니다. 하나만 골라 써도 되고 이어서 쓰면 쌓아 둔 자료가 다시 수업으로 돌아옵니다.
기록하고 연결하는 개인 서재
메모와 문서, 사진을 한곳에 보관하고 내 생각을 덧붙여 기록끼리 이어 줍니다. 로그인 없이 쓰며 기록은 내 브라우저에 저장됩니다.
흩어진 문서를 마크다운으로
블로그 백업, 한글, 워드, PPT, 엑셀, 구글 문서를 AI가 읽기 좋은 마크다운(.md)으로 모아 줍니다. 이름이나 연락처 같은 개인정보는 기본으로 가립니다.
폴더 하나를 웹 페이지로
폴더에 글과 사진, 그리고 _메모.txt 한 장을 넣으면 디자인을 입힌 웹 페이지가 나옵니다. 파일은 내 컴퓨터 밖으로 나가지 않습니다.
기록장에 내 기록 하나를 남기고 백업 파일을 받아 둡니다. 변환기로는 샘플 PDF를 글로 바꿔 보고 제작기로 예시 폴더를 웹 페이지로 만들어 봅니다. 마음에 드는 도구가 있으면 내 깃허브로 가져갑니다.
세 도구 모두 자료를 받아 두는 서버가 없습니다. 기록은 브라우저에 남습니다. 변환 결과는 내 드라이브나 PC에 저장되고 만든 페이지는 내 폴더에 그대로 있습니다. 그래서 백업과 공개 전 확인만큼은 꼭 챙겨 주세요.
기기와 계정을 확인한 뒤 세 도구가 어떻게 이어지는지 봅니다.
BLOCK 01체험 서재와 내 서재를 구별하고 화면의 여섯 구역을 찾아봅니다.
BLOCK 02노트북과 태그를 정해 기록을 저장한 다음 다른 기록과 이어 봅니다.
BLOCK 03낱말로 찾아보고 카드 파일 하나로 기록 109개를 한꺼번에 가져옵니다.
BLOCK 04영역을 바꾸고 확대해 보며 선과 점을 눌러 연결 이유와 이어진 기록을 읽습니다.
BLOCK 05첨부까지 담긴 백업 파일을 받습니다. 기기마다 서재가 따로라는 점도 익힙니다.
BLOCK 06설치 없이 샘플 PDF를 마크다운으로 바꾸고 결과를 받아 봅니다.
BLOCK 07문서 폴더를 통째로 바꾸고 개인정보 보고서를 확인합니다.
BLOCK 08Windows 앱과 파이썬 교재판 가운데 내 PC에 맞는 쪽을 고릅니다.
BLOCK 09제작기 파일을 받아 크롬이나 엣지에서 작업 폴더를 고릅니다.
BLOCK 10예시 폴더 하나를 웹 페이지로 만들어 열어 봅니다.
BLOCK 11디자인을 손보고 공개하기 전에 확인할 것을 살핍니다.
BLOCK 12바로 쓰기, 파일 받기, 템플릿, 포크 가운데 맞는 방법을 고릅니다.
BLOCK 13어떤 불편에서 시작했는지, 써 보면서 무엇을 고쳤는지 봅니다.
기기와 계정을 확인하고 세 도구가 어떻게 이어지는지 먼저 살펴봅니다.
| 준비물 | 어디에 쓰나 | 없을 때 |
|---|---|---|
| PC의 크롬 또는 엣지 | 세 도구 모두에 씁니다. 제작기의 폴더 고르기와 기록장의 카드 파일 자동 반영은 PC의 크롬·엣지에서만 됩니다. | 휴대폰에서는 기록장을 읽고 쓰는 데까지 됩니다. |
| 구글 계정 | 변환기를 코랩에서 실행할 때 필요합니다. 기록장 카드의 「원본 열기」·「드라이브 미리보기」도 그 파일을 볼 수 있는 계정으로 로그인한 브라우저에서 열립니다. | 변환기는 Windows 앱이나 교재판으로 씁니다. |
| 구글 드라이브 데스크톱 (내 드라이브 자료를 PC에서 쓸 때) | 기록장 카드의 「탐색기」·「경로 복사」, 드라이브에 둔 카드 파일과 백업 폴더 연결, 변환기 Windows 앱·교재판으로 드라이브 폴더를 바꿀 때, 드라이브에 둔 제작기 작업 폴더에 씁니다. 쓰는 폴더는 「오프라인으로 사용」으로 둡니다. | 체험 서재 실습, 기록 쓰기·지식맵·백업 파일, 코랩 변환은 없어도 됩니다. |
| 깃허브 계정 (선택) | 도구를 내 계정으로 가져갈 때 씁니다(12장). | 바로 쓰기와 파일 받기는 계정 없이도 됩니다. |
| 휴대폰 (선택) | QR로 주소를 저장하거나 기록장의 휴대폰 화면을 볼 때 씁니다. | 주소를 직접 입력하면 됩니다. |
한글, PDF, 블로그 백업 같은 자료는 파일을 열어 봐야 내용을 알 수 있었습니다. 이것을 마크다운 글로 바꾸면 검색도 되고 AI에게 건네기도 쉬워집니다.
변환한 글이나 새 메모를 기록장에 넣고 노트북, 태그, 연결, 다시 볼 날짜로 엮습니다. 변환기가 만든 마크다운은 날짜·분류·원문 주소까지, 카드 파일(.pkem)은 그대로 가져옵니다.
나누고 싶은 글과 사진을 한 폴더에 모아 웹 페이지로 만듭니다. 공개하기 전에는 사람이 직접 내용을 확인합니다.
도구끼리 자동으로 넘겨주지는 않아서 파일로 내보내고 가져오는 단계가 중간에 들어갑니다. 시간에 맞춘 진행 순서는 진행 · 점검에 있습니다.
체험 서재와 내 서재를 구별해 본 뒤 화면의 여섯 구역이 각각 무엇을 하는지 알아봅니다.
PKOS 나의지식서재는 개인 기록장입니다. 여기에 메모와 문서, 사진을 함께 보관하고 내 생각을 덧붙여 기록끼리 잇습니다. 로그인이 없고 기록은 지금 쓰는 브라우저 안에 저장됩니다.
크롬이나 엣지로 legoschool.github.io/pkos-library를 엽니다. 처음 열면 서재 안내 다섯 장이 차례로 나옵니다. 「닫기」로 건너뛰어도 오른쪽 위 「사용 안내」에서 다시 볼 수 있습니다.
빈 첫 화면에서 「가상 자료 48개로 먼저 살펴보기」를 누릅니다. 맨 위에 보라색 띠와 "가상 자료로 살펴보는 서재"라는 글이 보이면 체험 서재에 들어온 것입니다. 여기서 한 일은 내 서재에 섞이지 않습니다.
① 체험 서재 표시, ② 보기 메뉴(서재 현황·모든 기록·수집함·다시 보기·즐겨찾기·지식맵), ③ 노트북, ④ 기록 목록, ⑤ 읽기 화면, ⑥ 사용 안내를 차례로 손으로 가리켜 봅니다.
기록 하나에 노트북과 태그를 정해 저장합니다. 그 기록을 체험 서재의 다른 기록과 직접 이어 봅니다.
왼쪽 「새 기록」을 누르고 제목에 오늘 수업에서 남은 질문을, 본문에는 아래 두 줄을 적습니다.
모둠 토론 뒤에 "왜 그렇게 생각했니?"라고 물었더니 세 모둠이 근거를 다시 찾았다.
다음 시간에는 근거 문장을 먼저 고르게 한다.「노트북 · 태그 · 다시 볼 날짜」를 펼쳐서 노트북은 「수업 연구」로 고르고, 태그 칸에는 질문, 수업 성찰을 적습니다. 태그는 쉼표로 나눕니다. 태그 칸 아래에 이 글과 비슷한 기록에 붙은 태그가 제안되고, 누르면 태그 칸에 더해집니다.
/로 서식 넣기본문 끝 새 줄에서 /를 치면 「기록에 넣기」 메뉴가 열리고 제목·굵게·목록·표 같은 서식을 고를 수 있습니다. Esc로 닫은 뒤 방금 친 /는 지웁니다.
「다른 기록 연결」을 누르고 찾기 칸에 질문을 적습니다. 「좋은 질문은 답을 서두르지 않는다」에 표시한 다음 「연결 저장」을 누르면 됩니다. 찾기 칸을 비워 두면 지금 쓰는 글과 낱말이 겹치는 기록이 먼저 보입니다.
「저장」을 누르면 읽기 화면으로 바뀝니다. 「함께 읽을 기록」 맨 위에 "내가 연결한 기록"이 있습니다. 그 아래로 이어지는 기록은 서재에서 드물게 나오는 낱말이나 주제 태그가 겹쳐서 서재가 찾아 준 것이고, 줄마다 겹친 낱말이 적혀 있습니다.
/를 치면 열리는 「기록에 넣기」 메뉴입니다. 방향키로 고르고 Enter로 넣습니다.본문 낱말로 기록을 찾아봅니다. 이어서 카드 파일 하나로 기록 109개를 한꺼번에 가져옵니다.
Ctrl+K를 누르거나 왼쪽 「모든 기록 검색」을 누릅니다. 근거를 적으면 목록이 2개로 줄면서 02장에서 쓴 기록이 보입니다. 「검색 범위 · 정렬」을 펼치면 제목, 본문, 태그, 노트북으로 범위를 좁힐 수 있습니다.
카드 파일(.pkem)은 여러 기록을 한 파일에 묶어 둔 것으로, 백업 파일과 형식이 같습니다. 가상의 수업·연수·연구 자료 109장이 든 practice-1.pkem을 내려받습니다.
왼쪽 아래 「설정 · 백업」에서 「백업 파일 가져오기」를 누르고 내려받은 파일을 고릅니다. "109개 기록을 현재 서재에 더합니다"라는 확인 창이 뜨면 「가져오기」를 누릅니다.
「모든 기록」이 158로 늘어납니다(체험 기록 48 + 02장의 기록 1 + 카드 109). 노트북 목록에는 수업, 강의·연수, 연구, 집필·개발, 만든 도구, 생활·공동체 이렇게 영역 6개가 새로 생깁니다.
탐구 계획서로 찾아서 카드를 엽니다. 「원본 열기」를 누르면 원래 파일이 새 탭에서 열립니다. 「자료 정보」 상자에는 묶음, 형식, 연도, 원래 이름과 파일 자리(웹 주소, 탐색기, 경로 복사)가 있고, 묶음 이름을 누르면 묶음 카드로 이동합니다. 내 구글 드라이브 자료로 만든 카드는 「드라이브 미리보기」로 원본을 이 화면 안에서 봅니다. 미리보기는 보기 전용이라 그 칸에서는 내려받기·인쇄·새 창 열기가 막혀 있고, 그 파일을 볼 권한이 있는 계정으로 로그인한 브라우저에서만 보입니다.
근거를 넣은 화면입니다. 지금 고른 보기와 노트북 안에서 찾습니다.지식맵에서 영역을 바꾸고 확대해 봅니다. 선을 눌러 두 기록이 이어진 이유를 읽고, 점을 눌러 이어진 기록을 따라갑니다.
지식맵의 점은 기록 하나, 선은 두 기록 사이의 연결입니다. 점 색은 영역(가장 위 노트북)을 나타내고 같은 묶음에 든 기록끼리 가까이 모입니다. 점 사이의 거리는 연결 규칙으로 계산한 배치입니다. 의미가 얼마나 가까운지를 잰 값은 아닙니다.
왼쪽 「지식맵」을 누릅니다. 위쪽에서 지도에 올릴 기록 수(처음에는 500개)와 고르는 기준, 영역을 정할 수 있습니다.
「영역」을 「수업」으로 바꾸면 수업 영역의 묶음 4개가 서로 다른 색으로 다시 칠해집니다.
무리 위에서 마우스 휠을 굴리면 확대되면서 기록 제목이 보입니다. 빈 곳을 끌면 지도가 움직이고 「전체 보기」를 누르면 처음 크기로 돌아옵니다. 휴대폰에서는 두 손가락으로 벌리면 됩니다.
점과 점 사이의 선을 누르면 「이 기록들이 연결된 이유」 창이 열립니다. 겹친 낱말, 같은 태그와 노트북, 직접 연결 여부, 그리고 점수가 나옵니다.
점 하나를 누르면 지도 오른쪽에 그 기록의 미리 보기가 열리고, 이 지도에서 이어진 기록과 연결 이유가 보입니다. 이어진 기록을 누르면 미리 보기가 그 기록으로 바뀌어 지도를 떠나지 않고 따라갈 수 있습니다. 「이웃만 보기」는 그 기록과 이웃만 남겨 확대하고, 「읽기」는 기록을 엽니다.
「3D 입체 지도」를 누르고 빈 곳을 끌어 돌려 봅니다. 3D 지도는 기록을 500개까지 그립니다.
첨부까지 담긴 백업 파일을 받아 두고 휴대폰과 PC의 서재가 서로 따로라는 점을 알아 둡니다.
「설정 · 백업」에서 「첨부를 포함한 백업 내보내기」를 누릅니다. 창을 닫으면 "기록과 첨부가 포함된 백업을 내보냈습니다."라는 알림이 뜹니다.
Ctrl+J로 다운로드 목록을 열고 PKOS-백업-날짜.pkem 파일을 확인합니다. 다른 PC나 브라우저에서 같은 주소를 연 다음 「백업 파일 가져오기」로 이 파일을 넣으면 기록이 그대로 옮겨집니다.
「Markdown 묶음 내보내기」로 받은 파일은 압축을 풀면 옵시디언 보관함으로 바로 열립니다. 「읽기용 웹문서 만들기」는 서재를 웹문서 한 파일로 묶어 줍니다. PC의 크롬·엣지에서는 「PC 폴더 자동 백업」도 켤 수 있습니다.
휴대폰 브라우저로 같은 주소를 엽니다. 목록에서 기록을 누르면 읽기 화면이 됩니다. 노트북과 지식맵은 왼쪽 위 줄 세 개 단추에서 엽니다. 「앱으로 설치」나 '홈 화면에 추가'를 쓰면 바탕화면에 아이콘이 생깁니다.
실습을 마쳤다면 「설정 · 백업」의 「체험 서재 처음 상태로 되돌리기」를 누릅니다. 체험 서재만 가상 기록 48개로 돌아가고 내 서재는 그대로 남습니다.
설치 없이 코랩에서 샘플 PDF를 마크다운으로 바꾼 뒤 결과 파일을 내려받습니다.
PKOS 자료변환기는 블로그, 한글, 워드, PPT, 엑셀, 구글 문서에 흩어진 기록을 모아 마크다운(.md)으로 바꿉니다. AI가 읽기 좋은 형식입니다. 코랩은 내 구글 계정으로 실행되고 파일은 내 드라이브 안에서만 읽고 씁니다.
| 부 | 무엇을 | 어떤 형식 |
|---|---|---|
| 1부 | 네이버 블로그 백업 | .pdf를 글 한 편씩 나눠서 변환합니다 |
| 2부 | 문서 폴더 통째로 | .hwp .hwpx .docx .pptx .xlsx .odt .pdf .html .txt .csv |
| 3부 | 구글 문서 | 문서, 시트, 슬라이드를 모두 .md로 바꿉니다 |
위 단추로 노트북을 엽니다. 오른쪽 위 「로그인」으로 구글 계정에 들어간 다음 위쪽 「Drive로 복사」를 누르면 내 드라이브에 내 사본이 생깁니다. 다음부터는 이 사본을 열어 쓰면 됩니다.
맨 위 「준비하기」의 두 칸에서 ▶를 차례로 누릅니다. 구글 드라이브 연결을 묻는 창이 뜨면 직접 눌러 허용하세요. 브라우저가 팝업을 막으면 연결이 진행되지 않습니다.
「먼저 연습하기 → ▶ 샘플 PDF로 변환 테스트」를 누릅니다. 경로는 넣지 않아도 됩니다. 태극기와 애국가 1~4절이 담긴 2쪽짜리 PDF가 만들어지고 2부와 같은 변환기를 거쳐 마크다운이 됩니다.
셀 아래에서 가사가 제대로 읽히는지 봅니다. 왼쪽 폴더 아이콘을 눌러 PKOS_샘플/변환결과로 간 다음 파일을 오른쪽 단추로 누르고 「다운로드」를 고릅니다.
드라이브의 문서 폴더를 통째로 변환합니다. 개인정보가 어떻게 가려졌는지는 보고서로 확인합니다.
2부의 「폴더 훑어보기」로 파일 수와 형식을 먼저 확인합니다. 변환에는 100MB당 대략 1~3분이 걸립니다.
문서 폴더에는 드라이브의 전체 경로를, 결과 폴더에는 드라이브 안의 위치를 적습니다. 코랩 왼쪽 폴더 목록에서 폴더를 오른쪽 단추로 누르고 「경로 복사」를 고르면 정확하게 넣을 수 있습니다.
문서폴더: /content/drive/MyDrive/수업자료/2025
결과폴더: PKOS/변환결과▶를 누르면 변환이 시작됩니다. 중간에 끊겨도 다시 누르면 이어서 하고 한 파일이 실패해도 나머지는 계속 변환합니다.
결과 폴더는 원본 폴더 구조를 그대로 따릅니다. INDEX.md에는 형식별 목차가, _오류.md에는 실패한 파일과 그 이유가 나옵니다.
변환결과/
├── (원본과 같은 하위 폴더)/문서이름_hwp.md
├── INDEX.md 형식별 목차
├── _files.json
├── _오류.md 실패 목록과 이유
└── _개인정보_보고서.md 무엇이 어떻게 가려졌는지변환하면서 주민등록번호, 전화번호, 이메일, 계좌번호, 카드번호, 이름, 주소, 생년월일, 차량번호를 찾아 가립니다. 기본으로 켜져 있고 종류마다 가리는 방식을 따로 고를 수 있습니다.
| 방식 | 예 |
|---|---|
| 부분가림 | 홍길동 → 홍** · 010-1234-5678 → 010-****-**** |
| 가림 | 900101-1234567 → ******-******* |
| 삭제 | 빈칸으로 바꿈 |
| 그대로 | 건드리지 않음 |
종이를 스캔한 PDF와 사진은 글자가 아니라 그림이라서 변환되지 않습니다(OCR 기능은 없습니다). 옛 형식인 .xls .ppt .doc는 해당 프로그램에서 열어 「다른 이름으로 저장」으로 새 형식으로 바꾼 뒤 쓰세요. 확장자 이름만 바꿔서는 변환되지 않습니다.
내 PC에서 변환하는 방법 두 가지를 알아본 다음 내 환경에 맞는 쪽을 고릅니다.
코랩이 낯설거나 PC에 있는 폴더를 바로 변환하고 싶을 때 씁니다. Windows 앱은 창에서 단추를 눌러 가며 쓰고 교재판은 따라 하는 실습 교재와 함께 씁니다.
릴리스 페이지의 Assets에서 PKOS-Windows-v0.1.1.zip(약 48MB)을 받습니다. 파이썬이 실행 파일 안에 들어 있어서 따로 설치하지 않아도 됩니다.
ZIP 파일을 오른쪽 단추로 눌러 「모두 압축 풀기」를 합니다. ZIP 안에서 바로 실행하지는 마세요.
PKOS 폴더 안의 PKOS.exe를 두 번 누르고 「샘플로 테스트」부터 눌러 봅니다.
원본 경로를 붙여 넣고 결과 폴더를 고른 다음 변환을 시작합니다. 진행 상태 보기, 중지, 결과 미리보기, 폴더 열기를 쓸 수 있습니다. 원본이 구글 드라이브에 있으면 그 폴더를 「오프라인으로 사용」으로 둔 뒤 변환합니다(준비).
파이썬이 설치된 Windows PC에서 씁니다. 자료변환기 실습 교재가 설치부터 변환까지 15블록으로 차근차근 안내합니다.
pkos_자료변환기\설치.cmd를 두 번 누릅니다. 스마트 앱 컨트롤이 막으면 명령 프롬프트에서 도구 폴더로 이동해 아래 첫 줄을 실행하세요.
python 바로가기_만들기.py를 한 번 실행합니다. 새로 생긴 여기에_폴더_선택하기.lnk를 두 번 눌러 흩어진자료를 고르면 형식별 개수가 나옵니다. 확인한 뒤 y를 누릅니다.
흩어진자료\_변환결과\INDEX.md에서 목차와 변환된 문서를 봅니다. 다시 돌리면 바뀐 파일만 새로 만듭니다.
python pkos.py --설치
python pkos.py "C:\pkos_실습\흩어진자료" --훑기
python pkos.py "C:\pkos_실습\흩어진자료"
python pkos.py --자가진단자가진단은 시험 자료를 직접 만들어 126가지 항목을 판정합니다. 통과 126 · 실패 0이 나오면 준비가 끝난 것입니다.
_오류.md에 남고 가린 개인정보 건수도 알려 줍니다.INDEX.md와 형식별 폴더, 보고서가 생깁니다.제작기 파일을 내려받습니다. 그다음 PC의 크롬이나 엣지에서 작업 폴더를 고릅니다.
웹 게시본 제작기는 폴더에 넣은 글과 사진, 그리고 _메모.txt 한 장을 읽습니다. 읽은 내용으로 웹 페이지(index.html)를 만듭니다. 설치나 회원가입, 로그인이 없고 파일은 내 컴퓨터 밖으로 나가지 않습니다. 원본은 읽기만 합니다.
위의 「제작기 파일 ZIP 받기」나 저장소의 「Code → Download ZIP」으로 받아 압축을 풉니다. 안에 디자인/과 게시본/ 폴더가 있습니다. 두 폴더를 담은 이 폴더가 바로 작업 폴더입니다.
PC의 크롬이나 엣지에서 「제작기 열기」를 누릅니다. 내려받은 제작기.html을 두 번 눌러 열면 폴더를 읽지 못하니, 꼭 주소로 열어 주세요.
「작업 폴더 고르기」를 누르고 압축을 푼 폴더를 고릅니다. 브라우저가 "이 폴더를 이 페이지에 허용할까요?"라고 한 번 묻습니다. 구글 로그인 창이 아니니 허용하면 됩니다.
"디자인 10가지, 게시본 N개를 찾았습니다."가 보이면 준비가 끝났습니다. 아래 「게시본」에는 폴더마다 카드가 하나씩 생깁니다.
게시본 폴더 하나에 글과 사진, _메모.txt를 넣고 제작기로 웹 페이지를 만들어 엽니다.
예시 폴더로 먼저 해 봅니다. 우리반-텃밭-기록 예시 받기 (17KB)를 내려받아 작업 폴더의 게시본/ 안에 풀어 주세요. 글과 그림은 모두 지어낸 것입니다.
게시본/ 아래 폴더 하나가 웹 페이지 하나가 됩니다. 글은 .md로, 사진은 그림 파일로 넣습니다. 파일 이름 앞 번호가 순서를 정합니다. 03!_처럼 번호 뒤에 !를 붙이면 그 자료가 강조됩니다.
게시본/우리반-텃밭-기록/
├── _메모.txt ← 사람이 쓰는 유일한 설정 파일
├── 01_씨앗 심기.md
├── 01_씨앗 심기.png
├── 02_새싹 관찰.md
├── 02_새싹 관찰.png
├── 03!_첫 수확.md ← 번호 뒤 ! = 강조
└── 03!_첫 수확.png_메모.txt 쓰기--- 위에는 설정을, 아래에는 도구에게 하고 싶은 말을 적습니다. 아랫단은 페이지에 나오지 않습니다. 제작기 화면의 드롭다운으로 골라도 저절로 적힙니다.
제목: 우리 반 텃밭 기록
부제: 씨앗에서 첫 수확까지
디자인: 기록장
배치: 나열
공개: 끄기
---
사진은 크게, 첫 수확 글을 강조해 줘제작기에서 작업 폴더를 다시 고르면 게시본 카드가 생깁니다. 디자인, 접기, 배치를 고르고 「만들기」를 누릅니다.
"index.html 을 만들었습니다."라는 안내와 함께 자료 목록이 나옵니다. 그 폴더의 index.html을 두 번 누르면 브라우저에서 열리고 휴대폰 화면 크기에도 맞춰집니다.
디자인부터 손봅니다. 공개하기 전에 확인할 것을 살핀 뒤 다른 사람에게 보여 줍니다.
게시본 카드의 「디자인 손보기」를 누릅니다. 바탕 디자인, 강조색, 글꼴, 본문 폭, 사진 크기, 배치를 바꾸고 「미리보기에 반영」으로 확인합니다. 「이 게시본에만 저장」을 누르면 _메모.txt 윗단에 적히고, 「새 디자인으로 저장」을 누르면 다른 게시본에서도 고를 수 있게 됩니다.
나열, 바둑판, 목록, 슬라이드, 갤러리, 잡지, 타임라인의 7가지가 있습니다. 글이 많으면 나열이, 사진이 많으면 갤러리가, 날짜 흐름이 중요하면 타임라인이 잘 어울립니다.
학생 이름, 상담 기록, 연락처 같은 것은 남에게 보이면 안 됩니다. 이런 내용이 섞여 있지 않은지 직접 살펴봅니다. 제작기에는 아직 공개 전 개인정보 점검 기능이 없습니다.
_메모.txt에서 공개: 켜기로 바꿉니다. 만들어진 폴더를 Netlify Drop에 끌어다 놓으면 주소가 생깁니다. 깃허브 Pages로 올리는 방법은 12장과 제작기 저장소의 안내를 참고하세요.
| 할 일 | AI 없이 | AI를 켜면 |
|---|---|---|
| 폴더 훑어보기 · 디자인 추천 | 됩니다 | 똑같습니다 |
| 주제로 묶고 이름 짓기 | 낱말 기반이라 투박합니다 | 주제를 제대로 묶습니다 |
| 말로 적은 방향을 설정으로 | 적어 두기만 합니다 | 설정 줄로 옮겨 적자고 제안합니다 |
| 웹 페이지 · 디자인 · 게시 사이트 | 됩니다 | AI와 상관없습니다 |
AI를 켜면 자료의 제목, 날짜, 앞부분 200자만 보냅니다. 비용은 내 키로 내고 키는 만들어진 페이지나 저장소에 들어가지 않습니다.
바로 쓰기, 파일 받기, 템플릿, 포크 가운데 내게 맞는 방법을 고릅니다. 원하면 내 주소로 운영합니다.
세 도구는 모두 깃허브 공개 저장소에 있습니다. 쓰기만 할 때는 계정이 필요 없습니다. 내 계정에 사본을 두면 내 주소로 운영하거나 고쳐 써도 됩니다.
주소를 열어 씁니다. 기록장과 제작기, 교재에는 웹 주소가 있습니다. 기록장은 백업 파일(.pkem)로 내 기록을 보관합니다.
저장소의 초록색 「Code → Download ZIP」을 누릅니다. 제작기는 이 방법으로 디자인·게시본 폴더를 받습니다. 실행 파일은 오른쪽 「Releases」에 있습니다.
변환기 노트북에서 「Drive로 복사」를 누르면 내 드라이브의 Colab Notebooks 폴더에 내 것이 생깁니다.
「Use this template」로 내 계정에 사본을 만듭니다. Pages를 켜면 내아이디.github.io/저장소이름 주소가 생깁니다.
원본이 새 판으로 바뀔 때 따라가고 싶다면 「Fork」로 가져갑니다. 나중에 「Sync fork」를 누르면 새 판이 들어옵니다.
기록장을 예로 들었습니다. 변환기와 제작기 저장소도 순서는 같습니다.
깃허브에 로그인한 뒤 저장소 오른쪽 위 초록색 「Use this template」에서 「Create a new repository」를 누릅니다.
그림 12-2. 깃허브 화면을 단순하게 다시 그렸습니다. 이 단추는 로그인해야 보입니다.
Repository name에 이름(예: my-pkos)을 적고 「Public」을 고른 뒤 「Create repository」를 누릅니다. 무료 계정은 공개 저장소에서만 Pages를 켤 수 있습니다. 저장소에는 앱 파일만 들어가고 내 기록은 올라가지 않습니다.
그림 12-3. 새 저장소 만들기 화면입니다. 이름을 적고 공개를 고른 다음 만들기를 누릅니다.
새 저장소의 「Settings」에서 왼쪽 「Pages」로 갑니다. Source는 「Deploy from a branch」로 두고 Branch에서 main과 / (root)를 고른 뒤 「Save」를 누릅니다.
그림 12-4. Pages 설정 화면입니다. 저장하고 1~2분 뒤 새로 고침하면 위쪽에 내 주소가 나옵니다.
https://내아이디.github.io/my-pkos/가 열리면 끝입니다. 기록장이라면 주소 끝에 ?demo=1을 붙여 체험 서재를, manual/을 붙여 설명서를 확인해 보세요.
| 도구 | 가장 쉬운 방법 | 내 것으로 운영하려면 |
|---|---|---|
| 기록장 | 주소로 바로 쓰고 백업 파일(.pkem)을 보관합니다. | 템플릿으로 가져가 Pages를 켭니다. 내 주소의 서재는 원래 주소와 저장 공간이 따로입니다. |
| 변환기 | 코랩에서 「Drive로 복사」를 누릅니다. | Windows ZIP이나 교재 코드 zip을 받거나 템플릿으로 가져가 고쳐 씁니다. |
| 사이트 만들기 | Download ZIP으로 받고 제작기에서 그 폴더를 고릅니다. | 템플릿으로 가져가 Pages를 켜면 내 제작기 주소가 생깁니다. |
세 도구가 어떤 불편에서 시작했고 직접 써 보며 무엇을 고쳤는지 살펴봅니다.
“13년이 어디에 있는지 모릅니다. 분명히 있는데 꺼낼 수가 없습니다.”
“그래서 이번에는 정했습니다. 원본은 내가 가진다.”
만든 이의 개발 배경 글에서
수업안은 문서 폴더에, 사진은 사진첩에 있었고 생각은 블로그와 메모에 흩어져 있었습니다. 필요할 때 함께 꺼내 쓰고 작년의 경험에서 다음 수업을 시작하고 싶었습니다. 그래서 원본은 내가 가진다는 원칙을 세우고 도구를 하나씩 만들었습니다.
무엇이 필요한지, 어떻게 판단할지, 써 보니 어땠는지는 사람이 정했습니다. 코드 작성과 시험, 문서 정리는 AI와 함께 했습니다. 앱 안에 AI가 스스로 판단하는 기능이 들어 있다는 뜻은 아닙니다. 기술은 기록을 돕는 도구이고 무엇을 남기고 누구와 나눌지는 쓰는 사람이 정합니다.
이 사이트 주소 하나만 기억하면 세 도구로 모두 갈 수 있습니다.
legoschool.github.io/pkos-workshop
기록장, 변환기, 사이트 만들기의 사용법과 깃허브 주소를 모두 모아 두었습니다. 휴대폰으로 찍어 저장해 두고 실습은 PC에서 하세요.
기록장 · 체험 서재
기록장 · 사용 설명서
변환기 · 코랩
변환기 · 실습 교재
사이트 만들기 · 제작기[PKOS 도구 모음 · 기록장 · 변환기 · 사이트 만들기]
이 세 가지 도구는 흩어진 수업 자료와 생각을 다시 꺼내 쓸 수 있게 돕습니다.
사용법과 깃허브 주소를 한곳에 모아 두었습니다.
https://legoschool.github.io/pkos-workshop/
▶ 기록장 (PKOS 나의지식서재) · 로그인 없이 브라우저에 저장
체험 서재: https://legoschool.github.io/pkos-library/?demo=1
사용 설명서: https://legoschool.github.io/pkos-library/manual/
▶ 변환기 (PKOS 자료변환기) · 한글·PDF·블로그를 마크다운으로
https://github.com/legoschool/pkos-fileconverter
▶ 사이트 만들기 (웹 게시본 제작기) · 폴더 하나를 웹 페이지로
https://legoschool.github.io/pkos-publisher/제작기.html
기록장의 기록은 쓴 브라우저에만 남습니다. PC를 바꾸기 전에는 「설정 · 백업 → 첨부를 포함한 백업 내보내기」로 백업 파일을 받아 두세요.주어진 시간에 맞춰 블록을 고릅니다. 자주 막히는 곳은 미리 짚어 둡니다.
| 시간 | 블록 | 끝났을 때 확인할 행동 |
|---|---|---|
| 0–5분 | 13 만든 과정 · 세 도구 소개 | 세 도구의 이름과 순서를 말합니다 |
| 5–30분 | 01–03 기록장 | 「모든 기록」이 158이 됩니다 |
| 30–40분 | 06 변환기 (진행자 시연) | 마크다운으로 바뀐 가사를 함께 봅니다 |
| 40–52분 | 09–10 사이트 만들기 | 예시 폴더의 index.html을 엽니다 |
| 52–60분 | 05 백업 · 12 가져가기 · QR | 백업 파일을 찾고 QR을 저장합니다 |
| 시간 | 블록 | 끝났을 때 확인할 행동 |
|---|---|---|
| 0–10분 | 준비 · 13 만든 과정 | 내 자료가 흩어진 곳 세 군데를 적습니다 |
| 10–45분 | 01–05 기록장 | 연결 이유 창을 열고 백업 파일을 찾습니다 |
| 45–60분 | 06–07 변환기 | 샘플 변환 결과를 내려받습니다 |
| 60–80분 | 09–11 사이트 만들기 | 디자인을 바꿔 다시 만듭니다 |
| 80–90분 | 12 가져가기 · 정리 | 가져갈 도구와 방법을 정합니다 |
기록장만 깊이 다루고 싶다면 기록장 사용 설명서의 80분 실습 진행표를 쓰면 됩니다.
| 화면의 증상 | 확인할 곳과 다음 할 일 |
|---|---|
| 내려받은 파일을 못 찾을 때 | Ctrl+J로 다운로드 목록을 열거나 파일 고르기 창 왼쪽의 「다운로드」를 누릅니다. 파일이 있는 곳을 알면 탐색기에서 그 파일을 오른쪽 단추로 눌러 「경로로 복사」를 고르고 파일 고르기 창의 「파일 이름」 칸에 붙여 넣어도 됩니다. 시작하기 전에 진행자가 한 번 보여 주면 덜 막힙니다. |
| 기록장 위쪽에 보라색 띠가 없을 때 | 주소 끝의 ?demo=1이 빠진 경우입니다. 그 상태로 한 실습은 내 서재에 남습니다. |
| 다른 PC에서 기록이 안 보일 때 | 기록은 브라우저마다 따로 저장됩니다. 처음 쓴 곳에서 백업 파일을 내보내 가져오면 됩니다. |
| 코랩이 드라이브 연결에서 멈출 때 | 승인 창을 직접 눌러야 합니다. 주소창 오른쪽에 팝업 차단 표시가 있으면 허용해 주세요. |
| Windows 앱이 실행되지 않을 때 | 보안 설정은 바꾸지 말고 코랩이나 교재판으로 바꿔 진행합니다. |
| 제작기에서 폴더 고르기가 안 될 때 | PC의 크롬·엣지인지, 파일을 두 번 눌러 연 것이 아니라 주소로 열었는지 확인합니다. |
| 「원본 열기」가 새 탭으로 안 열릴 때 | 주소창 오른쪽의 팝업 차단 표시를 눌러 허용합니다. |
체크와 메모는 이 브라우저에만 저장됩니다. 위쪽 「학습 기록 내보내기」를 누르면 글 파일로 받을 수 있습니다.