「編集ガイド」の編集履歴(バックアップ)一覧はこちら
編集ガイド - (2018/10/31 (水) 18:12:57) の最新版との変更点
追加された行は緑色になります。
削除された行は赤色になります。
管理人が編集するときのページレイアウトを紹介します。これに従う必要は全くありませんが、参考になれば幸いです。
----
**wikiの登録・ログイン
''現在、一時的にwikiに編集制限を設定しています。''
編集を希望する方は、右上の''「このウィキに参加」''からメンバー登録を行ってください。
現在、登録は自動承認制です。登録にはログインID・パスワード、メールアドレスが必要になります。
wikiメンバーの権限は以下の通りです。
-編集制限がかかっているときにも、wikiページの編集権限を持つ。
-編集制限がかかっていないとき、編集実行時の文字入力承認が不必要になる。
-閲覧制限のあるページにもアクセスできる(現在そのようなページはありませんが…)。
高度な設定(ページやアップロード画像の削除、CSSスタイル設定など)は''管理者のみ可能''です。
登録が上手く行かない場合は管理人まで問い合わせ願います。
**目次・コメント
ページの一番上には基本的に目次を作る。
#contents(,fromhere=true,level=3)
----
で、「***」までの見出しが表示される。
ページの一番下にはコメントボックスを置く。
----
**コメント
#comment()
投稿されたコメントは本文テキストと同じ扱いとなり、編集画面で編集可能。
上の例のように、本文と目次・コメントの間には仕切り線「&nowiki(){----}」を入れる。
**本文
中途半端な長さの文の後に改行するとスマホ版で読み辛くなってしまうので、''長い段落中の改行は出来る限り少なくする''とよい。ただし箇条書きに近い短文が続く場合など、改行した方が見やすいこともある。段落は2~5文程度の同じ内容を持つ文章で形成し、段落間には1行の空行を入れるとよい。
**見出し
**(h2):ページ内で数回出てくるような規模の見出し
*** (h3):小見出し
****(h4), *****(h5):極小見出し、強調
「**」(h2)の前には空行を2行、「***」(h3)の前には1行挿入する。
「****」(h4),「*****」(h5)は見出しの他に、強調としても使える。
「*」(h1) は使用できるが非推奨。
**文字装飾
****太字
&b(){太字} または ''単語''
は、単語や短いフレーズ、特別に強調したい文に使用。
****下線
&u(){下線}
は、少し強調したい文・フレーズに使用。
****色文字
&color(red){文字}
管理人は使いこなせていない。
**箇条書き
箇条書きの領域は、上下の本文との境界に
-この程度の余白が
生まれる。
+A
+-B
+C
と書くと、標準と番号付のものを組み合わせられる(↓)。
+A
+-B
+C
**整形済みテキスト
整形済みテキスト(行頭に半角スペース)
は、計算式やACMDなどのコマンドを載せるときに使う。
整形済みテキスト内では、文字装飾や箇条書きなどのプラグインが動作しない。
**引用
>引用
は、説明文などを目立たせるときに使う。
**数式
検証wikiではTexlikeモードをONにしているので、「$$」で挟まれた領域にTex形式で数式を打ち込める。ただし行幅が固定なので分数表記には向かない。他サイトへのコピー&ペーストも考え、整形済みテキストを一応推奨しておく。
**表
|A|B|C|h
|a|b|c|
|a|b|c|
|a|b|c|
|a|b|c|
#table_sorter(){head=#d6f,odd=#f0f0f0,even=#ffffff,repeathead=10}
で、
-先頭行をヘッダーに指定
-並び替え可能
-縞模様
-10項目ごとにヘッダー繰り返し
の表が作れる。表の作成には、Excelの表をwiki形式に変換するツールを使うと便利。
参考:
-[[WikiサポートExcelアドイン>>https://www.ideamans.com/software/wiki-support-addin/]]
-[[Excelの表をWiki形式に変換するjsフォーム>>https://tools.racing-lagoon.info/excel2wiki]]
**画像
標準の画像表示:
#image(.png,width=640)
widthまたはheightで大きさを一辺だけ指定すると、もう一辺は縦横比を保存したままリサイズされる。
クリックで画像を新しいタブに表示させるには、
&blankimg(,width=640,height=360)
こちらは縦横両方ともサイズを指定しないと、指定の無い辺の長さが128pxになってしまうので注意。
**リンク
wiki内ページであれば、
[[リンクするページ名]]
と書くのがシンプルで良い。あるページのある見出しに飛ぶには、その見出しのリンクURLを貼らなければならず面倒。
外部ページへのリンクは
[[表示するテキスト>>URL]]
で、新しいタブでリンクを開くようにしている。">"が1つだと直接そのページに移動。
----
**コメント
#comment()
当wikiを編集する際のノウハウを伝授します。
atwikiの編集プラグインについては''[[atwikiご利用ガイド>>https://www1.atwiki.jp/guide/]]''で調べてください。
#contents(,fromhere=true,level=3)
----
**wikiの登録・ログイン
''現在、一時的にwikiに編集制限を設定しています。''
編集を希望する方は、右上の''「このウィキに参加」''からメンバー登録を行ってください。
現在、登録は自動承認制です。登録にはメールアドレスが必要になります。
wikiメンバーの権限は以下の通りです。
-編集制限がかかっているときにも、wikiページの編集権限を持つ。
-編集制限がかかっていないとき、編集実行時の文字入力承認が不要になる。
-閲覧制限のあるページにもアクセスできる。&footnote(現在、恒久的に閲覧制限をかけているページはありませんが…)
また、wiki管理者は
-個別ページに対する閲覧・編集権限の設定
-編集モードの変更
-アップロードファイルの削除
をwikiメンバーに付与することができます。
これらの機能が必要な方は管理人まで連絡ください。
高度な設定(ページ削除、CSSスタイル設定など)は''管理者のみ可能''です。
**掲載ページに迷ったら
&u(){ページ:''[[小ネタ]]''に載せてください。}
数行で収まるような内容ならば、これらのページに見出しを一つ追加して掲載してください。
検証wikiの項目にない良い記事を見つけたときや、自身のブログなどに検証内容をまとめた場合は、
ページ:[[小ネタ]]に項目を追加するか、メニューの「その他」にリンクを作成してください。
「**」クラスの見出しが2つ以上作れるときや、独立したページを作る価値があるネタについては新規ページを作成してください。
ページ:[[小ネタ]]の内容が膨れ上がった場合は、新規ページを作って内容を移動しましょう。
「ギリギリで独立ページになったネタ」として、for検証wikiの次のページを判断基準にするとよいと思います。
-[[for_ベクトル合成>>https://www30.atwiki.jp/ssb4_kensyou/pages/122.html]]:内容の量のボーダーライン。
-[[for_ポート>>https://www30.atwiki.jp/ssb4_kensyou/pages/130.html]]:量としては若干足りないが、関連する項目が無いため独立して作るべきだと判断。
**ページ作成
複数のページ編集モードがありますが、''基本的にatwikiモードを推奨''します。
ページ作成後は、「メニューの編集」で''メニューにページを追加''してください。
**ページレイアウト・一行の文字数
2019/6/9現在、PC版のページレイアウトを
-本文:14 px
-最小本文幅:840 px
-最小全体ページ幅:1280 px
に設定しています。
この設定の下では、''本文1行につき60文字''までであれば、PCブラウザのウィンドウサイズによらず折り返しが発生しません。&footnote(全角の場合)
このため、''一文をなるべく60文字以下に収め、一文ごとに改行する''ことを推奨します。
60文字を超える文は、区切りの良い所で改行して2行にすると良いでしょう。
''左メニューは1行につき10文字''までならば一行に収まります。&footnote(全角の場合。箇条書き記号を含む)
ページ名が10文字を超える場合、「&nowiki(){[[ページ略称>>リンクするページ名]]}」の書式でメニューに登録してください。
スマホ版は、おおむね''本文1行あたり20文字''で表示されます。
ただし端末に大きく依存するため、編集時にはあまり気にしなくて良いです。
**編集プラグインの用例
管理人のプラグインの使い方を紹介します。
これに従う必要は全くありませんが、参考になれば幸いです。
***目次・コメント
ページの一番上には基本的に目次を作る。
「***」までの見出しを表示するには、
#contents(,fromhere=true,level=3)
----
ページの一番下にはコメントボックスを置く。
----
**コメント
#comment() あるいは #pcomment(reply)
上の例のように、本文と目次・コメントの間には仕切り線「&nowiki(){----}」を入れる。
-「&nowiki(){#comment()}」タイプは、投稿コメントが本文テキスト扱いとなり、ページ編集で編集可能となる。
-「&nowiki(){#pcomment(reply)}」タイプは、ツリー形式のコメントが別ページ扱いで展開される。
***見出し
見出しの規模は次のように使い分けるとよい。
**(h2):ページ内で数回出てくるような規模の見出し
*** (h3):小見出し
****(h4), *****(h5):極小見出し、強調
「**」の前には空行を2行、「***」の前には1~2行挿入するのが目安。
「****」,「*****」は見出しだけでなく強調としても使える。
「*」(h1) も使用できるが、atwikiでは利用を推奨していない。
***文字装飾
****太字
書式: &b(){太字} または ''太字''
単語や短いフレーズ、強調したい文に使用する。
強調には、基本的に太字を使えばよい。
シングルクォート2つ('')で囲う形式は、中身にスペースが入っていると上手く機能しない。
****下線
書式:&u(){下線}
少し強調したい文・フレーズに使用する。太字と組み合わせるのもよい。
****色文字
書式:&color(red){文字} もしくは &color(red,blue){文字}
性質の違うものとして注意を惹きたい箇所に使う(変更点など)。太字と組み合わせるのもよい。
色を1つ指定すると文字色が変わる。2つ指定すると、1つめが文字色・2つめが背景色になる。
( )内に使える色は、[[atwikiで使える英語色名の一覧>>https://www65.atwiki.jp/atwikicolor/]]にまとめられている。
例:&color(red){red}, &color(blue){blue}, &color(yellow){yellow}, &color(orange){orange}, &color(green){green}, &color(purple){purple}
***箇条書き
書式: -(番号無) もしくは +(番号付)
箇条書きの領域は、上下の本文との境界に
-この程度の余白が
生まれることに留意。
入れ子構造の箇条書きでは、標準と番号付の箇条書きを組み合わせることも可能である。
+大乱闘スマッシュブラザーズSPECIAL
+大乱闘スマッシュブラザーズfor
+-大乱闘スマッシュブラザーズfor3DS
+-大乱闘スマッシュブラザーズforWiiU
+大乱闘スマッシュブラザーズX
***整形済みテキスト
書式: 行頭に半角スペース
計算式や解析データのスクリプトなどを載せるときに使う。
整形済みテキスト内では、文字装飾や箇条書きなどのプラグインが無効になる。
****数値強調(等幅プラグイン)
書式:&tt(){テキスト}
&tt(){12%}のように、文章中で数値を目立たせたいときに使用する。
この等幅プラグインの装飾は当wiki独自のものである。
***引用
書式:行頭に ">"
公式情報や他サイトからの引用に使う。
***divclass
書式:#divclass(class名){テキスト}
当wikiのCSS設定で定義したclassの書式をテキストに適用する。
当wikiが現在定義しているclassは、
-&bold(){bggray}
-&bold(){caution}
-&bold(){box1}
-&bold(){box2}
である。
#divclass(bggray){
bggray
}
#divclass(caution){
caution
}
#divclass(box1){
box1
#divclass(box_title){box1_title1}
#divclass(box_title2){box1_title2}
#divclass(box_title3){box1_title3}
}
#divclass(box2){
box2
#divclass(box_title){box2_title1}
#divclass(box_title2){box2_title2}
}
***数式
検証wikiではTexlikeモードをONにしている。
Tex形式の記述を「$$」で挟むと画像として数式を表示できる。
ただし行幅が固定なので分数表記には向かない。
他サイトへのコピー&ペーストも考えて、''数式は整形済みテキストで打ち込む''ことを推奨しておく。
***表
例えば、
-先頭行をヘッダーに指定
-並び替え可能
-縞模様
-10項目ごとにヘッダー繰り返し
の表は、以下のように作成する。
|A|B|C|h
|a|b|c|
|a|b|c|
|a|b|c|
#table_sorter(){head=#d6f,odd=#f0f0f0,even=#ffffff,repeathead=10}
表の作成には、Excelの表をwiki形式に変換するツールを使うと便利である。
-[[WikiサポートExcelアドイン>>https://www.ideamans.com/software/wiki-support-addin/]]
-[[Excelの表をWiki形式に変換するjsフォーム>>https://tools.racing-lagoon.info/excel2wiki]]
***画像
まず、ページに使いたい画像を「このページにファイルをアップロード」からアップロードする。
画像表示にはimageコマンドを使う。
書式:#image(sample.jpg, width=480, https://img.atwikiimg.com/www65.atwiki.jp/smashsp_kensyou/attach/15/651/sample.jpg)
#image(sample.jpg, width=480, https://img.atwikiimg.com/www65.atwiki.jp/smashsp_kensyou/attach/15/651/sample.jpg)
widthまたはheightで大きさを一辺だけ指定すると、もう一辺は縦横比を保存したままリサイズされる。
スマホ版ページは横幅を自動調整して表示してくれるので、PC版でのレイアウトだけを考えて表示サイズを決めればよい。
&bold(){横幅 = 480px, 640px}あたりが目安となる。
画像クリックで拡大表示させるには、画像のURLをimageコマンド内に追加する。
「このページにファイルをアップロード」>アップロードされたファイル一覧
から、画像ファイルのリンクアドレスをコピーするのが一番手軽。
****キャラクターアイコン
atwikiでは、wiki内の他のページにアップロードしてある画像を参照できる。
例えば複数のファイターを挙げるとき、ページ:[[アイコン]]にあるストックアイコンを利用すると綺麗にまとまるだろう。
アイコンを横に並べる場合、"inline"オプションを使って下のように記述するとよい。
&image(inline, page=アイコン, mario.png)&image(inline, page=アイコン, luigi.png)
上の表示例:&image(inline, page=アイコン, mario.png)&image(inline, page=アイコン, luigi.png)
***リンク
wiki内ページであれば、シンプルに以下の形で書くのが良い。
[[リンクするページ名]] または [[ページ略称>>リンクするページ名]]
新しいタブで外部ページを開くリンクは以下のように作成する。">"が1つだと直接そのページに移動する。
「あるページのある見出し」に飛ばすには、そのページの目次にある見出しリンクURLをコピー&ペーストし、↓のURLとして入力する。
[[表示するテキスト>>URL]]
----
**コメント
#comment()