위키문헌:끼워넣기 길라잡이

← 검증

끼워넣기 길라잡이

마무리 →

(일반) 이름공간에 책의 내용을 추가하는 법.

  다음 문서를 참고하십시오: 위키문헌:문서 끼워넣기

끼워넣기란?

"끼워넣기"는 영어 낱말 Transclusion의 번역으로, 페이지 이름공간의 텍스트를 (일반) 이름공간에 게시하는 방법입니다. 이때, 페이지 이름공간은 교정 작업을 수행하는 곳이고, 문헌을 단순 열람하는 곳은 (일반) 이름공간의 문서입니다.

끼워넣기는 페이지 이름공간에서 교정된 텍스트를 (일반) 이름공간의 문서에 게시하여 (일반) 이름공간의 문서에서 열람할 수 있게 합니다. 그러나 끼워넣은 텍스트는 여전히 페이지 이름공간에서 가져오는 것이므로, 페이지 이름공간에서 교정된 텍스트를 수정하면 (일반) 이름공간에서도 별개의 편집 없이 수정된 텍스트를 볼 수 있습니다.

끼워넣기를 사용할 때

  다음 문서를 참고하십시오: 위키문헌:페이지 상태

끼워넣기는 교정이 완료되고 모든 페이지가 검증되었을 때 권장됩니다.

또한 끼워넣기를 통해 교정된 텍스트가 (일반) 이름공간에서 어떻게 보일지 확인할 수 있습니다. 이를 활용해야 한다면 교정이 완료되기 전이라도 (일반) 이름공간으로 끼워넣을 수 있습니다. 그러나 (일반) 이름공간은 사람들이 문헌을 열람하는 공간이므로, 최대한 깔끔하고 정돈된 모습의 텍스트를 게시하는 게 위키문헌의 목표입니다. 따라서 텍스트를 끼워넣고자 한다면 최대한 좋은 상태의 텍스트 위주로 끼워넣기 바랍니다.

단순 끼워넣기

끼워넣기를 시작하기 위해서는 다음과 같이 하면 됩니다:

1. 텍스트의 최종본이 게시될 새로운 페이지를 생성합니다.
2. 그 페이지를 편집합니다.
3. 아래에 나온 대로 끼워넣기 코드를 삽입합니다.
4. 페이지를 저장합니다.

써야 하는 코드는 한 페이지에 몇 페이지씩 끼워넣고 싶은지에 따라 다릅니다.

끼워넣기 코드

페이지 개수	사용할 코드
낱개	<pages index="파일이름" include="X" header="1" />
둘 이상	<pages index="파일이름" from="X" to="X" header="1" />

빨간 텍스트를 상황에 맞게 바꾸면 됩니다.

• '파일이름'은 색인과 페이지 문서에서 쓰인 파일의 이름입니다.
• X는 끼워넣으려는 페이지의 숫자입니다. 이때 쓸 페이지의 숫자는 페이지 문서의 제목 맨 뒤 숫자를 기준으로 합니다.

예를 들어, 색인:내예제문헌.djvu에서 한 장(章, chapter)의 내용을 끼워넣고 싶고, 그 장이 페이지:내예제문헌.djvu/20에서 페이지:내예제문헌.djvu/35까지라면, 쓰고자 하는 코드는 다음과 같습니다(PDF 파일도 동일한 방식으로 진행합니다):

<pages index="내예제문헌.djvu" from="20" to="35" header="1" />.

한편 JPEG와 같은 이미지 기반 색인에서 끼워넣고 싶을 때는 약간 다릅니다. 이미지 기반 색인 색인:내이미지문헌에서 페이지 20(페이지:내이미지문헌 20.jpeg)부터 페이지 35(페이지:내이미지문헌 35.png)까지 이어지는 한 장의 내용을 끼워넣고 싶다면, 쓰고자 하는 코드는 다음과 같습니다:

<pages index="내이미지문헌" from="내이미지문헌 20.jpg" to="내이미지문헌 35.png" header="1" />.

이미지로 된 색인을 끼워넣을 때에는 각 페이지의 숫자와 확장자에 유의하여 코드를 기입하시기 바랍니다.

머리말 수정하기

단순 끼워넣기는 "마법 머리말"로 색인 문서에서 필요한 정보를 가져와 페이지 상단에 보여줍니다. 만약 이 머리말에 문제가 있거나 더 자세한 정보를 기입하고 싶으시다면 직접 머리말을 넣어야 합니다.

직접 머리말을 넣으려면:

1. 텍스트의 최종본이 게시될 새로운 페이지를 생성합니다.
2. 그 페이지를 편집합니다
3. 아래와 같이 직접 머리말 코드를 기입합니다.
4. 머리말에서 채울 수 있는 정보를 기입합니다.
5. 아래와 같이 끼워넣기 코드를 기입합니다.
6. 페이지를 저장합니다.

직접 기입해야 하는 머리말 코드는 아래와 같습니다:

{{머리말
 | 제목 = 
 | 저자 = 
 | 역자 = 
 | 부제 = 
 | 이전 = 
 | 다음 = 
 | year = 
 | 포털 = 
 | 설명 = 
}}

제목과 저자는 기입되어야 합니다. {{머리말}} 틀 문서에서 더 자세한 정보를 볼 수 있습니다.

"header"("마법 머리말"을 만드는 attribute)를 뺀 것을 제외하면 단순 끼워넣기와 코드가 동일합니다. 예시 코드는 아래와 같습니다:

끼워넣기 코드(머리말 없을 때)

페이지 개수	사용할 코드
낱개	<pages index="파일이름" include="X" />
둘 이상	<pages index="파일이름" from="X" to="X" />

고급 기능

끼워넣기로 할 수 있는 것은 이외에도 많습니다. 끼워넣기로 페이지를 제외하거나 넘길 수 있으며, 페이지의 전부 말고 일부만 끼워넣을 수도 있습니다. 이에 대해 더 많은 정보는 위키문헌:끼워넣기를 보십시오.