スタイルファイルとは、LaTeXのマクロパッケージのことで、ドキュメントクラス（<code>.cls</code>）やパッケージ（<code>.sty</code>）もその一種です。スタイルファイルを使うことで、同じコマンドを複数の文書で使い回せるようになります。
<aside class="msg message">!<div class="msg-content">
筆者の環境はTeXLive 2020です。
</div></aside>
<h1 id="%E6%9B%B8%E3%81%8D%E6%96%B9">
<a class="header-anchor-link" href="#%E6%9B%B8%E3%81%8D%E6%96%B9" aria-hidden="true"></a> 書き方</h1>
jsclasses<a href="#fn-3b60-1" id="fnref-3b60-1">[1]</a>などは、DOCSTRIP というプログラムを使って、
<ol>
<li>コードに説明が付いた<code>.dtx</code>ファイルを作成</li>
<li>
<code>.dtx</code>ファイルをコンパイルして、説明付きPDFと<code>.sty</code>ファイルを出力</li>
</ol>
のようにして作成されています。しかし、このやり方は複雑なので、<code>.sty</code>ファイルを直に書く方法を紹介します。
スタイルファイルの中身はプリアンブルと同じように書くことができますが、<code>\makeatletter</code>や<code>\makeatother</code>を書く必要はありません。
以上の事を踏まえたスタイルファイルは次のようになります。
<div class="code-block-container">
<div class="code-block-filename-container">mypkg.sty</div>
<pre class="language-latex"><code class="language-latex">% パッケージの読み込み
\usepackage{graphicx}

% jlreqの見出しをカスタマイズ
\NewBlockHeading{section}{1}{%
 font={\normalfont\fontsize{32Q}{32H}\bfseries},
 before_space=0mm,
 after_space=8mm,
 align=left
}
</code></pre>
</div>このスタイルファイルをパッケージとして呼ぶには、このスタイルファイルを使いたいソースのプリアンブルに、
<div class="code-block-container"><pre class="language-latex"><code class="language-latex">\usepackage{mypkg}
</code></pre></div>のように書きます。
<h1 id="%E3%82%B9%E3%82%BF%E3%82%A4%E3%83%AB%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E5%90%91%E3%81%91%E3%81%AE%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89">
<a class="header-anchor-link" href="#%E3%82%B9%E3%82%BF%E3%82%A4%E3%83%AB%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E5%90%91%E3%81%91%E3%81%AE%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89" aria-hidden="true"></a> スタイルファイル向けのコマンド</h1>
スタイルファイルで使うと便利、もしくは使われてるのを見かけるコマンドです。
<ul>
<li>
<code>\NeedsTeXFormat{LaTeX2e}</code><a href="#fn-3b60-2" id="fnref-3b60-2">[2]</a> 
必要なLaTeXの形態として<code>LaTeX2e</code>を指定します。<code>LaTeX2e</code>の代わりに<code>pLaTeX2e</code>などを指定することもできます。</li>
<li>
<code>\ProvidesPackage{&lt;パッケージ名&gt;}[&lt;日付&gt;]</code> 
パッケージの名前を定義します。<code>&lt;日付&gt;</code>よりLaTeXのバージョンが古い場合に警告を出すことができます。<code>&lt;日付&gt;</code>は、<code>2020/12/28</code>のように指定します。</li>
<li>
<code>\ProvidesClass{&lt;クラス名&gt;}[&lt;日付&gt;]</code> 
クラスの名前を定義します。他は<code>\ProvidesPackage</code>と同じです。</li>
<li>
<code>\LoadClass[&lt;オプション&gt;]{&lt;クラス名&gt;}</code> 
クラスを読み込みます。自分用のクラスを作る時に便利で、これを使うと最初の例は以下のようになります。<div class="code-block-container">
<div class="code-block-filename-container">mycls.cls</div>
<pre class="language-latex"><code class="language-latex">\LoadClass{jlreq}
\RequirePackage{graphicx}
\NewBlockHeading{section}{1}{%
 font={\normalfont\fontsize{32Q}{32H}\bfseries},
 before_space=0mm,
 after_space=8mm,
 align=left
}
</code></pre>
</div>
<div class="code-block-container"><pre class="language-latex"><code class="language-latex">\documentclass{mycls}
</code></pre></div>
</li>
<li>
<code>\endinput</code> 
この命令よりも後の記述を無視します。</li>
</ul>
さらに詳しい内容を知りたい方は、<a href="https://qiita.com/takahashim/items/5fcc68fbc8a3eca42f07" target="_blank" rel="nofollow noopener noreferrer">クラス・パッケージ作者のためのLaTeX 2ε（抄訳）</a>を読んでみてください。
<h1 id="tex-live%E3%81%AB%E8%AA%8D%E8%AD%98%E3%81%95%E3%81%9B%E3%82%8B">
<a class="header-anchor-link" href="#tex-live%E3%81%AB%E8%AA%8D%E8%AD%98%E3%81%95%E3%81%9B%E3%82%8B" aria-hidden="true"></a> TeX Liveに認識させる</h1>
スタイルファイルを作っただけでは、そのディレクトリ<a href="#fn-3b60-3" id="fnref-3b60-3">[3]</a>以外で使うことが出来ません。そこで、TeX Liveに認識させます。
TeX Liveでユーザーのスタイルファイルを入れるディレクトリは<code>$TEXMFLOCAL/tex/latex/</code>、すなわち<code>texlive/texmf-local/tex/latex/</code>です<a href="#fn-3b60-4" id="fnref-3b60-4">[4]</a>。手順は以下のようになります。
<ol>
<li>前述のディレクトリにファイルを保存もしくはシンボリックリンクを作成</li>
<li>コマンドラインにて<code>mktexlsr</code>を実行（管理者権限が必要<a href="#fn-3b60-5" id="fnref-3b60-5">[5]</a>）</li>
</ol>
<h1 id="%E5%8F%82%E8%80%83%E8%B3%87%E6%96%99">
<a class="header-anchor-link" href="#%E5%8F%82%E8%80%83%E8%B3%87%E6%96%99" aria-hidden="true"></a> 参考資料</h1>
<ul>
<li>LaTeX2e美文書作成入門［改訂第7版］</li>
<li>独習LaTeX2e</li>
<li>TeX Liveガイド 2020</li>
<li><a href="https://latexref.xyz/_005cendinput.html" target="_blank" rel="nofollow noopener noreferrer">LaTeX2e unofficial manual</a></li>
</ul>
<hr>
この記事は以下のシリーズの一部です。
<iframe id="zenn-embedded__8e593b3594e2d" src="https://embed.zenn.studio/card#zenn-embedded__8e593b3594e2d" data-content="https%3A%2F%2Fzenn.dev%2Fhirospark%2Fscraps%2F549a0863ca408d" frameborder="0" scrolling="no" loading="lazy"></iframe><a href="https://zenn.dev/hirospark/scraps/549a0863ca408d" style="display:none" target="_blank">https://zenn.dev/hirospark/scraps/549a0863ca408d</a>
<section class="footnotes">
脚注
<ol class="footnotes-list">
<li id="fn-3b60-1" class="footnote-item">
<code>jsarticle</code>や<code>jsbook</code>などの「pLaTeX2e新ドキュメントクラス」のことです。 <a href="#fnref-3b60-1" class="footnote-backref">↩︎</a>
</li>
<li id="fn-3b60-2" class="footnote-item">
2021/04/14 誤植の指摘を受け修正しました。 <a href="#fnref-3b60-2" class="footnote-backref">↩︎</a>
</li>
<li id="fn-3b60-3" class="footnote-item">
いわゆるフォルダのことです（厳密には少し違います）。 <a href="#fnref-3b60-3" class="footnote-backref">↩︎</a>
</li>
<li id="fn-3b60-4" class="footnote-item">
スタイルファイルを入れることのできるディレクトリは他にもあります。詳細はTeX Liveガイドを参照してください。 <a href="#fnref-3b60-4" class="footnote-backref">↩︎</a>
</li>
<li id="fn-3b60-5" class="footnote-item">
Windowsなら管理者権限でコマンドプロンプトを起動してから実行してください。Unix系なら<code>sudo</code>を頭につけて実行してください。 <a href="#fnref-3b60-5" class="footnote-backref">↩︎</a>
</li>
</ol>
</section>

