사용자:Scartol/Scartol, 템플릿 사용 및 설계 시

Scartol, 템플릿 사용 및 설계 시

템플릿 만들기 튜토리얼에 오신 것을 환영합니다, 질문과 코멘트는 여기 또는 내 토크 페이지에서 환영한다.

위키피디아에서 템플릿은 이름 앞에 템플릿 접두사가 있는 페이지로서 다음과 같다. Template:Example.

템플릿 이름(접두사 없음)이 나타날 때마다 템플릿의 특수 기능이 기본 제공된다는 점을 제외하고 템플릿은 다른 페이지와 동일함 {{within curly brackets just like this}}다른 페이지의 원본 텍스트에서 다른 페이지가 표시되면 해당 위치에 자동으로 삽입된다. 이 특징을 전폐라고 한다.

기사의 네비게이션 상자, 사용자 페이지 상단에 있는 메뉴, 위키프로젝트 구성원 모두의 사용자 페이지에 표시되는 작업 목록 등 여러 페이지에 동일한 내용을 표시하고자 할 때 전폐가 유용하다. 템플리트의 또 다른 장점은 템플리트를 조정할 때(예를 들어, 텍스트를 업데이트하거나 형식을 변경하거나 공지사항을 추가하기 위해), 템플리트를 포함하는 모든 페이지에 조정사항이 나타난다는 것이다.

템플릿 네임스페이스에 없는 페이지도 변환할 수 있지만, 다음과 같이 페이지의 네임스페이스 접두사를 포함해야 하는 페이지: {{Wikipedia:Welcome}}. 그러나 전대할 페이지가 본문공간에 있다면 다음과 같이 이름 앞에 대장(:)을 붙여야 한다. {{:Humanism}}.

이 레슨을 읽는 동안 샌드박스를 열어두는 것이 좋으니, 앞으로 나아가면서 스스로 시험해 볼 수 있도록 하는 것이 좋다. {{X1}, {{X2}} …{X9}}}에 템플릿 샌드박스가 몇 개 있는데, 이 템플릿 샌드박스는 위키백과에서 사용할 수 없는 수십 개의 페이지를 추가하지 않도록 하기 위해 시작하기에 좋은 곳이다.템플릿 네임스페이스.

기본 사항

템플릿은 매우 기초적인 기능에서 고도로 고급화된 기능에 이르기까지 여러 가지 기능을 제공할 수 있다. 우리는 가장 간단한 요소부터 시작해서 앞으로 나아갈 것이다.

기본연계

샘플 템플릿에 링크하는 것부터 시작합시다. 이 부분은 간단하다. 샌드박스에 입력만 하면

[[템플릿:X9]]

"Save page"를 누르십시오. 이제 페이지에 도달하기 위해 클릭할 수 있는 링크(템플릿:X9)가 있을 것이다. 그것은 마치 기사에 링크하는 것과 같다 – 유일한 차이점은 템플릿 네임스페이스에서 작업한다는 것이다.

또한 "tl " 앞에 있는 가새에 이름을 입력하여 템플릿에 링크를 추가할 수 있다. 샌드박스에서 처음 만든 링크를 제거하고 다음을 입력하십시오.

{{tl X9}}}

그리고 저축한다. 교정기 안쪽의 링크는 {{X9} – 약간 다르게 보이지만 다른 링크와 같은 위치로 이어진다.(이 템플릿 나열 형식은 다른 링크와 다르게 보이고 타이핑이 덜 필요하기 때문에 자주 사용된다.) 우리는 왜 "tl"이 필요한지 곧 알게 될 것이다.

아직 존재하지 않는 템플릿에 대한 링크를 만들면 (기사처럼) 빨간색 링크가 생성된다는 점에 유의하십시오.

기본 편집

{{X9}}의 링크를 클릭하고 "이 페이지 편집"을 선택하십시오.(보통 새 창이나 탭에서 이 작업을 수행하므로 샌드박스가 계속 열려 있다.) {{X9} 페이지에 이미 텍스트가 있는 경우 삭제하십시오. 그런 다음 다음을 입력하십시오.

만드는 법을 배우고 있다 [[위키피디아:템플릿]]]]]

