#author("2023-08-18T00:23:08+09:00","default:kanateko","kanateko")
#author("2023-08-31T11:35:44+09:00;2023-08-18T00:23:08+09:00","default:kanateko","kanateko")
&tag(プラグイン,自作,追加,未公開);

//#ref(getcell.jpg,center,wrap,500x)

#contentsx

*表の特定のセルの内容を取得するプラグイン [#ke97903b]
#infobox(plugin){{
name=getcell
ver=1.1.0
pukiwiki=1.5.4
update=2023-08-17
}}

指定したページにある表の中から、指定した文字を含む、あるいは直接行数で指定した行を抽出し、その行の指定した列のセル内容を取得して表示するプラグイン。

要は特定のセルの内容を取得・表示することができる。

#clear

#box(label,label-style=full,box-color=blue,title=このプラグインでできること){{
-指定したページに有る表内の特定のセル内容を取得・表示する。
--指定した正規表現にマッチする行を抜き出すことが出来る。
--ページ内に表が複数ある場合、すべての表をヘッダ行やスタイル指定行を除いた状態で連結した上で行数をカウントする。((後々この仕様は変更するつもり))
--ページ内に表が複数ある場合、すべての表をヘッダ行やスタイル指定行を除いた状態で連結した上で行数をカウントする。
}}


*ダウンロード [#w807f1c9]
//最新: [[GitHub>https://github.com/kanateko/pukiwiki-plugin]]
#box(caution,width=400px){{{
このプラグインは現在公開されていません。
}}}

|~日付|~バージョン|~備考|h
|CENTER:120|CENTER:60|590|c
|2022-08-17|1.1.0|#ul(複数のマッチする行がある場合に任意の行を選択する機能を追加)|
|2022-05-24|1.0.2|#ul(相対パス指定に対応)|
|2022-12-05|1.0.1|#ul(インライン形を追加)|
|~|1.0.0|#ul(初版作成)|

#null{{{
*セットアップ [#m4ba94e4]
+GitHubからダウンロードした「getcell.inc.php」をPukiWikiのpluginディレクトリに放り込む。
}}}

*使用方法 [#d03fa7aa]
 #getcell(< ページ名 >,<オプション>)

インライン型 (`&amp;getcell(...);`) も使用可。

**オプション [#r157b091]
:ページ名 (文字列)|
必ず第一引数で指定する。
:filter = < 文字列 (正規表現) >|
行数指定方法その1。
指定した文字列にマッチした最初の行が対象になる。
マッチした行が複数ある場合、下記のindexオプションでいずれかを指定することが可能。
:index = < 数字 >|
マッチした行の中で何番目の行を表示するかを指定する。
指定しなかった場合は自動的に1番目が表示される。
:row = < 数字 >|
行数指定方法その2。
数字で直接何行目を対象にするか指定する。
表がページ内に複数ある場合、すべての表を連結 (ヘッダやスタイル指定の行を除く) した上でカウントする。
:col = < 数字 >|
指定した行の何列目のセルを対象にするか指定する。
指定しなかった場合は自動的に1列目を取得する。

オプションとしてfilterもしくはrowを指定する必要がある (同時指定は不可) 。

*使用例 [#j8f00297]
#tab{{{
#:表示
#getcell(../swiper,filter=^1.1.2$,col=3)
#:ソース
 #getcell(../swiper,filter=^1.1.2$,col=3)
}}}

*備考 [#oc220838]
-現段階では色々と試作状態なので、ある程度仕様がまとまってきたら公開する予定。

*コメント [#n29eb473]
#pcomment(reply)