위키문헌:색인 문서

색인 문서

색인 이름공간에 대한 설명.

색인 문서

색인 문서(색인 페이지, 색인 파일)는 '색인 이름공간'에 있는 문서로, 색인 문서 1개당 작업할 작품 1개에 대응되어, 파일의 전사와 검토가 이루어지는 '작업 공간' 역할을 합니다. 색인 문서에는 파일의 쪽별로 하나씩 링크가 표시되어 있으며, 작품의 각 쪽에 대응하는 '페이지 이름공간'으로 연결됩니다.

색인 문서와 하위 페이지 문서의 제목은 같습니다.
예를 들어, "색인:작품/djvu"라는 문서가 있을 때, 연결된 페이지 링크는 밑처럼 나타나게 됩니다.

1. 페이지:작품.djvu/1
2. 페이지:작품.djvu/2
3. 페이지:작품.djvu/3

   ...

색인 문서에서는 주로 DjVu나 PDF 형식을 많이 사용하지만, JPEG, PNG 등 이미지 파일을 수작업으로 이어붙여 만들 수도 있습니다. 여러 파일을 사용하는 경우가 아니라면, 파일의 이름과 색인 문서의 제목은 같아야 합니다.

예를 들어, "파일:작품.pdf" 파일을 사용한다면 색인 문서의 제목은 "색인:작품.pdf"로 맞추어야 합니다.

색인 문서에는 페이지 목록에 더해, 참조를 위해 제목, 저자명, 출판 연도 등을 담는 공간도 마련되어 있습니다. 이 정보는 최종적으로 일반 문서 형태로 게시될 때 같이 표시하는 용도로도 사용합니다.

색인 문서 만들기

색인 문서를 편집하는 모습.

색인 문서를 만들기 위해서는 먼저 작품의 스캔본 파일을 업로드해야 합니다. 스캔본은 특별한 경우가 아닌 경우 DjVu나 PDF 형식으로 업로드합니다. 보통 스캔본은 위키미디어 공용에 직접 업로드하지만, '합법'이라 하여도 공용 정책에 맞지 않아 업로드할 수 있는 경우도 있습니다. 이러한 경우에는 위키문헌에 직접 파일을 올릴 수 있습니다.

전사 작업 시 항상 색인 문서를 만들어야 합니다. 색인 문서는 다른 문서와 같은 방식으로 형성되며, 대표적인 방법은 다음과 같습니다.

1. 상단 검색란에 생성할 색인 문서의 이름을 입력한 후 빨간 링크를 눌러 생성
2. 파일이 공용이 아닌 위키문헌 내에 있을 경우, 파일 페이지의 url 주소에 있는 "파일:"을 "색인:"으로 변경하여 생성

스캔본 파일에서 색인 문서를 만들 경우, 이름공간 접두사를 제외하고 파일의 이름과 색인 문서의 이름은 같아야 합니다. 예를 들어, 스캔본의 이름이 "파일:책.djvu"일 경우, 색인 문서의 이름은 반드시 "색인:책.djvu"이어야 합니다. 파일 이름과 일치하지 않을 경우 색인 문서가 정상적으로 작동하지 않습니다.

새로 만든 색인 문서는 일반적인 위키 문서와 형태적인 차이가 있습니다. 텍스트를 입력할 수 있는 칸이 여럿 있으며 (칸의 변수에 대한 설명은 밑에 작성되여 있습니다) 대부분은 비어 있지만 일부 자동으로 작성되는 칸도 있습니다. 이 변수들은 전사와 검토를 돕는 역할을 하며, 일부는 메타데이터를 나타내기도 합니다.

색인 문서의 형태는 틀을 통해 표시되며, 만약 자바스크립트를 끈 상태로 색인 페이지를 편집하면 색인 틀이 포함된 일반 문서의 형태로 표시됩니다. 문서 내의 틀 자체는 여타 틀과 같은 방식으로 편집할 수 있습니다.

색인 문서는 어느 때나 저장할 수 있기 때문에, 반드시 모든 칸을 작성한 후 저장할 필요는 없습니다.

변수

색인 문서에는 작품에 대한 정보를 실을 수 있는 도구가 내장되어 있습니다.

종류

원작의 종류로, 기본값은 "서적"입니다.

