README

   1 The LuaTeX-ja Package $VER$
   2 --------------------------------
   3 Copyright (c) 2011--2013 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 These documents are generated from doc/luatexja.{dtx,ins}. However,
  13 to produce PDF files, you will need Kozuka fonts (commercial fonts).
  14
  15 LuaTeX-ja is developed on
  16   <http://sourceforge.jp/projects/luatex-ja/wiki/FrontPage(en)>.
  17 If you have questions or recognize bugs/have feature requests,
  18 we would like you to create a thread in the forum or a ticket
  19 in the way which SourceForge.JP supplies, via links found in
  20 the page above.
  21
  22
  23 Installation
  24 ------------
  25
  26 0. Please make sure that your TeX distribution is up-to-date.
  27    This version of LuaTeX-ja requires
  28     - LuaTeX beta-0.74.0 or later
  29     - luaotfload v2.2
  30     - luatexbase v0.6
  31    Hence this version does not work in TeX Live 2012 (or earlier).
  32
  33 1. If you are using TeX Live 2013 or later, you can install LuaTeX-ja via tlmgr.
  34
  35 2. If you must/want to install manually:
  36
  37    a. Download the source archive from CTAN,
  38       or tagged as $VER$ in the Git repository by
  39       <http://git.sourceforge.jp/view?p=luatex-ja/luatexja.git
  40                               ;a=snapshot;h=refs/tags/$VER$;sf=tgz>
  41
  42    b. Extract the archive and process following three files by LuaLaTeX
  43       to generate classes for Japanese typesetting:
  44         src/ltjclasses.ins
  45         src/ltjltxdoc.ins
  46         src/ltjsclasses.ins
  47
  48    c. Put src/ into your TEXMF tree.
  49       An example location is TEXMF/tex/luatex/luatexja.
  50
  51       If you are updating from old version, you MUST remove it before
  52       extracting the new version of LuaTeX-ja.
  53
  54    d. You may need to update the filename database, by 'mktexlsr' or something.
  55
  56
  57 Basic Usage
  58 -----------
  59
  60 LuaTeX-ja supports both the plain format and LaTeX2e.
  61 Simply loading luatexja.sty by \input or \usepackage does the minimal setting.
  62
  63 - If you want to create Japanese-based documents, you can consider the use of
  64   ltj{article,book,report}.cls or ltjs{article,book}.cls.
  65 - If you want to use the fontspec package, please load luatexja-fontspec.sty.
  66   It defines control sequences such as \setmainjfont, setsansjfont and
  67   \jfontspec, which can be used for specifying Japanese fonts.
  68
  69
  70 Last commit date: $Format:%cd$