문서 검토와 수정

문서 시작하기

양자정보과학기술 연구회 위키는 미디어 위키 문법에 기반해 있습니다. 상세한 문법에 관한 설명은 미디어 위키 공식 위키를 참조할 수 있습니다.

검토진들의 업무

해당 위키의 내용들은 Word로 작성된 문서를 변환 프로그램을 통해 미디어 위키 마크업 언어로 변환한 것입니다. 때문에, 의도치 못한 문법적 오류, 그림의 위치, 크기 문제, 불필요한 구조의 문법 등이 발생할 수 있습니다. 검토진들은 해당 사항들에 대해, Word 문서와 비교하여 적절한 문서가 될 수 있도록 해당 문서를 수정해야 합니다. 주로 다음과 같은 문제들이 알려져 있습니다.

• 그림의 크기 문제:
• 그림의 캡션:
• 불필요한 수식 구조

아래 문법 단원에서는 공식 미디어 위키 도움말을 링크하고, 검토진들이 사용할 일부 문법에 관한 내용에 대해 기술하고 있습니다.

문법

기초 문법

다음의 공식문서를 참조할 수 있습니다. 미디어 위키:도움말:서식 지정

링크

다음의 공식문서를 참조할 수 있습니다. [미디어 위키:도움말:링크]

그림

다음의 공식문서를 참조할 수 있습니다. 미디어 위키:도움말:그림

미디어 위키 엔진에서 그림을 불러올 때, 기본적으로 서버 내에 있는 그림만을 대상으로 합니다. 본 위키에서는 외부 이미지 호출이 가능하도록 되어있습니다.

내부 그림

그림 구문은 다음의 구조를 가집니다.

 
[[File:{image name}|{option}|{caption}]]

File은 서버 내 파일을 나타내는 접두사입니다. 이 구문은 서버내에 있는 파일만을 대상으로 합니다. 예를 들어서 양자 회로 SDK인 Qiskit의 로고가 본 서버에 Qiskit-Logo.svg란 이름으로 저장되어 있습니다. 이를 가로 크기 200px의 크기로 문서에 삽입하려면 다음과 같은 문법을 사용할 수 있습니다.

source	output
[[File:Qiskit-Logo.svg|200px|Qisikit logo]]

외부 그림

외부 서버에 있는 경우 img 파일을 나타내는 url이 필요하고, 서버 내 그림에 사용한 구문이 아닌 다른 구문을 사용해야합니다.

위에서 예시로 든, Qisikit 로고는 Wikipedia 서버에 저장되어 있습니다[1].

먼저, 외부 이미지는 해당 url 자체로 엔진에서 이미지로 처리합니다.(svg 파일 포멧은 자동으로 처리되지 않습니다. 후술할 img tag를 사용하세요)

https://upload.wikimedia.org/wikipedia/commons/thumb/5/51/Qiskit-Logo.svg/256px-Qiskit-Logo.svg.png

이 경우 caption을 넣고 싶다면 다음과 같이 표를 이용해서 작성해야 합니다.

{|
| <image url>
|-
| caption
|}

예시

{|
| https://upload.wikimedia.org/wikipedia/commons/thumb/5/51/Qiskit-Logo.svg/256px-Qiskit-Logo.svg.png
|-
| caption: Qiskit logo 
|}

caption: Qiskit logo

더 상세한 설정이 필요한 경우(예: resizing) Mozilla 재단의 html img tag 문서를 참조하세요. 단, 미디어 위키 엔진은 보안상의 이유로 html tag 사용을 기본으로 막고 있습니다. 무분별한 html tag 사용은 유지 보수를 어렵게 하고 보안 문제의 위협이 있습니다.

표

다음의 공식문서를 참조할 수 있습니다. 미디어 위키:도움말:표