이 문서는 모듈:마작패에 대한 설명문서입니다.
이 모듈은 문서 내에 마작패 이미지를 쉽게 넣기 위해 만들어졌습니다. 마작패 이미지는 그 특성상 여러 이미지를 연달아 이어넣어야 하는데, 미디어위키의 이미지 삽입 문법을 이용해 하나하나 넣게 되면 오류가 발생하기 쉽고, 수정하기 힘들며 위키텍스트를 보았을 때 그 의미를 한 눈에 알아보기 쉽지 않습니다. 이 모듈은 이러한 문제점을 해결하기 위해, 사용자 친화적인 방식으로 마작패 이미지를 넣도록 해 줍니다.
마작패 모듈에는 크게 두 가지 메인 함수와 나머지 보조 함수가 있습니다. 메인 함수 두 가지는 '파싱' 함수와 '출력' 함수입니다.
마작 자체에 대한 자세한 설명은 마작 문서를 참고합니다.이 틀의 상세한 예는 리치마작 문서에서 확인할 수 있으며, 이 틀의 설명 문서를 수정하려면 모듈:마작패/설명문서 문서를 수정합니다.
간단한 사용법[원본 편집]
{{#invoke:마작패|파싱|123456789만}}
'파싱' 이라는 함수 이름 뒤에 구분자 기호 |
를 넣고, 그 뒤에 표기법대로 원하는 마작패를 쓰면 됩니다.
마작패 모듈의 표기법[원본 편집]
모듈:마작패 에서는 간결한 표기를 위해 각 마작패의 이름에서 한글자씩을 따와 대표어로 사용합니다. 특수한 기호를 대표어 앞에 넣어 추가적인 기능을 사용할 수도 있습니다.
- 수패
- 만수패는 '만', 통수패는 '통', 삭수패는 '삭' 이라는 대표어를 씁니다. 대표어 앞에 숫자를 1부터 9까지 쓰며, 숫자 사이에 대표어를 쓸 필요는 없습니다.
111222333444만
- 자패
- 자패는 바람패와 삼원패를 각각 '동남서북백발중' 이라는 대표어로 대신합니다.
- 적도라
- 적도라는 수패 5에만 있으며, '적5'라는 대표어를 적어 표시합니다.
1234적56789통
- 뒷면
- 깡 등으로 인해 뒷면을 표기해야 할 때는 '뒤'라는 대표어를 적어 표시합니다.
뒤22만뒤
- '치', '펑' 등으로 인해 가로로 눕힌 패의 표기
- 눕혀서 표기해야 하는 패 바로 앞에
-
기호를 적어 표기합니다.북북-북
- 소명깡(가깡)을 표기하기 위한 이중 표기
- 눕혀진 패 두 개가 겹쳐져서 표기해야 하는 패 바로 앞에
/
기호를 적어 표기합니다./222삭
파싱 함수[원본 편집]
파싱 함수는 연속된 마작패 이미지를 출력합니다. '파싱'이라는 함수명 뒤에 구분자를 적고, 표기법에 따라 마작패를 적어줍니다. 중간에 띄어쓰기가 있어도 무시하게 됩니다. 다음은 각 상황에 대한 사용법의 예시입니다.
- 수패 및 적도라
{{#invoke:마작패|파싱|234적5678삭}}
- 자패
{{#invoke:마작패|파싱|동남서북백발중}}
- 가로로 눕힌 패
입력한 값 | 실제 표시되는 모습 |
---|---|
{{#invoke:마작패|파싱|-345통}} |
|
{{#invoke:마작패|파싱|발발 -발}} |
- 가깡을 위한 이중 표기
입력한 값 | 실제 표시되는 모습 |
---|---|
{{#invoke:마작패|파싱|/345통}} |
|
{{#invoke:마작패|파싱|발발 /발}} |
- 표기법 조합
입력한 값 | 실제 표시되는 모습 |
---|---|
{{#invoke:마작패|파싱|999 123통}} |
|
{{#invoke:마작패|파싱|북 123만 중}} |
|
{{#invoke:마작패|파싱|123만적589삭2통}} |
|
{{#invoke:마작패|파싱|999 99 9만}} |
출력 함수[원본 편집]
출력 함수는 파싱 함수의 확장으로, 여러 패를 구분해서 입력해야 하는 경우에 사용합니다. 특히, 펑이나 치, 깡 등을 간단하게 입력하는 데에 최적화되어 있습니다. 파싱 함수와 동일한 요령으로 여러 표기법을 제한없이 적다가, 패의 구분이 필요할 때에 구분 기호 |
를 사용하여 입력하면 됩니다. 표기법 중간에 공백이 입력되면 단순히 무시합니다.
출력 함수에서는 #마작패 모듈의 표기법에 있는 표기법 외에도 펑이나 치, 깡을 위한 추가적인 표기법을 사용할 수 있습니다. 그러나 추가 표기법은 반드시 구분 기호로 분리하여 적어야 합니다.
- 펑 표기법
- '펑'이라는 대표어 뒤에 가져온 패를 적고, 바로 이어서 소괄호 안에 누구에게 가져왔는지(상가, 대가 또는 하가) 적습니다.
{{#invoke:마작패|출력|펑4만 (대가)}}
- 치 표기법
- '치'라는 대표어 뒤에 가져온 패를 적고, 나머지 두 패를 소괄호 안에 적습니다.
{{#invoke:마작패|출력|치 8삭(79삭)}}
- 깡 표기법
- '깡'이라는 대표어 뒤에 가져온 패를 적습니다. 안깡인 경우에는 그대로 두고, 타가에게서 받아온 경우에는 펑과 마찬가지로 소괄호 안에 적습니다.
{{#invoke:마작패|출력|깡 발}}
{{#invoke:마작패|출력|깡중(하가)}}
- 가깡 표기법
- 파싱 함수의 이중 표기와 유사한 표기법을 사용하며, '펑' 또는 '깡' 대표어 뒤에
/
기호를 사용합니다.{{#invoke:마작패|출력|펑 /8통 (상가)}}
{{#invoke:마작패|출력|깡/서(하가)}}
- 표기법 조합
- 출력 함수는 표기법을 조합해서 구분자 기호를 사용해 여러 패를 동시에 적을 수 있습니다. 물론, 추가된 펑/치/깡 표기법을 사용하지 않아도 됩니다.
입력한 값 | 실제 표시되는 모습 |
---|---|
{{#invoke:마작패|출력|567만|8888통|백백| 깡 발(상가) |중}} |
|
{{#invoke:마작패|출력|깡 동|남남 / 남|깡 서 (대가)|뒤북북뒤|11통}} |
|
{{#invoke:마작패|출력|깡4만(대가)|123 만|9 통|펑 /4만(상가)}} |
|
{{#invoke:마작패|출력|938삭 726만|깡 9통(하가)}} |
기타 옵션[원본 편집]
옵션 값을 통해 출력 결과물을 조정하거나 기타 정보를 추가할 수 있습니다. 옵션의 순서는 무관하며, {옵션 이름} = {옵션 값}
형식으로 적습니다.
- 게임과 자리 표기법
- 현재 게임의 국 수와 자리를 옵션으로 표기할 수 있습니다. 옵션은 '게임'과 '자리'라는 이름을 사용합니다.
{{#invoke:마작패|출력|23만|444555666통|북북|게임=동1국|자리=남}}
- (동1국 남가)
{{#invoke:마작패|출력|서서|백백백|자리=서|999삭|234만|55통}}
- (서가)
- 도라와 쯔모, 론패 표기법
- 각각 '도라'와 '쯔모', '론'이라는 옵션을 사용합니다. 옵션의 순서는 무관합니다. 쯔모와 론 옵션은 동시에 사용할 수 없습니다.
{{#invoke:마작패|출력|서서|북북북|999만|345통|55통|자리=서|쯔모=적5통}}
- (서가) 쯔모
{{#invoke:마작패|출력|1통|111만|999만|111삭|999삭|론=1통|도라=19만19삭|자리=동|게임=남4국}}
- (남4국 동가) 론 도라
- 이미지 크기 조절
size
옵션을 사용하여 이미지의 가로 크기를 조정할 수 있습니다. 현재 업로드된 이미지는 가로 66px, 세로 90px의 이미지로서 이미지의 왜곡이 발생하지 않게 하기 위해서는 소수점이 발생하지 않는 11의 배수로 입력해야 합니다 (반드시 그래야 하는 것은 아닙니다). 기본값은 33입니다.
{{#invoke:마작패|출력|123-456만|size=22}}
{{#invoke:마작패|출력|123-456만|size=37}}
{{#invoke:마작패|출력|123-456만|size=44}}
보조 함수들[원본 편집]
보조 함수는 위 파싱 함수와 출력 함수의 단축키 역할을 합니다. 일반적으로 많이 사용될 것으로 예상되는 형태의 패를 미리 설정해 두었습니다.
입력한 값 | 실제 표시되는 모습 |
---|---|
{{#invoke:마작패|만수패}} |
|
{{#invoke:마작패|통수패}} |
|
{{#invoke:마작패|삭수패}} |
|
{{#invoke:마작패|바람패}} |
|
{{#invoke:마작패|삼원패}} |
|
{{#invoke:마작패|자패}} |