blob: da80c5dd56ad39a8628f1ec7f8417078a1496833 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
|
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: pdfTeX / 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.
- `kusamakura` (13 paragraphs): The opening passage from the novel
"草枕" (Kusamakura) written by Natsume Soseki.
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 on use with pdfTeX
* In using with pdfTeX, Japanese (non-ASCII) characters are represented
as UTF-8 byte sequences. Thus there must be some mechanism (such as
the CJKutf8 package) that will decode such sequences and display the
Japanese characters properly.
### 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.3a ‹2017/03/01›
- Added text “kusamakura”.
* Version 0.3 ‹2016/11/06›
- Added the support for pdfTeX.
* Version 0.2 ‹2016/08/15›
- The first public version.
--------------------
Takayuki YATO (aka. "ZR")
http://zrbabbler.sp.land.to/
|
