서식

작성 표준에 대한 내용은 Article style criteria/Writing를 참조하세요.
알림: 이 문서에서는 RFC 2119에 따른 요구사항 수준을 설명합니다.

로케일

아래 목록은 위키에서 주로 지원하는 로케일입니다:

참고: 웹사이트는 유저가 선택한 언어의 문서를 표시합니다. 표시하지 못할 경우에는 영어 문서로 표시됩니다.

머리말

머리말은 반드시 파일의 맨 위에 위치해야 하며, YAML로 작성 된, 문서의 추가 정보를 가지고 있습니다. 이것은 반드시 3개의 하이픈(---)으로 감싸져 있어야 하며, 타이틀의 제목이 시작되기 전 한줄의 빈 공간이 있어야 합니다.

도움이 필요한 문서

참고: 이 태그가 있는 영어 문서는 번역하지 마세요. 이 외에도, 번역 자체를 정리해야 할 필요가 있다면 이 태그를 추가하세요.

need_cleanup 태그는 다시 작성해야 하거나 문서 서식에 도움이 필요할 경우 추가할 수 있습니다. 이를 위해 GitHub에서 이슈를 여는 것도 허용됩니다. 태그를 사용할 때는 아래와 같이 작성해야 합니다:

needs_cleanup: true

문서에 이 태그를 추가하는 경우, 태그를 제거하기 위해 해야하는 작업들을 설명하는 주석을 추가해야 합니다.

오래된 문서

참고: 이 태그가 있는 영어 문서는 번역하지 마세요. 만약 영어 문서가 이 태그를 가지고 있다면, 번역된 문서에도 반드시 이 태그를 추가해야 합니다.

영어 문서에 포함된 내용이 오해의 소지가 있거나, 더 이상 관련이 없는 내용을 포함하는 경우에는 오래된 문서로 처리할 수 있습니다. 이 경우 outdated 태그를 추가해야 하며, 다음과 같이 작성을 해야 합니다:

outdated: true

이 태그를 문서에 추가하는 경우, 태그를 제거하기 위해 업데이트되어야 할 내용을 설명하는 주석을 추가해야 합니다.

오래된 번역

영어 문서에 변경점이 있을 경우 번역된 문서들에는 outdated_translation 태그를 사용해야 합니다. 문서에 사소한 단어 변경이나 문법 조정과 같이 문서에 영향을 주지 않는 경우에는 제외합니다.

outdated_translation: true

번역이 오래되었을 경우, 영어 버전이 업데이트된 첫번째 커밋을 표시하는 outdated_since 태그를 반드시 추가해야 합니다.

outdated_since: 29eac89cd535f8b071ca000af8fe4f0be22bdc9b

문서 태그하기

태그는 웹사이트의 검색 엔진이 문서를 더 잘 가져오도록 도와줍니다. 태그는 작성된 문서와 동일한 언어로 작성되어야 하며, 원본 문서의 태그 목록을 포함해야 합니다. 태그는 해당되는 경우에 소문자를 사용하세요.

예로, "Beatmap discussion"이라는 문서에서는 다음과 같은 태그를 가지고 있습니다:

tags:
  - beatmap discussions
  - modding V2
  - MV2

검토가 없는 번역

참고: 위키 관리자가 병합하기 전 이 마크를 추가할지 결정합니다.

다른 원어민의 검토 없이 번역이 위키에 추가될 때가 있습니다. 이 경우, 다음에 번역을 할 번역가들이 다시 한번 체크할 필요가 있다는 것을 알리기 위해 no_native_review 태그가 추가됩니다. 태그는 다음과 같이 작성해야 합니다:

no_native_review: true

문서 명명 규칙

또한 폴더 이름와 제목도 참조하세요.

문서의 제목은 단수여야 하며, 문장의 첫 글자를 대문자로 작성해야 합니다. 자세한 내용은 위키백과 명명 규칙 문서를 확인하세요.

문서의 제목은 폴더의 이름과 동일해야 합니다 (적절한 경우에 공백은 밑줄(_)로 대체할 수 있습니다). 폴더 이름을 변경했다면 문서 제목을 그에 맞게 변경해야 하며, 그 반대의 경우도 마찬가지입니다.

콘테스트 및 토너먼트 문서의 경우는 예외입니다. 폴더 이름은 축약형이나 두문자어, 혹은 이니셜을 사용해야 하며, 문서의 제목은 콘테스트 혹은 토너먼트의 전체 이름이어야 합니다.

폴더 및 파일 구조

폴더 이름

또한 문서 명명 규칙도 참조하세요.

폴더 이름은 반드시 영어로 작성되어야 하며, 첫 글자를 대문자로 작성해야 합니다.

폴더 이름에 사용할 수 있는 문자는 다음과 같습니다:

• 대문자 혹은 소문자
• 숫자
• 밑줄(_)
• 하이픈(-)
• 느낌표(!)

문서 파일 이름

문서 파일의 이름은 로케일 섹션의 파일명 열에서 찾을 수 있습니다. 번역된 문서의 위치는 영어 문서와 같은 폴더에 있어야 합니다.

색인 문서

다른 문서들을 보관하기 위한 폴더에서는 색인 문서를 작성해야 합니다. 색인 문서에는 폴더 안에 있는 문서의 목록이 포함되어야 하며, 링크된 문서의 주요 문단 혹은 설명과 같은 기타 정보를 포함할 수 있습니다.

