IdeoTypeユーザガイド

使い方

ワークフローは単純です。ただ原稿を用意してソフトウェアを実行するだけです。

  1. 原稿を用意する
  2. IdeoTypeを実行してPDFを生成する

あとは好きなだけ原稿を編集してPDFを作り直せばよいのです。結果に満足したら、不要なファイルを片付けましょう。以降のセクションで具体的な操作方法を説明します。

原稿を準備する

IdeoTypeが受け付ける原稿形式は、XHTMLによく似ています。技術的にはXHTML+MathMLのサブセットで、classやidやtitleやその他の属性で意味を補ったものです（いわゆるmicroformatsの一種）。

注意事項：

原稿は例えばこのようになります： 

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1 plus MathML 2.0//EN"
 "http://www.w3.org/TR/MathML2/dtd/xhtml-math11-f.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-type" content="application/xhtml+xml;"/>
    <meta name="author" content="John Doe"/>
    <meta name="date" content="2038-02-31"/>
    <title>Title</title>
  </head>
  <body>
    ...
  </body>
</html>

記法の詳細は記法のセクションを参照してください。

原稿からPDFを生成する

現時点での標準のUIはコマンドラインインタフェースです。

原稿ファイルがfoo.xhtmlだとしたら、ideotype build foo.pdfとタイプすればPDFが生成されます。

配布物に含まれるテストデータで試せます。 

% cp -r /usr/share/doc/ideotype ./
% cd ideotype
% ls test/testdata.xhtml
test/testdata.xhtml
% ideotype build test/testdata.pdf
...
% ls test/testdata.pdf
test/testdata.pdf
%

ファイルを片付ける

不要な中間ファイルを削除するには、ideotype clean booknameとタイプします。 

% ideotype clean test/testdata

PDFを含め、生成されたファイルをすべて削除するには、ideotype distclean booknameとタイプします。 

% ideotype distclean test/testdata

進んだ使い方

既存のHTML文書を原稿として使う

HTML文書とそれに付随する画像などをWebからダウンロードするには、ideotype download URLとタイプします。 

% ideotype download http://example.org/foo.html

HTML文書とそれに付随する画像などをインポートするには、ideotype import filenameとタイプします。 

% ideotype import example.org/foo.html

ただしルールに沿って書かれたきれいなHTMLファイルしかインポートできません。この機能はまだ簡易的なものです。

特定の言語だけを出力する

langsオプションを使うと、特定のxml:lang属性を持った要素（およびxml:lang属性を持たない、全言語に共通の要素）だけを出力できます。 

% ideotype --langs="en" build test/testdata.pdf
% ideotype --langs="all" build test/testdata.pdf

原稿に不正なxml:lang値があると意図しない結果になるのでご注意ください。

プロジェクトごとのカスタマイズ

プロジェクト設定ファイルを書き換えればプロジェクトごとの設定を変えられます（まだ実験的な機能です）。 

% ideotype initproject .
% cp .book/html2latex.xsl.example .book/html2latex.xsl
% $EDITOR .book/html2latex.xsl

トラブルシューティング