WMDE Technical Wishes/Sub-referencing/ko

하위 참조
하위 참조
Status	진행 중
Origin	2013년, 2015년, 2022년 및 그 외 기술 희망 사항 조사
Focus area	참조의 재사용을 쉽게 만들기
Phabricator	프로젝트 게시판
Responsible	기술 희망 팀
	당신의 의견을 알려 주세요 당신을 프로토타입 테스트에 초청합니다. 이는 지속적으로 업데이트될 것입니다. 이 문서를 주시하거나 이 대량 메시지 목록에 가입하여 테스트해 볼 수 있는 것들에 대하여 알아볼 수 있습니다.; 테스트 및 피드백에 대해 더 읽어 보기

This page is a translated version of the page WMDE Technical Wishes/Sub-referencing and the translation is 100% complete.

주어진 글에서 같은 참조를 다른 세부 사항을 가지고 재사용하는 것은 현재로서는 쉽지 않습니다. 공동체 구성원들은 참조의 기존 방식에 기반하고 틀 없이 작동하는, 위키텍스트와 시각 편집기를 위한 미디어위키 해법을 반복적으로 요청해 왔습니다. » 더 알아보기

참조의 재사용을 쉽게 만들기 집중 영역의 일환으로서, 위키미디어 독일의 기술 희망 팀은 하위 참조를 도입 중입니다. 이는 이미 존재하는 참조에, 이를 중복할 필요 없이 서로 다른 세부 사항들을 쉽게 추가할 수 있도록 하는 선택 기능입니다.

2024년 말에 위키미디어 위키에 하위 참조를 도입할 계획입니다.

» 자주 묻는 질문
» 최근 변화 및 다음 단계

하위 참조 요약

하나의 출처를 서로 다른 세부 사항을 가지고 여러 번 인용하려면, 주 참조와 하위 참조가 필요합니다.

주 참조는 참고 문헌의 주요 정보를 포함합니다.
하위 참조는 세부 사항을 포함합니다. 즉, 쪽수, 장, 절(節), 주해 등과 같은, 인용마다 다른 추가 정보를 포함합니다.

참고 문헌 문단에서, 독자들은 하위 참조들이 그 주 참조 아래에 모여 있는 것을 보게 됩니다. 이는 하나의 출처가 얼마나 자주 인용되었는지 파악하기 쉽게 합니다.
위키텍스트의 경우, 하위 참조를 위한 새로운 속성을 사용합니다. 이 속성의 현재 이름은 extends이나, 기능이 도입되기 전에 이름이 바뀔 수 있습니다. 저희는 이름에 대한 피드백을 더 수집할 것입니다.
시각 편집기에서, 저희는 기존 인용 대화창이 하위 참조를 지원하도록 수정 중입니다.

주요 이점

하위 참조는 참조가 작동하는 기존 방식에 기반합니다.
시각 편집기와 위키텍스트 모두에서 잘 작동하므로, 시각 편집기와 위키텍스트가 동등한 기능을 갖추는 데 한 발 더 다가갑니다.
미디어위키에 통합될 것이므로, 모든 위키미디어 위키에서 사용 가능할 것이며 틀에 기반한 방법 없이 사용 가능할 것입니다.
하위 참조는 참고 문헌 미리 보기 및 모바일 참조 팝업에 적절히 표시될 것입니다.
선택적 기능입니다. 다른 참조 방법도 여전히 유효합니다. 다만 여러 문서에서 다른 편집자가 작성한 하위 참조를 만나게 될 수 있습니다.

여러분의 생각을 알려 주세요. 이 새로운 기능이 사용자 작업 흐름을 방해하지 않고, 직관적이며, 위키텍스트와 시각 편집기 이용자 모두에게 (위키텍스트나 틀에 대한 숙련도와 관계 없이) 잘 작동하는 것이 중요합니다. 이를 위해서는 당신의 피드백이 필요합니다.

