\documentclass{jarticle}
\usepackage{boxedminipage}
\usepackage{txfonts}
\usepackage[dvipdfm]{color}
\usepackage[dvipdfm,bookmarks=true,bookmarksnumbered=true,%
bookmarkstype=toc]{hyperref}
\usepackage{graphicx}
\usepackage{html}
\title{\LaTeX とHTMLによる論文・報告作成の基礎}
\author{岩熊哲夫}
\date{2000年7月2日 ([-30]5051.49)}
\setlength{\topmargin}{-11mm}
\setlength{\headsep}{20pt}
\setlength{\textheight}{24cm}
\setlength{\textwidth}{16cm}
\setlength{\oddsidemargin}{1.5mm}
\setlength{\evensidemargin}{1.5mm}
\def\english{\par\baselineskip=.7\normalbaselineskip
  \vskip .4286\baselineskip\noindent\ignorespaces}
\def\endenglish{\par}
% \renewcommand{\baselinestretch}{.88}
\begin{document}
\maketitle

\begin{english}
\tableofcontents
\end{english}

\mbox{}
\medskip\hrule\medskip

\begin{htmlonly}
\htmladdnormallink{もともとの\LaTeX ソース}{latexhtm.tex}と，
\htmladdnormallink{pdfファイル}{latexhtm.pdf}
\end{htmlonly}

\section{文書の記述法}

\subsection{表現と中身}

\begin{itemize}
\item レイアウト構成
\begin{itemize}
\item 単なる見え方である．例えばセンタリングや細かいフォント指定
\item 論理の流れを示す補助にはなるが本質ではない
\item 伝えたい内容や説得力とは直接の関係は無い
\item 極端化したものはポスター
\end{itemize}
\item 論理構造
\begin{itemize}
\item 内容の意味や段落間の意味的関係で，章建てや箇条書き
\item 文書を書く上で最も重要で本質的な点
\item 見え方が伝えたい内容を左右しない．文章そのものの説得力のために必要
\item 一種の極端は詩や短歌
\end{itemize}
\end{itemize}

\subsection{論文・報告}

最も重要なのは「文書構成」「内容の論理」であって，
レイアウトはたいていは定型である．
ウェブ上のページであっても，何か伝えたい・提供したいというので
あれば，内容の論理を重視した構成になっている必要がある．
すべてがポスター様であれば，独り善がりになり易い．

\subsection{記述言語}

\begin{itemize}
\item[(a)] ワープロ：WYSIWYG (What you see is what you get.)方式の
文書整形ソフト．保存ファイル中はマークアップ方式情報．
利用者が組版の知識を有していないと駄目な出力になる．
\item[(b)] お絵描き：単なる整形；ポスター作成．論理より直感（視覚）．
\item[(c)] Hyper Text Markup Language: SGML (Standard
 Generalized Markup Language) と同様，マークアップ言語．HTMLは
ネットワークでの使用が前提のようだが，論理的記述もできる．
\item[(d)] \TeX: 組版ソフト；テキスト整形のみではない．
内容の論理構成に従って記述する言語．\LaTeX は定型文書用．
ワープロと違ってレイアウト等の余計な事を考える必要が全く無いので，
文書の論理構成だけに精神を集中できる．
そういう意味で論理的記述に向いている．
現在のバージョンは3.14159で，完成したら$\pi$になる．
フォントを作るソフトの{\tt Metafont}は2.7182で，こちらも
完成したら$e$になる．
\item[(e)] プリンタ記述言語：PostScriptやLIPSで通常は
ページ記述言語と呼ばれ，出力の頁毎のレイアウトのみを記述する．
プリンタ制御用の言語．
\end{itemize}

\subsection{文章の記述法}

細かい点も含めて義務教育の「国語」では習っていない
ものと考え，独学する必要がある．最も分かりやすい
文献（教科書）は，『日本語の作文技術（本多勝一著：朝日
新聞社刊朝日文庫）』の特にp.28以降を勉強するとよい．
さらに，多くの良い本（小説は駄目）を読むこと．

\subsection{よくある間違い等}

