タグ「35」を含む投稿［6件］
てがろぐ Ver 4.7.0 を公開しました。動画の埋込表示、1行単位フリースペース、折り畳み装飾記法、指定回数超のハッシュタグだけのリスト表示記法、折畳型の日付リスト記法や、n番目画像を出力する記法の仕様増強、などの追加が主な更新点です。その他、細々した仕様改善や機能追加、不具合修正を含んでいます。
➡ https://www.nishishi.com/cgi/tegalog/
バージョンアップには2通りの方法があります。
🆕 Ver 4.7.0の更新点(概要)：
《▼大きな機能追加》
●動画ファイルの埋め込み表示機能。
●「名前付き1行単位フリースペース」欄を追加。
●指定範囲を(details＋summary要素で)折り畳んだ状態で表示する装飾記法を追加。
●投稿内のn番目の画像を出力する [[ONEPICT:n]] 記法に、細かなオプション記法を追加。
《▼その他の機能追加》
●Faviconの設定機能を追加。
●画像拡大スクリプトを任意に指定する際、複数ファイルの読み込み指定を可能に。
●使用回数が指定値以上のハッシュタグだけをリスト表示する記法を追加。
●最初は年だけが見えている折り畳み型の日付リンクリスト記法を追加。
《▼細かな機能追加》
●ログインフォームの上側に任意のメッセージを掲載できる設定機能。
《▼仕様改善》
●装飾系ボタンの動作改善
●Apple Musicの共有用URLの新仕様に対応。
●使用中画像の検索機能を（検索語に「PICT:」を指定せずに）ファイル名だけで検索するよう変更。
●画像管理画面からの画像削除時に、サムネイル画像があればそれも同時に削除するように改善。
●エラー発生時の環境情報の出力をデフォルトで「しない」に変更。
《▼スキン更新》
●折り畳み表示用のCSSを追記。（通常モードで使うスキン9種類のみ）
●動画埋め込み表示用のCSSを追記。（通常モードで使うスキン9種類のみ）
《▼不具合修正》
❎検索語のハイライト機能を有効にしている状況で、全文検索で使う検索語の中に「半角の英数記号1文字だけの検索語」が含まれているときに、「続きを読む」機能や「OGPカード型リンク」の表示機能が使えなくなる不具合を修正。
❎検索文字列の先頭に空白があると文字化けする問題を解決。（全文検索でのハイライト表示処理の不具合を解消）
❎投稿本文の1行目に「隠す記法」・「折り畳み記法」・「リスト記法」のどれかがあるとき、[[COMMENT:TITLE]]記法を使って1行目だけを分離しているスキンでは表示が崩れる可能性がある問題を解決。（→自動的に内部的に空行を先頭に挿入することで、1行目に書かれている内容が2行目になるよう調整。）
❎装飾の「リスト」ボタンと「隠す」ボタンで、入力をキャンセルした場合にだけ、投稿欄にフォーカスが戻らなかった不具合を修正。（JavaScriptがエラーを出していた問題を修正。）
❎予約投稿を有効にしているとき、（ログインしている状態で）存在しない投稿番号の単独ページにアクセスするとシステムエラー画面が出る問題を解決。
❎管理画面の投稿一覧で本文の一部が抜粋されない不具合を修正。
▼今回の大きな機能追加：
🌸動画ファイルの埋め込み表示機能
直接サーバにUPされているMP4動画ファイルなど、「URLで指定できる動画ファイル」を本文中に埋め込んで表示できる記法を追加しました。
従来はYouTube動画を埋め込むくらいしか方法がありませんでしたが、MP4ファイル等の動画ファイルを直接（ブラウザ側の再生コントロールを使って）再生できる専用記法を用意しました。
➡ 詳しい使い方は、使い方・設定方法ページの「リンクの書き方」区画内の「動画ファイルを埋め込み表示する書き方」項目をご覧下さい。
▼装飾について
なお、何もCSSを用意しない場合、動画は（おそらく）その動画のデフォルトサイズで出力されてしまいます。縦横サイズが大きめの動画だと、閲覧者のブラウザの描画領域からはみ出してしまう可能性がありますのでご注意下さい。
Ver 4.7.0に同梱している各標準添付スキンには、埋め込み動画用のCSSを追記してあります。標準添付スキンをそのままお使いの場合は、スキンを上書きするだけで埋め込み動画対応になります。その他のスキンをお使いの場合は、同梱のCSSを参考に調整して下さい。下図は、標準スキンに含まれている tegalog.css の410行目付近です。このあたりに記述があります。
➡ この記法によって出力されるvideo要素等は、カスタマイズ方法ページの「リンクの装飾方法」区画の中にある「動画ファイルの埋め込み表示として出力されるHTML」項目で紹介しています。独自に装飾したい場合に参考にして下さい。
🌸「名前付き1行単位フリースペース」欄を追加
従来からある「多目的フリースペース」とは別に、各フリースペースに名前を付けて使える『名前付き1行単位フリースペース』機能を加えました。複数の細かなフリースペースを設ける用途を前提にした機能で、外側スキンだけでなく内側スキンでも使えます。
従来からある【多目的フリースペース】でも区切り記号 <> を使うことで複数個のフリースペースを用意することはできます。しかし、その場合は「何番目なのか」を表す番号でしかスキンに記述できません。そのため、分割個数が多い場合や中身が長い場合には、どこに何を書いているのか把握しにくくなる問題がありました。
今回追加した「名前付き1行単位フリースペース」機能では、番号ではなく、任意の名前を付けたフリースペースを設けられます。
※名前には日本語文字や絵文字も使えますので、[[FREELINE:著者アイコン]] や [[FREELINE:🧀]] のような記述も使えます。
※この「名前付き1行単位フリースペース」をIF文記法の中に書いたり、「名前付き1行単位フリースペース」の中に直接IF文の記法を書いたりもできます。
➡ 詳しい仕様などは、カスタマイズ方法ページの『名前付き1行単位フリースペースの書き方』区画で解説しています。
※外側スキンと内側スキンの両方で使えるフリースペース関連機能は「名前付き1行単位フリースペース」だけです。それ以外のフリースペース機能は、どれも外側スキンのみでしか使えません。
🌸指定範囲を(details＋summary要素で)折り畳んだ状態で表示する装飾記法を追加。
従来からある「a要素によるボタン＋JavaScript」で実装された「隠す」記法とは別に、details＋summary要素を使って指定範囲を折り畳んで表示する装飾記法 [O:ラベル:～] を追加しました。
※「O」は英大文字のオーでOritatamiの略です。（FoldのOだと解釈できなくもないですが。^^;）
標準スキンだと以下のような感じで見えます。（折り畳まれていた部分の展開後）
ボタンの左側に見える「▼」は、ブラウザ側が表示している記号です。ブラウザによっては異なる見え方になるかもしれません。（summary要素に display: inline; などを指定すれば消すことはできます。）
これによって、従来からある2つの記法🔴🟠と合わせて、3通りの隠し方ができるようになりました。
🔴 指定範囲を隠す記法： [H:～] または [H:ラベル:～]
🟠 それ以降のすべてを隠す記法： <>
🔵 指定範囲を折り畳む記法： [O:ラベル:～]
従来からちらほら「続きを読む」ボタンと「畳む」ボタンを同じ位置に掲載したい、というご要望を頂いていましたが、今回実装した「details＋summary要素による折り畳み機能」で、ほぼそれと同じ効果を実現できると思います。
▼詳しい解説（ヘルプドキュメント）：
この機能は、他の機能と同様にボタンクリックで挿入する機能を用意していますが、使い方に若干の注意点があるため、標準では非表示になっています（その場合でも直接本文に記法を書けば使えます）。表示させる方法や、メリット・注意点などの情報は、使い方・設定方法ページの「折り畳み：指定の範囲内だけを折り畳んでトグルボタンで表示/非表示を切り替え表示する機能」項目をご覧下さい。
▼「続きを読む」系統3種類の比較：
投稿本文中の一部を隠す「続きを読む」系統の機能が3種類（※鍵付き投稿機能を加えたら4種類ですけども）に増えましたから、ちょいと仕様を比較整理できる情報があった方が良いかな……と思って、ヘルプドキュメントに比較表を加えてみました。
詳しくは、使い方・設定方法ページ内の『続きを読む(一部を隠す)機能の仕様』区画で直接ご確認下さい。
▼装飾について：
今バージョンの標準添付各スキンのうち、特殊なモード用を除いた9種類には「折り畳み用のCSS」を追記しています。どのスキンもほぼ同じ感じの装飾にしていますが、下図のようにスキンのカラーに合わせてボタン配色等を少しだけ変えてあります。
▲左側：標準スキンでの表示例 ／ 右側：昔のTwitterっぽいスキン(ピンク)での表示例
追記した「折り畳み部分用のCSSソース」だけを抜き出したソースは、oritatami-v462.css にあります。カスタマイズしてお使いの場合や、自作スキンをお使いの場合には、参考にして下さい。（もっとも、details＋summary要素の折り畳み機能は、HTML側に存在している機能ですから、何一つ装飾しなくても動作はしますけども。）
なお、「折り畳み」機能で使われるdetails要素＋summary要素が具体的にどのような形で出力されるのかは、カスタマイズ方法ページの「「折り畳み」機能に使われるマークアップ（HTMLタグ）をカスタマイズする方法」項目にHTMLソースと解説を掲載していますのでご参照下さい。
🌸投稿内のn番目の画像を出力する [[ONEPICT:n]] 記法に、細かなオプション記法を追加。
投稿本文内のn番目の画像だけを出力する [[ONEPICT:n]] 記法に、「リンクにならない記法」や「各種の値だけを出力する記法」など、細かなオプションを追加しました。
てがろぐの内側スキンに [[ONEPICT:1]] と書くと「投稿本文内の1つ目の画像」だけが出力されます。この記法は以前からあります。しかし、これだと設定によっては【リンク付き】の状態で出力される場合がありますし、投稿本文の書き方によっては【キャプション付き】で出力されたりします。
このように出力が様々だと、複雑なスキンを作る際に活用しにくい問題がありましたので、以下のような記法を増やしました。
▼新設した記法①：
[[ONEPICT:1:IMG]]：設定に関係なく、本文内1つ目の画像単独のimg要素だけを出力する。
▼新設した記法②：
[[ONEPICT:1:VALUE:SRC]]：画像のURLだけを出力する。
[[ONEPICT:1:VALUE:CLASS]]：画像のフラグだけを(あれば)出力する。
[[ONEPICT:1:VALUE:ALT]]：画像のキャプションだけを出力する。
[[ONEPICT:1:VALUE:WIDTH]]：画像の横幅を出力する。(認識している場合だけ)
[[ONEPICT:1:VALUE:HEIGHT]]：画像の高さを出力する。(認識している場合だけ)
[[ONEPICT:1:VALUE:LOADING]]：loading="lazy"の指定があればそれ(値だけ)を出力する。
1枚目の画像を使って任意の場所へリンクさせたい場合には、原寸画像へのリンクになると困りますよね。その場合には、【新設した記法①】の [[ONEPICT:1:IMG]] を使うと良いです。常にimg要素だけしか出力されませんから。
また、画像のフラグを使って「画像の外側を囲む何らかの要素」を設けたい場合には、【新設した記法②】の [[ONEPICT:1:VALUE:CLASS]] を使って、例えば、<span class="[[ONEPICT:1:VALUE:CLASS]]"> ～ </span> のように書く方法などが使えるでしょう。
※【新設した記法②】の各記法には、値だけが出力されます。例えば、画像の横幅サイズが 300px なら、[[ONEPICT:1:VALUE:WIDTH]] には「300」という数字だけが出力されます。（ただし、指定番目の画像が存在しない場合や、てがろぐ側が画像サイズを認識できていない画像に対しては、何も出力されません。）
➡ 詳しくは、カスタマイズ方法ページのリファレンス内【投稿本文に含まれる画像関連要素】項目に追記してありますのでご覧下さい。
▼今回のその他の機能追加：
🌺Faviconの設定機能を追加
管理画面から任意のFavicon(ファビコン)を適用できる設定を加えました。
従来でもWebサイトの最上階層に favicon.ico ファイルがあれば、てがろぐ（管理画面も含む）でもそのFaviconが表示されていました。しかし、てがろぐだけに専用のFaviconを表示したい場合もあるかもしれませんので、管理画面から任意のFaviconを適用できる設定も加えました。
標準では「指定しない」になっていますから、強制的に何らかのFaviconが適用されるようなことはありません。「独自に設定する」に変更した上で、FaviconのURL等を書けば、それがFaviconとして採用されます。ついでに、『て』意匠の内蔵アイコンも用意しておきました。「特に使いたいFaviconはないが、てがろぐを使っていることは軽く示したい」みたいな場合にご活用下さい。(笑)
※備考：この『て』アイコンは個別にダウンロードしてご活用頂くこともできます。FAQ・豆知識ページの「てがろぐ用Favicon画像」項目からダウンロードできます。
なお、「Favicon URL等」欄には、URLを書いても構いませんし、「/」で始まる絶対パスや、相対パス、Base64でエンコードされたデータを書くこともできます。（link要素のhref属性値に書ける値なら何でも登録できます。）
Faviconの適用先を「管理画面内のみ」にすると、管理画面内だけに指定のFaviconが適用されます。この場合は、（てがろぐ複数設置時などで）識別する用途に使えそうな気がします。「管理画面とスキン」にした場合は、外側スキンで [[FAVICON]] と書かれた位置にFaviconを表示するためのlink要素が出力されます。（※スキン側にこの記述がない場合は、どこにも出力されません。）
スキンに書ける記法には、さらにオプションもあります。
詳しくは、カスタマイズ方法ページ内のリファレンスの【特殊機能要素】欄末尾をご覧下さい。
🌺画像拡大スクリプトを任意に指定する際、複数ファイルの読み込み指定を可能に
Lightbox以外のスクリプトを使いたい場合で、JavaScriptやCSSファイルを2つ以上読み込む必要があるケースにも対応。
てがろぐでは標準で画像拡大スクリプトにLightboxを使いますが、任意のスクリプトに変更もできます。その際、従来は「JavaScriptファイル」と「CSSファイル」をそれぞれ1ファイルずつしか指定できませんでしたが、半角スペース区切りで複数のファイルを指定できるようにしました。これで、JavaScriptファイル2つの読み込みが必要な場合でも管理画面から指定できます。
詳しい書き方や、オプションの意味などについては、カスタマイズ方法ページの『Lightbox以外の画像拡大スクリプトを読み込んで使う方法』区画にある、「設定箇所1（前半：スクリプトファイルの読み込み）」項目以降あたり（備考2～3）をご覧下さい。
▼セキュリティ面の属性について
将来的には対応予定ですが、現在のバージョンでは（この設定機能を使って読み込む場合の）JavaScriptファイルにcrossorigin属性やintegrity属性を加えることはできません。
今の時点でcrossorigin属性とintegrity属性を加えたい場合は、てがろぐ側の機能では読み込ませずに、スキンHTMLに直接script要素を書いて下さい。
🌺使用回数が指定値以上のハッシュタグだけをリスト表示する記法を追加
使用回数が指定値以上のハッシュタグだけをリスト表示できる [[HASHTAG:LIST(000+)]] 記法を追加。(数値は1以上の任意の整数)
従来から、外側スキンに [[HASHTAG:LIST]] と書くとハッシュタグのリストが出力される機能がありましたが、使用回数の多寡に関係なくすべてのハッシュタグが一気に出力される仕様でしたので、長ぁ～いリストになる場合もありました。
そこで、 [[HASHTAG:LIST(10+)]] のように書くことで、「10回以上使われているタグ」に限って出力できる機能を加えました。（※閾値は自由に指定可能です。）
上図は、
記法 [[HASHTAG:LIST(123+)]] の数字部分は、1以上の整数なら任意の値を自由に指定できます。（「1」を指定する意味はありませんけども。^^;）
数値の後に半角の「+」記号が必須ですので忘れないようご注意下さい。
ハッシュタグリストの記法には、いろいろオプション記法がありますが、それらとも併用が可能です。
例えば......
➡ そのほかのオプション記法とも併用可能ですので、詳しい書き方は、カスタマイズ方法ページのリファレンス内【ハッシュタグ要素】項目をご覧下さい。
🌺最初は年だけが見えている折り畳み型の日付リンクリスト記法を追加
日付リンクのうち、初期状態では年リストだけが見えていて、クリックすると月リンクが展開される（details＋summary要素での出力になる） [[DATEBOX:EXPAND]] 記法を追加。
てがろぐ外側スキンに [[DATEBOX:LIST]] と書く方法で日付一覧を出すと、投稿期間が長い場合にはリンクリストも長ぁ～くなります。そこで、初期状態では年リストだけが見えていて、クリックすると月リンクが展開される（details＋summary要素での）出力になる [[DATEBOX:EXPAND]] を加えてみました。
上図の右上のように、クリックした年に対してだけ、その年内の月別リンクリストが見えるように動作します。この展開型のリストは、HTMLのdetails＋summary要素で出力されますので、JavaScript不要で展開／伸縮できます。
なお、月別リンクリスト部分のHTMLは、従来からある（上図左側の）日付リストと同じHTMLが出力されます。class名も同じなので、従来の日付リスト用の装飾がそのまま適用されます。
しかし、summary要素がクリックされた後に展開される部分（上図で赤色の吹き出しの先に見えている「左端に薄い緑色の縦バーが付加されている空間」）については、何らかの装飾を加えない限り、デフォルトの状態で見えます。
上図のサンプルでは、以下のようなCSSを加えています。
/* ▽日付折り畳みリスト内の追加装飾 */
.datelimit-expand {
border-left: 3px solid #aca; /* 左端の縦線 */
padding-left: 0.5rem; /* 左側の(縦線より)内側の余白量 */
margin-left: 0.2rem; /* 左側の(縦線より)外側の余白量 */
margin-bottom: 0.5rem; /* 下側の余白量 */
}
summary要素がクリックされた後に展開される部分は、<div class="datelimit-expand"> ～ </div>というHTMLでマークアップされていますので、これに対して装飾を加えると、展開された部分全体に対して装飾ができます。
なお、従来からある日付一覧2種類の記法には、[[DATEBOX:LIST:モード指定]] や[[DATEBOX:PULL:モード指定]] のようなオプション記法もありました。
今回追加した [[DATEBOX:EXPAND]] でも、[[DATEBOX:EXPAND:モード指定]] のように同じオプションを付加できます。
➡ 詳しい書き方は、カスタマイズ方法ページのリファレンス内【日付リスト要素】項目をご覧下さい。
▼その他の細かな機能追加：
🌷ログインフォームの上側に任意のメッセージを掲載できる設定機能
従来から、ログインフォームの下側に任意のメッセージを掲載する機能がありましたが、それとは別に、ログインフォームの上側にも任意のメッセージを掲載できる機能を加えました。（下図の緑色矢印の先）
複数のてがろぐCGIを併用している場合で、「どのてがろぐのログインなのか」を識別する用途や、複数人で共有している場合などで、ログイン関連のメッセージを伝えたい場合などに活用できるかもしれません。
そのほか、ログイン者限定公開機能でログインを促すメッセージを自由に書き換える方法と併用すると（操作の）分かりやすさが増すかもしれません。
また、ログインフォームに検索避けmeta要素を出力する機能も加えました。上図の黄色矢印部分です。デフォルトでONなので、何も設定しなくても出力されます。
▼仕様改善：
🌳装飾系ボタンの動作改善
投稿欄の下部にある「装飾」ボタンを押して出てくる各種ボタンのうち、下図に3色の矢印🟡🟢🔵で示したボタンの動作仕様を、後述の通り改善しました。
🟡「折畳」ボタンで、サマリー(ラベル)を空欄にしたままでも折り畳み記法を挿入するよう改善。
➡ 今バージョンからサポートした折り畳み記法では、[O:ラベル:中身] のようにラベルを指定できる仕様ですが、ラベルを省略した [O:中身] という書き方もできます。しかし、（初期実装段階でのβ版では）投稿欄下部に表示される「折畳」ボタンから入力する方法だと省略できませんでした。
この仕様を改善して、下図のように（ラベルが不要なら）空欄のままでOKボタンを押せば、ラベルを省略した記法が挿入されるようにしました。
ここを空欄にしたまま[OK]ボタンを押せば、ラベルを省略した記法が挿入されます。
※注：この「折畳」ボタンは初期状態では非表示になっていますので見えません。使いたい場合は、管理画面の[設定]→[投稿欄の表示]→【装飾ボタンの表示設定】でONにして下さい。
🟢「隠す」ボタンで、ラベルの入力ができるように改善。(ラベルを省略したい場合は空欄のままOKを押す)
➡ 続きを読む記法でも、ボタンラベルを指定した [H:ラベル:中身] という書き方と、ラベルを省略した [H:中身] という書き方ができます。従来では、投稿欄下部に表示される「隠す」ボタンを使うと、問答無用で後者の [H:中身] の書き方が挿入されていましたが、下図のようにラベル入力ダイアログを開くよう改善しました。
先の折り畳み記法の場合と同様に、空欄のままでOKを押せば、従来と同じようにラベルを省略した記法が挿入されます。
🔵「汎用装飾1～9」ボタンで、追加のclass名を入力できるように改善。(省略したい場合は空欄のままOKを押す)
➡ 先程の図の水色矢印部分には ①②③④⑤…… のようなボタンが見えています。これは、Ver 4.4.4以降で使える汎用装飾を挿入するためのボタンです。このボタンを押した場合、従来は問答無用で [1:中身] のような最小限の記法が出力されていました。しかし、記法の仕様としては任意のclass名を指定することもできますので、下図のようにclass名をその場で入力できるダイアログを表示するように改善しました。
これも同様に、空欄のままでOKを押せば、従来と同じようにclass名を省略した記法が挿入されます。
※注：これらのボタンは初期状態では非表示になっていますので見えません。使いたい場合は、管理画面の[設定]→[投稿欄の表示]→【装飾ボタンの表示設定】区画で、下図のあたりから設定して下さい。
ボタンラベルもここから変更できます。詳しくは、使い方・設定方法ページの「文字装飾記法をボタンクリックで挿入する方法」をご覧下さい。
🌳.htaccessの影響で管理画面上からは過去バックアップのダウンロードが阻まれる問題を解消。
標準の.htaccessファイルなどを使って.xmlファイルへのアクセスをブロックしていると、バックアップ専用ディレクトリ内の.xmlファイルへのアクセスもブロックされるために、管理画面上からは過去のバックアップのダウンロードができませんでした。そこで、過去のバックアップファイルのダウンロード処理も、てがろぐ内部を経由してダウンロードさせるように仕様を改善しました。（ログイン状態の場合にのみダウンロードできます。）
てがろぐには自動バックアップ機能があります。投稿するたびに、その直前の状態を自動バックアップします。なので、誤操作等で既存データを吹き飛ばしてしまっても、以前の投稿はバックアップ用ディレクトリに残っています。「吹き飛ばしたのはどうやら数日前らしいぞ……？」と後から気付いた場合でも、過去30バージョンは残っていますから（設定で増量も可）、直近だけでなく、離れた「以前の状態」にも戻せます。
下図の【水色矢印の先】に見える各ボタンは『最新のデータファイルをダウンロードできるボタン』で、【黄色矢印の先】に見える各リンクは『過去のバックアップファイルへのリンク』です。
問題は、その「古いバックアップのダウンロード方法」です。FTP等の手段でダウンロードする分には何も支障ないのですが、『設置を推奨する .htaccess ファイル』で適切なアクセス制限を施していると、管理画面上からダウンロードしようと操作しても 403 Forbiddenエラーになってダウンロードできませんでした。（※上図の【水色矢印の先】にある各ボタンからは問題なくダウンロードできますが、【黄色矢印の先】に見える各リンクからはダウンロードできませんでした。）
これは、【水色矢印の先】の方は、一旦てがろぐ内部を経由してデータをダウンロードさせる仕組みになっているのに対して、【黄色矢印の先】の方は単にそのファイルへリンクしているに過ぎなかったからです。
まあ、ここからダウンロードできなくても、「これだけのファイルが、バックアップ専用ディレクトリに蓄積されているよ」と知らせる意味くらいには役に立ちますけども。^^;
➡ そこで、今回のバージョンでは、【黄色矢印】の方も【水色矢印】と同じように、てがろぐ内部を経由してダウンロードさせる方式に改善しました。なので、 .htaccessファイルを使って適切にアクセス制限をしている環境でも、ブラウザ上から過去のバックアップファイルをダウンロードできます。（※適切な権限のIDでログインしている場合のみ。）
🌳Apple Musicの共有用URLの新仕様に対応
Apple MusicのURLの仕様が変わったために、新URLを使って単曲を埋め込んだ際に（埋め込み部分の下部に）無駄な空間が出てしまっていた点を修正しました。
特に何も設定する必要はなく、今回のバージョンに更新するだけで、新旧どちらのURLで埋め込んだ場合でも、上図のように無駄な空間なく表示されます。
🌳使用中画像の検索機能を（検索語に「PICT:」を指定せずに）ファイル名だけで検索するよう変更
画像管理画面には、下図の水色矢印部分のように、各画像の使用場所を一覧できるボタン「投稿を見る」と「一覧で見る」があります。これを使うと「PICT: ＋画像ファイル名」という検索語で全文検索した結果を返す仕様になっていましたが、「PICT:」を使わずに、ファイル名だけで検索するよう変更しました。
この仕様改善によって、通常の画像表示以外に [IMG]URL の記法を使って表示している場合もヒットするようになります。（ただファイル名を書いただけの場合もヒットしてしまいますが。）
🌳画像管理画面からの画像削除時に、サムネイル画像があればそれも同時に削除するように改善
画像管理画面から画像を削除する操作をした際に、当該画像にサムネイル画像があれば、サムネイル画像も併せて削除するように動作を改善しました。（※今のところ、てがろぐ側からサムネイル画像を直接UPする機能はありませんが、画像保存用ディレクトリ内に mini サブディレクトリを設けて、そこに同名の画像ファイルをUPすると、サムネイル画像として採用される仕様があります。）
上図は、画像管理画面から画像3枚を削除した後の画面です。黄色矢印部分で示したように（サムネイル画像がある場合に限って）サムネイル画像も併せて削除されていることが分かります。
なお、サムネイル画像の認識等に関する仕様については、使い方・設定方法ページの「サムネイル画像があればサムネイル画像の方を表示する機能(簡易版)」区画をご覧下さい。
🌳エラー発生時の環境情報の出力をデフォルトで「しない」に変更
てがろぐCGIで「処理を継続できないようなエラー」が発生した場合、エラー画面には（主に問い合わせ時の参考情報として教えて頂くための）環境情報を表示していました。この表示は従来から、システム設定の「高度な設定」でON/OFFが可能でしたが、デフォルトでOFFになるよう標準値を変更しました。
🌳デフォルトで読み込まれるJavaScriptのバージョンを最新版に更新
画像管理画面や、何も設定を変更しなかった場合に標準で読み込まれるJavaScriptのjQueryとLightboxのバージョンを最新版に更新しました。
具体的には、jQueryはVer 3.7.1(min)が、LightboxはVer 2.11.5(min)がCDNから読み込まれるようになります。
▼スキン更新：
🌻折り畳み表示用のCSSを追記。（通常モードで使うスキン9種類のみ）
今回のバージョンからサポートした折り畳み表示機能に対応したCSSを、標準添付各スキン（のうち、特殊なモード用を除いた9種類に）追記しました。
詳しくは、このリリースノートの先頭『🌸指定範囲を(details＋summary要素で)折り畳んだ状態で表示する装飾記法を追加』項目に記しましたのでそちらをご参照下さい。
🌻動画埋め込み表示用のCSSを追記。（通常モードで使うスキン9種類のみ）
今回のバージョンからサポートした動画ファイルの埋め込み表示に対応したCSSを、標準添付各スキン（のうち、特殊なモード用を除いた9種類に）追記しました。
詳しくは、このリリースノートの先頭『🌸動画ファイルの埋め込み表示機能』項目に記しましたのでそちらをご参照下さい。
▼#不具合修正 ：
❎検索語のハイライト機能を有効にしている状況で、全文検索で使う検索語の中に「半角の英数記号1文字だけの検索語」が含まれているときに、「続きを読む」機能や「OGPカード型リンク」の表示機能が使えなくなる不具合を修正。
全文検索結果の表示時に、検索語をハイライト表示する機能を有効にしている場合（※標準で「有効」に設定されています）で、検索語の中に「半角の英数記号1文字程度だけの検索語」が含まれているときに、「続きを読む」機能や「OGPカード型リンク」の表示機能が正常に動作しなくなる可能性がある不具合がありました。これを修正しました。
※全文検索結果の表示時に検索語をハイライトする設定とは、下図の黄色矢印部分のことです。（出力要素には何を選択していても同様に発生していました。）
❎検索文字列の先頭に空白があると文字化けする問題を解決。（全文検索でのハイライト表示処理の不具合を解消）
全文検索結果を表示するページでの、検索語の強調表示の処理に不具合がありまして、管理画面の[設定]→[ページの表示]→【全文検索／表示】で『検索結果に含まれる検索語を強調表示する』をONにしている場合に限って（※標準でONになっています）、検索文字列の先頭に空白文字があると検索結果ページ全体が文字化けする問題がありました。その点を解決しました。
❎[[COMMENT:TITLE]]記法で1行目を分離するスキンで表示が崩れる可能性がある問題を解決。
投稿本文の1行目に「隠す記法」・「折り畳み記法」・「リスト記法」のどれかがあるとき、スキン側で [[COMMENT:TITLE]] の記法を使って1行目だけを分離しているときに、表示が崩れてしまう可能性がある問題を解決しました。
具体的には、[[COMMENT:TITLE]] か [[COMMENT:BODY]] の記述がある場合に限って、投稿本文の1行目に上記の記法があれば、自動的に内部的に空行を先頭に挿入することで、投稿本文の1行目に書かれている内容が「2行目」だと解釈、投稿本文の2行目に書かれている内容が「3行目」だと解釈される……ように自動調整する仕様にしました。この場合、[[COMMENT:TITLE]] には（投稿本文の1行目を空行にした場合と同じように）「No.123」の形で投稿番号が出力されます。
※この自動調整は、 [[COMMENT:LINE:1]] のように行番号を指定して挿入される場合には働きません。
※投稿本文を行単位で分割表示する記法に関しては、カスタマイズ方法ページ内のリファレンス【投稿本文関連要素（オプション）】項目をご参照下さい。
❎装飾の入力をキャンセルした場合に、投稿欄にフォーカスが戻らない不具合を修正。
装飾の「リスト」ボタンと「隠す」ボタンで、入力をキャンセルした場合にだけ、投稿欄にフォーカスが戻らなかった不具合を修正しました。（※JavaScriptがエラーを出していた問題を修正しました。）
❎予約投稿を有効にしているとき、（ログインしている状態で）存在しない投稿番号の単独ページにアクセスするとシステムエラー画面が出る問題を解決。
以下の3条件を満たした際にエラー画面が出てしまう不具合がありましたので解決しました。
なお、「条件2」がありますので、一般の閲覧者がそのエラー画面に遭遇することはありません。
❎管理画面の投稿一覧で本文の一部が抜粋されない不具合を修正。
管理画面の投稿一覧では、各投稿の冒頭が抜粋表示されます。抜粋範囲内に画像がある場合は (画像:jpg) のように省略表示されますが、同一投稿内に複数の画像があったり、URLの記述があったりすると、その間の文字列が抜粋されない不具合がありました。その点を修正しました。
以上、ご活用頂ければ幸いです。
※不具合の修正と動作仕様の改善も含んでおりますので、使いたい追加機能がない場合でもバージョンアップ頂くことをお勧め致します。
※バージョンアップしても、データや設定はそのまま引き継げます。バージョンアップ方法について詳しくは、「CGIの更新方法」をご覧下さい。
なお、開発進捗状況報告サイトでフォロー頂くと、てがろぐCGIの最新β版や正式版の公開時にメールで連絡を受け取ることもできますので、ぜひご活用下さい。(╹◡╹)ﾉ
フォロー数が増えると、私の開発モチベーションが向上するメリットもあります！！！🤩
➡ https://www.nishishi.com/cgi/tegalog/
バージョンアップには2通りの方法があります。
データファイルや設定ファイルは、すべてそのまま引き継げます。（Ver.3以下も含む、過去のどのバージョンからでも可）
- 1クリックでバージョンアップできる専用PHP「TegUp」のご使用をお勧め致します。（※てがろぐに同梱していますので、お使いの tegalog.cgi と同じ位置に tegup.php が既にあればそこにアクセスするだけです。）
- もしくは、最新版のZIPの中から tegalog.cgi と fumycts.pl と tegup.php の3ファイルだけを抜き出して上書きアップロードして下さい。
🆕 Ver 4.7.0の更新点(概要)：
《▼大きな機能追加》
●動画ファイルの埋め込み表示機能。
●「名前付き1行単位フリースペース」欄を追加。
●指定範囲を(details＋summary要素で)折り畳んだ状態で表示する装飾記法を追加。
●投稿内のn番目の画像を出力する [[ONEPICT:n]] 記法に、細かなオプション記法を追加。
《▼その他の機能追加》
●Faviconの設定機能を追加。
●画像拡大スクリプトを任意に指定する際、複数ファイルの読み込み指定を可能に。
●使用回数が指定値以上のハッシュタグだけをリスト表示する記法を追加。
●最初は年だけが見えている折り畳み型の日付リンクリスト記法を追加。
《▼細かな機能追加》
●ログインフォームの上側に任意のメッセージを掲載できる設定機能。
《▼仕様改善》
●装飾系ボタンの動作改善
- 「折畳」ボタンで、サマリー(ラベル)を空欄にしたままでも折り畳み記法を挿入するよう改善。
- 「隠す」ボタンで、ラベルの入力ができるように改善。(ラベルを省略したい場合は空欄のままOKを押す)
- 「汎用装飾1～9」ボタンで、追加のclass名を入力できるように改善。(省略したい場合は空欄のままOKを押す)
●Apple Musicの共有用URLの新仕様に対応。
●使用中画像の検索機能を（検索語に「PICT:」を指定せずに）ファイル名だけで検索するよう変更。
●画像管理画面からの画像削除時に、サムネイル画像があればそれも同時に削除するように改善。
●エラー発生時の環境情報の出力をデフォルトで「しない」に変更。
《▼スキン更新》
●折り畳み表示用のCSSを追記。（通常モードで使うスキン9種類のみ）
●動画埋め込み表示用のCSSを追記。（通常モードで使うスキン9種類のみ）
《▼不具合修正》
❎検索語のハイライト機能を有効にしている状況で、全文検索で使う検索語の中に「半角の英数記号1文字だけの検索語」が含まれているときに、「続きを読む」機能や「OGPカード型リンク」の表示機能が使えなくなる不具合を修正。
❎検索文字列の先頭に空白があると文字化けする問題を解決。（全文検索でのハイライト表示処理の不具合を解消）
❎投稿本文の1行目に「隠す記法」・「折り畳み記法」・「リスト記法」のどれかがあるとき、[[COMMENT:TITLE]]記法を使って1行目だけを分離しているスキンでは表示が崩れる可能性がある問題を解決。（→自動的に内部的に空行を先頭に挿入することで、1行目に書かれている内容が2行目になるよう調整。）
❎装飾の「リスト」ボタンと「隠す」ボタンで、入力をキャンセルした場合にだけ、投稿欄にフォーカスが戻らなかった不具合を修正。（JavaScriptがエラーを出していた問題を修正。）
❎予約投稿を有効にしているとき、（ログインしている状態で）存在しない投稿番号の単独ページにアクセスするとシステムエラー画面が出る問題を解決。
❎管理画面の投稿一覧で本文の一部が抜粋されない不具合を修正。
▼今回の大きな機能追加：
🌸動画ファイルの埋め込み表示機能
直接サーバにUPされているMP4動画ファイルなど、「URLで指定できる動画ファイル」を本文中に埋め込んで表示できる記法を追加しました。
従来はYouTube動画を埋め込むくらいしか方法がありませんでしたが、MP4ファイル等の動画ファイルを直接（ブラウザ側の再生コントロールを使って）再生できる専用記法を用意しました。
➡ 詳しい使い方は、使い方・設定方法ページの「リンクの書き方」区画内の「動画ファイルを埋め込み表示する書き方」項目をご覧下さい。
▼装飾について
なお、何もCSSを用意しない場合、動画は（おそらく）その動画のデフォルトサイズで出力されてしまいます。縦横サイズが大きめの動画だと、閲覧者のブラウザの描画領域からはみ出してしまう可能性がありますのでご注意下さい。
Ver 4.7.0に同梱している各標準添付スキンには、埋め込み動画用のCSSを追記してあります。標準添付スキンをそのままお使いの場合は、スキンを上書きするだけで埋め込み動画対応になります。その他のスキンをお使いの場合は、同梱のCSSを参考に調整して下さい。下図は、標準スキンに含まれている tegalog.css の410行目付近です。このあたりに記述があります。
➡ この記法によって出力されるvideo要素等は、カスタマイズ方法ページの「リンクの装飾方法」区画の中にある「動画ファイルの埋め込み表示として出力されるHTML」項目で紹介しています。独自に装飾したい場合に参考にして下さい。
🌸「名前付き1行単位フリースペース」欄を追加
従来からある「多目的フリースペース」とは別に、各フリースペースに名前を付けて使える『名前付き1行単位フリースペース』機能を加えました。複数の細かなフリースペースを設ける用途を前提にした機能で、外側スキンだけでなく内側スキンでも使えます。
従来からある【多目的フリースペース】でも区切り記号 <> を使うことで複数個のフリースペースを用意することはできます。しかし、その場合は「何番目なのか」を表す番号でしかスキンに記述できません。そのため、分割個数が多い場合や中身が長い場合には、どこに何を書いているのか把握しにくくなる問題がありました。
今回追加した「名前付き1行単位フリースペース」機能では、番号ではなく、任意の名前を付けたフリースペースを設けられます。
※名前には日本語文字や絵文字も使えますので、[[FREELINE:著者アイコン]] や [[FREELINE:🧀]] のような記述も使えます。
※この「名前付き1行単位フリースペース」をIF文記法の中に書いたり、「名前付き1行単位フリースペース」の中に直接IF文の記法を書いたりもできます。
➡ 詳しい仕様などは、カスタマイズ方法ページの『名前付き1行単位フリースペースの書き方』区画で解説しています。
※外側スキンと内側スキンの両方で使えるフリースペース関連機能は「名前付き1行単位フリースペース」だけです。それ以外のフリースペース機能は、どれも外側スキンのみでしか使えません。
🌸指定範囲を(details＋summary要素で)折り畳んだ状態で表示する装飾記法を追加。
従来からある「a要素によるボタン＋JavaScript」で実装された「隠す」記法とは別に、details＋summary要素を使って指定範囲を折り畳んで表示する装飾記法 [O:ラベル:～] を追加しました。
※「O」は英大文字のオーでOritatamiの略です。（FoldのOだと解釈できなくもないですが。^^;）
標準スキンだと以下のような感じで見えます。（折り畳まれていた部分の展開後）
ボタンの左側に見える「▼」は、ブラウザ側が表示している記号です。ブラウザによっては異なる見え方になるかもしれません。（summary要素に display: inline; などを指定すれば消すことはできます。）
これによって、従来からある2つの記法🔴🟠と合わせて、3通りの隠し方ができるようになりました。
🔴 指定範囲を隠す記法： [H:～] または [H:ラベル:～]
🟠 それ以降のすべてを隠す記法： <>
🔵 指定範囲を折り畳む記法： [O:ラベル:～]
従来からちらほら「続きを読む」ボタンと「畳む」ボタンを同じ位置に掲載したい、というご要望を頂いていましたが、今回実装した「details＋summary要素による折り畳み機能」で、ほぼそれと同じ効果を実現できると思います。
▼詳しい解説（ヘルプドキュメント）：
この機能は、他の機能と同様にボタンクリックで挿入する機能を用意していますが、使い方に若干の注意点があるため、標準では非表示になっています（その場合でも直接本文に記法を書けば使えます）。表示させる方法や、メリット・注意点などの情報は、使い方・設定方法ページの「折り畳み：指定の範囲内だけを折り畳んでトグルボタンで表示/非表示を切り替え表示する機能」項目をご覧下さい。
▼「続きを読む」系統3種類の比較：
投稿本文中の一部を隠す「続きを読む」系統の機能が3種類（※鍵付き投稿機能を加えたら4種類ですけども）に増えましたから、ちょいと仕様を比較整理できる情報があった方が良いかな……と思って、ヘルプドキュメントに比較表を加えてみました。
詳しくは、使い方・設定方法ページ内の『続きを読む(一部を隠す)機能の仕様』区画で直接ご確認下さい。
▼装飾について：
今バージョンの標準添付各スキンのうち、特殊なモード用を除いた9種類には「折り畳み用のCSS」を追記しています。どのスキンもほぼ同じ感じの装飾にしていますが、下図のようにスキンのカラーに合わせてボタン配色等を少しだけ変えてあります。
▲左側：標準スキンでの表示例 ／ 右側：昔のTwitterっぽいスキン(ピンク)での表示例
追記した「折り畳み部分用のCSSソース」だけを抜き出したソースは、oritatami-v462.css にあります。カスタマイズしてお使いの場合や、自作スキンをお使いの場合には、参考にして下さい。（もっとも、details＋summary要素の折り畳み機能は、HTML側に存在している機能ですから、何一つ装飾しなくても動作はしますけども。）
なお、「折り畳み」機能で使われるdetails要素＋summary要素が具体的にどのような形で出力されるのかは、カスタマイズ方法ページの「「折り畳み」機能に使われるマークアップ（HTMLタグ）をカスタマイズする方法」項目にHTMLソースと解説を掲載していますのでご参照下さい。
🌸投稿内のn番目の画像を出力する [[ONEPICT:n]] 記法に、細かなオプション記法を追加。
投稿本文内のn番目の画像だけを出力する [[ONEPICT:n]] 記法に、「リンクにならない記法」や「各種の値だけを出力する記法」など、細かなオプションを追加しました。
てがろぐの内側スキンに [[ONEPICT:1]] と書くと「投稿本文内の1つ目の画像」だけが出力されます。この記法は以前からあります。しかし、これだと設定によっては【リンク付き】の状態で出力される場合がありますし、投稿本文の書き方によっては【キャプション付き】で出力されたりします。
このように出力が様々だと、複雑なスキンを作る際に活用しにくい問題がありましたので、以下のような記法を増やしました。
▼新設した記法①：
[[ONEPICT:1:IMG]]：設定に関係なく、本文内1つ目の画像単独のimg要素だけを出力する。
▼新設した記法②：
[[ONEPICT:1:VALUE:SRC]]：画像のURLだけを出力する。
[[ONEPICT:1:VALUE:CLASS]]：画像のフラグだけを(あれば)出力する。
[[ONEPICT:1:VALUE:ALT]]：画像のキャプションだけを出力する。
[[ONEPICT:1:VALUE:WIDTH]]：画像の横幅を出力する。(認識している場合だけ)
[[ONEPICT:1:VALUE:HEIGHT]]：画像の高さを出力する。(認識している場合だけ)
[[ONEPICT:1:VALUE:LOADING]]：loading="lazy"の指定があればそれ(値だけ)を出力する。
1枚目の画像を使って任意の場所へリンクさせたい場合には、原寸画像へのリンクになると困りますよね。その場合には、【新設した記法①】の [[ONEPICT:1:IMG]] を使うと良いです。常にimg要素だけしか出力されませんから。
また、画像のフラグを使って「画像の外側を囲む何らかの要素」を設けたい場合には、【新設した記法②】の [[ONEPICT:1:VALUE:CLASS]] を使って、例えば、<span class="[[ONEPICT:1:VALUE:CLASS]]"> ～ </span> のように書く方法などが使えるでしょう。
※【新設した記法②】の各記法には、値だけが出力されます。例えば、画像の横幅サイズが 300px なら、[[ONEPICT:1:VALUE:WIDTH]] には「300」という数字だけが出力されます。（ただし、指定番目の画像が存在しない場合や、てがろぐ側が画像サイズを認識できていない画像に対しては、何も出力されません。）
➡ 詳しくは、カスタマイズ方法ページのリファレンス内【投稿本文に含まれる画像関連要素】項目に追記してありますのでご覧下さい。
▼今回のその他の機能追加：
🌺Faviconの設定機能を追加
管理画面から任意のFavicon(ファビコン)を適用できる設定を加えました。
従来でもWebサイトの最上階層に favicon.ico ファイルがあれば、てがろぐ（管理画面も含む）でもそのFaviconが表示されていました。しかし、てがろぐだけに専用のFaviconを表示したい場合もあるかもしれませんので、管理画面から任意のFaviconを適用できる設定も加えました。
標準では「指定しない」になっていますから、強制的に何らかのFaviconが適用されるようなことはありません。「独自に設定する」に変更した上で、FaviconのURL等を書けば、それがFaviconとして採用されます。ついでに、『て』意匠の内蔵アイコンも用意しておきました。「特に使いたいFaviconはないが、てがろぐを使っていることは軽く示したい」みたいな場合にご活用下さい。(笑)
※備考：この『て』アイコンは個別にダウンロードしてご活用頂くこともできます。FAQ・豆知識ページの「てがろぐ用Favicon画像」項目からダウンロードできます。
なお、「Favicon URL等」欄には、URLを書いても構いませんし、「/」で始まる絶対パスや、相対パス、Base64でエンコードされたデータを書くこともできます。（link要素のhref属性値に書ける値なら何でも登録できます。）
Faviconの適用先を「管理画面内のみ」にすると、管理画面内だけに指定のFaviconが適用されます。この場合は、（てがろぐ複数設置時などで）識別する用途に使えそうな気がします。「管理画面とスキン」にした場合は、外側スキンで [[FAVICON]] と書かれた位置にFaviconを表示するためのlink要素が出力されます。（※スキン側にこの記述がない場合は、どこにも出力されません。）
スキンに書ける記法には、さらにオプションもあります。
詳しくは、カスタマイズ方法ページ内のリファレンスの【特殊機能要素】欄末尾をご覧下さい。
🌺画像拡大スクリプトを任意に指定する際、複数ファイルの読み込み指定を可能に
Lightbox以外のスクリプトを使いたい場合で、JavaScriptやCSSファイルを2つ以上読み込む必要があるケースにも対応。
てがろぐでは標準で画像拡大スクリプトにLightboxを使いますが、任意のスクリプトに変更もできます。その際、従来は「JavaScriptファイル」と「CSSファイル」をそれぞれ1ファイルずつしか指定できませんでしたが、半角スペース区切りで複数のファイルを指定できるようにしました。これで、JavaScriptファイル2つの読み込みが必要な場合でも管理画面から指定できます。
詳しい書き方や、オプションの意味などについては、カスタマイズ方法ページの『Lightbox以外の画像拡大スクリプトを読み込んで使う方法』区画にある、「設定箇所1（前半：スクリプトファイルの読み込み）」項目以降あたり（備考2～3）をご覧下さい。
▼セキュリティ面の属性について
将来的には対応予定ですが、現在のバージョンでは（この設定機能を使って読み込む場合の）JavaScriptファイルにcrossorigin属性やintegrity属性を加えることはできません。
今の時点でcrossorigin属性とintegrity属性を加えたい場合は、てがろぐ側の機能では読み込ませずに、スキンHTMLに直接script要素を書いて下さい。
🌺使用回数が指定値以上のハッシュタグだけをリスト表示する記法を追加
使用回数が指定値以上のハッシュタグだけをリスト表示できる [[HASHTAG:LIST(000+)]] 記法を追加。(数値は1以上の任意の整数)
従来から、外側スキンに [[HASHTAG:LIST]] と書くとハッシュタグのリストが出力される機能がありましたが、使用回数の多寡に関係なくすべてのハッシュタグが一気に出力される仕様でしたので、長ぁ～いリストになる場合もありました。
そこで、 [[HASHTAG:LIST(10+)]] のように書くことで、「10回以上使われているタグ」に限って出力できる機能を加えました。（※閾値は自由に指定可能です。）
上図は、
- 左端が、従来からある全表示の長ぁ～いハッシュタグリスト
- 中央が、「2回以上使われているハッシュタグ」に限定したリスト
- 右端が、「10回以上使われているハッシュタグ」に限定したリスト
記法 [[HASHTAG:LIST(123+)]] の数字部分は、1以上の整数なら任意の値を自由に指定できます。（「1」を指定する意味はありませんけども。^^;）
数値の後に半角の「+」記号が必須ですので忘れないようご注意下さい。
ハッシュタグリストの記法には、いろいろオプション記法がありますが、それらとも併用が可能です。
例えば......
- リンク先を特別なモードにしたい場合の [[HASHTAG:LIST:モード指定]] 記法と併せて使いたい場合は、[[HASHTAG:LIST(20+):モード指定]] のように記述できます。
- ハッシュタグリストをプルダウンメニュー（セレクトボックス）の形で出力する[[HASHTAG:PULL]] 記法に対しては [[HASHTAG:PULL(25+)]] のように書けます。
➡ そのほかのオプション記法とも併用可能ですので、詳しい書き方は、カスタマイズ方法ページのリファレンス内【ハッシュタグ要素】項目をご覧下さい。
🌺最初は年だけが見えている折り畳み型の日付リンクリスト記法を追加
日付リンクのうち、初期状態では年リストだけが見えていて、クリックすると月リンクが展開される（details＋summary要素での出力になる） [[DATEBOX:EXPAND]] 記法を追加。
てがろぐ外側スキンに [[DATEBOX:LIST]] と書く方法で日付一覧を出すと、投稿期間が長い場合にはリンクリストも長ぁ～くなります。そこで、初期状態では年リストだけが見えていて、クリックすると月リンクが展開される（details＋summary要素での）出力になる [[DATEBOX:EXPAND]] を加えてみました。
上図の右上のように、クリックした年に対してだけ、その年内の月別リンクリストが見えるように動作します。この展開型のリストは、HTMLのdetails＋summary要素で出力されますので、JavaScript不要で展開／伸縮できます。
なお、月別リンクリスト部分のHTMLは、従来からある（上図左側の）日付リストと同じHTMLが出力されます。class名も同じなので、従来の日付リスト用の装飾がそのまま適用されます。
しかし、summary要素がクリックされた後に展開される部分（上図で赤色の吹き出しの先に見えている「左端に薄い緑色の縦バーが付加されている空間」）については、何らかの装飾を加えない限り、デフォルトの状態で見えます。
上図のサンプルでは、以下のようなCSSを加えています。
/* ▽日付折り畳みリスト内の追加装飾 */
.datelimit-expand {
border-left: 3px solid #aca; /* 左端の縦線 */
padding-left: 0.5rem; /* 左側の(縦線より)内側の余白量 */
margin-left: 0.2rem; /* 左側の(縦線より)外側の余白量 */
margin-bottom: 0.5rem; /* 下側の余白量 */
}
summary要素がクリックされた後に展開される部分は、<div class="datelimit-expand"> ～ </div>というHTMLでマークアップされていますので、これに対して装飾を加えると、展開された部分全体に対して装飾ができます。
なお、従来からある日付一覧2種類の記法には、[[DATEBOX:LIST:モード指定]] や[[DATEBOX:PULL:モード指定]] のようなオプション記法もありました。
今回追加した [[DATEBOX:EXPAND]] でも、[[DATEBOX:EXPAND:モード指定]] のように同じオプションを付加できます。
➡ 詳しい書き方は、カスタマイズ方法ページのリファレンス内【日付リスト要素】項目をご覧下さい。
▼その他の細かな機能追加：
🌷ログインフォームの上側に任意のメッセージを掲載できる設定機能
従来から、ログインフォームの下側に任意のメッセージを掲載する機能がありましたが、それとは別に、ログインフォームの上側にも任意のメッセージを掲載できる機能を加えました。（下図の緑色矢印の先）
複数のてがろぐCGIを併用している場合で、「どのてがろぐのログインなのか」を識別する用途や、複数人で共有している場合などで、ログイン関連のメッセージを伝えたい場合などに活用できるかもしれません。
そのほか、ログイン者限定公開機能でログインを促すメッセージを自由に書き換える方法と併用すると（操作の）分かりやすさが増すかもしれません。
また、ログインフォームに検索避けmeta要素を出力する機能も加えました。上図の黄色矢印部分です。デフォルトでONなので、何も設定しなくても出力されます。
▼仕様改善：
🌳装飾系ボタンの動作改善
投稿欄の下部にある「装飾」ボタンを押して出てくる各種ボタンのうち、下図に3色の矢印🟡🟢🔵で示したボタンの動作仕様を、後述の通り改善しました。
🟡「折畳」ボタンで、サマリー(ラベル)を空欄にしたままでも折り畳み記法を挿入するよう改善。
➡ 今バージョンからサポートした折り畳み記法では、[O:ラベル:中身] のようにラベルを指定できる仕様ですが、ラベルを省略した [O:中身] という書き方もできます。しかし、（初期実装段階でのβ版では）投稿欄下部に表示される「折畳」ボタンから入力する方法だと省略できませんでした。
この仕様を改善して、下図のように（ラベルが不要なら）空欄のままでOKボタンを押せば、ラベルを省略した記法が挿入されるようにしました。
ここを空欄にしたまま[OK]ボタンを押せば、ラベルを省略した記法が挿入されます。
※注：この「折畳」ボタンは初期状態では非表示になっていますので見えません。使いたい場合は、管理画面の[設定]→[投稿欄の表示]→【装飾ボタンの表示設定】でONにして下さい。
🟢「隠す」ボタンで、ラベルの入力ができるように改善。(ラベルを省略したい場合は空欄のままOKを押す)
➡ 続きを読む記法でも、ボタンラベルを指定した [H:ラベル:中身] という書き方と、ラベルを省略した [H:中身] という書き方ができます。従来では、投稿欄下部に表示される「隠す」ボタンを使うと、問答無用で後者の [H:中身] の書き方が挿入されていましたが、下図のようにラベル入力ダイアログを開くよう改善しました。
先の折り畳み記法の場合と同様に、空欄のままでOKを押せば、従来と同じようにラベルを省略した記法が挿入されます。
🔵「汎用装飾1～9」ボタンで、追加のclass名を入力できるように改善。(省略したい場合は空欄のままOKを押す)
➡ 先程の図の水色矢印部分には ①②③④⑤…… のようなボタンが見えています。これは、Ver 4.4.4以降で使える汎用装飾を挿入するためのボタンです。このボタンを押した場合、従来は問答無用で [1:中身] のような最小限の記法が出力されていました。しかし、記法の仕様としては任意のclass名を指定することもできますので、下図のようにclass名をその場で入力できるダイアログを表示するように改善しました。
これも同様に、空欄のままでOKを押せば、従来と同じようにclass名を省略した記法が挿入されます。
※注：これらのボタンは初期状態では非表示になっていますので見えません。使いたい場合は、管理画面の[設定]→[投稿欄の表示]→【装飾ボタンの表示設定】区画で、下図のあたりから設定して下さい。
ボタンラベルもここから変更できます。詳しくは、使い方・設定方法ページの「文字装飾記法をボタンクリックで挿入する方法」をご覧下さい。
🌳.htaccessの影響で管理画面上からは過去バックアップのダウンロードが阻まれる問題を解消。
標準の.htaccessファイルなどを使って.xmlファイルへのアクセスをブロックしていると、バックアップ専用ディレクトリ内の.xmlファイルへのアクセスもブロックされるために、管理画面上からは過去のバックアップのダウンロードができませんでした。そこで、過去のバックアップファイルのダウンロード処理も、てがろぐ内部を経由してダウンロードさせるように仕様を改善しました。（ログイン状態の場合にのみダウンロードできます。）
てがろぐには自動バックアップ機能があります。投稿するたびに、その直前の状態を自動バックアップします。なので、誤操作等で既存データを吹き飛ばしてしまっても、以前の投稿はバックアップ用ディレクトリに残っています。「吹き飛ばしたのはどうやら数日前らしいぞ……？」と後から気付いた場合でも、過去30バージョンは残っていますから（設定で増量も可）、直近だけでなく、離れた「以前の状態」にも戻せます。
下図の【水色矢印の先】に見える各ボタンは『最新のデータファイルをダウンロードできるボタン』で、【黄色矢印の先】に見える各リンクは『過去のバックアップファイルへのリンク』です。
問題は、その「古いバックアップのダウンロード方法」です。FTP等の手段でダウンロードする分には何も支障ないのですが、『設置を推奨する .htaccess ファイル』で適切なアクセス制限を施していると、管理画面上からダウンロードしようと操作しても 403 Forbiddenエラーになってダウンロードできませんでした。（※上図の【水色矢印の先】にある各ボタンからは問題なくダウンロードできますが、【黄色矢印の先】に見える各リンクからはダウンロードできませんでした。）
これは、【水色矢印の先】の方は、一旦てがろぐ内部を経由してデータをダウンロードさせる仕組みになっているのに対して、【黄色矢印の先】の方は単にそのファイルへリンクしているに過ぎなかったからです。
まあ、ここからダウンロードできなくても、「これだけのファイルが、バックアップ専用ディレクトリに蓄積されているよ」と知らせる意味くらいには役に立ちますけども。^^;
➡ そこで、今回のバージョンでは、【黄色矢印】の方も【水色矢印】と同じように、てがろぐ内部を経由してダウンロードさせる方式に改善しました。なので、 .htaccessファイルを使って適切にアクセス制限をしている環境でも、ブラウザ上から過去のバックアップファイルをダウンロードできます。（※適切な権限のIDでログインしている場合のみ。）
🌳Apple Musicの共有用URLの新仕様に対応
Apple MusicのURLの仕様が変わったために、新URLを使って単曲を埋め込んだ際に（埋め込み部分の下部に）無駄な空間が出てしまっていた点を修正しました。
特に何も設定する必要はなく、今回のバージョンに更新するだけで、新旧どちらのURLで埋め込んだ場合でも、上図のように無駄な空間なく表示されます。
🌳使用中画像の検索機能を（検索語に「PICT:」を指定せずに）ファイル名だけで検索するよう変更
画像管理画面には、下図の水色矢印部分のように、各画像の使用場所を一覧できるボタン「投稿を見る」と「一覧で見る」があります。これを使うと「PICT: ＋画像ファイル名」という検索語で全文検索した結果を返す仕様になっていましたが、「PICT:」を使わずに、ファイル名だけで検索するよう変更しました。
この仕様改善によって、通常の画像表示以外に [IMG]URL の記法を使って表示している場合もヒットするようになります。（ただファイル名を書いただけの場合もヒットしてしまいますが。）
🌳画像管理画面からの画像削除時に、サムネイル画像があればそれも同時に削除するように改善
画像管理画面から画像を削除する操作をした際に、当該画像にサムネイル画像があれば、サムネイル画像も併せて削除するように動作を改善しました。（※今のところ、てがろぐ側からサムネイル画像を直接UPする機能はありませんが、画像保存用ディレクトリ内に mini サブディレクトリを設けて、そこに同名の画像ファイルをUPすると、サムネイル画像として採用される仕様があります。）
上図は、画像管理画面から画像3枚を削除した後の画面です。黄色矢印部分で示したように（サムネイル画像がある場合に限って）サムネイル画像も併せて削除されていることが分かります。
なお、サムネイル画像の認識等に関する仕様については、使い方・設定方法ページの「サムネイル画像があればサムネイル画像の方を表示する機能(簡易版)」区画をご覧下さい。
🌳エラー発生時の環境情報の出力をデフォルトで「しない」に変更
てがろぐCGIで「処理を継続できないようなエラー」が発生した場合、エラー画面には（主に問い合わせ時の参考情報として教えて頂くための）環境情報を表示していました。この表示は従来から、システム設定の「高度な設定」でON/OFFが可能でしたが、デフォルトでOFFになるよう標準値を変更しました。
🌳デフォルトで読み込まれるJavaScriptのバージョンを最新版に更新
画像管理画面や、何も設定を変更しなかった場合に標準で読み込まれるJavaScriptのjQueryとLightboxのバージョンを最新版に更新しました。
具体的には、jQueryはVer 3.7.1(min)が、LightboxはVer 2.11.5(min)がCDNから読み込まれるようになります。
▼スキン更新：
🌻折り畳み表示用のCSSを追記。（通常モードで使うスキン9種類のみ）
今回のバージョンからサポートした折り畳み表示機能に対応したCSSを、標準添付各スキン（のうち、特殊なモード用を除いた9種類に）追記しました。
詳しくは、このリリースノートの先頭『🌸指定範囲を(details＋summary要素で)折り畳んだ状態で表示する装飾記法を追加』項目に記しましたのでそちらをご参照下さい。
🌻動画埋め込み表示用のCSSを追記。（通常モードで使うスキン9種類のみ）
今回のバージョンからサポートした動画ファイルの埋め込み表示に対応したCSSを、標準添付各スキン（のうち、特殊なモード用を除いた9種類に）追記しました。
詳しくは、このリリースノートの先頭『🌸動画ファイルの埋め込み表示機能』項目に記しましたのでそちらをご参照下さい。
▼#不具合修正 ：
❎検索語のハイライト機能を有効にしている状況で、全文検索で使う検索語の中に「半角の英数記号1文字だけの検索語」が含まれているときに、「続きを読む」機能や「OGPカード型リンク」の表示機能が使えなくなる不具合を修正。
全文検索結果の表示時に、検索語をハイライト表示する機能を有効にしている場合（※標準で「有効」に設定されています）で、検索語の中に「半角の英数記号1文字程度だけの検索語」が含まれているときに、「続きを読む」機能や「OGPカード型リンク」の表示機能が正常に動作しなくなる可能性がある不具合がありました。これを修正しました。
※全文検索結果の表示時に検索語をハイライトする設定とは、下図の黄色矢印部分のことです。（出力要素には何を選択していても同様に発生していました。）
❎検索文字列の先頭に空白があると文字化けする問題を解決。（全文検索でのハイライト表示処理の不具合を解消）
全文検索結果を表示するページでの、検索語の強調表示の処理に不具合がありまして、管理画面の[設定]→[ページの表示]→【全文検索／表示】で『検索結果に含まれる検索語を強調表示する』をONにしている場合に限って（※標準でONになっています）、検索文字列の先頭に空白文字があると検索結果ページ全体が文字化けする問題がありました。その点を解決しました。
❎[[COMMENT:TITLE]]記法で1行目を分離するスキンで表示が崩れる可能性がある問題を解決。
投稿本文の1行目に「隠す記法」・「折り畳み記法」・「リスト記法」のどれかがあるとき、スキン側で [[COMMENT:TITLE]] の記法を使って1行目だけを分離しているときに、表示が崩れてしまう可能性がある問題を解決しました。
具体的には、[[COMMENT:TITLE]] か [[COMMENT:BODY]] の記述がある場合に限って、投稿本文の1行目に上記の記法があれば、自動的に内部的に空行を先頭に挿入することで、投稿本文の1行目に書かれている内容が「2行目」だと解釈、投稿本文の2行目に書かれている内容が「3行目」だと解釈される……ように自動調整する仕様にしました。この場合、[[COMMENT:TITLE]] には（投稿本文の1行目を空行にした場合と同じように）「No.123」の形で投稿番号が出力されます。
※この自動調整は、 [[COMMENT:LINE:1]] のように行番号を指定して挿入される場合には働きません。
※投稿本文を行単位で分割表示する記法に関しては、カスタマイズ方法ページ内のリファレンス【投稿本文関連要素（オプション）】項目をご参照下さい。
❎装飾の入力をキャンセルした場合に、投稿欄にフォーカスが戻らない不具合を修正。
装飾の「リスト」ボタンと「隠す」ボタンで、入力をキャンセルした場合にだけ、投稿欄にフォーカスが戻らなかった不具合を修正しました。（※JavaScriptがエラーを出していた問題を修正しました。）
❎予約投稿を有効にしているとき、（ログインしている状態で）存在しない投稿番号の単独ページにアクセスするとシステムエラー画面が出る問題を解決。
以下の3条件を満たした際にエラー画面が出てしまう不具合がありましたので解決しました。
- 条件1：予約投稿を有効にしているときに
- 条件2：ログインしている状態で
- 条件3：存在しない投稿番号の単独ページにアクセスする
なお、「条件2」がありますので、一般の閲覧者がそのエラー画面に遭遇することはありません。
❎管理画面の投稿一覧で本文の一部が抜粋されない不具合を修正。
管理画面の投稿一覧では、各投稿の冒頭が抜粋表示されます。抜粋範囲内に画像がある場合は (画像:jpg) のように省略表示されますが、同一投稿内に複数の画像があったり、URLの記述があったりすると、その間の文字列が抜粋されない不具合がありました。その点を修正しました。
以上、ご活用頂ければ幸いです。
※不具合の修正と動作仕様の改善も含んでおりますので、使いたい追加機能がない場合でもバージョンアップ頂くことをお勧め致します。
※バージョンアップしても、データや設定はそのまま引き継げます。バージョンアップ方法について詳しくは、「CGIの更新方法」をご覧下さい。
なお、開発進捗状況報告サイトでフォロー頂くと、てがろぐCGIの最新β版や正式版の公開時にメールで連絡を受け取ることもできますので、ぜひご活用下さい。(╹◡╹)ﾉ
フォロー数が増えると、私の開発モチベーションが向上するメリットもあります！！！🤩
：15836文字 修正
てがろぐ Ver 4.3.0 を公開しました！ #Update
てがろぐ Ver 4.3.0 を公開しました。隣接・近傍投稿の一括表示モード、表示対象（同一カテゴリ等）だけに限定した隣接投稿への移動機能、ログイン者限定表示機能、編集画面に自由なHTMLをスキン別に追加できる機能、限定表示中のカテゴリの各種情報の挿入記法、ゲストを読み専IDにする機能、SITEMAP XMLの静的出力機能などの追加が主な更新点です。その他、細々した仕様改善や機能追加を含んでいます。
➡ https://www.nishishi.com/cgi/tegalog/
バージョンアップするには、
🆕 Ver 4.3.0の更新点(概要)：
《▼大きな機能追加》
●隣接・近傍投稿の一括閲覧機能（隣り合う数投稿をまとめて表示する機能）の追加。
●「その状況で表示対象になっている投稿」だけに限定した隣接投稿に移動できる機能（※同カテゴリに限定した隣接投稿への移動機能）の追加。
●条件指定パラメータを引き継いだ単独投稿にリンクできる記法（＝「その状況で表示対象になっている投稿」だけに限定した隣接投稿に移動できる機能が使える状態の単独投稿へリンクできる記法）の追加。
●ログイン済みでないとどのページも閲覧できなくする「ログイン者限定表示」機能の追加。
●新規投稿/編集画面に自由なHTML(edit.htm)をスキン別に加える機能の追加。
《▼その他の機能追加》
●そのとき限定されているカテゴリの各種情報を挿入できる専用記法の追加。
●ゲストIDで投稿を禁止する設定（＝ログイン者限定表示と併用することで「読者用ID」になる機能）の追加。
●リスト記法で、リストの種類や記号を指定するオプションを使っている場合でも、さらに任意のclass名を指定できる機能を追加。
●SITEMAP XMLを静的ファイルに出力する機能を追加。
●カテゴリの概要文でHTMLを使えるようにできる設定の追加。
《▼細かな機能追加》
●カスタム絵文字のファイル名にハイフン・ドット・アンダーバーが含まれているとき、それらで分割した文字列を使ったclass名をさらに加える機能を追加。
●アタック目的のアクセスを簡易的に検出して拒否する(400 Bad Requestを返す)機能を追加。
《▼仕様改善》
●既存ハッシュタグ簡単挿入機能で、ハッシュタグの後ではなく前に半角スペースを挿入できる(または一切挿入しない)設定機能を追加。
●「任意URLリンク」ボタンで、リンク先が丸括弧で囲まれる場合には、直後に半角スペースを自動挿入しない仕様に改善。
●データファイルを読むよりも前にパラメータの不正をチェックすることで、無駄なデータ読み込みを発生させないよう改善。
●QUICKPOSTで投稿欄が空っぽの状態で投稿したときの動作を改善。
●投稿単独表示時の隣接投稿への移動先解釈の改善。
●管理画面のボタンの行高を固定することで、一部のモバイル端末でボタンの高さがガタガタになる現象を解消。
●YouTubeの埋め込みに「ライブ動画の共有用URL」も使用可能に。
《▼不具合修正》
●URLを丸括弧で囲む [ラベル](URL) 記法の直後に半角丸括弧を書いたとき、記法末尾の「)」記号がURLの一部だと誤解されてしまう不具合を修正。
▼今回の大きな機能追加：
🌸隣接・近傍投稿の一括閲覧機能（隣り合う数投稿をまとめて表示する機能）の追加。
ある特定の投稿の前後に、どんな投稿があるのかを一括して閲覧できる方法を追加しました。
▼解説：
例えば、パラメータ ?postid=123&mode=around3 で、No.123 の前後3件ずつの最大計7投稿を一括閲覧できます。
前後の何件ずつを一括表示するのかは数値(1～9)で指定できるため、
✅「 ?postid=123&mode=around1 」なら前後1件ずつの計3投稿
✅「 ?postid=123&mode=around2 」なら前後2件ずつの計5投稿
： ： ：
✅「 ?postid=123&mode=around9 」なら前後9件ずつの計19投稿
……が閲覧できます。
※数字を省略した場合は、後述する設定値の数(＝標準では 3 )が指定されたとみなされます。
過去の投稿に言及したいとき、>>123 みたいな感じでその投稿番号へリンクしておくことがよくあります。このリンクをたどれば No.123 の投稿を単独で閲覧できるわけですが、「その投稿の前後にはどんな投稿をしていたんだっけ？」という疑問を持つことがあります。
その場合、従来は『前後に1件ずつ移動するリンク』を使って1件ずつ見ていくしかありませんでした。本当に隣接する1件を見れば済むだけならそれで良いのですが、もうちょっと幅広く参照したいと思うこともよくあります。
そんなときに今回実装したこの機能を使えば、「いま単独表示しているこの投稿の前後にどんな投稿があるのか？」を、前後の数件まとめて一括閲覧できます。
▼使用方法：
投稿単独表示時に本文の後に出力されるユーティリティリンク枠に、下図のように『この投稿に隣接する前後3件をまとめて見る』というリンクが追加されていますので、ここからでもアクセスできます。（非表示に設定することもできます。）
▼設定箇所：
標準では前後3件ずつを見るリンクが出力されますが、何件ずつにするのかは設定（下図水色矢印部分）で変更できます。また、このリンクの表示をOFFにするには、下図の緑色矢印部分の項目をOFFにすれば良いです。
➡ 詳しくは、ヘルプドキュメント「使い方・設定方法」ページ内の『隣接投稿の一括閲覧機能（隣り合う投稿をまとめて表示する方法）』項目をご覧下さい。
🌸「その状況で表示対象になっている投稿」だけに限定した隣接投稿に移動できる機能（※同カテゴリに限定した隣接投稿への移動機能）の追加。
以前から『同じカテゴリに限定して隣接投稿へ移動できるようにして欲しい』というご要望を頂いていました。その機能を実装しました。カテゴリに限らず、ハッシュタグ限定表示でも、全文検索の指定でも何でも、表示条件を絞るあらゆる条件で「その条件を満たす投稿に限った隣の投稿」へ移動できるようになりました。
▼解説：
下表のような属性・カテゴリ・内容の No.96～103 の投稿があり、「現在は No.100 が単独で表示されている」という場合を例にして説明します。
表示条件が限定されていない ?postid=100 のパラメータでアクセスされている場合は、表示対象外である下書きだけを飛ばして「« No.99」と「No.102 »」がリンク先になります。（※従来のバージョンでは、下書きを飛ばすこともせず、単純に隣接する「« No.99」と「No.101 »」がリンク先になっていました。）
ここで、表示条件を加えると、下記のように前後のリンク先が変化します。
✅カテゴリinfo限定表示 ?postid=100&cat=info なら、
➡「« No.97」と「No.103 »」がリンク先になります。
✅カテゴリdiary限定表示 ?postid=100&cat=diary なら、
➡「« No.96」と「No.102 »」がリンク先になります。（下書きは飛ばすため。）
✅ハッシュタグ#Test限定表示 ?postid=100&tag=Test なら、
➡「« No.97」と「No.102 »」がリンク先になります。
そのほか、全文検索（qパラメータ）、ユーザ限定（useridパラメータ）、日付限定（dateパラメータ）を使って表示対象を限定することもできます。
どの場合でも、「条件を満たす投稿に限定した隣」が前後の移動リンクとして出力されます。
➡ 詳しくは、ヘルプドキュメント「使い方・設定方法」ページ内の『「その状況で表示対象になっている投稿」だけに限定した隣接投稿に移動できる機能』項目をご覧下さい。
また、このような「条件指定パラメータを維持した状態で投稿単独ページへ移動するためのURL」を出力する専用の記法も用意しています。その点は、次の項目で解説します。
🌸条件指定パラメータを引き継いだ単独投稿にリンクできる記法（＝「その状況で表示対象になっている投稿」だけに限定した隣接投稿に移動できる機能が使える状態の単独投稿へリンクできる記法）の追加。
投稿単独ページへ移動できるURLを出力するための記法 [[PERMAURL]] のオプションを追加しました。これによって、投稿単独表示時に「同一カテゴリだけに限定した隣接投稿」などへ前後移動できるようになります。
▼解説：
「条件指定パラメータを引き継いだ単独投稿」に移動できるURLを出力する専用記法を追加しましたので、
追加した記法の意味は以下の通りです。
また、「どの条件を維持するのか？」を識別子で選択的に指定できる拡張記法 [[PERMAURL:KEEPCOND(識別子)]] もあります。
識別子には、下記の7種類が使えます。
① M :モード を維持する
② U :ユーザ限定 を維持する
③ C :カテゴリ限定 を維持する
④ H :ハッシュタグ限定 を維持する
⑤ S :検索語 を維持する
⑥ D :日付指定 を維持する
⑦ O :表示順序 を維持する
これによって、例えば、
➊『カテゴリ限定表示時から投稿単独ページに移動した場合には、同カテゴリに属する投稿に限定した隣接投稿に前後移動できるようにしたい。しかし、カテゴリ以外の条件でさらに絞り込まれていたとしてもそれらの条件は無視して、カテゴリだけに限定した隣接投稿に移動させたい』
➋『ギャラリーモードで、ハッシュタグやカテゴリや検索語で絞り込まれている場合には、その条件に該当する投稿だけに限定した隣接投稿に前後移動できるようにしたい。しかし、モードは解除して、投稿者IDや日付で絞り込まれている場合は無視したい』
……といったスキンが作れます。
具体的には、
➊は、 [[PERMAURL:KEEPCOND(C)]] と書けば良く、
➋は、 [[PERMAURL:KEEPCOND(CHS)]] と書けば良い
です。
なお、識別子を指定せずに [[PERMAURL:KEEPCOND]] と書いた場合は、[[PERMAURL:KEEPCOND(MUCHSD)]] と書いた場合と同じになります。（つまり、「O＝表示順序」以外のすべての条件が維持されます。）
➡ 記法について詳しくは、リファレンス内の【投稿単独URL出力要素】区画をご覧下さい。[[PERMAURL]]系統のすべての記法を一覧できます。
➡ また、『「その状況で表示対象になっている投稿」だけに限定した隣接投稿に移動できる機能』について詳しくは、ヘルプドキュメント「使い方・設定方法」ページ内にある 『1投稿の単独閲覧時（投稿単独ページ表示時）での前後移動』項目をご覧下さい。
（※そこに含まれる『Ⓑ 表示条件が限定されている場合に採用される移動先』項目もご参照頂くと、より分かりやすいかもしれません。）
🌸ログイン済みでないとどのページも閲覧できなくする「ログイン者限定表示」機能の追加。
自分専用または内輪専用として使いたい場合等のために、てがろぐにログイン済みの状態でなければどのページも閲覧できない動作モードを追加しました。
▼解説：
非ログイン状態でアクセスすると、ログインを促すメッセージ（下図）が表示されるだけになります。管理画面では、常に右上に橙色で「ログイン者限定表示中」のサインが見えます。
▼設定：
設定は、管理画面の[設定]→[システム設定]→【高度な設定】→[動作形態]項目（下図の黄色矢印の先）からできます。ただし、後述の事前準備が必須です。
ここで、「ゲストIDによる投稿を禁止する」にチェックを入れておくと、「ゲスト権限のID（＝Lv.1のID）」を読者専用IDとして機能させることもできます。（※その機能については後述の『🌺ゲストIDで投稿を禁止する設定』項目で改めて解説します。）
▼事前準備（必須）：
ブラウザのアドレス欄にデータファイル（tegalog.xml）のURLを打ってみたときに、そのままファイルが閲覧・ダウンロード可能になっている状態では、この機能の意味がありません。したがって、この機能はデータファイルへの直接アクセスをブロックする .htaccess ファイルによるアクセス制限を併用する必要があります。
そのため、.htaccessファイルが存在しない状態で設定しようとしても、下図のように設定が拒否される仕様になっています。
したがって、この機能を有効にする前に、まずは .htaccess ファイルを設置してからご使用下さい。
なお、この機能を使っても画像は保護されません（＝何らかの方法で画像のURLが分かれば、誰でもその画像を閲覧できます）。何もかもを保護するには、サーバ側の認証機能（Basic認証等）をお使い頂く必要があります。この機能は、あくまでも「簡易版の非公開モード」のような位置づけである点にご注意下さい。
➡ 詳しくは、ヘルプドキュメントの「ログイン済みでないとどのページも閲覧できなくする「ログイン者限定表示」機能」項目をご覧下さい。
特に、……の両項目もご参照下さい。
🌸新規投稿/編集画面に自由なHTML(edit.htm)をスキン別に加える機能の追加。
編集画面に自前の edit.css と edit.js を読み込む機能は従来からありましたが、スキン別に異なるファイルを読み込みたい場合のために、「そのとき適用されているスキンのディレクトリ」の中にある edit.htm を挿入する機能も用意しました。
▼解説：
この機能を使うと、
※edit.css と edit.js の挿入仕様は従来のまま（＝適用スキンに関係なく、CGI本体のあるディレクトリに存在するファイルを読み込み）です。
※ファイル名がバッティングすると紛らわしいので、edit.htm というHTMLを挿入する形にしました。（CSSやJavaScriptをスキン別に読ませたい場合は、edit.htmの中に直接記述すれば良いでしょう。）
機能の違いをまとめると、下記のようになります。
▼事前設定：
デフォルトでは無効なので、使いたい場合には下記の場所で有効に設定して頂く必要があります。
▼出力位置：
挿入される位置は、下図の赤色帯の部分です。投稿フォームよりも後に出力されますから、JavaScriptで投稿フォームそのものをカスタマイズする際にも制御がしやすいでしょう。
そのほか、単純に文章を掲載する用途にも使えますから、投稿本文を行ごとに分割して活用するスキンの場合には、「何行目が何の役割なのか」をここに書いておくことで、編集を分かりやすくできるかもしれません。
➡ 詳しくは、ヘルプドキュメントの「新規投稿/編集画面に自由なHTMLをスキン別に加える方法」項目をご覧下さい。
▼今回のその他の機能追加：
🌺そのとき限定されているカテゴリの各種情報を挿入できる専用記法の追加。
カテゴリ限定表示時（＝特定のカテゴリに属する投稿に限定して表示されている状況）で、そのカテゴリに関する各種情報（カテゴリ名や、カテゴリ概要文など）を挿入できる専用記法4つを用意しました。
カテゴリの名称だけは、従来から『 カテゴリ××に属する投稿 [xx件] 』のような形で、SITUATION部分に表示されましたが、この記法を使えば、概要文やアイコンも自由に配置して掲載できます。また、カテゴリIDは、HTMLソース内でclass名等に活用できるでしょう。
具体的には、下記の記法を追加しました。
✅[[INFO:NOWCAT:NAME]]
➡そのとき限定されているカテゴリの名称が挿入されます。
✅[[INFO:NOWCAT:DESCRIPTION]]
➡そのとき限定されているカテゴリの概要文が挿入されます。
✅[[INFO:NOWCAT:ICON]]
➡そのとき限定されているカテゴリのアイコンが挿入されます。
✅[[INFO:NOWCAT:ID]]
➡そのとき限定されているカテゴリのIDが挿入されます。
※カテゴリ限定表示時ではない状況では、何も出力されません。
※事前に許可設定をしていれば、カテゴリ概要文の中に任意のHTMLソースを含めることもできます。
➡ 詳しくは、ヘルプドキュメントのリファレンスの【現在カテゴリ情報要素】項目をご覧下さい。
🌺ゲストIDで投稿を禁止する設定（＝ログイン者限定表示と併用することで「読者用ID」になる機能）の追加。
ゲスト権限(Lv.1)のIDでの投稿を禁止することで、ゲストIDを「読み専」にできる設定を追加しました。ログイン者限定表示機能を使っている場合でも、ログインパスワードを知っている人々からの閲覧は許容したい場合等にご活用頂けます。
この設定をすると、すべてのゲストIDの動作が変わります（※既にあるIDも、これから作るIDも）。
この機能を有効にしている状態だと、ゲストIDでログインした場合には、通常の管理画面ではなく、下図のような「読み専ID専用の管理画面」だけが見えます。（てがろぐHOMEへの移動か、ログアウトのどちらかしかできない画面です。）
なお、この機能が有効な場合は、(ゲスト権限のIDでは)ログイン中でも QUICKPOST（＝ページ上に埋め込んで表示される投稿欄）は表示されません。その際は、非ログイン時と同じ出力になります。
詳しくは、『読み専ID（読むだけのユーザID）を作成する方法』項目や、『ログイン者限定表示の仕様』項目をご覧下さい。
🌺リスト記法で、リストの種類や記号を指定するオプションを使っている場合でも、さらに任意のclass名を指定できる機能を追加。
文字装飾記法には以前からリストを作る記法を用意していました。この記法にはオプションで、先頭記号や開始番号などを指定できました(➊)。また、任意のclass名を指定することもできました(➋)。しかし、その両者(➊と➋)を併用することはできませんでした。今回のバージョンでは、その併用を可能にしました。
例えば：
✅ [L:🌰:hogehoge: ～ ] と書くと、class名として listdeco-hogehoge が指定された、先頭記号が「🌰」の箇条書きリストになります。
✅ [L:5:hogehoge: ～ ] と書くと、class名として listdeco-hogehoge が指定された、5から始まる番号付きリストになります。
✅ [L:DL:hogehoge: ～ ] と書くと、class名として listdeco-hogehoge が指定された説明リスト(＝dl＋dt＋dd要素から構成されるリスト)になります。
あらかじめ用意してあるスタイルを適用させつつ、先頭記号や番号等を指定したい場合にご活用頂けます。
詳しくは、ヘルプドキュメント「使い方・設定方法」ページ内にある『リストのオプション記述方法』項目内の、「任意のclassを指定」の後半をご覧下さい。
🌺SITEMAP XMLを静的ファイルに出力する機能を追加。
新規投稿や既存投稿の再編集タイミングで、SITEMAP XMLを sitemap.txt というファイルに出力する機能を加えました。（試験実装）
SITEMAP XMLを毎回動的生成するのはサーバ資源の無駄な気もしますので。投稿データの編集時に sitemap.txt として静的ファイルに出力しておけば、サイトマップXMLの参照時にはCGIを稼働させずに済むため、サーバの負荷軽減に役立つ気がします。
➡ 詳しくは、ヘルプドキュメントの「SITEMAP XML（静的出力）」項目をご覧下さい。
※この機能は試験実装です。仕様は将来のバージョンで変更される可能性があります。現在のところ、出力されるファイル名は sitemap.txt ですが、ファイルの中身はXMLです。（ファイル拡張子 .xml のファイルを一括アクセス制限している場合のために、そのような仕様にしています。それでSITEMAP XMLとしてどこでも認識されるのかどうかはハッキリしないので、ダメそうなら将来的にはファイルの中身もプレーンテキストに変更する可能性があります。）
🌺カテゴリの概要文でHTMLを使えるようにできる設定の追加。
カテゴリの概要文中に書いたHTMLソースを、HTMLとして出力もできるようにしました。
これによって、 [[INFO:NOWCAT:DESCRIPTION]] 等の記法を使ってカテゴリ概要文を表示する際に、任意のHTMLを出力することもできるようになります。
ただし、この機能はデフォルトではOFFなので、HTMLを書きたい場合は事前に下記の設定をする必要があります。
詳しくは、ヘルプドキュメント「使い方・設定方法」ページ内の『カテゴリ設定』区画にある『カテゴリ概要文にHTMLを書きたい場合の設定』項目をご覧下さい。
なお、カテゴリの概要文を掲載するスキンの書き方については、
🟣リファレンスの【現在カテゴリ情報要素】項目や、
🟠カスタマイズ方法ページの『カテゴリツリー内の掲載内容を指定できる CATEGORY:TREE:識別子 の書き方』項目をご覧下さい。
▼その他の細かな機能追加：
🌷カスタム絵文字のファイル名にハイフン・ドット・アンダーバーが含まれているとき、それらで分割した文字列を使ったclass名をさらに加える機能を追加。
カスタム絵文字を出力する際には、絵文字ごとに特別な装飾をCSSで施しやすいように、絵文字名（ファイル名）をベースにしたclass名が出力される仕様です。この仕様をさらに拡張して、「複数のカスタム絵文字に共通する装飾」を簡単に用意できるようにしました。
具体的には、下図の①②③のclass名が新たに追加出力されるようになります。
――― ▼従来からある仕様：―――
例えば、カスタム絵文字を挿入する [:takoyaki-large:] と [:takoyaki_ikayaki-set:] という記法を書いたとき、従来は次のような2つのclass名を含むHTMLソースが出力されていました。
<span class="cemoji ce-takoyaki-large"><img 絵文字画像></span>
<span class="cemoji ce-takoyaki_ikayaki-set"><img 絵文字画像></span>
この場合は
✅「cemoji」が、どんなカスタム絵文字にも共通する装飾に使えるclass名で、
✅「ce-takoyaki-large」や「ce-takoyaki_ikayaki-set」のように「ce-絵文字名」が、その絵文字専用の装飾に使えるclass名です。
――― ▼今バージョンでの追加仕様： ―――
今バージョンでは、カスタム絵文字の名称(ファイル名)にハイフン・ドット・アンダーバーが含まれているときには、それらで分割した文字列もさらにclass名として加わる仕様を追加しました。
例えば、カスタム絵文字を挿入する [:takoyaki-large:] と [:takoyaki_ikayaki-set:] という記法を書いたとき、次のようなclass名が出力されます。
✅cemoji、ce-takoyaki-large、ce-takoyaki、ce-large
✅cemoji、ce-takoyaki_ikayaki-set、ce-takoyaki、ce-ikayaki、ce-set
つまり、class名「ce-takoyaki」を使うと、これら2つのカスタム絵文字を一括して装飾できます。絵文字名に記号を使って分類名等を含めておけば、それらに共通して適用される装飾(CSS)を簡単に用意できるでしょう。
なお、カスタム絵文字の装飾方法について詳しくは、カスタマイズ方法ページ内の「カスタム絵文字の装飾方法」区画や、その中の「複数の絵文字に共通する装飾を指定したい場合の装飾方法」項目をご覧下さい。
🌷アタック目的のアクセスを簡易的に検出して拒否する(400 Bad Requestを返す)機能を追加。
不正アクセスの試みによって負荷が高まってしまうのをできるだけ防ぐ仕様を追加しました。
Web上に設置した何らかのシステム（※てがろぐCGIに限らずWordPressなど何でも）は、不正なパラメータを付加して不正侵入等を試そうとするSQLインジェクションのような攻撃を受けることがあります（※てがろぐはデータベースを使っていないので、そもそもそんな攻撃に意味はありませんが）。高頻度でそのような不正アクセスが集中するとサーバ負荷が高まる原因になるかもしれません。その悪影響を軽減させるため、SQLインジェクション攻撃っぽいパラメータが指定された場合には、内部でデータファイルの読み込み等の処理をするよりも前に、下図のようにほんの短い（140Bytes程度の）エラーメッセージと「400 Bad Request」のコードを返すようにしてみました。
※サーバ側の機能としてWAF（Web Application Firewall）が提供されているなら、WAFを使うことを推奨致します。（サーバのログに 400 Bad Request が多数記録されるようなら特に。）
▼仕様改善：
●既存ハッシュタグ簡単挿入機能で、ハッシュタグの後ではなく前に半角スペースを挿入できる(または一切挿入しない)設定機能を追加。
投稿欄下部の「既存のハッシュタグを簡単に挿入できるセレクトボックス」からハッシュタグを追加する際、（従来は）ハッシュタグの直後に強制的に半角スペースが1つ追加されていました。この仕様を、
Ⓐ ハッシュタグの後に半角スペースを挿入
Ⓑ ハッシュタグの前に半角スペースを挿入
Ⓒ 半角スペースは一切挿入しない
……の中から選べるようにしました。
強制挿入される半角スペースをいちいち消していた場合には、この設定を変更することで、面倒な手間を減らせるでしょう。
設定箇所は、管理画面の［設定］→［投稿欄の表示］→【既存ハッシュタグ簡単入力機能】→「既存ハッシュタグ入力ボタンの動作」項目です。（上図：水色矢印の先）
●「任意URLリンク」ボタンで、リンク先が丸括弧で囲まれる場合には、直後に半角スペースを自動挿入しない仕様に改善。
投稿欄下部の「任意URLリンク」ボタンを使ってリンク先を入力したとき、そのリンク先が、
✅相対パス
✅（スラッシュ記号で始まる）絶対パス
✅メールアドレス・電話番号
……だった場合には、丸括弧で囲む記法が出力されます。そのように「リンク先を丸括弧で囲む」場合は、記法の直後に半角スペースは要りませんから、自動挿入しないように仕様を改善しました。
※リンク先が丸括弧で囲まれない記法が出力される場合には、従来通り、半角スペースが出力されます。丸括弧のありナシについては、使い方・設定方法ページの「リンクの書き方」区画にある「リンクになる書き方のバリエーション」項目で解説しています。
※URLの直後に続く文字が全角文字や絵文字等のように半角英数字ではないなら、半角スペースは消しても正しく動作します。ここで半角スペースを強制挿入しているのは、（直後に半角文字を続けてしまった場合などに対処するための）ほぼ「念のため」というくらいの意味であって、必須というわけではありません。
※リンク先を丸括弧で囲まなくても良い場合は、丸括弧で囲んでも問題なく動作します。（逆に、丸括弧で囲まなければならない場合は、丸括弧を省略すると正しく動作しません。）
●データファイルを読むよりも前にパラメータの不正をチェックすることで、無駄なデータ読み込みを発生させないよう改善。
てがろぐ本体（tegalog.cgi）に与えるパラメータがおかしい場合には、従来から下図のようなエラー画面が表示されます。しかし従来は、この類いの画面を表示する場合でも、内部では全データファイルを（無駄に）読み込んでいました。
今バージョンから、この類いの画面はデータファイルを読み込む処理よりも前に表示するよう改善したため、無駄なディスクアクセスを削減できるようになりました。
※人間のユーザがこの画面を見る機会はあまりないと思うのですけども、何やらよく分からないBotがテキトーなパラメータで大量アクセスしてくるケースに遭遇しましたので、そういう場合に余計な負荷が高まらないようにするための対策です。
●QUICKPOSTで投稿欄が空っぽの状態で投稿したときの動作を改善。
従来はQUICKPOSTから投稿欄が空っぽの状態で投稿した際には「処理内容がありません。データファイルをリフレッシュしました。」と表示されていましたが、そうではなく新規投稿画面に移動するよう動作を改善しました。（※ただ、内部ではデータファイルを再生成・再出力している動作は同じです。）
なお、新規投稿画面で投稿欄が空っぽの状態で投稿ボタンを押した際には、どこにも移動せずに「投稿本文を何か入力して下さい。」とAlertを表示するだけにしました。
●投稿単独表示時の隣接投稿への移動先解釈の改善。
従来は、隣接する投稿が下書きだろうと何だろうと、とにかく「直接隣接する投稿」へのリンクが出ていましたので、リンクをクリックした結果「指定された番号の投稿は存在しない」と表示されてしまうケースがありました。その種の問題を、下記のような動作にすることで解消しました。
例えば、下表のような属性・カテゴリ・内容の No.96～103 の投稿があり、「現在は No.100 が単独で表示されている」という場合を例にして説明します。
✅上記のような場合、No.100 の前後は No.99 と No.101 ですから、従来は下図左側のように「« No.99」と「No.101 »」のリンクが出力されていました。しかし、ここでは No.101 は下書き状態ですから（投稿者本人以外が）アクセスすると「指定された番号の投稿は存在しません」というメッセージだけが見えてしまいます。
その仕様を改善して、（表示対象外である下書き投稿は飛ばして）No.102 を「次の投稿」だと認識する仕様にしました。
✅また、ギャラリーモードでの投稿単独表示時でも、従来は単純に両隣にある投稿として「« No.99」と「No.101 »」のリンクが出力されていました。この場合、下書き状態の No.101 に先と同様の問題があるだけでなく、No.99 も（画像が含まれていないので）ギャラリーモードの表示対象にならないため、「表示対象外なために表示できません」というメッセージが表示されるだけになっていました。(下図左側)
その仕様を改善して、（ギャラリーモードでは）画像が含まれる投稿に限った場合の最も直近にある投稿を「隣の投稿」だと認識する仕様にしました。その結果、ここでは下図右側のように「« No.96」と「No.103 »」のリンクが出力されます。
このように、「隣だと認識する投稿」を、その投稿の中身や属性を勘案して選ぶように改善しました。
●管理画面のボタンの行高を固定することで、一部のモバイル端末でボタンの高さがガタガタになる現象を解消。
一部のモバイル環境では、管理画面HOMEに並んでいる各ボタンの高さが揃っていないようでしたので、CSSに調整を加えました。
●YouTubeの埋め込みに「ライブ動画の共有用URL」も使用可能に。
YouTubeのライブ動画の共有用URL（＝URL内に/live/が含まれるもの）を使った埋め込みにも対応しました。
※従来でも、watch?v=XXXXXX のようなURLを使えば、ライブ動画でも埋め込むことはできました。ただ、YouTube側のUIを使って共有用URLを得ると、ライブ動画では異なる形態のURLが出力されていましたので、それに対応させました。
詳しくは、『YouTube動画を埋め込む書き方』をご覧下さい。
▼#不具合修正 ：
❎URLを丸括弧で囲む [ラベル](URL) 記法の直後に半角丸括弧を書いたとき、記法末尾の「)」記号がURLの一部だと誤解されてしまう不具合を修正。
※URLにリンクラベルを付けるだけの場合は、URLを丸括弧で囲まない書き方もできます。「リンクになる書き方のバリエーション」で解説しています。
以上、ご活用頂ければ幸いです。
※不具合の修正と動作仕様の改善も含んでおりますので、使いたい追加機能がない場合でもアップグレード頂くことをお勧め致します。
※バージョンアップしても、ログインし直す必要はありません。ログイン状態は維持されます。データや設定はそのまま引き継げますし、もし必要になれば後からバージョンダウンすることも可能です。バージョンアップ方法について詳しくは、「CGIの更新方法」をご覧下さい。
なお、開発進捗状況報告サイトでフォロー頂くと、てがろぐCGIの最新β版や正式版の公開時にメールで連絡を受け取ることもできますので、ぜひご活用下さい。(╹◡╹)ﾉ
フォロー数が増えると、私の開発モチベーションが向上するメリットもあります！！！🤩
➡ https://www.nishishi.com/cgi/tegalog/
バージョンアップするには、
- 1クリックでバージョンアップできる専用PHP「TegUp」のご使用がお勧めです。
- もしくは、最新版のZIPの中から tegalog.cgi と fumycts.pl の2ファイルだけを抜き出して上書きアップロードして下さい。
🆕 Ver 4.3.0の更新点(概要)：
《▼大きな機能追加》
●隣接・近傍投稿の一括閲覧機能（隣り合う数投稿をまとめて表示する機能）の追加。
●「その状況で表示対象になっている投稿」だけに限定した隣接投稿に移動できる機能（※同カテゴリに限定した隣接投稿への移動機能）の追加。
●条件指定パラメータを引き継いだ単独投稿にリンクできる記法（＝「その状況で表示対象になっている投稿」だけに限定した隣接投稿に移動できる機能が使える状態の単独投稿へリンクできる記法）の追加。
●ログイン済みでないとどのページも閲覧できなくする「ログイン者限定表示」機能の追加。
●新規投稿/編集画面に自由なHTML(edit.htm)をスキン別に加える機能の追加。
《▼その他の機能追加》
●そのとき限定されているカテゴリの各種情報を挿入できる専用記法の追加。
●ゲストIDで投稿を禁止する設定（＝ログイン者限定表示と併用することで「読者用ID」になる機能）の追加。
●リスト記法で、リストの種類や記号を指定するオプションを使っている場合でも、さらに任意のclass名を指定できる機能を追加。
●SITEMAP XMLを静的ファイルに出力する機能を追加。
●カテゴリの概要文でHTMLを使えるようにできる設定の追加。
《▼細かな機能追加》
●カスタム絵文字のファイル名にハイフン・ドット・アンダーバーが含まれているとき、それらで分割した文字列を使ったclass名をさらに加える機能を追加。
●アタック目的のアクセスを簡易的に検出して拒否する(400 Bad Requestを返す)機能を追加。
《▼仕様改善》
●既存ハッシュタグ簡単挿入機能で、ハッシュタグの後ではなく前に半角スペースを挿入できる(または一切挿入しない)設定機能を追加。
●「任意URLリンク」ボタンで、リンク先が丸括弧で囲まれる場合には、直後に半角スペースを自動挿入しない仕様に改善。
●データファイルを読むよりも前にパラメータの不正をチェックすることで、無駄なデータ読み込みを発生させないよう改善。
●QUICKPOSTで投稿欄が空っぽの状態で投稿したときの動作を改善。
●投稿単独表示時の隣接投稿への移動先解釈の改善。
●管理画面のボタンの行高を固定することで、一部のモバイル端末でボタンの高さがガタガタになる現象を解消。
●YouTubeの埋め込みに「ライブ動画の共有用URL」も使用可能に。
《▼不具合修正》
●URLを丸括弧で囲む [ラベル](URL) 記法の直後に半角丸括弧を書いたとき、記法末尾の「)」記号がURLの一部だと誤解されてしまう不具合を修正。
▼今回の大きな機能追加：
🌸隣接・近傍投稿の一括閲覧機能（隣り合う数投稿をまとめて表示する機能）の追加。
ある特定の投稿の前後に、どんな投稿があるのかを一括して閲覧できる方法を追加しました。
▼解説：
例えば、パラメータ ?postid=123&mode=around3 で、No.123 の前後3件ずつの最大計7投稿を一括閲覧できます。
前後の何件ずつを一括表示するのかは数値(1～9)で指定できるため、
✅「 ?postid=123&mode=around1 」なら前後1件ずつの計3投稿
✅「 ?postid=123&mode=around2 」なら前後2件ずつの計5投稿
： ： ：
✅「 ?postid=123&mode=around9 」なら前後9件ずつの計19投稿
……が閲覧できます。
※数字を省略した場合は、後述する設定値の数(＝標準では 3 )が指定されたとみなされます。
過去の投稿に言及したいとき、>>123 みたいな感じでその投稿番号へリンクしておくことがよくあります。このリンクをたどれば No.123 の投稿を単独で閲覧できるわけですが、「その投稿の前後にはどんな投稿をしていたんだっけ？」という疑問を持つことがあります。
その場合、従来は『前後に1件ずつ移動するリンク』を使って1件ずつ見ていくしかありませんでした。本当に隣接する1件を見れば済むだけならそれで良いのですが、もうちょっと幅広く参照したいと思うこともよくあります。
そんなときに今回実装したこの機能を使えば、「いま単独表示しているこの投稿の前後にどんな投稿があるのか？」を、前後の数件まとめて一括閲覧できます。
▼使用方法：
投稿単独表示時に本文の後に出力されるユーティリティリンク枠に、下図のように『この投稿に隣接する前後3件をまとめて見る』というリンクが追加されていますので、ここからでもアクセスできます。（非表示に設定することもできます。）
▼設定箇所：
標準では前後3件ずつを見るリンクが出力されますが、何件ずつにするのかは設定（下図水色矢印部分）で変更できます。また、このリンクの表示をOFFにするには、下図の緑色矢印部分の項目をOFFにすれば良いです。
➡ 詳しくは、ヘルプドキュメント「使い方・設定方法」ページ内の『隣接投稿の一括閲覧機能（隣り合う投稿をまとめて表示する方法）』項目をご覧下さい。
🌸「その状況で表示対象になっている投稿」だけに限定した隣接投稿に移動できる機能（※同カテゴリに限定した隣接投稿への移動機能）の追加。
以前から『同じカテゴリに限定して隣接投稿へ移動できるようにして欲しい』というご要望を頂いていました。その機能を実装しました。カテゴリに限らず、ハッシュタグ限定表示でも、全文検索の指定でも何でも、表示条件を絞るあらゆる条件で「その条件を満たす投稿に限った隣の投稿」へ移動できるようになりました。
▼解説：
下表のような属性・カテゴリ・内容の No.96～103 の投稿があり、「現在は No.100 が単独で表示されている」という場合を例にして説明します。
表示条件が限定されていない ?postid=100 のパラメータでアクセスされている場合は、表示対象外である下書きだけを飛ばして「« No.99」と「No.102 »」がリンク先になります。（※従来のバージョンでは、下書きを飛ばすこともせず、単純に隣接する「« No.99」と「No.101 »」がリンク先になっていました。）
ここで、表示条件を加えると、下記のように前後のリンク先が変化します。
✅カテゴリinfo限定表示 ?postid=100&cat=info なら、
➡「« No.97」と「No.103 »」がリンク先になります。
✅カテゴリdiary限定表示 ?postid=100&cat=diary なら、
➡「« No.96」と「No.102 »」がリンク先になります。（下書きは飛ばすため。）
✅ハッシュタグ#Test限定表示 ?postid=100&tag=Test なら、
➡「« No.97」と「No.102 »」がリンク先になります。
そのほか、全文検索（qパラメータ）、ユーザ限定（useridパラメータ）、日付限定（dateパラメータ）を使って表示対象を限定することもできます。
どの場合でも、「条件を満たす投稿に限定した隣」が前後の移動リンクとして出力されます。
➡ 詳しくは、ヘルプドキュメント「使い方・設定方法」ページ内の『「その状況で表示対象になっている投稿」だけに限定した隣接投稿に移動できる機能』項目をご覧下さい。
また、このような「条件指定パラメータを維持した状態で投稿単独ページへ移動するためのURL」を出力する専用の記法も用意しています。その点は、次の項目で解説します。
🌸条件指定パラメータを引き継いだ単独投稿にリンクできる記法（＝「その状況で表示対象になっている投稿」だけに限定した隣接投稿に移動できる機能が使える状態の単独投稿へリンクできる記法）の追加。
投稿単独ページへ移動できるURLを出力するための記法 [[PERMAURL]] のオプションを追加しました。これによって、投稿単独表示時に「同一カテゴリだけに限定した隣接投稿」などへ前後移動できるようになります。
▼解説：
「条件指定パラメータを引き継いだ単独投稿」に移動できるURLを出力する専用記法を追加しましたので、
- 投稿単独表示時に「本当に隣接している投稿」に移動するスキン
- 投稿単独表示時に「その状況で表示対象になっている投稿に限定した隣接投稿」に移動するスキン
追加した記法の意味は以下の通りです。
- [[PERMAURL:KEEPCOND]] と記述すると、その位置に『そのとき表示対象になっている条件』を引き継いだ状態で、投稿単体を表示するための固有URLが相対パスで挿入されます。
- [[PERMAURL:KEEPCOND:FULL]] と記述すると、それが絶対URLで挿入されます。
また、「どの条件を維持するのか？」を識別子で選択的に指定できる拡張記法 [[PERMAURL:KEEPCOND(識別子)]] もあります。
識別子には、下記の7種類が使えます。
① M :モード を維持する
② U :ユーザ限定 を維持する
③ C :カテゴリ限定 を維持する
④ H :ハッシュタグ限定 を維持する
⑤ S :検索語 を維持する
⑥ D :日付指定 を維持する
⑦ O :表示順序 を維持する
これによって、例えば、
➊『カテゴリ限定表示時から投稿単独ページに移動した場合には、同カテゴリに属する投稿に限定した隣接投稿に前後移動できるようにしたい。しかし、カテゴリ以外の条件でさらに絞り込まれていたとしてもそれらの条件は無視して、カテゴリだけに限定した隣接投稿に移動させたい』
➋『ギャラリーモードで、ハッシュタグやカテゴリや検索語で絞り込まれている場合には、その条件に該当する投稿だけに限定した隣接投稿に前後移動できるようにしたい。しかし、モードは解除して、投稿者IDや日付で絞り込まれている場合は無視したい』
……といったスキンが作れます。
具体的には、
➊は、 [[PERMAURL:KEEPCOND(C)]] と書けば良く、
➋は、 [[PERMAURL:KEEPCOND(CHS)]] と書けば良い
です。
なお、識別子を指定せずに [[PERMAURL:KEEPCOND]] と書いた場合は、[[PERMAURL:KEEPCOND(MUCHSD)]] と書いた場合と同じになります。（つまり、「O＝表示順序」以外のすべての条件が維持されます。）
➡ 記法について詳しくは、リファレンス内の【投稿単独URL出力要素】区画をご覧下さい。[[PERMAURL]]系統のすべての記法を一覧できます。
➡ また、『「その状況で表示対象になっている投稿」だけに限定した隣接投稿に移動できる機能』について詳しくは、ヘルプドキュメント「使い方・設定方法」ページ内にある 『1投稿の単独閲覧時（投稿単独ページ表示時）での前後移動』項目をご覧下さい。
（※そこに含まれる『Ⓑ 表示条件が限定されている場合に採用される移動先』項目もご参照頂くと、より分かりやすいかもしれません。）
🌸ログイン済みでないとどのページも閲覧できなくする「ログイン者限定表示」機能の追加。
自分専用または内輪専用として使いたい場合等のために、てがろぐにログイン済みの状態でなければどのページも閲覧できない動作モードを追加しました。
▼解説：
非ログイン状態でアクセスすると、ログインを促すメッセージ（下図）が表示されるだけになります。管理画面では、常に右上に橙色で「ログイン者限定表示中」のサインが見えます。
▼設定：
設定は、管理画面の[設定]→[システム設定]→【高度な設定】→[動作形態]項目（下図の黄色矢印の先）からできます。ただし、後述の事前準備が必須です。
ここで、「ゲストIDによる投稿を禁止する」にチェックを入れておくと、「ゲスト権限のID（＝Lv.1のID）」を読者専用IDとして機能させることもできます。（※その機能については後述の『🌺ゲストIDで投稿を禁止する設定』項目で改めて解説します。）
▼事前準備（必須）：
ブラウザのアドレス欄にデータファイル（tegalog.xml）のURLを打ってみたときに、そのままファイルが閲覧・ダウンロード可能になっている状態では、この機能の意味がありません。したがって、この機能はデータファイルへの直接アクセスをブロックする .htaccess ファイルによるアクセス制限を併用する必要があります。
そのため、.htaccessファイルが存在しない状態で設定しようとしても、下図のように設定が拒否される仕様になっています。
したがって、この機能を有効にする前に、まずは .htaccess ファイルを設置してからご使用下さい。
なお、この機能を使っても画像は保護されません（＝何らかの方法で画像のURLが分かれば、誰でもその画像を閲覧できます）。何もかもを保護するには、サーバ側の認証機能（Basic認証等）をお使い頂く必要があります。この機能は、あくまでも「簡易版の非公開モード」のような位置づけである点にご注意下さい。
➡ 詳しくは、ヘルプドキュメントの「ログイン済みでないとどのページも閲覧できなくする「ログイン者限定表示」機能」項目をご覧下さい。
特に、……の両項目もご参照下さい。
🌸新規投稿/編集画面に自由なHTML(edit.htm)をスキン別に加える機能の追加。
編集画面に自前の edit.css と edit.js を読み込む機能は従来からありましたが、スキン別に異なるファイルを読み込みたい場合のために、「そのとき適用されているスキンのディレクトリ」の中にある edit.htm を挿入する機能も用意しました。
▼解説：
この機能を使うと、
- 適用中のスキンに応じたカスタマイズを新規投稿/編集画面にも施せる。
- （CSSやJavaScriptだけでなく）任意のHTMLを挿入してカスタマイズできる。
- 新規投稿/編集画面内に、任意のメッセージや画像等を挿入できる。
※edit.css と edit.js の挿入仕様は従来のまま（＝適用スキンに関係なく、CGI本体のあるディレクトリに存在するファイルを読み込み）です。
※ファイル名がバッティングすると紛らわしいので、edit.htm というHTMLを挿入する形にしました。（CSSやJavaScriptをスキン別に読ませたい場合は、edit.htmの中に直接記述すれば良いでしょう。）
機能の違いをまとめると、下記のようになります。
- edit.css , edit.js は、スキンに関係なく読み込まれる（※tegalog.cgiファイルと同じディレクトリに格納する）。
- edit.htm は、スキン別に読み込まれる（※スキンディレクトリの中に格納する）。
▼事前設定：
デフォルトでは無効なので、使いたい場合には下記の場所で有効に設定して頂く必要があります。
▼出力位置：
挿入される位置は、下図の赤色帯の部分です。投稿フォームよりも後に出力されますから、JavaScriptで投稿フォームそのものをカスタマイズする際にも制御がしやすいでしょう。
そのほか、単純に文章を掲載する用途にも使えますから、投稿本文を行ごとに分割して活用するスキンの場合には、「何行目が何の役割なのか」をここに書いておくことで、編集を分かりやすくできるかもしれません。
➡ 詳しくは、ヘルプドキュメントの「新規投稿/編集画面に自由なHTMLをスキン別に加える方法」項目をご覧下さい。
▼今回のその他の機能追加：
🌺そのとき限定されているカテゴリの各種情報を挿入できる専用記法の追加。
カテゴリ限定表示時（＝特定のカテゴリに属する投稿に限定して表示されている状況）で、そのカテゴリに関する各種情報（カテゴリ名や、カテゴリ概要文など）を挿入できる専用記法4つを用意しました。
カテゴリの名称だけは、従来から『 カテゴリ××に属する投稿 [xx件] 』のような形で、SITUATION部分に表示されましたが、この記法を使えば、概要文やアイコンも自由に配置して掲載できます。また、カテゴリIDは、HTMLソース内でclass名等に活用できるでしょう。
具体的には、下記の記法を追加しました。
✅[[INFO:NOWCAT:NAME]]
➡そのとき限定されているカテゴリの名称が挿入されます。
✅[[INFO:NOWCAT:DESCRIPTION]]
➡そのとき限定されているカテゴリの概要文が挿入されます。
✅[[INFO:NOWCAT:ICON]]
➡そのとき限定されているカテゴリのアイコンが挿入されます。
✅[[INFO:NOWCAT:ID]]
➡そのとき限定されているカテゴリのIDが挿入されます。
※カテゴリ限定表示時ではない状況では、何も出力されません。
※事前に許可設定をしていれば、カテゴリ概要文の中に任意のHTMLソースを含めることもできます。
➡ 詳しくは、ヘルプドキュメントのリファレンスの【現在カテゴリ情報要素】項目をご覧下さい。
🌺ゲストIDで投稿を禁止する設定（＝ログイン者限定表示と併用することで「読者用ID」になる機能）の追加。
ゲスト権限(Lv.1)のIDでの投稿を禁止することで、ゲストIDを「読み専」にできる設定を追加しました。ログイン者限定表示機能を使っている場合でも、ログインパスワードを知っている人々からの閲覧は許容したい場合等にご活用頂けます。
この設定をすると、すべてのゲストIDの動作が変わります（※既にあるIDも、これから作るIDも）。
この機能を有効にしている状態だと、ゲストIDでログインした場合には、通常の管理画面ではなく、下図のような「読み専ID専用の管理画面」だけが見えます。（てがろぐHOMEへの移動か、ログアウトのどちらかしかできない画面です。）
なお、この機能が有効な場合は、(ゲスト権限のIDでは)ログイン中でも QUICKPOST（＝ページ上に埋め込んで表示される投稿欄）は表示されません。その際は、非ログイン時と同じ出力になります。
詳しくは、『読み専ID（読むだけのユーザID）を作成する方法』項目や、『ログイン者限定表示の仕様』項目をご覧下さい。
🌺リスト記法で、リストの種類や記号を指定するオプションを使っている場合でも、さらに任意のclass名を指定できる機能を追加。
文字装飾記法には以前からリストを作る記法を用意していました。この記法にはオプションで、先頭記号や開始番号などを指定できました(➊)。また、任意のclass名を指定することもできました(➋)。しかし、その両者(➊と➋)を併用することはできませんでした。今回のバージョンでは、その併用を可能にしました。
例えば：
✅ [L:🌰:hogehoge: ～ ] と書くと、class名として listdeco-hogehoge が指定された、先頭記号が「🌰」の箇条書きリストになります。
✅ [L:5:hogehoge: ～ ] と書くと、class名として listdeco-hogehoge が指定された、5から始まる番号付きリストになります。
✅ [L:DL:hogehoge: ～ ] と書くと、class名として listdeco-hogehoge が指定された説明リスト(＝dl＋dt＋dd要素から構成されるリスト)になります。
あらかじめ用意してあるスタイルを適用させつつ、先頭記号や番号等を指定したい場合にご活用頂けます。
詳しくは、ヘルプドキュメント「使い方・設定方法」ページ内にある『リストのオプション記述方法』項目内の、「任意のclassを指定」の後半をご覧下さい。
🌺SITEMAP XMLを静的ファイルに出力する機能を追加。
新規投稿や既存投稿の再編集タイミングで、SITEMAP XMLを sitemap.txt というファイルに出力する機能を加えました。（試験実装）
SITEMAP XMLを毎回動的生成するのはサーバ資源の無駄な気もしますので。投稿データの編集時に sitemap.txt として静的ファイルに出力しておけば、サイトマップXMLの参照時にはCGIを稼働させずに済むため、サーバの負荷軽減に役立つ気がします。
➡ 詳しくは、ヘルプドキュメントの「SITEMAP XML（静的出力）」項目をご覧下さい。
※この機能は試験実装です。仕様は将来のバージョンで変更される可能性があります。現在のところ、出力されるファイル名は sitemap.txt ですが、ファイルの中身はXMLです。（ファイル拡張子 .xml のファイルを一括アクセス制限している場合のために、そのような仕様にしています。それでSITEMAP XMLとしてどこでも認識されるのかどうかはハッキリしないので、ダメそうなら将来的にはファイルの中身もプレーンテキストに変更する可能性があります。）
🌺カテゴリの概要文でHTMLを使えるようにできる設定の追加。
カテゴリの概要文中に書いたHTMLソースを、HTMLとして出力もできるようにしました。
これによって、 [[INFO:NOWCAT:DESCRIPTION]] 等の記法を使ってカテゴリ概要文を表示する際に、任意のHTMLを出力することもできるようになります。
ただし、この機能はデフォルトではOFFなので、HTMLを書きたい場合は事前に下記の設定をする必要があります。
詳しくは、ヘルプドキュメント「使い方・設定方法」ページ内の『カテゴリ設定』区画にある『カテゴリ概要文にHTMLを書きたい場合の設定』項目をご覧下さい。
なお、カテゴリの概要文を掲載するスキンの書き方については、
🟣リファレンスの【現在カテゴリ情報要素】項目や、
🟠カスタマイズ方法ページの『カテゴリツリー内の掲載内容を指定できる CATEGORY:TREE:識別子 の書き方』項目をご覧下さい。
▼その他の細かな機能追加：
🌷カスタム絵文字のファイル名にハイフン・ドット・アンダーバーが含まれているとき、それらで分割した文字列を使ったclass名をさらに加える機能を追加。
カスタム絵文字を出力する際には、絵文字ごとに特別な装飾をCSSで施しやすいように、絵文字名（ファイル名）をベースにしたclass名が出力される仕様です。この仕様をさらに拡張して、「複数のカスタム絵文字に共通する装飾」を簡単に用意できるようにしました。
具体的には、下図の①②③のclass名が新たに追加出力されるようになります。
――― ▼従来からある仕様：―――
例えば、カスタム絵文字を挿入する [:takoyaki-large:] と [:takoyaki_ikayaki-set:] という記法を書いたとき、従来は次のような2つのclass名を含むHTMLソースが出力されていました。
<span class="cemoji ce-takoyaki-large"><img 絵文字画像></span>
<span class="cemoji ce-takoyaki_ikayaki-set"><img 絵文字画像></span>
この場合は
✅「cemoji」が、どんなカスタム絵文字にも共通する装飾に使えるclass名で、
✅「ce-takoyaki-large」や「ce-takoyaki_ikayaki-set」のように「ce-絵文字名」が、その絵文字専用の装飾に使えるclass名です。
――― ▼今バージョンでの追加仕様： ―――
今バージョンでは、カスタム絵文字の名称(ファイル名)にハイフン・ドット・アンダーバーが含まれているときには、それらで分割した文字列もさらにclass名として加わる仕様を追加しました。
例えば、カスタム絵文字を挿入する [:takoyaki-large:] と [:takoyaki_ikayaki-set:] という記法を書いたとき、次のようなclass名が出力されます。
✅cemoji、ce-takoyaki-large、ce-takoyaki、ce-large
✅cemoji、ce-takoyaki_ikayaki-set、ce-takoyaki、ce-ikayaki、ce-set
つまり、class名「ce-takoyaki」を使うと、これら2つのカスタム絵文字を一括して装飾できます。絵文字名に記号を使って分類名等を含めておけば、それらに共通して適用される装飾(CSS)を簡単に用意できるでしょう。
- 独立したclass名に分割されるのは、半角ハイフン記号「-」、半角アンダーバー記号「_」、半角ドット記号「.」の3つだけです。それ以外の文字では分割されません。
- どのclass名にも「ce-」の接頭辞が付きます。これは Custom Emoji の略です。
- カスタム絵文字を指定する際に、[:umai-takoyaki.png:] のようにファイル拡張子も含めて記述した場合は、拡張子も独立したclass名になります。この場合は、cemoji、ce-umai-takoyakipng、ce-umai、ce-takoyaki、ce-png が出力されます。
なお、カスタム絵文字の装飾方法について詳しくは、カスタマイズ方法ページ内の「カスタム絵文字の装飾方法」区画や、その中の「複数の絵文字に共通する装飾を指定したい場合の装飾方法」項目をご覧下さい。
🌷アタック目的のアクセスを簡易的に検出して拒否する(400 Bad Requestを返す)機能を追加。
不正アクセスの試みによって負荷が高まってしまうのをできるだけ防ぐ仕様を追加しました。
Web上に設置した何らかのシステム（※てがろぐCGIに限らずWordPressなど何でも）は、不正なパラメータを付加して不正侵入等を試そうとするSQLインジェクションのような攻撃を受けることがあります（※てがろぐはデータベースを使っていないので、そもそもそんな攻撃に意味はありませんが）。高頻度でそのような不正アクセスが集中するとサーバ負荷が高まる原因になるかもしれません。その悪影響を軽減させるため、SQLインジェクション攻撃っぽいパラメータが指定された場合には、内部でデータファイルの読み込み等の処理をするよりも前に、下図のようにほんの短い（140Bytes程度の）エラーメッセージと「400 Bad Request」のコードを返すようにしてみました。
※サーバ側の機能としてWAF（Web Application Firewall）が提供されているなら、WAFを使うことを推奨致します。（サーバのログに 400 Bad Request が多数記録されるようなら特に。）
▼仕様改善：
●既存ハッシュタグ簡単挿入機能で、ハッシュタグの後ではなく前に半角スペースを挿入できる(または一切挿入しない)設定機能を追加。
投稿欄下部の「既存のハッシュタグを簡単に挿入できるセレクトボックス」からハッシュタグを追加する際、（従来は）ハッシュタグの直後に強制的に半角スペースが1つ追加されていました。この仕様を、
Ⓐ ハッシュタグの後に半角スペースを挿入
Ⓑ ハッシュタグの前に半角スペースを挿入
Ⓒ 半角スペースは一切挿入しない
……の中から選べるようにしました。
強制挿入される半角スペースをいちいち消していた場合には、この設定を変更することで、面倒な手間を減らせるでしょう。
設定箇所は、管理画面の［設定］→［投稿欄の表示］→【既存ハッシュタグ簡単入力機能】→「既存ハッシュタグ入力ボタンの動作」項目です。（上図：水色矢印の先）
●「任意URLリンク」ボタンで、リンク先が丸括弧で囲まれる場合には、直後に半角スペースを自動挿入しない仕様に改善。
投稿欄下部の「任意URLリンク」ボタンを使ってリンク先を入力したとき、そのリンク先が、
✅相対パス
✅（スラッシュ記号で始まる）絶対パス
✅メールアドレス・電話番号
……だった場合には、丸括弧で囲む記法が出力されます。そのように「リンク先を丸括弧で囲む」場合は、記法の直後に半角スペースは要りませんから、自動挿入しないように仕様を改善しました。
※リンク先が丸括弧で囲まれない記法が出力される場合には、従来通り、半角スペースが出力されます。丸括弧のありナシについては、使い方・設定方法ページの「リンクの書き方」区画にある「リンクになる書き方のバリエーション」項目で解説しています。
※URLの直後に続く文字が全角文字や絵文字等のように半角英数字ではないなら、半角スペースは消しても正しく動作します。ここで半角スペースを強制挿入しているのは、（直後に半角文字を続けてしまった場合などに対処するための）ほぼ「念のため」というくらいの意味であって、必須というわけではありません。
※リンク先を丸括弧で囲まなくても良い場合は、丸括弧で囲んでも問題なく動作します。（逆に、丸括弧で囲まなければならない場合は、丸括弧を省略すると正しく動作しません。）
●データファイルを読むよりも前にパラメータの不正をチェックすることで、無駄なデータ読み込みを発生させないよう改善。
てがろぐ本体（tegalog.cgi）に与えるパラメータがおかしい場合には、従来から下図のようなエラー画面が表示されます。しかし従来は、この類いの画面を表示する場合でも、内部では全データファイルを（無駄に）読み込んでいました。
今バージョンから、この類いの画面はデータファイルを読み込む処理よりも前に表示するよう改善したため、無駄なディスクアクセスを削減できるようになりました。
※人間のユーザがこの画面を見る機会はあまりないと思うのですけども、何やらよく分からないBotがテキトーなパラメータで大量アクセスしてくるケースに遭遇しましたので、そういう場合に余計な負荷が高まらないようにするための対策です。
●QUICKPOSTで投稿欄が空っぽの状態で投稿したときの動作を改善。
従来はQUICKPOSTから投稿欄が空っぽの状態で投稿した際には「処理内容がありません。データファイルをリフレッシュしました。」と表示されていましたが、そうではなく新規投稿画面に移動するよう動作を改善しました。（※ただ、内部ではデータファイルを再生成・再出力している動作は同じです。）
なお、新規投稿画面で投稿欄が空っぽの状態で投稿ボタンを押した際には、どこにも移動せずに「投稿本文を何か入力して下さい。」とAlertを表示するだけにしました。
●投稿単独表示時の隣接投稿への移動先解釈の改善。
従来は、隣接する投稿が下書きだろうと何だろうと、とにかく「直接隣接する投稿」へのリンクが出ていましたので、リンクをクリックした結果「指定された番号の投稿は存在しない」と表示されてしまうケースがありました。その種の問題を、下記のような動作にすることで解消しました。
例えば、下表のような属性・カテゴリ・内容の No.96～103 の投稿があり、「現在は No.100 が単独で表示されている」という場合を例にして説明します。
✅上記のような場合、No.100 の前後は No.99 と No.101 ですから、従来は下図左側のように「« No.99」と「No.101 »」のリンクが出力されていました。しかし、ここでは No.101 は下書き状態ですから（投稿者本人以外が）アクセスすると「指定された番号の投稿は存在しません」というメッセージだけが見えてしまいます。
その仕様を改善して、（表示対象外である下書き投稿は飛ばして）No.102 を「次の投稿」だと認識する仕様にしました。
✅また、ギャラリーモードでの投稿単独表示時でも、従来は単純に両隣にある投稿として「« No.99」と「No.101 »」のリンクが出力されていました。この場合、下書き状態の No.101 に先と同様の問題があるだけでなく、No.99 も（画像が含まれていないので）ギャラリーモードの表示対象にならないため、「表示対象外なために表示できません」というメッセージが表示されるだけになっていました。(下図左側)
その仕様を改善して、（ギャラリーモードでは）画像が含まれる投稿に限った場合の最も直近にある投稿を「隣の投稿」だと認識する仕様にしました。その結果、ここでは下図右側のように「« No.96」と「No.103 »」のリンクが出力されます。
このように、「隣だと認識する投稿」を、その投稿の中身や属性を勘案して選ぶように改善しました。
●管理画面のボタンの行高を固定することで、一部のモバイル端末でボタンの高さがガタガタになる現象を解消。
一部のモバイル環境では、管理画面HOMEに並んでいる各ボタンの高さが揃っていないようでしたので、CSSに調整を加えました。
●YouTubeの埋め込みに「ライブ動画の共有用URL」も使用可能に。
YouTubeのライブ動画の共有用URL（＝URL内に/live/が含まれるもの）を使った埋め込みにも対応しました。
※従来でも、watch?v=XXXXXX のようなURLを使えば、ライブ動画でも埋め込むことはできました。ただ、YouTube側のUIを使って共有用URLを得ると、ライブ動画では異なる形態のURLが出力されていましたので、それに対応させました。
詳しくは、『YouTube動画を埋め込む書き方』をご覧下さい。
▼#不具合修正 ：
❎URLを丸括弧で囲む [ラベル](URL) 記法の直後に半角丸括弧を書いたとき、記法末尾の「)」記号がURLの一部だと誤解されてしまう不具合を修正。
※URLにリンクラベルを付けるだけの場合は、URLを丸括弧で囲まない書き方もできます。「リンクになる書き方のバリエーション」で解説しています。
以上、ご活用頂ければ幸いです。
※不具合の修正と動作仕様の改善も含んでおりますので、使いたい追加機能がない場合でもアップグレード頂くことをお勧め致します。
※バージョンアップしても、ログインし直す必要はありません。ログイン状態は維持されます。データや設定はそのまま引き継げますし、もし必要になれば後からバージョンダウンすることも可能です。バージョンアップ方法について詳しくは、「CGIの更新方法」をご覧下さい。
なお、開発進捗状況報告サイトでフォロー頂くと、てがろぐCGIの最新β版や正式版の公開時にメールで連絡を受け取ることもできますので、ぜひご活用下さい。(╹◡╹)ﾉ
フォロー数が増えると、私の開発モチベーションが向上するメリットもあります！！！🤩
：15047文字 修正
てがろぐ Ver 3.9.0 を公開しました！ #Update
てがろぐ Ver 3.9.0 を公開しました。画像をキャプション付きで表示できる機能、新着画像リスト表示機能、サムネイルがあればそちらを先に表示する機能、投稿経過時間の表示機能、インスタグラム埋め込み機能、「続きを読む」ボタンラベルをその都度指定できる新記法、リスト表示用の記法などの追加が主な更新点です。その他、細かな機能追加や不具合修正を含んでいます。
➡ https://www.nishishi.com/cgi/tegalog/
アップデートするには、tegalog.cgi と fumycts.pl の2ファイルだけ(※)を上書きアップロードして下さい。
データファイルや設定ファイルは、すべてそのまま引き継げます。(Ver.2以下も含む過去のどのバージョンからでも)
※今回も標準添付スキンのソースを全体的に更新しています。標準添付スキンをそのままお使いの場合は、それらも上書きアップロードして下さい。
🆕 Ver 3.9.0の更新点(概要)：
《▼新機能：画像投稿関連》
●新着画像リスト（最近UPされた画像の一覧）出力機能。
●UPされた画像1つ1つにキャプションやフラグ等を事前登録しておける画像インデックス機能。
●画像をキャプション付きで表示できる新記法を追加。
●画像のキャプションをその都度指定できる新記法を追加。
●その画像に対応したサムネイル画像が存在する場合には『ページ上の表示にはサムネイル画像を使い、Lightboxでのリンク先にはオリジナル画像を使う』ように表示できる機能を追加。
●投稿本文内に含まれる画像をすべて抽出して表示できる記法を追加。
《▼新機能：ページ上の表示関連》
●インスタグラムの埋め込み機能。
●投稿日付の表示に（n分前、n時間前、n日前……のような）経過時間を表示できる日付表記オプション。
●ページ番号の省略を始める総ページ数を自由に設定できる機能。
●ページ番号リンクの両端（先頭と末尾）に何ページずつ固定表示するかを変更できる機能。
●サイドコンテンツ各種でもギャラリーモードやサイトマップページを維持したリンクを出力できる新記法。
《▼新機能：表示を拡張する新記法》
●「続きを読む」ボタンのラベルをその都度指定できる新記法を追加。
●リストを表示するための専用記法。（箇条書きリストや番号付きリストが表示可能に）
●投稿本文の行数が得られる記法を追加。(内側スキンのみ)
●RSS Auto-Discoveryを挿入する記法を追加。(外側スキンのみ)
《▼新機能：スキンのカスタマイズ関連》
●上位ディレクトリや別階層に存在するスキンでもプレビューしたり簡易適用したりできる機能。
●投稿本文内の、任意の範囲をコメントアウトできる記法。
●各種ディレクトリのパス(PATH)を得られる新記法を追加。
●スキン内に記述されている link要素やform要素に対して、「現在のスキンでの表示を維持する」目的で自動挿入される各種記述をスキップできる記法を追加。
●[[INCLUDE:～]] 記法と [[PATH:～]] 記法を、内側スキンでも使用可能に。(従来は外側スキン専用でした)
●任意のファイルを挿入できる INCLUDE 記法の仕様拡充。
《▼新機能：設定項目》
●記述サンプルを自動入力するかどうかの設定項目と、文字色や背景色として自動入力するサンプル文字列の設定項目を追加。
●ログインフォームの下部に表示できるメッセージを設定画面で設定できる機能。
●ハッシュタグだとは認識されない「 # 」記号を簡単に表示させる方法として、「#」を入力できる項目をハッシュタグ簡単入力プルダウンメニューに追加できる機能を追加。
●投稿本文中にAmazonのURLが書かれたとき、自動で極力短く加工する機能を追加（標準ではOFF）。
《▼仕様改善》
●拡大画像をLightboxで表示できるテキストリンクを作る記法に、「画像リンクに独自のclass属性値を追加する」と同じclass属性値も追加されるよう仕様改善。
●全文検索の強調表示では、半角英字の大文字小文字が一致しなくても強調対象になるよう仕様改善。
●上位ディレクトリを参照するパスで画像が指定されたときに、ファイルが見つからなければ注釈を含むエラーを表示するよう仕様改善。
●デフォルトで読み込むjQueryやLightboxを最新版にバージョンアップ。
《▼スキン更新》
●標準添付の各スキンを更新
《▼不具合修正》
●「スラッシュで始まる絶対パス」で画像が指定されたとき、画像のURLが正しくなくなって画像が表示されない不具合を解消。
●「続きを読む」記法が使われている状態で、設定画面から「続きを読む」機能をOFFにすると、Internal Server Errorになる不具合を修正。
●「skin=」パラメータでスキンが指定されているとき、投稿本文内のハッシュタグをすべて抜き出す記法 [[COMMENT:TAGS]] が動作しない不具合を解消。
●ハッシュタグに半角アンダーバー「_」を使うと、既存ハッシュタグ簡単入力用プルダウンメニューでは角括弧付きでリストアップされる不具合を修正。
●内側スキンで [[CATEGORYLINKS:FULL]] と書いても、カテゴリページへのURLがフルパスでは出力されない不具合を解消。
●投稿単独ページのURLを挿入する [[PARMAURL]] キーワードのスペルを [[PERMAURL]] でも認識するよう改善。
●「Unrecognized escape \\v passed through at tegalog.cgi」というアラートがサーバのエラーログに記録される問題を解消。
●サーバのエラーログに「CGI::param called in list context」のようなアラートが出力されるのを防ぐよう改善。
●設定画面のHTMLにいくつか存在していた文法ミスを修正。
●リンクラベルの中に # での # 記号が入っていても正しくラベルとして使えるよう仕様を修正。
●「続きを読む」機能を入れ子にして使うと、ボタンラベルが正しく出力されないケースがある不具合を修正。
▼新機能：画像投稿関連
🌸新着画像リスト（最近UPされた画像の一覧）出力機能。
最近にアップロードされた画像だけの一覧を表示する「新着画像リスト」表示機能を追加しました。
画像保存用ディレクトリに存在する画像のうち、「一覧外」フラグが立てられていないすべての画像を対象に、新着順に指定個数だけ表示します。Twitterのプロフィールページ右上に見えるメディア欄のような感じの表示を作りたい場合に活用できます。
詳しくは、新着画像リストの設定方法などをご覧下さい。
.png)
新着画像リストの出力方法は、リファレンス内の【新着画像リスト要素】をご覧下さい。
新着画像リストの装飾に関する参考情報は、新着画像リストの装飾方法をご覧下さい。
標準添付スキンのうち（チャットタイプスキンを除く）8種類のスキンにも新着画像リスト用のHTML＋CSSを加えてあります。標準添付スキンをそのままお使いの場合は、上書きアップロードすれば新着画像リストも表示されるようになります。もし、大きくカスタマイズしてお使いの場合や、独自のスキンを作ってお使いの場合には、標準スキンの下記の位置にあるソースをコピー＆ペーストするなどしてご活用頂くと、標準スキンと同じ見た目を手っ取り早く実現できるでしょう。
✅まず、外側スキン（skin-cover.html）には、以下のようなHTMLを加えています。
うまく装飾するためには、[[IMAGELIST]] の外側に何らかのブロック要素を加えておく方が良いと思います。 下記では <p class="imagelistbox">～</p> で囲んでいます。
✅次に、CSS（tegalog.css）では、以下のようなソースで装飾しています。 CSSソース内で ▼画像一覧リスト区画 という文字列を検索すると見つかります。この区画の中身をコピーするなどしてご活用下さい。
特に、画像サイズを調整している箇所は、1080～1089行目にある /* ▼各画像の装飾 */ と書かれた区画です。（上図のほぼ中央付近）畳む
🌸UPされた画像1つ1つにキャプションやフラグ等を事前登録しておける画像インデックス機能。
てがろぐ上にアップロードした画像1つ1つに、あらかじめキャプションを登録しておいたり、表示上の調整を加えられるフラグを設定しておいたり、縦横サイズを手動設定しておいたりできる画像管理機能を加えました。
詳しくは、画像管理画面で画像1つ1つにキャプションやフラグを登録する方法をご覧下さい。
フラグには「NSFW（not safe for work）」もあり、標準添付の各スキンでは、このNSFWフラグが設定された画像は、デフォルト状態ではぼかされて表示されます。
※従来の画像表示形態はそのまま何も変わりません。
今バージョンからは画像にキャプションを登録できるようになりましたが、それは「キャプションを表示したければできる」というだけであって、既存の画像表示は何も変わりません。なので、CGIをバージョンアップしても、今お使いのスキンはそのまま問題なく継続してご使用頂けます。
🌸画像をキャプション付きで表示できる新記法を追加。
あらかじめ登録しておいたキャプション付きで画像を表示できる新しい記法として [PICT:FIG:ファイルパス] を追加しました。
詳しくは、画像を表示する書き方のまとめをご覧下さい。
なお、この記法によって画像が表示される際に、どのようなHTMLとして出力されるのかは、カスタマイズ方法ページの「画像の表示方法に応じた実際の出力HTMLと装飾例」等で紹介していますのでご参照下さい。
🌸画像のキャプションをその都度指定できる新記法を追加。
画像に任意のキャプションをその都度指定できる記法として [PICT:FIG(キャプション):ファイルパス] を追加しました。
画像にキャプションを事前登録しておけるのは、画像保存用ディレクトリ内に存在する画像だけです。そのため、先の [PICT:FIG:～] 記法を使って、画像保存用ディレクトリ以外の場所にあるファイルを指定しても、キャプションは表示できません（※「キャプション自動取得対象外」というエラーがキャプションとして表示されます）。しかし、 [PICT:FIG(臨時キャプション):～] 記法を使うことで、画像保存用ディレクトリ以外に存在する画像にもその都度キャプションを指定できます。
🌸その画像に対応したサムネイル画像が存在する場合には『ページ上の表示にはサムネイル画像を使い、Lightboxでのリンク先にはオリジナル画像を使う』ように表示できる機能を追加。
サムネイル画像があればサムネイル画像の方を表示する機能(簡易版)を用意しました。
ファイルサイズの大きな画像を掲載したい場合などでは、最初はサイズの小さなサムネイル画像を見せておいて、拡大操作がされた際にだけオリジナルの画像を見せたい場合もあるでしょう。そのような動作を実現できます。詳しくは、サムネイル画像があればサムネイル画像の方を表示する機能(簡易版)をご覧下さい。
🌺投稿本文内に含まれる画像をすべて抽出して表示できる記法を追加。
投稿本文内に含まれる画像だけを抽出して表示できる記法 [[COMMENT:PICTS]] を追加しました。投稿本文内に含まれるハッシュタグだけを抽出する [[COMMENT:TAGS]] と同様の感じで動作します。
詳しくは、リファレンスの【投稿本文関連要素（オプション）】内にある「抽出結果を挿入（画像）」項目をご覧下さい。
▼新機能：ページ上の表示関連
🌸インスタグラムの埋め込み機能。
投稿本文中に、Instagramの1投稿を埋め込むこともできるようになりました。
詳しくは、Instagram(インスタグラム)の投稿を埋め込む書き方をご覧下さい。
🌸投稿日付の表示に（n分前、n時間前、n日前……のような）経過時間を表示できる日付表記オプション。
投稿日時を表示できる [[DATE:～]] 記法に、投稿されたのが現在からどれくらい前なのかを「40秒前」や「3分前」や「12時間前」や「50日前」などのように相対時間で表示できる日時表記オプションを追加しました。
投稿日時を表示できる [[DATE:～]] 記法の中に……
🌰「A」と記述すれば、5秒前、6分前、7時間前、8日前、9年前 のように表示（未来の日付だと、1日後、2時間後、3分後のように表示）されます。
🌰「a」と記述すれば、5秒、6分、7時間、8日、9年 のように表示（未来の日付だと、-1日、-2時間、-3分のように表示）されます。
詳しくは、リファレンスの【投稿日時関連要素】をご覧下さい。その項目末尾の補足欄に、より詳しい解説を記しています。
🌸ページ番号の省略を始める総ページ数を自由に設定できる機能。
🌸ページ番号リンクの両端（先頭と末尾）に何ページずつ固定表示するかを変更できる機能。
ページ番号の省略を始める総ページ数と、ページ番号リンクの両端（先頭と末尾）に何ページずつ固定表示するかを、設定画面で変更できるようになりました。
ページネーションの占有幅を省略時のデフォルトサイズ（下図の左端）よりももっとコンパクトにしたい場合などにご活用頂けます。
詳しくは、ページ番号の省略を始める総ページ数や、ページ番号リンクの両端に何ページずつ固定表示するかを変更するをご覧下さい。
🌸サイドコンテンツ各種でもギャラリーモードやサイトマップページを維持したリンクを出力できる新記法。
サイドコンテンツ各種(例えばハッシュタグ一覧やカレンダー等)でも、ギャラリーモードやサイトマップページを維持したリンクを出力できる新記法を追加しました。
ハッシュタグ一覧、日付一覧、カレンダー、新着リスト等の「サイドコンテンツ」をギャラリーモード用スキンに掲載したとしても、それらのリンク先は「ギャラリーモードを解除したページ」になっています。そうではなく、「ギャラリーモードのまま表示」したい場合のための新記法を追加しました。
🌰ハッシュタグ一覧リンク：
⬜従来からの(モード解除リンクになる)記法 [[HASHTAG:LIST]]
✨ギャラリーモードでのリンクになる記法 [[HASHTAG:LIST:GALLERY]]
✨サイトマップページでのリンクになる記法 [[HASHTAG:LIST:SITEMAP]]
🌰ハッシュタグ選択プルダウンメニュー：
⬜従来からの(モード解除移動になる)記法 [[HASHTAG:PULL]]
✨ギャラリーモードへの移動になる記法 [[HASHTAG:PULL:GALLERY]]
✨サイトマップページへの移動になる記法 [[HASHTAG:PULL:SITEMAP]]
※[[HASHTAG:PULL:JS]] も同様に [[HASHTAG:PULL:JS:GALLERY]] や [[HASHTAG:PULL:JS:SITEMAP]] と書けます。
🌰日付一覧リンク：
⬜従来からの(モード解除リンクになる)記法 [[DATEBOX:LIST]]
✨ギャラリーモードでのリンクになる記法 [[DATEBOX:LIST:GALLERY]]
✨サイトマップページでのリンクになる記法 [[DATEBOX:LIST:SITEMAP]]
🌰日付検索プルダウンメニュー：
⬜従来からの(モード解除移動になる)記法 [[DATEBOX:PULL]]
✨ギャラリーモードへの移動になる記法 [[DATEBOX:PULL:GALLERY]]
✨サイトマップページへの移動になる記法 [[DATEBOX:PULL:SITEMAP]]
※日付一覧と日付検索を両方いっぺんに出力できる [[DATEBOX]] 記法は対象外です。
🌰カレンダー：
⬜従来からの(モード解除リンクになる)記法 [[CALENDAR]]
✨ギャラリーモードでのリンクになる記法 [[CALENDAR:GALLERY]]
✨サイトマップページでのリンクになる記法 [[CALENDAR:SITEMAP]]
※前後の月へ移動できる（主にカレンダー移動リンクとして使うことを想定した）[[MOVEMONTH:-1:URL]]記法は対象外です。この記法は（リンクが出力されるのではなく）URLが出力されるだけですから、ギャラリーモードで表示したい場合には自力でリンクに「 &mode=gallery 」を加えて下さい。
🌰新着リストリンク：
⬜従来からの(モード解除リンクになる)記法 [[LATESTLIST]]
✨ギャラリーモードでのリンクになる記法 [[LATESTLIST:GALLERY]]
✨サイトマップページでのリンクになる記法 [[LATESTLIST:SITEMAP]]
🌰カテゴリツリーのリンク先：
⬜従来からの(モード解除リンクになる)記法 [[CATEGORY:TREE]]
✨ギャラリーモードでのリンクになる記法 [[CATEGORY:TREE:GALLERY]]
✨サイトマップページでのリンクになる記法 [[CATEGORY:TREE:SITEMAP]]
※識別子を使ってカスタマイズされた [[CATEGORY:TREE:<IT>CBD]] のような記法でも、末尾に加えて [[CATEGORY:TREE:<IT>CBD:GALLERY]] や [[CATEGORY:TREE:<IT>CBD:SITEMAP]] のように書くことができます。
🌰カテゴリプルダウンメニュー：
⬜従来からの(モード解除移動になる)記法 [[CATEGORY:PULL]]
✨ギャラリーモードへの移動になる記法 [[CATEGORY:PULL:GALLERY]]
✨サイトマップページへの移動になる記法 [[CATEGORY:PULL:SITEMAP]]
※[[CATEGORY:PULL:JS]] も同様に [[CATEGORY:PULL:JS:GALLERY]] や [[CATEGORY:PULL:JS:SITEMAP]] と書けます。
🌰使用上の注意：
ギャラリーモードの表示対象にならない投稿しか該当しない場合は、1件も表示されないリンクになる点に注意
ギャラリーモードは、投稿本文内に投稿画像が1つ以上含まれている場合にだけ表示されるモードです。なので、
・画像が含まれていない投稿でしか使われていないハッシュタグ
・画像が含まれていない投稿しかしなかった日付
・画像が含まれていない投稿でしか使われていないカテゴリ
等がある場合、それらのリンク先では「表示できる投稿が1件も見つかりませんでした」等のメッセージだけが見えます。（ギャラリーモードとして表示可能な投稿へのリンクだけが生成される仕様ではありません。）
※なお、これらの記述はギャラリーモードやサイトマップページ以外のスキンでも使用可能です。（外側スキンなら、どこでも使用可能です。）
畳む
▼新機能：表示を拡張する新記法
🌸「続きを読む」ボタンのラベルをその都度指定できる新記法を追加。
「続きを読む」ボタンのラベルを、設定で一括変更する以外に、その都度本文で指定できる記法 [H:ボタンラベル:～中身～] を追加しました。
この記法を使えば、任意のラベルを臨時に使うことができます。「ネタバレ」や「長くなるので畳む」や、隠されている範囲に含まれている内容の注意喚起「巨大画像注意(10MB)」などにも使えるでしょう。
詳しくは、「続きを読む」ボタンのラベルをその都度指定する書き方をご覧下さい。
🌸リストを表示するための専用記法。（箇条書きリストや番号付きリストが表示可能に）
装飾記法に、箇条書きリスト、番号付きリスト、説明リスト等を出力できるオプションを加えました。
各種リストを出力できるほか、任意の先頭記号を指定したり、任意のclass名を付加したりもできます。詳しくは、リスト(箇条書き/番号付き/説明)の指定をご覧下さい。
🌺投稿本文の行数が得られる記法を追加。(内側スキンのみ)
投稿本文の文字数が得られる [[LENGTH]] に対して、投稿本文の行数が得られる記法 [[TOTALLINES]] を追加しました。
ここでの行数は、見た目の行数ではなく、HTML上の論理行数（正確には改行の数）です。行数を表示したい場合のほか、行数の多さに応じてスクリプト等で何らかの処理を加えたい場合等に活用できるかもしれません。
🌺RSS Auto-Discoveryを挿入する記法を追加。(外側スキンのみ)
RSSフィードの存在を自動検知させる仕組みである「RSS Auto-Discovery」を出力できる専用のキーワード [[RSS:AUTODISCOVERY]] を用意しました。
従来のように、link要素を自力で組み立てる必要がなくなります。これによって、従来のスキンに存在した『RSSを使わない設定にしているのに、Auto-Discoveryの記述だけは存在する』という無駄な出力を避けられます。
詳しくは、RSSフィードの出力や、RSSフィード用スキンの作り方・使い方や、リファレンスの「特殊機能要素」欄をご覧下さい。
▼新機能：スキンのカスタマイズ関連
🌸上位ディレクトリや別階層に存在するスキンでもプレビューしたり簡易適用したりできる機能。
他の階層（上位のディレクトリとか）に存在するスキンでもプレビューしたり簡易本番適用したりできるようにしました。
てがろぐを複数個設置して併用しているとき、同じスキンを使って運営したいなら1カ所にあるスキンを共用できる方がカスタマイズが楽でしょう。
詳しくは、「スキンは、直下のサブディレクトリ以外の別階層にあっても使える」をご覧下さい。
🌺投稿本文内の、任意の範囲をコメントアウトできる記法。
記法 [!-- 中身 --] で、任意の範囲をコメントアウトできる仕様を追加しました。
詳しくは、任意の範囲をコメントアウトする書き方をご覧下さい。
🌺各種ディレクトリのパス(PATH)を得られる新記法を追加。
てがろぐに関連する各種ディレクトリへのパス(PATH)だけを得られる新記法として、[[PATH:CGIDIR]] や [[PATH:SKINDIR]] など7種類の記法を追加しました。
複数のスキンを組み合わせて運営したい場合などに役立つかもしれません。
詳しくは、リファレンスの【各種パス挿入要素】をご覧下さい。
🌺スキン内に記述されている link要素やform要素に対して、「現在のスキンでの表示を維持する」目的で自動挿入される各種記述をスキップできる記法を追加。
「現在のスキンでの表示を維持する」目的で挿入される各種の自動調整をスキップできる記法 [[NO-LINKADJUSTMENT]] を追加しました。
従来から、デフォルトスキン以外のスキンが適用されているときには、3種類のリンク自動調整処理が働く仕様になっていました。これらの自動処理を無効化する指示として、記法 [[NO-LINKADJUSTMENT]] を追加しました。複数のスキンを同時に活用している場合で、ある特定のスキンに対してリンクが自動調整されると困る場合にお使い頂けます。
詳しくは、適用スキンを維持するためのリンク自動調整仕様をご覧下さい。
🌺[[INCLUDE:～]] 記法と [[PATH:～]] 記法を、内側スキンでも使用可能に。
従来は外側スキンだけでしか使えなかった INCLUDE 記法を内側スキンでも使用可能にしました。また、新設の PATH 記法も両方で使えます。
詳しくは、リファレンスの外側スキンと内側スキンの両方で使用可能な共通キーワードの一覧と書き方項目をご覧下さい。
🌺任意のファイルを挿入できる INCLUDE 記法の仕様拡充。
合成できるファイルの仕様を大幅に拡充しました。
詳しくは、リファレンスの外側スキンと内側スキンの両方で使用可能な共通キーワードの一覧と書き方項目内の「ファイル合成要素」項目をご覧下さい。
例えば以下のような仕様拡充があります。
▼新機能：設定項目
🌺記述サンプルを自動入力するかどうかの設定項目と、文字色や背景色として自動入力するサンプル文字列の設定項目を追加。
装飾ボタンを押した際に、記述サンプルや色名サンプルを自動入力するかどうか、自動入力する場合にデフォルトのサンプル色を何にするか等を設定できる機能を加えました。
詳しくは、記述サンプルを自動入力するかどうかの設定と、文字色や背景色として自動入力するサンプル文字列を設定する方法をご覧下さい。
●ログインフォームの下部に表示できるメッセージを設定画面で設定できる機能。
てがろぐのログインフォーム（＝ログインしていない状態で管理画面にアクセスしたときに最初に表示されるログイン画面）の下部に任意のメッセージを表示できる機能が以前からありましたが、これを管理画面の「設定」で登録しておける機能を加えました。
●ハッシュタグだとは認識されない「 # 」記号を簡単に表示させる方法として、「#」を入力できる項目をハッシュタグ簡単入力プルダウンメニューに追加できる機能を追加。
詳しくは、ハッシュタグにならない「 # 」記号を書きたい場合をご覧下さい。
●投稿本文中にAmazonのURLが書かれたとき、自動で極力短く加工する機能を追加（標準ではOFF）。
Amazonの商品URLを自動で短くする機能を加えました。詳しくは、投稿本文中にAmazonのURLが書かれたとき、自動で極力短く加工する機能をご覧下さい。
▼仕様改善
🌺拡大画像をLightboxで表示できるテキストリンクを作る記法に、「画像リンクに独自のclass属性値を追加する」と同じclass属性値も追加されるよう仕様改善。
画像を直接埋め込まずに、画像へのテキストリンクとして掲載しつつ、リンク先の画像はLightboxで見せたい場合の書き方 [リンクラベル:LB] の出力仕様を拡張し、data-属性ではなくclass属性に指定の記述が必要なスクリプトでも使えるようにしました。
詳しくは、画像を直接埋め込まずに、画像へのテキストリンクとして掲載しつつ、リンク先の画像はLightboxで見せたい場合の書き方をご覧下さい。
●全文検索の強調表示では、半角英字の大文字小文字が一致しなくても強調対象になるよう仕様改善。
従来は、（全文検索そのものでは大文字/小文字を区別しないものの）大文字/小文字が一致していないと強調表示はされませんでした。
例えば、投稿本文に「Sister」という英単語があり、検索語「sister」で検索した場合、
●従来は、検索にはヒットするものの強調表示はされませんでした。(先頭の大文字/小文字が一致しないため)
●今後は、検索にヒットする上、強調表示もされるようになります。
●上位ディレクトリを参照するパスで画像が指定されたときに、ファイルが見つからなければ注釈を含むエラーを表示するよう仕様改善。
本文中に画像を表示する記法で、[PICT:/hogehoge/hoge.png] などのように、スラッシュで始まる絶対パスで画像が指定されたときに、ファイルが見つからなければその旨をエラー表示するよう仕様を改善しました。
➡ 従来は、指定した位置に画像が存在しない場合でも、『何も表示されないimg要素』が出力されていました。それでは記述ミスに気付きにくいので、下図のようにエラーを表示するようにしました。
また、本文中に画像を表示する記法で、[PICT:../../hogehoge/hoge.png] などのように、上位ディレクトリを参照するパスで画像が指定されたときに、ファイルが見つからなければ注釈を含むエラーを表示するよう仕様を改善しました。
➡ 従来は、『画像用ディレクトリにそのファイルはない』というエラーメッセージが表示されていましたので、まるで「相対パスの記述が認識されていない」かのように誤解されそうでしたので、その辺を明確に伝えるように改善しました。
●デフォルトで読み込むjQueryやLightboxを最新版にバージョンアップ。
もはや古いバージョンを読む必要性がありませんので、それぞれ最新版を読むように変更しました。具体的には、jQueryはVer.3系(jquery-3.6.1.min.js)を、Lightboxは Ver 2.11.3 を読み込むようになります。
▼スキン更新
●標準添付の各スキンを更新
標準添付の各スキンを更新しました。ギャラリーモード用スキンも含めて、新仕様に対応するよう書き換えてあります。
主な更新点：
✅標準添付スキンをそのままお使いの場合は、上書きアップロードして下さい。
✅スキンをかなりカスタマイズして使っている場合や、独自のスキンをお使いの場合は、標準スキンのCSS（tegalog.css）の225行目の『/* ▼埋め込み画像 */』の部分以降のソースをコピー＆ペーストするなどしてご活用下さい。
▼標準スキンに含まれる tegalog.css ファイルの 224～268行目付近：
※上記の 255～260行目にある .embeddedimage 部分は従来から存在する装飾です。
※上記の 262行目以降は、NSFWフラグが付いた画像の表示用として、画像をぼかす装飾を記述しています。
※標準スキン以外に付属するCSSファイルでは行番号や配色が異なります。
▼キャプション付き画像ボックスを横に並べたい場合の注意：
figure要素は（何もCSSで装飾しない標準状態では）横方向には並んで表示されません。figure要素を横方向に並べるには、figure要素をinline-block等で表示するようなCSSが必要です。標準添付の各スキンでは、inline-block ではなく inline-table を使って横に並べています（上図参照）。
※inline-tableを使っている理由は、次の2点です。
✅キャプションが長い場合には、画像の横幅を超えることなく自動改行して表示されるようにするため。
✅キャプションの位置を上端にしたい場合や下端にしたい場合に、プロパティの値1つを書き換えるだけで済むようにするため。（caption-sideプロパティの値をbottomにするとキャプションは画像の下に表示されます。topにすると画像の上に表示されます。）標準添付スキンの中では、ギャラリーモードだけは top にしてあります。
▼#不具合修正 ：
❎「スラッシュで始まる絶対パス」で画像が指定されたとき、画像のURLが正しくなくなって画像が表示されない不具合を解消。
画像保存用ディレクトリ以外に存在している画像を表示したいとき、設定の『画像パスに絶対URL(フルパス)を使う』がONで、画像パスとして「スラッシュで始まる絶対パス」を使って画像が指定されたときに、画像のURLがおかしくなって正しく画像が表示されない不具合を解消しました。
❎「続きを読む」記法が使われている状態で、設定画面から「続きを読む」機能をOFFにすると、Internal Server Errorになる不具合を修正。
あまりこのように操作する人は居ないとは思いますが、
【前提】「続きを読む」記法を本文中に使っている状態で、
【操作】設定画面で「続きを読む」機能をOFFにすると、
Internal Server Error になる可能性のある不具合が（比較的最近のバージョンでだけ）ありました。
しかも、一度この状態になると、設定画面から再度「続きを読む」機能を有効にしようと操作しても、保存時に（保存処理が実行されるより前に）Internal Server Errorになる可能性があり、一度この状態になったらデータファイル tegalog.ini を直接修正しない限り復帰できない可能性があります。古いバージョンをお使いの場合に上記のような操作を試さないようご注意下さい。
この問題を解決しました。
❎「skin=」パラメータでスキンが指定されているとき、投稿本文内のハッシュタグをすべて抜き出す記法 [[COMMENT:TAGS]] が動作しない不具合を解消。
URLの中で、パラメータ(クエリ)の開始を意味する「?」記号と、ハッシュタグを指定するパラメータ「tag=○○○」との間に別のパラメータが存在する場合に限って、何も抽出されない不具合がありました。それを解消しました。
❎ハッシュタグに半角アンダーバー「_」を使うと、既存ハッシュタグ簡単入力用プルダウンメニューでは角括弧付きでリストアップされる不具合を修正。
角括弧が付いていてもハッシュタグとしては機能しますが、英数字だけで構成されるハッシュタグの場合は角括弧は不要なので、付かないよう修正しました。
❎内側スキンで [[CATEGORYLINKS:FULL]] と書いても、カテゴリページへのURLがフルパスでは出力されない不具合を解消。
例えば、「最新の投稿1件を別ページに埋め込んでいる場合」などでは、所属カテゴリへのリンクをフルパスで出力しないとリンク切れになってしまうため、 [[CATEGORYLINKS:FULL]] という記法を用意していました。
……が、この記法を使ってもフルパスでは出力されていない不具合がありましたので修正しました。
❎投稿単独ページのURLを挿入する [[PARMAURL]] キーワードのスペルを [[PERMAURL]] でも認識するよう改善。（※両方使用可能）
投稿単独ページのURLが得られる記法(内側スキンで使えます)として、従来の [[PARMAURL]] のほかに [[PERMAURL]] も使えるようにしました（※従来の記述のままでも使用可能です）。古い記述を無効にする予定はありませんので、従来の記述をわざわざ修正する必要はありません。
※PERMAURL は、Permanent URL の略です。PARMAURL は、Permanent And Revolutionary Momonga Accessible URL とかの略です。
嘘です。スペルミスです。○|￣|＿
❎「Unrecognized escape \\v passed through at tegalog.cgi」というアラートがサーバのエラーログに記録される問題を解消。
Perl 5.8.x あたりの比較的古いバージョンのPerlが使われているWebサーバでは、サーバのエラーログにアラートが記録される可能性がありましたので修正しました（記録されていても、てがろぐの動作に問題はありません）。
❎サーバのエラーログに「CGI::param called in list context」のようなアラートが出力されるのを防ぐよう改善。
かなり新しいバージョンのPerlが使えるサーバでは、「CGI::param called in list context from tegalog.cgi line XXXX, this can lead to vulnerabilities.」のようなアラートがサーバのエラーログに記録されることがありました。これを記録されないようにしました。(※もし引き続き記録される場合はご報告頂けますと幸いです。)
❎設定画面のHTMLにいくつか存在していた文法ミスを修正。
設定画面としての動作には問題ないレベルですが、文法的におかしなHTMLになっていた箇所を修正しました。
❎リンクラベルの中に # での # 記号が入っていても正しくラベルとして使えるよう仕様を修正。
[ラベル]URL 記法を使ってテキストリンクを作るとき、ラベルの中に # を記述していると正しくリンクラベルとして使えない不具合を解消しました。
なお、# ではない # 記号そのものが含まれていると、それはハッシュタグとして認識されてしまうためにテキストリンクにはなりませんのでご注意下さい。
❎「続きを読む」機能を入れ子にして使うと、ボタンラベルが正しく出力されないケースがある不具合を修正。
指定範囲を隠せる「続きを読む」機能である [H: ～ ] 記法の中に、さらに [H: ～ ] 記法を含めて2階層以上の隠された範囲を作ると、うまく動作しない不具合を解消しました。何階層にも入れ子にしても大丈夫なように改善しています。
以上、ご活用頂ければ幸いです。
※不具合の修正も含んでおりますので、使いたい追加機能がない場合でもアップグレード頂くことをお勧め致します。（アップグレードしても、ログインし直す必要はありません。ログイン状態は維持されます。）
なお、開発進捗状況報告サイトでフォロー頂くと、てがろぐCGIの最新β版や正式版の公開時にメールで連絡を受け取ることもできますので、ぜひご活用下さい。(╹◡╹)ﾉ
フォロー数が増えると、私の開発モチベーションが向上するメリットもあります！！！🤩
➡ https://www.nishishi.com/cgi/tegalog/
アップデートするには、tegalog.cgi と fumycts.pl の2ファイルだけ(※)を上書きアップロードして下さい。
データファイルや設定ファイルは、すべてそのまま引き継げます。(Ver.2以下も含む過去のどのバージョンからでも)
※今回も標準添付スキンのソースを全体的に更新しています。標準添付スキンをそのままお使いの場合は、それらも上書きアップロードして下さい。
🆕 Ver 3.9.0の更新点(概要)：
《▼新機能：画像投稿関連》
●新着画像リスト（最近UPされた画像の一覧）出力機能。
●UPされた画像1つ1つにキャプションやフラグ等を事前登録しておける画像インデックス機能。
●画像をキャプション付きで表示できる新記法を追加。
●画像のキャプションをその都度指定できる新記法を追加。
●その画像に対応したサムネイル画像が存在する場合には『ページ上の表示にはサムネイル画像を使い、Lightboxでのリンク先にはオリジナル画像を使う』ように表示できる機能を追加。
●投稿本文内に含まれる画像をすべて抽出して表示できる記法を追加。
《▼新機能：ページ上の表示関連》
●インスタグラムの埋め込み機能。
●投稿日付の表示に（n分前、n時間前、n日前……のような）経過時間を表示できる日付表記オプション。
●ページ番号の省略を始める総ページ数を自由に設定できる機能。
●ページ番号リンクの両端（先頭と末尾）に何ページずつ固定表示するかを変更できる機能。
●サイドコンテンツ各種でもギャラリーモードやサイトマップページを維持したリンクを出力できる新記法。
《▼新機能：表示を拡張する新記法》
●「続きを読む」ボタンのラベルをその都度指定できる新記法を追加。
●リストを表示するための専用記法。（箇条書きリストや番号付きリストが表示可能に）
●投稿本文の行数が得られる記法を追加。(内側スキンのみ)
●RSS Auto-Discoveryを挿入する記法を追加。(外側スキンのみ)
《▼新機能：スキンのカスタマイズ関連》
●上位ディレクトリや別階層に存在するスキンでもプレビューしたり簡易適用したりできる機能。
●投稿本文内の、任意の範囲をコメントアウトできる記法。
●各種ディレクトリのパス(PATH)を得られる新記法を追加。
●スキン内に記述されている link要素やform要素に対して、「現在のスキンでの表示を維持する」目的で自動挿入される各種記述をスキップできる記法を追加。
●[[INCLUDE:～]] 記法と [[PATH:～]] 記法を、内側スキンでも使用可能に。(従来は外側スキン専用でした)
●任意のファイルを挿入できる INCLUDE 記法の仕様拡充。
《▼新機能：設定項目》
●記述サンプルを自動入力するかどうかの設定項目と、文字色や背景色として自動入力するサンプル文字列の設定項目を追加。
●ログインフォームの下部に表示できるメッセージを設定画面で設定できる機能。
●ハッシュタグだとは認識されない「 # 」記号を簡単に表示させる方法として、「#」を入力できる項目をハッシュタグ簡単入力プルダウンメニューに追加できる機能を追加。
●投稿本文中にAmazonのURLが書かれたとき、自動で極力短く加工する機能を追加（標準ではOFF）。
《▼仕様改善》
●拡大画像をLightboxで表示できるテキストリンクを作る記法に、「画像リンクに独自のclass属性値を追加する」と同じclass属性値も追加されるよう仕様改善。
●全文検索の強調表示では、半角英字の大文字小文字が一致しなくても強調対象になるよう仕様改善。
●上位ディレクトリを参照するパスで画像が指定されたときに、ファイルが見つからなければ注釈を含むエラーを表示するよう仕様改善。
●デフォルトで読み込むjQueryやLightboxを最新版にバージョンアップ。
《▼スキン更新》
●標準添付の各スキンを更新
《▼不具合修正》
●「スラッシュで始まる絶対パス」で画像が指定されたとき、画像のURLが正しくなくなって画像が表示されない不具合を解消。
●「続きを読む」記法が使われている状態で、設定画面から「続きを読む」機能をOFFにすると、Internal Server Errorになる不具合を修正。
●「skin=」パラメータでスキンが指定されているとき、投稿本文内のハッシュタグをすべて抜き出す記法 [[COMMENT:TAGS]] が動作しない不具合を解消。
●ハッシュタグに半角アンダーバー「_」を使うと、既存ハッシュタグ簡単入力用プルダウンメニューでは角括弧付きでリストアップされる不具合を修正。
●内側スキンで [[CATEGORYLINKS:FULL]] と書いても、カテゴリページへのURLがフルパスでは出力されない不具合を解消。
●投稿単独ページのURLを挿入する [[PARMAURL]] キーワードのスペルを [[PERMAURL]] でも認識するよう改善。
●「Unrecognized escape \\v passed through at tegalog.cgi」というアラートがサーバのエラーログに記録される問題を解消。
●サーバのエラーログに「CGI::param called in list context」のようなアラートが出力されるのを防ぐよう改善。
●設定画面のHTMLにいくつか存在していた文法ミスを修正。
●リンクラベルの中に # での # 記号が入っていても正しくラベルとして使えるよう仕様を修正。
●「続きを読む」機能を入れ子にして使うと、ボタンラベルが正しく出力されないケースがある不具合を修正。
▼新機能：画像投稿関連
🌸新着画像リスト（最近UPされた画像の一覧）出力機能。
最近にアップロードされた画像だけの一覧を表示する「新着画像リスト」表示機能を追加しました。
画像保存用ディレクトリに存在する画像のうち、「一覧外」フラグが立てられていないすべての画像を対象に、新着順に指定個数だけ表示します。Twitterのプロフィールページ右上に見えるメディア欄のような感じの表示を作りたい場合に活用できます。
詳しくは、新着画像リストの設定方法などをご覧下さい。
新着画像リストの出力方法は、リファレンス内の【新着画像リスト要素】をご覧下さい。
新着画像リストの装飾に関する参考情報は、新着画像リストの装飾方法をご覧下さい。
標準添付スキンのうち（チャットタイプスキンを除く）8種類のスキンにも新着画像リスト用のHTML＋CSSを加えてあります。標準添付スキンをそのままお使いの場合は、上書きアップロードすれば新着画像リストも表示されるようになります。もし、大きくカスタマイズしてお使いの場合や、独自のスキンを作ってお使いの場合には、標準スキンの下記の位置にあるソースをコピー＆ペーストするなどしてご活用頂くと、標準スキンと同じ見た目を手っ取り早く実現できるでしょう。
✅まず、外側スキン（skin-cover.html）には、以下のようなHTMLを加えています。
うまく装飾するためには、[[IMAGELIST]] の外側に何らかのブロック要素を加えておく方が良いと思います。 下記では <p class="imagelistbox">～</p> で囲んでいます。
✅次に、CSS（tegalog.css）では、以下のようなソースで装飾しています。 CSSソース内で ▼画像一覧リスト区画 という文字列を検索すると見つかります。この区画の中身をコピーするなどしてご活用下さい。
特に、画像サイズを調整している箇所は、1080～1089行目にある /* ▼各画像の装飾 */ と書かれた区画です。（上図のほぼ中央付近）畳む
🌸UPされた画像1つ1つにキャプションやフラグ等を事前登録しておける画像インデックス機能。
てがろぐ上にアップロードした画像1つ1つに、あらかじめキャプションを登録しておいたり、表示上の調整を加えられるフラグを設定しておいたり、縦横サイズを手動設定しておいたりできる画像管理機能を加えました。
詳しくは、画像管理画面で画像1つ1つにキャプションやフラグを登録する方法をご覧下さい。
フラグには「NSFW（not safe for work）」もあり、標準添付の各スキンでは、このNSFWフラグが設定された画像は、デフォルト状態ではぼかされて表示されます。
※従来の画像表示形態はそのまま何も変わりません。
今バージョンからは画像にキャプションを登録できるようになりましたが、それは「キャプションを表示したければできる」というだけであって、既存の画像表示は何も変わりません。なので、CGIをバージョンアップしても、今お使いのスキンはそのまま問題なく継続してご使用頂けます。
🌸画像をキャプション付きで表示できる新記法を追加。
あらかじめ登録しておいたキャプション付きで画像を表示できる新しい記法として [PICT:FIG:ファイルパス] を追加しました。
詳しくは、画像を表示する書き方のまとめをご覧下さい。
なお、この記法によって画像が表示される際に、どのようなHTMLとして出力されるのかは、カスタマイズ方法ページの「画像の表示方法に応じた実際の出力HTMLと装飾例」等で紹介していますのでご参照下さい。
🌸画像のキャプションをその都度指定できる新記法を追加。
画像に任意のキャプションをその都度指定できる記法として [PICT:FIG(キャプション):ファイルパス] を追加しました。
画像にキャプションを事前登録しておけるのは、画像保存用ディレクトリ内に存在する画像だけです。そのため、先の [PICT:FIG:～] 記法を使って、画像保存用ディレクトリ以外の場所にあるファイルを指定しても、キャプションは表示できません（※「キャプション自動取得対象外」というエラーがキャプションとして表示されます）。しかし、 [PICT:FIG(臨時キャプション):～] 記法を使うことで、画像保存用ディレクトリ以外に存在する画像にもその都度キャプションを指定できます。
🌸その画像に対応したサムネイル画像が存在する場合には『ページ上の表示にはサムネイル画像を使い、Lightboxでのリンク先にはオリジナル画像を使う』ように表示できる機能を追加。
サムネイル画像があればサムネイル画像の方を表示する機能(簡易版)を用意しました。
ファイルサイズの大きな画像を掲載したい場合などでは、最初はサイズの小さなサムネイル画像を見せておいて、拡大操作がされた際にだけオリジナルの画像を見せたい場合もあるでしょう。そのような動作を実現できます。詳しくは、サムネイル画像があればサムネイル画像の方を表示する機能(簡易版)をご覧下さい。
🌺投稿本文内に含まれる画像をすべて抽出して表示できる記法を追加。
投稿本文内に含まれる画像だけを抽出して表示できる記法 [[COMMENT:PICTS]] を追加しました。投稿本文内に含まれるハッシュタグだけを抽出する [[COMMENT:TAGS]] と同様の感じで動作します。
詳しくは、リファレンスの【投稿本文関連要素（オプション）】内にある「抽出結果を挿入（画像）」項目をご覧下さい。
▼新機能：ページ上の表示関連
🌸インスタグラムの埋め込み機能。
投稿本文中に、Instagramの1投稿を埋め込むこともできるようになりました。
詳しくは、Instagram(インスタグラム)の投稿を埋め込む書き方をご覧下さい。
🌸投稿日付の表示に（n分前、n時間前、n日前……のような）経過時間を表示できる日付表記オプション。
投稿日時を表示できる [[DATE:～]] 記法に、投稿されたのが現在からどれくらい前なのかを「40秒前」や「3分前」や「12時間前」や「50日前」などのように相対時間で表示できる日時表記オプションを追加しました。
投稿日時を表示できる [[DATE:～]] 記法の中に……
🌰「A」と記述すれば、5秒前、6分前、7時間前、8日前、9年前 のように表示（未来の日付だと、1日後、2時間後、3分後のように表示）されます。
🌰「a」と記述すれば、5秒、6分、7時間、8日、9年 のように表示（未来の日付だと、-1日、-2時間、-3分のように表示）されます。
詳しくは、リファレンスの【投稿日時関連要素】をご覧下さい。その項目末尾の補足欄に、より詳しい解説を記しています。
🌸ページ番号の省略を始める総ページ数を自由に設定できる機能。
🌸ページ番号リンクの両端（先頭と末尾）に何ページずつ固定表示するかを変更できる機能。
ページ番号の省略を始める総ページ数と、ページ番号リンクの両端（先頭と末尾）に何ページずつ固定表示するかを、設定画面で変更できるようになりました。
ページネーションの占有幅を省略時のデフォルトサイズ（下図の左端）よりももっとコンパクトにしたい場合などにご活用頂けます。
詳しくは、ページ番号の省略を始める総ページ数や、ページ番号リンクの両端に何ページずつ固定表示するかを変更するをご覧下さい。
🌸サイドコンテンツ各種でもギャラリーモードやサイトマップページを維持したリンクを出力できる新記法。
サイドコンテンツ各種(例えばハッシュタグ一覧やカレンダー等)でも、ギャラリーモードやサイトマップページを維持したリンクを出力できる新記法を追加しました。
ハッシュタグ一覧、日付一覧、カレンダー、新着リスト等の「サイドコンテンツ」をギャラリーモード用スキンに掲載したとしても、それらのリンク先は「ギャラリーモードを解除したページ」になっています。そうではなく、「ギャラリーモードのまま表示」したい場合のための新記法を追加しました。
🌰ハッシュタグ一覧リンク：
⬜従来からの(モード解除リンクになる)記法 [[HASHTAG:LIST]]
✨ギャラリーモードでのリンクになる記法 [[HASHTAG:LIST:GALLERY]]
✨サイトマップページでのリンクになる記法 [[HASHTAG:LIST:SITEMAP]]
🌰ハッシュタグ選択プルダウンメニュー：
⬜従来からの(モード解除移動になる)記法 [[HASHTAG:PULL]]
✨ギャラリーモードへの移動になる記法 [[HASHTAG:PULL:GALLERY]]
✨サイトマップページへの移動になる記法 [[HASHTAG:PULL:SITEMAP]]
※[[HASHTAG:PULL:JS]] も同様に [[HASHTAG:PULL:JS:GALLERY]] や [[HASHTAG:PULL:JS:SITEMAP]] と書けます。
🌰日付一覧リンク：
⬜従来からの(モード解除リンクになる)記法 [[DATEBOX:LIST]]
✨ギャラリーモードでのリンクになる記法 [[DATEBOX:LIST:GALLERY]]
✨サイトマップページでのリンクになる記法 [[DATEBOX:LIST:SITEMAP]]
🌰日付検索プルダウンメニュー：
⬜従来からの(モード解除移動になる)記法 [[DATEBOX:PULL]]
✨ギャラリーモードへの移動になる記法 [[DATEBOX:PULL:GALLERY]]
✨サイトマップページへの移動になる記法 [[DATEBOX:PULL:SITEMAP]]
※日付一覧と日付検索を両方いっぺんに出力できる [[DATEBOX]] 記法は対象外です。
🌰カレンダー：
⬜従来からの(モード解除リンクになる)記法 [[CALENDAR]]
✨ギャラリーモードでのリンクになる記法 [[CALENDAR:GALLERY]]
✨サイトマップページでのリンクになる記法 [[CALENDAR:SITEMAP]]
※前後の月へ移動できる（主にカレンダー移動リンクとして使うことを想定した）[[MOVEMONTH:-1:URL]]記法は対象外です。この記法は（リンクが出力されるのではなく）URLが出力されるだけですから、ギャラリーモードで表示したい場合には自力でリンクに「 &mode=gallery 」を加えて下さい。
🌰新着リストリンク：
⬜従来からの(モード解除リンクになる)記法 [[LATESTLIST]]
✨ギャラリーモードでのリンクになる記法 [[LATESTLIST:GALLERY]]
✨サイトマップページでのリンクになる記法 [[LATESTLIST:SITEMAP]]
🌰カテゴリツリーのリンク先：
⬜従来からの(モード解除リンクになる)記法 [[CATEGORY:TREE]]
✨ギャラリーモードでのリンクになる記法 [[CATEGORY:TREE:GALLERY]]
✨サイトマップページでのリンクになる記法 [[CATEGORY:TREE:SITEMAP]]
※識別子を使ってカスタマイズされた [[CATEGORY:TREE:<IT>CBD]] のような記法でも、末尾に加えて [[CATEGORY:TREE:<IT>CBD:GALLERY]] や [[CATEGORY:TREE:<IT>CBD:SITEMAP]] のように書くことができます。
🌰カテゴリプルダウンメニュー：
⬜従来からの(モード解除移動になる)記法 [[CATEGORY:PULL]]
✨ギャラリーモードへの移動になる記法 [[CATEGORY:PULL:GALLERY]]
✨サイトマップページへの移動になる記法 [[CATEGORY:PULL:SITEMAP]]
※[[CATEGORY:PULL:JS]] も同様に [[CATEGORY:PULL:JS:GALLERY]] や [[CATEGORY:PULL:JS:SITEMAP]] と書けます。
🌰使用上の注意：
ギャラリーモードの表示対象にならない投稿しか該当しない場合は、1件も表示されないリンクになる点に注意
ギャラリーモードは、投稿本文内に投稿画像が1つ以上含まれている場合にだけ表示されるモードです。なので、
・画像が含まれていない投稿でしか使われていないハッシュタグ
・画像が含まれていない投稿しかしなかった日付
・画像が含まれていない投稿でしか使われていないカテゴリ
等がある場合、それらのリンク先では「表示できる投稿が1件も見つかりませんでした」等のメッセージだけが見えます。（ギャラリーモードとして表示可能な投稿へのリンクだけが生成される仕様ではありません。）
※なお、これらの記述はギャラリーモードやサイトマップページ以外のスキンでも使用可能です。（外側スキンなら、どこでも使用可能です。）
畳む
▼新機能：表示を拡張する新記法
🌸「続きを読む」ボタンのラベルをその都度指定できる新記法を追加。
「続きを読む」ボタンのラベルを、設定で一括変更する以外に、その都度本文で指定できる記法 [H:ボタンラベル:～中身～] を追加しました。
この記法を使えば、任意のラベルを臨時に使うことができます。「ネタバレ」や「長くなるので畳む」や、隠されている範囲に含まれている内容の注意喚起「巨大画像注意(10MB)」などにも使えるでしょう。
詳しくは、「続きを読む」ボタンのラベルをその都度指定する書き方をご覧下さい。
🌸リストを表示するための専用記法。（箇条書きリストや番号付きリストが表示可能に）
装飾記法に、箇条書きリスト、番号付きリスト、説明リスト等を出力できるオプションを加えました。
各種リストを出力できるほか、任意の先頭記号を指定したり、任意のclass名を付加したりもできます。詳しくは、リスト(箇条書き/番号付き/説明)の指定をご覧下さい。
🌺投稿本文の行数が得られる記法を追加。(内側スキンのみ)
投稿本文の文字数が得られる [[LENGTH]] に対して、投稿本文の行数が得られる記法 [[TOTALLINES]] を追加しました。
ここでの行数は、見た目の行数ではなく、HTML上の論理行数（正確には改行の数）です。行数を表示したい場合のほか、行数の多さに応じてスクリプト等で何らかの処理を加えたい場合等に活用できるかもしれません。
🌺RSS Auto-Discoveryを挿入する記法を追加。(外側スキンのみ)
RSSフィードの存在を自動検知させる仕組みである「RSS Auto-Discovery」を出力できる専用のキーワード [[RSS:AUTODISCOVERY]] を用意しました。
従来のように、link要素を自力で組み立てる必要がなくなります。これによって、従来のスキンに存在した『RSSを使わない設定にしているのに、Auto-Discoveryの記述だけは存在する』という無駄な出力を避けられます。
詳しくは、RSSフィードの出力や、RSSフィード用スキンの作り方・使い方や、リファレンスの「特殊機能要素」欄をご覧下さい。
▼新機能：スキンのカスタマイズ関連
🌸上位ディレクトリや別階層に存在するスキンでもプレビューしたり簡易適用したりできる機能。
他の階層（上位のディレクトリとか）に存在するスキンでもプレビューしたり簡易本番適用したりできるようにしました。
てがろぐを複数個設置して併用しているとき、同じスキンを使って運営したいなら1カ所にあるスキンを共用できる方がカスタマイズが楽でしょう。
詳しくは、「スキンは、直下のサブディレクトリ以外の別階層にあっても使える」をご覧下さい。
🌺投稿本文内の、任意の範囲をコメントアウトできる記法。
記法 [!-- 中身 --] で、任意の範囲をコメントアウトできる仕様を追加しました。
詳しくは、任意の範囲をコメントアウトする書き方をご覧下さい。
🌺各種ディレクトリのパス(PATH)を得られる新記法を追加。
てがろぐに関連する各種ディレクトリへのパス(PATH)だけを得られる新記法として、[[PATH:CGIDIR]] や [[PATH:SKINDIR]] など7種類の記法を追加しました。
複数のスキンを組み合わせて運営したい場合などに役立つかもしれません。
詳しくは、リファレンスの【各種パス挿入要素】をご覧下さい。
🌺スキン内に記述されている link要素やform要素に対して、「現在のスキンでの表示を維持する」目的で自動挿入される各種記述をスキップできる記法を追加。
「現在のスキンでの表示を維持する」目的で挿入される各種の自動調整をスキップできる記法 [[NO-LINKADJUSTMENT]] を追加しました。
従来から、デフォルトスキン以外のスキンが適用されているときには、3種類のリンク自動調整処理が働く仕様になっていました。これらの自動処理を無効化する指示として、記法 [[NO-LINKADJUSTMENT]] を追加しました。複数のスキンを同時に活用している場合で、ある特定のスキンに対してリンクが自動調整されると困る場合にお使い頂けます。
詳しくは、適用スキンを維持するためのリンク自動調整仕様をご覧下さい。
🌺[[INCLUDE:～]] 記法と [[PATH:～]] 記法を、内側スキンでも使用可能に。
従来は外側スキンだけでしか使えなかった INCLUDE 記法を内側スキンでも使用可能にしました。また、新設の PATH 記法も両方で使えます。
詳しくは、リファレンスの外側スキンと内側スキンの両方で使用可能な共通キーワードの一覧と書き方項目をご覧下さい。
🌺任意のファイルを挿入できる INCLUDE 記法の仕様拡充。
合成できるファイルの仕様を大幅に拡充しました。
詳しくは、リファレンスの外側スキンと内側スキンの両方で使用可能な共通キーワードの一覧と書き方項目内の「ファイル合成要素」項目をご覧下さい。
例えば以下のような仕様拡充があります。
- [[INCLUDE:～]] 記法で合成されたファイルの中に書かれている [[INCLUDE:～]] 記法も解釈するよう仕様改善。(ただし3階層まで)
- 今読んでいるスキンディレクトリに存在する特定のファイルを読み込む [[INCLUDE:FROM-THIS-SKIN-DIR:ファイル名]] 記法を追加。
- [[INCLUDE:～]] 記法の中で [[PATH:～]] 記法によるパス指定が可能に。
- [[INCLUDE:～]] 記法で合成されたファイルの中に [[CALENDAR]]、[[DATEBOX]]、[[LATESTLIST]] 等、一部の記述があるとき、それが正しく解釈されない可能性があった点を修正。
- [[INCLUDE:～]] 記法で埋め込むファイル名として「/」で始まる絶対パスが指定された場合は、DOCUMENT ROOTからのパスとして解釈するよう仕様改善。(従来は相対パスでの記述を求めていました)
▼新機能：設定項目
🌺記述サンプルを自動入力するかどうかの設定項目と、文字色や背景色として自動入力するサンプル文字列の設定項目を追加。
装飾ボタンを押した際に、記述サンプルや色名サンプルを自動入力するかどうか、自動入力する場合にデフォルトのサンプル色を何にするか等を設定できる機能を加えました。
詳しくは、記述サンプルを自動入力するかどうかの設定と、文字色や背景色として自動入力するサンプル文字列を設定する方法をご覧下さい。
●ログインフォームの下部に表示できるメッセージを設定画面で設定できる機能。
てがろぐのログインフォーム（＝ログインしていない状態で管理画面にアクセスしたときに最初に表示されるログイン画面）の下部に任意のメッセージを表示できる機能が以前からありましたが、これを管理画面の「設定」で登録しておける機能を加えました。
●ハッシュタグだとは認識されない「 # 」記号を簡単に表示させる方法として、「#」を入力できる項目をハッシュタグ簡単入力プルダウンメニューに追加できる機能を追加。
詳しくは、ハッシュタグにならない「 # 」記号を書きたい場合をご覧下さい。
●投稿本文中にAmazonのURLが書かれたとき、自動で極力短く加工する機能を追加（標準ではOFF）。
Amazonの商品URLを自動で短くする機能を加えました。詳しくは、投稿本文中にAmazonのURLが書かれたとき、自動で極力短く加工する機能をご覧下さい。
▼仕様改善
🌺拡大画像をLightboxで表示できるテキストリンクを作る記法に、「画像リンクに独自のclass属性値を追加する」と同じclass属性値も追加されるよう仕様改善。
画像を直接埋め込まずに、画像へのテキストリンクとして掲載しつつ、リンク先の画像はLightboxで見せたい場合の書き方 [リンクラベル:LB] の出力仕様を拡張し、data-属性ではなくclass属性に指定の記述が必要なスクリプトでも使えるようにしました。
詳しくは、画像を直接埋め込まずに、画像へのテキストリンクとして掲載しつつ、リンク先の画像はLightboxで見せたい場合の書き方をご覧下さい。
●全文検索の強調表示では、半角英字の大文字小文字が一致しなくても強調対象になるよう仕様改善。
従来は、（全文検索そのものでは大文字/小文字を区別しないものの）大文字/小文字が一致していないと強調表示はされませんでした。
例えば、投稿本文に「Sister」という英単語があり、検索語「sister」で検索した場合、
●従来は、検索にはヒットするものの強調表示はされませんでした。(先頭の大文字/小文字が一致しないため)
●今後は、検索にヒットする上、強調表示もされるようになります。
●上位ディレクトリを参照するパスで画像が指定されたときに、ファイルが見つからなければ注釈を含むエラーを表示するよう仕様改善。
本文中に画像を表示する記法で、[PICT:/hogehoge/hoge.png] などのように、スラッシュで始まる絶対パスで画像が指定されたときに、ファイルが見つからなければその旨をエラー表示するよう仕様を改善しました。
➡ 従来は、指定した位置に画像が存在しない場合でも、『何も表示されないimg要素』が出力されていました。それでは記述ミスに気付きにくいので、下図のようにエラーを表示するようにしました。
また、本文中に画像を表示する記法で、[PICT:../../hogehoge/hoge.png] などのように、上位ディレクトリを参照するパスで画像が指定されたときに、ファイルが見つからなければ注釈を含むエラーを表示するよう仕様を改善しました。
➡ 従来は、『画像用ディレクトリにそのファイルはない』というエラーメッセージが表示されていましたので、まるで「相対パスの記述が認識されていない」かのように誤解されそうでしたので、その辺を明確に伝えるように改善しました。
●デフォルトで読み込むjQueryやLightboxを最新版にバージョンアップ。
もはや古いバージョンを読む必要性がありませんので、それぞれ最新版を読むように変更しました。具体的には、jQueryはVer.3系(jquery-3.6.1.min.js)を、Lightboxは Ver 2.11.3 を読み込むようになります。
▼スキン更新
●標準添付の各スキンを更新
標準添付の各スキンを更新しました。ギャラリーモード用スキンも含めて、新仕様に対応するよう書き換えてあります。
主な更新点：
- head要素にあるRSS Auto-Descovery部分を [[RSS:AUTODISCOVERY]] に更新。
- 内側スキンの [[PARMAURL]] を [[PERMAURL]] に修正。
- 投稿日時の相対時間表示も各スキンに追加。
- 「最終更新日時」にも経過時間(相対時間)表記を追加。
- キャプション付きの画像表示に対応。
✅標準添付スキンをそのままお使いの場合は、上書きアップロードして下さい。
✅スキンをかなりカスタマイズして使っている場合や、独自のスキンをお使いの場合は、標準スキンのCSS（tegalog.css）の225行目の『/* ▼埋め込み画像 */』の部分以降のソースをコピー＆ペーストするなどしてご活用下さい。
▼標準スキンに含まれる tegalog.css ファイルの 224～268行目付近：
※上記の 255～260行目にある .embeddedimage 部分は従来から存在する装飾です。
※上記の 262行目以降は、NSFWフラグが付いた画像の表示用として、画像をぼかす装飾を記述しています。
※標準スキン以外に付属するCSSファイルでは行番号や配色が異なります。
▼キャプション付き画像ボックスを横に並べたい場合の注意：
figure要素は（何もCSSで装飾しない標準状態では）横方向には並んで表示されません。figure要素を横方向に並べるには、figure要素をinline-block等で表示するようなCSSが必要です。標準添付の各スキンでは、inline-block ではなく inline-table を使って横に並べています（上図参照）。
※inline-tableを使っている理由は、次の2点です。
✅キャプションが長い場合には、画像の横幅を超えることなく自動改行して表示されるようにするため。
✅キャプションの位置を上端にしたい場合や下端にしたい場合に、プロパティの値1つを書き換えるだけで済むようにするため。（caption-sideプロパティの値をbottomにするとキャプションは画像の下に表示されます。topにすると画像の上に表示されます。）標準添付スキンの中では、ギャラリーモードだけは top にしてあります。
▼#不具合修正 ：
❎「スラッシュで始まる絶対パス」で画像が指定されたとき、画像のURLが正しくなくなって画像が表示されない不具合を解消。
画像保存用ディレクトリ以外に存在している画像を表示したいとき、設定の『画像パスに絶対URL(フルパス)を使う』がONで、画像パスとして「スラッシュで始まる絶対パス」を使って画像が指定されたときに、画像のURLがおかしくなって正しく画像が表示されない不具合を解消しました。
❎「続きを読む」記法が使われている状態で、設定画面から「続きを読む」機能をOFFにすると、Internal Server Errorになる不具合を修正。
あまりこのように操作する人は居ないとは思いますが、
【前提】「続きを読む」記法を本文中に使っている状態で、
【操作】設定画面で「続きを読む」機能をOFFにすると、
Internal Server Error になる可能性のある不具合が（比較的最近のバージョンでだけ）ありました。
しかも、一度この状態になると、設定画面から再度「続きを読む」機能を有効にしようと操作しても、保存時に（保存処理が実行されるより前に）Internal Server Errorになる可能性があり、一度この状態になったらデータファイル tegalog.ini を直接修正しない限り復帰できない可能性があります。古いバージョンをお使いの場合に上記のような操作を試さないようご注意下さい。
この問題を解決しました。
❎「skin=」パラメータでスキンが指定されているとき、投稿本文内のハッシュタグをすべて抜き出す記法 [[COMMENT:TAGS]] が動作しない不具合を解消。
URLの中で、パラメータ(クエリ)の開始を意味する「?」記号と、ハッシュタグを指定するパラメータ「tag=○○○」との間に別のパラメータが存在する場合に限って、何も抽出されない不具合がありました。それを解消しました。
❎ハッシュタグに半角アンダーバー「_」を使うと、既存ハッシュタグ簡単入力用プルダウンメニューでは角括弧付きでリストアップされる不具合を修正。
角括弧が付いていてもハッシュタグとしては機能しますが、英数字だけで構成されるハッシュタグの場合は角括弧は不要なので、付かないよう修正しました。
❎内側スキンで [[CATEGORYLINKS:FULL]] と書いても、カテゴリページへのURLがフルパスでは出力されない不具合を解消。
例えば、「最新の投稿1件を別ページに埋め込んでいる場合」などでは、所属カテゴリへのリンクをフルパスで出力しないとリンク切れになってしまうため、 [[CATEGORYLINKS:FULL]] という記法を用意していました。
……が、この記法を使ってもフルパスでは出力されていない不具合がありましたので修正しました。
❎投稿単独ページのURLを挿入する [[PARMAURL]] キーワードのスペルを [[PERMAURL]] でも認識するよう改善。（※両方使用可能）
投稿単独ページのURLが得られる記法(内側スキンで使えます)として、従来の [[PARMAURL]] のほかに [[PERMAURL]] も使えるようにしました（※従来の記述のままでも使用可能です）。古い記述を無効にする予定はありませんので、従来の記述をわざわざ修正する必要はありません。
※PERMAURL は、Permanent URL の略です。PARMAURL は、Permanent And Revolutionary Momonga Accessible URL とかの略です。
嘘です。スペルミスです。○|￣|＿
❎「Unrecognized escape \\v passed through at tegalog.cgi」というアラートがサーバのエラーログに記録される問題を解消。
Perl 5.8.x あたりの比較的古いバージョンのPerlが使われているWebサーバでは、サーバのエラーログにアラートが記録される可能性がありましたので修正しました（記録されていても、てがろぐの動作に問題はありません）。
❎サーバのエラーログに「CGI::param called in list context」のようなアラートが出力されるのを防ぐよう改善。
かなり新しいバージョンのPerlが使えるサーバでは、「CGI::param called in list context from tegalog.cgi line XXXX, this can lead to vulnerabilities.」のようなアラートがサーバのエラーログに記録されることがありました。これを記録されないようにしました。(※もし引き続き記録される場合はご報告頂けますと幸いです。)
❎設定画面のHTMLにいくつか存在していた文法ミスを修正。
設定画面としての動作には問題ないレベルですが、文法的におかしなHTMLになっていた箇所を修正しました。
❎リンクラベルの中に # での # 記号が入っていても正しくラベルとして使えるよう仕様を修正。
[ラベル]URL 記法を使ってテキストリンクを作るとき、ラベルの中に # を記述していると正しくリンクラベルとして使えない不具合を解消しました。
なお、# ではない # 記号そのものが含まれていると、それはハッシュタグとして認識されてしまうためにテキストリンクにはなりませんのでご注意下さい。
❎「続きを読む」機能を入れ子にして使うと、ボタンラベルが正しく出力されないケースがある不具合を修正。
指定範囲を隠せる「続きを読む」機能である [H: ～ ] 記法の中に、さらに [H: ～ ] 記法を含めて2階層以上の隠された範囲を作ると、うまく動作しない不具合を解消しました。何階層にも入れ子にしても大丈夫なように改善しています。
以上、ご活用頂ければ幸いです。
※不具合の修正も含んでおりますので、使いたい追加機能がない場合でもアップグレード頂くことをお勧め致します。（アップグレードしても、ログインし直す必要はありません。ログイン状態は維持されます。）
なお、開発進捗状況報告サイトでフォロー頂くと、てがろぐCGIの最新β版や正式版の公開時にメールで連絡を受け取ることもできますので、ぜひご活用下さい。(╹◡╹)ﾉ
フォロー数が増えると、私の開発モチベーションが向上するメリットもあります！！！🤩
：16393文字 修正
てがろぐ Ver 4.7.0 を公開しました！ #Update
⌚ 2025年09月28日(日) 11:35:28