CSV を表として表示する。
CSV プラグイン
Compatible with DokuWiki
2013-03-06 "Weatherwax", 2012-10-13 "Adora Belle", 2012-01-25 "Angua"
This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.
This extension is not in the 'plugin' or 'template' namespace and is therefore ignored.
このプラグインは元々 Steven Danz が書きました。 現在のバージョンは、他の貢献者によってセキュリティバグが修正され、パッチが組み込まれています。
説明
CVS データを表形式で表示するという単純なプラグインです。
データは <csv> から </csv> の間で文書中に埋め込むか、<csv namespace:test.csv></csv> を利用してメディア領域のファイルから読み込みます。
アップロード済のメディアファイルの代わりに CSV ファイルの HTTP URL の指定もできます。
メディア領域の CSVファイルを使う場合、.csv ファイルがアップロードできるように mime.local.conf に .csv ファイル拡張子を追加する必要があります。 こんな感じで始めることができます：
csv text/csv
<csv> には、ファイル参照と同様に追加オプションを指定することができます。
| オプション | 説明 | デフォルト値 |
|---|---|---|
file=<filename> | <filename> は <namespace:file.csv> か <http url> が可能 | |
hdr_rows=<n> | CSV データの最初の <n> 行を列の見出しとして書式設定する。 | 1 |
hdr_cols=<n> | 行毎の最初の <n> 列を行の見出しとして書式設定する。 | 0 |
span_empty_cols=[01] | 内容のあるセルに続く空セル（隣接したカンマ）毎にセルを横結合する。 | 0 |
delim=<char> | セルの間の区切り文字。タブ区切りファイルの場合 tab を指定します。 | , |
<key>=<value> 形式の他のオプションも可能ですが、CSV データ表示には未使用です。
データの一部にカンマが含まれるセルは、二重引用符で囲まれていることを想定しています。 これは、CSV ファイルをエクスポートする場合、ほとんどシステムにとって標準的な動作です。
CSV ファイルやデータの空行は、表の中の水平区切りとして表示されます。
ダウンロード
手動で、又はプラグイン管理を使用してこのプラグインをインストールするのに、以下の URL を使います：
変更履歴
- Version upped (2022-01-03 23:50)
- code style cleanup (2022-01-03 16:51)
- test cleanup and PHP8 fixes (2022-01-03 16:41)
- wrap contents in thead and tbody tags (2021-11-12 03:08)
- Version upped (2021-02-18 23:50)
- Merge pull request #21 from alex-krippner/issue_plugin-csv-#19 (2021-02-18 16:53)
- edited error message #19 (2021-02-18 14:39)
- added error message when no filter results (2021-02-17 13:47)
機能拡張の検討事項
- 目盛線が使えると良いかもしれない。
- クリックが可能な DokuWiki 内部リンクをセル内に配置できるだろうか？
- 外部リンクをセル内に配置できるだろうか？
- 他の DokuWiki 書式（ bold, italic, ul, インターウィキ）は良いかも。
- 行の選択は素晴らしい。例：rows=1,5,6,7
- 右揃え align right
Googleドキュメントのスプレッドシートを使用
Use with a Google Docs Spreadsheetを参照してください。