"Busan Data Guide"의 두 판 사이의 차이

pnu_dhc
이동: 둘러보기, 검색
 
(같은 사용자의 중간 판 25개는 보이지 않습니다)
1번째 줄: 1번째 줄:
  
 +
<html lang="ko">
 +
<head>
 +
    <meta charset="UTF-8">
 +
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
 +
    <title>부산 지역 인문학 데이터 편찬 입문 가이드</title>
 +
    <style>
 +
        * {
 +
            margin: 0;
 +
            padding: 0;
 +
            box-sizing: border-box;
 +
        }
  
<div style="background: linear-gradient(to right, #4a7ba7 0%, #5a8bb7 100%); color: white; padding: 60px 40px; border-radius: 8px; margin-bottom: 0; text-align: center; border-bottom: 6px solid #2c3e50;">
+
        body {
  <h1 style="font-size: 2.4em; margin: 0 0 15px 0; font-weight: bold; padding: 0 0 20px 0; border-bottom: 3px solid rgba(255,255,255,0.3);">
+
            font-family: 'Noto Sans KR', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
    <span style="font-size: 1.2em;">📚</span> 부산 지역 인문학 데이터 편찬 입문 가이드
+
            line-height: 1.7;
  </h1>
+
            color: #2c3e50;
  <p style="font-size: 1.05em; margin: 0; line-height: 1.6;">부산광역시 문화유산과 시사편찬실 발간 도서 『부산을 빛낸 인물』과 『부산의 자연마을』의 디지털 데이터 변환</p>
+
            background-color: #f8f9fa;
</div>
+
            padding: 20px;
 +
        }
  
<div style="background-color: #2c5a7f; padding: 20px 40px; display: flex; gap: 25px; flex-wrap: wrap; align-items: center; font-size: 0.95em;">
+
        .container {
  <a href="#들어가며" style="color: white; text-decoration: none; padding: 8px 12px; transition: opacity 0.3s;">들어가며</a>
+
            max-width: 1200px;
  <a href="#전체" style="color: white; text-decoration: none; padding: 8px 12px; transition: opacity 0.3s;">전체 로드맵</a>
+
            margin: 0 auto;
  <a href="#데이터-구조" style="color: white; text-decoration: none; padding: 8px 12px; transition: opacity 0.3s;">데이터 구조(Excel)</a>
+
            background-color: white;
  <a href="#실전" style="color: white; text-decoration: none; padding: 8px 12px; transition: opacity 0.3s;">실전 예시</a>
+
            box-shadow: 0 2px 10px rgba(0,0,0,0.1);
  <a href="#ID" style="color: white; text-decoration: none; padding: 8px 12px; transition: opacity 0.3s;">ID 규칙</a>
+
            border-radius: 10px;
  <a href="#작업" style="color: white; text-decoration: none; padding: 8px 12px; transition: opacity 0.3s;">작업 프로세스</a>
+
            overflow: hidden;
  <a href="#실습" style="color: white; text-decoration: none; padding: 8px 12px; transition: opacity 0.3s;">실습 스프레드시트</a>
+
        }
  <a href="#XML" style="color: white; text-decoration: none; padding: 8px 12px; transition: opacity 0.3s;">XML 태깅</a>
 
  <a href="#QA" style="color: white; text-decoration: none; padding: 8px 12px; transition: opacity 0.3s;">Q&A</a>
 