프로토타입을 테스트해 주세요! 어떻게 테스트하는지에 대해 더 읽기.
토론 문서에 일반 피드백 제공해 주세요.
이 문서를 주시하거나 대량메시지 목록에 가입하여 테스트해 볼 수 있는 새로운 것들에 대하여 알아 보세요.

작동 방식

위키텍스트

하위 참조의 위키텍스트 해법은 거의 다 완성되었습니다. 하지만 속성의 이름은 변경될 수 있습니다. 위키텍스트를 통한 하위 참조가 아직 도입되지 않은 것은 시각 편집기 이용자들의 경험이 위키텍스트 이용자들의 경험과 크게 다르지 않도록 하기 위함입니다. 여전히 프로토타입을 테스트하고 문제점과 개선점을 저희에게 알릴 수 있습니다.

위키텍스트 특화 이점

이름을 갖는 참조의 기존 개념에 기반합니다.
틀 관련 지식이 요구되지 않습니다.
중복에 가까운 참조를 제거하여 위키텍스트를 더 간결하고 군더더기 없고 읽기 쉽게 만듭니다.

단계별 안내

1) 참고 문헌의 주요 정보를 담은 참조(즉, 주 참조)가 필요합니다. 이 참조의 이름도 필요합니다.

<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>

이 주 참조는 참고 문헌 문단에 위치해야 합니다. 다른 곳에 둘 경우 이 글에는 쪽수와 같은 세부 사항을 보여 주지 않는 참조가 존재하게 됩니다.

2) extends 속성과 주 참조의 이름을 사용하여 하위 참조를 만듭니다. 세부 사항을 <ref> 태그 사이에 넣습니다.

<ref extends="Miller">Page 23.</ref>

다음과 같이 보입니다.

According to scientists, the Sun is pretty big.<ref extends="Miller">Page 23.</ref> In fact, it is very big. Take their word for it.<ref extends="Miller">Page 48.</ref> Don't look directly at the sun!<ref extends="Miller">Page 23.</ref>

==References==
<references>
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
</references>

주의

하위 참조를 사용하여 새로운 출처를 인용하고자 한다면, 주 참조를 참고 문헌 문단에 만들기만 하면 됩니다.

그러나 많은 경우에 여러분은 이미 존재하는 참조에 대하여 하위 참조를 사용하기를 원할 것입니다. 이 경우

<ref name>을 사용하여 원래의 참조를 주 참조로 바꿉니다.
주 참조를 참고 문헌 문단으로 옮깁니다.
원래 참조가 놓였던 곳에 하위 참조를 만듭니다.
주 참조의 세부 사항(쪽수 등)을 하위 참조로 옮깁니다. 세부 사항이 주 참조에 남아 있지 않도록 해야 합니다. 그러지 않으면 이들은 두 번 표시됩니다.
서로 다른 세부 사항을 가지고 이 출처를 인용하기를 원하는 곳마다 더 많은 하위 참조를 만듭니다.

하위 참조에 이름을 부여하여 하위 참조 자체를 재사용할 수도 있습니다.

According to scientists, the Sun is pretty big.<ref extends="Miller" name="Miller, 23">Page 23.</ref> In fact, it is very big. Take their word for it.<ref extends="Miller">Page 48.</ref> Don't look directly at the sun!<ref name="Miller, 23" />

==References==
<references>
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
</references>

주의 사항

참조를 주 참조 및 하위 참조로 변환하는 작업은 약간의 정리를 필요로 하며, 특히 주 참조는 참고 문헌 문단에 위치시켜야 합니다 (위 설명 참고).
하위 참조는 인용 틀과 같이 사용할 수 있습니다. 저희는 가장 자주 사용되는 인용 틀들에 대하여 테스트를 마쳤지만, 일부 인용 틀들은 저희 해법과 같이 사용하기 위해서 업데이트가 필요할 수 있습니다.
일부 인용 관련 소도구 및 스크립트들도 새로운 하위 참조 해법과 호환되기 위해서는 업데이트가 필요할 수 있습니다.
하위 참조의 하위 참조는 만들 수 없습니다.
<ref group>을 사용하는 경우, 주 참조와 하위 참조는 같은 그룹에 속하여야 합니다.

