Help:リンクとwiki文法

出典: STARBOOK WIKI

目次

 

ほとんどの場合において、文章編集はWYSIWYGエディタですんでしまいます。ですがWSYSIWYGエディタは完璧ではなく、たまに文章が崩れる事があります。そのような場合には、エディタ左上にあるWikietextボタンをクリックすることで、WYSIWYGモードをoffにして直接入力モードを利用し編集します。

Wikitextモードでは、いわゆる英語系のwiki文法（pukiwiki系のものとは記法が異なります）を利用します。

以下、wiki文法の簡単な説明を示します。

見出し

見出しは半角イコール(=)で見出しにしたい行を囲みます。この際、イコールの数で見出しの段数が決まります。

見出し１を作成したい場合は前後にイコールを1個ずつ付与します。 

= 見出し１の文章です =

同様に、見出し２、３，４を作成する場合は、それぞれに合った個数のイコールを付与します。 

== 見出し２ ==
=== 見出し３ ===
==== 見出し４ ====

見出し付けのルール

見出しは、ページの先頭が自動的に見出し1に設定されます。

ですので、執筆時は必ず見出し２を最上段の見出しとして利用してください。そうしないと、ページタイトルが複数存在する誤ったページになってしまいます。

リンク

リンクしたい対象によっては幾つか異なる方法が存在します。


wiki内リンク

STARBOOK wiki内の別のページへのリンクを作成するには、二重の半角角括弧[]で囲みます。

例えば 

光軸調整については[[反射鏡/光軸調整]]を参照してください。

は、次のように表示されます。

光軸調整については反射鏡/光軸調整を参照してください。


リンクに対して、リンク先と異なる文を与えたい場合、パイプ文字を組み合わせて記述します。 

光軸調整については[[反射鏡/光軸調整|こちら]]を参照してください。
光軸調整についてはこちらを参照してください。



一般のWebページへのリンク

いわゆるhttp://やftp://などのURL表記によるページリンクは、角括弧で囲む事でリンクになります。

この際、リンクの後ろに名称を付与しないと表示が[1]などの数字になります。 