私が気になる所を列挙しておく．
\begin{itemize}
\item 横書きでの句読点は，全角のコンマとピリオド（土木学会），あるいは
全角のコンマと句点（文部省）を用いる．ただし表示ソフトに
邪悪な「ＭＳ明朝Ｐ」等を設定してあると正しくは表示されない．
\item 中黒「・」なども原則全角ドリである．
\item 括弧始めと終わりがあるように，引用マークも
きちんと“このようなもの”や`this type of marks'あるいは``a double
 quotation mark''を用いる．
これも表示ソフトに邪悪な「ＭＳ明朝Ｐ」等を設定してあると
正しくは表示されない．「"」というマークは『インチ記号』であり，
それを引用に使うのはインチキである．
\item 英数字は半角とする．括弧は，半角を囲むときは(半角の
括弧記号)を，全角を囲むときは（全角の括弧記号）を用いる．
\item 句読点やコロン(:)・セミコロン(;)等の区切り文字は
文頭には決して置かない．
たとえそれが箇条書きであったとしても文頭には置かない．
\item 区切り文字はすぐ前の文字との間にスペースを入れず，
全半角共に必ず密着させる．
また半角の区切り文字の場合は，区切り文字のすぐ後には
半角のスペースを置く．
\item 区切り文字と引用記号の順番は，英語の場合``this
 is quoted sentense,'' andのようになる．
\end{itemize}

\section{\LaTeX とHTMLの基本的な設定部分}

\subsection{基本的な書き出しと最終行}

書き出しには次のような「おまじない」が必要．

\noindent
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   \documentclass{jarticle}
   \title{題目}
   \author{筆者名}
   \date{日付}
   \begin{document}
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   <html>
   <head>
    <title>ページのタイトル</title>
   </head>
   <body>
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\bigskip

\noindent となる．これで文書本体の書き出しにつながる．HTMLの
場合もタイトルを略すのはよくない．\LaTeX の場合に
基本的なスタイルとして論文スタイル{\tt jarticle}を
用いている．他に報告・本スタイル{\tt jreport}, {\tt jbook}がある．
この\verb+\begin{document}+の前の部分をプリアンブルと呼ぶが，
ここはオプションとして利用するスタイルファイル等の指定にも用いる．
例えばこの文章のように{\tt boxedminipage}という特殊な
環境を用いる場合や，PostScriptの図を読み込むためなどに
\begin{verbatim}
     \usepackage{boxedminipage}
     \usepackage[varg]{txfonts}
     \usepackage[dvips]{graphicx}
\end{verbatim}
のような行を並べる．具体的な指定の仕方は，それぞれのスタイルファイルの
ドキュメントを読むこと．

全部の文章が終わった最後の最後には

\noindent
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   \end{document}
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   <address>
   何の某 2000.1.1<br>
   daresore@hoge.tohoku.ac.jp
   </address>
   </body>
   </html>
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\bigskip

\noindent となる．HTMLの場合には，署名と
作成日を明確にしておくことが望ましい．

以上で明らかなように，\LaTeX では \verb+\begin+で始まった
環境は \verb+\end+で終わり，HTMLでは原則として \verb+<tag>+で
始まったものが \verb+</tag>+で終わっている．
この組み合わせが順番通り並んでいないと，期待した
出力は得られないので注意する．

\subsection{文書の表示・印刷}

\begin{description}
\item[\LaTeX:] 組版ソフト\TeX でコンパイルして
できるDVIファイルを，いわゆるdviwareで表示・印刷する．
ちなみにDVIとはdevice independentという意味で一種の
ページ記述言語（バイナリ）である．\TeX そのものは
どんなプラットフォーム上でもソフトが
存在するportableなもので，dviwareも
各種・各プラットフォーム上で整備されている．
またPostScriptにも変換できる．DVIファイルは
ページ記述言語であるから，どこで出力しても同じ出力になる．
\item[HTML:] ブラウザで表示・印刷する．出力結果は
ブラウザの設定等で統一されないことが前提であることに注意する．
そういった意味でも，HTMLは論理記述のための言語と
考えておいた方がいい（画像を多用しない限り）．
\item[ワープロ:] ワープロは画面で見たままのが出力される(WYSIWYG:
 What you see is what you get.)から，
組版の規則をある程度知っていないと醜い出力になってしまう．
またソースファイルを別の環境で読み込んだ場合，フォント設定等の
関係で，必ずしも同じ出力が得られるとは限らないこともあるので注意．
日本語対応のワープロで作成した英文文書ファイルが，
外国では表示すらできない場合もあるらしい．
\end{description}

\section{本文本体の記述法}

\subsection{論理的な文章}

論文・報告というのは論理的な文章であればよく，明確に
記述され誤解が生じない限り，美的である必要もないし，感情に
訴えるものである必要もない．
\begin{description}
\item[文節：] ひとつの句点を持つ文章基本単位で，ひとつの事柄を，
複数の読点で論理を明確にして記述する構造．
ひとつのことを述べる毎に文節を改めるのが誤解を生まないが，
説得力やインパクトのために工夫する必要もある．
\item[段落：] 複数の文節ででき，あるひとつの論理を示す最小単位．
ひとつの段落ではひとつの事だけについて書く．
\item[節：] 複数の段落を論理的に並べ，ある論理的帰結なり
まとまった考えを主張する構造．
その節が何のためにあるのかが明確になるようにする．
\item[文書：] 複数の節が論理的に並べられ，ひとつ以上の
最終的な結論・主張を示すもの．
\end{description}
と考えるとよい．

特に論文・報告のように科学的・工学的主張を述べる文書の
場合，「起承転結」等の構成をうまく考え，節毎にひとつの
閉じた論理を構成させ，節の並べ方と内容によって，ひとつの
文書で閉じた論理を構成するようにする．

\subsection{文書の題目周辺}

まずは題目部分になるが

\noindent
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   \maketitle
   ［空行］
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   <h1>タイトル</h1>
   <big>だれそれ</big><br>
   <strong>いつの記述</strong><p>
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\bigskip

\noindent となる．HTMLの場合のは例えばの話であるが，
上の「おまじない」の \verb+<title>+部分は，本文中では
反映されないので，このようにヘッダタグで再度
記述する必要がある．

\subsection{節建て}

ここから本文が始まるが，節建てをして始める

\noindent
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   \section{第一節のタイトル}
   ［空行］
   さて，ここでは・・・
   ［空行］
   \subsection{第一節の小節タイトル}
   ［空行］
   ところで・・・
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   <h2>第一節のタイトル</h2>
   さて，ここでは・・・
   <h3>第一節の小節タイトル</h3>
   ところで・・・
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\bigskip

\noindent となる．HTMLの場合，ここではページの題目に
ヘッダタグの \verb+<h1>+を使っているため，節に \verb+<h2>+を
用いている．

節は次のようにして順番を付ける．

\noindent
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   \section{節タイトル}
   \subsection{小節タイトル}
   \subsubsection{項タイトル}
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   <h2>節タイトル</h2>
   <h3>小節タイトル</h3>
   <h4>項タイトル</h4>
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\bigskip

\noindent \LaTeX では自動的に節番号が振られる．この例のHTMLの
場合では前述のように，ページの
タイトルに \verb+<h1>+を使ってあるので，
このように \verb+<h2>+から下を用いてある．

また，\LaTeX の報告・本スタイル{\tt jreport}, {\tt jbook}の
場合には，節の上に『章 \verb+\chapter{...}+』が使え，
さらにその上に『部 \verb+\part{...}+』が使える．

\subsection{段落}

段落は次のような文節のまとまりとする．

\noindent
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   ［空行］
    さて，・・・
   ［空行］
    ところで，・・・
   ［空行］
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
    <p>
    さて，・・・
    </p>
    <p>
    ところで，・・・
    </p>
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\bigskip

\noindent ただしHTMLの \verb+</p>+は省略できる．

\LaTeX の場合は，段落の開始・終了の前後に空行を入れて
おくのが分かりやすく，特に最初の空行は，段落始めの
インデント（字下げ）を自動的に挿入してくれる．
このように，段落始めに自動的に字下げが入ることで
段落を明示している．

これに対しHTMLの場合は，段落間に1行
間隔程度の空行が入るだけで，字下げは自動化されない．
HTMLの場合に字下げが必要な場合は，段落の最初に
全角のスペースを入れておく必要がある．そうであっても，
読む側のブラウザのフォント設定で，
例えば「ＭＳ明朝Ｐ（プロポーショナル）」等と
いった『日本文化を滅ぼすフォント指定』がされていた
場合に，1文字分の字下げにならない．英語の段落始めの
ように，数文字分の字下げにするには，例えば

\noindent
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
     &nbsp;&nbsp;&nbsp;さて，・・・となる．
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
      さて，ここでは・・
   ・・・・となる．
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\bigskip

\noindent のようにすると良いかもしれない．

\subsection{表題付きのパラグラフ}

\LaTeX の場合は， \verb+\paragraph{...}+や \verb+\subparagraph{...}+で
段落に題目を付けることもできる．

HTMLの場合には，文章の表現にも少し工夫をして，例えば

\noindent
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
     <b>見出し</b><br>
     ここにひとつの段落を．．<br>
     　字下げして次の段落．．<p>
     <b>次の見出し</b><br>
     ところで・・・
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[t]{.48\textwidth}
\begin{quote}
\begin{english}
{\bf 見出し}

ここにひとつの段落を．．．

　字下げして次の段落を．．
\bigskip

{\bf 次の見出し}

ところで・・・
\end{english}
\end{quote}

\mbox{}
\end{boxedminipage}
\bigskip

\noindent とするのも効果的である．
見出しは \verb+<big>...</big>+も考えらる．
また \verb+<h5>+,  \verb+<h6>+も使えるが，ブラウザによっては
多少小さめ過ぎる場合がある．

\subsection{引用}

何か他の人の文章等を引用する場合には

\noindent
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   \begin{quote}
   ...
   \end{quote}
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   <blockquote>
   ...
   </blockquote>
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\bigskip

\noindent となる．\LaTeX では{\tt quotation}環境も
ある．ただしHTMLの場合には，
これも文章表現のレイアウトに使うことで，
見出しを効果的にすることもできる．例えば

\noindent
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
     <b>見出し</b>
     <blockquote>
     本文をここに書く<br>
     　字下げして次<p>
     次の関連話題の段落・・・
     </blockquote>
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[t]{.48\textwidth}
\begin{quote}
\begin{english}
{\bf 見出し}
\begin{quote}
本文をここに書く

　字下げして次
\bigskip

次の関連話題の段落・・・
\end{quote}
\end{english}
\end{quote}

\mbox{}
\end{boxedminipage}
\bigskip

\noindent のようなこともできる．

\subsection{脚注}

\LaTeX の場合は \verb+\footnote{...}+を用いて
脚注を入れることは可能であるが，論文・報告では
原則として用いない方がよい．HTMLには
脚注そのものは無い．

\subsection{相互参照}
\label{sec:xref}

「相互参照」は\LaTeX の場合の呼び名であり，
それに相当するHTMLタグとして「アンカー・タグ」を
説明する．

\subsubsection{\LaTeX の相互参照}

例えば節番号を文中で引用することがある．また
式を引用することがある．そういった場合には
\begin{itemize}
\item 引用される側には \verb+\label{name}+でラベルを付ける
\item 引用する側では \verb+\ref{name}+でラベルを引用する
\end{itemize}
ことにしておいて，2回コンパイルをすればきちんと相互参照が
できる．例えば

\noindent
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
 第\ref{sec:xref}節で展開された
 \begin{equation}
   f(x)=\sin x \label{eq:example}
 \end{equation}
 という式(\ref{eq:example})において
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\mbox{}

第\ref{sec:xref}節で展開された
\begin{equation}
f(x)=\sin x \label{eq:example}
\end{equation}
という式(\ref{eq:example})において

\mbox{}
\end{english}
\end{boxedminipage}
\bigskip

\noindent という風になる．

\subsubsection{HTMLのアンカー}

HTMLの場合の相互参照は，引用される側もする側も
アンカー・タグを付す．例えば

\noindent\begin{boxedminipage}[t]{.98\textwidth}
\begin{english}
\begin{verbatim}
    例えば<a name="xref">ここを引用する</a>として
    文章がつらつら続いていて
    ・・・・
    ある所で<a href="#xref">上で示したように</a>という
    引用をする
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{minipage}[t]{.01\textwidth}
~
\end{minipage}
\bigskip

\noindent のようにする．これで{\tt href}した部分を
ブラウザ上でクリックすれば，上の{\tt name}を定義した部分に
ジャンプすることになる．

もちろんHTMLで最もよく用いられるのは，他の
リソースへのアンカーである．例えば

\noindent\begin{boxedminipage}[t]{.98\textwidth}
\begin{english}
\mbox{}

\begin{verbatim}
   <a href="http://www.hoge.ac.jp/hoge.html">このページでは</a>・・
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{minipage}[t]{.01\textwidth}
~
\end{minipage}
\bigskip

\noindent という風に使うと，他のリソースとのリンクができる．
またページ最後の \verb+<address>+部分の
自分のメイルIDの部分も

\noindent\begin{boxedminipage}[t]{.98\textwidth}
\begin{english}
\mbox{}

\begin{verbatim}
   <a href="mailto:hoge@hoge.tohoku.ac.jp">hoge@hoge.tohoku.ac.jp</a>
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{minipage}[t]{.01\textwidth}
~
\end{minipage}
\bigskip

\noindent としておくこともできる．

もし他のリソースのページ途中のある指定箇所とリンクするなら

\noindent\begin{boxedminipage}[t]{.98\textwidth}
\begin{english}
\mbox{}

\begin{verbatim}
   <a href="./hokano.html#dokosoko">何のページのどこそこでは</a>・・
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{minipage}[t]{.01\textwidth}
~
\end{minipage}
\bigskip

\noindent のようにする．

\subsection{箇条書き}

単純な箇条書き，すなわち
\begin{itemize}
\item 一つ目の箇条書きの行
\item これが二つ目
\begin{itemize}
\item 入れ子の最初
\item 入れ子の最後
\end{itemize}
\item 最後の箇条になります
\end{itemize}
の場合には

\noindent
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   \begin{itemize}
   \item 一つ目の箇条書きの行
   \item これが二つ目
    \begin{itemize}
    \item 入れ子の最初
    \item 入れ子の最後
    \end{itemize}
   \item 最後の箇条になります
   \end{itemize}
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   <ul>
   <li> 一つ目の箇条書きの行
   <li> これが二つ目
    <ul>
    <li> 入れ子の最初
    <li> 入れ子の最後
    </ul>
   <li> 最後の箇条になります
   </ul>
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\bigskip

\noindent となる．記号は変えられる．

順番の数字付きの箇条書き，すなわち
\begin{enumerate}
\item 一つ目の箇条書きの行
\item これが二つ目
\item 最後の箇条になります
\end{enumerate}
の場合には

\noindent
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   \begin{enumerate}
   \item 一つ目の箇条書きの行
   \item これが二つ目\label{en:2nd}
   \item 最後の箇条になります
   \end{enumerate}
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   <ol>
   <li> 一つ目の箇条書きの行
   <li> これが二つ目
   <li> 最後の箇条になります
   </ol>
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\bigskip

\noindent となる．開始番号や表示は変えられる．\LaTeX の場合には，
箇条の数字（上例の二つ目の箇条の\verb+\label+）が相互参照の対象になる．

見出し付きの箇条書き，すなわち
\begin{quote}
\begin{description}
\item[あれ：] 一つ目の箇条書きの行
\item[これ：] これが二つ目
\item[それ：] 最後の箇条になります
\end{description}
\end{quote}
の場合には

\noindent
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   \begin{description}
   \item[あれ：] 一つ目の箇条書きの行
   \item[これ：] これが二つ目
   \item[それ：] 最後の箇条になります
   \end{description}
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   <dl>
    <dt>あれ：
     <dd> 一つ目の箇条書きの行
    <dt>これ：
     <dd> これが二つ目
    <dt>それ：
     <dd> 最後の箇条になります
   </dl>
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\bigskip

\noindent となる．HTMLの場合は見出しと箇条の間は改行されて
しまうが，見出しにするものが2文字程度以下の
場合は， \verb+<dl compact>+を用いると改行されない．

\section{レイアウトや文字飾り}

レイアウトや文字飾りは，特に論文や報告では可能な限り使わない．
論文や報告は内容を論理的に記述して伝えるためのものであり，
見た目で情報を伝えるものではない．

\subsection{位置決め}

センタリングの場合には

\noindent
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   \begin{center}
   最初の行\\
   次の行
   \end{center}
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   <center>
   最初の行<br>
   次の行
   </center>
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\bigskip

\noindent となる．

左右合わせの場合には

\noindent
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   \begin{flushleft}
   最初の行\\
   次の行
   \end{flushleft}
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   <p align="left">
   最初の行<br>
   次の行
   </p>
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\bigskip

\noindent となる．右合わせの場合には
上記の{\tt left}が{\tt right}になる．
このHTMLの場合の \verb+</p>+は省略できない．

改行を入れた文をそのままのイメージで出力する場合には

\noindent
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{quote}
    \verb+\begin{verbatim}+\\
   ここに書く（\LaTeX 命令無効）\\
    \verb+\end{verbatim}+
\end{quote}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   <pre>
   ここに書く（タグ有効）
   </pre>
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\bigskip

\noindent となる．

\subsection{コメント}

表示されないコメントをソースファイルに入れておくことが
できる．

\noindent
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   % ％マークで始まる行
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   <!-- の記号から右の記号まで -->
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\bigskip

\noindent という行がコンパイルされない，あるいは表示されない
コメント行になる．
ただし，これを多用すると，見通しの悪いソースになる．
可能な限りコンパクトに，かつ，必要な部分にのみ用いる．

\subsection{文字飾り（強調のため）}

通常，2種類のフォントで十分である．それ以上必要なら，
論理的に異様なことをしていると考えよう．
また重複した飾り，例えばゴチックで斜体とか，
下線付きのイタリック等も節操が無いのでやめる．
ポスターではなく，論文・報告を作成していることを忘れない．

イタリックの場合には

\noindent
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   {\em ...}
   {\it ...}
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   <em>...</em>
   <i>....</i>
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\bigskip

\noindent となる．`em'の方は「強調」という意味で，論理的な
制御と呼ばれる．HTMLの場合もこちらが好ましい．