그런 다음 편집 요약("실험이 좋다")을 포함하고 "페이지 저장"을 누르십시오. {{X9}페이지의 모양은 다른 페이지와 같으며, 이 튜토리얼에 대한 링크가 있다. 템플릿 페이지는 문서 또는 사용자 페이지와 동일한 내용(텍스트, 링크, 그림, 기타 템플릿)을 포함할 수 있다. 이것은 혼란스러울 수 있지만, 지금은 단순하게 할 것이다.

기본횡단

기술적 정의를 가지고 있지만, 이 경우, 전폐의 기본 개념은 데이터를 템플릿에 가져다가 다른 페이지에 배치하는 것이다.

샌드박스의 {{tl X9} 코드 아래에 다음을 입력하십시오.

{{X9}}

그리고 저축한다. 다음을 확인하십시오.

{{X9}}
위키백과 만드는 법을 배우고 있다.템플릿.

템플릿에 대한 링크를 만들려면 "tl" 코드를 포함하는 것이 왜 중요한지 이제 이해하셨으면 좋겠는데, 이 세 글자가 없으면 위키피디아에게 템플릿의 모든 것을 초월하라고 말하는 겁니다.

문서화

템플릿 사용 방법에 대한 문서화(또는 "문서"를 다른 사용자도 사용할 수 있도록 포함시키는 것이 좋다. 가장 쉬운 방법은 문서들을 템플릿과 같은 페이지에 포함시켜, <무포함> 태그로 둘러싸는 것이다. (템플릿이 표시될 때 문서가 포함되지 않도록 주의하십시오.)

{{X9} 템플릿 페이지로 돌아가서 아래쪽에 다음을 추가하십시오.

<noinclude>==Documentation==이 템플릿을 페이지에 추가하려면 다음 코드를 입력하기만 하면 된다:{tl X9}}. 그것밖에 없다!</없음>

그리고 저축한다. 이제 당신의 템플릿을 방문하는 사람들은 그것을 쉽게 사용할 수 있을 것이다.[1]

문서를 제공하는 다른 방법은 문서들을 위해 별도의 페이지를 만든 다음 그것들을 템플릿에 포함하는 것이다. 가장 일반적인 방법은 "/doc"이라는 템플릿의 하위 페이지를 만드는 것이다.

{{X9}} 템플릿으로 돌아가서 방금 넣은 문서를 제거하십시오. 그런 다음 다음을 입력하십시오.

<무인용>{{noinclude doc}}></noinclude용>

그리고 저축한다. 이런 상자는 꼭 받아야 한다.

문서화[만들기]

"만들기" 링크를 클릭하면 Template:X9/doc 페이지의 편집자가 된다. 이 페이지에 이미 코드가 몇 개 있습니다(모든 새 템플릿 문서에 표시됨). 나는 편집자들이 분류되지 않은 템플릿을 제한하기를 원한다고 생각한다.

사용 머리글 아래에 다음을 삽입하십시오.

이 템플릿을 페이지에 추가하려면 다음 코드 {{tl X9}만 입력하면 된다!  

그리고 저축한다. 여기서 우리는 <무포함> 태그를 사용할 필요가 없다는 점에 주목하십시오. 그것은 우리가 처리할 일이기 때문이다. 이제 {{X9} 템플릿을 다시 로드하면 문서 페이지가 자동으로 포함됨 (추측했겠지만, 이것은 템플릿 내의 템플릿의 예)

별도의 문서 페이지를 설정하면 많은 경우 편집 프로세스가 쉬워진다. 또한 변수 및/또는 예에 대한 설명뿐만 아니라 "참고" 링크에도 좋은 지점을 제공한다. (우리는 저것들로 간다.)

이미지 및 테이블

템플릿은 설계 목적에 유용할 수 있다(특히 사용자 페이지와 기사 정보박스). 간단한 이미지를 샘플 템플릿에 추가해 어떻게 작동하는지 봅시다. 그러는 동안 HTML 코드를 몇 개 보여 줄게, 아주 편리할 거야.

{{X9}} 템플릿에서 첫 번째 줄 앞에 다음을 입력하십시오.

<표 너비=100% 테두리=1><td 너비=50%>[이미지:Maida arch.jpg 50px]</기울기> <기울기폭=50%>

그런 다음, 앞서 작성한 텍스트 줄 뒤에("배우고 있어...") 다음 코드를 추가하십시오.

</그냥>[그냥]

그리고 저축한다. 다음 사항을 확인하십시오.

Maida arch.jpg 위키백과 만드는 법을 배우고 있다.템플릿.

(이탈리아 마을 마이다에서 찍은) 사진과 본문은 이제 간단한 테이블의 세포로 둘러싸여 있다. 돌아가서 샌드박스를 다시 로드하면 테이블도 거기에 나타나야 한다.

간단히 말해, 코드는 다음과 같이 한다. <테이블> 태그는 테이블의 시작이다. (표 끝에 닫는 </테이블> 태그가 있다는 점에 유의하십시오. 대부분의 HTML 태그에는 닫히는 </어떠한> 상대 태그가 있습니다.) <테이블> 태그 안에는 테이블 폭(페이지의 100%)과 테두리 두께(1픽셀)를 포함시켰다. 이후 행의 시작을 표시해야 한다(이것은 <tr> 태그다). 그런 다음 표의 각 셀("td"는 표 데이터 셀을 의미한다)에 <td>를 사용한다.

테이블은 사용자 지정이 매우 쉽기 때문에 레이아웃에 좋다. 위키북에서 테이블에 대한 모든 것을 배울 수 있다. 레이아웃에 사용되는 대부분의 테이블에는 코드에 "경계=0"이 있으므로, 코드 뒤에 있는 구조를 모두 볼 수 없다는 점에 유의하십시오.

CSS는 템플릿 테이블에서도 사용할 수 있다(<td style="백그라운드:#CCCCC">를 예로 들 수 있다.

중간

좋아, 한 단계 올려보자. 빵!

매개변수

위키백과 템플릿에서 매개변수는 대수 문제에서 X와 같은 일종의 변수다. 템플리트가 렌더링될 때 매개변수 스팟에 플러그를 꽂는 것이 모두 포함된다. 시험 삼아 한번 해 봅시다.

{{X9} 템플릿으로 돌아가서 테이블 코드를 삭제하고 다음을 추가하십시오.

{{{1}}}}은(는) 역대 최고의 텔레비전 쇼다.

"1" 주위에 있는 세 개의 브레이스는 그것을 매개변수로 만든다. 이제 샌드박스의 {{X9} 아래에 다음 코드를 입력하십시오.

{{X9 더 심슨스}}

그리고 저축한다. 다음 사항을 확인하십시오.

심슨 가족은 역대 최고의 텔레비전 쇼다.

위키피디아는 우리의 템플릿에서 매개 변수를 {{1}} – 템플릿 이름 코드에 포함된 정보로 대체했다. 샌드박스의 코드를 다음으로 변경해 보십시오.

{{X9 몽티 파이썬의 플라잉 서커스}}

이제 다른 매개 변수를 추가해 봅시다. {{X9}} 템플릿으로 돌아가서 다음과 같이 변경하십시오.

{{{1}}}}은(는) 역대 최고의 텔레비전 쇼로, {{{1}}}은(는) 이 쇼에서 최고의 캐릭터다.

그런 다음 읽을 샌드박스를 변경하십시오.

{{X9 심슨 리사}}

다음을 얻으십시오.

심슨 가족은 역대 최고의 텔레비전 쇼로, 리사는 이 쇼에서 최고의 캐릭터다.

여기서 주목해야 할 것은 두 가지다.

  1. 기본 파라미터는 숫자 1, 2, 3 등이다. 숫자는 템플릿 이름 코드(기호로 구분)에 있는 항목의 순서에 해당한다. 여기서 "심슨 가족"은 1이고 "리사"는 2이다. 숫자 대신 단어를 사용할 수 있지만, 이것은 더 많은 작업을 필요로 한다. 예를 들어 {{1}}을(를) {{{{Show}}}}(으)로 만들려면 읽을 템플릿 이름의 코드를 변경해야 한다. {{X9 show="심슨 가족"}}.
  2. 매개변수는 스타일을 설정하거나 연결하거나 다른 매개변수를 포함할 수 있다. 이것의 예를 보자.

샌드박스의 코드를 변경하여 다음과 같이 말하십시오.

{{X9"[The Simpsons]]"'[Lisa Simpson]]"}}

이제 텍스트 줄에는 심슨가족리사 심슨가족 둘 다에 대한 링크가 있어야 한다. 프로그램의 이름은 이탤릭체로, 리사의 이름은 굵은 글씨로 표시되어야 한다.

마법의 주문

이것은 템플릿에 특정되지 않지만, 이른바 "마법적인 단어"를 사용함으로써 다양한 메타 정보를 포함할 수도 있다. 자세한 내용은 이 페이지를 참조하십시오.

하위(항목)

템플릿 A를 페이지 X로 변환하면, 위키피디아는 템플릿 A에 있는 모든 것을 복사하여 페이지 X에 바로 넣는다. 만약 누군가가 템플릿 A의 내용을 변경한다면, 페이지 X (및 그것이 나타나는 다른 모든 페이지)는 자동으로 변경될 것이다. 대부분의 경우 이것은 좋은 일이다. 템플릿이 매우 유용한 주요 이유 중 하나이다.

그러나 템플릿 A에서 페이지 X로 정보를 한 번만 스탬프로 찍어보고 나중에 템플릿 A가 어떻게 변경되든 상관없이 이 정보를 영원히 동일하게 유지한다고 가정해 보십시오. 이것이 신들이 치환을 만든 이유다.[2]

샌드박스로 돌아가서 – 코드 아래 {{X9 '[심슨]'''[리사 심슨]''}}}}을(를) 입력하십시오.

{{subst:X9"[The Simpsons]]"'[Lisa Simpson]]"}}}

그리고 저축한다. 너도 똑같은 걸 얻을 수 있어 하지만 어떤 잃어버린 영혼이 어떤 슬픈 이유로 심슨 가족을 폄하하고 싶어한다고 가정해보자. {{X9}} 템플릿에 들어가서 다음과 같이 변경하십시오.

{{1}}}은(는) '영원한 쇼'이며, {{{2}}분은 '영원한 캐릭터'이다.

이제 저장한 후 샌드박스를 다시 로드하십시오. 첫 번째 줄에는 다음이 표시되어야 한다.

심슨 가족역대 최악의 공연이고, 리사 심슨역대 최악의 캐릭터다.

그러나 두 번째 줄은 변함이 없다. 변전소의 힘을 보라!

이 기술은 종종 위키피디아 배포에 사용된다.헛간반달 경고 템플릿, 그 중에서도.

고급

여기서 두 가지 고급 기술을 더 살펴보겠다. 템플릿 코드를 사용할 수 있는 여러 가지 정교한 방법이 있다는 점에 유의하십시오. 자세한 내용은 여기에서 확인할 수 있다.

#만약

가장 기본적인 파서 함수 중 하나는 #if이다. 이것은 대부분의 컴퓨터 프로그래밍에서 사용되는 종류처럼 "만약/그때" 루틴을 허용하는 간단한 기능이다.


케이스 문

사례 진술은 이 추가 단계를 수반할 때 더 복잡한 매개변수 전달을 수반할 수 있다.

사용자가 자신의 기본 설정을 지정할 수 있는 템플릿을 만들고 다음과 같은 상자를 받고 싶다고 가정합시다.

내가 가장 좋아하는 나라는 이탈리아야. Flag of Italy.svg
내가 가장 좋아하는 도시는 베니스야. Venezia 2004.jpg

매개변수로 할 수 있지만 사용자는 이탈리아와 베니스에 링크를 추가하고 사용할 그림을 지정해야 한다. 사례 진술은 더 쉬운 방법(더 제한적이긴 하지만)을 허용한다.

샌드박스로 이동하여 다음 코드를 추가하십시오.

{{tl X9/컨트리체크}}{{tl X9/도시체크}}}}

이제 첫 번째 링크({X9/countrycheck})를 클릭하고(빨간색일 수 있음) 확인 페이지에 다음을 삽입하십시오(이미 있을 수 있음, 그렇다면 일치하는지 확인하십시오).

{{#스위치:{{lc{{{1}:{1}}}} ita=[Italy]]. [[이미지:이탈리아의 국기.svg 50px] saf=[남아프리카] [[이미지:남아프리카 공화국의 국기.svg 50px]] }}

그런 다음 두 번째 링크({X9/citycheck})를 클릭하고 citycheck 페이지에 추가(또는 확인)하십시오.

{{#스위치:{{lc{{{1}:{1}}}} ven=[베니스] [[이미지:베네치아 2004.jpg 50px] joh=[Johnesburg][Joh=[Johannesburg]. [[이미지:Joburg top.jpg 50px]]  위의 항목 중 아무 것도 아니다 }} 

이게 어디로 가는 건지 알길 바래. 이제 {{X9} 템플릿 페이지에서 페이지를 비우고 다음 코드를 삽입하십시오.

<표 너비=50% arlign=중앙 테두리=1> 내가 가장 좋아하는 나라는 {{X9/컨트리체크 {{{country}}}}</td></table>}}</table>이다.

마지막으로, 샌드박스로 돌아가서 이전 텍스트를 삭제하십시오. 다음 항목으로 대체:

{{X9 나라=ita city=ven }}}

우리가 시작한 박스를 받으십시오.

내가 가장 좋아하는 나라는 이탈리아야. Flag of Italy.svg
내가 가장 좋아하는 도시는 베니스야. Venezia 2004.jpg

이제 샌드박스로 돌아가 "ita"를 "saf"로 교체하고 "ven"을 "joh"로 전환하십시오. 다음과 같은 대안을 확인하십시오.

내가 가장 좋아하는 나라는 남아프리카야. Flag of South Africa.svg
내가 가장 좋아하는 도시는 요하네스버그야. Joburg top.jpg

기본적으로 우리가 한 것은 가능한 변수들과 그들이 표에 넣을 것들을 나열하는 페이지들을 만들었다. 그리고 나서 우리는 체크가 이루어져야 하는 지점을 표시하기 위해 세 개의 브래킷으로 테이블을 위한 코드를 템플릿에 넣는다. 마지막으로 템플릿 이름 지정 코드는 (체크 페이지에 설정한 코드에) 우리가 좋아하는 나라와 도시의 이름을 포함한다.

또한 기본값("위 중 없음")을 표시했다는 점에 유의하십시오. 사용자가 지정하지 않거나 우리가 허용한 코드 이외의 다른 코드를 사용하는 경우 기본값이 나열된다. (기본값은 사용자가 컨트리체크 또는 시티체크 페이지로 이동할 때 표시되는 항목이기도 함) 이러한 이유로, 사용 가능한 옵션과 함께 사용자의 전체 문서를 포함하는 것이 매우 중요하다. 여기 또한 예시가 편리한 곳이다.

lc:는 소문자를 의미하며, 정맥뿐만 아니라 VEN과 Ven을 사용할 수 있다.[1]

끝.

축하합니다 – 전체 튜토리얼을 통과하셨습니다! 내가 알고 있는 템플릿 제작과 사용법을 모두 가르쳐 줬어. 저보다 더 숙련된 사용자들이 많으며, 내가 가짜 정보를 제공했을 가능성이 충분히 있다는 점에 유의하십시오. (그렇다면 내가 고칠 수 있도록 알려 주시오.)

이제 이 단계를 모두 마쳤으므로 사용자 페이지에 다음 배지를 표시할 수 있는 권한이 부여됨. 다음 코드를 복사하여 붙여넣으십시오.

{{subst:TempTutorialBadge}

사용자 페이지에 이 spiffy 박스가 표시되며, 이 박스가 작동하는 이유를 알 수 있을 것이다.

Gold medal 2 green.jpg

이 사용자는 템플릿 튜토리얼을 완료했다.


위키피디아에 대한 당신의 연구에 감사한다!

이 페이지는 Scartol에 의해 만들어지고 유지된다. 그는 잘못된 정보, 잘못된 주장, 그리고/또는 불쾌한 이단에 대해 책임이 있다.

참고 항목

메모들

  1. ^ 대부분의 사용자들은 "tl"을 사용하는 대신 자신의 템플릿 코드를 태그 안에 넣지만, 이 튜토리얼 자체는 <pre>……</pre>를 사용하기 때문에 어떤 이유에서인지 나는 그것들을 중첩하여 시연할 수 없다.
  2. ^ 나는 누구의 신학적 관점을 흔드는 것에 관심이 없다. 이것은 시적 허가증이다.