•  


GitHub - Schmytzi/mahjong-tex: A LaTeX 3 package for typesetting mahjong hands
Skip to content

Schmytzi/mahjong-tex

Folders and files

Name Name
Last commit message
Last commit date

Latest commit

 

History

54 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mahjong-tex

CTAN

A LaTeX 3 package for typesetting mahjong hands using MPSZ algebraic notation. This package provides an interface for LaTeX 2e, so you can use it without any experience in LaTeX 3.

A display of all tiles used for Riichi Mahjong

This package focuses on Riichi (a.k.a. Japanese) Mahjong but can be used to typeset any style. However, flower tiles are currently missing.

Usage

\usepackage{mahjong}
\mahjong{<tiles>}

Insert mahjong tiles as specified by <tiles> . For instance,

\mahjong{119p 19s 19m 1234567z}

produces an image of the "Thirteen Orphans" hand with a pair of 1 dots.

A row of mahjong tiles: 1 dots, 1 dots, 9 dots, 1 bamboo, 9 bamboo, 1 character, 9 character, east wind, south wind, west wind, north wind, white dragon, green dragon, and red dragon

Additional supported features are:

  • Red fives
  • Concealed tiles
  • Spaces
  • Blank tiles
  • Rotated tiles (90° counter-clockwise)
  • Stacked, rotated tiles
\mahjong{X44Xp-123's-50"5m-33?z}

4 groups of mahjong tiles separated by spaces. Group 1: A concealed tile, showing its red backside, 4 dots, 4 dots, concealed tile. Group 2: 1 bamboo, 2 bamboo, 3 bamboo, rotated 90° counter-clockwise. Group 3: 5 character, two red 5 character, rotated 90° counter-clockwise and stacked, 5 character. Group 4: south wind, south wind, a tile with a question mark.

The size of the typeset hand can be changed. Either locally as an optional argument to \mahjong or as a package option.

Prerequisites

You need a sufficiently recent version of LaTeX which ships with the L3 programming layer. This applies to all version released after October 2019.

mahjong depends on stackengine, which is included in all major TeX distributions.

Building

A simple invocation of make is enough to produce a zip file in out/ which can be submitted to CTAN.

make

Installation

Run

make install

to install the package to your local texmf directory. It should be available for use in your documents.

Run

texdoc mahjong

to get an introduction to the package, including the extended flavor of MPSZ notation this package uses.

Attribution

The mahjong tiles used in this package were created by @FluffyStuff . The original repository is FluffyStuff/riichi-mahjong-tiles , used under CC-BY.

- "漢字路" 한글한자자동변환 서비스는 교육부 고전문헌국역지원사업의 지원으로 구축되었습니다.
- "漢字路" 한글한자자동변환 서비스는 전통문화연구회 "울산대학교한국어처리연구실 옥철영(IT융합전공)교수팀"에서 개발한 한글한자자동변환기를 바탕하여 지속적으로 공동 연구 개발하고 있는 서비스입니다.
- 현재 고유명사(인명, 지명등)을 비롯한 여러 변환오류가 있으며 이를 해결하고자 많은 연구 개발을 진행하고자 하고 있습니다. 이를 인지하시고 다른 곳에서 인용시 한자 변환 결과를 한번 더 검토하시고 사용해 주시기 바랍니다.
- 변환오류 및 건의,문의사항은 juntong@juntong.or.kr로 메일로 보내주시면 감사하겠습니다. .
Copyright ⓒ 2020 By '전통문화연구회(傳統文化硏究會)' All Rights reserved.
 한국   대만   중국   일본