ゴチックの場合には

\noindent
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   {\bf ...}
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   <strong>....</strong>
   <b>.........</b>
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\bigskip

\noindent となる． \verb+<strong>+が論理的．

下線を引くの場合には

\noindent
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   \underline{....}
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   <u>....</u>
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\bigskip

\noindent となる．\LaTeX の場合，2行以上にわたる下線は
普通はできない．

等間隔文字（タイプライター様の）を用いる場合には

\noindent
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   {\tt ...}
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   <tt>....</tt>
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\bigskip

\noindent となる．

\subsection{文字サイズ}

論文・報告で文字サイズをどうこうする必要は滅多に無い．
ただHTMLの場合は，メリハリを付けるのに多少の工夫は必要だろう．
基本的には

\noindent\begin{boxedminipage}[t]{.98\textwidth}
\begin{english}
\mbox{}

\begin{verbatim}
    <big>....</big> や <small>....</small>
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{minipage}[t]{.01\textwidth}
~
\end{minipage}
\bigskip

\noindent で十分であり， \verb+<font size=.....>+等を多用するのは，
ポスター様のページ以外のページでは好ましくない．

\subsection{水平区分け線}

段落を強調する意味で用いることができそうだ．

\noindent
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   前段落
   \medskip
   \hrule
   \medskip
   次段落
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
   前段落
   </p>
   <hr>
   <p>
   次段落
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\bigskip