</div>
 
  
== 📚 부산 지역 인문학 데이터 편찬 입문 가이드 ==
+
        /* Header - PNU DHC 스타일 */
 +
        header {
 +
            background: linear-gradient(135deg, #2b5a7a 0%, #3d6b8f 100%);
 +
            color: white;
 +
            padding: 40px;
 +
            text-align: center;
 +
        }
  
부산광역시 문화유산과 시사편찬실 발간 도서 『부산을 빛낸 인물』과 『부산의 자연마을』의 디지털 데이터 변환
+
        header h1 {
 +
            font-size: 2.2em;
 +
            margin-bottom: 10px;
 +
            font-weight: 700;
 +
            color: white;
 +
        }
  
 +
        header p {
 +
            font-size: 1.1em;
 +
            opacity: 0.95;
 +
        }
  
 +
        /* Navigation */
 +
        nav {
 +
            background-color: #1e4a66;
 +
            padding: 15px 40px;
 +
            position: sticky;
 +
            top: 0;
 +
            z-index: 100;
 +
        }
  
<div style="background-color: #34495e; padding: 15px 20px; border-radius: 6px; margin-bottom: 30px; display: flex; gap: 15px; flex-wrap: wrap;">
+
        nav ul {
<span style="color: white; padding: 8px 12px; border-radius: 4px;">[[#들어가며|들어가며]]</span>
+
            list-style: none;
<span style="color: white; padding: 8px 12px; border-radius: 4px;">[[#데이터 구조|데이터 구조]]</span>
+
            display: flex;
<span style="color: white; padding: 8px 12px; border-radius: 4px;">[[#ID 규칙|ID 규칙]]</span>
+
            flex-wrap: wrap;
<span style="color: white; padding: 8px 12px; border-radius: 4px;">[[#작업 프로세스|작업 프로세스]]</span>
+
            gap: 25px;
<span style="color: white; padding: 8px 12px; border-radius: 4px;">[[#XML|XML 태깅]]</span>
+
        }
</div>
 
  
== 📚 부산 지역 인문학 데이터 편찬 입문 가이드 ==
+
        nav a {
 +
            color: white;
 +
            text-decoration: none;
 +
            font-weight: 500;
 +
            transition: color 0.3s;
 +
        }
  
부산광역시 문화유산과 시사편찬실 발간 도서 『부산을 빛낸 인물』과 『부산의 자연마을』의 디지털 데이터 변환
+
        nav a:hover {
 +
            color: #ff6b35;
 +
        }
  
== 들어가며 ==
+
        nav a:visited {
 +
            color: white;
 +
        }
  
전체 로드맵
+
        /* Main Content */
 +
        main {
 +
            padding: 40px;
 +
        }
  
데이터 구조(Excel)
+
        section {
 +
            margin-bottom: 60px;
 +
            scroll-margin-top: 70px;
 +
        }
  
실전 예시
+
        h2 {
 +
            font-size: 2em;
 +
            color: #2b5a7a;
 +
            margin-bottom: 20px;
 +
            padding-bottom: 10px;
 +
            border-bottom: none;
 +
        }
  
ID 규칙
+
        h3 {
 +
            font-size: 1.5em;
 +
            color: #1e4a66;
 +
            margin: 30px 0 15px 0;
 +
        }
  
작업 프로세스
+
        h4 {
 +
            font-size: 1.2em;
 +
            color: #555;
 +
            margin: 20px 0 10px 0;
 +
        }
  
실습 스프레드시트
+
        p {
 +
            margin-bottom: 15px;
 +
        }
  
XML 태깅
+
        /* Info Boxes - 차분한 색상 */
 +
        .info-box {
 +
            background-color: #e8f2f7;
 +
            border-left: 4px solid #2b5a7a;
 +
            padding: 20px;
 +
            margin: 20px 0;
 +
            border-radius: 5px;
 +
        }
  
Q&A
+
        .warning-box {
 +
            background-color: #fff8e6;
 +
            border-left: 4px solid #ff9f43;
 +
            padding: 20px;
 +
            margin: 20px 0;
 +
            border-radius: 5px;
 +
        }
  
== 📖 들어가며: 부산 인문 자료의 디지털화 ==
+
        .success-box {
 +
            background-color: #e8f5e9;
 +
            border-left: 4px solid #4caf50;
 +
            padding: 20px;
 +
            margin: 20px 0;
 +
            border-radius: 5px;
 +
        }
  
본 프로젝트는 부산광역시 문화유산과 시사편찬실에서 발간한 『부산을 빛낸 인물』과 『부산의 자연마을』이라는 부산의 인문 자료를 디지털 데이터로 변환하는 기초 작업입니다.
+
        .tip-box {
 +
            background-color: #fff4e6;
 +
            border-left: 4px solid #ff6b35;
 +
            padding: 20px;
 +
            margin: 20px 0;
 +
            border-radius: 5px;
 +
        }
  
== 📚 프로젝트 규모 및 팀 구성 ==
+
        /* Tables */
 +
        .table-wrapper {
 +
            overflow-x: auto;
 +
            margin: 20px 0;
 +
        }
  
작업 대상 자료: 부산광역시사편찬위원회 자료실 및 부산 지역사 도서관에서 PDF 확인 가능
+
        table {
 +
            width: 100%;
 +
            border-collapse: collapse;
 +
            background-color: white;
 +
            box-shadow: 0 2px 5px rgba(0,0,0,0.1);
 +
        }
  
* 『부산의 자연마을』전 6권 : 약 2,400페이지
+
        th {
* 『부산을 빛낸 인물』전 3권 : 약 800페이지
+
            background-color: #2b5a7a;
 +
            color: white;
 +
            padding: 12px;
 +
            text-align: left;
 +
            font-weight: 600;
 +
        }
  
== 👥 팀 구성 (총 24명: 인문계 18명 + 이공계 6명) ==
+
        td {
 +
            padding: 12px;
 +
            border-bottom: 1px solid #ddd;
 +
        }
  
역할: 인문계-데이터 편찬 및 태깅 / 이공계-기술 지원 및 자동화
+
        tr:hover {
 +
            background-color: #f5f5f5;
 +
        }
  
=== A팀 ===
+
        /* Code Blocks */
 +
        .code-block {
 +
            background-color: #2c3e50;
 +
            color: #ecf0f1;
 +
            padding: 20px;
 +
            border-radius: 5px;
 +
            overflow-x: auto;
 +
            margin: 20px 0;
 +
            font-family: 'Courier New', monospace;
 +
            line-height: 1.5;
 +
        }
  
* 부산을 빛낸 인물 전 3권(총 800페이지)
+
        .code-inline {
* 인원: 6명 (인문계 4명 + 이공계 2명)
+
            background-color: #e8f2f7;
* 담당: 『부산을 빛낸 인물』 800페이지
+
            padding: 2px 6px;
* 총괄: 디지털인문학센터 연구전략부장
+
            border-radius: 3px;
 +
            font-family: 'Courier New', monospace;
 +
            color: #2b5a7a;
 +
            font-weight: 600;
 +
        }
  
=== B팀 ===
+
        /* Example Sections */
 +
        .example {
 +
            background-color: white;
 +
            border: 2px solid #2b5a7a;
 +
            padding: 20px;
 +
            border-radius: 8px;
 +
            margin: 20px 0;
 +
            box-shadow: 0 2px 5px rgba(0,0,0,0.08);
 +
        }
  
* 부산의 자연마을 제1, 2, 6권(총 1,200페이지)
+
        .example h4 {
* 인원: 9명 (인문계 7명 + 이공계 2명)
+
            color: #ff6b35;
* 담당: 『부산의 자연마을』 1,200페이지
+
            margin-top: 0;
* 총괄: 디지털인문학센터 교육지원부장
+
        }
  
=== C팀 ===
+
        /* Before/After Comparison */
 +
        .comparison {
 +
            display: grid;
 +
            grid-template-columns: 1fr 1fr;
 +
            gap: 20px;
 +
            margin: 20px 0;
 +
        }
  
* 부산의 자연마을 제3, 4, 5권(총 1,200페이지)
+
        .comparison-item {
* 인원: 9명 (인문계 7명 + 이공계 2명)
+
            padding: 15px;
* 담당: 『부산의 자연마을』 1,200페이지
+
            border-radius: 5px;
* 총괄: 디지털인문학센터 계약교수
+
        }
  
== 📊 인문계 학생 (각 팀 4~7명씩, 총 18명) 주요 역할 ==
+
        .before {
 +
            background-color: #fff5f5;
 +
            border: 2px solid #ff6b6b;
 +
        }
  
* PDF에서 추출한 텍스트를 Excel/구글 시트에 입력
+
        .after {
* 텍스트 유형 판단 (분류 작업)
+
            background-color: #f0f9f4;
* 의미 요소 식별 (XML 태깅을 위한 준비 작업)
+
            border: 2px solid #51cf66;
* 메타데이터(페이지, 장 번호 등 서지 정보 기록) 관리
+
        }
  
== 💻 이공계 학생 (각 팀 2명씩, 총 6명) 주요 역할 ==
+
        /* Checklist */
 +
        .checklist {
 +
            background-color: #fafafa;
 +
            padding: 20px;
 +
            border-radius: 8px;
 +
            margin: 20px 0;
 +
        }
  
* 파이썬 스크립트 개발 (태깅 마커 → XML 자동 변환)
+
        .checklist li {
* 데이터 검증 및 오류 체크 자동화
+
            margin: 10px 0;
* 팀 내 기술적 문제 실시간 지원
+
            padding-left: 30px;
* VSCode, Git 등 도구 활용 교육
+
            position: relative;
 +
        }
  
== 📊 작업 일정 계획 (2026년 1월~2월) ==
+
        .checklist li:before {
 +
            content: "☐";
 +
            position: absolute;
 +
            left: 0;
 +
            font-size: 1.2em;
 +
            color: #2b5a7a;
 +
        }
  
=== 📚 전체 분량 ===
+
        /* Spreadsheet Embed */
 +
        .spreadsheet-container {
 +
            margin: 30px 0;
 +
            border: 3px solid #2b5a7a;
 +
            border-radius: 8px;
 +
            overflow: hidden;
 +
        }
  
* 『부산을 빛낸 인물』: 총 800여 페이지 → 1개 팀 (6명) 담당
+
        .spreadsheet-header {
* 『부산의 자연마을』: 총 2,400여 페이지 → 2개 팀 (각 9명) 분담
+
            background-color: #2b5a7a;
** 1팀: 1,200페이지
+
            color: white;
** 2팀: 1,200페이지
+
            padding: 15px;
 +
            font-weight: 600;
 +
            display: flex;
 +
            justify-content: space-between;
 +
            align-items: center;
 +
        }
  
※ 각 팀원은 담당 권/장을 선정하여 2개월간 데이터 편찬 작업을 진행합니다.
+
        .spreadsheet-link {
 +
            background-color: white;
 +
            color: #2b5a7a;
 +
            padding: 8px 16px;
 +
            border-radius: 5px;
 +
            text-decoration: none;
 +
            font-size: 0.9em;
 +
            transition: all 0.3s;
 +
            font-weight: 600;
 +
        }
  
=== 💡 팀별 작업 진도 관리 팁 ===
+
        .spreadsheet-link:hover {
 +
            background-color: #f0f0f0;
 +
            transform: translateY(-2px);
 +
        }
  
* 일일/주간/월간 목표 정하기
+
        .spreadsheet-embed {
* 정기 모임: 매주 날짜와 시간을 정해 줌으로 진도 점검 등
+
            width: 100%;
* 비상 연락: 단톡방 개설/공동 작업 파일
+
            height: 600px;
 +
            border: none;
 +
        }
  
== 이제 책 속의 자료를 시맨틱 데이터로 변환하는 기초 작업을 진행할 예정입니다. 왜 이 작업이 필요할까요? ==
+
        /* Roadmap */
 +
        .roadmap {
 +
            background-color: #f8fafb;
 +
            padding: 30px;
 +
            border-radius: 10px;
 +
            margin: 30px 0;
 +
            border: 1px solid #e0e0e0;
 +
        }
  
부산광역시사편찬위원회 자료실에 PDF로 제공되는 도서는 한 번에 한 사람만 읽을 수 있지만, 디지털 데이터로 변환된 지식은:
+
        .roadmap-step {
 +
            display: flex;
 +
            align-items: flex-start;
 +
            margin: 20px 0;
 +
            padding: 20px;
 +
            background-color: white;
 +
            border-radius: 8px;
 +
            box-shadow: 0 2px 5px rgba(0,0,0,0.08);
 +
        }
  
* 💡 검색 가능: "1950년대 부산 영도구"라고 검색하면 관련된 모든 내용이 한눈에 보이게 만들 수 있습니다!
+
        .roadmap-number {
* 🔗 연결 가능: 인물과 장소, 사건이 서로 연결되어 새로운 통찰을 발견할 수 있습니다!
+
            background-color: #2b5a7a;
* 📊 분석 가능: 빈도, 패턴, 관계를 통해 보이지 않던 역사적 의미를 발견할 수 있습니다!
+
            color: white;
* 🌐 공유 가능: 전 세계 연구자들과 부산의 이야기를 나눌 수 있어요
+
            width: 50px;
 +
            height: 50px;
 +
            border-radius: 50%;
 +
            display: flex;
 +
            align-items: center;
 +
            justify-content: center;
 +
            font-size: 1.5em;
 +
            font-weight: bold;
 +
            margin-right: 20px;
 +
            flex-shrink: 0;
 +
        }
  
== 🔥 전체 로드맵: 3단계 여정 ==
+
        .roadmap-content h3 {
 +
            margin-top: 0;
 +
            color: #2b5a7a;
 +
        }
  
=== 1. 데이터 편찬(Data Compilation)현재 단계 ===
+
        /* Lists */
 +
        ul, ol {
 +
            margin: 15px 0 15px 30px;
 +
        }
  
* PDF → 텍스트 추출
+
        li {
* 구조화 → CSV 정리
+
            margin: 8px 0;
* 태깅 → XML 변환
+
        }
* 목표: 원천 자료를 DB에 업로드 가능한 형태로 구조화
 
  
=== 2. 데이터 분석(Data Analysis) ===
+
        /* Badges */
 +
        .badge {
 +
            display: inline-block;
 +
            padding: 5px 12px;
 +
            border-radius: 20px;
 +
            font-size: 0.85em;
 +
            font-weight: 600;
 +
            margin: 5px;
 +
        }
  
* 빈도 분석 & 키워드 추출
+
        .badge-primary {
* 관계 파악
+
            background-color: #2b5a7a;
* 의미 해석
+
            color: white;
* 목표: 구축된 데이터에서 학문적 의미와 패턴 도출
+
        }
  
=== 3. 데이터 설계(Data Modeling) ===
+
        .badge-success {
 +
            background-color: #4caf50;
 +
            color: white;
 +
        }
  
* 온톨로지 설계
+
        .badge-warning {
* 지식 그래프 구상
+
            background-color: #ff9f43;
* 활용 방안 기획
+
            color: white;
* 목표: 플랫폼 구축을 위한 데이터 모델링
+
        }
  
== 📊 우리 팀 데이터 구조 이해하기 ==
+
        .badge-danger {
 +
            background-color: #e74c3c;
 +
            color: white;
 +
        }
  
우리가 사용하는 구글 시트는 18개의 필드(열)로 구성되어 있어요. 각 필드가 왜 필요한지 함께 살펴볼까요?
+
        /* Fire Emoji Style for emphasis */
 +
        .fire-emoji {
 +
            color: #ff6b35;
 +
            font-size: 1.2em;
 +
        }
  
=== 💡 작업 단계별 사용 필드 ===
+
        /* Footer */
 +
        footer {
 +
            background-color: #1e4a66;
 +
            color: white;
 +
            padding: 30px;
 +
            text-align: center;
 +
        }
  
* 1단계 (csv): id, book_title, person_id, text_original, text_type
+
        /* Responsive */
* 2단계 (txt): text_original 컬럼만 별도로 text_tagged 작업
+
        @media (max-width: 768px) {
* 3단계 (xml): text_tagged 작업물 → XML 자동변환(파이썬 스크립트 개발)
+
            body {
 +
                padding: 10px;
 +
            }
  
=== 💡 중간 산출물: 총괄 교수님과 상의 후 팀별로 경과 보고 ===
+
            main {
 +
                padding: 20px;
 +
            }
  
=== 💡 최종 산출물: 권별.csv, 권별.txt, 권별.xml + 팀별 결과보고서(팀장을 정해서 한 명이 9개 파일 수합 후 이메일로 제출) ===
+
            header h1 {
 +
                font-size: 1.6em;
 +
            }
  
=== 💡 권별 파일명(부산 지역사 도서관 PDF파일명을 따름): lightuppeople01..., B_jayeonmaeul01... ===
+
            nav ul {
 +
                flex-direction: column;
 +
                gap: 10px;
 +
            }
  
== 🔑 핵심 필드 설명 ==
+
            .comparison {
 +
                grid-template-columns: 1fr;
 +
            }
  
| 필드명 | 예시 | 설명 | 작업자가 할 일 |
+
            .spreadsheet-header {
|-|-|-|-|
+
                flex-direction: column;
| id | txt_10001 | 텍스트 고유 번호 | 필수 반드시 부여 (중복 금지!) |
+
                gap: 10px;
| book_id | lightuppeople01 | 책 식별자 | 책마다 고정값 사용 |
+
            }
| book_title | 부산을_빛낸_인물 | 책 제목 | 언더바(_)로 연결 |
 
| sub_title | 20세기_이전_인물편 | 부제목 | 있는 경우만 입력 |
 
| publisher | 부산광역시_문화유산과_시사편찬실 | 발행처 | 책 정보 그대로 |
 
| pub_date | 2004.06 | 출판일 | YYYY.MM 형식 |
 
| chapter | 001 | 장 번호 | 3자리 숫자 (001, 002...) |
 
| page | 005 | 페이지 | 3자리 숫자 (005, 006...) |
 
| person_id | per_101_001 | 인물 고유 번호 | 필수 새 인물마다 부여 |
 
| name_ko | 최치원 | 인물 한글 이름 | 정확하게 입력 |
 
| name_ch | 崔致遠 | 인물 한자 이름 | 있는 경우만 입력 |
 
| topic | 해운대의_유래 | 소주제 | 섹션 제목 그대로 |
 
| author | 정경주_경성대교수 | 글쓴이 | 이름_소속 형식 |
 
| text_original | (본문 내용) | 원문 텍스트 | 필수 가장 중요! |
 
| text_type | normal / citation / poem | 텍스트 유형 | 집필자가 기술한 텍스트인지 인용문인지 등을 구별 |
 
| relation_note | txt_10008 | 관련 텍스트 ID | 연결된 경우만 |
 
| img_caption | 최치원_영정 | 이미지 설명 | 이미지 있을 때만 |
 
| remark | 번역문 / 원문 | 비고 | 필수 2월말에 결과보고서로 제출 |
 
  
== 🔢 ID 부여 규칙 마스터하기 ==
+
            .spreadsheet-embed {
 +
                height: 400px;
 +
            }
 +
        }
  
=== 1. 텍스트 ID (id) 규칙 ===
+
        /* Print Styles */
 +
        @media print {
 +
            nav {
 +
                display: none;
 +
            }
  
txt_10001, txt_10002, txt_10003...
+
            .spreadsheet-embed {
 +
                display: none;
 +
            }
  
* 형식: txt_ + 5자리 숫자
+
            section {
* 시작: 10001부터 시작
+
                page-break-inside: avoid;
* 연속성: 중간에 번호를 건너뛰지 않음
+
            }
* 고유성: 전체 데이터베이스에서 중복되면 안 됨!
+
        }
  
=== 2. 인물 ID (person_id) 규칙 ===
+
        /* Highlight Important Text */
 +
        strong {
 +
            color: #2b5a7a;
 +
        }
  
per_101_001, per_101_002, per_102_001...
+
        /* Links */
 +
        a {
 +
            color: #2b5a7a;
 +
            text-decoration: none;
 +
            transition: color 0.3s;
 +
        }
  
* 형식: per_ 10001
+
        a:hover {
* 책번호:
+
            color: #ff6b35;
** 10001 = 『부산을 빛낸 인물』 권1
+
            text-decoration: underline;
** 20001 = 『부산을 빛낸 인물』 권2
+
        }
** 40001 = 『부산의 자연마을』 권1
+
    </style>
* 인물번호: 책 내에서 등장 순서대로 10001, 10002 … 순으로 부여
+
</head>
 +
<body>
 +
    <div class="container">
 +
        <header>
 +
            <h1>📚 부산 지역 인문학 자료의 디지털화(Digitalization)</h1>
 +
            <p>『부산을 빛낸 인물』과 『부산의 자연마을』의 디지털 데이터 변환 </p>
 +
        </header>
  
=== 실전 예시 ===
+
        <nav>
 +
            <ul>
 +
                <li><a href="#intro">들어가며</a></li>
 +
                <li><a href="#roadmap">전체 로드맵</a></li>
 +
                <li><a href="#schedule">작업일정 계획</a></li>
 +
                <li><a href="#spreadsheet">작업 스프레드시트</a></li>
 +
                <li><a href="#xml-tagging">XML 태깅</a></li>
 +
            </ul>
 +
        </nav>
  
| 상황 | person_id | 설명 |
+
        <main>
|-|-|-|
+
            <!-- 들어가며 -->
| 최치원이 5페이지에서 처음 등장 | per_101_001 | 첫 번째 인물 |
+
            <section id="intro">
| 정서가 11페이지에서 처음 등장 | per_101_002 | 두 번째 인물 |
+
                <h2>📖 들어가며</h2>
| 최치원이 다시 15페이지에 등장 | per_101_001 | 동일 ID 재사용! |
+
               
 +
                <p>본 프로젝트는 부산광역시 문화유산과 시사편찬실에서 발간한 『부산을 빛낸 인물』과 『부산의 자연마을』이라는 부산의 인문 자료를 디지털 데이터로 변환하는 기초 작업입니다.</p>
  
※ 인물 등장 순서대로 번호 부여: 페이지 순서가 아니라 등장 순서
+
                <h3>📚 프로젝트 규모 및 팀 구성</h3>
 +
               
 +
                <div class="info-box">
 +
                    <p> <strong>작업 대상 자료</strong>: 부산광역시사편찬위원회 자료실 또는 부산 지역사 도서관에서 PDF 다운로드 & 모든 팀원 활동일지 다운로드</p>
 +
                    <ul>
 +
                        <li><strong> <a href="https://busandabom.net/index.nm?menuCd=105">『부산의 자연마을』전 6권</a> </strong> </li>
 +
                        <li><strong> <a href="https://busandabom.net/index.nm?menuCd=110">『부산을 빛낸 인물』전 3권</a> </strong> </li>
 +
                        <li><strong> <a href="https://script.google.com/macros/s/AKfycbxWAfQ8l8_BEurbtQq8hAFS76zWnxnj8O3nNjEFo_rGdDkWMQcjkmaCVas5eREZxTV1/exec" target="_blank">오리엔테이션 출석체크</a></strong> </li>
 +
                        <li><strong> <a href="https://docs.google.com/document/d/1I-bov6PDifJkqLkjBKopsXauVQU5NWSySAi_VA1BxG4/edit?usp=sharing">보조연구원 활동일지 서식 보기(hwp파일로 개별 배포 예정)</a> </strong> </li>
 +
                    </ul>
 +
                </div>
  
※ 같은 인물은 같은 ID: 여러 페이지 혹은 다른 책에 등장해도 ID는 하나(인물별 주민번호처럼 사용)
+
                <div class="roadmap" style="margin-top: 20px;">
 +
                    <h4 style="color: #2b5a7a; margin-bottom: 15px;">👥 역할 분담 (총 26명: 인문계 23명 + 이공계 3명)</h4>
 +
                    <p><strong>역할:</strong> 인문계 학생들은 텍스트 구조화(EXCEL) 및 태깅(XML) + 이공계 학생들은 기술 지원 및 자동화</p>
 +
                   
 +
                    <div class="roadmap-step">
 +
                        <div class="roadmap-number">A팀</div>
 +
                        <div class="roadmap-content">
 +
                            <h3 style="margin-top: 0;"> 『부산을 빛낸 인물』전 3권 (780 페이지)</h3>
 +
                            <ul>
 +
                                <li><strong>구조화:</strong> 황인영, 이선영 (390페이지씩) </li>
 +
                                <li><strong>태깅:</strong> 박하영, 김남희, 최은 </li>
 +
                                <li><strong>검수:</strong> 박수연 </li>
 +
                            </ul>
 +
                        </div>
 +
                    </div>
  
※ 엑셀 필터 활용: 이미 부여된 인물 ID 확인하기
+
                    <div class="roadmap-step">
 +
                        <div class="roadmap-number">B팀</div>
 +
                        <div class="roadmap-content">
 +
                            <h3 style="margin-top: 0;">『부산의 자연마을』제1, 2, 6권(1,140여 페이지)</h3>
 +
                            <ul>
 +
                                <li><strong>구조화:</strong> 김수민, 김주난, 임승주 (380페이지씩) </li>
 +
                                <li><strong>태깅:</strong> 김수인, 김민경, 홍정빈 </li>
 +
                                <li><strong>검수:</strong> 정재환 </li>
 +
                            </ul>
 +
                        </div>
 +
                    </div>
  
== 🛠️ 단계별 작업 프로세스 ==
+
                    <div class="roadmap-step">
 +
                        <div class="roadmap-number">C팀</div>
 +
                        <div class="roadmap-content">
 +
                            <h3 style="margin-top: 0;">『부산의 자연마을』제3, 4, 5권(1,140여 페이지) </h3>
 +
                            <ul>
 +
                                <li><strong>구조화:</strong> 김수영, 엄미연, 윤채영 (380페이지씩) </li>
 +
                                <li><strong>태깅:</strong> 우지성, 임혜민, 조혜원 </li>
 +
                                <li><strong>검수:</strong> 노수미 </li>
 +
                            </ul>
 +
                        </div>
 +
                    </div>
  
=== STEP 1: PDF에서 텍스트 추출 ===
+
                    <div class="roadmap-step">
 +
                        <div class="roadmap-number">D팀</div>
 +
                        <div class="roadmap-content">
 +
                            <h3 style="margin-top: 0;"> 전체 작업 (약 3,000 페이지)</h3>
 +
                            <ul>
 +
                                <li><strong>원본 파일(txt):</strong> 이다원, 최나영 (1500페이지씩) </li>
 +
                                <li><strong>표, 이미지 및 전체 검수:</strong> 윤수현 </li>
 +
                                <li><strong>전처리 및 XML 변환:</strong> 강주연, 박지현, 박비원 </li>
 +
                            </ul>
 +
                        </div>
 +
                    </div>
  
* 방법 1: 부산 지역사 도서관에서 pdf 다운로드(파일명 확인)
 
* PDF 파일에서 문단 단위로 Ctrl+C (복사) → 엑셀에 도서의 페이지, 챕터 번호,  챕터명(한글: name_ko, 한문: name_ch), 장제목(topic)확인 하면서 원문을 text_original 컬럼에 Ctrl+V (붙여넣기)
 
* 텍스트 문단별 (txt_id) 부여, 인물별 (per_id) 부여, 집필자 (author) 확인
 
* 인용문 등의 text_type 표기, 이어지는 문단 및 이미지 삽입 위치(relation_note) 입력, 이미지 캡션, 도서 정보 채우기(시트마다 동일)
 
* 기타 기록사항(remark)은 기계 학습보다 사람이 참고하는 컬럼이므로 자유롭게 기술, 논의가 필요한 부분이나 애매한 부분, 임의로 처리한 부분들을 기재한 후 나중에 모아서 결과보고서 양식에 맞게 작성하여 제출
 
* 띄어쓰기는 _표시
 
  
=== STEP 2: 텍스트 전처리 ===
+
                    <div class="tip-box" style="margin-top: 20px;">
 +
                        <strong>📊 A~C팀의 역할</strong>
 +
                        <ul>
 +
                            <li>구조화: PDF에서 추출한 텍스트를 팀별 작업 시트에 입력</li>
 +
                            <li>매주 일정 분량씩 검수자에게 제출</li>
 +
                            <li>태깅: 의미 요소 식별 (XML 태깅을 위한 준비 작업)</li>
 +
                            <li>검수: 누락된 부분 없는지 확인 및 작업 일정 관리</li>
 +
                        </ul>
 +
                    </div>
  
정규표현식:  
+
                    <div class="tip-box" style="margin-top: 20px;">
 +
                        <strong>💻 D팀의 역할</strong>
 +
                        <ul>
 +
                            <li>파이썬 스크립트 개발 (태깅 마커 [P][/P] → XML 자동 변환)</li>
 +
                            <li>데이터 검증 및 오류 체크 자동화</li>
 +
                            <li>팀 내 기술적 문제 실시간 지원</li>
 +
                            <li>VScode, Git 등 도구 활용 지원</li>
 +
                        </ul>
 +
                    </div>
 +
                </div>
  
* 중복된 단어로 인식하므로 괄호와 괄호 안의 모든 문자를 찾아서 제거: clean_text = re.sub(r'([^)]*)', '', text)
+
                <h3> 이제 책 속의 자료를 시맨틱 데이터로 변환하는 기초 작업을 진행할 예정입니다. 왜 이 작업이 필요할까요?</h3>
* 형태소 분석시 같이 추출될 있으므로 한글, 영어, 숫자, 공백을 제외한 모든 특수문자 제거(따옴표, 괄호, 꺽쇠, 마침표 등 싹 지워짐): clean_text = re.sub(r'[^ws]', '', text)
+
               
 +
                <div class="info-box">
 +
                    <p>부산광역시사편찬위원회 자료실에 PDF로 제공되는 도서는 한 번에 한 사람만 읽을 있지만, 디지털 데이터로 변환된 지식은:</p>
 +
                    <ul>
 +
                        <li>💡 <strong>검색 가능</strong>: "1950년대 부산 영도구"라고 검색하면 관련된 모든 내용이 한눈에 보이게 만들 수 있습니다!</li>
 +
                        <li>🔗 <strong>연결 가능</strong>: 인물과 장소, 사건이 서로 연결되어 새로운 통찰을 발견할 수 있습니다!</li>
 +
                        <li>📊 <strong>분석 가능</strong>: 빈도, 패턴, 관계를 통해 보이지 않던 역사적 의미를 발견할 수 있습니다!</li>
 +
                        <li>🌐 <strong>공유 가능</strong>: 전 세계 연구자들과 부산의 이야기를 나눌 수 있어요</li>
 +
                    </ul>
 +
                </div>
 +
            </section>
  
text_original 문장을 메모패드 등에서 정규표현식으로 전처리 작업
 
  
| text_original | 전처리 작업 후 |
+
            <!-- 전체 로드맵 -->
|-|-|
+
            <section id="roadmap">
| 사람은 땅의 정기를 받아 태어나고, 땅은 사람으로 인하여 이름을 얻게 된다. 한반도 동남쪽 끝 바닷가의 한 모퉁이에 있는 해운대는 천년 전 신라의 학사 최치원이 머물며 자취를 남긴 곳이다. 지금도 동백섬 동남쪽 해변에는 "해운대(海雲臺)"라 새긴 글자가 남아 있는데, 최치원이 쓴 글씨라고 전해온다. | 사람은 땅의 정기를 받아 태어나고, 땅은 사람으로 인하여 이름을 얻게 된다. 한반도 동남쪽 끝 바닷가의 한 모퉁이에 있는 해운대는 천년 전 신라의 학사 최치원이 머물며 자취를 남긴 곳이다. 지금도 동백섬 동남쪽 해변에는 해운대라 새긴 글자가 남아 있는데, 최치원이 쓴 글씨라고 전해온다. |
+
                <h2><span class="fire-emoji">🔥</span> 전체 로드맵: 3단계 여정</h2>
 +
               
 +
                <div class="roadmap">
 +
                    <div class="roadmap-step">
 +
                        <div class="roadmap-number">1</div>
 +
                        <div class="roadmap-content">
 +
                            <h3>디지털화(Digitalization) 기초 작업<p style="display: inline-block; padding: 5px 12px; border-radius: 20px; font-size: 0.85em; font-weight: 600; background-color: #ff6b35; color: white; margin: 5px;">현재 단계</p></h3>
 +
                            <ul>
 +
                                <li>PDF → 텍스트 추출</li>
 +
                                <li>구조화 → CSV 정리</li>
 +
                                <li>태깅 → XML 변환</li>
 +
                            </ul>
 +
                            <p><strong>목표:</strong> 원천 자료를 DB에 업로드 가능한 형태로 구조화</p>
 +
                        </div>
 +
                    </div>
  
1월 16일까지 excel 파일 제출
+
                    <div class="roadmap-step">
 +
                        <div class="roadmap-number">2</div>
 +
                        <div class="roadmap-content">
 +
                            <h3>데이터 분석(Data Analysis)</h3>
 +
                            <ul>
 +
                                <li>빈도 분석 & 키워드 추출</li>
 +
                                <li>관계 파악</li>
 +
                                <li>의미 해석</li>
 +
                            </ul>
 +
                            <p><strong>목표:</strong> 구축된 데이터에서 학문적 의미와 패턴 도출</p>
 +
                        </div>
 +
                    </div>
  
1월 23일까지 전처리 작업한 txt 제출
+
                    <div class="roadmap-step">
 +
                        <div class="roadmap-number">3</div>
 +
                        <div class="roadmap-content">
 +
                            <h3>데이터 설계(Data Modeling)</h3>
 +
                            <ul>
 +
                                <li>온톨로지 설계</li>
 +
                                <li>지식 그래프 구상</li>
 +
                                <li>활용 방안 기획</li>
 +
                            </ul>
 +
                            <p><strong>목표:</strong> 플랫폼 구축을 위한 데이터 모델링</p>
 +
                        </div>
 +
                    </div>
 +
                </div>
  
1월25일까지 검수 완료, xml에 대한 완성된 지침을 발송할 예정
+
            </section>
  
== 최종 체크리스트 ==
 
  
작업 완료 전에 꼭 확인하세요!
+
 +
            <!-- 주차별 작업 계획 -->
 +
            <section id="schedule">
 +
                <h2>📊 작업일정 계획 (2026년 1월~2월)</h2>
  
* id가 연속되어 있나요? (txt_10001 → txt_10002 → txt_10003)
+
<div style="text-align: center; margin: 40px 0;">
* person_id가 올바르게 부여되었나요?(부산인물)
+
    <div style="display: inline-block; border-radius: 8px; box-shadow: 0 4px 15px rgba(0,0,0,0.1); overflow: hidden; border: 1px solid #eee;">
* place_id가 올바르게 부여되었나요?(자연마을)
+
        <img src="https://dh.aks.ac.kr/~kimseoyun/wiki/images/8/8c/Timeline.jpg"
* 같은 인물이 다른 도서에도 나오는지 확인하고  person_id를 사용했나요?(중요)
+
            alt="부산 인문자료 디지털화 온보딩 타임라인"
* 인용문의 경우 text_type에 표시되어 있나요?
+
            style="width: 1000px; max-width: 100%; height: auto; display: block;">
* 시의 원문과 번역문을 분리했나요?
+
    </div>
* relation_note로 관련 텍스트를 연결했나요?(이미지 위치 확인 포함)
+
    <p style="margin-top: 10px; color: #666; font-size: 0.9em;">부산 인문자료 디지털화 온보딩 타임라인</p>
* 한자 이름이 있는 경우 name_ch에 입력했나요?
+
</div>
* 도서 정보와 집필자 정보 정확하게 기입했나요?
 
* 전처리 작업물 중 누락된 부분은 없나요?(분석작업 시 방해요소 없는지 확인)
 
 
 
** 형태소 분석이나 토픽모델링 등의 분석을 진행할 파일이니 방해요소는 과감하게 다 지우셔도 됩니다. 그래야 토픽모델링 결과가 깔끔하게 잘 나옵니다!
 
 
 
== STEP 3: XML태깅 ==
 
 
 
🏷️ XML 태깅이란? 데이터에 의미를 부여하는 작업입니다. CSV로 정리한 텍스트에 의미론적 태그(Semantic Tags)를 붙여서 컴퓨터가 "누가", "어디서", "언제" 같은 정보를 컴퓨터가 이해할 수 있게 만드는 작업입니다.
 
 
 
=== 🎯 왜 XML 태깅이 필요한가요? ===
 
 
 
태깅 전 (일반 텍스트)
 
 
 
최치원은 857년에 경주에서 태어났다.→ 컴퓨터는 그냥 글자로만 인식
 
 
 
태깅 후 (XML)
 
 
 
<persName>최치원</persName>
 
<date when="857">857년</date>에
 
<placeName>경주</placeName>에서 태어났다.
 
 
 
→ 인물, 시간, 장소를 구분해서 인식!
 
 
 
== 📚 온톨로지 설계 참고: 광주인문도시 사례 ==
 
 
 
우리 프로젝트는 광주인문도시스토리플랫폼의 온톨로지 설계를 참고합니다:
 
 
 
🔗 광주 온톨로지 Class 설계 보기
 
 
 
광주 사례에서는 Person, Place, Event, Organization, Artifact 등의 클래스를 정의했습니다. 우리는 이를 부산 지역 특성에 맞게 적용할 예정입니다.
 
 
 
== 🎯 단계별 태깅 전략 (난이도별 접근) ==
 
 
 
=== 1차 작업 (필수) - 가장 명확한 요소 ===
 
 
 
현재 작업 단계
 
 
 
| 요소 | 마커 | 설명 |
 
|-|-|-|
 
| 인명 | [P]최치원[/P] | 사람 이름 (판단 쉬움) |
 
| 지명 | [L]영도구[/L] | 장소, 지역명 (판단 쉬움) |
 
 
 
💡 추천: 현재의 기초 작업에서는 인명과 지명, 날짜(연도)에 특히 집중하는 것을 권장합니다!
 
 
 
✅ 판단이 가장 명확
 
 
 
✅ 작업 속도가 빠름
 
 
 
✅ 온톨로지 핵심인 "누가-어디서" 관계망 우선 구축
 
 
 
=== 2차 작업 (선택) - 조금 더 복잡 ===
 
 
 
| 요소 | 마커 | 설명 |
 
|-|-|-|
 
| 기관명 | [O]동래부[/O] | 단체, 조직, 관청 |
 
| 서명 | [B]동래부지[/B] | 책, 문서, 작품명 |
 
| 시간 | [D]1876년[/D] | 날짜, 연도, 시대 |
 
 
 
진행 시기: 1차 작업 완료 후 또는 동시 진행 가능
 
 
 
=== 3차 작업 (고급) - 전문가 검수 필요 ===
 
 
 
| 요소 | 마커 | 설명 |
 
|-|-|-|
 
| 문화유산 | [H]동래읍성[/H] | 유적, 문화재, 건축물 |
 
| 사건명 | [E]임진왜란[/E] | 역사적 사건, 행사 |
 
| 작품명 | [W]해운대가[/W] | 시, 그림, 예술작품 |
 
 
 
진행 시기: 데이터 분석 및 설계 단계에서 정밀하게 진행될 예정이나, 명확한 판단이 가능하다면 기초 작업에서 작업 가능합니다.
 
 
 
※ 문화유산과 지명, 작품명과 서명의 구분이 애매할 수 있으므로 검수자 확인 반드시 필요
 
 
 
== 🔍 1차 작업: 인명 + 지명 태깅 실전 ==
 
 
 
=== 예시 1: 『부산을 빛낸 인물』 ===
 
 
 
원문:
 
 
 
최치원은 857년(헌안왕 원년)에 신라의 서울 경주에서 태어났다. 868년(경문왕 8)에 12세의 나이로 당나라에 들어갔다.
 
 
 
1차 태깅 (인명 + 지명+날짜만):
 
 
 
[P]최치원[/P]은 [D]857년(헌안왕 원년)[/D]에 [L]신라[/L]의 서울 [L]경주[/L]에서 태어났다. [D]868년(경문왕 8)[/D]에 12세의 나이로 [L]당나라[/L]에 들어갔다.
 
 
 
=== 예시 2: 『부산의 자연마을』 ===
 
 
 
원문:
 
 
 
영도구 동삼동은 조선시대에는 절영도의 일부였다. 1876년 개항 이후 일본인들이 거주하기 시작했으며, 1942년 부산부에 편입되었다.
 
 
 
1차 태깅 (인명 + 지명+날짜만):
 
 
 
[L]영도구[/L] [L]동삼동[/L]은 조선시대에는 [L]절영도[/L]의 일부였다. [D]1876년[/D] 개항 이후 일본인들이 거주하기 시작했으며, [D]1942년[/D] [L]부산부[/L]에 편입되었다.
 
 
 
💡 판단 기준
 
 
 
역할 분담: 3단계 워크플로우
 
 
 
인문계 학생 - Excel/Google Sheets에서 태깅
 
 
 
* text_original 열 오른쪽에 새 열 text_tagged 추가
 
* 인명과 지명, 날짜에 마커 표시:
 
** 인명: [P]최치원[/P]
 
** 지명: [L]경주[/L]
 
 
 
이공계 학생 - 파이썬으로 XML 자동 변환
 
 
 
* text_tagged 컬럼의 마커 표시된 문장
 
* XML 태그로 변환(TEI 준수)
 
* XML 파일로 출력
 
* 샘플 작업 후 먼저 연구책임자 검토
 
* 검토 의견 반영 후 Python으로 자동화 작업 시작
 
* VSCode(Visual Studio Code )로 XML 검수 및 수정 작업
 
 
 
✅ XML 구문 하이라이팅 (오류를 쉽게 발견)
 
 
 
✅ 태그 자동 완성
 
 
 
✅ 검색 & 일괄 치환 기능
 
  
✅ 확장 프로그램으로 XML 검증 가능
 
  
* 태그가 올바르게 닫혔는가? (<persName>...</persName>)
+
            <!-- 작업 스프레드시트 -->
* 잘못된 마커가 남아있지 않은가? ([P] → <persName>)
+
            <section id="spreadsheet">
* 중첩된 태그가 있는가? (수정 필요)
+
                <h2>💻 실습용 작업 스프레드시트</h2>
* 인명/지명/날짜 구분이 올바른가?
 
  
== xml 규칙: 같은 내용도 나올 때마다 계속 표기, id는 처음에 한번, 그다음은 ref 속성(#은 문서 내에 있는 id 참조하라는 의미) ==
+
                <p>아래는 우리 팀이 실제로 작업하는 구글 시트입니다. 실시간으로 데이터를 확인하고 입력할 수 있어요.</p>
  
만약 첫 번째에만 태깅하고 두 번째부터는 그냥 텍스트로 둔다면, 나중에 플랫폼에서 이런 검색이 불가능해집니다. "최치원이 '해운대'와 같이 등장하는 문장을 다 찾아줘"
+
                <div class="spreadsheet-container">
 +
                    <div class="spreadsheet-header">
 +
                        <span>📊 PNU_DHC 플랫폼 데이터 작업 시트</span>
 +
                        <a href="https://docs.google.com/spreadsheets/d/1beVxX1Q-xRAyHOxjk-u3YLYszGZjftkONu_EtR0n9yM/edit?gid=0#gid=0"
 +
                          target="_blank"
 +
                          class="spreadsheet-link">
 +
                          새 탭에서 열기 →
 +
                        </a>
 +
                    </div>
 +
                    <iframe class="spreadsheet-embed"
 +
                            src="https://docs.google.com/spreadsheets/d/1beVxX1Q-xRAyHOxjk-u3YLYszGZjftkONu_EtR0n9yM/edit?gid=0&single=true&widget=true&headers=false&rm=minimal">
 +
                    </iframe>
 +
                </div>
  
태깅 안 했을 때: 컴퓨터는 뒤에 나오는 '최치원'을 그냥 글자(가나다)로만 인식해서, 인물과의 관계를 못 찾습니다.
+
                <div class="info-box">
 +
                    <strong>💡 스프레드시트 사용 팁</strong>
 +
                    <ul>
 +
                        <li>위 임베드 창에서 바로 데이터를 확인할 수 있어요</li>
 +
                        <li>실제 입력은 "새 탭에서 열기" 버튼을 클릭해서 진행하세요</li>
 +
                        <li>여러 사람이 동시에 작업할 수 있어요 (실시간 공동 편집)</li>
 +
                        <li>변경 이력은 자동으로 저장됩니다</li>
 +
                    </ul>
 +
                </div>
 +
  
태깅 했을 때: 문서의 어느 위치에 있든 <persName> 태그가 붙어 있으므로 모든 결과를 긁어올 수 있습니다.
+
 
  
tip: 처음에 나오는 최치원에서 태그하고, 그 다음에는 찾기 바꾸기(Ctrl+H) 기능으로 최치원 찾아서 <persName ref="#per_01">최치원</persName> 모두 바꾸기, 대명사는 태깅 안 함
+
            <!-- XML 태깅 가이드 -->
 +
            <section id="xml-tagging">
 +
  
== <요소명 속성="속성값">(시작태그)콘텐츠</요소명>(끝태그) ==
+
                <h2>🎯 단계별 XML 태깅 전략 (난이도별 접근)</h2>
  
=== 인명 <persName> ===
+
                <div class="roadmap">
 +
                    <div class="roadmap-step" style="background-color: #e8f5e9;">
 +
                        <div class="roadmap-number" style="background-color: #4caf50;">1</div>
 +
                        <div class="roadmap-content">
 +
                            <h3 style="margin-top: 0; color: #4caf50;">1차 작업 (필수) - 가장 명확한 요소</h3>
 +
                            <p><span class="badge badge-success">현재 작업 단계</span></p>
 +
                            <table style="margin-top: 10px; width: 100%;">
 +
                                <tr>
 +
                                    <td><strong>인명</strong></td>
 +
                                    <td><code class="code-inline">[P]최치원[/P]</code></td>
 +
                                    <td>사람 이름 (판단 쉬움)</td>
 +
                                </tr>
 +
                                <tr>
 +
                                    <td><strong>지명</strong></td>
 +
                                    <td><code class="code-inline">[L]영도구[/L]</code></td>
 +
                                    <td>장소, 지역명 (판단 쉬움)</td>
 +
                                </tr>
 +
                            </table>
 +
                            <p style="margin-top: 10px;"><strong>💡 추천:</strong> 학부생 기초 작업은 <strong>인명과 지명만</strong> 집중하는 것을 권장합니다!</p>
 +
                            <ul style="margin-top: 10px;">
 +
                                <li>✅ 판단이 가장 명확</li>
 +
                                <li>✅ 작업 속도가 빠름</li>
 +
                                <li>✅ 온톨로지 핵심인 "누가-어디서" 관계망 우선 구축</li>
 +
                            </ul>
 +
                        </div>
 +
                    </div>
  
최치원의 경우 per_id가 부여되어 있음(속성) <persName id="per_10001">최치원</person>
+
                    <div class="roadmap-step" style="background-color: #fff8e6;">
 +
                        <div class="roadmap-number" style="background-color: #ff9f43;">2</div>
 +
                        <div class="roadmap-content">
 +
                            <h3 style="margin-top: 0; color: #ff9f43;">2차 작업 (선택) - 조금 더 복잡</h3>
 +
                            <table style="margin-top: 10px; width: 100%;">
 +
                                <tr>
 +
                                    <td><strong>시간</strong></td>
 +
                                    <td><code class="code-inline">[D]1876년[/D]</code></td>
 +
                                    <td>날짜, 연도, 시대</td>
 +
                                </tr>
 +
                                <tr>
 +
                                    <td><strong>기관명</strong></td>
 +
                                    <td><code class="code-inline">[O]동래부[/O]</code></td>
 +
                                    <td>단체, 조직, 관청</td>
 +
                                </tr>
 +
                                <tr>
 +
                                    <td><strong>서명</strong></td>
 +
                                    <td><code class="code-inline">[T]동래부지[/T]</code></td>
 +
                                    <td>책, 문서, 작품명</td>
 +
                                </tr>
 +
                            </table>
 +
                            <p style="margin-top: 10px;"><strong>진행 시기:</strong> 1차 작업 완료 후 또는 동시 진행 가능</p>
 +
                        </div>
 +
                    </div>
  
"최치원의 아버지는 견일(肩逸)인데," → 한자 포함해서 태깅 <persName>견일(肩逸)</persName> → 나중에 id 부여할 예정, 한번 태깅했으면 계속 태깅, 최치원의 아버지는 최치원을 가리키는 것이 아니라 최견일을 가리키는 것이므로, 최치원(id)으로 태깅 안 함, 자호 같은 이명이 등장하는 경우는 태깅
+
                    <div class="roadmap-step" style="background-color: #f3e5f5;">
 +
                        <div class="roadmap-number" style="background-color: #9c27b0;">3</div>
 +
                        <div class="roadmap-content">
 +
                            <h3 style="margin-top: 0; color: #9c27b0;">3차 작업 (고급) - 전문가 검수 필요</h3>
 +
                            <table style="margin-top: 10px; width: 100%;">
 +
                                <tr>
 +
                                    <td><strong>문화유산</strong></td>
 +
                                    <td><code class="code-inline">[H]동래읍성[/H]</code></td>
 +
                                    <td>유적, 문화재, 건축물</td>
 +
                                </tr>
 +
                                <tr>
 +
                                    <td><strong>사건명</strong></td>
 +
                                    <td><code class="code-inline">[E]임진왜란[/E]</code></td>
 +
                                    <td>역사적 사건, 행사</td>
 +
                                </tr>
 +
                                <tr>
 +
                                    <td><strong>작품명</strong></td>
 +
                                    <td><code class="code-inline">[W]해운대가[/W]</code></td>
 +
                                    <td>시, 그림, 예술작품</td>
 +
                                </tr>
 +
                            </table>
 +
                            <p style="margin-top: 10px;"><strong>진행 시기:</strong> 데이터 분석 및 설계 단계에서</p>
 +
                            <p style="font-size: 0.9em; color: #666;">※ 문화유산과 지명, 작품명과 서명의 구분이 애매할 수 있어 전문가 판단 필요</p>
 +
                        </div>
 +
                    </div>
 +
                </div>
 +
</section>
  
=== 지명 <placeName> ===
 
  
해운대(海雲臺) → <place>해운대(海雲臺)</place>
+
 
 +
        </main>
  
=== 고유명사 <name> 시간으로 쓰면 부사이나 주어가 될 수 있음(예: 시대, 왕조, 사건명 등) ===
+
        <footer>
 
+
            <p>&copy; 2025 부산대학교 디지털인문학센터 (Digital Humanities Center of Pusan National University)</p>
<name type="dynasty">신라</name>
+
            <p>PNU Knowledge Base 로컬 인문학 프로젝트</p>
 
+
            <p style="margin-top: 10px; font-size: 0.9em;">
=== 시간 <date>: 숫자로 표시 가능한 콘텐츠 ===
+
                문의 및 결과물 제출: 김서윤 sy527991@pusan.ac.kr | 051-510-1594 | 최종 업데이트: 2025년 12월 20일
 
+
            </p>
857년(헌안왕 원년) → <date when="0857">857년(헌안왕 원년)</date> when의 속성값은 반드시 서기 연도 4자리를 함께 입력
+
        </footer>
 
+
    </div>
== 예시 ==
+
</body>
 
 
<persName xml:id="per_10001">최치원</person>은  <date when="0857">857년(헌안왕 원년)</date>에 <name type="period">신라</name>의 서울 <place>경주</place>에서 태어났다. <place>경주</place>의 최씨는 본디 <name type="period">신라</name> 육촌의 하나인 <place>본피부(本彼部)</place>에서 비롯하였다. <persName ref="#per_10001">최치원</person>의 고택은 <name type="period">고려</name>중엽까지 <place>황룡사</place> 남쪽에 남아 있었다고 한다. 최치원의 아버지는 <persName name="최견일">견일(肩逸)</person>인데, 그 선조가 어떤 사람인지에 대하여는 밝혀진 것이 없다. <persName ref="#per_10001">최치원</person>은 <date when="0857">868년(경문왕 8)</date>에 12세의 나이로 배를 타고 <name type="period">당나라</name>에 들어갈 때, 그의 부친이 당부한 말을 종신토록 잊지 못하였다. 그는 나중에 지은 글에 당시 그 아버지가 하신 말씀을 옮겨 놓았다.
 
 
 
== text_type: 인용문 전체를 태깅 ==
 
 
 
<cit>제 나이 열 두살 때 집을 떠나 서쪽으로 갔습니다. 배를 탈 적에 돌아가신 아버지께서 타이르시기를, '십 년 안에 진사(進士)에 급제하지 못하면 내 아들이라 하지 말라. 나도 아들을 두었다 아니하리라. 가라! 부지런히 하여 네 힘을 게을리 말라'고 하셨습니다. 저는 엄한 말씀을 가슴에 지녀 감히 잊지 못하고, 머리를 묶어 매고 송곳으로 찔러가며 부모님의 뜻을 받들 것을 기약하여, 다른 사람이 백번 하면 나는 천번을 하여, 중국에 온 지 6년만에 영광스런 이름을 방의 끄트머리에 올리게 되었습니다.</cit>
 
 
 
== 인용문의 출처가 있는 경우 → <cit> 안에 <quote>와 <bibl> 추가 ==
 
 
 
<cit>
 
 
 
    <quote id="cit_10001" type="verse">狂奔疊石吼重巒 人語難分咫尺間 常恐是非聲到耳 故敎流水盡籠山</quote>
 
 
 
    <tranlation corr_id="cit_10001">미친 물 바위 치며 겹겹 산을 뒤흔드니 지척 사이에도 사람 소리 모르겠네. 세상의 시비 소리 들릴까 두려워서 짐짓 흐르는 물로 산을 온통 가두었네.</tranlation>
 
 
 
    <bibl>삼국사기 권46 열전</bibl>
 
 
 
</cit>
 
 
 
== 평서문과 인용문이 이어지는 경우 ==
 
 
 
<p id="txt_10008">
 
 
 
<name type="period">당나라</name>로 건너간 <persName id="per_10001">최치원</person>은 18세 되던 해에 <name type="period">당나라</name>의 과거에 급제하고 <name type="period">당나라</name>의 <place>낙양(洛陽)</place> 땅으로 옮겨 살았다. <name type="period">당나라</name>는 과거에 급제하더라도 고위 관직에 있는 사람이 추천해 주지 않으면 벼슬자리에 나갈 수 없었다. 아무리 재능이 있었다 하더라도 만리 이국의 소년을 선뜻 관직에 추천해 줄 인물은 흔치 않았다. <persName id="per_10001">최치원</person>이 그때 지은 시에는
 
 
 
<cit type="verse">>갈림 길 먼지 속에 이리 날리고 저리 굴러 파리한 말 혼자 타고 고생이 얼마던가? 고향 길이 좋은 줄 모르지 않지마는 돌아간다 하더라도 집이 가난한 걸 </cit>
 
 
 
이라 하여 탄식을 숨기지 않았다. 만리 이국 땅에서 어린 나이로 떠돌며 생활하는 것이 참으로 막막하였던 것이다.
 
 
 
</p>
 
 
 
== text_original에 / → 한시 행바꿈<l>(line), 1연<lg>(line group) ==
 
 
 
<lg>
 
 
 
<l>
 
 
 
<l>
 
 
 
<lg>
 
 
 
== 🔄 작업 도구별 역할 정리 ==
 
 
 
| 단계 | 도구 | 작업 내용 | 담당 |
 
|-|-|-|-|
 
| 1단계 csv | Excel / Google Sheets | CSV 데이터 입력 (text_original) | 전체 팀원 |
 
| 2단계 txt | Notepad++ / VSCode | 태깅 마커 표시 (text_tagged) | 인문계 학생 |
 
| 3단계 xml | Python | 마커 → XML 자동 변환 | 이공계 학생 |
 
| 4단계 valid check | XML Validation 도구 | XML 파일 검수 및 수정 | 팀 총괄 + 전체 |
 
 
 
== ⚠️ 태깅 시 주의사항 ==
 
 
 
* 일관성 유지: 같은 대상은 항상 같은 방식으로 태깅
 
* 중첩 금지: [P][L]김해[/L][/P] (X) → 하나만 선택
 
* 불확실하면 표시 안 함: 확실한 것만 태깅, 불확실한 것은 remarks에 기록
 
* Excel에서 작업: 익숙한 도구로 빠르게 진행
 
* VSCode는 검수용: XML 변환 후 최종 확인에만 사용
 
 
 
== 태깅 진도 체크리스트 ==
 
 
 
* 인명과 지명의 차이를 구분할 수 있나요?
 
* 마커 표기법([P], [L])을 이해했나요?
 
* Excel에 text_tagged 열을 추가했나요?
 
* 샘플 10개 문단을 태깅해보았나요?
 
* 팀원들과 태깅 기준을 통일했나요?
 
* VSCode를 설치하고 XML Tools 확장을 설치했나요?
 
 
 
== 💻 실습 스프레드시트 ==
 
 
 
아래는 우리 팀이 실제로 작업하는 구글 시트입니다. 실시간으로 데이터를 확인하고 입력할 수 있어요.
 
 
 
<html>
 
<div style="border: 1px solid #cccccc; padding: 0; margin: 0 0 20px 0;">
 
<iframe src="https://docs.google.com/spreadsheets/d/1beVxX1Q-xRAyHOxjk-u3YLYszGZjftkONu_EtR0n9yM/edit?usp=sharing" width="100%" height="600" style="border: none; margin: 0; padding: 0;"></iframe>
 
</div>
 
 
</html>
 
</html>
 
'''📊 PNU_DHC 플랫폼 데이터 작업 시트'''
 
 
💡 스프레드시트 사용 팁
 
 
* 위 임베드 창에서 바로 데이터를 확인할 수 있어요
 
* 실제 입력은 "새 탭에서 열기" 버튼을 클릭해서 진행하세요
 
* 여러 사람이 동시에 작업할 수 있어요 (실시간 공동 편집)
 
* 변경 이력은 자동으로 저장됩니다
 
 
== 마무리 ==
 
 
기억해야 할 핵심 3가지
 
 
일관성이 생명: 같은 항목은 항상 같은 방식으로 진행, 자연마을에 부산 인물에 등장했던 사람이 언급될 수 있으므로, 같은 id 부여해야 함. 그러므로 세 팀의 전체 작업을 하나의 파일에서 작업할 것임, 복사본을 만들어 검수 작업 진행
 
 
ID는 신중하게: 한번 부여한 ID는 앞으로도 계속 사용될 예정이며, 중복되지 않는지 반드시 확인
 
 
협업이 중요: 막힐 때는 팀원들과 의논하기(논의가 필요하다 생각한 부분을 결과보고서에 기입!!)
 
 
== 📎 참고 자료 ==
 
 
* 작업 스프레드시트: 구글 시트 바로가기
 
* XML 가이드: XML 설계 입문
 
* 광주인문도시스토리플랫폼: 사례 참고
 
 
© 2025 부산대학교 디지털인문학센터 (Digital Humanities Center of Pusan National University) PNU 로컬 인문학 데이터 편찬 프로젝트
 
 
문의 및 결과물 제출: 김서윤 sy527991@pusan.ac.kr | 051-510-1594 | 최종 업데이트: 2025년 12월
 

2026년 1월 18일 (일) 12:32 기준 최신판

부산 지역 인문학 데이터 편찬 입문 가이드

📚 부산 지역 인문학 자료의 디지털화(Digitalization)

『부산을 빛낸 인물』과 『부산의 자연마을』의 디지털 데이터 변환

📖 들어가며

본 프로젝트는 부산광역시 문화유산과 시사편찬실에서 발간한 『부산을 빛낸 인물』과 『부산의 자연마을』이라는 부산의 인문 자료를 디지털 데이터로 변환하는 기초 작업입니다.

📚 프로젝트 규모 및 팀 구성

작업 대상 자료: 부산광역시사편찬위원회 자료실 또는 부산 지역사 도서관에서 PDF 다운로드 & 모든 팀원 활동일지 다운로드

👥 역할 분담 (총 26명: 인문계 23명 + 이공계 3명)

역할: 인문계 학생들은 텍스트 구조화(EXCEL) 및 태깅(XML) + 이공계 학생들은 기술 지원 및 자동화

A팀

『부산을 빛낸 인물』전 3권 (780 페이지)

  • 구조화: 황인영, 이선영 (390페이지씩)
  • 태깅: 박하영, 김남희, 최은
  • 검수: 박수연
B팀

『부산의 자연마을』제1, 2, 6권(1,140여 페이지)

  • 구조화: 김수민, 김주난, 임승주 (380페이지씩)
  • 태깅: 김수인, 김민경, 홍정빈
  • 검수: 정재환
C팀

『부산의 자연마을』제3, 4, 5권(1,140여 페이지)

  • 구조화: 김수영, 엄미연, 윤채영 (380페이지씩)
  • 태깅: 우지성, 임혜민, 조혜원
  • 검수: 노수미
D팀

전체 작업 (약 3,000 페이지)

  • 원본 파일(txt): 이다원, 최나영 (1500페이지씩)
  • 표, 이미지 및 전체 검수: 윤수현
  • 전처리 및 XML 변환: 강주연, 박지현, 박비원
📊 A~C팀의 역할
  • 구조화: PDF에서 추출한 텍스트를 팀별 작업 시트에 입력
  • 매주 일정 분량씩 검수자에게 제출
  • 태깅: 의미 요소 식별 (XML 태깅을 위한 준비 작업)
  • 검수: 누락된 부분 없는지 확인 및 작업 일정 관리
💻 D팀의 역할
  • 파이썬 스크립트 개발 (태깅 마커 [P][/P] → XML 자동 변환)
  • 데이터 검증 및 오류 체크 자동화
  • 팀 내 기술적 문제 실시간 지원
  • VScode, Git 등 도구 활용 지원

이제 책 속의 자료를 시맨틱 데이터로 변환하는 기초 작업을 진행할 예정입니다. 왜 이 작업이 필요할까요?

부산광역시사편찬위원회 자료실에 PDF로 제공되는 도서는 한 번에 한 사람만 읽을 수 있지만, 디지털 데이터로 변환된 지식은:

  • 💡 검색 가능: "1950년대 부산 영도구"라고 검색하면 관련된 모든 내용이 한눈에 보이게 만들 수 있습니다!
  • 🔗 연결 가능: 인물과 장소, 사건이 서로 연결되어 새로운 통찰을 발견할 수 있습니다!
  • 📊 분석 가능: 빈도, 패턴, 관계를 통해 보이지 않던 역사적 의미를 발견할 수 있습니다!
  • 🌐 공유 가능: 전 세계 연구자들과 부산의 이야기를 나눌 수 있어요

🔥 전체 로드맵: 3단계 여정

1

디지털화(Digitalization) 기초 작업

현재 단계

  • PDF → 텍스트 추출
  • 구조화 → CSV 정리
  • 태깅 → XML 변환

목표: 원천 자료를 DB에 업로드 가능한 형태로 구조화

2

데이터 분석(Data Analysis)

  • 빈도 분석 & 키워드 추출
  • 관계 파악
  • 의미 해석

목표: 구축된 데이터에서 학문적 의미와 패턴 도출

3

데이터 설계(Data Modeling)

  • 온톨로지 설계
  • 지식 그래프 구상
  • 활용 방안 기획

목표: 플랫폼 구축을 위한 데이터 모델링

📊 작업일정 계획 (2026년 1월~2월)

부산 인문자료 디지털화 온보딩 타임라인

부산 인문자료 디지털화 온보딩 타임라인

💻 실습용 작업 스프레드시트

아래는 우리 팀이 실제로 작업하는 구글 시트입니다. 실시간으로 데이터를 확인하고 입력할 수 있어요.

📊 PNU_DHC 플랫폼 데이터 작업 시트 새 탭에서 열기 →
💡 스프레드시트 사용 팁
  • 위 임베드 창에서 바로 데이터를 확인할 수 있어요
  • 실제 입력은 "새 탭에서 열기" 버튼을 클릭해서 진행하세요
  • 여러 사람이 동시에 작업할 수 있어요 (실시간 공동 편집)
  • 변경 이력은 자동으로 저장됩니다

🎯 단계별 XML 태깅 전략 (난이도별 접근)

1

1차 작업 (필수) - 가장 명확한 요소

현재 작업 단계

인명 [P]최치원[/P] 사람 이름 (판단 쉬움)
지명 [L]영도구[/L] 장소, 지역명 (판단 쉬움)

💡 추천: 학부생 기초 작업은 인명과 지명만 집중하는 것을 권장합니다!

  • ✅ 판단이 가장 명확
  • ✅ 작업 속도가 빠름
  • ✅ 온톨로지 핵심인 "누가-어디서" 관계망 우선 구축
2

2차 작업 (선택) - 조금 더 복잡

시간 [D]1876년[/D] 날짜, 연도, 시대
기관명 [O]동래부[/O] 단체, 조직, 관청
서명 [T]동래부지[/T] 책, 문서, 작품명

진행 시기: 1차 작업 완료 후 또는 동시 진행 가능

3

3차 작업 (고급) - 전문가 검수 필요

문화유산 [H]동래읍성[/H] 유적, 문화재, 건축물
사건명 [E]임진왜란[/E] 역사적 사건, 행사
작품명 [W]해운대가[/W] 시, 그림, 예술작품

진행 시기: 데이터 분석 및 설계 단계에서

※ 문화유산과 지명, 작품명과 서명의 구분이 애매할 수 있어 전문가 판단 필요

© 2025 부산대학교 디지털인문학센터 (Digital Humanities Center of Pusan National University)

PNU Knowledge Base 로컬 인문학 프로젝트

문의 및 결과물 제출: 김서윤 sy527991@pusan.ac.kr | 051-510-1594 | 최종 업데이트: 2025년 12월 20일