• '저널'은 저널 또는 잡지를 권 단위로 한 번에 싣는다는 것을 나타냅니다. 저널 속의 글이나 기사 하나만을 발췌해 올리는 것을 통상 권장하지 않으며, 간혹 저널에 따라 수록된 기사별로 적용하는 저작권이 다를 수 있음도 유의해 주세요.
• '모음집'은 서로 관련 있는 미디어를 나타내며, 변수는 존재하지만 각 작품별 수록을 권장하는 위키문헌 특성상 사용을 권장하지 않습니다.
• '논문'은 보고서 등 공식적인 출판 과정을 거치지 않은 작품을 수록하는 데 사용하며, 이 경우 위키문헌에 수록할 수 있는지 조건을 더 꼼꼼히 확인하여야 합니다.
• '사전'은 매우 작은 단위로 쪼개야 하는 작품을 가리킵니다.

제목

작품의 제목으로, 부제가 있을 경우 같이 입력합니다.

언어

작품에서 주로 사용하는 언어로, ISO 639에 따라 영어 알파벳 2~3자로 입력합니다. 참고로, 한국어는 ko를 사용합니다.

권

만약 작품이 여러 권으로 나뉘어 있을 경우, 해당 파일의 권 번호를 적어 넣습니다.

저자

저자의 이름으로, 만약 위키문헌의 '저자 이름공간'에 해당 저자 문서가 있을 경우 링크를 걸어주기도 합니다.

번역자

만약 작품이 다른 작품을 번역한 번역본일 경우, 번역가의 이름을 적습니다.

편집자

만약 백과사전이나 저널 등 제작자가 여러 명일 경우, 편집자는 따로 여기에 적습니다.

삽화가

작품에 실린 삽화를 그린 사람을 넣습니다.

학교

논문에 사용하는 변수로, 해당 논문을 지도한 학교(기관)의 이름을 적습니다. 간혹 한 작품을 같은 기관에 소속된 여러 명이 만들었을 경우 사용할 수도 있지만, 이는 미술 작품에 흔한 관행으로, 위키문헌에서는 이러한 경우가 실질적으로 없습니다.

출판사

작품을 출판한 출판사의 이름을 적습니다.

위치

출판사의 소재지를 적습니다.

출판 연도

작품이 출판된 연도를 적습니다.

정렬 키

만약 작품의 이름이 특별한 의미 없는 글자("제" 등)나 비슷한 단어로 시작할 경우, 분류 속에서 찾기 쉽도록 '어느 문자'로 정렬할지를 정합니다. {{DEFAULTSORT}} 틀과 역할이 같습니다.

ISBN, OCLC, LCCN, BNF ARK, National Archives identifier

작품에 부여되어 있는 식별자로, 있을 경우 입력합니다. 이 중 하나만 입력해도 충분하며, 오래된 작품일 경우 식별자가 없기도 합니다.

스캔본

주어진 항목 중 해당하는 파일 확장자를 선택하면, 해당 파일로 가는 링크가 자동으로 생겨납니다. 만약 '기타'로 설정하면 링크가 생기지 않습니다. 보통 djvu나 pdf를 사용하지만, 각 이미지를 수동으로 이어붙여 만들 수도 있습니다.

표지 그림

작품의 표지로 사용할 파일명으로, 페이지 번호를 입력합니다. 기본값은 1(첫 페이지)입니다.

진행 상황

색인 문서를 어디로 분류할지를 정합니다. 주어진 항목 중 선택하는 형태이지만, 직접 텍스트를 입력할 수도 있습니다. 새로 만든 색인 문서의 경우 '교졍 안 됨'으로 분류됩니다. 진행 상황을 입력하면 틀에서 짧은 알파벳 약자로 변환하여 저장합니다.

진행 상황 변수에서 사용하는 선택지

