WORDの記事の雛形

• subfilesパッケージにより、texファイル入稿の形態へと変更
• usepackageはarticle-template 直下の main.tex を編集する
• デフォルトの処理系をLuaLaTeXへと変更
• 記事タイトル周辺のコマンドの変更

ビルド時にぶっこわれが発生する場合、 pLaTeX専用パッケージを利用しようとしていないかを疑ってみましょう。

全体ビルド時にぶっこわれが発生する場合、前に置いてある記事で変更された コマンドがないかなどを確認しましょう。

必要なもの

• Git
• TeXLiveまたはMacTeX
• GNU Make

編集の仕方

0. ブランチを切る

記事を入れるディレクトリ名に合わせてGitのブランチを切ります。 記事のディレクトリをmy_articleとしたら、次のように切ってブランチを移動しましょう。

git branch articles/my_article
git switch articles/my_article

注意する点として、 article s である点です。 article だとCIが走らないので気を付けてください。

1. 記事のディレクトリを作る

articlesフォルダのhinagataをコピーして、任意の名前をつけます。 このときの名前はなんでも構いませんが日本語を使うとややこしくなるのでやめましょう。 このときのディレクトリ名をここではmy_articleとしたとして話をすすめます。

2. 記事を目次に加える

リポジトリ直下にあるmain.texを見てみましょう。ファイル中盤に次のような記述があるはずです。

% 記事（サンプル）
\article{./articles/hinagata}

% 裏表紙
\article{./articles/back_cover}

パスの部分を次のように自分の記事のディレクトリに変更した\articleコマンドを挿入します。

 % 記事（サンプル）
 \article{./articles/hinagata}

+\article{./articles/my_article}

 % 裏表紙
 \article{./articles/back_cover}

3. 記事を編集する

手順（1）で作成したディレクトリの中にあるファイル ./articles/my_article/main.texを編集することで、記事をつくれます。

記事内コマンド

document 環境内 で以下のコマンドが使えます。

• \articletitle{hoge} で記事タイトルの設定をします。
• \articleauthor{fuga} で著者の設定をします。
• \makearticletitle で記事タイトルと記事著者を表示します。

「文　編集部」の消し方

WORD編集部の人間ではない場合、著者の前に付く「文　編集部」を削除したくなると思います。 「文　編集部」は以下のコマンドを\begin{document}の直後に書くことで消せます。

\authormark{}

ヘッダの表示変更

通常記事タイトルがヘッダに表示されますが、これを変更する場合document環境内で 以下を叩いてください。

\articleheader{newheader}

パッケージの追加

article-template/main.tex のプリアンブルで\usepackageを行ってください。

参考文献の書式

BiBTeXを用いる場合、bibファイルはarticle-template 直下のmain.bib を編集する。 こだわりや調整の自信が無い場合、参考文献の表示は \bibbysection[heading=subbibnumbered] を用いる。

article-template/articles/my_article/main.tex

\begin{document}
...
情報太郎\cite{myarticle-taro}によれば、ここは
...


\bibbysection[heading=subbibnumbered]

\end{document}

article-template/main.bib

@proceedings{my_article-taro,
Title={Sugoi Ronbun},
Author={Taro Jhouho},
...
}

既定以外のフォントを用いる場合

docker側でフォントインストールとシステムへの反映処理が書かれているものとして、 WORDクラス元のbxjsクラスでluatexja-fontspecパッケージを読みこんでいるので、 article-template/main.tex のプリアンブルで以下のようにして追加する。 他の記事を壊さないよう、グルーピング（{}）して使用すること。

article-template/main.tex

\newfontfamily{\myfont}{Very Good Font}

\begin{docment}

article-template/articles/my_article/main.tex

\begin{document}
...

普通の文章。{\myfont ここからウルトラスーパー良いフォントで表示}

別にpdfをビルドしている場合

すでに別ビルドしたpdfがある場合、 hinagata-import-pdfをコピーして同様に進めてください。 別ビルドのpdfではページ番号とヘッダを使わないようにしてください。 wordクラスを使う場合、documentclassのオプションにnoheaderとnopagenumberを 設定します。 articletitleとarticleauthorを設定し \makenoarticletitleで目次に 記事タイトルと著者名が追加されます。

コンパイル

全体のコンパイル

リポジトリのルートディレクトリでmakeしましょう。

各記事のコンパイル

目次と裏表紙が必要ない場合はarticles/以下の記事ディレクトリにcdしてmakeしましょう。

Dockerによるコンパイル

手元でのビルドに失敗したり、TeXLiveを入れたくなかったりする人はDockerイメージを使ってビルドすることもできます。

全体のコンパイル

リポジトリのルートディレクトリでdocker compose upしましょう。

各記事のコンパイル

目次と裏表紙が必要ない場合はarticles/以下の記事ディレクトリにcdしてdocker compose upしましょう。

GitHub Actionsによるコンパイル

特定のブランチ名でBitBucketにpushするとGitHub Actionsを使って記事をビルドすることができます。

コンパイル対象

• タグ: 全体の記事
• mainブランチ: 全体の記事
• articles/*ブランチ: ブランチ名末尾と同じディレクトリの記事

例えばmy_articleというディレクトリで記事を書いた場合、 articles/my_articleというブランチ名でpushすることで自動的に記事がビルドされます。

PDFのダウンロード

ビルドに成功したら編集部内のストレージからPDFをダウンロードすることができます。 詳細は編集部のえらい人に聞いてください。

質問

@hid_alma1026か @_yyu_へ投げると早い。 LuaLaTeXに関しては@Nymphiumか@azuma962へ。

GitHub Actionsや成果物のpush先に関しては @totsugeki_tai に聞くとよい。

ライセンス

License: modified BSD (see LICENSE)