====== CSV プラグイン ======

---- plugin ----
description: CSV を表として表示する。
author     : Andreas Gohr
email      : gohr@cosmocode.de
type       : syntax
lastupdate : 2009-11-03
compatible : 2013-03-06 "Weatherwax", 2012-10-13 "Adora Belle", 2012-01-25 "Angua" 
depends    : 
conflicts  : 
similar    : 
tags       : csv, tables, file


downloadurl: https://github.com/cosmocode/csv/zipball/master
sourcerepo : https://github.com/cosmocode/csv
bugtracker : https://github.com/cosmocode/csv/issues
----

このプラグインは元々 [[steven-danz@kc.rr.com|Steven Danz]] が書きました。
現在のバージョンは、他の貢献者によってセキュリティバグが修正され、パッチが組み込まれています。

===== 説明 =====

[[http://www.cosmocode.de/en/open-source/dokuwiki-plugins/|{{ http://www.cosmocode.de/_media/en/wiki/dokuwiki/cosmologo.png|CosmoCode プラグイン}}]]

CVS データを表形式で表示するという単純な[[ja:plugins|プラグイン]]です。
データは ''%%<csv>%%'' から ''%%</csv>%%'' の間で文書中に埋め込むか、''%%<csv namespace:test.csv></csv>%%'' を利用してメディア領域のファイルから読み込みます。
アップロード済のメディアファイルの代わりに CSV ファイルの HTTP URL の指定もできます。

メディア領域の CSVファイルを使う場合、.csv ファイルがアップロードできるように [[ja:mime|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 ファイルやデータの空行は、表の中の水平区切りとして表示されます。

===== ダウンロード =====

手動で、又は[[ja:plugin:plugin|プラグイン管理]]を使用してこのプラグインをインストールするのに、以下の URL を使います：

  * https://github.com/cosmocode/csv/archive/master.zip

==== 変更履歴 ====

{{rss>https://github.com/cosmocode/csv/commits/master.atom date}}

==== 機能拡張の検討事項 ====

  * 目盛線が使えると良いかもしれない。
  * クリックが可能な DokuWiki 内部リンクをセル内に配置できるだろうか？
  * 外部リンクをセル内に配置できるだろうか？
  * 他の DokuWiki 書式（ **bold**, //italic//, __ul__, [[wpjp>インターウィキ]]）は良いかも。
  * 行の選択は素晴らしい。例：rows=1,5,6,7
  * 右揃え align right

==== Googleドキュメントのスプレッドシートを使用 ====

[[plugin:csv#use_with_a_google_docs_spreadsheet|Use with a Google Docs Spreadsheet]]を参照してください。