항목명	약자 코드	문서에 표시되는 상태	설명	추적 분류
완료	T	완료—해당 작품의 모든 페이지를 올바르게 검증하였습니다	이 파일의 모든 페이지가 검증이 완료되었거나 '텍스트 없음'으로 설정되었고, 문제가 되는 페이지가 없습니다. 광고 페이지는 굳이 필요하지 않습니다.	검증된 색인
교정됨	V	교정됨—해당 작품의 모든 페이지를 올바르게 교정하였으나, 검증 작업은 거치지 않았습니다	파일 내 모든 페이지의 교정 작업이 끝나, 검증만을 앞두고 있는 경우입니다. 이 단계에는 작품 내의 표나 일러스트도 포함되어 있어야 합니다. 광고 페이지는 굳이 필요하지 않습니다.	교정된 색인
교정 안 됨	C	교정되지 않았습니다	교정해야 하는 페이지가 남아 있는 단계로, 이 단계에서는 문제가 있는 페이지가 남아있을 수 있습니다.	교정 안 된 색인
Match & Split 준비됨	MS	Match & Split을 할 준비가 되었습니다	만약 일반 이름공간에 같은 문서가 이미 있고, 그 문서는 스캔본을 기반으로 입력한 것이 아닌 경우, 둘을 비교하는 방식으로 스캔을 교정할 수 있습니다.	색인 - Match & Split 준비
원본 파일에 OCR 텍스트 레이어가 필요함	OCR	OCR 텍스트 레이어가 필요합니다	색인 문서 속 페이지 문서에 텍스트가 아직 입력되지 않은 경우, 즉 전사가 완료되지 않은 경우입니다.	색인 - 텍스트 레이어 필요
원본 파일에 문제가 있음(페이지 순서 및 누락)	L	교정 작업을 시작하기에 앞서 원본 파일을 수정해야 합니다	원본 파일에 페이지 생략이나 중복 등 문제가 있어, 문제를 해결할 때까지 전사와 교정 작업을 중단해야 합니다. 문제가 무엇인지 색인 문서의 토론 문서나 권 변수에 남기면 문제를 빠르게 해결하는 데 도움이 됩니다.	색인 - 파일 수정 필요
교정 작업 시작 전 페이지 목록 필요	X	교정 작업을 시작하기에 앞서 페이지 목록이 필요합니다	원본 파일이 업로드되어 있지만 페이지가 빠지거나 순서가 바뀌었는지 확인을 아직 거치지 않은 경우입니다.	색인 - 파일 검토 필요
			간혹 색인 문서에 문제가 있어, 진행 상황이 지정되어 있지 않은 경우도 있습니다.	색인 - 진행 상황 알 수 없음

쪽별 색인

이 칸은 일반적인 .djvu나 .pdf 파일 내 페이지를 가시적으로 표시해, 마치 원본 파일을 알아보기 쉽게 정렬한 것처럼 표시하는 데 사용합니다. 페이지를 특정 값으로 할당하면 해당 페이지와 자동으로 연결되며, 해당 페이지의 미리보기 이미지가 옆에 같이 표시됩니다. 이 작업의 목적은 앞에서 설명한 것과 같이, 전사 및 교정 작업을 원할하게 하기 위함입니다.

쪽별 색인을 작성할 때는 미리 작성한 코드에 <pagelist /> 태그를 사용하는데, 기본값인 <pagelist />를 변경하지 않고 사용하면 처음부터 끝까지 1대 1 대응으로 단순한 페이지 목록을 자동적으로 생성합니다.

pagelist 태그

<pagelist /> 태그는 페이지 번호를 작성할 때 어떠한 상황에서도 사용할 수 있는 단순하지만 강력한 도구입니다. 번호를 붙이지 않을 페이지도 따로 지정할 수 있는데, 예를 들어 <pagelist 1to2=- 3=1 />로 작성할 경우 1페이지와 2페이지는 '-'로, 3번 페이지부터는 번호를 붙여 표시됩니다. 여기서 파일의 3페이지부터 1번째 페이지로 표시됩니다.

