X-Git-Url: http://git.osdn.jp/view?a=blobdiff_plain;f=README;h=a19ae738b7d0b8b1456dc07b915d1f9d996db81d;hb=eb118f3e5ea0852407b5261817700401699528b9;hp=d8fdda1dc353917a53208ce5b3d04f240b3e1526;hpb=41bb02d78a4042dffe47d54bc9d53296c0b240c0;p=luatex-ja%2Fluatexja.git diff --git a/README b/README index d8fdda1..a19ae73 100644 --- a/README +++ b/README @@ -1,6 +1,6 @@ -The LuaTeX-ja Package 20120422.0 +The LuaTeX-ja Package $VER$ -------------------------------- -Copyright (c) 2011--2012 The LuaTeX-ja project +Copyright (c) 2011--2015 The LuaTeX-ja project License: modified BSD (see COPYING) LuaTeX-ja is a macro package for typesetting Japanese documents with LuaTeX. @@ -8,35 +8,52 @@ 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 recognise questions/requests or bugs, we would like you to make a -thread in the forum or a ticket in the bug tracking system for that in the way -which SourceForge.jp supplies, via links found in the page above. + . +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. - LuaTeX-ja (luatexja-fontspec.sty) requires xunicode.sty v0.981. + This version of LuaTeX-ja requires + - LuaTeX beta-0.80.0 or later + - luaotfload v2.5 + - adobemapping (Adobe CMap files) + - everysel package + - IPAex fonts (http://ipafont.ipa.go.jp/) + Hence this version does not work in TeX Live 2014 (or earlier). -1. If you use TeX Live 2011 or later, you can install LuaTeX-ja via tlmgr. +1. If you are using TeX Live 2015 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 HEAD in the Git repository by - - b. Extract the archive and put src/ into your TEXMF tree. + a. Download the source archive from CTAN, + or tagged as $VER$ in the Git repository by + + + 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 @@ -47,10 +64,21 @@ 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. +- 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$