% Time-stamp: <2019-09-20 11:11:37 nagata>
% コンパイルの仕方：
% uplatex filename
% dvipdfmx filename
%%%%%%%%%%%%%%%%%%%%%%
\documentclass[uplatex]{jsarticle}
%
%% 以上を preamble（前口上）と呼ぶ
%
\begin{document}% ここからが「本文」
日本語\textbf{\TeX{}}入門，初めの一歩。先ずは，\textgt{マーク
  アップ言語}（markup language. 視覚表現や文章構造等をテキス
トで記述するための形式言語。ウェブページを記述するHTML:
Hypertext Markup Languageもマークアップ言語）の流儀に慣れるこ
と。\TeX{}は美文書作成のためのマークアップ言語であり，プログ
ラミング言語でもある。

\TeX{}を使った文書作成は，まず\textgt{入力ファイル}（input
file. 本文に\textgt{命令}（command. \TeX{}ではcontrol
sequenceと呼ぶ）等のマークアップを埋め込んだ\textgt{テキスト
  ファイル}，source fileともいう。ファイルの拡張子は .tex）を
用意し，これを\TeX{}プログラムで\textgt{一括処理}（batch
process）し，\textgt{出力ファイル}（output file. 通常はpdfファ
イル。出力ファイルは\textgt{バイナリファイル}，バイナリはテキ
ストの対語）を得る，という工程を辿る。プログラムで一括処理す
ることを「\textgt{コンパイル}（compile）する」ともいう。コン
パイル作業は「ターミナル」上で行う。

入力ファイルは，文字入力とテキストファイルでのファイル保存が
可能であればどのようなソフトウェア（たとえばMS-Word/Excel等）
を使っても良いが，通常，テキストを高速編集できる「\textgt{テ
  キストエディタ}（text editor）」を用いて作成する。高機能エ
ディタであれば，命令等が埋め込まれたマー
クアップ箇所を「色分け」等して，人間の目にも分かりやすいよう
に，本文テキストとは区別して表示してくれる。この機能
を\textgt{シンタクスハイライト}（syntax highlight）と呼ぶ。

入力ファイルは大きく「\textgt{プリアンブル}（preamble, 前口上）」
箇所と「本文」箇所に分かれる。前者は，テキストの「\textgt{組
  版}（typeset）」指定に関わる初期命令群をまとめて記しておく
部分である。\verb|%| は\TeX{}における「\textgt{コメン
  ト}（comment）」記
号で，この記号の後の記述はプログラムに無視されるため，ここに
メモ等を好きなように記すことができる。\TeX{}プログラム
は \verb|\end{document}| 以降の記述も全て無視する（のでここに
もメモ等を書いておける）。

なお，このように入力ファイルに空白行を置くと出力ファイルでは
そこが改行され，自動的に段落が作られる。段落冒頭の字下げ
（\textgt{インデント}）も自動でなされる。

king, street, summerといった英語はもちろん，König, Straße,
hôtel, été, français, à, vœuxといったドイツ語やフランス語の単
語も混在させられる。欧文単語と和文（邦文とも）の間にはわざわ
ざ「空白（white space）」を挿入しなくても，自動的に適切な
「空き」が設けられる。

入力ファイルにマークアップ命令等の記述ミスが含まれている
と，\TeX{}はコンパイル時にそこで処理をストップさ
せ，\textgt{エラーメッセージ}を出力する。こうした場合，ターミ
ナル上で x を打ち込み，処理工程から抜けた上で，記述ミスを訂正
（\textgt{デバッグ}，debug）し，入力ファイルを上書き保存した
後，あらためてコンパイルし直す。最終的に望む出力が得られるま
で，この工程を繰り返す。

\TeX{}のコマンドは \textbackslash{}（backslash）で始まり，必
須の「\textgt{引数}（argument）」を \verb|{...}|（中括
弧，braces）に括る。「\textgt{オプション}（option）」
は \verb|[...]|（大括弧，brackets）に入れる。本入力ファイルで
用いられている\TeX{}コマンドを全てチェックし，それぞれ入・出
力を比較してみよ。
\end{document}% 「本文」終わり