작품 내의 위치를 표시하기 위해 텍스트를 입력할 수도 있습니다. 예를 들어 <pagelist 1=표지 2to6=- 7=제목 8=2 20="판 1" />로 입력할 경우, 1페이지는 '표지', 2~6페이지는 '-', 7페이지는 '제목', 8페이지부터 19페이지까지는 1번부터 12페이지, 20페이지는 '판 1'로 표시됩니다. 입력할 텍스트 내부에 띄어쓰기가 있을 경우 전체에 큰따옴표(")를 쳐야 합니다.

만약 작품 원문에서 페이지 번호를 로마 숫자로 표기하여 이를 그대로 사용하고 싶은 경우, <pagelist 5to10=roman 5=1 11=1 />와 같은 방식으로 적으면 됩니다. 이 예시의 경우 5번 페이지가 i, 6번 페이지가 ii 등으로 표시되며, 11번 페이지는 아라비아 숫자 1로 표시됩니다. 대문자 로마 숫자는 "highroman"을 사용하면 됩니다.

<pagelist /> 태그는 여러 번 나누어 사용할 수 있기 때문에, 사전처럼 여러 작품이 한 권으로 묶인 경우에 용이합니다. pagelist를 여러 번 사용할 때는 <pagelist from=147 to=185 /> 형식으로 적어야 합니다. 이 경우에는 해당 태그에서 147번부터 185번 페이지만을 표시합니다.

앞표지와 뒷표지를 '표지'로 적어 주십시오.

삽화는 '삽화' 또는 '그림'으로 적어 주십시오. 만약 작품 내에 그림 번호가 표시되어 있는 경우, 그림 번호를 사용해도 됩니다. 가능하면 모든 그림의 이름에 번호 등을 붙이는 방식으로 서로 구별할 수 있게끔 하는 방법을 권장합니다.

본문에 해당하지 않는 기타 보조 페이지는 역할에 따라 '안표지', '목차', '서지' 등으로 표시해 주십시오. 만약 같은 주제를 다루는 페이지일 경우, 번호를 붙여 구분하는 방식을 권장합니다.

광고가 포함된 페이지는 '광고'로 적어 주십시오.

보통 내용이 없는 페이지(빈 페이지)는 '빈면'이나 '-'(하이픈)으로 표시합니다. 표시 방법이 정해진 것은 아니지만 같은 작품 내에서는 통일할 것을 권장하고 있습니다.

모든 페이지는, 처음부터 마지막까지, 비었는지, 전사할 필요가 없는 내용인지, 전사되었는지의 여부와 전혀 관계 없이, 반드시 쪽별 색인에 포함되어야 합니다!

만약 특정 페이지를 생략하고 싶다면, 일반 이름공간으로 문서를 끼워넣을 때 따로 설정하거나, 파일을 업로드할 때 파일 자체를 수정해서 업로드해야 합니다.

목차

해당 작품 내의 목차를 표시하며, 보통 작품에 대한 설명을 적거나 일반 이름공간으로 링크를 거는 용도로도 사용합니다.

목차 자체는 위키텍스트(표나 목록 등)를 포함해 원하는 방식으로 만들 수 있습니다.

만약 목차가 너무 길 경우, 목차 앞에 <div style="width: 95%; height: 700px; overflow: auto; border:thin grey solid; padding: 0px 5px 0px 20px;">를, 뒤에 </div>를 붙이면 스크롤링 창이 표시됩니다.

편집 시 스캔 해상도

하부의 페이지 이름공간 문서를 편집할 때 표시되는 이미지의 해상도 값을 덮어씌웁니다. 예시로 1000을 입력할 경우, 페이지 문서에서는 1000픽셀 해상도로 이미지가 표시됩니다.

현재 일부 브라우저에서 오류로 인해 모든 이미지가 검은색으로 표시되는 오류가 있는데, 이 값을 300~1600 사이로 설정하는 경우 대부분 해결됩니다.

CSS

여기에 내용을 입력하면 하위 페이지 전체에 CSS 스타일이 자동으로 적용됩니다.

머리말

색인 문서 하위에 있는 페이지 문서의 머리말을 일괄적으로 설정하는 변수입니다. 여기에 입력한 텍스트는 하위 페이지 문서의 머리말에 자동으로 입력됩니다.

머리말은 주로 장 제목이나 페이지 번호 등, 일반 이름공간으로 옮길 필요가 없는 내용을 입력하는 데 사용합니다. 만약 같은 형식이 해당 작품에서 계속 반복된다면, 색인 문서의 머리만 변수에 해당 내용을 입력하여 두면 반복 작업을 줄일 수 있습니다.

머리말은 페이지 문서에서 각각 편집할 수 있는데, 이 경우 편집한 내용은 해당 페이지 문서에만 저장되며, 색인 문서에는 반영되지 않습니다. 또한, 일반 이름공간에 있는 문서에는 전혀 영향이 가지 않습니다.

이 변수의 단점은 해당 페이지의 정렬 방향이 왼쪽인지 오른쪽인지를 감안하지 않는다는 것으로, 이러한 경우에는 두 경우 모두를 입력하여 둔 다음 편집 시 하나를 지우는 방법을 사용하기도 합니다.

꼬리말

머리말 변수와 마찬가지로, 색인 문서 하위에 있는 꼬리말을 일괄적으로 설정하는 변수입니다.

보통 페이지의 꼬리말에는 쪽 번호가 들어갑니다. 보통 가운데로 정렬된 번호를 입력할 때는 {{center|번호}} 틀이 편리합니다. 보통 <references /> 태그가 기본값으로 입력되어 있기도 한데, 이는 페이지 내 주석을 표시하기 위함입니다.

꼬리말은 페이지 문서에서 각각 편집할 수 있는데, 이 경우 편집한 내용은 해당 페이지 문서에만 저장되며, 색인 문서에는 반영되지 않습니다. 또한, 일반 이름공간에 있는 문서에는 전혀 영향이 가지 않습니다.

분류

이 변수는 프로젝트 관리(분류:옛한글 문헌 전자화 프로젝트 등)를 위해 있으며, 분류:작품 및 하위 분류 등 작품 자체에 대한 설명은 색인 문서에 적지 않습니다.

개별 이미지 파일 사용

색인 문서는 JPEG나 PNG 등 이미지 파일로도 만들 수 있습니다. 이 방법은 비문처럼 출판물이 아닌 작품을 전사할 때 사용할 수 있는 방법입니다. 이 방법은 복잡하며, 여러 단점이 있기 때문에, 몇 페이지밖에 되지 않는 매우 짧은 작품을 제외하고는 사용을 권장하지 않습니다.

과정 자체는 기본적으로 여느 색인 문서를 만드는 방법과 같으나, 다음과 같은 차이점이 있습니다.

1. 색인 문서를 만들 때, 만약 파일 하나만을 사용한다면 파일명과 문서명을 맞추어 주는 것이 좋습니다. 예를 들어, File:비석.jpg를 전사하려면 색인:비석.jpg로 만드는 식입니다. 여러 파일을 사용한다면, 최대한 여러 파일을 포괄하는 이름을 작성하면 됩니다. 이 경우 파일 확장자를 반드시 기재할 필요는 없습니다.
2. 보통 자동으로 입력되는 변수의 경우 수동으로 입력해야 합니다.
   • 스캔본: 사용할 파일의 확장자를 목록 형식으로 제시하는 변수입니다. 만약 사용하는 파일 형식이 없으면, '기타'를 선택하면 됩니다.
   • 표지 그림: 표지 그림이 자동으로 생성되지 않습니다. 또한 페이지 번호 대신 파일을 [[파일:비석.jpg|200px]]과 같은 방식으로 위키텍스트까지 완전히 입력해야 합니다. 파일을 여럿 사용할 경우, 제일 '표지'에 어울리는 그림을 선택하면 됩니다.
   • 쪽별 색인: 페이지 목록이 자동으로 생성되지 않으며, <pagelist /> 태그를 사용할 수 없기 때문에, 모든 파일을 수동으로 추가해야 합니다. 페이지 이름은 파일 이름을 위키텍스트까지 완전히 입력하되, '파일' 접두사를 '페이지'로 바꿔야 합니다. 예시는 다음과 같습니다.
     1. 파일 1개: 색인:비석.jpg (File:비석.jpg) 내에 [[페이지:비석.jpg|1]]이라고 입력해야 합니다.
     2. 파일 여러 개: 순서를 맞추어 입력해야 합니다. 예를 들어, 색인:2500년 선거 홍보물 문서 내에 [[페이지:2500년 선거 홍보물 1.jpg|1]] [[페이지:2500년 선거 홍보물 2.jpg|2]]처럼 입력하면 됩니다.

색인 토론 문서

전사와 교정 작업은 여러 사용자가 공동으로 진행하는 작업이기 때문에, 기본적인 편집 지침은 있긴 하지만, 이 외에 편집하는 사용자 간에 전하고 싶은 정보가 있을 경우, 색인 문서의 토론 문서에 관련 내용을 남길 것을 권장하고 있습니다.

색인 문서의 교정 및 끼워넣기

색인 문서를 중심으로 교정 작업이 이루어지게 됩니다. 색인 문서는 최종적으로 색인 문서 내 목록에 있는 모든 페이지 문서를 교정하는 것이 목표입니다.

• 위키문헌:교정
• 위키문헌:문서 끼워넣기

색인 문서 틀

색인 문서의 양식은 미디어위키:Proofreadpage index template 문서에 작성되어 있습니다. 이 틀이 작동하려면 브라우저에서 자바스크립트가 활성화되어있어야 하며, 자바스크립트를 사용하지 못하면 일반 편집창에 틀이 부착된 형태로 보이게 됩니다. 틀 형태가 편한 경우 자바스크립트를 일부러 끄고 편집해도 되지만, 권장하는 편집 방법은 아닙니다.

도구

색인 문서 오른쪽 상단에는 사용할 수 있는 도구 3개가 있습니다.

• 스크롤 형식으로 보기 () 도구는 페이지를 한 개씩이 아닌, 한 번에 스크롤해서 볼 수 있는 형식으로 띄워 줍니다.
• 새로고침 () 도구는 위키미디어 공용에 있는 원본 파일을 강제로 새로고침합니다.
• 트랜스클루전 상태 확인하기 () 도구는 페이지의 교정 상태를 일반 이름공간에 반영되었는지의 여부와 함께 표시해 줍니다.