アスキーアート表示プラグインとは?

基本情報

プラグイン名
aapro
種別
ブロック型プラグイン
書式
#aapro{{
アスキーアート1行目
アスキーアート2行目
  
  
  
アスキーアート最後の行
}}
概要
プロポーショナルフォントで描かれたアスキーアートをPukiWikiできれいに表示するプラグインです。

詳細

このプラグインはsue445さんのアスキーアート出力プラグインを改造した物です。
オリジナルのプラグインはWindowsに特化しているらしくMacではうまく表示されないので改造しました。
主に2ちゃんねるのアスキーアートをターゲットにしています。

IPAモナーフォントにも対応。なので MS Pゴシックを手に入れることができない環境(Linux など)でもOK。

v(バージョン)1.4.6以上のPukiWikiで利用可能。ソフトウェアライセンスはGNU GPL 2です。

ちなみに "aapro" の名前の由来は、
ASCII art drawn with a proportional font プロポーショナルフォントで描かれたアスキーアート)

リリース情報

バージョンリリース年月日概要
1.012006-09-05初リリース
1.022007-01-11URLを自動的にリンクに変換する機能を追加
1.032008-02-17バグフィックス版。pukiwiki.dev:BugTrack2/29に従い定数名を修正しました。機能に変更はありません。
1.042008-09-15以前のバージョンにあった、横に長いAAを貼るとレイアウトが崩れる問題を回避
 

使用例

#aapro{{
        _,,:-ー''" ̄ ̄ ̄ `ヽ、
     ,r'"           `ヽ.
 __,,::r'7" ::.              ヽ_
 ゙l  |  ::              ゙) 7
  | ヽ`l ::              /ノ )
 .| ヾミ,l _;;-==ェ;、   ,,,,,,,,,,,,,,,_ ヒ-彡|
  〉"l,_l "-ー:ェェヮ;::)  f';;_-ェェ-ニ ゙レr-{
  | ヽ"::::''   ̄´.::;i,  i `'' ̄    r';' }
 . ゙N l ::.  ....:;イ;:'  l 、     ,l,フ ノ
 . |_i"ヽ;:...:::/ ゙'''=-='''´`ヽ.  /i l"
   .| ::゙l  ::´~===' '===''` ,il" .|'".
    .{  ::| 、 :: `::=====::" , il   |
   /ト、 :|. ゙l;:        ,i' ,l' ノト、
 / .| \ゝ、゙l;:      ,,/;;,ノ;r'" :| \
'"   |   `''-、`'ー--─'";;-'''"   ,|   \_
}}

     ↓

        _,,:-ー''" ̄ ̄ ̄ `ヽ、
     ,r'"           `ヽ.
 __,,::r'7" ::.              ヽ_
 ゙l  |  ::              ゙) 7
  | ヽ`l ::              /ノ )
 .| ヾミ,l _;;-==ェ;、   ,,,,,,,,,,,,,,,_ ヒ-彡|
  〉"l,_l "-ー:ェェヮ;::)  f';;_-ェェ-ニ ゙レr-{
  | ヽ"::::''   ̄´.::;i,  i `'' ̄    r';' }
 . ゙N l ::.  ....:;イ;:'  l 、     ,l,フ ノ
 . |_i"ヽ;:...:::/ ゙'''=-='''´`ヽ.  /i l"
   .| ::゙l  ::´~===' '===''` ,il" .|'".
    .{  ::| 、 :: `::=====::" , il   |
   /ト、 :|. ゙l;:        ,i' ,l' ノト、
 / .| \ゝ、゙l;:      ,,/;;,ノ;r'" :| \
'"   |   `''-、`'ー--─'";;-'''"   ,|   \_

 

実体参照も使えます。

#aapro{{
♠ ♦ ♥ ♣
}}

     ↓

♠ ♦ ♥ ♣

URLは自動的にリンクに変換されます。
プラグインの設定によって自動リンクを許可しないようにすることもできます。

このサイトのURL
 http://warota.web5.jp/

先頭のhを抜いたURLはリンクされない
 ttp://warota.web5.jp/

使用上の注意点

その1

アスキーアートの中に

}}

が含まれているとエラーとなります(Wikiの仕様)。
この場合、最初と最後の中括弧の数を増やせば、正しく表示する事が出来ます。

 

エラーの例 エラーの例

#aapro{{
  /゙ ゙.";ヽゞ'-、、
 .jミノ,ノノ~ ̄""''ヽミ!
 i ノハー′     .iミ!
 iミ! ,--、_ ,_,,,..、、.i;;l
 }iト  ィェァ} (ェoァ j}}
  レl  .ノ,!_!、   j-'
   l  /_二'_、〉 .ij
-ー;丶、  ̄  ノ;ー-、,
;;;;;;;;;;/;;;\ニ//;;ヽ;;;;;;;;;;
;;;;;;;;;;ヽヽ .};;{ /;;;;;/;;;;;;;;;;;
}}

     ↓