시각 편집기 (개발 중)

이 시점에서 저희는 시각 편집기에서의 기능이 어떤 모습일지 정확히 알지 못합니다. 아직까지는 최소한의 해법만이 존재하며 아직 도입이 준비되지 않았습니다. 수주 안에 이 해법은 변경될 가능성이 높습니다. 시각 편집기 해법의 현재 상태에서의 프로토타입을 테스트해 볼 수 있습니다. 변할 수 있음에 주의하세요. 새로운 테스트거리가 생기면 이 문서를 업데이트할 것입니다.

시각 편집기 특화 이점

같은 출처를 서로 다른 세부 사항을 가지고 인용할 때 더 이상 새로운 참조를 처음부터 만들 필요가 없습니다.
하위 참조는 (틀 기반 방법과 달리) 시각 편집기와 완전히 호환됩니다. 인용 대화창을 통하여 만들 수 있으며 참고 문헌 문단에서 편집할 수 있습니다.

현재 프로토타입의 워크플로 (변경될 가능성이 높음)

하위 참조 만들기

하위 참조를 만드는 작업은 현재 기존 인용 대화 상자를 통해 이루어집니다.
"확장" 탭에서 재사용하려는 참조를 선택합니다. 이 탭은 현재 사용자 테스트 세션 이후에 개선될 가능성이 높습니다.
해당 하위 참조의 세부 정보를 입력하고 삽입을 클릭하세요.
시각편집기의 참조 팝업은 이 참조가 하위 참조임을 보여주고, 얼마나 자주 재사용되는지 알려줍니다.

기존 하위 참조 편집

하위 참조를 편집하려면 기사 텍스트에서 각주 표시를 클릭하세요.
이제 하위 참조의 세부 정보를 변경할 수 있습니다. 또한 하위 참조라는 사실도 알려줍니다.
아직은 참조 목록에서 하위 참조를 편집할 수 없습니다.
주요 참고문헌을 편집하려면 참고문헌 섹션에서 해당 참고문헌을 클릭하세요.

하위 참조 재사용

인용 대화 상자의 '재사용' 탭을 사용하여 하위 참조를 재사용할 수 있습니다.

참고하세요

시각편집기에서 참조의 자동 이름에 대한 기존 문제는 하위 참조에서도 발생합니다.
시각편집기에서 현재 하위 참조의 하위 참조를 만들 수 있습니다. 이는 오류이며 저장 시 오류가 발생합니다. 실제 솔루션에서는 나중에 작동하지 않으며 위키텍스트에서도 작동하지 않습니다.
재사용되는 참조를 삭제하면 어떤 일이 일어나는지에 대한 문제는 아직 해결되지 않았습니다.
기존 참조를 기본 참조와 하위 참조로 전환하는 워크플로는 아직 정의되지 않았습니다.
시각편집기에서 하위 참조의 재사용을 생성한 다음 위키텍스트로 전환하면 위키텍스트의 문장이 <ref extends="main-reference" name="sub-reference" />임을 알 수 있습니다. 이는 버그이며 T367749의 일부로 수정됩니다.
<ref name="sub-reference name"/>는 현재 시각편집기 편집 모드에서 하위 참조에 대한 참조 미리 보기를 제대로 표시하지 않습니다. 팝업에서 하위 참조의 세부 정보만 볼 수 있고 주 참조의 정보는 볼 수 없습니다. 팝업에서 주 참조의 정보도 보려면 현재 <ref extends="main" name="sub-reference name" /> 구문을 사용해야 합니다.

프로토타입 테스트

우리는 올바른 것을 구축하기 위해 여러분의 피드백이 필요합니다. 피드백이나 질문은 이 프로젝트의 토론 페이지에서 언제나 환영합니다.