\noindent のようにする．

\section{数式}

\LaTeX での数式表現については別途参考書を読むこと．HTMLでは
まだ満足なものができないが，\LaTeX で書いたソースをHTML化する
ある種の変換ソフトでは，式の部分だけをGIF画像にして
貼り込んでいる．HTMLで簡単に胡麻化すには \verb+<pre>+を使う．

\LaTeX での基本的な部分を列挙しておく．
\begin{description}
\item[式番号付き：] 基本的なもので，一行の式は

\noindent
\begin{boxedminipage}[c]{.48\textwidth}
\begin{english}
\begin{verbatim}
 \begin{equation}
   f(x)=\sin x \label{eq:eq1}
 \end{equation}
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[c]{.48\textwidth}
\begin{english}
\begin{equation}
f(x)=\sin x \label{eq:eq1}
\end{equation}
\end{english}
\end{boxedminipage}
\bigskip

\noindent という風になる．複数行になる場合には

\noindent
\begin{boxedminipage}[c]{.48\textwidth}
\begin{english}
\begin{verbatim}
 \begin{eqnarray}
   f(x) & = & \sin x \label{eq:eqn1} \\
   g(x) & = & \int_0^\infty h(x)
         \,\mbox{d} x \label{eq:eqn2}
 \end{eqnarray}
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[c]{.48\textwidth}
\begin{english}
\begin{eqnarray}
   f(x) & = & \sin x \label{eq:eqn1} \\
   g(x) & = & \int_0^\infty h(x) \,\mbox{d} x \label{eq:eqn2}
