The traditional Chinese 7-bids suanpan(abacus) package based on l3draw

The suanpan-l3 package is a traditional Chinese 7-bids abacus drawing package that utilizes l3draw and TikZ and is developed with Expl3. It can effectively manage both upper and lower bids, while also considering bottom bid, top bid, and hanging bid.

The suanpan-l3 package offers a unique environment for drawing abacuses, denoted as suanpan. Within this environment, 8 specialized macros are available for the creation of abacuses. The \rod macro is used to lay out a single rod, while the \rod* macro draws a counting point on this rod's beam. The \rods macro is capable of laying out a set of rods. The \bid macro colors the specified bid. The \bids macro colors all inner bids that are near the beam, while the \bids* macro colors all outer bids that are far from the beam. The \rodmark mark the rod on beam. Lastly, the \mkfame macro is used to lay out the frame of an abacus.

At the same time, the suanpan-l3 package offers customization options for abacus, including line width, draw color, fill color, bid space, rod space, etc. These can be configured through package options, suanpan environment options, or \suanpanset macro.

For further details and examples, please refer to the manual(in Chinese/English).

Contributing

1. gitee repository: (1). repository: suanpan (2). Issues and PR: issue or pull request.

基于l3draw的中国传统7珠算盘LaTeX排版宏包

suanpan-l3是一个基于l3draw和TikZ绘图宏包，用Expl3开发的中国传统7珠圆珠算盘排版宏包，它能够实现普通上珠、下珠和使用底珠、顶珠和悬珠的算盘排版。

suanpan-l3宏包提供了唯一的一个suanpan排版环境用于绘制需要排版的算盘，在该环境中使用专用命令\rod排版一个档位，\rod*命令排版带计位点的档位，\rods命令排版一组档位，\bid命令为指定的算珠进行着色，\bids命令为指定档位的内珠进行着色，\bids*命令为指定的档位的外珠进行着色，\rodmark命令用于为档位横梁添加标记，\mkframe命令排版算盘边框。

同时，suanpan-l3宏包还为算盘排版提供线宽、颜色、间距等外观设置选项，可以通过宏包选项、环境选项对其进行设置，也可以通过\suanpanset命令实现外观属性设置。

可以通过阅读宏包手册以了解该宏包更多的使用细节和使用样例。

参与贡献

1. gitee仓库: (1). 仓库地址: suanpan (2). Issues and PR: issue or pull request.

Copyright and Licence

Copyright (C) 2020-2024 by Nan Geng <nangeng@nwafu.edu.cn>
----------------------------------------------------------------------

This work may be distributed and/or modified under the
conditions of the LaTeX Project Public License, either
version 1.3c of this license or (at your option) any later
version. This version of this license is in
   http://www.latex-project.org/lppl/lppl-1-3c.txt
and the latest version of this license is in
   http://www.latex-project.org/lppl.txt
and version 1.3 or later is part of all distributions of
LaTeX version 2005/12/01 or later.

This work has the LPPL maintenance status "maintained".

The Current Maintainer of this work is Nan Geng.

This package consists of suanpan-l3.sty, suanpan-l3.tex and README.md(this file),
             and the derived files suanpan-l3.pdf with build.sh.