프로토타입은 베타 위키에서 사용할 수 있습니다. 현재, 우리는 주로 위키텍스트 솔루션을 테스트하도록 초대합니다: 베타 위키에서 테스트 피드백

베타 위키는 일반 위키와 약간 다르다는 점을 참고하시기 바랍니다.

다르게 보일 수도 있습니다(예: 선호하는 스킨을 사용하지 않을 수 있음).
아직 테스트 중인 몇 가지 새로운 기능을 제공할 수도 있습니다.
여기에는 전체 위키 콘텐츠가 아닌 일부 테스트 페이지와 템플릿만 포함되어 있으며, 익숙한 모든 템플릿, 모듈, 소도구 등이 포함되어 있지 않습니다.
베타 위키에서는 일반 위키미디어 로그인이 작동하지 않습니다. 계정을 등록할 수 있습니다. 일반 위키미디어 계정과 다른 비밀번호를 사용해야 합니다. 아니면 계정 없이 기능을 테스트할 수 있습니다. 그러면 임시 계정이 생성됩니다(de-betawiki에서) 또는 IP 주소를 표시합니다(en-betawiki에서).

우리가 해결하고 있는 문제

위키백과 문서에서는 출처를 여러 번 참조하는 것이 일반적입니다. 하지만 참조를 "있는 그대로" 재사용할 수는 있지만, 현재는 "다른 세부 정보" (예: 다른 페이지 번호)로 동일한 참조를 재사용할 수 없습니다. 유일한 옵션은 완전히 새로운 참조를 만들거나 해결 방법을 사용하는 것입니다.

현상 유지: 위키텍스트와 시각편집기에서 참조 재사용

위키텍스트에서 참조를 재사용하려면 명명된 참조로 전환하여 문서의 다른 지점에서 해당 이름을 참조할 수 있습니다. 명명된 참조는 문서 텍스트나 참조 섹션에 배치할 수 있습니다. Visual Editor에서 인용 대화 상자에서 "재사용" 옵션을 사용할 수 있습니다. 참조 섹션에서 같은 이름의 참조는 함께 그룹화됩니다.

위키텍스트: 문서 텍스트의 <ref name>
위키텍스트: 참고 문헌 문단 속 <ref name>
시각 편집기: 인용 대화창
독자 뷰

현황: 위키텍스트에서 다양한 세부 사항을 가진 인용 재사용

위키텍스트에서 기존 인용을 서로 다른 세부 사항을 추가하여 재사용하고자 한다면, 현재로서는 기존 인용을 복사 및 붙여넣기한 뒤 세부 사항을 변경하거나, 처음부터 새로운 (거의 같은) 인용을 만들어야 합니다. 일부 위키프로젝트는 짧은 인용과 같은 대안 또는 간소화 각주와 같은 틀 기반 해법을 사용합니다. 참고 문헌 문단에서 원래 인용과 새 인용은 한데 묶여 있지 않습니다.

위키텍스트 속, 거의 같은 두 인용.
독자 뷰: 거의 같은 인용들이 한데 묶여 있지 않음
위키텍스트 속, 짧은 인용을 통한 대안
독자 뷰: 짧은 인용을 통한 대안
위키텍스트 속, {{sfn}}를 통한 대안
독자 뷰: {{sfn}}를 통한 대안

현황: 시각 편집기에서 다양한 세부 사항을 가진 인용 재사용

시각 편집기에서 기존 인용을 서로 다른 세부 사항을 추가하여 재사용하고자 할 때, 인용 대화창에서 "재사용"하는 방법이나 복사-붙여넣기 하는 방법은 모두 소용 없습니다. 이는 둘 모두 동일한 재사용(즉, 하나의 세부 사항을 수정하면 남은 하나의 세부 사항도 똑같이 수정됨)을 야기하기 때문입니다. 그 대신 거의 동일한 인용을 처음부터 새로 만들어야 합니다. 참고 문헌 문단에서 원래 인용과 새 인용은 한데 묶여 있지 않게 됩니다.