\end{eqnarray}
\end{english}
\end{boxedminipage}
\bigskip

\noindent という風になる．ちょっと気にして欲しいのは，
積分変数前の微分`d'が，数学斜体の`$d$'ではないことである．
つまり，変数としての`$d$'と区別するために，
積分変数前の微分記号は\verb+\,\mbox{d}+を用いてある．
ここの\verb+\,+は小さいスペーシングである．
\item[式番号無し：] 番号が要らない場合にはそれぞれ，{\tt displaymath},
{\tt eqnarray*}環境で式を書けばよい．
\item[複数行の場合の注意：] 式が複数になった場合の二行目が「引き算」
記号で始まるような場合，\verb+\mbox{}+を必ず入れるようにする．
これは演算子であることを区別するためである．

\noindent
\begin{boxedminipage}[c]{.48\textwidth}
\begin{english}
\begin{verbatim}
 \begin{eqnarray}
   f(x) & = & ax^3+b \\
        & & - bx^2 \\
        & & \mbox{} - cx
 \end{eqnarray}
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[c]{.48\textwidth}
\begin{english}
\begin{eqnarray}
   f(x) & = & ax^3+b \\
        & & - bx^2 \\
        & & \mbox{} - cx
\end{eqnarray}
\end{english}
\end{boxedminipage}
\bigskip

\noindent という風になる．3行目が正しい．
マイナス記号前後のスペース幅を比較して欲しい．
\item[本などの執筆で記号で式を参照したい：] 本の執筆などで，
非常に多くの式を扱うために式番号がかなりの数に及ぶものの，
ある節だけでしか必要の無い，しかし本文で引用したい式を表示したい
場合がある．そういう場合にはplain-\TeX のコマンドを用い

\noindent
\begin{boxedminipage}[c]{.48\textwidth}
\begin{english}
\begin{verbatim}
 $$
    f(x) = ax^3+b \eqno{(*)}
 $$
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[c]{.48\textwidth}
\begin{english}
 $$
    f(x) = ax^3+b \eqno{(*)}
 $$
\end{english}
\end{boxedminipage}
\bigskip

\noindent とするとよい．
\end{description}

\begin{figure}
\begin{center}
\includegraphics{ce.ps}
\end{center}
\caption{PostScriptの図の例}
\end{figure}

\section{図表・写真}

\subsection{\LaTeX のフロート}

\LaTeX の場合は，図表は{\tt figure}, {\tt table}環境の
中に配置する．この2つの環境はフロート（浮き）という分類に
なっており，ソースファイル中の位置とページのレイアウトの
状態とを勘案して，複数のページ内をあちこち「漂う箱」と
考えなければならない．つまり，どこに配置するかを
決めるのは\TeX そのものであり，利用者は出力をプレビューしながら，
欲しい位置に来るように調整する必要がある．これは
大抵の出版物（辞典のようなものではなく）の場合，図表は上や下に
まとめてあることを思い出せば納得がいくのではないだろうか．
面倒ではあるが，文章の読みやすさを損ねないための工夫と
考えて欲しい．

基本的には，段落と段落の間の空行の部分にこのフロートを置くことにし，
それをプレビューしながら最初のフロートから順に，適切な場所に
出力されるように，{\bf ひとつひとつ}配置していくしかない．
論文の版下提出のような場合には，偶数ページを左に置いた見開きページに
二ページ分が見渡せることを考え，その配置を工夫すると，
最終的な論文の読みやすさが向上し，読者の理解も得られ易くなるだろう．
もしかしたら査読もいい結果になるかもしれない．呵呵．

また，キャプションのセンタリングをする人が多いが，不要である．

\noindent
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
 \begin{figure}
  \begin{center}
   \includegraphics{hoge1.ps}\\
   \includegraphics{hoge2.ps}
  \end{center}
  \caption{キャプション}\lable{fig:hoge}
 \end{figure}
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{boxedminipage}[t]{.48\textwidth}
\begin{english}
\begin{verbatim}
 \begin{table}
  \caption{実験値\protect\cite{hogehoge}}
    \label{tab:hogege}
  \begin{center}
  \begin{tabular}{|l||r|r|} \hline
    .....
  \end{tabular}
  \end{center}
 \end{table}
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\bigskip

\noindent とするとよい．表のキャプションは表そのものの上に
位置する．キャプション中で参考文献を引用したい場合には
上記のように\verb+\protect+を用いるとエラーが生じない．

\subsection{HTMLの場合}

図表や画像データは，そのファイルを文中に指定することで
貼り込む．例えば

\noindent\begin{boxedminipage}[t]{.98\textwidth}
\begin{english}
\mbox{}

\begin{verbatim}
   <img border=0 align="bottom" alt="あの図" src="./photos/hoge.gif">
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{minipage}[t]{.01\textwidth}
~
\end{minipage}
\bigskip

\noindent といったようなタグを使う．{\tt alt}は目の不自由な人等に
とって重要なので省略しないようにする．

2枚以上の図や写真を隙間無く横に並べたい場合がある．
そういう場合には

\noindent\begin{boxedminipage}[t]{.98\textwidth}
\begin{english}
\begin{verbatim}
   <img border=0 ... src="./leftphoto.gif"><!-- コメントを入れて改行し
     --><img border=0 ... src="./rightphoto.gif">
\end{verbatim}
\end{english}

\mbox{}
\end{boxedminipage}
\hfill
\begin{minipage}[t]{.01\textwidth}
~
\end{minipage}
\bigskip

\noindent のようにするといい．

HTMLでもフロートのような利用法は可能である．せっかく
窓（複数）システムを使っているのに，わざわざフレームを使ったり，
何も工夫しないでリンクしたりするのはもったいない．
例えば

\noindent\begin{boxedminipage}[t]{.98\textwidth}
\begin{english}
\mbox{}

\begin{verbatim}
   <a target="photoswindow" href="./photos/hoge.gif">この写真では</a>
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{minipage}[t]{.01\textwidth}
~
\end{minipage}
\bigskip

\noindent とすると，{\tt photoswindow}という名前付きの窓が開いて，
そこに画像が出力される．もちろん直接画像ファイルではなく
他のHTMLファイルでもいい．
同様のことは{\tt JavaScript}を使っても可能である．

\subsection{表そのもの}

\LaTeX では{\tt tabular}環境を使う．HTMLでは，
非常に面倒だが \verb+<table>+の中に， \verb+<tr>+,
  \verb+<th>+,  \verb+<td>+等を使って書く．

HTMLの場合，止むを得ない場合を除いて，表でレイアウトしては
いけない．目の不自由な人にとってメリットが無いからである．

\section{参考文献リスト}

\LaTeX での参考文献リストの標準的な書き方を示すに留める．
\begin{verbatim}
     \begin{thebibliography}{99}
      \bibitem{hogehoge} Lastname, A. and Lastname, B.,
        \newblock \emph{J. Appl. Mech., JSCE,}
        \newblock Vol.4, pp.45-50, 2002.
      ......
     \end{thebibliography}
\end{verbatim}
となる．上記`99'というのは，文献が10以上あることを示しているだけで，
文献リストの番号を表示するときの適正な幅を\TeX に
教えているだけである．10未満の場合は，例えば\verb+{5}+で
よい．数値そのものには意味が無い．{\tt hogehoge}はラベルで，
本文中の引用する箇所で\verb+\cite{hogehoge}+とする．

