모듈:마작패/설명문서

리브레 위키에서 가져왔습니다.

이 모듈은 문서 내에 마작패 이미지를 쉽게 넣기 위해 만들어졌습니다. 마작패 이미지는 그 특성상 여러 이미지를 연달아 이어넣어야 하는데, 미디어위키의 이미지 삽입 문법을 이용해 하나하나 넣게 되면 오류가 발생하기 쉽고, 수정하기 힘들며 위키텍스트를 보았을 때 그 의미를 한 눈에 알아보기 쉽지 않습니다. 이 모듈은 이러한 문제점을 해결하기 위해, 사용자 친화적인 방식으로 마작패 이미지를 넣도록 해 줍니다.

마작패 모듈에는 크게 두 가지 메인 함수와 나머지 보조 함수가 있습니다. 메인 함수 두 가지는 '파싱' 함수와 '출력' 함수입니다.

마작 자체에 대한 자세한 설명은 마작 문서를 참고합니다. 또한, 이 틀의 상세한 예는 마작/리치마작 문서에서 확인할 수 있습니다.

간단한 사용법

{{#invoke:마작패|출력|123456789만}}

'출력' 문구 바로 뒤에 구분자 기호 |를 넣고, 그 뒤에 마작패의 호칭을 쓰면 됩니다.

마작패 표기법

수패

만수패는 '만', 통수패는 '통', 삭수패는 '삭' 이라는 대표어를 씁니다. 대표어 앞에 숫자를 1부터 9까지 쓰며, 숫자 사이에 대표어를 쓸 필요는 없습니다.

111222333444만

자패

자패는 바람패와 삼원패를 각각 '동남서북백발중' 이라는 대표어로 대신합니다.

적도라

적도라는 수패 5에만 있으며, 숫자 앞에 '적'이라는 대표어를 적어 표시합니다.

{{#invoke:마작패|파싱|1234적5678삭}}

뒷면

깡 등으로 인해 뒷면을 표기해야 할 때는 '뒤'라는 대표어를 적어 표시합니다.

'치', '펑' 등으로 인해 가로로 눕힌 패의 표기

눕혀서 표기해야 하는 패 바로 앞에 - 기호를 적어 표기합니다.

입력한 값	실제 표시되는 모습
{{#invoke:마작패|파싱|-345통}}
{{#invoke:마작패|파싱|발발-발}}

파싱 함수

파싱 함수는 연속된 마작패 이미지를 출력합니다. '파싱'이라는 함수명 뒤에 구분자를 적고, 표기법에 따라 마작패를 적어줍니다. 중간에 띄어쓰기가 있어도 무시하게 됩니다.

입력한 값	실제 표시되는 모습
{{#invoke:마작패|파싱|999통}}
{{#invoke:마작패|파싱|동남서북}}
{{#invoke:마작패|파싱|123만589삭2통}}
{{#invoke:마작패|파싱|999 99 9만}}

출력 함수

출력 함수는 파싱 함수의 확장으로, 여러 패를 구분해서 입력해야 하는 경우에 사용합니다. 특히, 펑이나 치, 깡 등을 간단하게 입력하는 데에 최적화되어 있습니다. 파싱 함수와 동일한 요령으로, 여러 패를 제한없이 구분지어 적을 수 있습니다. 마찬가지로 표기법 중간에 공백이 입력되면 단순히 무시합니다.

출력 함수에서는 위의 마작패 표기법에 있는 표기법 외에도 펑이나 치, 깡을 위한 추가적인 표기법을 사용할 수 있습니다.

펑 표기법

'펑'이라는 대표어 뒤에 가져온 패를 적고, 바로 이어서 소괄호 안에 누구에게 가져왔는지(상가, 대가 또는 하가) 적습니다.

{{#invoke:마작패|출력|펑4만(대가)}}

치 표기법

'치'라는 대표어 뒤에 가져온 패를 적고, 나머지 두 패를 소괄호 안에 적습니다.

{{#invoke:마작패|출력|치8삭(79삭)}}

깡 표기법

'깡'이라는 대표어 뒤에 가져온 패를 적습니다. 안깡인 경우에는 그대로 두고, 타가에게서 받아온 경우에는 펑과 마찬가지로 소괄호 안에 적습니다.

{{#invoke:마작패|출력|깡발}}

{{#invoke:마작패|출력|깡중(하가)}}

이를 전부 합쳐서, 출력 함수는 구분자 기호를 사용해 여러 패를 동시에 적을 수 있습니다. 물론, 추가된 펑/치/깡 표기법을 사용하지 않아도 됩니다. 이 추가 표기법은 일반 표기법과 함께 써서는 안되고, 반드시 따로 적어야 합니다.

입력한 값	실제 표시되는 모습
{{#invoke:마작패|출력|567만|789통|백백|깡발(상가)|중}}
{{#invoke:마작패|출력|깡동|깡서(대가)|남남남-남|뒤북북뒤|11통}}
{{#invoke:마작패|출력|깡4만(대가)|123 만|9 통}}
{{#invoke:마작패|출력|938삭 깡4만(대가) 726만}}

보조 함수들

보조 함수는 위 파싱 함수와 출력 함수의 단축키 역할을 합니다. 일반적으로 많이 사용될 것으로 예상되는 형태의 패를 미리 설정해 두었습니다.

입력한 값	실제 표시되는 모습
{{#invoke:마작패|만수패}}
{{#invoke:마작패|통수패}}
{{#invoke:마작패|삭수패}}
{{#invoke:마작패|바람패}}
{{#invoke:마작패|삼원패}}
{{#invoke:마작패|자패}}