From 156716e3385bbc263517b2aa496ef5e80edb93a9 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 24 Sep 2018 20:25:06 +0000 Subject: bxwareki (24sep18) git-svn-id: svn://tug.org/texlive/trunk@48752 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/bxwareki/LICENSE | 21 +++ Master/texmf-dist/doc/latex/bxwareki/README.md | 176 +++++++++++++++++++++++++ 2 files changed, 197 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/bxwareki/LICENSE create mode 100644 Master/texmf-dist/doc/latex/bxwareki/README.md (limited to 'Master/texmf-dist/doc') diff --git a/Master/texmf-dist/doc/latex/bxwareki/LICENSE b/Master/texmf-dist/doc/latex/bxwareki/LICENSE new file mode 100644 index 00000000000..fbe40a0146b --- /dev/null +++ b/Master/texmf-dist/doc/latex/bxwareki/LICENSE @@ -0,0 +1,21 @@ +The MIT License + +Copyright (c) 2018 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/bxwareki/README.md b/Master/texmf-dist/doc/latex/bxwareki/README.md new file mode 100644 index 00000000000..637f814a7b7 --- /dev/null +++ b/Master/texmf-dist/doc/latex/bxwareki/README.md @@ -0,0 +1,176 @@ +BXwareki Package +================ + +LaTeX: Support for Japanese calendar + +This package provides commands to convert from the Gregorian calendar +(2018/8/28) to the Japanese rendering of the Japanese calendar (Heisei +30 nen 8 gatsu 28 nichi; actually with kanji characters). You can choose +whether the numbers are written in Western numerals or kanji numerals. + +Note that the package only deals with dates in the year 1873 or later, +where the Japanese calendar is really a Gregorian calendar with the +different notation of years. + +### System requirement + + * TeX format: LaTeX. + * TeX engine: pdfTeX, LuaTeX, XeTeX, pTeX, upTeX, ApTeX (pTeX-ng), + and NTT-jTeX. (The e-TeX extension is not needed.) + +### Installation + + - `*.sty`, `*.def` → $TEXMF/tex/latex/BXwareki + +### License + +This package is distributed under the MIT License. + + +The bxwareki Package ― main +---------------------------- + +Note: The modern (post-1873) Japanese calendar (*wareki*; 和暦) can be +regarded as a variant of Gregorian calendar where only the notation of +years differs from the original. To avoid confusion, this document refers +to the original Gregorian calendar as the *Western calendar*, which +corresponds to the Japanese term *seireki* (西暦). + +### Package Loading + + \usepackage{bxwareki} + +### Usage + +#### Conversion from the given date + + * `\warekisetdate{}{}{}`: Converts from the specified + Western date. The result will be rendered by the commands described + at the following items, where the result for the invocation + `\warekisetdate{2018}{8}{28}` will be shown as example. + + Note: Although the Japanese calendar differs from the Western calendar + only in the notation of years, the value of months and days are still + required, since the notation of the year in which *kaigen* (改元; + change of gengo) occurs depends on months and days. + + * `\warekisettoday`: Does `\warekisetdate` with the current date. + + * Counter `warekiyear`: The year number (within the gengo); e.g. 30. + + Note: Unlike ordinary counters, the assignment to `warekiyear` by + `\warekisetdate` is *local*. Moreover, manual assignment to this + counter is not supported. + + * `\warekigengo`: The gengo in kanji, e.g. “平成”. + + * `\warekiyear`: The full notation of the year (without ‘年’), + e.g. “平成30”. + + Note: When the year number is one, the kanji ‘元’ is used instead + of the numeral ‘1’. + + * `\warekidate`: The date string, e.g. “平成30年8月28日”. + + * `\warekikanjidate`: The date string using kansuji (kanji numerals), + e.g. “平成三〇年八月二八日”. + + * `\warekijkanjidate`: The date string using “kansuji-by-reading” + (that is, kanji rendering of numbers in the Japanese language), + e.g. “平成三十年八月二十八日”. + + * `\warekicustomdate{