AnimKanji Wordpress Plugin

Description

This Wordpress plugin allows to draw stroke by stroke animated kanji. Kanji are stored in SVG files. The available kanji are currently the 2136 jōyō kanji and the 862 jinmeyō kanji.

Version

Plugin version: 2

The SVG files representing kanji come from the AnimCJK project (version of 2018-12-16). Check https://github.com/parsimonhi/animCJK to get newer version of the SVG files if available. Just replace the svgsJa folder inside your plugin by the svgsJa folder of AnimCJK.

Installation (tested on wordpress 5.0)

1. Download the plugin archive on your computer.
2. Open the wordpress admin page of your website.
3. Select "Plugins" from the left menu. The "Plugins" page displays.
4. Click on "Add New". The "Install Plugins" page displays.
5. Click on "Upload".
6. Click on "Select a file" button, look for the plugin archive, then click on "Install Now".
7. Click on "Activate Plugin".

Usage

Insert somewhere in a wordpress page a string like:

[animkanji][/animkanji]
or
[animkanji]字[/animkanji] where "字" can be any jōyō kanji
or
[animkanji]一二三[/animkanji] where "一二三" can be any list of jōyō kanji

If no kanji is inserted between [animkanji] and [/animkanji], the displayed kanji is chosen randomly in the whole jōyō kanji set.
If only one kanji is inserted between [animkanji] and [/animkanji], the displayed kanji is that kanji.
If a list of kanji is inserted between [animkanji] and [/animkanji], the displayed kanji is chosen randomly in this list.

To display several kanji, just insert several [animkanji]...[/animkanji] in the page. For instance, to display "漢字", insert:

[animkanji]漢[/animkanji][animkanji]字[/animkanji]

Options

Some options can be set through the wordpress admin page of your web site. Click on "Settings" in the left menu, then on "AnimKanji", then modify what you want.

These options are:

• animkanji_tag (default value: "animkanji"): can be any alphanumeric string. Change this value if "animkanji" tag is already used by another plugin.
• animkanji_loop (default value: "2"): can be 0, 1 or 2. If 0, don't animate kanji. If 1, play kanji animation only once. If 2, play kanji animation as infinite loop.
• animkanji_initial_color (default value: "#ccc"): can be any css color. Initial color of the kanji.
• animkanji_drawing_color (default value: "#c00"): can be any css color. Color of a stroke during its drawing.
• animkanji_final_color (default value: "#000"): can be any css color. Final color of the kanji.
• animkanji_duration (default value: "1"): can be any number. Duration (in second) to draw one stroke.
• animkanji_delay (default value: "1"): can be any number. Delay (in second) between two drawings.

Attributes

It is also possible to use attributes to set loop and colors values for each kanji.

For instance:

[animkanji final_color="blue"]漢[/animkanji][animkanji final_color="orange"]字[/animkanji]

Style

The kanji images display inside svg tag that have "acjk" as css class name. By default, the width of the svg expands to fit its parent width. To set the size of the svg or to add a border or anything else you want, just add to the additional css of your website some style for svg.acjk class.

For instance, to force the svg to be an image of 256px by 256px, add to the additional css:

svg.acjk {width:256px;height:256px;}

Note: to add something to the additional css of your website, go to Wordpress admin page, click on "Appearance", then click on "Customize", then click on "Additional CSS".

Licences

Read COPYING.txt for more details.