X-Git-Url: http://git.osdn.net/view?p=luatex-ja%2Fluatexja.git;a=blobdiff_plain;f=README;h=97bde80da0b11e901033083ca3d9350129df2cd0;hp=0937cacddb015ceecf3fa4c938fe3e1075871fcd;hb=3613db91c12dae3275d70f4bc3c9b52d2fc3b915;hpb=0f6477986ccd4acc3208a746ee2864542d4412e8 diff --git a/README b/README index 0937cac..97bde80 100644 --- a/README +++ b/README @@ -1,6 +1,6 @@ The LuaTeX-ja Package $VER$ -------------------------------- -Copyright (c) 2011--2012 The LuaTeX-ja project +Copyright (c) 2011--2019 The LuaTeX-ja project License: modified BSD (see COPYING) LuaTeX-ja is a macro package for typesetting Japanese documents with LuaTeX. @@ -8,38 +8,58 @@ 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), doc/luatexja-zh.pdf (zh). + doc/luatexja-en.pdf (en), doc/luatexja-ja.pdf (ja). LuaTeX-ja is developed on - . + . 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. +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. - LuaTeX-ja (luatexja-fontspec.sty) requires xunicode.sty v0.981. - -1. If you use TeX Live 2011 or later, you can install LuaTeX-ja via tlmgr. + This version of LuaTeX-ja requires + - LuaTeX 1.0.0 or later + - luaotfload v2.6 + - adobemapping (Adobe CMap files) + - everysel package + - etoolbox package + - ltxcmds package + - pdftexcmds package + - atbegshi package + - filehook package + - stfloats package + - IPAex fonts (http://ipafont.ipa.go.jp/) + Hence this version does not work in TeX Live 2016 (or earlier). + +1. If you are using TeX Live 2018 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 $VER$ in the Git repository by - - b. Extract the archive and put src/ into your TEXMF tree. + 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. Process src/ltj-kinsoku_make.tex by (plain) LuaTeX to generate ltj-kinsoku.lua, + which stores default "kinsoku" parameters. + + d. 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. - c. You may need to update the filename database, by 'mktexlsr' or something. + e. You may need to update the filename database, by mktexlsr (or by another program). Basic Usage @@ -49,11 +69,22 @@ 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. + 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 +----- +* 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.) -Last commit date: $Format:%cd$ + 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: $Format:%cd$