LaTeX のスタイルファイルを自作する

スタイルファイル向けのコマンド

hidaruma

HiroSpark

&lt;del&gt;\ProvideTeXFormat{&lt;バージョン&gt;}&lt;/del&gt;&lt;ins&gt;NeedsTeXFormat{&lt;バージョン&gt;}&lt;/ins&gt;でしょうか。
初めての方にむけてということはわかるんですが、ここで「バージョン」とするのもあまりよくなくて、 
具体的に「LaTeX2e」などを記述した例を載せておいて、他に「pLaTeX2e」なども有り得る、程度にして良いのではないかと思います。この段階でゼネラルなことを書こうとすると脱線が激しくなると思うので。 
（丁度よい代案はないのですが）たとえば美文書であればこの箇所入る文字列については「形態」と紹介していますね。

<blockquote>
&lt;del&gt;\ProvideTeXFormat{&lt;バージョン&gt;}&lt;/del&gt; 
&lt;ins&gt;NeedsTeXFormat{&lt;バージョン&gt;}&lt;/ins&gt;でしょうか。
</blockquote>
その通りです。ありがとうございます。
<blockquote>
この段階でゼネラルなことを書こうとすると脱線が激しくなると思うので。
</blockquote>
確かにそうですね。変更します。

<blockquote>
&lt;日付&gt;よりLaTeXのバージョンが古い場合に警告を出すことができます。
</blockquote>
<code>\ProvidesPackage</code>のこれはパッケージの要求バージョンですね。
LaTeX（LaTeX2e）のバージョン警告は\NeedsTeXFormat{LaTeX2e}[&lt;日付&gt;]とした場合で、こんな感じになります。
<div class="code-block-container"><pre class="language-latex"><code class="language-latex">% my.sty
\NeedsTeXFormat{LaTeX2e}[2030/01/01]
\ProvidesPackage{my}[1970/04/01]
</code></pre></div><div class="code-block-container"><pre class="language-latex"><code class="language-latex">\documentclass{article}
\usepackage{my}[2021/04/14]
</code></pre></div><div class="code-block-container"><pre class="language-cmd"><code class="language-cmd">$ lualatex tes.tex
...
LaTeX Warning: You have requested release `2030/01/01' of LaTeX,
 but only release `2020-10-01' is available.

)

LaTeX Warning: You have requested, on input line 2, version
 `2021/04/01' of package my,
 but only version
 `1970/04/01'
 is available.
</code></pre></div>

Discussion