天地有情

[LaTeX] changes --- 文書の変更(追加,訂正,置換)のマークアップ

§1 はじめに

changesパッケージは,ユーザーが手動で additions, deletions, replacements などの
テキストの変更をマークアップのための手段を提供します.変更されたテキストは別の色
で示されます.削除されたテキストは striked out(中線を引く)されます.

1.1 インストール

TeXLive/W32TeX などには標準でインストールされています.

1.2 マニュアル

コマンドラインから texdoc changes を実行するか,
上記に同梱の changes.pdf をお読み下さい.


§2 使い方

2.1プリアンブルに
  \usepackage {changes}
  または,
  \usepackage [<options>] {changes}
  を記述します.

<options>:
  ・draft
   変更のマークアップを可能にします.デフォルトのオプションです.
   \usepackage[draft]{changes} あるいは \usepackage{changes}

  ・final
   変更のマークアップを無効にし,唯一の正しいテキストが表示されます.
   \usepackage[final]{changes}

  ・markup
   事前定義された視覚的なマークアップを選択します.明示的なマークアップが指定
   されてない場合,デフォルトのマークアップが選択されます.
   
   \usepackage[markup=<markup> ]{changes}
   
    e.g.
    \usepackage[markup=default]{changes} または, \usepackage{changes}
    \usepackage[markup=underlined]{changes}
    \usepackage[markup=bfit]{changes}
    \usepackage[markup=nocolor]{changes}

  ・addedmarkup, deletedmarkup
   addedmarkupオプションが追加されたテキストの事前定義された視覚的なマークアップが選択されます.
   deletedmarkupオプションは削除されたテキストの事前定義された視覚的なマークアップが選択されます.
   
   \usepackage[addedmarkup=<markup> ]{changes}
   
    e.g.
    \usepackage[addedmarkup=none]{changes} または,\usepackage{changes}
    \usepackage[addedmarkup=uline]{changes}

  ・authormarkup
   authormarkupオプションはauthorの識別の事前定義された視覚的なマークアップが選択されます.
   明示的なマークアップが指定されていない場合,デフォルトのマークアップが選択されています.
   
   \usepackage[authormarkup=<markup> ]{changes}
   
    e.g.
    \usepackage[authormarkup=superscript]{changes} または, \usepackage{changes}
    \usepackage[authormarkup=subscript]{changes}
    \usepackage[authormarkup=brackets]{changes}
    \usepackage[authormarkup=footnote]{changes}
    \usepackage[authormarkup=none]{changes}

  ・authormarkupposition
   authormarkuppositionオプションはauthorの識別の位置を選択します.
   明示的なマークアップが指定されていない場合,デフォルトの値が選択されています.
   
   \usepackage[authormarkupposition= <markup> ]{changes}
   
    e.g.
    \usepackage[authormarkupposition=right]{changes} または, \usepackage{changes}
    \usepackage[authormarkupposition=left]{changes}

  ・authormarkuptext
   authormarkuptextオプションは,authorの識別に使用されるテキストを選択します.
   明示的なマークアップが指定されていない場合,デフォルトの値が選択されています.
   
   \usepackage[authormarkuptext= <markup> ]{changes}
   
    e.g.
    \usepackage[authormarkuptext=id]{changes} = \usepackage{changes}
    \usepackage[authormarkuptext=name]{changes}

  ・ulem
   ulemパッケージのすべてのオプションをパラメータとして指定することができます.
   二つ以上のオプションの場合,中括弧に入れる必要があります.
   
   \usepackage[ulem=<options> ]{changes}
   
    e.g.
    \usepackage[ulem=normalem]{changes}
    \usepackage[ulem={normalem,normalbf}]{changes}

  ・xcolor
   xcolorパッケージのすべてのオプションをパラメータとして指定することができます.
   二つ以上のオプションが中括弧に包含されることがあります.
   
   \usepackage[xcolor=<options> ]{changes}
   
    e.g.
    \usepackage[xcolor=dvipdf]{changes}
    \usepackage[xcolor={dvipdf,gray}]{changes}

