編集ガイド

執筆・編集の際に必要となる基本的な記法についてまとめています。

はじめに

書きかけです。

• ページ内の「目次」は、ページ内の見出し階層から自動生成されます。

本文の編集について

本文・段落について

• 編集画面内での改行は画面には反映されません。以下のいずれかを使わない限り、文章は基本的に一つの段落に連続するとみなされ、文章の幅はウインドウの幅に応じて変化します（リキッドレイアウト）。
• 強制的に改行を行う場合は、行末に
  タグを書いて下さい。
• 一行の空改行で「段落区切り」の扱いになります。
• 二行の空改行で１行分の空きができます。

見出し

見出しは、半角の [ = ]記号を連結する形で、大見出し、中見出し、小見出しを区別します。

 ==大見出し==
 ===中見出し===
 ====小見出し====
 

リスト

番号なしリスト、番号付きリスト、定義リストは以下の書式で実現します。

 * 箇条書きレベル１
 ** 箇条書きレベル２

 # 番号付きリスト レベル１
 ## 番号付きリスト レベル２

 ; 定義リスト 項目 1
 :  定義 1
 ; 定義リスト 項目 2
 :  定義 2-1
 :  定義 2-2
 

斜体・太字・文字色

斜体と太字については シングルクォーテーション ['] を用いて演出します。文字の色については、HTML の span タグとスタイル定義で実現します。

 ''斜体''
 '''太字'''
 '''''太字 & 斜体'''''
 <span style="color:red;">赤い文字列</span>
 

リンクの張り方

リンクには、他のサイトへジャンプする「外部リンク」と、サイト内の別ページへジャンプする「内部リンク」があります。

 外部リンク1：http://www.example.com
 外部リンク2：[ http://www.example.com （リンク文字）]
 
 内部リンク1：[ [（サイト内のページ名）] ]
 内部リンク2：[ [（サイト内のページ名）|（リンク文字）] ]  ※画面には「リンク文字」が表示されます。 

画像の掲載

前提の確認

画像の掲載には、以下の２つの手順が必要となります。

• 当サイトへの画像のアップロード
• 画像を掲載するコードをページ内に記載

画像のアップロードについて

• 画像のアップロードは、左メニュー「ツール」のファイルをアップロード から行います。

• 画像は「半角英数名.拡張子」という名称形式でご用意下さい。

画像の名称は、サイト内でユニーク（唯一の存在）であることが必要です。

氏名をつけて「HanakoKyusanFig01.jpg」などとして下さい。

• 画像は必要最小限にリサイズしてからアップロードして下さい。

以下のサイトを使うと簡単にリサイズできます（幅を 640 などとして変換して下さい）。

Bulk Resize Photos：https://bulkresizephotos.com/

画像を掲載するコード

 書式：[[File : 画像のファイル名 | thumb | left / right | サイズpx | キャプション ]]
 

最もシンプルな記述は、ファイル名と掲載サイズのみを指定する以下の形です。ページ内の掲載したい場所で、以下のコードを記述します。

 [[File:HanakoKyusanFig01.jpg|200px]]
 

サイズは、幅のみを px 単位で指定すれば、縦は自動的に調整されます。

left または right オプションを記入すると、その下の原稿が画像の左右に回り込みます。

 [[File:HanakoKyusanFig01.jpg|right|200px]]
 

必要以上の回り込みを解除するには、文章の末尾に、以下のコードを記載します。

 <br clear=all>
 

キャプションをつけるには、以下のように、thumb（サムネール）オプションとともに、キャプション文字列を記載します。

 [[File:HanakoKyusanFig01.jpg|thumb|right|200px|図1.◯◯◯◯]]
 

以下、全体を網羅したサンプルです。

 [[File:HanakoKyusanFig01.jpg|thumb|right|200px|図1.◯◯◯◯]] 
  
 Lorem Ipsum is simply dummy・・・
 ・・・・・・・・・・・・・・・・・・・
 remaining essentially unchanged.
 
 <br clear=all>
 

図1.◯◯◯◯

Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book. It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged.

動画の埋め込み

前提の確認

• MediaWiki自体は動画のアップも可能ですが、当サイトについては動画のアップロードはご遠慮下さい。
• 動画の掲載を希望される場合は、YouTube等の動画共有サイトへアップロードした後、ページ内に以下のような埋め込みコードを記載して下さい。

動画の埋め込みコード

 書式：{{ #ev:サービス名 | 動画のID | 幅(px) }}
 
 事例：{{#ev:youtube|Us-TVg40ExM|480}}

• 上のように３つの情報を定義記載すると、YouTube等の動画の埋め込みが可能です。

動画のIDとは、YouTubeの場合、動画のURLの v= の後の文字列がそれに該当します。

YouTube以外のサービスも利用できます。サービス名の詳細については こちらの記事をご覧下さい。

表示例

表組み

表組みは慣れないと煩雑な印象を受けると思います。表は画像としてアップする方が簡単です。

 {| class="wikitable"
 ! NAME
 ! 項目A
 ! 項目B
 |-
 | Alice
 | 25
 | true
 |-
 | Steve
 | 30
 | false
 |} 

• {| 表の開始、必須
• |- 表の行、最初の行については省略可能。
•  ! 表のヘッダーセル、省略可能。
• | 表のデータセル、省略可能。
• |} 表の終了、必須

表示例

NAME	項目A	項目B
Alice	25	true
Steve	30	false

記法の詳細（公式ガイド）

より詳細な編集を希望される方は、以下の公式情報をご覧下さい。

• 編集：https://www.mediawiki.org/wiki/Help:Editing_pages/ja
• 書式整形：https://www.mediawiki.org/wiki/Help:Formatting/ja
• リスト：https://www.mediawiki.org/wiki/Help:Lists/ja
• 表組み：https://www.mediawiki.org/wiki/Help:Tables/ja
• 画像：https://www.mediawiki.org/wiki/Help:Images/ja
• リンク：https://www.mediawiki.org/wiki/Help:Links/ja
• ナビゲーション：https://www.mediawiki.org/wiki/Help:Navigation/ja