天地有情

[LaTeX] showexpl --- LaTeXコードとフォーマットされた出力の対照を表示する

showexpl --- LaTeXコードとフォーマットされた出力の対照を表示する

§1 はじめに

LaTeX パッケージのドキュメントは,コマンドと環境の使用例がある場合,はるかに読みやすくなります.
これを行う最善の方法は,LaTeX コードとフォーマットされた出力の対照を与えることです.

showexpl は,それを行うためのパッケージであり,良好なタイプセットソースコードを提供します.
次に参考例を示します.実行結果の配置は オプション "pos=r,l,t,b" で指定できます.

show00.png

1.1 インストール

TeXLive/W32TeX などには標準でインストールされていますので,インストール作業は必要ありません.
すぐに利用できる状態にあると思われます.

1.2 マニュアル

コマンドラインから texdoc showexpl を実行してください.

§2 LaTeX2e 文書での指定方法

2.1 書式

プリアンブルに
  \usepackage{showexpl}
  \usepackage{listings,jlisting}  を記述します.

(注)上記の listings.sty はプログラムのソースコードなどを載せるのに利用できます.
   しかし,そのままで使うと 日本語 TeX (pTeX) 上では正常に処理できません.
   対策として以下から jlisting.bz2 をダウンロードしてください

showexpl は1つのコマンドと1つの環境を提供します.

● \LTXinputExampleの構文は次で与えられます.
   \LTXinputExample[<key val list>]{<file>}   
● LTXexample環境の構文は次で与えられます.
   \begin{LTXexample}[<key val list>] ...... \end{LTXexample}

のオプションセットは,コマンドと環境の両方で同じです.
詳細はマニュアルを参照ください.

show01B.png

2.2 サンプル

下記のディレクトリ中にオプション(<key val list>)の使い方などの好例があります.

  C:\w32tex\share\texmf-dist\doc\latex\showexpl

  ● showexpl-test.tex
  ● showexpl-test.pdf

§3 注意事項

次の QA:一般フォーラム において,

タイトル:[showexpl で日本語が抜ける]が見つかりました.参考になると思われます.

次のようなパッチを当てると[日本語]が表示されます.

■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■
\usepackage{etoolbox}
\makeatletter
\catcode`\^^I=11
\patchcmd{\lst@WFBegin}{\lst@ProcessSpace}{\lst@@ProcessSpace}{}{}
\catcode`\^^I=10
\makeatother
■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■

日本語表示の例

show02.png

(EOF)
スポンサーサイト
  1. 2015/04/01(水) 10:17:30|
  2. LaTeX Tools