README

   1 The LuaTeX-ja Package 20120419.0
   2 --------------------------------
   3 Copyright (c) 2011--2012 The LuaTeX-ja project
   4
   5 LuaTeX-ja is a macro package for typesetting Japanese documents with LuaTeX.
   6 This package is highly affected by ASCII pTeX engine, but not a porting of it.
   7
   8 Note that this package is still *alpha-stage*; documentations are not complete
   9 and specifications are subject to change. Documentations are located at
  10   doc/man-en.pdf (en), doc/man-ja.pdf (ja), doc/manual-zh.pdf (zh).
  11
  12 LuaTeX-ja is developed on
  13   <http://sourceforge.jp/projects/luatex-ja/wiki/FrontPage(en)>.
  14 If you recognise questions/requests or bugs, we would like you to make a
  15 thread in the forum or a ticket in the bug tracking system for that in the way
  16 which SourceForge.jp supplies, via links found in the page above.
  17
  18
  19
  20 Installation
  21 ------------
  22
  23 0. Please make sure that your TeX distribution is up-to-date.
  24    Needed (additional) packages are:
  25    - xunicode.sty v0.981
  26    - filehook.sty
  27 1. If you use TeX Live 2011 or later, you can install LuaTeX-ja via tlmgr.
  28 2. If you must/want to install manually:
  29    a. Download the source archive from CTAN, or HEAD in the Git repository by
  30       <http://git.sourceforge.jp/view?p=luatex-ja/luatexja.git
  31                                                     ;a=snapshot;h=HEAD;sf=tgz>
  32    b. Extract the archive and put src/ into your TEXMF tree.
  33       An example location is TEXMF/tex/luatex/luatexja.
  34    c. Files in src/no_runtime/ are not used in the regular use,
  35       so you can remove them.
  36    d. You may need to update the filename database, by 'mktexlsr' or something.
  37
  38
  39 Basic Usage
  40 -----------
  41
  42 LuaTeX-ja supports both the plain format and LaTeX2e.
  43 Simply loading luatexja.sty by \input or \usepackage does the minimal setting.
  44
  45 - If you want to create Japanese-based documents, you can consider the use of
  46   ltj{article,book,report}.cls or ltjs{article,book}.cls.
  47 - If you want to use the fontspec package, please load luatexja-fontspec.sty.
  48   It defines control sequences such as \setmainjfont, setsansjfont and
  49   \jfontspec, which can be used for specifying Japanese fonts.
  50