Asir contrib の texinfo document を作製する方法. あなたの asir-contrib の folder 名が xy_zzz だとします. * texinfo を直接書く場合. *** 文字コードは必ず utf8 を使って下さい *** mkdir xy_zzz xy_zzz に texinfo ファイル xy_zzz-ja.texi (日本語) および xy_zzz-en.texi (英語) を用意します. どちらか片方でもかまいません. xy_zzz/Makefile はこちらで準備します. 例: todo_parametrize には todo_parametrize-ja.texi があります. 英語マニュアルはないので, 無いと宣言してるファイルを Makefile で自動作製しています. * oxgentexi を利用して全documentを自動生成する場合. mkdir xy_zzz xy_zzz に oxgentexi への入力ファイル xy_zzz.oxg を用意する. oxgentexi の入力ファイルは必ず拡張子 .oxg を付ける. --------- xy_zzz.oxg の例 ------------- /*&usage-ja begin: myadd(x,y) {x} と {y} の和を求める. description: ここには texinfo の命令もかける. example: myadd(1,3) example: myadd(x+1,y) end: */ リスト GT1 のような Makefile を用意する. make で xy_zzz-ja.texi が自動生成される. xy_zzz-en.texi も自動生成される. 中身は 英語のマニュアルがないよ, といってるだけ. make gen-html-ja (日本語 html ドキュメントの生成) ---------------------------------------------------------- リスト GT1 #$OpenXM: OpenXM/src/asir-contrib/packages/doc/oxgentexi/readme-ja.txt,v 1.2 2017/03/30 06:51:38 takayama Exp $ # Name of this document. MYNAME=xy_zzz SRC = ENSRCS = ${SRC:.oxw=.en} JASRCS = ${SRC:.oxw=.ja} ENAUTO= JAAUTO=${ENAUTO:.en=.ja} GENTEXI_OPT=--noSorting --author "OpenXM.org" --infoName asir-contrib-${MYNAME} include ../Makefile.common clean_private: ${RM} -f ${MYNAME}-ja.texi ${MYNAME}-en.texi ${MYNAME}-ja.texi: ${MYNAME}.oxg @echo "xy_zzz =?ISO-2022-JP?B?GyRCJV4lSyVlJSIlaxsoQg==?= " >title.tmp # generated by nkf -M ${NKF} -j ${MYNAME}.oxg | ${OXWEAVE} usage-ja | ${OXGENTEXI} ${GENTEXI_OPT} --title "`nkf -w title.tmp`" >${MYNAME}-ja.texi rm -f title.tmp ${MYNAME}-en.texi: @echo "begin: plain|" >auto.en @echo "English manual has not yet been written." >>auto.en @echo "end:" >>auto.en ${OXGENTEXI} ${GENTEXI_OPT} --title "xy_zzz Manual" ${MYNAME}-en.texi -------------------------------------------------------------------------