\section{目次}

長い文章の場合は付けておいた方が便利である．\LaTeX では

\noindent\begin{boxedminipage}[t]{.98\textwidth}
\begin{english}
\mbox{}

\begin{verbatim}
   \tableofcontents
\end{verbatim}

\mbox{}
\end{english}
\end{boxedminipage}
\hfill
\begin{minipage}[t]{.01\textwidth}
~
\end{minipage}
\bigskip

\noindent を付けて2回コンパイルすれば終わりである．HTMLの場合は，
アンカー・タグを利用して目次を作成するのが望ましい．
目次そのものは節・小節・項と深くなるにつれて，入れ子の
箇条書きを利用するのが一番簡単である．例を示しておく．

\noindent\begin{boxedminipage}[t]{.98\textwidth}
\begin{english}
\begin{verbatim}
 <big><b>もくじ</b></big>
 <ul>
  <li><a href="#1st">文書の記述法</a>
   <ul>
    <li><a href="#1st1">表現と中身</a>
    <li><a href="#1st2">論文・報告</a>
    <li><a href="#1st3">記述言語</a>
    <li><a href="#1st4">文章の記述法</a>
   </ul>
  <li><a href="#2nd">LaTeX と HTML の基本的な設定部分</a>
 ....
 </ul>
 <p>
 <a name="1st"> <h2>文書の記述法</h2> </a>
  <a name="1st1"> <h3>表現と中身</h3> </a>
   ここが最初の小節・・・
