diff options
author | Karl Berry <karl@freefriends.org> | 2020-06-15 20:36:25 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2020-06-15 20:36:25 +0000 |
commit | cb8e6abd24b5e90b71844a5aecd6ee51608f5b21 (patch) | |
tree | 794be695675528dbf95c868db7eaa5c8862230bb /Master/texmf-dist/doc | |
parent | b50316a7af545c8e6708232da43b8ba13bc36e6c (diff) |
wtref (15jun20)
git-svn-id: svn://tug.org/texlive/trunk@55558 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r-- | Master/texmf-dist/doc/latex/wtref/LICENSE | 2 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/wtref/README.md | 10 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/wtref/wtref-ja.pdf | bin | 120211 -> 117348 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/wtref/wtref-ja.tex | 70 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/wtref/wtref.pdf | bin | 220864 -> 226945 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/wtref/wtref.tex | 26 |
6 files changed, 58 insertions, 50 deletions
diff --git a/Master/texmf-dist/doc/latex/wtref/LICENSE b/Master/texmf-dist/doc/latex/wtref/LICENSE index 0dddce08b78..a089635538e 100644 --- a/Master/texmf-dist/doc/latex/wtref/LICENSE +++ b/Master/texmf-dist/doc/latex/wtref/LICENSE @@ -1,6 +1,6 @@ The MIT License (MIT) -Copyright (c) 2016-2017 Takuto ASAKURA (wtsnjp) +Copyright 2016-2020 Takuto ASAKURA (wtsnjp) Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal diff --git a/Master/texmf-dist/doc/latex/wtref/README.md b/Master/texmf-dist/doc/latex/wtref/README.md index b965038d6be..d2af713e5fb 100644 --- a/Master/texmf-dist/doc/latex/wtref/README.md +++ b/Master/texmf-dist/doc/latex/wtref/README.md @@ -1,17 +1,17 @@ -# WTRef Package (v0.3.2) +# WTRef Package (v0.4.0) -WTRef package extend cross-reference system of LaTeX2e and introduce concepts of namespace and scope. This package is a part of the WT Series. +WTRef package is a small extension for LaTeX2e's cross-reference system. It introduces concepts of namespace and scope. This package is a part of the WT Series. ## System Requirements * TeX format: LaTeX2e * TeX engine: any engine * Document class: any class -* Prerequisite package: xkeyval +* Prerequisite package: xparse and xkeyval ## Installation -Move wtref.sty file to $TEXMF/tex/latex/wtref. +Move wtref.sty file to $TEXMF/tex/latex/wtref. ## Documents @@ -23,4 +23,4 @@ This package released under [the MIT license](./LICENSE). --- -Takuto ASAKURA ([wtsnjp](https://twitter.com/wtsnjp))
\ No newline at end of file +Takuto ASAKURA ([wtsnjp](https://twitter.com/wtsnjp)) diff --git a/Master/texmf-dist/doc/latex/wtref/wtref-ja.pdf b/Master/texmf-dist/doc/latex/wtref/wtref-ja.pdf Binary files differindex 8d216eab71a..587f6a731fa 100644 --- a/Master/texmf-dist/doc/latex/wtref/wtref-ja.pdf +++ b/Master/texmf-dist/doc/latex/wtref/wtref-ja.pdf diff --git a/Master/texmf-dist/doc/latex/wtref/wtref-ja.tex b/Master/texmf-dist/doc/latex/wtref/wtref-ja.tex index e8e8eaa0cc8..87e1189380d 100644 --- a/Master/texmf-dist/doc/latex/wtref/wtref-ja.tex +++ b/Master/texmf-dist/doc/latex/wtref/wtref-ja.tex @@ -1,14 +1,18 @@ +%#!uplatex \documentclass[a4paper,uplatex]{jsarticle} \usepackage{otf} \usepackage{enumitem} \usepackage{shortvrb} +\usepackage[verb]{bxghost} + \MakeShortVerb{\|} -\newcommand{\PkgName}{\textsf{WTRef}} +\newcommand{\PkgName}[1]{\textsf{#1}} +\newcommand{\ThisPkg}{\PkgName{WTRef}} \newcommand{\Meta}[1]{$\langle$\mbox{}\textit{#1}\mbox{}$\rangle$} \newenvironment{syntax}{\begin{quote}\small}{\end{quote}} -\title{\PkgName パッケージ (v0.3.2)} +\title{\ThisPkg パッケージ (v0.4.0)} \author{朝倉卓人 (wtsnjp)} \begin{document} @@ -17,26 +21,26 @@ \begin{abstract} WTシリーズは著者が\LaTeX 文書作成にあたってよく利用するマクロを集めたものである. -\PkgName パッケージはこのWTシリーズを構成するパッケージの1つであり,\LaTeX オリジナルの +\ThisPkg パッケージはこのWTシリーズを構成するパッケージの1つであり,\LaTeX オリジナルの 相互参照機能を拡張してスコープの指定と名前空間の分離,参照形式の柔軟な指定を可能にする. -サポート対象は任意の\TeX エンジンと\LaTeXe の組み合わせで,動作には\textsf{xkeyval} -パッケージが必要である. +サポート対象は任意の\TeX エンジンと\LaTeXe の組み合わせで,動作には\PkgName{xparse}, +\PkgName{xkeyval}パッケージが必要である. \end{abstract} \section{動作要件} -\PkgName パッケージの動作要件は以下の通りである. +\ThisPkg パッケージの動作要件は以下の通りである. % \begin{itemize} \item \TeX エンジン:任意 \item \TeX フォーマット:\LaTeXe \item ドキュメントクラス:任意 -\item 依存パッケージ:\textsf{xkeyval} +\item 依存パッケージ:\PkgName{xparse}, \PkgName{xkeyval} \end{itemize} \section{パッケージ読み込み} -読み込みには |\usepackage| 命令を用いる.オプションは存在しない. +読み込みには|\usepackage|命令を用いる.オプションは存在しない. % \begin{syntax} |\usepackage{wtref}| @@ -46,7 +50,7 @@ WTシリーズは著者が\LaTeX 文書作成にあたってよく利用する \subsection{相互参照命令の新設} -|\newref| 命令を用いて相互参照に用いる2つの命令を新設することができる.この命令は +|\newref|命令を用いて相互参照に用いる2つの命令を新設することができる.この命令は プリアンブルでのみ使用可能である. % \begin{syntax} @@ -58,9 +62,9 @@ WTシリーズは著者が\LaTeX 文書作成にあたってよく利用する あってはならない.なお\Meta{ref types}の先頭・末尾およびカンマ前後の連続する空白は すべて無視される. -|\newref| 命令は指定した\Meta{ref type}に応じて |\|\Meta{ref type}|label|, -|\|\Meta{ref type}|ref| という形をもつ,新しい2つの命令を定義する.ここで前者の命令を -\textbf{ラベル命令},後者の命令を\textbf{参照命令}と呼ぶことにする.|\newref| 命令は同名の +|\newref|命令は指定した\Meta{ref type}に応じて|\|\Meta{ref type}|label|, +|\|\Meta{ref type}|ref|という形をもつ,新しい2つの命令を定義する.ここで前者の命令を +\textbf{ラベル命令},後者の命令を\textbf{参照命令}と呼ぶことにする.|\newref|命令は同名の 命令が既に存在していても,その定義を上書きするので\Meta{ref type}は注意して選ぶ必要がある. また,\Meta{options}には以下の内容をkey-valueリストで指定可能である: @@ -93,8 +97,8 @@ WTシリーズは著者が\LaTeX 文書作成にあたってよく利用する \subsubsection{機能と使い方} -ラベル命令はラベルを付けるときに用いる.使い方は\LaTeX の |\label| 命令とまったく同様である. -以下にラベル命令の例 |\exlabel| を用いるときの書式を示しておく. +ラベル命令はラベルを付けるときに用いる.使い方は\LaTeX の|\label|命令とまったく同様である. +以下にラベル命令の例|\exlabel|を用いるときの書式を示しておく. % \begin{syntax} |\exlabel{|\Meta{label}|}| @@ -111,61 +115,61 @@ WTシリーズは著者が\LaTeX 文書作成にあたってよく利用する \subsection{参照命令} 参照命令は対応するラベル命令によってラベル付けされた番号を,指定した書式で印字するための -命令である.例として |\exref| の使い方を以下に示す. +命令である.例として|\exref|の使い方を以下に示す. % \begin{syntax} |\exref[|\Meta{the scope}|]{|\Meta{label list}|}| \end{syntax} 参照するラベルが同じスコープ内に存在する場合は\Meta{the scope}は省略可能である. -\Meta{the scope}に参照先のスコープに対応する``|\the|\Meta{counter}''の出力を直接記入することで -スコープの範囲外からラベルを参照することが可能である.なお,スコープ機能が無効 -(|\newref| によって相互参照命令を定義する際に\Meta{options}で |scope| キーを指定しなかった +\Meta{the scope}に参照先のスコープに対応する``|\the|\Meta{counter}''の出力を直接記入する +ことでスコープの範囲外からラベルを参照することが可能である.なお,スコープ機能が無効 +(|\newref|によって相互参照命令を定義する際に\Meta{options}で|scope|キーを指定しなかった 場合)のときは,\Meta{the scope}は常に無視される. また,引数にはカンマ区切りで複数の参照先ラベルを指定することが可能である. \Meta{label list}の先頭・末尾およびカンマ前後の連続する空白はすべて無視される. -複数のラベルを指定した場合,デフォルトでは該当する番号がカンマ区切りで出力される.この出力書式 -は後述する参照書式変更命令 |\setrefstyle| を用いて柔軟にカスタマイズすることができる. +複数のラベルを指定した場合,デフォルトでは該当する番号がカンマ区切りで出力される. +この出力書式は後述する参照書式変更命令|\setrefstyle|を用いて柔軟にカスタマイズすることが +できる. \section{参照書式変更命令} -|\setrefstyle| 命令を用いると,参照命令による出力を柔軟にカスタマイズすることができる. -最初に |\setrefstyle| 命令の書式を示しておく. +|\setrefstyle|命令を用いると,参照命令による出力を柔軟にカスタマイズすることができる. +最初に|\setrefstyle|命令の書式を示しておく. % \begin{syntax} |\setrefstyle{|\Meta{ref types}|}{|\Meta{options}|}| \end{syntax} これにより\Meta{ref types}中に含まれる\Meta{ref type}に対応する参照命令が出力する内容の -書式を変更できる.この |\setrefstyle| 命令はプリアンブルに限らず\LaTeX 文書ソース中全域で -使用可能であり,設定の有効範囲は |{| や |}| によるブロックの制御を受ける. +書式を変更できる.この|\setrefstyle|命令はプリアンブルに限らず\LaTeX 文書ソース中全域で +使用可能であり,設定の有効範囲は|{|や|}|によるブロックの制御を受ける. \Meta{options}には以下の内容をkey-valueリストで指定可能である: % \begin{description}[font=\normalfont] \item[|refcmd=|\Meta{command}] \Meta{label list}に与えたラベルの数だけ,指定した\Meta{command}が繰り返し実行・印字される. -\Meta{command}中に記入された |#1| は適切に整形されたラベル名に置換される. -規定値は |\ref{#1}|. +\Meta{command}中に記入された|#1|は適切に整形されたラベル名に置換される.規定値は|\ref{#1}|. % \item[|sep=|\Meta{command}] -\Meta{label list}に3つ以上のラベルが記入されているときに,|refcmd| の各出力の間に印字 -する区切りの内容を指定する.ただし,最後の区切りは |last sep| に指定した値となる. -規定値は |{,\space}|. +\Meta{label list}に3つ以上のラベルが記入されているときに,|refcmd|の各出力の間に印字 +する区切りの内容を指定する.ただし,最後の区切りは|last sep|に指定した値となる. +規定値は|{,\space}|. % \item[|last sep|(|=|\Meta{command})] \Meta{label list}に複数のラベルが記入されている際に出力される,最後の区切りを指定する. -|=| 以降を記入せず,単に |last sep| と指定した場合,最後の区切りには |sep| の値が適用される. -規定値は値指定なし(つまり |sep| の値に従属). +|=|以降を記入せず,単に|last sep|と指定した場合,最後の区切りには|sep|の値が適用される. +規定値は値指定なし(つまり|sep|の値に従属). % \item[|prefix=|\Meta{command}] 参照命令を使用したとき,最初に実行・印字される内容を指定する. -規定値は |{}|. +規定値は|{}|. % \item[|suffix=|\Meta{command}] 参照命令を使用したとき,最後に実行・印字される内容を指定する. -規定値は |{}|. +規定値は|{}|. \end{description} % これらの設定は,明示的に指定したもの以外はそれ以前の設定がそのまま引き継がれる. diff --git a/Master/texmf-dist/doc/latex/wtref/wtref.pdf b/Master/texmf-dist/doc/latex/wtref/wtref.pdf Binary files differindex 4787b420257..0022ff251b9 100644 --- a/Master/texmf-dist/doc/latex/wtref/wtref.pdf +++ b/Master/texmf-dist/doc/latex/wtref/wtref.pdf diff --git a/Master/texmf-dist/doc/latex/wtref/wtref.tex b/Master/texmf-dist/doc/latex/wtref/wtref.tex index 02e482ac7fd..bfd9bfa913f 100644 --- a/Master/texmf-dist/doc/latex/wtref/wtref.tex +++ b/Master/texmf-dist/doc/latex/wtref/wtref.tex @@ -1,13 +1,16 @@ +%#!pdflatex \documentclass[a4paper]{article} \usepackage{enumitem} \usepackage{shortvrb} + \MakeShortVerb{\|} -\newcommand{\PkgName}{\textsf{WTRef}} +\newcommand{\PkgName}[1]{\textsf{#1}} +\newcommand{\ThisPkg}{\PkgName{WTRef}} \newcommand{\Meta}[1]{$\langle$\mbox{}\textit{#1}\mbox{}$\rangle$} \newenvironment{syntax}{\begin{quote}\small}{\end{quote}} -\title{{\PkgName} Package (v0.3.2)} +\title{The {\ThisPkg} Package (v0.4.0)} \author{Takuto ASAKURA (wtsnjp)} \begin{document} @@ -15,27 +18,28 @@ \maketitle \begin{abstract} -WT Series collects macros which author frequently use to create {\LaTeX} documents. -{\PkgName} package is a part of this WT Series that extend {\LaTeX} original -cross-reference system. It makes enable to divide namespace and scope, further arrows users -to customise reference formats. {\LaTeXe} on any kind of {\TeX} engine is supported, and -\textsf{xkeyval} package is required. +WT Series collects macros which are useful to create {\LaTeX} documents. +{\ThisPkg} package is a part of this WT Series that extends cross-reference +system of {\LaTeX}. It makes enable to divide namespace and scope, further +arrows users to customise reference formats. {\LaTeXe} on any kind of {\TeX} +engine is supported. The package requires Package \PkgName{xparse} and +\PkgName{xkeyval}. \end{abstract} \section{System Requirements} -System requirements of {\PkgName} are shown bellow: +System requirements of {\ThisPkg} are shown bellow: % \begin{itemize} \item {\TeX} engine: any engine \item {\TeX} format: \LaTeXe \item Document class: any class -\item Required package: \textsf{xkeyval} +\item Required packages: \PkgName{xparse} and \PkgName{xkeyval} \end{itemize} -\section{Loading the {\PkgName} Package} +\section{Loading the {\ThisPkg} Package} -To use {\PkgName} package, load \texttt{wtref.sty} file with |\usepackage| command in preamble. +To use {\ThisPkg} package, load \texttt{wtref.sty} file with |\usepackage| command in preamble. No package option is available. % \begin{syntax} |