summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/luatex/luatexja/README
blob: 8cd4cbe045afddfd02c6c3156399e3ab054f4f2b (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
76
77
78
79
80
81
82
83
The LuaTeX-ja Package 20140324.0
--------------------------------
Copyright (c) 2011--2014 The LuaTeX-ja project
License: modified BSD (see COPYING)

LuaTeX-ja is a macro package for typesetting Japanese documents with LuaTeX.
This package is highly affected by ASCII pTeX engine, but not a porting of it.

Note that this package is still *alpha-stage*; documentations are not complete
and specifications are subject to change. Documentations are located at
  doc/luatexja-en.pdf (en), doc/luatexja-ja.pdf (ja).

LuaTeX-ja is developed on
  <http://sourceforge.jp/projects/luatex-ja/wiki/FrontPage(en)>.
If you have questions or recognize bugs/have feature requests,
we would like you to create a thread in the forum or a ticket
in the way which SourceForge.JP supplies, via links found in
the page above.


Installation
------------

0. Please make sure that your TeX distribution is up-to-date.
   This version of LuaTeX-ja requires 
    - LuaTeX beta-0.74.0 or later
    - luaotfload v2.2
    - luatexbase v0.6
   Hence this version does not work in TeX Live 2012 (or earlier).

1. If you are using TeX Live 2013 or later, you can install LuaTeX-ja via tlmgr.

2. If you must/want to install manually:

   a. Download the source archive from CTAN,
      or tagged as 20140324.0 in the Git repository by
      <http://git.sourceforge.jp/view?p=luatex-ja/luatexja.git
                              ;a=snapshot;h=refs/tags/20140324.0;sf=tgz>

   b1. Extract the archive and process following three files by LuaLaTeX
      to generate classes for Japanese typesetting:
        src/ltjclasses.ins
        src/ltjltxdoc.ins
        src/ltjsclasses.ins

   b2. Process src/ltj-kinsoku_make.tex by (plain) LuaTeX to generate ltj-kinsoku.lua,
      which stores default "kinsoku" parameters.

   c. Put src/ into your TEXMF tree.
      An example location is TEXMF/tex/luatex/luatexja.

      If you are updating from old version, you MUST remove it before
      extracting the new version of LuaTeX-ja.

   d. You may need to update the filename database, by 'mktexlsr' or something.


Basic Usage
-----------

LuaTeX-ja supports both the plain format and LaTeX2e.
Simply loading luatexja.sty by \input or \usepackage does the minimal setting.

- If you want to create Japanese-based documents, you can consider the use of
  ltj{article,book,report}.cls or ltjs{article,book}.cls.
- If you want to use the fontspec package, please load luatexja-fontspec.sty.
  It defines control sequences such as \setmainjfont, setsansjfont and
  \jfontspec, which can be used for specifying Japanese fonts.

Notes
-----
* This archive contains four .{dtx,ins} pairs:
    src/ltjclasses.{ins,dtx},  src/ltjltxdoc.{ins,dtx}
    src/ltjsclasses.{ins,dtx}, doc/luatexja.{ins,dtx}
  Former three pairs generate class files (see above),
  while the latter doc/luatexja.{ins,dtx} generates documentations.
  (You will need Kozuka fonts to regenerate documentaion PDFs.)

  No .{dtx,ins} pair generates .sty files of LuaTeX-ja package.

* src/*.{ins.dtx} and src/ltj-kinsoku_make.tex are not needed in regular use.

Last commit date: Mon Mar 24 09:20:06 2014 +0900