(注)changes-packageは,その機能のために既存のパッケージを使用しています.次の
   パッケージが常に必要とされ、changespackageのためにインストールされています.
   (xifthen, xkeyval, pdfcolmk, ulem, xcolor)

2.2 authorの定義
changes-packageはデフォルトの「匿名」(anonymous)のauthorを提供します.authorに応じて変更を追跡
したい場合は、次のように必要なauthorを定義する必要があります.

  ・\definechangesauthor[name={<author's name> }, color={<color> }]{<author's id> }
  
   \definechangesauthorは,変更のための新しいauthorが定義されます.
   ユニークなauthorのIDを定義する必要があり特殊文字やスペースはauthorのid内で
   許可されていません.対応する色やauthor名を定義することができます.色を定義
   しない場合,黒が使用されます. 対応するオプションを設定した場合,authorの
   名前は,変更のリストとマークアップで使用されています.

    e.g.
    \definechangesauthor{EK}
    \definechangesauthor[color=orange]{EK}
    \definechangesauthor[name={Ekkart Kleinod}]{EK}
    \definechangesauthor[name={Ekkart Kleinod}, color=orange]{EK}

2.3 コマンド

すべてが変更されたテキストはマークアップするように設定されています.変更に応じて
以下のコマンドを使用します.

■ newly added text

  ・\added[id=<author's id> , remark=<remark> ]{<new text> }
  
   \addedコマンドは,新しいテキストをマーク.
   新しいテキストは、中括弧で書かれているコマンドの必須の引数です。
   オプションの引数はauthor's IDとremarkするための キーと値 のペアが含まれています.
   author's IDは\definechangesauthorを使用して定義されなければなりません.
   remarkは、特殊文字やスペースが含まれている場合は、remarkを囲む中括弧を使用します.
   
    e.g.
    This is \added[id=EK]{new} text.
    This is \added[id=EK, remark={has to be in it}]{new} text.
    This is \added[remark=anonymous]{new} text.

■ deleted text

  ・\deleted[id=<author's id> , remark=<remark> ]{<deleted text> }
  
   \deletedコマンドはマークがテキストを削除します.
   
    e.g.
    This is \deleted[remark=obsolete]{bad} text.

■ replaced text

  ・\replaced[id=<author's id> , remark=<remark> ]{<new text> }{<old text> }
  
   \replacedコマンドはテキストを置き換えます.必須の引数は新しいテキストと古いテキストです.

    e.g.
    This is \replaced[id=EK]{nice}{bad} text.

2.4 文書の組版

テキストで変更をマーキングした後は,LaTeX で処理することによって生成された文書で
それらを表示することができます.対応するオプションやコマンドで文書を処理すること
により,変更されたテキストがレイアウトされます.

2.5 変更リストの出力

  ・\listofchanges[style=<list|summary> ]
  
   \listofchangesコマンドは、変更のリストまたは要約を出力します.
   スタイル引数は,変更の一覧が印刷されます.デフォルトはオプションです.
   要約を印刷したい場合はオプションの style=summary を使用する必要があります.

2.6 マークアップの出力を抑制

多くの場合,変更を認識した後、変更マークアップを削除したいです.次の方法で,変更
マークアップの出力を抑制することができます.([final]オプション)
    \usepackage[final]{changes}


§3 簡単なサンプル

(1)\added, \replaced, \deleted を使った例

changes01.png


(注)
コンパイルは pdflatex あるいは 和文を含むなら lualatex(または luajitlatex)で行います.   
\listofchanges でリスト出力する場合には, 2回コンパイルします.



(2)\usepackage[final]{changes} finalオプションを指定した場合の例
   オプション [final] は文書を清書します.

changes02.png



(EOF)
スポンサーサイト
  1. 2016/08/03(水) 07:32:30|
  2. LaTeX Tools