[[TeX入門]]/
最初の例/
[[簡単な数式 (1)>TeX入門/簡単な数式(1)]]/
[[簡単な数式 (2)>TeX入門/簡単な数式(2)]]/
[[各種パッケージの利用>TeX入門/各種パッケージの利用]]/
[[レポート>TeX入門/レポート]]/
[[HTML と LaTeX の比較>TeX入門/HTMLとLaTeXの比較]]/
[[複雑な数式>TeX入門/複雑な数式]]/
[[図表>TeX入門/図表]] /
[[文献引用]]/
[[索引作成]]/
[[マクロの作成>TeX入門/マクロの作成]]/
[[スライドの作り方（jsarticle 編）>TeX入門/スライドの作り方（jsarticle編）]]/
[[応用的な使い方>TeX入門/応用的な使い方]]
&color(White,#5F2F2F){ ''◆CONTENTS◆'' };&br;
#contents
* 最初の例 [#cb71c504]
まずはうんと簡単な例からやってみましょう。
**ファイルの作成 [#a37eebd1]
次のファイルを作ってみましょう。
\documentclass[uplatex]{jsarticle}
\begin{document}
吾輩は猫である。名前はまだ無い。
どこで生れたかとんと見当がつかぬ。
何でも薄暗いじめじめした所で
ニャーニャー泣いていた事だけは記憶している。
吾輩はここで始めて人間というものを見た。
\end{document}
この文章をテキストエディタ((Windows では「メモ帳」，「[[Emacs]]」，「[[Vim]]」，「[[Atom]]」，「[[Brackets]]」，「[[Light Table]]」，「[[Notepad++]]」，「[[サクラエディタ]]」など．OS X, Linux では「[[Emacs]]」，「[[Vim]]」，「[[Atom]]」，「[[Brackets]]」，「[[Light Table]]」など))に記述します。~
コピー & ペーストしても OK です。~
ファイルに ex1.tex という名前を付けて UTF-8 で保存します。~
ファイル名は何でもかまいませんが，最後に .tex を付けます。
**upLaTeX の実行 [#a6b25776]
作成した TeX ファイルを upLaTeX で処理してみましょう。~
-[[Windows PowerShell]] またはコマンド プロンプト (Windows の場合)~
-ターミナル (OS X, Linux の場合)~
を開いて，さきほど ex1.tex を保存したディレクトリ（フォルダー）に移動し，次のように打ち込みます。
uplatex ex1
すると，たとえば次のような表示が画面に出ます。~
表示は TeX ディストリビューションによって微妙に異なります。~
This is e-upTeX, Version 3.14159265-p3.5-u1.11-130605-2.6 (utf8.uptex) (TeX Live 2014/W32TeX) (preloaded format=uplatex)
restricted \write18 enabled.
entering extended mode
(./ex1.tex(guessed encoding: UTF-8 = utf8)
pLaTeX2e <2011/05/07u00>+0 (based on LaTeX2e <2014/05/01> patch level 0)
Babel <3.9k> and hyphenation patterns for 78 languages loaded.
(c:/texlive/2014/texmf-dist/tex/platex/jsclasses/jsarticle.cls(guessed encoding: ISO-2022-JP = jis)
Document Class: jsarticle 2014/02/07 okumura
) (./ex1.aux) [1] (./ex1.aux) )
Output written on ex1.dvi (1 page, 556 bytes).
Transcript written on ex1.log.
これで ex1.dvi という組版結果のファイルが生成されます。~
また，処理の様子を書き込んだ ex1.log が出力されます。~
エラーが起こった場合はエラーメッセージなども出力されます。~
この場合には特に意味のない補助ファイル ex1.aux も出力されます。~
**dvipdfmx の実行 [#r1e1daab]
ex1.dvi を dvipdfmx で処理します。~
dvipdfmx ex1
ex1.pdf というファイルができていることを確かめてください。~
ex1.pdf を
-[[TeXworks]], [[TeXstudio]] (Windows, OS X, Linux の場合)~
-[[SumatraPDF]] (Windows の場合)~
-Preview, [[Skim]], [[TeXShop]] (OS X の場合)~
-[[Evince]], [[Okular]], [[zathura]], [[qpdfview]] (Linux の場合)~
で開くと，きれいに組版された文章が画面に現れます。~
PDF ファイルは [[Adobe Reader]] で表示・印刷できます。 ~
この例を [[TeXworks]] で入力してタイプセット・プレビューしたときの様子を [[TeXworks のページ>TeXworks/使い方#h5dac63f]]に挙げておきました。~
TeXworks のタイプセットメニューで upLaTeX (ptex2pdf) または pdfupLaTeX を指定してタイプセットすると uplatex で処理したあと dvipdfmx を実行します。~
**ptex2pdf の実行 [#k492ffcb]
uplatex と dvipdfmx を実行したい場合は
ptex2pdf -u -l ex1
とします。~
ptex2pdf に関する詳細は [[ptex2pdf - TeX Wiki>ptex2pdf]] を参照してください。~
人に渡す場合は，DVI ファイルを PDF ファイルに変換しましょう。~
* 解説 [#md8c2330]
最初の2行と最後の1行は，決まり文句です。~
この間に，出力（印刷）したい文章を書きます。~
文章は，適当に改行してもかまいません。~
改行は，出力には影響しません。~
ただし，空の行は，段落の切れ目を表します。~
組版結果は出力装置（%%%''d''%%%e%%%''v''%%%ice）に依存しない（%%%''i''%%%ndependent）ことから DVI ファイルと呼ばれます。~
DVI ファイルは dvipdfmx を実行すると PDF ファイルに変換されます。~
PDF ファイルは異なった環境でも同じように閲覧できる文書形式 (%%%''P''%%%ortable %%%''D''%%%ocument %%%''F''%%%ormat) なので PDF ファイルと呼ばれます。~
* 間違いやすいこと [#o075508f]
**拡張子 [#ka2ad20a]
Windows のメモ帳で保存すると，ex1.tex としたつもりでも ex1.tex.txt というファイル名にされてしまうことがあります（メモ帳のおせっかい）。~
この場合は，保存してから名前を変えてください。
**入力モード (半角/全角) [#m0f2be64]
\ 印で始まる英語のような単語は TeX へのいろいろな指示を表すコマンドです。~
すべて半角文字（Windows では直接入力）で入力してください。~
//“オマジナイ”という語は、事情に通じている人の間のしゃれですよね。~
//初学者を相手にするときは使わないべきと考えます。~
* エラーメッセージ [#z764b56f]
コマンドのつづりを間違えていたりすると，エラーメッセージが出ます。~
たとえば、上記のファイルの2行目にある \begin というところを誤って \bigin と打ち込んでしまった場合なら、次のようなエラーメッセージが出ます。~
This is e-upTeX, Version 3.14159265-p3.5-u1.11-130605-2.6 (utf8.uptex) (TeX Live 2014/W32TeX) (preloaded format=uplatex)
restricted \write18 enabled.
entering extended mode
(./ex1.tex(guessed encoding: UTF-8 = utf8)
pLaTeX2e <2011/05/07u00>+0 (based on LaTeX2e <2014/05/01> patch level 0)
Babel <3.9k> and hyphenation patterns for 78 languages loaded.
(c:/texlive/2014/texmf-dist/tex/platex/jsclasses/jsarticle.cls(guessed encoding: ISO-2022-JP = jis)
Document Class: jsarticle 2014/02/07 okumura
)
! Undefined control sequence.
<recently read> \bigin
l.2 \bigin
{document}
?
エラーメッセージの下の方に“l.2 \bigin”という行があります。~
これは入力ファイル2行目の \bigin という部分を読み込んだところでエラーが発生したことを示しています。~
“l.2 \bigin”のそのすぐ上のところにある“! Undefined control sequence.”という行が発生したエラーの種類を示しています。~
この場合は“定義されていないコントロールシークエンスである（＝こんなコマンドはないですよ）”というエラーです。~
エラーが発生すると TeX は処理を一時停止して待機します。~
エラーメッセージを見てもどこが悪かったのかわからない場合には、この待機中に“h”を入力するともう少し詳しい状況説明と対処方法が表示されることもあります。~
? h
The control sequence at the end of the top line
of your error message was never \def'ed. If you have
misspelled it (e.g., `\hobx'), type `I' and the correct
spelling (e.g., `I\hbox'). Otherwise just continue,
and I'll forget about whatever was undefined.
?
上記のエラーの場合は“I\begin”を入力すると ex1.dvi が作成されます。~
? I\begin
(./ex1.aux) [1] (./ex1.aux) )
Output written on ex1.dvi (1 page, 556 bytes).
Transcript written on ex1.log.
“I\begin”を入力せずに“x”を入力すると TeX はここで処理を終了します。~
? x
No pages of output.
Transcript written on ex1.log.
エラーメッセージからどこを直すべきかわかった場合にはその箇所を修正してやり直してください。~
どこを直すべきかわからなかった場合にはエラーが起きた箇所の近辺を精査して間違った箇所を探し出したうえで入力ファイルを修正してやり直してください。~
//このようになってしまったときは，Enter キーを押すと，そのエラーを無視して，処理を続行します。~
//// ↑
//// 初心者には使いこなせない機能です。~
//エラーメッセージが表示されなくても、いつまでも TeX の処理が終わらないような場合は， Ctrl キーを押さえながら C キーをたたいてみてください。~
////↑
//// ほとんど起こりません。~
各種エラーメッセージについては、[[LaTeX のエラーメッセージ]]、[[TeX のエラーメッセージ]]も参照してください。
* さらに…… [#q6b5d096]
\documentclass[uplatex]{jsarticle} は jsarticle というドキュメントクラスに従って upLaTeX で組版することを指図する命令です。~
ドキュメントクラスは HTML のスタイルシートに対応するもので，スタイルファイルとも呼ばれます。~
** upLaTeX がインストールされていない古いシステムの場合 [#q9e98ef6]
\documentclass[uplatex]{jsarticle} を \documentclass{jsarticle} に変えると，pLaTeX で組版できます。~
** upLaTeX, jsarticle ドキュメントクラスがインストールされていないさらに古いシステムの場合 [#m304e480]
\documentclass[uplatex]{jsarticle} を \documentclass{jarticle} に変えると，jarticle という古いドキュメントクラスに従って pLaTeX で組版できます。~
