Help:Extension:FileImporter/ko

주의사항: 이 문서를 편집하면 CC0에 따라 당신의 기여한 것을 배포하는 데 동의하는 것으로 간주됩니다. 자세한 내용은 퍼블릭 도메인 도움말 문서를 확인 하세요.

FileImporter / FileExporter 확장기능은 각 위키에서 위키미디어 공용으로 파일을 이동하는 일을 쉽게 해 줍니다. 이 새 기능은 파일에 원래 있던 데이터와 문서 역사를 그대로 보존한 상태에서 공용으로 파일을 옮기게 도와줍니다.

FileExporter 확장기능은 각 위키에 위키미디어 공용으로 파일을 옮기는 URL을 제공한 후, 후속 작업을 "FileImporter"에게 넘깁니다. FileImporter 확장 기능은 위키미디어 공용의 확장기능으로써 파일의 요구 사항이 적합한지 확인한 후 파일을 들여옵니다. 기술적으로 말하자면, 파일을 "복사"하는 것이 아니라 "들여"오게 됩니다.

FileImporter 확장 기능은 2018년 6월에 위키미디어 공용에 활성화되었습니다. 이 기능을 사용하기 위해서는, 여러분이 활동하는 위키에서 FileExporter 기능을 베타 기능으로 활성화해야 합니다. FileExporter is deployed and enabled as default feature on all Wikimedia wikis since August 2020.

배경

FileImporter / FileExporter 확장 기능은 독일어권 위키미디어 공동체의 기술 희망사항 프로젝트의 요청을 충족하기 위해 위키미디어 독일지부의 기술팀이 개발했습니다. 더 자세한 내용은 메타의 프로젝트 문서에서 확인할 수 있습니다.

사용법

시작하기

1) FileExporter 확장 기능을 사용하기 위해서 로그인 상태여야 합니다.

2) 여러분의 위키를 위한 설정 파일이 있어야 합니다. CommonsHelper2 도구의 설정을 기반으로 한 파일들이 여럿 존재합니다. 필요한 경우 들여오는 작업이 정상적으로 진행될 수 있도록 설정 문서를 검토하거나 생성하기를 바랍니다.

설정 파일이 어떻게 동작하는지와 왜 설정 파일이 필요한지에 대해서는 이 설명을 참조하기 바랍니다.

단계별 순서

이 기능을 사용하기 위해서는 로그인해야 합니다.

• 
  1. 여러분의 위키의 파일 문서에서, "Export to Wikimedia Commons" 탭을 클릭하세요 (사진 위에 있습니다).
• 
  2: FileImporter 검사 FileImporter 가 파일을 들여올 수 있는지, 들여오면서 파일을 변경해야 하는지 확인합니다. 이 절차는 위키의 설정 파일을 기반으로 진행됩니다. 더 알아보기.
• 
  3: 공용의 미리보기 문서를 통해 어떤 부분을 들여올지 볼 수 있습니다. 파일 이름과 문서 정보를 수정하고, FileImporter에게 "공용중복" 틀을 붙이거나 관리자의 경우 파일을 바로 삭제함으로써 후속 작업을 처리하도록 요청할 수 있습니다. "Import File" 버튼을 통해 파일을 복사하세요.
• 
  4: 파일 옮겨짐 파일을 옮길 때 원래 파일의 게시자와 파일을 옮긴 사람, 파일의 과거 역사와 파일을 들여오며 만든 변경 사항이 모두 저장됩니다.

가져온 파일을 찾는 방법

• 파일의 역사에서, 들여오기 편집은 빈 편집으로 표시됩니다 (예: 문서의 변경 사항이 없는 역사 내역). 문서를 가져오는 동안 변경된 사항이 있다면, 추가 문서 편집이 이루어집니다.
• 문서를 가져오는 동안 변경된 사항을 반영하는 편집에는 Modified with FileImporter 태그가 부착됩니다. 이렇게 하면 최근바뀜에서 해당 내용을 별도로 볼 수 있습니다.
• 파일 올리기 기록과 들여오기 기록이 같이 생성되며 문서를 들여오는 사용자가 들여오는 시각에 빈 편집을 한 것으로 처리됩니다. 두 기록이 모두 남는 것이 기본 설정입니다. 이로 인해 최근 바뀜과 주시문서 목록에 중복 기록이 남을 수 있습니다. 예시 파일과 기록을 참조하세요.
• 과거의 파일 편집의 경우, 원래 파일이 게시된 날짜와 원래 파일을 올린 사용자의 이름이 파일 올리기 기록에 기록되어 해당 파일이 공용의 파일 올리기 기록에 반영됩니다. 이러한 편집본은 Imported with FileImporter 태그가 부착됩니다.
• 들여온 파일은 보이지 않는 문서 내 내용을 통해 "이 파일은 FileImporter에 의해 이동되었습니다"라는 문구와 원래 파일의 URL이 기록됩니다. CirrusSearch의 insource: 기능을 통해 이러한 내용이 있는 파일을 찾을 수 있습니다. 예시: insource:"This file was moved here using FileImporter from //en.wikipedia" Note this also finds later derivatives of imported files, but not files where the comment was removed.

How to add categories

The message fileimporter-post-import-revision-annotation (empty by default) can be used to add any additional wikitext to every imported file. The message accepts two parameters:

• $1 - Full URL of the source file.
• $2 - Time of the import in ISO 8601, e.g. 2004-02-12T15:19:21+00:00.

For example, to categorize by source wiki, an interface administrator can set the message to {{#invoke:Imported with FileImporter|main|url=$1|time=$2}}, where the invoked Lua module ("Module:Imported with FileImporter" in this example) looks like this:

local exports = {}
function exports.main( frame )
    return "[[Category:Files moved to Commons from " .. mw.uri.new( frame.args.url ).host:gsub( ".org", "" ) .. "]]"
end
return exports

Deployment roadmap

• 2018-06-12: Export to test.wikipedia.org
  • FileExporter as a beta feature on mediawiki.org and test2.wikipedia.org.  OK (To test the export, you also need to be an auto-confirmed user on these wikis.)
  • FileImporter on test.wikipedia.org  OK

• 2018-06-25: Export to Wikimedia Commons
  • FileExporter as a beta feature on de.WP, fa.WP, ar.WP  OK
  • exporting from mediawiki.org now to Wikimedia Commons  OK
  • FileImporter on Wikimedia Commons  OK
• 2018-07-11:
  • FileExporter as a beta feature on wikisource  OK
• 2019-01-16:
  • Deployment of the FileExporter beta feature to all other wikis  OK

• 2019-09-24:

• • Deployment as a default feature on de.WP, fa.WP, ko.WP, mr.WP and sourceswiki (wikisource.org)  OK

• 2020-08-05:

• • Deployment as a default feature on all remaining Wikis

 OK

링크

• Main project page on Meta

• FileImporter - extension manual
• Extension:FileImporter/List of configured wikis - FileImporter configurations
• FileExporter - extension manual
• phab:tag/move-files-to-commons/ - Phabricator project
• overview: How templates are matched with the FileImporter extension