동음이의어 문서

동음이의어 문서는 반드시 /wiki/Disambiguation 폴더에 넣어야 합니다. 메인 페이지는 동음이의어 문서를 포함하도록 업데이트해야 합니다. 예로 동음이의어/모드를 참조하세요.

헷갈릴 수 있는 키워드는 동음이의어 문서로 이동되도록 리디렉션 해야 합니다.

동음이의어 문서에 링크된 문서에는 다른 의미를 찾으려면 햇노트가 있어야 합니다.

HTML

HTML은 주석 외에는 사용하면 안 됩니다. HTML을 사용하는 경우 문서의 구조를 다시 작성해야 합니다.

주석

HTML 주석은 해야 할 작업을 표시하는 데 사용되지만, 텍스트에 설명글을 다는데도 사용할 수 있습니다. 주석은 각 줄에 있어야 하지만, 문단의 줄 내부에도 배치할 수도 있습니다. 줄 내부에 배치를 할 경우, 주석의 앞부분에는 공백을 두어선 안됩니다.

안 좋은 예:

HTML 주석은 <!-- TODO explain HTML comments --> 할 일을 표시하거나 텍스트에 주석을 달기 위해 사용해야 합니다.

좋은 예:

HTML 주석은<!-- TODO explain HTML comments --> 할 일을 표시하거나 텍스트에 주석을 달기 위해 사용해야 합니다.

수정

라인 종단 부호

주의: GitHub을 이용해 CRLF(캐리지 리턴 및 라인 피드)를 사용한 Markdown 파일을 업로드하는 경우 해당 파일이 CRLF를 사용하게 됩니다. 이를 막기 위해, 업로드하기 전 라인의 끝을 LF(라인 피드)로 설정해 주세요.

Markdown 파일의 라인 종단 부호가 LF인지 확인하세요.

이스케이프

Markdown 문법은 필요에 따라 이스케이프 해야 하지만, 문서의 제목은 일반 텍스트로 처리되므로 이스케이프를 하면 안 됩니다.

문단

각 문단 다음에는 반드시 빈 줄 하나가 따라와야 합니다.

줄 바꿈

줄 바꿈은 백슬래시(\)를 사용해야 합니다.

줄 바꿈은 드물게 사용해야 합니다.

햇노트

공지와 헷갈리지 마세요.

햇노트는 관련 문서로 유도하거나 관련 주제에 대해 알리는 데 도움을 주기 위해 문서 혹은 섹션의 맨 위에 배치되는 짧은 노트입니다.

햇노트는 기울임체로 표시해야 하며 제목 바로 다음에 배치해야 합니다. 여러개의 햇노트를 사용하는 경우, 같은 단락에 줄 바꿈으로 구분하여 입력해야 합니다.

메인 페이지

메인 페이지 햇노트는 주제의 메인 문서를 나타냅니다. 이 햇노트를 사용한다는 것은 해당 섹션이 링크된 페이지에 대한 요약 정보임을 의미합니다. 이 햇노트는 반드시 하나의 링크만을 가지고 있어야 합니다. 다음과 같은 형식으로 사용하세요:

*메인 페이지: {문서}*

*메인 페이지: {문서} 및 {문서}*

또한 참조하세요

또한 참조하세요 햇노트는 주어진 문서 혹은 섹션에서 관심을 가져볼 만한 다른 포인트를 제시합니다. 다음과 같은 형식으로 사용하세요:

*또한 {문서}도 참조하세요.*

*또한 {문서}와 {문서}도 참조하세요.*

해당된다면 참조하세요

해당된다면 참조하세요 햇노트는 또한 참조하세요 햇노트와 비슷하지만, 일반적으로 더 직접적으로 설명합니다. 이 햇노트는 필요에 따라 2개 이상의 링크를 사용할 수 있습니다. 다음과 같은 형식으로 사용하세요:

*{내용}이라면 {문서}를 참조하세요.*

*{내용}이라면 {문서} 및 {문서}를 참조하세요.*

헷갈리지 마세요

헷갈리지 마세요 햇노트는 헷갈릴 수 있거나 잘못 이해할 수 있는 문서 제목 혹은 섹션을 구별하는 데 도움을 줍니다. 이 햇노트는 필요에 따라 2개 이상의 링크를 사용할 수 있습니다. 다음과 같은 사용하세요:

*{문서}와 헷갈리지 마세요.*

*{문서} 혹은 {문서}와 헷갈리지 마세요.*

다른 의미를 찾으려면

다른 의미를 찾으려면 햇노트는 헷갈리지 마세요 햇노트와 비슷하지만, 동음이의어 문서에 직접 연결됩니다. 이 햇노트의 링크는 동음이의어 문서에만 연결되어야 합니다. 다음과 같은 형식으로 사용하세요:

*다른 의미를 찾으려면 {동음이의어 문서}를 참조하세요.*

공지

햇노트와 헷갈리지 마세요.

공지는 해당되는 섹션에 배치되지만, 단락의 시작에 사용되어야 하며 기울임체를 사용해야 합니다. 적절한 경우에는 굵게 표시할 수 있지만 최소한으로 적용해야 하며, 완전한 문장으로 작성되어야 합니다. 따라서, 대부분의 햇노트와는 달리 마침표(.) 또는 느낌표(!)를 적절하게 사용해야 합니다. 공지와 같은 단락에 있는 모든 것들은 기울임체로 작성되어야 합니다. 다음과 같은 형식으로 사용하세요:

*참고: {참고}.*

*알림: {알림}.*

*주의: {주의}.*

*경고: {경고}.*

• 참고은 사실이나 사소한 내용에 사용합니다.
• 알림는 알아야 할 내용을 상기시거나 관심을 가지게 할 때 사용합니다.
• 주의는 의도하지 않은 결과가 발생하지 않도록 경고하는 데 사용합니다.
• 경고는 변경이 될 수 있음을 경고하는 데 사용해야 합니다.

햇노트 및 공지 스택

필요한 경우 여러개의 햇노트 혹은 공지를 스택 할 수 있습니다. 이 경우 공백 라인이 없도록 스택하고 백슬래시가 뒤에 따라와야 합니다:

*경고: {경고}.*\
*또한 {문서}도 참조하세요.*

대부분의 경우에는 문단에 관련 없는 햇노트나 공지를 여러개 스택하는 것보다 문단 텍스트에 포함시키는 것이 더 적합할 수 있습니다.

강조

굵게

굵은 텍스트는 이중 별표(**)를 사용해야 합니다.

단락의 첫 부분은 문서 제목의 첫번째 항목을 굵게 표시할 수 있습니다.

기울임체

기울임체은 단일 별표(*)를 사용해야 합니다.

축약형이나 두문자어, 혹은 이니셜이 처음 나오는 경우 기울임체로 표시할 수 있습니다.

기울임체는 강조하거나 가독성의 개선을 위해 사용될 수도 있습니다.

작품이나 비디오 게임의 이름은 기울임체로 표기해야 합니다. osu! — 게임 — 은 예외입니다.

예로 {아티스트} - {제목} 형식의 노래를 언급할 때에는 전 부분이 작품에 대한 참조이므로 기울임체로 표기해야 합니다.

*cYsmix - triangles*는 게임 클라이언트가 시작되었을 때 들을 수 있는 3개의 인트로 곡 중 하나입니다.

아티스트 이름은 일반적으로 기울임체로 표시하지 않습니다. 이는 자유로운 형식의 참조에서 아티스트 이름은 작품 이름의 일부가 아니기 때문에 제목만 기울임체로 표시해야 한다는 것을 의미합니다.

xi의 *Blue Zenith*는 특정 난이도에서 탑 플레이어가 받은 유명한 점수로 인해 커뮤니티에서 악명 높은 곡입니다.

강조 및 링크

링크 텍스트는 다른 색으로 이미 강조가 되어있으므로, 더 강조할 필요가 없습니다:

