ref
Top / plugin / ref
ref †
種別
ブロック型プラグイン
インライン型プラグイン
書式
ブロック型
#ref( <ファイル指定>,<表示方法指定(複数可)>,<タイトル指定>)
#ref( 添付ファイル名| ページ名/添付ファイル名| URL [,ページ名]| ファイルパス {, [left|center|right], [wrap|nowrap], [around], [noicon], [noimg], [nolink], [zoom|max|min], [999x999], [fit], [999%], [resize] } [,タイトル] )
インライン型
&ref( <ファイル指定>,<表示方法指定(複数可)>,<タイトル指定>);
&ref( 添付ファイル名| ページ名/添付ファイル名| URL [,ページ名]| ファイルパス {, [left|center|right], [noicon], [noimg], [nolink], [zoom|max|min], [999x999], [fit], [999%], [resize] } [,タイトル] );
概要
ページに添付されたファイルを表示します。
画像ファイル(.jpg .png .gif)は画像を表示します。
それ以外の場合(.pdf .xls .doc など)はダウンロード用のリンクが表示されます。 ビットマップ(.bmp)は画像ではなく、リンクが表示されます。 >> ref プラグインの表示例
引数
添付ファイル名に、ページに添付したファイル名を指定します(省略時はエラーになります)。 「ページ名/添付ファイル名」で別ページの添付ファイルも指定できます。 ページ名にはファイルを添付したページをWikiNameかBracketNameで指定します。このオプションは最初(添付ファイル名の次)に記述してください。省略時は設置したページです。 FTPでアップロードしたファイルのファイルパスも指定できます。 >> WikiPlusのディレクトリ構造
以下の引数を組み合わせて、ファイルの表示方法を指定できます。
left,center,right 表示時の位置を指定します。省略時:left wrap,nowrap テーブルタグで囲む/囲まない を指定します。省略時:nowrap ブロック型プラグインの、#ref で使用できます。 around テキストの回り込みを指定します。省略時:回り込みしない ブロック型プラグインの、#ref で使用できます。 noicon ファイルが画像以外の場合に表示されるアイコンを表示しません。 省略時:表示する noimg ファイルが画像の場合に画像を展開しないようにします。 省略時:展開する nolink 元ファイルへのリンクを張らない指定にします。 省略時:リンクする zoom,max,min 画像の縦横比(アスペクト比)を保持します。 max は、表示する最大サイズを指定します。指定サイズより大きな画像は、指定サイズを超えない最大の大きさで表示します。小さい場合は、そのまま表示します。 min は、指定したサイズより小さな画像の場合に、指定したサイズで表示します。大きい場合は、そのまま表示します。 省略時:サイズ指定に従う 999x999 ピクセル単位(幅×高さ)で画像の表示サイズを指定します。 省略時:倍率指定に従う。何も対象画像のサイズ の順で表示 指定の書式 500x300 幅 と 高さ を指定 500x 幅 だけを指定(高さ は対象画像のサイズ) x300 高さ だけ指定(幅 は対象画像のサイズ) * x(英小文字エックス)の代わりに、 *(アスタリスク)も使用できます fit あらかじめ指定された幅に対して表示倍率を適用します。 指定がない場合は、800ピクセルが適用されます。 »幅の指定方法 999% サイズを指定(倍率)します。省略時:100% resize 画像ファイルをリサイズします。データサイズが小さくなるためページの表示速度が向上します。(透過png、透過gif については対応しておりません。) 省略時:もとのデータサイズで表示します。 caption、captiontop タイトルに指定した文字列を画像のキャプション(注釈)として表示します。 caption(下付きキャプション)captiontop(上付きキャプション) 省略時:キャプションを表示しない タイトル 上記以外のパラメータは画像の代替文字列(alt属性)、リンクのタイトル属性として使用されます。指定しない場合には、ファイル名が表示されます。 ページ名やパラメータと同じ文字列を使用するときには、#ref(xxxxxx.jpg,,zoom)のように表示したいタイトルの前にカンマを余分に入れます。