본문 바로가기
미디어위키

Citoid Enabling Citoid on your wiki

by 다움위키 2023. 12. 27.

Citoid는 URL 또는 DOI, PMID, PMCID 및 ISBN과 같은 일부 학술 참조 식별자를 기반으로 온라인 소스로부터 인용 템플릿을 자동으로 생성하는 자동-완성 인용 생성기(auto-filled citation generator)입니다. 그것은 현재 시각 편집기(VisualEditor) 기능으로 사용할 수 있으며, 그러나 미래 어느 시점에는 위키텍스트 편집기에서 사용할 수 있을 것입니다. Citoid는 페이지 링크를 자세한 정보로 변환하기 위해서 Zotero 번역기를 사용합니다.

Step 1: Enable the citation template tool

Citoid 서비스는 시각 편집기의 인용 도구(VisualEditor's Citation Tool)를 사용합니다. 이것은 대부분의 큰 위키 백과와 많은 소규모 프로젝트에서 이미 활성화되어 있습니다. 만약 인용 도구가 활성화되면, "인용(Cite)" 메뉴에 "기본(Basic)" 및 "재사용(Re-use)" 외에도 하나 이상의 로컬 인용 템플릿이 나열될 것입니다. 만약 인용 도구가 활성화되어 있지 않으면, 다음 단계를 진행하기 전에 활성화할 필요가 있습니다. 각 인용 템플릿은 작동하기 위해 표준 TemplateData를 요구할 것입니다.

Step 2: Configure Citoid

Citoid 확장은 특별한 TemplateData 맵과 특별한 Citoid-지정 메시지를 사용하여 반드시 구성되어야 합니다. 이들 두 단계를 순서대로 수행하는 것이 중요합니다!

Step 2.a: Create a 'citoid' maps value for each citation template 

필드 ISSN, ISBN, author, editor 그리고 일부 다른 것들은 citoid 맵에서 배열 [] 또는 2D 배열 [[]]일 수 있는 특별한 필드입니다. 자세한 사항은 여기를 참조하십시요.

Citoid는 각 문서 유형에 대해 필드의 그의 집합을 가지기 때문에 (예를 들어, 저널 이름은 Citoid에서 'publicationTitle'라고 불리지만, Template:Cite_journal에서 'journal'이라고 불립니다), 각 인용 템플릿에 대해 mw:TemplateData의 maps 객체에서 'citoid'라고 불리는 특수 매핑을 반드시 추가해야 합니다. 이 특별한 매핑은 Citoid의 필드와 템플릿의 필드 사이에 맵을 생성합니다. 맵은 Citoid 확장이 어떤 맵을 찾을지 알기 위해 만드는 것을 'citoid'라고 불립니다. 고유한 키를 갖는 맵의 무제한 숫자가 맵 대상에서 허용됩니다. 주목할 것은 TemplateData 맵은 편집 모드에서만 볼 수 있다는 것입니다; 그것은 TemplateData 테이블에서 표시되지 않습니다. 또한 만약 최근에 다른 위키에서 복사하여 해당 위키에 TemplateData를 생성했다면, 그것은 아마도 이미 Citoid 맵을 포함하고 있으므로, 확인한 후에 이 단계를 건너뛸 수 있습니다.

Citoid 확장을 갖는 호환되는 가장 최신 맵 객체는 영문 위키피디아에 있습니다:

Step 2.b: Configuring a special MediaWiki message

특별한 MediaWiki: namespace message, MediaWiki:Citoid-template-type-map.json을 반드시 구성해야 합니다. 이 메시지는 34개의 기본 Citoid 유형 (artwork, book, journalArticle, tvBroadcast, website, 등)을 적절한 템플릿 (Cite web, Cite book, Cite journal 등)에 매핑합니다.

로컬 인용 템플릿을 모든 각 단일 Citoid 유형과 짝지어야 합니다. 만약 템플릿이 짝지어지지 않으면, Citoid가 작동하지 않을 것입니다. 짝지어진 것이 없는 것보다 나쁜 짝지어진 것이 있는 것이 낫습니다. 예를 들어, 만약 위키가 DVD에 대해 패키징에서 라이너 노트를 인용하기 위한 특수한 템플릿을 가지고 있으면, 해당 경우에서 책 또는 비디오에 대해 설계된 템플릿을 사용하는 것을 고려하십시오. 만약 매핑하려는 소스의 유형에 대해 좋은 짝이 없다면 유형에 대해 포괄적인 것으로, 영문 위키피디아의 Template:Citation과 같은, 일반적인 템플릿을 사용하는 것을 고려하십시오.

예제 이름공간 메시지는 영문 위키피디아: https://en.wikipedia.org/wiki/MediaWiki:Citoid-template-type-map.json에서 찾을 수 있습니다.

Troubleshooting 

Citoid has disappeared from my wiki

Phabricator에서 임의의 작동 중단을 보고 하고, 임시 해결 방법을 찾으십시오.

The new cite button does not appear in the toolbar 

2.b 단계에서 미디어위키 메시지를 만들 때, 이전 인용 드롭-다운 메뉴 (File:VisualEditor_-_Cite_Pulldown.png)는 도구 모음 메뉴에서 citoid 서비스에 대해 새로운 버튼으로 대체되어야 합니다. 만약 새로운 보튼이 도구모음에서 표시되지 않으면, MediaWiki:Citoid-template-type-map.json에 문제가 있을 수 있습니다. 만약 이 페이지가 로컬에 존재하지 않거나, 만약 해당 페이지에서 JSON이 유효하지 않으면, citoid는 작동하지 않을 것입니다. 대안적으로, 자바스크립트 캐시를 새로 고침해야 할 수도 있습니다.

Empty references appear 

빈 참조는 맵 데이터를 가지고 있지 않은 인용 템플릿을 삽입하려고 시도할 때 가장 공통적으로 나타납니다. 이 문제는 만약 템플릿에 맵 데이터가 있지만, 해당 데이터가 미디어위키 API에 도달하지 않으면, 역시 나타납니다. 만약 맵 대상은 템플릿의 문서에서 TemplateData 블록에서 존재하면, 템플릿에서 "null edit"을 만드는 것을 시도하십시오. 만약 그래도 작동하지 않으면, 맵 자체에 문제가 있을 수 있습니다.

My favorite site isn't recognized by Citoid and only gets basic information 

Citoid 서비스는 Zotero 번역기가 각 사이트에 대해 쓰여야 하므로 "magic"의 상당 부분에 대해 화려한 Zotero 커뮤니티에 의존합니다. 모든 Zotero 번역기 목록은 https://github.com/zotero/translators 에서 볼 수 있습니다. 현재, Zotero는 영어 소스를 가장 잘 지원합니다. 다른 사이트의 적용 범위를 개선하기 위해서 여러분의 도움이 필요합니다. 자신만의 Zotero 번역기를 작성할 수 있습니다. 먼저 유사한 웹사이트의 기존 번역기를 보는 것으로 시작하시고, mw:Citoid/Creating Zotero translators에서 자습서를 읽어 보십시오.

Dates are formatted differently on my wiki

전체 정보를 갖는 날짜(월, 년, 그리고 일)는 국제 표준 ISO 형식입니다. 만약 공동체가 사용자에게 보이는 방식을 마음에 들지 않으면, 인용 템플릿을 편집하여 ISO 날짜를 해당 언어에서 표준으로 지정한 어떤 형식으로 바꿀 수 있습니다. 예를 들어, 만약 날짜가 ISO yyyy-mm-dd 형식에 있는 것으로 감지되면, 해당 날짜는 그 페이지에서 dd/mm/yyyy으로 *표시하기 위해* 형식을 다시 지정하는 것처럼, 템플릿에 논리를 추가할 수 있습니다. 어쨌든, 만약 이렇게 하면, 기본 데이터 (즉, 위키텍스트 또는 시각편집기에서 형식을 편집할 때)가 동일하게 여전히 유지될 것입니다.

오직 월 그리고 년을 갖는 데이트는 현재 영문 위키피디아에 있습니다. T132308을 참조하십시오.

Many language wiki templates (pl, it, en) don't accept xx-XX style language codes

관련 임무에 대해 T115326을 참조하십시오. 다른 위키가 이 제한을 해결하기로 결정한 방법을 알아보려면 T97256에서 스레드를 참조하십시오.

See also 

관련글

티스토리툴바