README

   1 The LuaTeX-ja Package $VER$
   2 --------------------------------
   3 Copyright (c) 2011--2019 The LuaTeX-ja project
   4 License: modified BSD (see COPYING)
   5
   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.
   8
   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).
  12
  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.
  18
  19
  20 Installation
  21 ------------
  22
  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)
  29     - everysel package
  30     - etoolbox package
  31     - ltxcmds package
  32     - pdftexcmds package
  33     - atbegshi package
  34     - filehook package
  35     - stfloats package
  36     - IPAex fonts (http://ipafont.ipa.go.jp/)
  37    Hence this version does not work in TeX Live 2016 (or earlier).
  38
  39 1. If you are using TeX Live 2019 or later, you can install LuaTeX-ja via tlmgr.
  40
  41 2. If you must/want to install manually:
  42
  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>
  47
  48    b. Extract the archive and process following three files by LuaLaTeX
  49       to generate classes for Japanese typesetting:
  50         src/ltjclasses.ins
  51         src/ltjltxdoc.ins
  52         src/ltjsclasses.ins
  53
  54    c. Process src/ltj-kinsoku_make.tex by (plain) LuaTeX to generate ltj-kinsoku.lua,
  55       which stores default "kinsoku" parameters.
  56
  57    d. Put src/ into your TEXMF tree.
  58       An example location is TEXMF/tex/luatex/luatexja.
  59
  60       If you are updating from old version, you MUST remove it before
  61       extracting the new version of LuaTeX-ja.
  62
  63    e. You may need to update the filename database, by mktexlsr (or by another program).
  64
  65
  66 Basic Usage
  67 -----------
  68
  69 LuaTeX-ja supports both the plain format and LaTeX2e.
  70 Simply loading luatexja.sty by \input or \usepackage does the minimal setting.
  71
  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.
  77
  78 Notes
  79 -----
  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.)
  86
  87   No .{dtx,ins} pair generates .sty files of LuaTeX-ja package.
  88
  89 * src/*.{ins.dtx} and src/ltj-kinsoku_make.tex are not needed in regular use.
  90
  91 Last commit date: $Format:%cd$