summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/xelatex/zitie/README.md
blob: f70e1fc844b9bf263b3596a3762e16126c7922f7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
# zitie 

zitie is a LaTeX package for making CJK character calligraphy practicing 
sheet (copybook). 

zitie distinguishes `CJK` Classes and `Punctutation` Classes (`FullLeft`, 
`FullRight`, `HalfLeft`, `HalfRight`) and other Classes.

## Main Interfaces

`\framezi*[<options>]{<CJK chars>}`, makes frame for every single <CJK chars>

`\framezifile*[<options>]{<filename>}`, makes frame from <filename> 
containning <CJK chars>

`\framerange[<options>]{<char Hex range>}`, makes frame from Hex range,
such as: "4E00 -> "4E27, "4E30. etc

`\zitienewfont*{...}`, declares new font(s) for making frame

`\framezhlipsum[<options>]{<paragraphs>}[<name>]`, frames Lorem ipsum given 
<name> and <paragraphs> made by package `zhlipsum`. Use 
`\usepackage[enable-zhlipsum]{zitie}` to enable this function

`\zitiebackground[<background options>]`, make frames in background,
much faster than `\frame...` family. Use 
`\usepackage[enable-background]{zitie}` to enable this function

`\begin{zitieframe}{<initials>}[<options>] ... \end{zitieframe}`,
environment version for `\framezi`, can cantain `\par`

`\zitieCJKfamily`, use CJK font family declared before

`\zitiecolorlet`, zitie version of `\colorlet` in `xcolor` package

`...`

See PDF documentation (in chinese) for more details.

Please note the frame functions of this package currently do need many TeX 
computation, so the compiling maybe very slow.

Currently, only support XeTeX. 

## Dependence: 

`LaTeX2e 2020-10-01` and after, `l3draw`, `xeCJK`, `ctexsize`, please note that `l3draw`
is very experimental, some interfaces maybe cannot use later.

Need not `pgf` or `pstricks`.

## TODO:
- faster and less resource
- optimize `background` module 
- support LuaTeX
- support pinyin
- more grid
- more transformation
- support more character Classes
- support opacity (require l3opacity)
- ...

## IMPORTANT!!! 

Please note the attached PDF documentation contains NON-COMMERCIAL font. 
The copyright of those fonts belong to font designer(s), mainly, FounderType.
CANNOT be used for commercial purposes without authorization.

Source file (zitie.tex, zitie.sty) under LPPL 1.3c license. 

## Contact

GitHub: https://github.com/Sophanatprime/zitie

Email: longaster@163.com