文書の構造：導入

要約

この課は、文書の構造を扱う本講座の第三単元の始まりである。単元が何のためにあるかを説明する。すなわち、前の単元で整えた本文から、固有の骨組みをもつ長い文書へ進むことである。その文書では各部分が番号をもち、目次に並び、互いに参照し合い、複数のファイルに分けられる。さらに、単元の五つの課と、ドキュメントクラスとページから自前のプリアンブルまでそれらを貫く筋道を示し、それまでの単元から何を前提とするかを明らかにし、学術文書の形がどこから来たかを振り返る。そして単元が解決する問題、すなわち参照と番号を手で書いた文書は変更されたとたんに嘘をつき始めるという問題を立て、この骨組みが物理学の学位論文にも歴史学の学位論文にも同じように役立つことを示す。

学習目標

単元の内容の順序を述べ、各課が次の課に何をもたらすかを説明する。
単元がそれまでの単元から前提としていることを見分け、必要なら復習する。
内部の参照を手で書かない理由を、例を用いて説明する。
さまざまな分野の学術的なジャンルのうちに、単元が組み方を教える構造を見いだす。

開始テスト

単元に取りかかる前に、出発点を測っておくとよい。このテストは自己評価であり、採点はされず、学習の方向づけだけを目的とする。最初の二問は、単元がそれまでの単元から前提としていることを復習する。続く十問は、二問ずつ順に、単元の五つの課を扱う。長い文書を組んだことのない人は、正解できなくてもかまわない。どの答えも、正しくても誤っていても、要点を説明し、それを扱う課の名を示す。同じ技能は、最後のまとめの課で改めて測る。

導入テスト

単元を始める前に、自分の出発点を測りましょう。短い自己評価です。採点はされず、結果はあなたのブラウザーにだけ保存されます。

問 1前の単元から文書を初めてコンパイルしたあと、\ref で書いた参照が二つの疑問符として表示され、ログはもう一度コンパイルするよう求めている。何が起きているのか。
最初のパスでエンジンは番号を補助ファイルに書き込んだが、それを使えるのは次のパスからである。もう一度コンパイルするか、latexmk でコンパイルすればよい。
ラベルの綴りが誤っているので、直さなければならない。
参照のためのパッケージが足りない。
補助ファイルが壊れているので、削除しなければならない。
問 2前の単元からあるエッセイは、作品名を毎回『』で囲んで手で書くかわりに、プリアンブルで \newcommand{\sakuhin}[1]{『#1』} と定義した \sakuhin{…} で示している。何が得られるか。
すべての書名の見た目を一行で変えられ、ほかの役目を果たす記号や書体には手を触れずにすむ。たとえば書名をイタリックにする欧文誌に投稿するときである。
何も得られない。結果は同じだからである。
コンパイルが速くなる。
書名がひとりでに目次に入る。
問 3ある学生が \documentclass{article} で学位論文を書き、本文を \chapter{…} で区切った。コンパイルすると何が起きるか。
エンジンは「Undefined control sequence」というエラーを出す。article クラスには章がないからである。
章が節として組まれる。
章は正しく組まれる。すべてのクラスが同じ階層をもつからである。
何の警告もなく無視される。
問 4ある大学は A4 用紙で 2.5 センチメートルの余白を求めている。それを設定する適切な方法はどれか。
geometry パッケージを使う。たとえばプリアンブルに \usepackage[a4paper, margin=2.5cm]{geometry} と書く。
余白を設定するクラスオプション a4paper を使う。
各行の頭に \hspace を書く。
\small で文字の大きさを小さくする。
問 5article クラスの文書で、\tableofcontents の前に \setcounter{tocdepth}{1} と書いた。目次には何が表示されるか。
節だけが表示され、小節は表示されない。
小節だけが表示される。
何も表示されない。目次が空になるからである。
すべての階層が表示されるが、番号はつかない。
問 6article クラスの文書で、命令 \appendix のあとに \section を二つ書いた。どのように番号がつくか。
文字で A、B とつく。
普通の節と同じく、それまでの番号が続く。
星印つきの節のように、番号がつかない。
ローマ数字で I、II とつく。
問 7ある著者が、第 2 節にあたる \section{方法} の前の行に \label{sec:methods} と書いた。\ref{sec:methods} はどの番号を印字するか。
前の区分の番号である 1 を印字する。ラベルは自分より前に最後に割り当てられた番号をとるからである。
2 を印字する。ラベルが節のすぐそばにあるからである。
何度コンパイルしても二つの疑問符になる。
ラベルは見出しの中に書かなければならないので、エラーになる。
問 8hyperref パッケージを読み込むと、文書の何が変わるか。
参照、目次の項目、脚注の合印が PDF のリンクになり、PDF にしおりがつく。
節とページの番号。
参照に二回のパスが要らなくなる。
「目次」「図」のような見出し語の言語。
問 9学位論文の親ファイルで、\include{chapter1} と \input{chapter1} は何が違うか。
\include は内容を新しいページから始め、\includeonly で一部の章だけをコンパイルできるようにする。\input はファイルを、書かれた位置にそのまま差し込む。
何も違わない。同義である。
\input はプリアンブル用のファイルしか受けつけない。
\include は保存時にファイルを親ファイルの中へ写す。
問 10ある学位論文のプリアンブルに \includeonly{chapter3} があり、本文は五つの章を \include で取り込んでいる。論文が以前に全体としてコンパイル済みなら、このコンパイルは何を生むか。
第 3 章だけの PDF で、ページ、章、参照の番号は保たれる。それらの番号はほかの章の補助ファイルからとられる。
五つの章すべてを含む PDF。\includeonly は目次にしか影響しないからである。
第 3 章だけの PDF で、第 1 章として、1 ページ目から番号がつく。
ほかの章がないので、エラーになる。
問 11プリアンブルに \newcommand{\emph}[1]{\textbf{#1}} がある。何が起きるか。
エンジンは「Command \emph already defined」というエラーを出す。\newcommand は既存の命令を定義し直さない。そのためには \renewcommand がある。
すべての強調が太字になる。
二つ目の \emph が作られ、元の命令と共存する。
何も起きない。プリアンブルは文字を組まないからである。
問 12プリアンブルに \newcommand{\ryou}[2]{#1~#2} があるとき、\ryou{5}{km} は何を印字するか。
「5 km」。間の空白では行を分割できない。
「km 5」。
「5~km」で、チルダが印字される。
命令は引数を一つしかとれないので、エラーになる。