#author("2024-04-09T16:07:08+09:00;2024-04-07T17:54:47+09:00","default:kanateko","kanateko")
#author("2024-04-09T16:07:32+09:00;2024-04-07T17:54:47+09:00","default:kanateko","kanateko")
&tag(プラグイン,自作,追加,未公開);

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

#contentsx
*セクション単位のincludeプラグイン [#overview]
#infobox(plugin,except=ライセンス){{
name=inc_section
ver=1.0.2
pukiwiki=1.5.4
update=2024-04-07
}}

includexの代替として開発したプラグイン。includexと違い、同ページ内で複数回同じページを指定して表示することができる。

同じ内容を複数のページに記載したいときなどにこのプラグインを使用することで、後々記述を変更したくなった場合に1ページのみを編集するだけで良くなるため、作業効率が向上する。
同じ内容を複数のページに記載したいときなどにこのプラグインを使用することで、後々記述を変更したくなった場合に1ページのみを編集するだけで済むため、作業効率が向上する。

似たようなプラグインとしてインフォボックスから情報を取得して表示する[[inc_infobox>../inc_infobox]]プラグインがある。

#clear

#box(label,style=full,title=このプラグインでできること){{
-指定したページの内容をセクション (段落) 単位で取得・表示する。
--指定した文字列を含む行のみを抽出することもできる。
---逆に指定した文字列を含む行を除外することもできる。
--行数や範囲を指定して表示することも可能。
}}

*ダウンロード[#download]
//最新: [[GitHub>https://github.com/kanateko/pukiwiki-plugin]]

#box(caution,width=400px){{{
このプラグインは現在公開されていません。
}}}

|~日付|~バージョン|~備考|h
|2024-04-07|1.0.2|#ul(ページの相対指定に対応)|
|2024-03-18|1.0.1|#ul(filterオプションを追加)|
|2024-02-24|1.0.0|#ul(初版作成)|

//*セットアップ [#setup]

//*プラグイン設定 [#settings]

*使用方法 [#usage]
 #inc_section(<ページ名>,<見出し>[,オプション])

必ず第一引数でページ名、第二引数で取得するセクションの見出しを指定する。見出しの指定には正規表現を使用できる。

*オプション [#options]
:filter = |指定した文字列 (正規表現) を含む行のみを抽出する。
:except = |指定した文字列 (正規表現) を含む行を除外する。
:num = |行数や範囲を指定する。指定方法はincludexプラグインと同じ (例:num=2, num=:5, num=3:6)。

*使用例 [#ecample]
#tab{{
#:表示
↓[[inc_infobox>../inc_infobox]]プラグインの更新履歴
#inc_section(../inc_infobox,ダウンロード,filter=^\|)
#:ソース
 #inc_section(../inc_infobox,ダウンロード,filter=^\|)
}}

*追加したい機能 [#roadmap]
-特になし

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