差し込みタグと差し込み箇所

制作会社の方向け · 2026年10月26日 更新

サイトの HTML のどこに、どの部品を出すかを決める方法です。HTML には目印のタグを2行入れるだけで、出す件数や形はツギテの画面で決めます。

• だれ向け:制作会社(ツギテの代理店)の担当の方、テナント管理者。
• 場所:サイト設定の「差し込み箇所」。
• 前提:接続設定 の接続テストが通っていること。

差し込みタグの書き方

部品を出したい所に、開きのタグと閉じのタグを入れます。name の所が差し込み箇所の名前です。

例:トップページの新着のお知らせなら、<!-- tsugite:news-top --> と <!-- /tsugite:news-top --> を2行で入れます。

• タグのあいだの中身は、公開のたびにツギテが書き換えます。タグの外は変えません。
• 書き込む中身は、開きのタグの行の字下げにそろえます。
• 1つのファイルに、同じ名前のタグは1組だけにします。
• 名前は半角の英小文字・数字・ハイフンで、40文字まで。サイトの中で重ならない名前にします。
• ファイルは UTF-8 で保存してください。UTF-8 でないファイルは書き換えません。

差し込み箇所を作る

1. サイト設定の「差し込み箇所」で「差し込み箇所を追加」を押します。
2. 「場所」を決めます。
   • 名前:HTML に入れたタグの名前(例 news-top)。
   • ファイル:公開ディレクトリからの場所(例 index.html、news/index.html)。.html か .htm で終わるようにします。
3. 「出すもの」を決めます(下の表)。
4. 「書き出されるHTMLの見本」で形を確かめ、「保存する」を押します。

「HTMLに入れるタグ」の欄に、その名前のタグが出ます。「コピー」で写して HTML に貼れます。

• 営業日カレンダーと緊急のお知らせ帯には、件数・出し方の欄はありません(いつも標準の形)。
• お問い合わせフォームは差し込み箇所ではありません。お問い合わせフォームを置く を見てください。

標準の形と、自分で書く

「自分で書く」を選べるのは、代理店の人とテナント管理者だけです。1件分の HTML は5,000文字までです。

例:<li><time datetime="{{date_iso}}">{{date}}</time> <a href="{{url}}">{{title}}</a></li>

• 入る値はエスケープします。
• 部品ごとの項目(ブログの {{excerpt}} など)も使えます。一覧は 記事のページ の表を見てください。
• 値があるときだけ出すには {{#キー}}…{{/キー}}、ないときだけ出すには {{^キー}}…{{/キー}} で囲みます(入れ子は1段まで)。
• 代理店の配下のサイトでは、「テンプレートから選ぶ」で共有のテンプレートを写せます。代理店の人は「テンプレートとして保存」もできます。

ページ分け

件数が「すべて」の一覧は、いくつかのページに分けて書き出せます。差し込み箇所の編集の「ページ分け」で選びます。ページ分けできる差し込み箇所は、1つのサイトで部品ごとに1つまでです。

• 分けたページは、元のページ(差し込み箇所のファイル)をひな形にしてツギテが書き出します。
• 書き出す場所は、元のページと同じフォルダだけです。 フォルダが変わると、相対パスの画像・CSS・リンクがずれるためです。
• 記事がなくなったページは、ツギテが作ったものなら消します。同じ名前でツギテが作っていないファイルがあれば止めます。
• 「分けない」に戻すと、分けたページを消し、ページのリンクの中を空にします。

ページのリンクと見出しのタグ

分けるときは、元のページに、もう2組のタグを入れます。名前は差し込み箇所の名前の後ろに -nav・-heading を付けたものです。

サーバのタグを確かめる

差し込み箇所の一覧の「サーバのタグを確かめる」を押すと、登録したファイルをサーバから読み、タグがあるかを確かめます。HTML をサーバに置いたあとに押してください。

タグが見つからない差し込み箇所は、公開しても書き出しません。 続けて何度も押すと、10分ほど確かめられなくなります。

差し込み箇所を消す

差し込み箇所の編集の「この差し込み箇所を消す」で消せます。サイトの HTML のタグと、今書き出されている中身はそのまま残ります。要らなければ、HTML から手で外してください。