{{sfn}}와 같은 틀 기반 방법을 통해 만든 인용은 참고 문헌 문단에서 편집될 수 없으며 인용 재사용 탭에 나타나지 않지만, 글 내 위치로 가면 수동으로 편집할 수 있습니다.

{{sfn}}을 통한 대안:

독자 뷰
"편집"을 클릭하면 인용이 참고 문헌 문단에서 사라짐.
"재사용" 대화창에서 {{sfn}} 인용을 사용할 수 없음.
인용은 그 글 속에서의 위치를 찾아낸 뒤에야 편집 가능

독자가 겪는 문제

틀 기반 대안은 각주 미리 보기·각주 말풍선·모바일 각주 팝업에서 적절히 표시되지 않습니다.

{{sfn}} 대안과 각주 미리 보기:

각주 미리 보기: 주요 정보가 팝업에 표시되지 않음.
각주 말풍선: 주요 정보가 처음 나타나는 팝업에 표시되지 않음.
각주 말풍선: 주요 정보가 두 번째 팝업에 표시됨.
모바일 각주 팝업: 주요 정보가 표시되지 않음.

현황의 주요 문제점

시각 편집기와 위키텍스트 이용자의 경험이 매우 상이합니다.
다양한 세부 사항을 가진 인용 재사용을 위한 대부분의 대안은 시각 편집기와 잘 호환되지 않습니다.
세부 사항이 다른 거의 동일한 인용들은 위키텍스트를 불필요하게 길고 읽기 어렵게 만듭니다.
틀 기반 대안은 모든 공동체에 의하여 받아들여진 것이 아니므로 모두가 사용 가능하지 않습니다.
일부 사용자는 출처를 참고 문헌 문단에 놓고 글 속에서 전혀 인용하지 않음을 통해 문제를 피하려고 하며, 이는 글의 내용을 확인 가능하기 어렵게 만듭니다.

최근 변화 및 다음 단계

저희 팀이 이 문제를 들여다 본 지 어느 정도 시간이 흘렀습니다. 여기는 이 프로젝트의 역사의 개요이며, 이는 저희의 연구 과정을 포함합니다. 수 년 동안 테스트와 인터뷰에 참여하거나 저희 프로젝트에 관심을 보이고, 저희 토론 문서에서 답글을 다는 데 시간을 쓴 모든 분들께 감사합니다. 깊은 감사를 표합니다. 추가 피드백은 토론 문서에서 공유해 주세요.

Y 베타 위키에 체험 가능한 프로토타입이 있습니다. 이는 위키텍스트 해법 전체와 시각 편집기 해법의 일부 기본 기능을 다룹니다. 프로토타입을 테스트하고 피드백을 제공할 수 있습니다.
Y저희는 이 새로운 기능에 대해 모든 위키에 공지사항을 보내 커뮤니티에 알리고, 테스트해 보고 피드백을 제공하도록 요청했습니다.
Y우리 팀은 위키마니아 2024에서 하위 참조를 발표하고 참가자들과 논의했습니다. (YouTube)
현재 여러 프로젝트에 걸친 사용자들이 조정 이용자 테스트에 참여하고 있습니다.
우리는 잠재적인 파일럿 위키에 연락하고 있으며 10월에 해당 위키에 하위 참조 기능을 배포할 계획입니다.
우리는 2024년 말까지 다른 위키미디어 위키에 하위 참조 기능을 배포할 계획입니다.
배포 후에도 해법 개선을 위한 피드백 수집을 계속할 예정입니다.

저희는 "인용 재사용" 집중 영역의 다른 문제들에 대하여 인지하고 있으며, 이들도 함께 살펴보도록 노력할 것입니다. 그러나 저희의 초점은 여전히 하위 인용 해법 제시에 맞추어져 있습니다.

자주 묻는 질문

하위 인용을 사용하는 글들은 어떻게 찾을 수 있나요?

