책 도구
모음집 확장은 더 많은 위키미디어 재단 프로젝트에서 공개될 예정이며, 이 확장은 글을 수집하고 PDF로 변환하는 기능을 제공합니다. 이 문서의 취지는 공동체가 이 확장을 성공적으로 도입하도록 안내하는 데 있습니다. 따라서 이 문서는 다양한 언어의 위키백과에서의 응용에 집중합니다. 이 도구가 어떻게 작동하는지 알아보려면 ko.wikipedia.org를 방문해서 "인쇄/내보내기" > "책 만들기"을 사용해 보세요.
소개
이 도구는 책에서 개인이 선별한 페이지들을 조직하는 것을 돕습니다. 책을 이렇게 할 수 있습니다:
이 프로젝트에 대한 추가 정보는 Wikis Go Printable를 참고하십시오.
모음집 확장은 2008년부터 *.wikibooks.org에서 테스트를 거쳤으며 2009년 1월 27일부터 독일어 위키백과에서 활성화되었습니다. 추가 공개가 예정되어 있습니다.
사용법
귀하가 이 문서를 방문한 것은 귀하의 위키백과가 곧 이 확장을 도입할 것이라는 소식 때문이었을 수 있습니다. 설정이 필요한 몇 가지 사항이 있으며 이 문서들(모두 보기)은 안내를 제공합니다.
- 도움말 번역. 번역이 필요한 4개의 도움말 문서가 있습니다. 귀하의 위키의 어디에 문서들을 만들지에 대한 제안은 #Pages used by this extension를 참고하세요.
- 책 도구 빠른 튜토리얼 페이지 번역
- 피드백 페이지에 관해서는 피드백이 많을 가능성이 높으며 메타의 영어 피드백 페이지로 번역된 문제를 필터링하여 전달하는 방법을 찾아야 합니다. 자세한 내용은 #Reporting 버그, 피드백 수집 및 도움말 받기를 참조하세요. 또한 일부 사용자는 도움말 페이지 토론을 사용하여 도움말이 아닌 도구에 대해 의견을 제시하는 경우가 많습니다.
- 토론 페이지 상단의 피드백 페이지에 대한 링크를 클릭하면 이 문제가 해결됩니다.
- 번역자를 위한 힌트: http://simple.wikipedia.org에서 이 확장 프로그램을 테스트하여 이 확장 프로그램과 함께 사용되는 기능과 개념을 더 잘 이해하세요. 또한 "페이지"라는 단어를 번역할 때는 PDF나 인쇄된 책의 페이지뿐만 아니라 위키 페이지(또는 문서)를 의미할 수도 있으므로 주의하세요.
- 다른 관련 페이지, 분류 및 틀을 만듭니다. 확장 프로그램을 배포한 후 가장 좋습니다. #Pages used by this extension을 참조하세요.
- PDF에서 생략되어야 하는 콘텐츠가 있는 틀 목록을 수집하려면 #Templates to exclude in offline exports을 참조하세요.
이러한 기본 사항이 완료되면 몇 가지 선택적 개선이 가능합니다.
- 모든 사용자의 이익을 위해 도서 관리를 고려하세요. #Organizing stored books 참조
- 언론 보도로 인해 유입된 방문자를 위한 대문 준비, #Preparing MainPage 참조
개념
- 책
- 일반적으로 페이지 모음(선택적으로 장, 제목, 부제가 포함됨)을 의미하며, 파생된 PDF, 인쇄된 책 또는 저장된 책을 의미할 수도 있습니다.
- 일시적인 책
- 현재 브라우저 세션에서 기억되는 기사 모음. "일시적인 책"의 기사 목록은 [[Special:Book]]에서 볼 수 있습니다.
- 저장된 책
- 사용자 이름공간([[User:Name/Books/Bookname]]) 또는 글로벌 이름공간([[Wikipedia:Books/Bookname]])에 있는 일반 위키페이지에 보관된 문서의 저장된 컬렉션입니다. 저장된 책은 로드될 수 있습니다. 그러면 "일시적인 책"은 "저장된 책"의 사본입니다.
- 책 페이지
- 일반적으로 [[Special:Book]]를 의미하며, 여기서는 "일시적인 책"의 모든 문서가 나열되어 있으며 "책"을 수정, 저장, 정렬, 내보낼 수 있습니다. "저장된 책"을 의미할 수도 있습니다.
- (책) 포틀릿
- 사이드바에 "책 만들기"라는 제목의 상자가 있습니다("기사 추가/삭제"-, "책 표시(N개 기사)"-, "책 불러오기"-, "책 제거"-, "책 도움말" 링크를 포함함).
- 책 도움말
- "포틀릿"에서 링크된 메인 [[Help:Books]] 페이지입니다.
- "오프라인 내보내기", "내보내기", "인쇄 중", "인쇄 버전", ...
- 디지털(PDF, ODF) 또는 물리적(인쇄된 책)으로 '도서'를 수출하는 것을 의미합니다.
- "제안", "제안 페이지"
- 책의 현재 페이지 집합과 관련된 페이지를 제안하는 기능을 나타냅니다.
현지화 변경
- 개념을 올바르게 잡으려고 노력하세요. 예를 들어 "책 보이기(19 "페이지")"는 PDF가 19개의 "문서"를 기반으로 하지만 아마도 19개의 "페이지"를 갖는 것처럼 잘못 해석될 수 있습니다. PDF나 인쇄된 책에 더 많은 페이지가 있습니다. 지금은 "임시 책"이기도 한 "보관된 책"을 방금 로드한 경우 "깨끗한 책"은 무엇을 의미합니까?
메시지를 변경해야 하는 경우 translatewiki.net (ext-collection)에서 변경하거나(다음 소프트웨어 업데이트 이후 적용) [[Special:Allmessages]]를 방문하고 "coll-*"로 필터링하여 위키에 대해 변경하여 모든 관련 메시지를 확인하세요. 의심스러운 경우 출처를 빠르게 살펴보면 올바른 메시지 식별자를 찾는 데 도움이 될 수 있습니다.
참고: "책"이라는 비유는 대부분의 위키에 적합합니다. 그러나 *.wikibooks.org에서는 "책"이라는 개념과 충돌하지 않습니다. Translatewiki.net에서 번역을 변경하는 경우 동일한 언어를 사용하는 모든 프로젝트(예: 위키책)에 알리는 것이 좋습니다.
생성된 PDF에 사용된 메시지의 현지화도 translatewiki.net (mwlibrl)에서 변경할 수 있습니다.
- 이 확장 프로그램에 사용된 모든 시스템 메시지가 귀하의 언어로 번역되었는지 확인하려면 translatewiki.net을 다시 확인하세요.
이 확장 프로그램에서 사용되는 페이지
생성해야 하는 모든 페이지, 분류, 틀 목록입니다.
페이지
[[Special:Book?bookcmd=book_creator]](생성이 필요하지 않음)- "책 작성자"를 활성화하고 짧은 도움말 페이지를 포함하는 특별 소개 페이지(사용자가 "책 만들기"를 클릭하면 표시되는 페이지). 이 도움말 페이지의 이름은
coll-book_creator_text_article에서 설정할 수 있습니다. 기본값은Help:Books/Book creator text입니다. 즉, 구성된 하위 페이지입니다. "책 작성자 텍스트"라는 도움말 페이지입니다. [[Special:Book]](생성이 필요하지 않음)- "임시 책"에 대한 모든 주요 상호 작용을 허용하는 특별 페이지입니다.
[[Special:Book/rendering]](생성이 필요하지 않음)- "렌더링 페이지"에는 문서가 생성되는 동안 진행 상황이 표시됩니다. 완료되면 문서에 대한 다운로드 링크가 표시됩니다. 렌더링이 실패한 경우 오류가 표시될 수도 있습니다.
coll-rendering_text,coll-rendering_article,coll-rendering_status,coll-rendering_page,coll-rendering_finished_text,coll-is_cached,coll-excluded_templates,coll-blacklisted_templates에서 텍스트를 구성할 수 있습니다. [[Special:Book/load_collection]](생성이 필요하지 않음)- "저장된 책"을 로드할 때 사용됩니다. 세션에 다른 책이 존재하더라도 책을 로드하려는 경우에만 사용자에게 표시됩니다.
coll-load_overwrite_text,coll-overwrite,coll-append,coll-cancel에서 텍스트를 구성할 수 있습니다. [[Help:Books]]- 포틀릿에서 링크된 이 도구에 대한 기본 도움말 페이지(예시)입니다. 해당 위치는 시스템 메시지
col-helppage에서 구성할 수 있습니다. - 이 페이지에 링크된 모든 템플릿은 인쇄에서 제외됩니다. 이 기능은 중앙 집중적이고 유연성이 떨어지는 접근 방식이므로 사용하지 않는 것이 좋습니다. 대신 [[Category:Exclude in print]]를 사용하는 것이 좋습니다(아래 참조).
coll-template_blacklist_title로 위치를 변경할 수 있습니다.
분류
[[Category:Wikipedia:Book tool]]- 모든 문서와 관련 페이지 및 템플릿을 저장하는 데 사용됩니다.
[[Category:Wikipedia:Books]]- 모든 "보존 도서"를 추적하는 분류입니다. 이 분류는 이 분류의 페이지를 방문할 경우 포틀릿에 나타나는 "책 로드" 링크를 통해 포함된 모든 페이지를 책으로 "로드"할 수 있으므로 특별합니다. 즉, "저장된 책"은 생성 시 자동으로 추가되지만 "저장된 책"이 아닌 페이지는 이 분류에 존재해서는 안 됩니다.
coll-bookscategory로 구성할 수 있습니다. 아마도 "'이 메시지를 변경"'하여 "위키백과:책"(분류 "Books"가 기본값임)로 변경하고 싶을 것입니다. [[Category:Exclude in print]]- 내보내기에 쓸모 없거나 방해가 되는 정보를 삽입하는 모든 틀을 추적하는 데 사용됩니다(몇 가지 동기를 얻으려면 아래 참조).
coll-exclusion_category_title로 구성할 수 있습니다.
틀
[[Template:Saved book]]- 이 템플릿(예)은 모든 "저장된 책" 상단에 자동으로 포함됩니다. "저장된 책" 페이지를 더욱 매력적으로 만들고 일부 메타데이터를 보유하도록 사용자 정의할 수 있습니다. 위치는
col-savedbook_template으로 구성할 수 있습니다. [[Template:Hide in print]]- 이 틀(예시)은 첫 번째 매개변수에 전달된 모든 마크업을 반환합니다(읽기: 아무 작업도 수행하지 않음). [[Category:Exclude in print]]에 추가하면 인쇄된 책이나 PDF의 내용을 선택적으로 생략할 수 있습니다. 매우 편리합니다! 원하는 대로 이름을 지정할 수 있지만 카테고리에 추가하고 전문가의 도움을 받아 문서화/링크하는 것을 잊지 마세요. 참고: 이 템플릿은 빠르게 채택되었으며 곧 가장 많이 포함되는 틀 중 하나가 되므로 보호하는 것이 좋습니다.
[[Template:Only in print]]and[[Template:PrintOnly in print]]- 이 틀(예시)은 첫 번째 매개변수에 전달된 마크업의 없음을 반환하는 반면, 해당 [[Template:Only in print"'/Print" ']] (예시)는 전달된 마크업을 반환합니다. 인쇄 시 틀을 대체하는 데 사용되는 */Print 하위 페이지에 대한 자세한 내용은 전문가를 위한 도움말을 참조하세요. 인쇄 시 틀을 대체하는 접두사는
coll-print_template_prefix로 구성할 수 있습니다.
사용자 정의 라이선스 소스 설정
일부 커뮤니티에서는 PDF의 라이선스에 추가 텍스트를 추가할 수 있습니다.
PDF에 포함될 라이선스는 라이선스를 렌더링하는 데 사용되는 원시 위키텍스트를 가리키는 URL에 MediaWiki:Coll-license_url을 설정하여 구성할 수 있습니다. 공개 위키미디어 사이트에서는 기본적으로 https://creativecommons.org/licenses/by-sa/3.0/.로 설정되어 있습니다.
오프라인 내보내기에서 제외할 틀
인쇄 버전에서 제외되어야 하는 콘텐츠가 포함된 틀이 많이 있습니다. 최소한 세 가지 주요 유형이 있습니다:
- 유지보수 메시지
- 오프라인에서는 기여할 수 없기 때문에 오프라인 내보내기에서는 쓸모가 없고 방해가 됩니다. 예: 유지 관리, 정리...
- 경고 및 힌트 메시지
- 사용자가 콘텐츠를 선택하고 어쨌든 추가하도록 선택할 때 이를 발견하므로 오프라인 내보내기에서는 쓸모가 없고 주의가 산만해집니다. 예: 문서 출처, 분쟁, 삭제, 일반...
- 탐색 콘텐츠
- 내비게이션 링크는 내보내기에 쓸모가 없고 방해가 됩니다. 예: 컴팩트 TOC, 위키미디어 자매 프로젝트...
이러한 틀은 CSS 클래스 noprint로 표시되어야 합니다.
가능하면 배포하기 전에 이 분류에 관련 틀을 조기에 식별하고 추가하는 것이 좋습니다.
독일어 위키백과에서는 관련 분류를 살펴봄으로써 130개의 틀을 빠르게 식별할 수 있었습니다. 우리는 그것들을 모두 한 페이지에 나열하고 봇을 사용하여 분류를 할당했습니다. 그 이후로 수동으로 추가해야 하는 틀은 14개만 확인되었습니다.
힌트: 일부 틀은 다른 틀의 역할을 합니다. 그러한 경우에는 이 (상위) 틀을 분류에 추가하는 것으로 충분"할 수" 있습니다. 결과적으로 전체 클래스의 틀이 제외됩니다.
저작자와 인쇄된 도서의 이용 가능 여부를 알리기
"PDF로 다운로드". 이 페이지에서 사용자(분명히 오프라인을 원하는 상태에 있는)는 "책 제작자"와 "인쇄된 책"을 얻을 수 있는 옵션을 소개받을 수 있습니다.
en.wp에서 이 페이지의 예를 보려면 en:Help:Books/Rendering page info text를 참조하고 "PDF 렌더링 페이지"에서 어떻게 보이는지 보려면 여기를 참조하세요.
이 시스템 메시지 Coll-rendering_page_info_text_article(example on en.wp)에 구성된 위치에 페이지가 존재하는 경우 "PDF 렌더링 페이지"에 표시됩니다.
저장된 책 정리하기
많은 사람들이 자신만의 책을 만드는 것을 좋아하지만, 다른 사람들은 특정 주제에 관한 책에 직접 접근할 수 있다면 기뻐할 것입니다.
[[Wikipedia:Books]] 페이지는 "저장된 책"의 가용성과 접근성을 높이는 데 사용될 수 있습니다. 이 주제에 대한 경험은 아직 많지 않지만 나온 아이디어 중 일부는 아래 하위 섹션에 나열되어 있습니다.
도서 창작 촉진
- "훌륭한 책"을 만드는 방법에 대한 가이드를 제공하세요:
- 적절한 제목을 선택하는 방법;
- 머리말을 포함하는 방법;
- 문서를 선택하는 방법;
- 권장 문서 수.
- 전역 이름공간에 존재하도록 허용된 도서에 대한 지침을 개발합니다. 여기에는 다음이 필요할 수 있습니다(예):
- 포함된 문서의 합당한 수(예: 5개 이상 200개 미만)
- 의미 있는 제목, 부제목이 있어야 합니다;
- 주제에 초점을 맞추고;
- 포함된 문서의 합리적인 품질(예: 분쟁 없음, 스텁, 삭제 후보 등)
- 주제를 조정합니다.
책을 접근 가능하게 만들기
- 이번주/월/연도의 책을 나열해 보세요.
- 훌륭한 책에 라벨을 붙이고 소개하세요.
- 관련 문서, 분류 또는 포털에 "이 주제에 관한 책이 있습니다" 상자를 추가합니다.
- 책장 A-Z의 일부를 연결하거나 포함합니다.
책장
저장된 책은 [[Category:Wikipedia:Books]] 분류에서 추적되지만 이는 빠르게 혼잡해집니다(de.wp는 1,000권에 가까운 저장된 책 - 대부분 사용자 공간에 있으며 10일 이내에 생성됨). 또한 분류 보기를 사용하면 메타데이터를 표시하거나 주제별로 도서에 액세스할 수 없습니다. 책을 분류에 연결하는 것이 가능하지만 이렇게 하면 기본 분류가 책으로 복잡해지거나 다른 이름공간에서 분류 트리가 복제되어야 합니다.
제목(A-Z) 또는 키워드별로 책을 탐색할 수 있는 책장을 자동으로 생성할 수 있는 봇이 있습니다. 물론 책장을 수동으로 만들 수도 있습니다. 봇 접근 방식에 대한 자세한 내용을 보려면 책장 페이지를 방문하세요.
대문 준비 중
포털 옆의 대문은 다중 열 웹 레이아웃을 사용하는 경우가 많기 때문에 특별합니다. 이러한 페이지는 렌더링된 PDF에서 정말 보기 좋지 않습니다(세로 레이아웃 페이지의 고정 너비 제한). 그러나 이것은 이 도구를 처음 사용하는 거의 모든 사용자가 자신의 책에 처음으로 추가하는 페이지입니다.
조기 실망을 방지하는 해결 방법은 대문이 PDF에서 더 잘 보이도록 준비하는 것입니다. 이는 대문(인쇄된)에 테이블이 전혀 없거나 열로만 구성되는 방식으로 [[Hide in print]] 템플릿을 사용하여 수행할 수 있습니다. (FIXME:example)
또 다른 문제는 '포틀릿'의 가시성입니다. 위키백과 방문자(당신이 아님)는 대부분 단순히 사이드바를 무시합니다. 제한된 시간 동안 이 새로운 기능에 대한 공지와 대문의 "위키백과에 대한 뉴스" 상자(사용 가능한 경우)에 도움말 페이지 링크가 있으면 도움이 될 수 있습니다.
버그 신고, 피드백 수집 및 도움 받기
위키 내에서
모든 기능 요청, 제안, 버그 보고서, 질문 등을 수집하는 것을 목표로 하는 메타(영어)의 중앙 피드백 페이지가 있습니다. 영어가 아닌 위키백과는 자신의 위키에 비슷한 페이지(예시)를 설정하고 다음과 같은 경우 일부 정책을 정의할 수 있습니다. 문제가 번역되어 메타의 피드백 페이지로 에스컬레이션되는 방법.
버그트래커
버그질라의 "수집" 구성요소를 사용하세요.
IRC
책 도구와 관련된 모든 것에 대한 IRC 채널 #pediapress접속이 있습니다.
과거 배포 경험
독일어 위키백과
효과가 있었던 것: 도구에 대한 반응은 대부분 긍정적이었습니다. 짧은 시간 안에 많은 저장된 책이 만들어졌습니다. 독일 지부의 보도 자료가 나오자 언론은 이 주제를 빠르게 다뤘습니다.
작동하지 않은 점: 첫 주 동안은 로그인한 사용자에게 새 도구를 제한할 계획이었습니다. 어쨌든 이 계획은 실행되지 않았습니다. 결과적으로 문서화 및 현지화가 실제로 완료되지 않은 상태에서 해당 기능이 활성화되었습니다. 일부 사용자의 경우 캐싱으로 인해 포틀릿이 일부 페이지에 표시되지 않았습니다. 대문은 인쇄 버전에 적합하지 않았습니다(위 참조). 마침내 독일의 인기 온라인 뉴스 잡지인 하이제(Heise)가 이야기를 다룬 이후 슬래시닷 효과가 나타났습니다. 방문자에게 서비스를 제공하는 대신 렌더링 서버가 축소되었습니다(로드가 300에 가깝습니다).
업데이트
업데이트, 특히 커뮤니티의 관심이 필요한 업데이트는 여기에서 발표됩니다.
- October 2014: Book tool bug day.
- September 2014: statistics for sales have been updated till the end of 2013, at [1].
- 2013–2014 - See mw:PDF rendering and talk page for updates.
- 3 Mar 2009 - PDF-server update & ColExt update
- Important Change: The template substitution was changed from a prefix to a suffix */Print. The license to be included in the PDF is now configurable by setting
MediaWiki:Coll-license_url - updated to mwlib release 0.9.11 (changelog)
- updated to mwlib.rl release 0.9.8 (changelog)
- Collection-Extension was updated to trunk (changelog)
- Important Change: The template substitution was changed from a prefix to a suffix */Print. The license to be included in the PDF is now configurable by setting
- 19 Feb 2009 - PDF-server update & ColExt update
- 8 Feb 2009 - PDF-server update
- 27 Jan 2009 - PDF-server & ColExt update
mwlib + mwlib.rl are used for rendering documents, Collection-Extension implements the UI in Mediawiki