#ref(): File not found: "error.png" at page "アスキーアート表示プラグイン"

 

対処法

#aapro{{{{
  /゙ ゙.";ヽゞ'-、、
 .jミノ,ノノ~ ̄""''ヽミ!
 i ノハー′     .iミ!
 iミ! ,--、_ ,_,,,..、、.i;;l
 }iト  ィェァ} (ェoァ j}}
  レl  .ノ,!_!、   j-'
   l  /_二'_、〉 .ij
-ー;丶、  ̄  ノ;ー-、,
;;;;;;;;;;/;;;\ニ//;;ヽ;;;;;;;;;;
;;;;;;;;;;ヽヽ .};;{ /;;;;;/;;;;;;;;;;;
}}}}

     ↓

  /゙ ゙.";ヽゞ'-、、
 .jミノ,ノノ~ ̄""''ヽミ!
 i ノハー′     .iミ!
 iミ! ,--、_ ,_,,,..、、.i;;l
 }iト  ィェァ} (ェoァ j}}
  レl  .ノ,!_!、   j-'
   l  /_二'_、〉 .ij
-ー;丶、  ̄  ノ;ー-、,
;;;;;;;;;;/;;;\ニ//;;ヽ;;;;;;;;;;
;;;;;;;;;;ヽヽ .};;{ /;;;;;/;;;;;;;;;;;

その2

AAに機種依存文字が含まれていると文字化けすることがあります。
似たような文字に置き換えてください。

インストールの手順

プラグインファイルの追加

このファイルをダウンロード・解凍して「plugin」フォルダ内に入れてください。

Unicode でエンコーディングしていますので、EUC 版をお使いの方はテキストエディタなどでエンコーディングを変換してください。変換しなくても一応動きます。

なおv1.03とv1.04の内容はほとんど変わらないので、v1.03からv1.04へアップグレードする場合は、プラグインファイルの更新は必要ではありません。

PukiWiki設定ファイルの編集

MarronWiki:Pluginsより引用

デフォルトでは複数行引数はOFFになっているので、pukiwiki.ini.phpの56行目の以下のところで1になっている部分を0に変えてください。

define('PKWKEXP_DISABLE_MULTILINE_PLUGIN_HACK', 1); // 1 = Disabled

スタイルシートの編集

v1.03 以前から v1.04 へのアップグレード

v1.03 以前から v1.04 へアップグレードする場合は skin/pukiwiki.css.php の p.aapro に次の2つの宣言を書き加えて下さい。

	white-space:nowrap;
	width:auto;

これで終わりです。

方法1(このサイトの現在の設定)

CSSファイルに以下のテキストを追記してください。
font-size から white-space までの行がアスキーアートの表示に大きく関わっている部分なので、編集の際は十分注意して下さい。

/* aapro.inc.php */
p.aapro {
	font-size:16px;
	font-family:'Mona','IPAMonaPGothic','IPA モナー Pゴシック',Monapo,Mona,'MS PGothic','MS Pゴシック',sans-serif;  /* 5ちゃんねるwiki (https://info.5ch.net/index.php/アスキーアート)より引用 */
	line-height:110%;
	width:auto;
	white-space:nowrap;
	color:black;
	background-color:#F0F0F0;
	padding:.5em;
	border-top:#DDD 1px solid;
	border-bottom:#888 1px solid;
	border-left:#DDD 1px solid;
	border-right:#888 1px solid;
	margin-left:1em;
	margin-right:1em;
}

方法2

CSSファイルの40行目辺りに body,tdの 設定項目があります。

body,td {
	color:black;
	background-color:white;
	margin-left:2%;
	margin-right:2%;
	font-size:90%;
	font-family:verdana, arial, helvetica, Sans-Serif;
}

ここの font-size とfont-family の行をコメントアウトするか削除してください。

それと、以下のテキストを追記してください。
font-size から white-space までの行がアスキーアートの表示に大きく関わっている部分なので、編集の際は十分注意して下さい。

/* aapro.inc.php */
p.aapro {
	font-size:100%;
	line-height:110%;
 	width:auto;
	white-space:nowrap;
	border-top:#DDD 1px solid;
	border-bottom:#888 1px solid;
	border-left:#DDD 1px solid;
	border-right:#888 1px solid;
	padding:.5em;
	margin-left:1em;
	margin-right:1em;
	color:black;
	background-color:#EEE;
}

方法3

Internet Explorer 6 対応版です。非推奨。CSSが PHP ファイルである必要があります。

skin/pukiwiki.css.php の40行目辺りに body, td の設定項目があります。

body,td {
	color:black;
	background-color:white;
	margin-left:2%;
	margin-right:2%;
	font-size:90%;
	font-family:verdana, arial, helvetica, Sans-Serif;
}

ここの font-family の行をコメントアウトするか削除してください。

それと、以下のテキストを追加してください。
font-size から white-space までの行がアスキーアートの表示に大きく関わっている部分なので、編集の際は十分注意して下さい。

/* aapro.inc.php */
p.aapro {
<?php   if (preg_match('/MSIE [4-6].+Win/', $_SERVER['HTTP_USER_AGENT'])) { ?>
	font-size:small;
<?php   } else { ?>
	font-size:medium;
<?php	}?>
	white-space:nowrap;
	width:auto;
	line-height:110%;
	border-top:#DDD 1px solid;
	border-bottom:#888 1px solid;
	border-left:#DDD 1px solid;
	border-right:#888 1px solid;
	padding:.5em;
	margin-left:1em;
	margin-right:1em;
	color:black;
	background-color:#EEE;
}

これを使用する際には、ブラウザのユーザーエージェントを偽装している人に問題が発生する場合があるので
ユーザーエージェントを変えるようにアナウンスする必要があるでしょう。

例文
注意:ウェブブラウザのユーザーエージェントを偽装している方へ
このサイトではアスキーアートをきれいに表示する為に、 ウェブブラウザの種類によってアスキーアートの文字サイズの最適化を行っております。
そのため、Opera や FireFox 等のブラウザで、ユーザーエージェントを IE に偽装している場合に アスキーアートの文字サイズが本来の設定よりも小さく表示される事があります。
また、IE コンポーネントブラウザにおいてユーザーエージェントを「IE 系でない」ように偽装している場合にも 同様の問題が発生するかもしれません。
このサイトを閲覧される際にはユーザーエージェントの設定を元に戻してください。
 
*補足説明
p.aapro のプロパティ "font-size" の値をキーワード "medium"(標準の大きさ)で指定する事で body や他の親要素の font-size の値に依存せずにAAを表示できるはずですが、 IE 6.0 以前でPukiWikiをブラウズするときには "small" がブラウザ標準のフォントサイズになる *1 という困った仕様があるので、ブラウザが IE 6.0 以前の場合は "font-size" の値を "small" となるようにしなければいけません。 この条件分岐を行ったのが上記のコードです。
追記:IEコンポーネントブラウザの中に、ユーザーエージェントの値に「MSIE」を含まない(意図的に隠す場合が多いらしい) ものがあるそうなので、上記の説明文にそのことについてのアナウンスを追記しておきます。

プラグインの設定

デフォルトでは、AA中のURLは自動的にリンクに変換されます。
自動リンクを許可しない場合は、aapro.inc.phpファイルの15行目辺りにある「URLの自動リンクを許可するかどうかの設定」を編集してください。

Monobook skin へのインストール

2020/11/19 更新

ここではMonobook skin を使用している場合のプラグイン導入法を説明します。
以下の説明は「スタイルシートの編集」の「方法3」に該当します。
以前の方法ではFireFoxでうまく動作しなかったようなので改善しました。

なお、動作テストはまだ十分には行えておりませんので、悪しからず。

プラグインファイルの追加

同上

PukiWiki設定ファイルの編集

同上

スタイルシートの編集

CSSファイルを次のように編集します。(マイナスの付いた行は削除、プラスの付いた行を追記)

body {
-	font: x-small sans-serif;
+	font-size: x-small;
	background: #f9f9f9 url(headbg.jpg) 0 0 no-repeat;
	color: black;
}
/* IE6 + EUC */
* html body {
-	font: xx-small Arial, sans-serif;
+	font-size: xx-small;
}
/* IE7 + EUC */
*+html body {
-	font: x-small Arial, sans-serif;
+	font-size: x-small;
}
/* Opera8 */
*+html > /**/body {
-	font: x-small sans-serif;
+	font-size: x-small;
}

それからCSSファイルに以下のテキストを追加してください。
font-size から white-space までの行がアスキーアートの表示に大きく関わっている部分なので、編集の際は十分注意して下さい。

/* aapro.inc.php */
p.aapro {
	font-size:16px;
	font-family:'Mona','IPAMonaPGothic','IPA モナー Pゴシック',Monapo,Mona,'MS PGothic','MS Pゴシック',sans-serif;  /* 5ちゃんねるwiki (https://info.5ch.net/index.php/アスキーアート)より引用 */
	line-height:110%;
	width:auto;
	white-space:nowrap;
	color:black;
	background-color:#F0F0F0;
	padding:.5em;
	border-top:#DDD 1px solid;
	border-bottom:#888 1px solid;
	border-left:#DDD 1px solid;
	border-right:#888 1px solid;
	margin-left:1em;
	margin-right:1em;
}

コメント

PukiWikiなので他人が書き込んだレスも自由に編集できてしまいます。

SPAM対策のため、投稿にIDとパスワードの入力が必要です。


*1 すなわち "font-size" の値を "medium" に設定すると、IEでは標準の文字サイズの約1.2倍の大きさで表示されてしまう

添付ファイル: fileaapro.inc.php.zip 520件 [詳細]

トップ   編集 凍結解除 差分 バックアップ 添付 複製 名前変更 リロード   新規 一覧 検索 最終更新   ヘルプ   最終更新のRSS
Last-modified: 2020-11-19 (木) 23:58:27