summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/bxjalipsum
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2016-08-17 21:34:35 +0000
committerKarl Berry <karl@freefriends.org>2016-08-17 21:34:35 +0000
commit02f5a1ff8007f70b1adef128a3481ea5c19ba4e8 (patch)
treee2a873dac4cb7e8a1eee6f5eb26519c62dbe57f6 /Master/texmf-dist/doc/latex/bxjalipsum
parentabf56b1cefe5e9a8dc7d890d6ae4aad07dc314d5 (diff)
bxjalipsum (17aug16)
git-svn-id: svn://tug.org/texlive/trunk@41877 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/bxjalipsum')
-rw-r--r--Master/texmf-dist/doc/latex/bxjalipsum/LICENSE27
-rw-r--r--Master/texmf-dist/doc/latex/bxjalipsum/README.md78
-rw-r--r--Master/texmf-dist/doc/latex/bxjalipsum/sample-bxjalipsum-1.tex45
-rw-r--r--Master/texmf-dist/doc/latex/bxjalipsum/sample-bxjalipsum-2.tex25
4 files changed, 175 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/bxjalipsum/LICENSE b/Master/texmf-dist/doc/latex/bxjalipsum/LICENSE
new file mode 100644
index 00000000000..49f803e083e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/bxjalipsum/LICENSE
@@ -0,0 +1,27 @@
+$BK\%=%U%H%&%'%"$O(B MIT $B%i%$%;%s%9$N2<$GG[I[$5$l$^$9!#(B
+$BCx:n8"$O:n<T$G$"$k!VH,EP(B $B?rG7!JJLL>(B ZR$B!K!W$KB0$7$^$9!#(B
+$B$^$?K\%=%U%H%&%'%"$OL5J]>Z$G$9!#(B
+
+This software is distributed under the MIT License.
+
+The MIT License
+
+Copyright (c) 2016 Takayuki YATO (aka. "ZR")
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
diff --git a/Master/texmf-dist/doc/latex/bxjalipsum/README.md b/Master/texmf-dist/doc/latex/bxjalipsum/README.md
new file mode 100644
index 00000000000..d6af25ae9bf
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/bxjalipsum/README.md
@@ -0,0 +1,78 @@
+BXjalipsum Package
+==================
+
+LaTeX: Dummy text in Japanese
+
+This package enables users to print some Japanese text that can be used
+as dummy text. It is a Japanese counterpart of the lipsum package.
+
+Since there is no well-known nonsense text like Lipsum in the Japanese
+language, the package uses some real text in public domain.
+
+### System requirement
+
+ * TeX format: LaTeX.
+ * TeX engine: pTeX / upTeX / XeTeX / LuaTeX.
+ * Dependent packages:
+ - intcalc (when using non-e-TeX engines)
+
+### Installation
+
+ - `*.sty` → $TEXMF/tex/latex/BXjalipsum
+
+### License
+
+This package is distributed under the MIT License.
+
+The bxjalipsum Package
+----------------------
+
+### Package Loading
+
+ \usepackage{bxjalipsum}
+
+No options are available.
+
+### Usage
+
+ * `\jalipsum[<range>,...]{<key>}`: Prints some paragraphs from the
+ text specified by the key.
+
+ - `iroha` (1 paragraph): The iroha sequence (いろはにほへと…).
+ - `jugemu` (1 paragraph): The "jugemu" name (寿限無寿限無五劫の…).
+ - `jugemuP` (1 paragraph): The "jugemu" name, with some punctuation
+ added in ad hoc manner (寿限無・寿限無、五劫の…).
+ - `wagahai` (33 paragraphs): The first chapter from the novel
+ "吾輩は猫である" (I Am A Cat) written by Natsume Soseki.
+ - `preamble` (4 paragraphs): The preamble of the Constitution of
+ Japan.
+ - `hatsukoi` (4 paragraphs): The whole text of the poem "初恋"
+ (First Love) written by Shimazaki Toson.
+
+ Ranges are specified in the form `[-3,7-10,5,12-]`. If ranges are not
+ given, then `[-]` (all paragraphs) will be assumed.
+
+ * `\jalipsumiroha`: The shorthand for `\jalipsum{iroha}`.
+ * `\jalipsumjugemu`: The shorthand for `\jalipsum{jugemu}`.
+ * `\jalipsumjugemuP`: The shorthand for `\jalipsum{jugemuP}`.
+
+### Notices for the TeX-programmers
+
+ * All the commands are fully expandable.
+ * The `\jalipsum` command is expanded to the actual text in two steps.
+ * The shorthand commands such as `\jalipsumiroha` are expanded to the
+ actual text in one step.
+ * Each of the paragraph texts consists only of character tokens and
+ optional `\\` (line-break) tokens.
+ * When `\jalipsum` with multiple paragraphs is expanded, each paragraph
+ is joined with `\par` tokens.
+
+Revision History
+----------------
+
+ * Version 0.2 〈2016/08/15〉
+ - The first public version.
+
+--------------------
+Takayuki YATO (aka. "ZR")
+http://zrbabbler.sp.land.to/
diff --git a/Master/texmf-dist/doc/latex/bxjalipsum/sample-bxjalipsum-1.tex b/Master/texmf-dist/doc/latex/bxjalipsum/sample-bxjalipsum-1.tex
new file mode 100644
index 00000000000..d316dfe298d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/bxjalipsum/sample-bxjalipsum-1.tex
@@ -0,0 +1,45 @@
+% LuaLaTeX document
+\documentclass[a4paper]{ltjsarticle}
+\usepackage{bxjalipsum}
+\begin{document}
+
+\section{iroha}
+
+% the Iroha sequence
+\jalipsumiroha
+
+\section{jugemu}
+
+\begin{flushright}
+
+% the person name in Jugemu
+\begin{parbox}[t]{12\zw}{%
+\jalipsumjugemu
+}%
+\end{parbox}
+\hspace{2cm}%
+\begin{parbox}[t]{12\zw}{%
+\jalipsumjugemuP
+}%
+\end{parbox}
+
+\end{flushright}
+
+\section{wagahai}
+
+% "Wagahai wa Neko de aru" by Natsume Soseki
+\begin{itemize}
+\item \jalipsum[-2]{wagahai}
+\item \jalipsum[3-4]{wagahai}
+\item \jalipsum[5]{wagahai}
+\end{itemize}
+
+\section{hatsukoi}
+
+% "Hatsukoi" by Shimazaki Toson
+\begin{quote}
+\addtolength{\parskip}{\baselineskip}
+\jalipsum{hatsukoi}
+\end{quote}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/bxjalipsum/sample-bxjalipsum-2.tex b/Master/texmf-dist/doc/latex/bxjalipsum/sample-bxjalipsum-2.tex
new file mode 100644
index 00000000000..bd6344e6dc7
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/bxjalipsum/sample-bxjalipsum-2.tex
@@ -0,0 +1,25 @@
+% upLaTeX document
+\documentclass[uplatex,a4paper]{jsarticle}
+\usepackage{bxjalipsum}
+\usepackage{plext}% for '\bou' command
+%!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! TeX code BEGIN
+% with a bit of TeXnique...
+%% Expand 'em all!!
+\edef\wagahaiOne{\jalipsum[1]{wagahai}}
+\edef\wagahaiTwo{\jalipsum[2-5]{wagahai}}
+%% \argexpd\CMD{<argument>}
+\def\argexpd#1{\expandafter#1\expandafter}
+%!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! TeX code END
+\begin{document}
+
+% rather nonsensical examples
+% (The \bou command add "bouten" to the given text.)
+
+\argexpd\bou{\jalipsumiroha}
+
+\argexpd\bou{\wagahaiOne}
+
+% NB. The meaning of \wagahaiTwo contains \par, so it is
+% not suitable for \bou.
+
+\end{document}