% \iffalse meta-comment % % Copyright (c) 2010 ASCII MEDIA WORKS % Copyright (c) 2016 Japanese TeX Development Community % % This file is part of the pLaTeX2e system (community edition). % ------------------------------------------------------------- % % \fi % % % \iffalse % % 2016/08/21 v2.0c % - Support pdfLaTeX, XeLaTeX and LuaLaTeX. % 2016/04/15 v2.0b % - Simplify \@keytop. % 2016/03/13 v2.0a % - Avoid arithmetic overflow in \mask/\maskbox. % 2016/03/12 v2.0 % - Converted to DTX file. % - Remove extra spaces before/after \keytop[c]{...}. % - Adjust parameters for \keytop. % 2016/03/06 % - Set \tbaselineshift in itembox str and shadebox env. % - Delete \tbaselineshift\z@ in \mask and \Maskbox. % - Save \ybaselineshift. % 2016/03/04 % - boxnote, shadebox begin with \par\vspace{.3\baselineskip}. % - Adjust the width of shadebox environment. % 2016/02/21 (many thanks to ZR for suggestions in bxascmac) % - Made compatible with pict2e (tate-gumi not supported yet). % - Adjust parameters for drawing rounded rectangles. % - Fix bugs in \maskbox and \Maskbox. % 2006/07/14 (ST): itembox, screen environment bug fix. % 2002/04/01 (KN): ASCII logo macros % 1998/11/27 (KN and FTEXers): itembox % 1998/02/27 (KN): set \tbaselineshift in minipage environment. % % \fi % % \iffalse %<*ascmac> %% wrapper for tascmac.sty %% % %<*tascmac> %% "tascmac" document style option for tate gumi. %% %% Original version: %% Copyright (C) by 1993, ASCII Corporation & Impress Corporation. %% (Last update: 2006/07/14) %% Modified by Japanese TeX Development Community, since 2016. %% %% (ChangeLog has moved to the source file ``ascmac.dtx'') %% % %\NeedsTeXFormat{LaTeX2e} %<*driver> \NeedsTeXFormat{pLaTeX2e} \ProvidesFile{ascmac.dtx} % %\ProvidesPackage{tascmac} %\ProvidesPackage{ascmac} [2016/08/21 v2.0c % ascmac package (community edition) % ascmac wrapper (community edition) ] %<*driver> \documentclass{jltxdoc} \usepackage{ascmac} \GetFileInfo{ascmac.dtx} \title{The \textsf{ascmac} package \fileversion} \author{Japanese \TeX\ Development Community} \date{作成日:\filedate} \begin{document} \maketitle \DocInput{\filename} \end{document} % % \fi % % \tableofcontents % % \section{はじめに} % % \textsf{ascmac}パッケージは、\LaTeXe{}の標準機能の範囲で、図や罫線で % 囲んだボックスを出力する命令などを提供します。\textsf{ascmac}パッケージ % の実体は\textsf{tascmac}パッケージですが、これはもともと古いp\LaTeX{}で % 配布されていた横組専用\textsf{ascmac}パッケージと、それを縦組に対応させ % た\textsf{tascmac}パッケージを統合した名残です。 % % このドキュメントは、アスキーによって配布されている 2006/07/14 バージョン % から派生して、日本語\TeX{}開発コミュニティによって開発されているバージョン % のために新たに書かれました。コミュニティ版では、オリジナルのアスキー版の % コードを元に、いくつかのバグ修正と他のパッケージとの互換性を改善しました。 % また、v2.0c以降ではpdf\LaTeX{}などのエンジンもサポートしました。 % % \section{使いかた} % % \subsection{環境型の命令} % % \textsf{ascmac}パッケージが提供する環境型の命令は4種類あります。それぞれ % テキストなどを罫線枠で囲んで出力します。 % % これらの環境は、すべて横幅がその時点での |\linewidth| の値になりますの % で、ボックスの幅を変更したい場合は |minipage| 環境などで囲んでください。 % 縦の長さは、自動的に内容に合わせて調整されます。 \medskip % % \DescribeEnv{boxnote} % |boxnote| 環境は、破ったメモ用紙のような雰囲気のボックスを作ります。 % 破ったような形の罫線は、ascgrpフォントを使って実現されています。 % % \begin{boxnote} % ボックスノート環境です。 % \end{boxnote} % は、以下の入力から得られます。 %\begin{verbatim} % \begin{boxnote} % ボックスノート環境です。 % \end{boxnote} %\end{verbatim} % % \DescribeEnv{screen} % |screen| 環境は、四隅が丸い囲み枠の中にテキストを入れます。 % オプション引数として |0| から |8| の整数値を指定すれば、四隅の丸みの % 具合を変更することができます。整数値を大きくするにつれて丸みは小さく % なっていきます。省略した場合は |0| とみなされます。 % % \begin{screen} % 四隅が丸い囲み枠です。 % \end{screen} % \begin{screen}[4] % 四隅が丸い囲み枠です。 % \end{screen} % は、以下の入力から得られます。 %\begin{verbatim} % \begin{screen} % 四隅が丸い囲み枠です。 % \end{screen} % \begin{screen}[4] % 四隅が丸い囲み枠です。 % \end{screen} %\end{verbatim} % % \DescribeEnv{itembox} % |itembox| 環境は |screen| 環境に似ていますが、上端の罫線のところにタイトル % を出力することができます。また、オプション引数 |l|, |c|, |r| でタイトル % の出力位置を左、中央、右と指定できます。省略した場合は中央になります。 % % \begin{itembox}[l]{タイトル} % 項目ボックスです。 % \end{itembox} % は、以下の入力から得られます。 %\begin{verbatim} % \begin{itembox}[l]{タイトル} % 項目ボックスです。 % \end{itembox} %\end{verbatim} % % \DescribeEnv{shadebox} % |shadebox| 環境は、影付きボックスの中にテキストを入れます。 % 影の幅は |\shaderule| パラメータで規定され、デフォルトは5ptです。 % % \begin{shadebox} % 影付きのボックスです。 % \end{shadebox} % は、以下の入力から得られます。 %\begin{verbatim} % \begin{shadebox} % 影付きのボックスです。 % \end{shadebox} %\end{verbatim} % % \subsection{網掛け命令} % % 網掛けをする命令が3種類用意されています。|\mask| 命令は、引数の内容の部分 % に網を掛けます。|\maskbox| 命令と |\Maskbox| 命令は、幅と高さを指定して % 網掛けすることができます。そして、|\maskbox| 命令と |\Maskbox| 命令の違い % は、後者のみボックスの周りに罫線を引くという点です。 % % これらの命令は、いずれもascgrpフォントに収録されている網掛けパターンの % 文字を並べることで網掛けを実現しています。 % % \makeatletter % \begin{table}[htbp] % \centering % \begin{tabular}{llll} % A = {\@ascgrp A} & B = {\@ascgrp B} & C = {\@ascgrp C} & D = {\@ascgrp D} \\ % E = {\@ascgrp E} & F = {\@ascgrp F} & G = {\@ascgrp G} & H = {\@ascgrp H} \\ % I = {\@ascgrp I} & J = {\@ascgrp J} & K = {\@ascgrp K} & % \end{tabular} % \end{table} % \makeatother % % \DescribeMacro{\mask} % |\mask| 命令は、第1引数が網掛けをする内容で、第2引数が網掛けパターンを % 示す記号(AからK)です。 % % \begin{center} % \mask{網掛け例1}{A} \hfil \mask{網掛け例2}{C} % \end{center} % は、以下の入力から得られます。 %\begin{verbatim} % \mask{網掛け例1}{A} \hfil \mask{網掛け例2}{C} %\end{verbatim} % % \DescribeMacro{\maskbox} % |\maskbox| 命令は5つの引数を持ち、それぞれボックスの幅、高さ、 % 網掛けパターン、出力位置、網掛けをする内容です。出力位置は |l|, |c|, |r| の % いずれかで、それぞれ左、中央、右に出力します。 % % \begin{center} % \maskbox{25em}{4em}{E}{c}{幅を指定した網掛けボックス} % \end{center} % は、以下の入力から得られます。 %\begin{verbatim} % \maskbox{25em}{4em}{E}{c}{幅を指定した網掛けボックス} %\end{verbatim} % % \DescribeMacro{\Maskbox} % |\Maskbox| 命令は |\maskbox| 命令と同様の引数を持ちますが、網掛けをする内容の % 指定の前、すなわち5番目の引数として、ボックスを囲む罫線の太さも指定します。 % したがって、全部で6つの引数を持ちます。 % % \begin{center} % \Maskbox{30em}{4em}{A}{c}{1pt}{幅を指定した罫線付き網掛けボックス} % \end{center} % は、以下の入力から得られます。 %\begin{verbatim} % \Maskbox{30em}{4em}{A}{c}{1pt}{幅を指定した罫線付き網掛けボックス} %\end{verbatim} % % \subsection{その他の命令} % % \DescribeMacro{\keytop} % |\keytop| コマンドは、キーボード上の文字を示すときなどに便利です。 % % \begin{table}[htbp] % \centering % \begin{tabular}{cc} % 入力 & 出力 \\ % |\keytop{A}| & \keytop{A} \\ % |\keytop{あ}| & \keytop{あ} % \end{tabular} % \end{table} % % \DescribeMacro{\yen} % \DescribeMacro{\return} % \DescribeMacro{\Return} % 円記号を出力する |\yen| 命令は、Yと=を重ね合わせて出力しています。 % 改行記号は |\return| と |\Return| です。改行記号はascgrpフォント % を用いています。 % % \begin{table}[htbp] % \centering % \begin{tabular}{cc} % 入力 & 出力 \\ % |\yen| & \yen \\ % |\return| & \return \\ % |\Return| & \Return % \end{tabular} % \end{table} % % \DescribeMacro{\ascii} % \DescribeMacro{\Ascii} % \DescribeMacro{\ASCII} % アスキーコーポレーションのロゴを出力する命令です。 % サイズは3種類用意されています。 % % \ascii \hfil \Ascii \hfil \ASCII % % % \StopEventually{} % % \section{コード} % % \textsf{ascmac}パッケージは\textsf{tascmac}パッケージのラッパーです。 % \begin{macrocode} %<*ascmac> \RequirePackage{tascmac} % % \end{macrocode} % % 従来、\textsf{tascmac}パッケージの動作条件は、p\LaTeXe{}でした。 % しかし、community editionでは、バージョンv2.0c以降でほかのエンジンも % サポートすることにしました。 % \begin{macrocode} %<*tascmac> %% %% Originally `ascmac' and `tascmac' can be used only in %% pLaTeX, upLaTeX or LuaLaTeX with LuaTeX-ja support. %% We (texjporg) started to support other engines, such as %% pdfLaTeX, XeLaTeX and LuaLaTeX (even without LuaTeX-ja). %% \newif\ifascmac@ptex \ascmac@ptextrue \ifx\kanjiskip\@undefined \@ifpackageloaded{luatexja}{% \PackageInfo{tascmac}{% Patch from LuaTeX-ja will be applied}% }{% \PackageInfo{tascmac}{% Assuming pdfLaTeX, XeLaTeX or LuaLaTeX}% \ascmac@ptexfalse }% \fi % \end{macrocode} % % (u)p\LaTeXe{}とLua\TeX-ja以外をサポートするためのトリックです。 % 「Q」という文字のカテゴリーコードをこのパッケージを読んでいる間だけ % 変更し、(u)p\LaTeXe{}またはLua\TeX-jaでは無視する文字に、それ以外では % コメント文字(|%|と同じ)にします。 % \changes{2016/08/21}{v2.0c}{pdf\LaTeX{}などをサポート} % \begin{macrocode} \chardef\ascmac@q@catcode=\catcode`\Q\relax \ifascmac@ptex \catcode`\Q=9\relax \else \catcode`\Q=14\relax \fi % \end{macrocode} % % pdf\LaTeX{}やLua\LaTeX{}のプリミティブを使って、ascgrpのType1フォントを % 使用できるように設定します。 % \changes{2016/08/21}{v2.0c}{pdf\LaTeX{}でascgrpのType1フォントを使用} % \begin{macrocode} %% %% Use Type1 font for ascgrp (pdfLaTeX, LuaLaTeX) \ifascmac@ptex\else \ifdefined\pdfextension % LuaTeX (>=0.85) \pdfextension mapline{+ascgrp % \end{macrocode} % % \Finale % \endinput