[Camellia - OOPARTS](https://cametek.bandcamp.com/track/parts)는 osu!를 위해 특별하게 공식적으로 제작된 곡의 예입니다. osu! World Cup 2020 타이브레이크를 위해 특별히 의뢰되어 제작되었기 때문에 *osu! original*이라고도 합니다.

그러나 링크에 참조된 저작물만이 있는 것이 아니라면 이를 적용하지 않습니다.

[Voltaeyx의 비트맵 *TheFatRat - Mayday (feat. Laura Brehm)*](https://osu.ppy.sh/beatmapsets/756794)은 독특한 오버랩 슬라이더 패턴으로 2018년에 상당한 인기를 끌었던 곡입니다.

위와 같은 형태의 구성은 적당히 사용해야 하며, 표나 목록과 같이 링크가 많은 곳에서는 사용하지 않아야 합니다.

헤더 작성

모든 헤더의 첫 글자는 대문자여야 합니다.

헤더는 ATX(해시) 스타일을 사용해야 하며, 앞과 뒤쪽에 빈 줄이 있어야 합니다. 제목 헤더의 경우 첫 줄에 있다면 예외로 둘 수 있습니다. 이 경우에는 제목 헤더의 뒤에만 빈 줄이 있으면 됩니다.

5단계 이상의 헤더를 사용하면 안 되며, 텍스트의 스타일이나 서식을 지정하는 데 사용해서는 안 됩니다.

제목

또한 문서 명명 규칙도 참조하세요.
주의: 제목은 일반 텍스트로 분석되므로, 이스케이프 처리를 해서는 안 됩니다.

모든 문서의 첫 줄은 반드시 문서의 제목인 1단계 헤더여야 하며, 이후의 모든 헤더는 섹션 헤더여야 합니다. 제목은 반드시 서식, 링크, 이미지를 포함해서는 안 됩니다.

머리말이 사용되지 않는 한 제목 헤더는 첫번째 줄에 있어야 합니다. 머리말이 있는 경우 제목 헤더는 그 뒤에 있어야 하며, 앞과 뒤쪽에 빈 줄이 있어야 합니다.

섹션

섹션 헤더는 2단계에서 5단계 사이로만 작성되어야 합니다. 제목 헤더 다음에 나오는 섹션 헤더는 2단계로 작성되어야 하며, 제목과는 다르게 섹션 헤더는 작은 아이콘을 포함할 수 있습니다.

섹션 헤더의 단계는 건너뛸 수 없으며(다시 말해, 2레벨 헤더에서 4레벨 헤더로 넘어가는 것은 할 수 없다는 의미입니다), 서식이나 링크를 포함할 수 없습니다.

알림: 웹사이트에서는 4, 5단계 헤더는 목차에 표시되지 않습니다.

커스텀 식별자

직접 링크하는 데 사용하는 섹션의 식별자를 재정의 할 수 있습니다. 자동으로 생성된 식별자가 너무 길거나 까다로운 구두점이나 이미지를 포함하는 경우 커스텀 식별자를 사용해야 합니다.

## My cooldown has passed. How do I appeal? {id=appeal}

## Various examples of osu! gameplay {id=osu!-gameplay}

이 기능은 제목이 없는 문서의 특정 부분을 태그하는 데에도 사용할 수 있습니다. 드물게 사용해 주세요:

> That's it! You're well on your way to becoming an osu! rhythm champion!
{id=tutorial-quote}

목록

목록은 들여쓰기를 4번 이상 하지 않도록 해야하며, 각 아이템 사이에에 빈 줄이 있어서는 안됩니다.

중첩 목록의 경우, 점과 숫자는 상위 목록의 콘텐츠와 같은 위치에 정렬해야 합니다.

다음 예는 정상적으로 동작하지 않습니다 (점 기호 앞 간격을 확인하세요):

1. 연날리기
  - 비가 내린다면 연을 날리지 마세요

다음 예는 정상적으로 동작합니다:

1. 연날리기
   - 비가 내린다면 연을 날리지 마세요

점

점 목록은 하이픈(-)을 사용해야 하며, 하나의 공백이 따라와야 합니다. (아래 예를 참고하세요.)

- osu!
  - Hit circle
    - Combo number
    - Approach circle
  - Slider
    - Hit circles
    - Slider body
    - Slider ticks
  - Spinner
- osu!taiko

숫자

숫자 목록의 숫자는 해당되는 단계를 나타내기 위해 증가해야 합니다.

1. osu! 인스톨러를 다운로드하세요.
2. 인스톨러를 실행하세요.
   1. 설치 위치를 변경하려면 프로그래스바 아래의 텍스트를 클릭하세요.
   2. 새 위치를 물어보는 메시지가 표시되면 설치할 폴더를 선택하세요
3. 설치가 완료되면 osu!가 실행됩니다.
4. 로그인하세요.

혼합

점 목록과 숫자 목록을 합치는 것은 드물게 사용해야 합니다.

1. 포럼에서 스킨을 다운로드하세요.
2. 스킨 파일을 osu!에서 불러오세요.
   - 스킨 파일이 `.zip` 형태라면, 압축을 풀어 그 안에 있는 내용물을 `Skins/` 폴더에 넣어주세요 (osu! 설치 폴더에서 찾을 수 있습니다).
   - 스킨 파일이 `.osk` 형태라면, 실행해서 열거나 게임 클라이언트로 끌어다 놓으세요.
3. osu!가 열려있지 않다면 열어주시고, 옵션에서 스킨을 선택하세요.
   - `.osk` 파일을 열었거나, 게임 클라이언트로 끌어다 놓았을 경우 자동으로 선택되어 있을 겁니다.

코드

코드 표현을 위한 마크업 문자는 억음 부호(`)입니다. 억음 부호를 코드에 넣고 싶다면, 억음 부호를 2번 넣어서 사용하세요. 만약 억음 부호가 시작과 끝부분에 있다면, 한 칸 떨어뜨려서 사용하세요. (아래 예를 참고하세요.)

`` ` ``
`` `Space` ``

키보드 단축키

알림: 키보드 키가 아닌 문자 자체를 나타낼 때에는 따옴표를 대신 사용하세요.

키보드 단축키를 표현하려면 하나의 문자는 대문자로, 특수키는 제목과 같은 방식으로 작성합니다. 더하기 기호(+)(코드 문자 제외)를 이용해서 키 조합을 표현할 수 있습니다. (아래 예를 참고하세요.)

pippi는 peppy처럼 소문자 "p"로 표기됩니다.

`Ctrl` + `O`를 눌러 대화상자를 여세요.

공백이나 스페이스바를 나타낼 때에는, `Space`를 사용해 주세요.

버튼 및 메뉴 텍스트

메뉴나 버튼에서 텍스트를 가져오려면 대소문자를 그대로 복사해야 합니다. (아래 예를 참고하세요.)

osu!supporter가 활성화되어 있다면, 메인 메뉴의 오른쪽에 `osu!direct` 버튼이 보일 것입니다.

폴더 및 디렉터리 이름

폴더나 디렉터리 이름을 가져오려면 대소문자를 그대로 복사하되, 가능한 경우 소문자로 된 디렉터리로 작성합니다. 디렉터리는 절대 경로로 작성해서는 안 됩니다(다시 말해, 드라이브 문자나 루트 폴더로 디렉터리 이름을 시작하지 말라는 의미입니다). (아래 예를 참고하세요.)

osu!는 설치 중 경로를 따로 지정하는 것이 아니라면 기본적으로 `AppData/Local` 폴더에 설치됩니다.

키워드 및 커맨드

키워드나 커맨드를 가져오려면 대소문자를 그대로 복사하거나, 사람들이 일반적으로 입력하는 방식으로 복사합니다. 해당되는 경우 소문자가 선호됩니다. (아래 예를 참고하세요.)

현재 스킨 설정 파일(`skin.ini`)의 `Name` 및 `Author` 항목은 아무런 동작도 하지 않습니다.

파일 이름

파일 이름을 가져오려면 대소문자를 그대로 복사해야 합니다. 해당되는 경우 소문자가 선호됩니다. (아래 예를 참고하세요.)

osu!를 플레이하려면 `osu!.exe` 아이콘을 더블클릭하세요.

파일 확장자

알림: 파일 형식(파일 확장자랑 헷갈리지 마세요)은 반드시 마침표(.)를 제외한 대문자로 표기되어야 합니다.

파일 확장자는 마침표(.)가 앞에 붙어야 하며, 이어서 오는 확장자는 소문자여야 합니다. (아래 예를 참고하세요.)

JPG(혹은 JPEG) 파일 형식은 `.jpg`(혹은 `.jpeg`) 확장자를 가집니다.

채팅 채널

채팅 채널을 가져오려면 우물 정자(#)로 시작하고, 그 뒤로 소문자의 채널 이름이 오도록 복사해야 합니다. (아래 예를 참고하세요.)

`#lobby`는 멀티플레이 방을 홍보하기 위한 채널입니다.

서식이 지정된 텍스트(코드 블록)

알림: 서식이 지정된 텍스트의 구문 강조는 웹사이트에서는 아직 구현되지 않았습니다.

서식이 지정된 텍스트(코드 블록으로도 알려져 있음)는 3개의 억음 부호로 감싸져 있어야 하며, 구문 강조 표시하기 위한 언어 식별자를 설정해야 합니다.

링크

또한 각주도 참조하세요.

2가지 타입의 링크가 존재합니다: 인라인 및 참조. 인라인 링크는 두가지의 스타일이 존재합니다.

다음은 2가지 인라인 스타일의 링크 예제입니다:

[Game modifier](/wiki/Gameplay/Game_modifier)

<https://osu.ppy.sh/home>

다음은 참조 스타일의 링크 예제입니다:

[Game modifier][game mods link]

[game mods link]: /wiki/Game_modifier

링크가 한번만 참조되는 경우 인라인 스타일의 링크를 사용해야 합니다. 꺾쇠괄호 스타일의 인라인 링크의 사용은 피해 주세요. 참조 링크에 대한 참조는 문서 하단에 배치해야 합니다.

내부 링크

알림: 내부 링크는 https://osu.ppy.sh/ 도메인 내부에 있는 링크를 나타냅니다.

위키 링크

위키 문서를 가리키는 모든 링크는 /wiki/로 시작해야 하며, 그 뒤로 대상 문서로 연결되는 경로가 이어져야 합니다. 상대 링크로도 사용할 수 있습니다. 몇 가지 예로는 다음과 같은 항목이 있습니다:

[FAQ](/wiki/FAQ)
[pippi](/wiki/Mascots#pippi)
[Beatmaps](../)
[Pattern](./Pattern)

위키 링크는 리디렉션 되어서는 안되며, 뒤쪽에 슬래시(/)를 가져서도 안됩니다.

안 좋은 예로는 다음과 같은 항목이 있습니다:

[Article styling criteria](/wiki/ASC)
[Developers](/wiki/Developers/)
[Developers](/wiki/Developers/#game-client-developers)

좋은 예로는 다음과 같은 항목이 있습니다:

[Article styling criteria](/wiki/Article_styling_criteria)
[Developers](/wiki/People/Developers)
[Developers](/wiki/People/Developers#game-client-developers)

하위 문서 링크

하위 문서를 가리키는 위키 링크는 링크 문서의 폴더 이름을 포함해야 합니다. 다음 예를 참고하세요:

*또한 [Beatmap Editor/Design](/wiki/Client/Beatmap_editor/Design)도 참조하세요.*

섹션 링크

알림: 웹사이트에서는 4, 5단계 헤더에는 id 속성을 주지 않습니다. 즉, 이들은 직접적으로 링크할 수 없다는 것을 의미합니다.

문서의 섹션을 가리키는 위키 링크에는 섹션 기호(§)를 사용할 수 있습니다. 다음 예를 참고하세요:

*타이밍 룰에 대한 정보는 [Ranking Criteria § Timing](/wiki/Ranking_criteria#timing)을 참조하세요.*

다른 osu! 링크

웹브라우저의 주소 표시줄에 있는 URL은 다른 osu! 웹 페이지로 링크할 때 그대로 복사해야 합니다. URL의 https://osu.ppy.sh 부분은 그대로 유지하세요.

유저 프로필

처음에 나오는 모든 사용자 이름은 반드시 링크되어야 합니다. 그다음에 나오는 유저 이름은 선택사항이지만, 문서 전반적으로 나오는 모든 유저 이름은 일관적으로 작성되어야 합니다. 유저의 아이디를 확인하기 어려운 경우에는 생략될 수 있습니다.

유저 프로필을 링크할 때에는 유저의 id가 이용되어야 합니다. id를 얻으려면 새로운 사이트(https://osu.ppy.sh/users/{유저명})를 이용하세요.

유저 링크의 텍스트는 유저의 현재 이름으로 작성되어야 합니다.

난이도

하나의 난이도를 링크할 때에는 텍스트로 다음 형식을 사용하세요:

{아티스트} - {타이틀} ({제작자}) [{난이도_이름}]

링크는 실질적으로 그 난이도에 링크되어야 합니다. 비트맵 난이도 URL은 반드시 다음과 같은 형식으로 작성해야 합니다:

https://osu.ppy.sh/beatmapsets/{비트맵셋ID}#{모드}/{비트맵ID}

난이도 이름은 링크 텍스트 외부에 적을 수도 있지만, 그렇게 할 경우 문서 전반적으로 일관적으로 작성되어야 합니다.

비트맵

비트맵을 링크할 때에는 텍스트로 다음 형식을 사용하세요:

{아티스트} - {타이틀} ({제작자})

모든 비트맵 URL은 반드시 다음과 같은 형식으로 작성해야 합니다:

https://osu.ppy.sh/beatmapsets/{비트맵셋ID}

외부 링크

알림: 외부 링크는 https://osu.ppy.sh 도메인 외부로 나가는 링크를 나타냅니다.

반드시 https 프로토콜이 사용되어야 하며, 사용하지 않는 사이트는 지원하지 않습니다. 외부 링크는 평판이 좋은 출처에 대한 확실하고 직접적인 링크여야 합니다. 웹브라우저의 주소 표시줄에 있는 URL은 다른 외부 페이지로 링크할 때 그대로 복사해야 합니다.

외부 링크와 osu! 웹 링크 사이에는 시각적인 차이가 없기 때문에, 웹사이트의 이름은 제목 테스트에 포함되어야 합니다. 다음 예를 참고하세요:

*음악 이론에 대한 자세한 정보는 [Music theory](https://en.wikipedia.org/wiki/Music_theory)를 참조하세요.*

이미지

2가지 타입의 이미지 링크가 존재합니다: 인라인 및 참조. 예제:

인라인 스타일:

![Gold crown](/wiki/shared/crown-gold.png "1st place")

참조 스타일:

![Gold crown][GCrown]

[GCrown]: /wiki/shared/crown-gold.png "1st place"

이미지는 인라인 스타일의 링크로 사용해야 합니다. 참조 링크에 대한 정의는 문서 하단에 배치해야 합니다.

페이지의 모든 블록 이미지(같은 줄에 다른 것이 없는 이미지)는 화면 양쪽에 화살표 아이콘이나 키보드 단축키 또는 화면 스와이프를 사용하여 탐색할 수 있는 단일 갤러리로 통합됩니다.

대체 및 제목 텍스트

첫번째 대괄호 쌍(대체 텍스트)의 텍스트는 이미지를 있는 그대로 설명해야 합니다. 스크린 리더에서 사용하거나 이미지를 불러오는데 실패했을 경우에 사용됩니다. 대체 텍스트가 제목 텍스트와 동일하거나 이미지가 장식용으로만 사용되는 경우 생략할 수 있습니다.

따옴표 안의 텍스트(제목 텍스트)는 이미지에 추가 컨텍스트를 제공하거나 그 의미를 나타내야 합니다. 이는 이미지 위에 마우스를 올렸을 경우 툴팁으로 표시되며, 해당되는 경우에는 이미지의 설명으로 사용됩니다. 마크다운 형식을 지원하지 않습니다.

출력

이미지가 단락의 유일할 내용일 경우, 중앙 블록으로 출력이 됩니다. 그렇지 않을 경우에는 라인에 있는 텍스트와 같이 출력됩니다.

제목 텍스트가 있는 블록 이미지에는 제목 텍스트가 이미지 아래에 설명으로 출력됩니다. 이미지와 같은 줄에 HTML 주석이나 다른 텍스트를 추가하지 마세요. 그러면 설명이 렌더링되지 않습니다.

블록 이미지는 기본 크기를 줄이고 다른 콘텐츠 옆에 같이 출력하기 위해 일반적으로 Infobox와 같이 사용됩니다.

::: Infobox
![](img/mod-response.png "모드에 대한 응답 예")
:::

이미지 캐싱

웹사이트의 이미지는 최대 60일까지 캐시됩니다. 캐시 된 이미지는 이미지 링크의 URL과 일치합니다.

이미지를 업데이트할 때는 이미지의 이름을 변경하거나 URL에 쿼리 문자열을 추가하세요. 이 경우, 이미지를 링크한 모든 번역 문서도 업데이트를 해야 합니다.

형식 및 화질

이미지는 퀄리티를 8(80 혹은 80%, 프로그램에 따라 다를 수 있음)로 설정한 JPG 형식을 사용해 주세요. 이미지가 투명한 부분이 포함되어 있거나 읽어야 하는 텍스트가 포함되어 있으면 대신 PNG 형식을 사용하세요. 이미지가 애니메이션이 포함되어 있다면 GIF 형식을 사용할 수 있습니다만, 로드하는데 시간이 더 오래 걸리거나 최대로 적용할 수 있는 파일 크기보다 클 수 있으므로 드물게 사용해야 합니다.

파일 크기

이미지는 반드시 1MB보다 작아야 합니다. 이보다 크다면 이미지를 불러올 수 없습니다. 이미지 크기를 줄이고 퀄리티 80%의 JPG를 사용하면 거의 대부분 크기 제한보다 작게 만들 수 있습니다.

모든 이미지는 가능한 한 최적화해야 합니다. JPEG 이미지를 압축하려면 jpeg-archive를 사용하세요. 일관적으로 jpeg-archive에는 다음과 같은 명령어를 사용하세요:

jpeg-recompress -am smallfry <input> <output>

혹은 ezgif.com에서 이미지 변환 및 최적화가 가능합니다.

파일 이름

알림: 파일 확장자는 반드시 소문자로 적어야 합니다. 그 외의 경우 이미지를 불러올 수 없습니다!

공백 문자에는 하이픈(-)을 사용하세요. 이미지 이름은 의미가 있거나 설명적이어야 하며 짧은 이름이어야 합니다.

이미지는 반드시 문서 폴더 내의 img 폴더에 위치해있어야 합니다. 여러 문서에 사용되는 이미지는 /wiki/shared 폴더에 저장해야 합니다.

최대 이미지 너비

웹사이트의 최대 이미지 너비는 문서 내용의 최대 넓이이므로 800픽셀을 넘어서는 안됩니다.

설명이 달린 이미지

이미지에 설명을 달 때는 Torus Regular 폰트를 사용하세요. 중국어, 한국어, 일본어 문자의 경우에는 Microsoft YaHei를 사용하세요.

이미지의 주석을 다는 것은 다른 번역가(혹은 다른 에디터)가 수정하기 힘들어지므로 피해 주세요.

설명이 달린 이미지 번역

설명이 달린 이미지를 번역할 때 번역된 이미지는 원본 이미지(요컨대, 영어 버전)와 같은 디렉터리에 있어야 합니다. 번역된 이미지의 파일 이름은 원래 이미지의 파일 이름으로 시작해야 하고, 그 뒤에 하이픈, 이어서 로케일 이름(대문자)가 따라와야 합니다. 다음 예를 참고하세요:

• 영어: hardrock-mod-vs-easy-mod.jpg
• 독일어: hardrock-mod-vs-easy-mod-DE.jpg
• 중국어 번체: hardrock-mod-vs-easy-mod-ZH-TW.jpg

게임 스크린샷

모든 게임 스크린샷은 Stable 빌드에 없는 기능이 아닌 이상 Stable 빌드에서 찍어야 합니다. 게임 내 스크린샷 기능(F12)를 사용하세요.

게임 클라이언트 설정

알림: 위키 작성을 위해 현재 설정을 바꾸고 싶지 않다면 osu!.<컴퓨터유저명>.cfg 파일을 osu! 폴더 바깥으로 빼두었다가 다시 돌려놓으세요.

게임 스크린샷을 찍기 전 반드시 다음과 같이 설정하세요(아래에 명시되지 않은 설정은 기본값으로 간주합니다):

• 언어 선택: English
• 비트맵 정보 원어로 보기: 활성화
• 해상도 선택: 1280x720
• 전체화면 모드: 비활성화
• 시차 효과: 비활성화
• 메인 메뉴 팁 보기: 비활성화
• Seasonal backgrounds: Never
• 키 오버레이 항상 보기: 활성화
• 스킨 선택: Default(첫번째 옵션)

번역가에게 알림: 게임 스크린샷이 포함된 문서를 번역하는 경우, 게임 클라이언트의 언어를 번역하는 언어로 설정할 수 있습니다

이미지 링크

이미지는 링크 텍스트의 일부분이 되어서는 안됩니다.

국기 아이콘

국기 아이콘은 2글자 코드(대문자)를 사용하여 특정 지역을 나타낼 수 있습니다. 국기 아이콘을 추가할 때는 다음과 같은 형식을 사용하세요:

::{ flag=XX }::

XX에는 국기에 대한 ISO 3166-1 alpha-2 2글자 국가 코드를 입력해 주세요.

표

웹 사이트의 표는 첫번째 줄이 헤더인 표만 지원합니다.

표를 꾸며서는 안됩니다(너비를 균일하게 만들기 위해 공백 문자로 셀을 채우지 마세요). 왼쪽과 오른쪽에는 수직선(|)이 있어야 하며, 각 셀의 텍스트는 양쪽에 하나의 공백 문자가 있어야 합니다. 빈 셀은 수직선(|), 그 뒤로 따라오는 2개의 공백 문자와 또 다른 수직선(|)을 사용해야 합니다.

구분 기호가 있는 행(표 헤더에 이어지는 줄)은 열 당 3글자만 사용해야 하며(양쪽에 공백 문자가 있어야 함), 다음 중 하나와 같아야 합니다:

• :--(왼쪽 정렬)
• :-:(가운데 정렬)
• --:(오른쪽 정렬)

다음은 테이블의 모양에 대한 예제입니다:

| Team "Picturesque" Red | Score | Team "Statuesque" Blue | Average Beatmap Stars |
| :-- | :-: | --: | :-- |
| **peppy** | 5 - 2 | pippi | 9.3 stars |
| Aiko | 1 - 6 | **Alisa** | 4.2 stars |
| Ryūta | 3 - 4 | **Yuzu** | 5.1 stars |
| **Taikonator** | 7 - 0 | Tama | 13.37 stars |
| Maria | No Contest | Mocha |  |

Infobox

Infobox는 문서의 오른쪽에 정렬되는 고정폭 블록입니다. 주변 텍스트와 관련된 이미지, 혹은 동일한 카테고리의 다른 문서로 연결되는 탐색 블록을 포함할 수 있습니다.

사용 예, 오른쪽에 렌더링 됨 (좁은 디스플레이에서는 위쪽):

::: Infobox
![](/wiki/shared/mods/SD.png "Sudden Death 모드 아이콘")
:::

다음과 같은 상황에서는 Infobox를 주의해서 사용해야 합니다:

• 짧은 섹션의 경우: 다음 섹션의 헤더가 Infobox 아래에 표시되며, 텍스트 뒤쪽으로 큰 간격이 남게 됩니다.
• 한번에 여러 이미지가 있는 경우: 더 나은 디자인을 위해 각각의 이미지에 Infobox를 사용하세요.

Infobox 안에서는 4, 5단계의 헤더만 허용됩니다. 이 항목은 목차에는 나타나지 않으며, 이보다 낮은 단계의 헤더는 너무 큽니다. 이로 인해 모든 CI 검사 에러를 무시해야 할 수 있습니다.

각주

각주는 페이지 끝에 있는 짧은 메모입니다. 출처를 인용하거나, 문서의 흐름을 방해할 배경지식을 제공하는 데 사용합니다. 각주에는 텍스트 서식이나 링크를 포함시킬 수 있습니다.

osu! Wiki에서의 각주는 특수한 문법([^식별자])를 사용하여 구현합니다. 각주에는 어떠한 식별자를 사용해도 되지만, 나오는 순서대로 증가하는 숫자 첨자로 자동 렌더링됩니다. 번역 문서에서는 각주의 식별자를 수정하지 마세요.

각주의 참조는 설명하는 단어나 구, 혹은 문장 바로 뒤에 공백이 없게 위치합니다. 이러한 참조는 내부 콘텐츠와 관련된 괄호나 가로줄을 제외하고 구두점 뒤에 위치해야 합니다.

각주 자체는 문서의 끝에 별도의 2단계 헤더에 배치해야 합니다. 내용에 따라 헤더는 참조, 노트 혹은 노트 및 참조가 될 수 있습니다.

올바른 사용 예:

osu! Wiki는 이전 FAQ 시스템을 대체하기 위한 프로젝트입니다. 이는 리듬 게임 osu![^osu]와 세상에서 가장 큰 온라인 백과사전인 Wikipedia의 이름을 따서 명명되었으며, 시작할 때부터 숙련된 번역가[^wiki-tl]와 편집자들이 도움을 주었습니다.

## 참조

[^wiki-faq]: https://osu.ppy.sh/community/forums/topics/68525
[^wiki-tl]: https://osu.ppy.sh/community/forums/posts/1177500
[^osu]: https://osu.ppy.sh/community/forums/posts/1178153

인용

인용 및 참조는 정보의 출처를 식별하는 데 사용합니다. 각주를 통한 인용이 인라인 링크보다 우선적으로 사용되어야 합니다.

참조는 해당되는 경우에 저자, 날짜, 서비스/플랫폼 및 제목을 지정해야 합니다. 정확한 서식은 간결성을 선호하는 참조 자료에 따라 달라질 수 있습니다.

예:

osu!api의 첫번째 버전은 2013년 7월 2일에 제공되었으며,[^api-first-usage] 여러 사용자들에게 호평을 받았습니다.[^api-praise] 그로부터 몇 년 후에 출시된 새 버전의 API는 더 많은 기능이 포함되어 있습니다.[^api-v2-2020] 엔드포인트 버전 관리는 웹 API에서는 일반적인 기능입니다.[^web-api]

## 참조

[^api-first-usage]: [peppy의 포럼 스레드(2013-07-02) "osu!api open beta"](https://osu.ppy.sh/community/forums/posts/2403913)
[^api-praise]: ["osu!api open beta" 스레드의 Menchi가 쓴 포럼 글(2013-11-02)](https://osu.ppy.sh/community/forums/posts/2662247)
[^api-v2-2020]: [@ppy의 트윗(2020-03-20)](https://twitter.com/ppy/status/1263083636363948032)
[^web-api]: [위키피디아 "Web API"](https://en.wikipedia.org/wiki/Web_API)

노트

각주는 문서의 가독성을 떨어뜨리지 않고는 줄에 설명을 추가할 수 없거나, 문서 자체보다는 덜 중요한 설명이나 접사적 주석을 저장하는 데 사용할 수 있습니다. 이러한 각주는 자유로운 서식으로 사용할 수 있습니다.

예:

경험이 없고 평판이 좋지 않은 스태프로 구성된 팀으로 토너먼트가 조직되고 운영되어서는 안됩니다.[^staff]

## 노트

[^staff]: *경험이 없는* 스태프는 osu!를 1시간 미만으로 플레이한 사람으로 느슨하게 정의됩니다.

들여쓰기

들여쓰기는 누군가 혹은 무언가를 이용하는 용도로 제한됩니다. 그 외의, 텍스트의 서식을 지정하기 위한 용도로는 사용하지 마세요.

> plz enjoy game

—rrtyui

주제 나누기

주제 나누기(수평선이라고도 함)는 드물게 사용해야 합니다. 주제 나누기를 사용하는 경우는 다음과 같습니다 (이에 국한되지는 않음):

• 이미지와 텍스트를 나눌 때
• 서로 이어지는 여러 이미지를 분리할 때
• 섹션 내에서의 주제를 바꿀 때

마크업 전후로 빈 줄이 있어야 합니다. 주제 나누기는 아래와 같이 3개의 하이픈만 사용해야 합니다:

---