texlive[57025] Master/texmf-dist: bxjaholiday (28nov20)
commits+karl at tug.org
commits+karl at tug.org
Sat Nov 28 22:42:55 CET 2020
Revision: 57025
http://tug.org/svn/texlive?view=revision&revision=57025
Author: karl
Date: 2020-11-28 22:42:55 +0100 (Sat, 28 Nov 2020)
Log Message:
-----------
bxjaholiday (28nov20)
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/latex/bxjaholiday/LICENSE
trunk/Master/texmf-dist/doc/latex/bxjaholiday/README.md
trunk/Master/texmf-dist/doc/latex/bxjaholiday/bxjaholiday.pdf
trunk/Master/texmf-dist/doc/latex/bxjaholiday/bxjaholiday.tex
trunk/Master/texmf-dist/tex/latex/bxjaholiday/bxjaholiday.sty
Added Paths:
-----------
trunk/Master/texmf-dist/doc/latex/bxjaholiday/bxjaholiday-ja.pdf
trunk/Master/texmf-dist/doc/latex/bxjaholiday/bxjaholiday-ja.tex
Modified: trunk/Master/texmf-dist/doc/latex/bxjaholiday/LICENSE
===================================================================
--- trunk/Master/texmf-dist/doc/latex/bxjaholiday/LICENSE 2020-11-28 01:32:41 UTC (rev 57024)
+++ trunk/Master/texmf-dist/doc/latex/bxjaholiday/LICENSE 2020-11-28 21:42:55 UTC (rev 57025)
@@ -1,6 +1,6 @@
The MIT License (MIT)
-Copyright 2018 Takuto ASAKURA (wtsnjp)
+Copyright 2018-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
Modified: trunk/Master/texmf-dist/doc/latex/bxjaholiday/README.md
===================================================================
--- trunk/Master/texmf-dist/doc/latex/bxjaholiday/README.md 2020-11-28 01:32:41 UTC (rev 57024)
+++ trunk/Master/texmf-dist/doc/latex/bxjaholiday/README.md 2020-11-28 21:42:55 UTC (rev 57025)
@@ -1,4 +1,4 @@
-# BXjaholiday Package
+# The BXjaholiday Package
LaTeX: Support for Japanese holidays
@@ -47,6 +47,9 @@
## Revision History
+* Version 1.1.0 ‹2020/11/28›
+ * Add Japanese documentation
+ * Support special cases in 2021
* Version 1.0.0 ‹2019/02/03›
* Add documentation
* Rename `\g_bxjh_sport_tl` -> `\g_bxjh_sports_tl`
Added: trunk/Master/texmf-dist/doc/latex/bxjaholiday/bxjaholiday-ja.pdf
===================================================================
(Binary files differ)
Index: trunk/Master/texmf-dist/doc/latex/bxjaholiday/bxjaholiday-ja.pdf
===================================================================
--- trunk/Master/texmf-dist/doc/latex/bxjaholiday/bxjaholiday-ja.pdf 2020-11-28 01:32:41 UTC (rev 57024)
+++ trunk/Master/texmf-dist/doc/latex/bxjaholiday/bxjaholiday-ja.pdf 2020-11-28 21:42:55 UTC (rev 57025)
Property changes on: trunk/Master/texmf-dist/doc/latex/bxjaholiday/bxjaholiday-ja.pdf
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/pdf
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/latex/bxjaholiday/bxjaholiday-ja.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/bxjaholiday/bxjaholiday-ja.tex (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/bxjaholiday/bxjaholiday-ja.tex 2020-11-28 21:42:55 UTC (rev 57025)
@@ -0,0 +1,263 @@
+% +++
+% latex = "uplatex"
+% extra_clean_files = [
+% "%B.dvi", "%B.synctex.gz", "%B.hd", "%B.glo"
+% ]
+% +++
+\documentclass[uplatex,dvipdfmx]{wtpl3doc}
+
+% packages
+\usepackage[verb]{bxghost}
+\usepackage{bxjaholiday}
+\usepackage{caption}
+
+% logos
+\usepackage{bxtexlogo}
+\bxtexlogoimport{*}
+
+% syntax
+\newenvironment{code}{\quote\small}{\endquote}
+
+% cross-refs
+\usepackage{wtref}
+\newref{tab,sec}
+
+% macros
+\newcommand{\PkgName}{\pkg{bxjaholiday}}
+\newcommand{\Ie}{i.\,e.}
+\newcommand{\Eg}{e.\,g.}
+
+\ExplSyntaxOn
+\cs_set_eq:NN \_ \c_underscore_str
+\cs_new:Npn \__bxjh_doc_holiday_line:nn #1#2
+ {
+ % first column: holiday
+ \tl_use:c { g_bxjh_#2_tl } &
+ % second column: variable
+ \cs { g_bxjh_#2_tl } \\
+ }
+\cs_new:Npn \__bxjh_doc_week_of_day_line:nn #1#2
+ {
+ % first column: week of day
+ \tl_use:c { g_bxjh_#2_tl } &
+ % second column: int variable
+ \cs { c_bxjh_ \tl_lower_case:n{ #1 } _int } &
+ % third column: int value
+ \int_use:c { c_bxjh_ \tl_lower_case:n{ #1 } _int } &
+ % fourth column: tl variable
+ \cs { g_bxjh_#2_tl } &
+ % fifth column: tl value
+ \tl_use:c { g_bxjh_#2_tl } \\
+ }
+\cs_new_eq:NN \HolidayLine \__bxjh_doc_holiday_line:nn
+\cs_new_eq:NN \WeekofdayLine \__bxjh_doc_week_of_day_line:nn
+\ExplSyntaxOff
+
+% metadata
+\GetFileInfo{bxjaholiday.sty}
+\title{{\PkgName}パッケージ}
+\author{朝倉卓人 (wtsnjp)}
+\date{\fileversion \quad [\filedate]}
+
+\begin{document}
+
+\maketitle
+
+\begin{abstract}
+このパッケージは日付から日本の祝日名を得るためのコマンドと，その副産物である
+日付から曜日を取得するコマンドを提供する．expl3向けには，これらのコマンドと
+同等の機能を有する関数と，追加の低級関数も用意されている．
+\end{abstract}
+
+%\tableofcontents
+
+\begin{documentation}
+
+%\section{Introduction}
+
+\section{動作要件}
+
+BXプレフィックス\footnote{BXシリーズは主として八登祟之 (a.k.a.~ZR) 氏によって
+開発されている\LaTeX パッケージ群である．``BX'' は ``\underline{b}abel
+e\underline{x}tensions'' を意味し，BXシリーズに含まれるパッケージは通常，日本語
+に特化したもの（\pTeX 系列）に限らず多様な\TeX 処理系をサポートしている．}の示す
+通り，本パッケージは様々な\TeX 処理系のサポートを意図しており，expl3がサポート
+するすべての\TeX 処理系をサポートしている（つまり\eTeX 拡張は必要である）．
+具体的には以下のシステムがサポートされている：
+%
+\begin{itemize}
+\item \TeX フォーマット：\LaTeXe
+\item \TeX 処理系：{\pdfTeX}, {\XeTeX}, {\LuaTeX},\footnote{\pTeX 系列以外の
+処理系で和文文字を表示するには，別途フォントやその他の設定を行う必要がある．}
+{\pTeX}, {\upTeX}
+\end{itemize}
+
+\section{パッケージ読み込み}
+
+本パッケージの読み込みは\LaTeXe の標準的な方法で行う．オプションは存在しない．
+%
+\begin{code}
+|\usepackage{bxjaholiday}|
+\end{code}
+
+\section{{\LaTeXe}インターフェース}
+
+\begin{function}[EXP]{\jaholidayname}
+\begin{syntax}
+|\jaholidayname|\marg{year}\marg{month}\marg{day}
+\end{syntax}
+%
+与えられた日付が日本の祝日に該当する場合，その祝日の名前に展開される．日付が
+祝日でない場合は展開後には何も残らない（空のトークンに展開される）．
+表\tabref{holidays}に展開結果となり得る祝日名の一覧を示す．
+
+引数の\meta{year}, \meta{month}, \meta{day}には明示的な数値またはカウンタ
+（例えば|\year|, |\month|, |\day|）を与えることができる．正確には，任意の
+\meta{integer expression}が許される．
+\end{function}
+
+\begin{function}[EXP]{\jadayofweek}
+\begin{syntax}
+|\jadayofweek|\marg{year}\marg{month}\marg{day}
+\end{syntax}
+%
+日付を曜日名（月・火・水・木・金・土・日のいずれか）に変換する．
+引数の仕様は|\jaholidayname|と同一である．
+\end{function}
+
+\begin{function}[EXP]{\IfJaHolidayTF,\IfJaHolidayT,\IfJaHolidayF}
+\begin{syntax}
+|\IfJaHolidayTF|\marg{year}\marg{month}\marg{day}\marg{true code}\marg{false code}
+|\IfJaHolidayT|\marg{year}\marg{month}\marg{day}\marg{true code}
+|\IfJaHolidayF|\marg{year}\marg{month}\marg{day}\marg{false code}
+\end{syntax}
+%
+祝日か否かの判定を行う．なお，この条件分岐では振替休日も祝日として扱われる．
+\end{function}
+
+\section{expl3インターフェース}
+
+本パッケージが提供するすべてのインターフェースは\texttt{bxjh}モジュールに属する．
+
+\subsection{関数}
+
+\begin{function}[EXP]{\bxjh_holiday_name:nnn}
+\begin{syntax}
+|\bxjh_holiday_name:nnn| \marg{year} \marg{month} \marg{day}
+\end{syntax}
+%
+|\jaholidayname|のexpl3関数版である．日付を祝日名に変換する．
+\end{function}
+
+\begin{function}[EXP]{\bxjh_day_of_week_name:nnn,\bxjh_day_of_week:nnn}
+\begin{syntax}
+|\bxjh_day_of_week_name:nnn| \marg{year} \marg{month} \marg{day}
+|\bxjh_day_of_week:nnn| \marg{year} \marg{month} \marg{day}
+\end{syntax}
+%
+|\bxjh_day_of_week_name:nnn|は|\jadayofweek|のexpl3関数版で，日付を曜日名に変換
+する．曜日の情報をexpl3内で利用したい場合（例えば条件分岐したい場合）には
+|\bxjh_day_of_week:nnn|を用いるのがより適切である．この関数は内部的な
+整数値 (\texttt{int}) を返す．この値は本パッケージが提供する定数と比較することが
+できる（\secref{variables}節参照）．
+\end{function}
+
+\begin{function}[EXP,TF]{\bxjh_if_holiday:nnn}
+\begin{syntax}
+|\bxjh_if_holiday:nnnTF| \marg{year} \marg{month} \marg{day} \marg{true code} \marg{false code}
+\end{syntax}
+%
+|\IfJaHoliday(TF)|のexpl3関数版である．
+\end{function}
+
+\begin{function}[EXP]{\bxjh_apply_prev_day:Nnnn,\bxjh_apply_next_day:Nnnn}
+\begin{syntax}
+|\bxjh_apply_prev_day:Nnnn| \meta{function} \marg{year} \marg{month} \marg{day}
+|\bxjh_apply_next_day:Nnnn| \meta{function} \marg{year} \marg{month} \marg{day}
+\end{syntax}
+%
+これらの関数は与えられた日付の前日または翌日の日付に\meta{function}を適用する．
+\meta{function}は3つの引数を，年月日の順にとる関数である必要がある．例えば
+%
+\begin{code}
+|\bxjh_apply_next_day:Nnnn \bxjh_holiday_name:nnn { 2019 } { 12 } { 31 }|
+\end{code}
+%
+は以下と同じ結果となる：
+%
+\begin{code}
+|\bxjh_holiday_name:nnn { 2020 } { 1 } { 1 }|
+\end{code}
+\end{function}
+
+\subsection{変数と定数}\seclabel{variables}
+
+\paragraph{祝日名}
+
+すべてグローバルな\texttt{tl}型変数として提供される（表\tabref{holidays}）．
+%
+\begin{table}[b]
+\centering\small
+\caption{日本の祝日}
+\tablabel{holidays}
+\begin{tabular}{ll}
+\hline
+祝日名 & 変数 \\ \hline
+\HolidayLine{New Year's Day}{ganjitsu}
+\HolidayLine{Coming of Age Day}{seijin}
+\HolidayLine{National Foundation Day}{kenkoku}
+\HolidayLine{The Emperor's Birthday}{tennou}
+\HolidayLine{Vernal Equinox Day}{shunbun}
+\HolidayLine{Showa Day}{showa}
+\HolidayLine{Greenery Day}{midori}
+\HolidayLine{Constitution Memorial Day}{kenpou}
+\HolidayLine{National Holiday}{kokumin}
+\HolidayLine{Children's Day}{kodomo}
+\HolidayLine{(substitute holiday)}{furikae}
+\HolidayLine{Marine Day}{umi}
+\HolidayLine{Mountain Day}{yama}
+\HolidayLine{Autumnal Equinox Day}{shubun}
+\HolidayLine{Respect for the Aged Day}{keirou}
+\HolidayLine{Sports Day}{sports}
+\HolidayLine{Health and Sports Day}{taiiku}
+\HolidayLine{Culture Day}{bunka}
+\HolidayLine{Labor Thanksgiving Day}{kinrou}
+\HolidayLine{National Mourning of Showa}{showa\_taisou}
+\HolidayLine{National Wedding of Akihito}{akihito\_kekkon}
+\HolidayLine{National Wedding of Naruhito}{naruhito\_kekkon}
+\HolidayLine{Core Enthronement Ceremony}{sokuirei}
+\HolidayLine{Coronation Day}{sokui}
+\hline
+\end{tabular}
+\end{table}
+
+\paragraph{曜日名}
+
+本パッケージは曜日を表す際，内部的には整数値を用いている．これらの内部整数値に
+対応する\texttt{int}型の定数が定義されている．また各曜日名を格納するグローバル
+\texttt{tl}変数も提供されている（表\tabref{dayofweek}）．
+%
+\begin{table}[b]
+\centering\small
+\caption{曜日}
+\tablabel{dayofweek}
+\begin{tabular}{c|lr|ll}
+\hline
+曜日 & 定数 (\texttt{int}) & & 変数 (\texttt{tl}) & \\ \hline
+\WeekofdayLine{Monday}{getsu}
+\WeekofdayLine{Tuesday}{ka}
+\WeekofdayLine{Wednesday}{sui}
+\WeekofdayLine{Thursday}{moku}
+\WeekofdayLine{Friday}{kin}
+\WeekofdayLine{Saturday}{do}
+\WeekofdayLine{Sunday}{nichi}
+\hline
+\end{tabular}
+\end{table}
+
+\end{documentation}
+
+%\PrintChanges
+
+\end{document}
+% vim: spell:
Property changes on: trunk/Master/texmf-dist/doc/latex/bxjaholiday/bxjaholiday-ja.tex
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/Master/texmf-dist/doc/latex/bxjaholiday/bxjaholiday.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/bxjaholiday/bxjaholiday.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/bxjaholiday/bxjaholiday.tex 2020-11-28 01:32:41 UTC (rev 57024)
+++ trunk/Master/texmf-dist/doc/latex/bxjaholiday/bxjaholiday.tex 2020-11-28 21:42:55 UTC (rev 57025)
@@ -1,4 +1,9 @@
-%#!xelatex
+% +++
+% latex = "xelatex"
+% extra_clean_files = [
+% "%B.synctex.gz", "%B.hd", "%B.glo"
+% ]
+% +++
\RequirePackage{fontspec}
\documentclass{l3doc}
@@ -37,9 +42,9 @@
% third column: Name in Japanese
\Ja { \tl_use:c { g_bxjh_#2_tl } } \\
}
-\cs_new:Npn \__bxjh_doc_week_of_day:nn #1#2
+\cs_new:Npn \__bxjh_doc_week_of_day_line:nn #1#2
{
- % first column: holiday
+ % first column: week of day
#1 &
% second column: int variable
\cs { c_bxjh_ \tl_lower_case:n{ #1 } _int } &
@@ -51,7 +56,7 @@
\Ja { \tl_use:c { g_bxjh_#2_tl } } \\
}
\cs_new_eq:NN \HolidayLine \__bxjh_doc_holiday_line:nn
-\cs_new_eq:NN \WeekofdayLine \__bxjh_doc_week_of_day:nn
+\cs_new_eq:NN \WeekofdayLine \__bxjh_doc_week_of_day_line:nn
\ExplSyntaxOff
% metadata
@@ -85,7 +90,7 @@
As one of the BX series\footnote{BX series is a collection of {\LaTeX} packages
mainly developed by Takayuki YATO (a.k.a.~ZR.) ``BX'' stands for
-``\underline{b}abel e\underline{x}tensions'' and packages in this series are
+``\underline{b}abel e\underline{x}tensions'' and packages in this series
normally support various {\TeX} engines not only Japanese-specific ones
({\pTeX}, {\upTeX}, and so on.)} packages, {\PkgName} supports all {\TeX}
engines which supported by expl3 (\Ie, the {\eTeX} extension is required.)
@@ -231,7 +236,7 @@
\HolidayLine{(substitute holiday)}{furikae}
\HolidayLine{Marine Day}{umi}
\HolidayLine{Mountain Day}{yama}
-\HolidayLine{Autumnal Equinox Day}{shunbun}
+\HolidayLine{Autumnal Equinox Day}{shubun}
\HolidayLine{Respect for the Aged Day}{keirou}
\HolidayLine{Sports Day}{sports}
\HolidayLine{Health and Sports Day}{taiiku}
@@ -248,6 +253,8 @@
\paragraph{Day of week}
+\enlargethispage{5mm}
+
Internally, {\PkgName} uses integers to represent day of week, and corresponding
\texttt{int} constants are defined. In addition to that, Japanese names of those
are also provided as global \texttt{tl} variables. See
Modified: trunk/Master/texmf-dist/tex/latex/bxjaholiday/bxjaholiday.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/bxjaholiday/bxjaholiday.sty 2020-11-28 01:32:41 UTC (rev 57024)
+++ trunk/Master/texmf-dist/tex/latex/bxjaholiday/bxjaholiday.sty 2020-11-28 21:42:55 UTC (rev 57025)
@@ -1,7 +1,7 @@
%%
%% This is file 'bxjaholiday.sty'.
%%
-%% Copyright 2018 Takuto ASAKURA (wtsnjp)
+%% Copyright 2018-2020 Takuto ASAKURA (wtsnjp)
%% GitHub: https://github.com/wtsnjp
%% Twitter: @wtsnjp
%%
@@ -13,7 +13,7 @@
% -------------------------------------------------- declarations
\RequirePackage{expl3}
-\ProvidesExplPackage {bxjaholiday} {2019/02/03} {1.0.0}
+\ProvidesExplPackage {bxjaholiday} {2020/11/28} {1.1.0}
{Support for Japanese holidays}
% -------------------------------------------------- utilities
@@ -23,7 +23,7 @@
\cs_new_eq:Nc \__bxjh_only_preamble:N { @onlypreamble }
% short hands
-%% \__bxjh_int_compare_and:nn(TF) { <intexpr1> } { <intexpr2> }
+%% \__bxjh_int_compare_and:nn(TF) { <integer relation1> } { <integer relation2> }
%% ( { <true code> } ) ( { <false code> } )
\prg_new_conditional:Npnn \__bxjh_int_compare_and:nn #1#2 { T, TF }
{
@@ -111,8 +111,8 @@
{
\cs_new:Npn \__bxjh_add_jchar_dec:nnn #1#2#3
{
- \ptex_kansujichar:D \c_one_int = \ptex_jis:D "#3 \scan_stop:
- \__bxjh_next:n { \ptex_kansuji:D \c_one_int }
+ \tex_kansujichar:D \c_one_int = \tex_jis:D "#3 \scan_stop:
+ \__bxjh_next:n { \tex_kansuji:D \c_one_int }
}
}
@@ -120,8 +120,8 @@
{
\cs_new:Npn \__bxjh_add_jchar_dec:nnn #1#2#3
{
- \ptex_kansujichar:D \c_one_int = \ptex_jis:D "#3 \scan_stop:
- \__bxjh_next:n { \ptex_kansuji:D \c_one_int }
+ \tex_kansujichar:D \c_one_int = \tex_jis:D "#3 \scan_stop:
+ \__bxjh_next:n { \tex_kansuji:D \c_one_int }
}
}
@@ -636,7 +636,7 @@
{ \g_bxjh_kenkoku_tl }
{
\__bxjh_int_compare_and:nnTF { #3 = 23 } { #1 > 2019 }
- { \g_bxjh_tennou_tl } % the "next" era (2020-)
+ { \g_bxjh_tennou_tl } % the Reiwa period
{
\__bxjh_date_compare:nnnNnnnT
{ #1 } { #2 } { #3 } = { 1989 } { 2 } { 24 }
@@ -736,7 +736,7 @@
{ 7 } % July
{
- \int_compare:nNnTF { #1 } > { 2020 }
+ \int_compare:nNnTF { #1 } > { 2021 }
{
\__bxjh_int_compare_and:nnT % third Monday
{ \int_div_truncate:nn { #3 - 1 } { 7 } = 2 }
@@ -758,19 +758,31 @@
}
}
{
- \int_compare:nNnTF { #1 } > { 2002 }
+ \int_compare:nNnTF { #1 } = { 2021 }
{
- \__bxjh_int_compare_and:nnT % third Monday
- { \int_div_truncate:nn { #3 - 1 } { 7 } = 2 }
+ % 2021 Tokyo Olympic year: special case
+ \int_compare:nNnTF { #3 } = { 22 }
+ { \g_bxjh_umi_tl }
{
- \bxjh_day_of_week:nnn { #1 } { #2 } { #3 }
- = \c_bxjh_monday_int
+ \int_compare:nNnT { #3 } = { 23 }
+ { \g_bxjh_sports_tl }
}
- { \g_bxjh_umi_tl }
}
{
- \__bxjh_int_compare_and:nnT { #1 > 1995 } { #3 = 20 }
- { \g_bxjh_umi_tl }
+ \int_compare:nNnTF { #1 } > { 2002 }
+ {
+ \__bxjh_int_compare_and:nnT % third Monday
+ { \int_div_truncate:nn { #3 - 1 } { 7 } = 2 }
+ {
+ \bxjh_day_of_week:nnn { #1 } { #2 } { #3 }
+ = \c_bxjh_monday_int
+ }
+ { \g_bxjh_umi_tl }
+ }
+ {
+ \__bxjh_int_compare_and:nnT { #1 > 1995 } { #3 = 20 }
+ { \g_bxjh_umi_tl }
+ }
}
}
}
@@ -778,7 +790,7 @@
{ 8 } % August
{
- \int_compare:nNnTF { #1 } > { 2020 }
+ \int_compare:nNnTF { #1 } > { 2021 }
{
\int_compare:nNnT { #3 } = { 11 }
{ \g_bxjh_yama_tl }
@@ -791,8 +803,16 @@
{ \g_bxjh_yama_tl }
}
{
- \__bxjh_int_compare_and:nnT { #1 > 2015 } { #3 = 11 }
- { \g_bxjh_yama_tl }
+ \int_compare:nNnTF { #1 } = { 2021 }
+ {
+ % 2021 Tokyo Olympic year: special case
+ \int_compare:nNnT { #3 } = { 8 }
+ { \g_bxjh_yama_tl }
+ }
+ {
+ \__bxjh_int_compare_and:nnT { #1 > 2015 } { #3 = 11 }
+ { \g_bxjh_yama_tl }
+ }
}
}
}
More information about the tex-live-commits
mailing list.