summaryrefslogtreecommitdiff
path: root/macros/luatex/generic/luatexja/README
blob: 3a433c20d48b0a290400b17bf47a9026b926cc03 (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
84
85
86
87
88
89
90
91
92
93
94
95
96
The LuaTeX-ja Package 20210521.0
--------------------------------
Copyright (c) 2011--2021 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
  <https://osdn.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 OSDN 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 1.10.0 (or later)
    - luaotfload (v3.1 or later recommended)
    - adobemapping (Adobe CMap files)
    - LaTeX2e 2020-02-02 patch level 5 or later (if you want to use with LaTeX)
    - etoolbox package
    - ltxcmds package, pdftexcmds package
    - filehook package, atbegshi package (for LaTeX2e 2020-02-02)
    - everysel package (for LaTeXe 2020-02-02 and 2020-10-01)
    - Harano Aji fonts (https://github.com/trueroad/HaranoAjiFonts)
	  more specifically, HaranoAjiMincho-Regular and HaranoAjiGothic-Medium

   Using LuaTeX-ja with LuaHBTeX is not well tested.
   One might be able to typeset documents without an error, but with
   some unwanted results.

1. If you are using TeX Live 2021, 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 20210521.0 in the Git repository by
      <http://git.osdn.jp/view?p=luatex-ja/luatexja.git
                              ;a=snapshot;h=refs/tags/20210521.0;sf=tgz>

   b. 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

   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 by another program).


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,report}.cls.
- If you want to use functionality of the fontspec package with Japanese fonts,
  load luatexja-fontspec.sty. It defines control sequences such as \setmainjfont,
  \setsansjfont and  \jfontspec, which can be used for specifying Japanese fonts.

Notes
-----
* We don't recommend defining a Japanese font with HarfBuzz, by specifying
  "Renderer=..." (fontspec) or "mode=harf" (otherwise).

* 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} are not needed in regular use.

* ltj-kinsoku_make.tex is removed in version 20200808.0.
  This file and ltj-kinsoku.lua are not used anymore.
  (Do not remove ltj-kinsoku.tex.)

Last commit date: Fri May 21 21:07:11 2021 +0900