분류:확장 인용을 사용하는 문서라는 이름의 추적용 분류가 하위 인용을 사용하는 모든 문서에 추가됩니다. 이를 통해 새 기능을 사용하는 문서들을 탐색 또는 수정할 수 있습니다. 이 분류의 이름은 변경될 수 있습니다.

인용 틀/도구와 함께 사용 가능한가요?

네, 하위 인용을 인용 틀과 함께 사용할 수 있습니다. 가장 흔히 사용되는 인용 틀들(예를 들어 서적 인용 또는 웹 인용)을 테스트해 보았으며, 예상되는 문제는 없습니다. 그러나 일부 틀들은 저희 해법과 같이 쓰기 위한 업데이트가 필요할 수 있습니다. 일부 인용 관련 소도구/스크립트들 역시 새로운 하위 인용 해법과 호환되기 위해 업데이트가 필요할 수 있습니다. 틀, 소도구, 스크립트들은 위키 공동체 수중에 있기 때문에 저희가 수정할 수 없습니다.

문제를 발견하거나 인용 틀을 새 기능에 맞게 업데이트하는 데 도움이 필요하다면 토론 문서에서 알려 주세요.
저희의 위키미디어 워크숍 "[$2 완전히 새로운 인용 선택지 - 인용 틀에 있어서 어떤 의미를 가질까?]"(혼합)에 참석하거나 나중에 녹화 기록을 시청할 수 있습니다.

하위 인용 속성의 이름은 무엇이 될까요?

아직은 모릅니다. 현재 하위 인용을 만들기 위한 속성의 이름은 extends입니다. 이는 공동체 및 위키미디어 재단 관계자들과의 토론을 거쳐 결정되었습니다. 그러나 이 이름이 최선의 선택이 아닐 수 있다는 피드백이 존재합니다. 이 기능을 위키에 도입하기 전에, 속성 이름에 대한 더 많은 피드백을 받고자 하며 몇 가지 대안들에 대하여 논의하기를 계획 중입니다. 때가 되면 알려 드릴 것입니다.

왜 이 위키텍스트 문법을 선택하였나요?

이 기능의 위키텍스트 구현을 시작했을 때, 저희는 다양한 방안을 논의했습니다. 새로운 태그(예를 들어 <subref>)를 추가하는 것은 신중하게 논의되었지만, 사용자가 배워야 하는 새로운 문법의 양을 최소화 하기 위해 기존의 <ref> 방법을 유지하고자 했습니다. 또한, 새로운 태그는 인용을 위한 기존 공동체 소프트웨어(도구, 소도구, 봇 등)의 많은 업데이트를 필요로 합니다.

하위 인용의 세부 사항을 <ref> 태그 안에 적도록 하자는 제안이 2008년에 있었습니다. 즉, <ref page="page 2" name="Miller"> 또는 <ref detail="page 2" name="Miller">(더 나중에 제안됨)와 같이 적고, name 속성을 통해 주 인용을 가리키자는 제안입니다. 이는 ko:틀:서적 인용과 같은 틀의 사용법과 유사합니다.

그러나 이 방법은 틀과의 문제를 야기하며 오류를 유발하기 쉽습니다. 다른 부차적인 문제점으로서, 이 방법은 하위 인용의 재사용을 지원하지 않습니다. 이는 name 속성이 이미 주 인용을 가리키기 위해 사용되었으며, 한 번 더 사용될 수 없기 때문입니다.

두 가지 문제점을 피하는 한 가지 방법은 새로운 속성을 만들고 하위 인용의 세부 사항을 여는 <ref> 태그와 닫는 태그 사이에 적는 것입니다 (이는 기존에 인용의 내용을 적을 때 이미 사용하고 있는 방식입니다). 이는 저희의 방법입니다.

왜 이렇게 오래 걸렸나요?

기술 희망 팀은 수 년 동안 이 문제의 해결에 힘써 왔습니다. 더 알고자 한다면 역사 및 문제의 복잡성의 개요를 참고하십시오.