\end{verbatim}
\end{english}

\mbox{}
\end{boxedminipage}
\hfill
\begin{minipage}[t]{.01\textwidth}
~
\end{minipage}

\section{音について}

HTMLの場合の効果音の付け方には工夫が必要である．
特にJavaを起動するような場合には，訪問者の負担になるので
止めた方がよい．音は利用者の選択で聴けるように，
スタート・ボタン等を付けた方がよい．
また，長い音楽を流し続けるのは，目の不自由な人が
利用している「ページ読みソフト」の出力判別の妨げになるので
避けるべきである．

\section{JavaScriptについて}

サンプル・ソース付きの便利なサイトをいくつか紹介しておく．
\begin{itemize}
\item  \htmladdnormallink{DOKUGAKU JavaScript}{http://www.ueda.info.waseda.ac.jp/~gaku/js/}
\item  \htmladdnormallink{JavaScript laboratory}{http://www4.justnet.ne.jp/~worldwar/js/index.html}
\item  \htmladdnormallink{JavaScript Made Easy!!}{http://www.easyjavascript.com/javascript.html}
\item  \htmladdnormallink{Timothy's JavaScript Examples}{http://www.essex1.com/people/timothy/js-index.htm}
\item  \htmladdnormallink{Nic's JavaScript Page}{http://www.geocities.com/\%7Ejsmaster/}
\end{itemize}
なお，中にはブラウザ依存のものもあるが，
可能な限りそういった方法は使わない方が良いのは当然である．

\end{document}