[http://www.google.jp]
[1]


表示名を入力する事で、数字ではなく任意の文字列を表示することが出来ます。 

[http://www.google.jp google]
google


つまり、いわゆるURLのベタ貼りを行ないたい場合は、面倒ですがURLを2回書く事になります。 

[http://www.google.jp http://www.google.jp]
http://www.google.jp


Wikipediaへのリンク

STARBOOK wikiではインターwikiリンク（wiki間リンク）をサポートしています。

他のwikiであっても、STARBOOK wikiが認識しているwikiサイトであればSTARBOOK wikiと同様、ページ名でリンクを貼る事とが出来るという機能です。

この機能を使う事で、STARBOOK wikiに欠けていて他サイトに存在するような情報を、すばやくリンクする事が出来ます。

例えばWikipediaの項目メシエに対してリンクを貼りたい場合は、名前空間Wikipediaを先頭に付与し、次のように記入します。 

[[:Wikipedia:メシエ]]
:wikipedia:メシエ

Wikipedia:ではなく:Wikipedia:となっているのは執筆者がwikiシステムに「参照」動作を望んでいる事を明示的に示す為のおまじないです。頭のコロンに関する詳細は文末の#参照と定義の問題をご覧ください。


リダイレクト

上述したリンクは、すべてページ中に表示され、ユーザーがクリックする事でページの移動が発生するものでした。

これに対してリダイレクトはユーザーがページにアクセスした際に別のページに飛ばす機能です。上述のリンクと組み合わせて利用します。 

#redirect リンク

をページの先頭に埋め込む事でリダイレクトが発動し、別のページへジャンプします。リンクの記法はサイト内リンクでもインターwikiリンクでもかまいません。

但し一般Webページへのリダイレクトは、セキュリティの制約上出来ないようです。

wiki内リンクの例
#redirect [[SX赤道儀]] - ページSXWで利用


インターwikiリンクの例
#redirect [[:wikipedia:メシエ]] - ページメシエで利用



インライン埋め込み

インラインはリンクと似ていますが、リンクが次のページへの入り口を提供するのに対し、インラインでは提示したページの内容をその場に展開します。

テンプレートはこのインラインでの埋め込みを応用した技法の１つです。

利用例としては、このページに最下部に表示されている各ヘルプへのリンクが挙げられます。各ヘルプページでは、あらかじめ作成したTemplate:HelpNavigationを末尾に埋め込んでいます。

別のファイルをわざわざ作成してインラインで埋め込む事のメリットは、以下の通りです。

  • 同じ内容を複数のページで利用したい場合
  • 同一内容が反復して1つのページ内に登場する場合
  • 複数ページの特定項目の内容が完全に統一されている事が求められる場合


文字装飾

色々あります。


ボールド文字

この文章の一部にボールド文字が存在します。 

この文章の一部に'''ボールド'''文字が存在します。


イタリック

この文章の一部にイタリック文字が存在します。 

この文章の一部に''イタリック''文字が存在します。


訂正線

この文章の一部に訂正線が使われています。 

この文章の一部に<strike>訂正線</strike>が使われています。


アンダーライン

この文章の一部にアンダーラインが引かれています。 

この文章の一部に<u>アンダーライン</u>が引かれています。


上付き文字

1GBは1024MBなのか103MBなのか。 

1GBは1024MBなのか10<sup>3</sup>MBなのか。


下付き文字

2H2+O2=2H2O 

2H<sub>2</sub>+O<sub>2</sub>=2H<sub>2</sub>O


箇条書き（番号）

  1. いちぎょうめ
    1. いちぎょうめの1
    2. いちぎょうめの2
  2. にぎょうめ
  3. さんぎょうめ 
#いちぎょうめ 
##いちぎょうめの1 
##いちぎょうめの2 
#にぎょうめ 
#さんぎょうめ


箇条書き（中黒）

  • いちぎょうめ
    • いちぎょうめの1
    • いちぎょうめの2
  • にぎょうめ
  • さんぎょうめ 
*いちぎょうめ 
**いちぎょうめの1 
**いちぎょうめの2 
*にぎょうめ 
*さんぎょうめ


定義と内容

ネットワークカード
ネットワークカードとは一般的にEthernetインタフェースカードの事を指す。Ethernetは80年代に軍事利用目的で米国内にて開発された技術で、当時電話網が障害等により分断され通信不能に陥る事が問題視されていた軍内部において、障害に強い通信網として研究された。
STARBOOK
ヘタレだが憎めない奴。たまに電池が切れる。 
;ネットワークカード 
:ネットワークカードとは一般的にEthernetインタフェースカードの事を指す。
Ethernetは80年代に軍事利用目的で米国内にて開発された技術で、当時電話網が障害等により分断され通信不能に
陥る事が問題視されていた軍内部において、障害に強い通信網として研究された。 

;STARBOOK 
:ヘタレだが憎めない奴。たまに電池が切れる。


クオート

これはくおーとされた文章です。 
<blockquote>これはくおーとされた文章です。 </blockquote>




利用できるHTMLタグ

良くわかりませんが、内部でサニタイズしていますので、危険なタグとみなされるものは排除されます。style属性を使う事も問題ないようです。但しサニタイズされてしって、大変不恰好で冗長的なstyle記法に変換されてしまう事が多いようです。

スタイルをいじったspanタグです 

<span style="font-size: 18px; color: #3366ff;">スタイルをいじったspanタグです</span>


脚注

この文章の末尾には脚注が埋め込まれています。[1] 

この文章の末尾には脚注が埋め込まれています。<ref>これは脚注の文章です。
本文中に書くべき内容ではないが補足を入れておきたい時にでも使ってやってくださいませ。</ref>




脚注は<references />を書いた場所に埋め込まれます。通常は末尾の方に独立して見出し2の項目として脚注欄を設けます。試しに次行に書いてみます。

脚注の例

  1. ↑ これは脚注の文章です。本文中に書くべき内容ではないが補足を入れておきたい時にでも使ってやってくださいませ。



参照と定義の問題

Mediawikiシステムでは参照と定義が同じ記法になってしまっています。この問題はカテゴリを例にして説明するとわかり易いと思います。

例えばカテゴリに所属したい場合、[[Category:全てのカテゴリ]]のような感じで表記します。一方、文章中で全てのカテゴリへのリンクを表示させたい場合も[[Category:全てのカテゴリ]]という記述になってしまいます。システムはユーザーがどちらの動作を望んでいるのかは理解できません。そこで、参照（リンク）の場合は頭に半角コロン(:)を付けて表記しようという決まりにになりました。



"http://www.starbook.jp/Help:%E3%83%AA%E3%83%B3%E3%82%AF%E3%81%A8wiki%E6%96%87%E6%B3%95" より作成