1 The LuaTeX-ja Package $VER$
2 --------------------------------
3 Copyright (c) 2011--2019 The LuaTeX-ja project
4 License: modified BSD (see COPYING)
6 LuaTeX-ja is a macro package for typesetting Japanese documents with LuaTeX.
7 This package is highly affected by ASCII pTeX engine, but not a porting of it.
9 Note that this package is still *alpha-stage*; documentations are not complete
10 and specifications are subject to change. Documentations are located at
11 doc/luatexja-en.pdf (en), doc/luatexja-ja.pdf (ja).
13 LuaTeX-ja is developed on
14 <https://osdn.jp/projects/luatex-ja/wiki/FrontPage(en)>.
15 If you have questions or recognize bugs/have feature requests,
16 we would like you to create a thread in the forum or a ticket
17 in the way which OSDN supplies, via links found in the page above.
23 0. Please make sure that your TeX distribution is up-to-date.
24 This version of LuaTeX-ja requires
25 - LuaTeX 1.0.0 or later
26 LuaHBTeX and HarfTeX are not currently supported
27 - luaotfload (v2.98 or later recommended)
28 - adobemapping (Adobe CMap files)
36 - IPAex fonts (http://ipafont.ipa.go.jp/)
37 Hence this version does not work in TeX Live 2016 (or earlier).
39 1. If you are using TeX Live 2019 or later, you can install LuaTeX-ja via tlmgr.
41 2. If you must/want to install manually:
43 a. Download the source archive from CTAN,
44 or tagged as $VER$ in the Git repository by
45 <http://git.osdn.jp/view?p=luatex-ja/luatexja.git
46 ;a=snapshot;h=refs/tags/$VER$;sf=tgz>
48 b. Extract the archive and process following three files by LuaLaTeX
49 to generate classes for Japanese typesetting:
54 c. Process src/ltj-kinsoku_make.tex by (plain) LuaTeX to generate ltj-kinsoku.lua,
55 which stores default "kinsoku" parameters.
57 d. Put src/ into your TEXMF tree.
58 An example location is TEXMF/tex/luatex/luatexja.
60 If you are updating from old version, you MUST remove it before
61 extracting the new version of LuaTeX-ja.
63 e. You may need to update the filename database, by mktexlsr (or by another program).
69 LuaTeX-ja supports both the plain format and LaTeX2e.
70 Simply loading luatexja.sty by \input or \usepackage does the minimal setting.
72 - If you want to create Japanese-based documents, you can consider the use of
73 ltj{article,book,report}.cls or ltjs{article,book,report}.cls.
74 - If you want to use functionality of the fontspec package with Japanese fonts,
75 load luatexja-fontspec.sty. It defines control sequences such as \setmainjfont,
76 \setsansjfont and \jfontspec, which can be used for specifying Japanese fonts.
80 * This archive contains four .{dtx,ins} pairs:
81 src/ltjclasses.{ins,dtx}, src/ltjltxdoc.{ins,dtx}
82 src/ltjsclasses.{ins,dtx}, doc/luatexja.{ins,dtx}
83 Former three pairs generate class files (see above),
84 while the latter doc/luatexja.{ins,dtx} generates documentations.
85 (You will need Kozuka fonts to regenerate documentaion PDFs.)
87 No .{dtx,ins} pair generates .sty files of LuaTeX-ja package.
89 * src/*.{ins.dtx} and src/ltj-kinsoku_make.tex are not needed in regular use.
91 Last commit date: $Format:%cd$