にしし ふぁくとりー:西村文宏 個人サイト

てがろぐ リリースノート

お手軽マイクロブログCGI「てがろぐ」のアップデート案内です。新機能や更新した仕様、新しいスキンなどを案内しています。
更新点だけではなく全体の機能説明をお読みになりたい場合や、CGIそのものをダウンロードしたい場合は、てがろぐ配布ページへお越し下さい。
セットアップやバージョンアップの前に最新版の使い心地を試したい場合は、動作テスト用てがろぐをご使用下さい。
次期バージョンの開発進捗状況をチェックしたい場合は、開発進捗報告ページをご覧下さい。

《最終更新: 2024年05月17日 金曜日 14時28分 》 RSSフィード

タグ「35」を含む投稿5件]

てがろぐ Ver 4.3.0 を公開しました! #Update

てがろぐ Ver 4.3.0 を公開しました。隣接・近傍投稿の一括表示モード表示対象(同一カテゴリ等)だけに限定した隣接投稿への移動機能ログイン者限定表示機能、編集画面に自由なHTMLをスキン別に追加できる機能、限定表示中のカテゴリの各種情報の挿入記法、ゲストを読み専IDにする機能、SITEMAP XMLの静的出力機能などの追加が主な更新点です。その他、細々した仕様改善や機能追加を含んでいます。
https://www.nishishi.com/cgi/tegalog/

バージョンアップするには、
  • 1クリックでバージョンアップできる専用PHP「TegUp」のご使用がお勧めです。
  • もしくは、最新版のZIPの中から tegalog.cgifumycts.pl の2ファイルだけを抜き出して上書きアップロードして下さい。
データファイルや設定ファイルは、すべてそのまま引き継げます。(Ver.3以下も含む過去のどのバージョンからでも)

🆕 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名が出力されます。

cemojice-takoyaki-largece-takoyakice-large
cemojice-takoyaki_ikayaki-setce-takoyakice-ikayakice-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.cgifumycts.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 記法の仕様拡充。

《▼新機能:設定項目》
記述サンプルを自動入力するかどうかの設定項目と、文字色や背景色として自動入力するサンプル文字列の設定項目を追加。
●ログインフォームの下部に表示できるメッセージを設定画面で設定できる機能。
●ハッシュタグだとは認識されない「 # 」記号を簡単に表示させる方法として、「&#35;」を入力できる項目をハッシュタグ簡単入力プルダウンメニューに追加できる機能を追加。
●投稿本文中に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にいくつか存在していた文法ミスを修正。
リンクラベルの中に &#35; での # 記号が入っていても正しくラベルとして使えるよう仕様を修正。
「続きを読む」機能を入れ子にして使うと、ボタンラベルが正しく出力されないケースがある不具合を修正。


▼新機能:画像投稿関連
🌸新着画像リスト(最近UPされた画像の一覧)出力機能。
最近にアップロードされた画像だけの一覧を表示する「新着画像リスト」表示機能を追加しました。
画像保存用ディレクトリに存在する画像のうち、「一覧外」フラグが立てられていないすべての画像を対象に、新着順に指定個数だけ表示します。Twitterのプロフィールページ右上に見えるメディア欄のような感じの表示を作りたい場合に活用できます。
詳しくは、新着画像リストの設定方法などをご覧下さい。
表示例

新着画像リストの出力方法は、リファレンス内の【新着画像リスト要素】をご覧下さい。
新着画像リストの装飾に関する参考情報は、新着画像リストの装飾方法をご覧下さい。

標準添付スキンのうち(チャットタイプスキンを除く)8種類のスキンにも新着画像リスト用のHTML+CSSを加えてあります。標準添付スキンをそのままお使いの場合は、上書きアップロードすれば新着画像リストも表示されるようになります。もし、大きくカスタマイズしてお使いの場合や、独自のスキンを作ってお使いの場合には、標準スキンの下記の位置にあるソースをコピー&ペーストするなどしてご活用頂くと、標準スキンと同じ見た目を手っ取り早く実現できるでしょう。

✅まず、外側スキン(skin-cover.html)には、以下のようなHTMLを加えています。
うまく装飾するためには、[[IMAGELIST]] の外側に何らかのブロック要素を加えておく方が良いと思います。 下記では <p class="imagelistbox">~</p> で囲んでいます。
skin-cover.html の 131行目~141行目

✅次に、CSS(tegalog.css)では、以下のようなソースで装飾しています。 CSSソース内で ▼画像一覧リスト区画 という文字列を検索すると見つかります。この区画の中身をコピーするなどしてご活用下さい。
tegalog.css の 1057行目~1101行目
特に、画像サイズを調整している箇所は、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からのパスとして解釈するよう仕様改善。(従来は相対パスでの記述を求めていました)



▼新機能:設定項目
🌺記述サンプルを自動入力するかどうかの設定項目と、文字色や背景色として自動入力するサンプル文字列の設定項目を追加。
装飾ボタンを押した際に、記述サンプルや色名サンプルを自動入力するかどうか、自動入力する場合にデフォルトのサンプル色を何にするか等を設定できる機能を加えました。
詳しくは、記述サンプルを自動入力するかどうかの設定と、文字色や背景色として自動入力するサンプル文字列を設定する方法をご覧下さい。
設定位置

●ログインフォームの下部に表示できるメッセージを設定画面で設定できる機能。
てがろぐのログインフォーム(=ログインしていない状態で管理画面にアクセスしたときに最初に表示されるログイン画面)の下部に任意のメッセージを表示できる機能が以前からありましたが、これを管理画面の「設定」で登録しておける機能を加えました。
20230114141652-nishishi.png

●ハッシュタグだとは認識されない「 # 」記号を簡単に表示させる方法として、「&#35;」を入力できる項目をハッシュタグ簡単入力プルダウンメニューに追加できる機能を追加。
詳しくは、ハッシュタグにならない「 # 」記号を書きたい場合をご覧下さい。
設定位置

●投稿本文中にAmazonのURLが書かれたとき、自動で極力短く加工する機能を追加(標準ではOFF)。
Amazonの商品URLを自動で短くする機能を加えました。詳しくは、投稿本文中にAmazonのURLが書かれたとき、自動で極力短く加工する機能をご覧下さい。
設定位置


▼仕様改善
🌺拡大画像をLightboxで表示できるテキストリンクを作る記法に、「画像リンクに独自のclass属性値を追加する」と同じclass属性値も追加されるよう仕様改善。
画像を直接埋め込まずに、画像へのテキストリンクとして掲載しつつ、リンク先の画像はLightboxで見せたい場合の書き方 [リンクラベル:LB] の出力仕様を拡張し、data-属性ではなくclass属性に指定の記述が必要なスクリプトでも使えるようにしました。
詳しくは、画像を直接埋め込まずに、画像へのテキストリンクとして掲載しつつ、リンク先の画像はLightboxで見せたい場合の書き方をご覧下さい。

●全文検索の強調表示では、半角英字の大文字小文字が一致しなくても強調対象になるよう仕様改善。
従来は、(全文検索そのものでは大文字/小文字を区別しないものの)大文字/小文字が一致していないと強調表示はされませんでした。
例えば、投稿本文に「Sister」という英単語があり、検索語「sister」で検索した場合、
●従来は、検索にはヒットするものの強調表示はされませんでした。(先頭の大文字/小文字が一致しないため)
●今後は、検索にヒットする上、強調表示もされるようになります。

●上位ディレクトリを参照するパスで画像が指定されたときに、ファイルが見つからなければ注釈を含むエラーを表示するよう仕様改善。
本文中に画像を表示する記法で、[PICT:/hogehoge/hoge.png] などのように、スラッシュで始まる絶対パスで画像が指定されたときに、ファイルが見つからなければその旨をエラー表示するよう仕様を改善しました。
➡ 従来は、指定した位置に画像が存在しない場合でも、『何も表示されないimg要素』が出力されていました。それでは記述ミスに気付きにくいので、下図のようにエラーを表示するようにしました。
202301141414371-nishishi.png
また、本文中に画像を表示する記法で、[PICT:../../hogehoge/hoge.png] などのように、上位ディレクトリを参照するパスで画像が指定されたときに、ファイルが見つからなければ注釈を含むエラーを表示するよう仕様を改善しました。
➡ 従来は、『画像用ディレクトリにそのファイルはない』というエラーメッセージが表示されていましたので、まるで「相対パスの記述が認識されていない」かのように誤解されそうでしたので、その辺を明確に伝えるように改善しました。
20230114141437-nishishi.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行目付近:
20230114142549-nishishi.png
※上記の 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になっていた箇所を修正しました。

❎リンクラベルの中に &#35; での # 記号が入っていても正しくラベルとして使えるよう仕様を修正。
[ラベル]URL 記法を使ってテキストリンクを作るとき、ラベルの中に &#35; を記述していると正しくリンクラベルとして使えない不具合を解消しました。
なお、&#35; ではない # 記号そのものが含まれていると、それはハッシュタグとして認識されてしまうためにテキストリンクにはなりませんのでご注意下さい。

❎「続きを読む」機能を入れ子にして使うと、ボタンラベルが正しく出力されないケースがある不具合を修正。
指定範囲を隠せる「続きを読む」機能である [H: ~ ] 記法の中に、さらに [H: ~ ] 記法を含めて2階層以上の隠された範囲を作ると、うまく動作しない不具合を解消しました。何階層にも入れ子にしても大丈夫なように改善しています。


以上、ご活用頂ければ幸いです。

※不具合の修正も含んでおりますので、使いたい追加機能がない場合でもアップグレード頂くことをお勧め致します。(アップグレードしても、ログインし直す必要はありません。ログイン状態は維持されます。)

なお、開発進捗状況報告サイトでフォロー頂くと、てがろぐCGIの最新β版や正式版の公開時にメールで連絡を受け取ることもできますので、ぜひご活用下さい。(╹◡╹)ノ
フォロー数が増えると、私の開発モチベーションが向上するメリットもあります!!!🤩

:16393文字 修正

てがろぐ Ver 3.6.0 を公開しました! #Update

てがろぐ Ver 3.6.0 を公開しました。サイトマップページ出力機能、SITEMAP XML出力機能、カテゴリアイコンやカテゴリ概要文の表示機能、Spotify埋め込み機能などの追加が主な更新点です。その他、細かな機能追加や不具合修正を含んでいます。
https://www.nishishi.com/cgi/tegalog/

アップデートするには、tegalog.cgifumycts.pl の2ファイルだけ(※)を上書きアップロードして下さい。
データファイルや設定ファイルは、すべてそのまま引き継げます。(Ver.2以下も含む過去のどのバージョンからでも)

※標準添付スキンの各スキンも更新していますので、もし標準添付スキンをそのままご使用になっている場合は、それも上書きアップロードして下さい。標準添付スキンを使っていない場合や、使っていても独自にカスタマイズして使っている場合には上書きする必要はありません。従来のスキンのままでも、正常に動作します。新しい機能を使うには、今バージョンに添付されているスキンを参考にしてカスタマイズして下さい。
※今回のバージョンから新しく追加された「サイトマップページ」モード用の新スキン skin-sitemap を完全構成パッケージに同梱しています。サイトマップページモードをご使用になりたい場合は、完全構成のZIPから skin-sitemap フォルダを抜き出してアップロードしてご使用下さい。

🆕 Ver 3.6.0の更新点(概要):
サイトマップページを出力する機能を追加(タイトル一覧、目次ページとして活用可能)
サイトマップページを表示できるURLを出力するオプション記法 [[SITEMAP:URL]] と [[SITEMAP:URL:FULL]] を追加
カテゴリリンクで、サイトマップモードを維持したリンクが出力できる記法 [[CATEGORYLINKS:SITEMAP]] と [[CATEGORYLINKS:SITEMAP:FULL]] を追加
SITEMAP XMLを出力する機能を追加
カテゴリをアイコンで表示できる機能・カテゴリの概要文を表示できる機能を追加
カテゴリ登録時にアイコンURLも登録できる機能を追加
外側スキン用の [[CATEGORY:TREE:フラグ群]] の記述仕様を追加。(カテゴリツリーで「アイコン、カテゴリ名、概要文、該当件数」を自由な順序で表示可能にする機能を追加)
内側スキン用の [[CATEGORYLINKS:識別子:オプション]] の記述仕様を追加。(該当カテゴリの「アイコン、カテゴリ名、概要文」を自由な順序で表示可能にする機能を追加)
Spotifyの埋め込み機能を追加

ページ番号だけを単独で得られる記法 [[INFO:PAGENUM]] を追加
各投稿に「直接削除するリンク」も表示できる記法 [[DELETEURL]] を追加
サイトマップとして表示されるハッシュタグリンクを出力できるオプション [[COMMENT:TAGS:SITEMAP]] を追加
●管理画面の投稿記事一覧での表示件数を設定する機能を追加。(デフォルトは100件)
●Spotify埋め込みボタンの表示機能を追加。
●OGPの出力で「og:descriptionにもog:titleと同じ内容を出力する」オプション設定を追加。
●ハッシュタグに全角文字と半角文字を混ぜたときの角括弧を表示上では消す(見えなくする)機能を追加。
●ハッシュタグ簡単入力機能の先頭に『「#」記号だけを単独で入力できる項目』の追加機能を追加。

新スキン「サイトマップページ(skin-sitemap)」を追加
既存の各スキンに、カテゴリアイコン用の装飾CSSを追加
既存の各スキンに「サイトマップページ」用リンクを追加

不具合修正:
ギャラリーモードで、skin=パラメータを使って別スキンを適用しているとき、[[PARMAURL:PURE]] の記述を使っても、デフォルトスキンではなく、現在適用中のスキンが維持されてしまう不具合を解消。
一時適用中のスキンを適用しないリンクが出力されるハズの各記法、[[PARMAURL:PURE]]、[[USERURL:PURE]]、[[CATEGORYLINKS:PURE]] が、設定によっては正しく動作しなかった不具合を修正。
新着リスト(最近の投稿)の文字数表示で、大幅に値が増えてしまう不具合を修正。
投稿1行目に文字装飾記法やエスケープ記法等が含まれているとき、新着リスト(最近の投稿)でのタイトルの表示がおかしい(各種記法ソースがそのまま表示されてしまう)不具合を解消。


▼今回の大きな機能追加:
🌸サイトマップページを出力する機能を追加(タイトル一覧、目次ページとして活用可能)
投稿タイトル一覧、目次ページなどとしても活用可能な、サイトマップページ出力機能(サイトマップページモード)を搭載しました。
▼解説:
サイトマップページ用スキンを使って出力します。完全構成パッケージ(ZIP)内に、サイトマップページ用スキン skin-sitemap を同梱しています。それをアップロードして頂くと、概ね下図のように見えます。ブログのように活用している場合で、目次(タイトル一覧)を用意したい場合に特に役に立つと思います。
(キャプション自動取得対象外)
このスキンをベースにカスタマイズ頂くと編集しやすいかもしれません。ただ、サイトマップページ用スキンに特別な作り方はなく、その他のスキンと同じ方法で記述できます。詳しくは以下のカスタマイズ案内をご参照下さい。
サイトマップページ用スキンの作り方・使い方

▼付随新規機能:
✅サイトマップページを表示できるURLを出力するオプション記法 [[SITEMAP:URL]][[SITEMAP:URL:FULL]] を追加
リファレンス【表示モード要素】

✅カテゴリリンクで、サイトマップモードを維持したリンクが出力できる記法 [[CATEGORYLINKS:SITEMAP]][[CATEGORYLINKS:SITEMAP:FULL]] を追加
リファレンス【カテゴリ関連要素】

🌸SITEMAP XMLを出力する機能を追加
検索サイトのクローラー向けに用意するSITEMAP XMLの出力機能を搭載しました。不要な場合は出力しない設定にもできます。
▼解説:
特別なスキンは不要で、ただ出力する設定にするだけで出力できます。(デフォルトで出力する設定になっています。)
SITEMAP XMLモード
SITEMAP XML出力機能の設定方法

🌸カテゴリをアイコンで表示できる機能・カテゴリの概要文を表示できる機能を追加
カテゴリにアイコンを登録できるようになったほか、カテゴリツリーの表示内容(構造)や、投稿1つ1つの所属カテゴリの表示内容(順序)を自由にカスタマイズできるようになりました。従来は表示する方法がなかった「カテゴリ概要文」も表示対象に選べるようになりました。
▼解説:
カテゴリツリーや、投稿1つ1つのカテゴリ表示に関するカスタマイズ解説は、新たに新設したカテゴリ表示関連のカスタマイズ方法&装飾方法項目にまとめて記載していますのでご参照下さい。

(キャプション自動取得対象外)

▼付随新規機能:
✅カテゴリ登録時にアイコンURLも登録できる機能を追加しました。
カテゴリ設定画面

✅外側スキン(カテゴリツリー)で「アイコン、カテゴリ名、概要文、該当件数」を自由な順序で表示可能にするための [[CATEGORY:TREE:フラグ群]] の記述仕様を追加しました。
カテゴリツリー表示内容のカスタマイズ方法
カテゴリツリー内の掲載内容を指定できる識別子の書き方

✅内側スキン(投稿1つ1つに対する該当カテゴリ)で「アイコン、カテゴリ名、概要文」を自由な順序で表示可能にするための [[CATEGORYLINKS:識別子:オプション]] の記述仕様を追加しました。
各投稿に表示されるカテゴリ情報の取捨選択カスタマイズ方法(アイコンや概要の表示)

🌸Spotifyの埋め込み機能を追加
投稿本文中に、Spotifyの音楽(楽曲、アルバム、プレイリスト)をそのまま埋め込めるようになりました。
▼解説:
Spotifyアプリからシェア用のURLを取得して、専用記法で記述するだけで埋め込めます。専用記法は、ボタンクリックで入力することもできます。
Spotify音楽を埋め込む書き方

(キャプション自動取得対象外)


▼今回のその他の機能追加:
🌺ページ番号だけを単独で得られる記法 [[INFO:PAGENUM]] を追加
現在のページ番号が数値(プレーンテキスト)で挿入される記法を追加しました。
ページ番号だけをどこかに表示したい場合にお使い頂けます。主にスキンを深くカスタマイズなさりたい方々向けの記法です。例えば、既存の [[INFO:TARGETPOSTS]] と 今回追加した [[INFO:PAGENUM]] を使えば、「該当件数」と「ページ番号」の表示を自力で構成できます。
リファレンス【細かな情報要素】

例えばスキンHTMLに <span class="page[[PAGENUM]]">~</span> のように書いておけば、CSSを使うことで「1ページ目だけでしか表示されない区画」や「1ページ目だけは何も表示しない区画」なども作りやすくなるでしょう。

🌺各投稿に「直接削除するリンク」も表示できる記法 [[DELETEURL]] を追加
押すと削除確認画面へ直接移動できるリンクが作れる記法を追加しました。
備忘録やToDoリストなどのように、頻繁に削除もするメモとして使っている場合、「編集」ボタンの隣に、直接消せる「削除」ボタンも表示しておくと便利かもしれません。
各投稿に「編集リンク」だけでなく「直接削除するリンク」も表示する方法
リファレンス【投稿ID関連要素】

(キャプション自動取得対象外)

🌺サイトマップとして表示されるハッシュタグリンクを出力できるオプション [[COMMENT:TAGS:SITEMAP]] を追加
本文中に含まれるハッシュタグだけを抜き出せる記法 [[COMMENT:TAGS]] のバリエーションとして、リンク先がサイトマップページになるハッシュタグを作れる記法を追加しました。
あまり用途はないかも知れませんが。特定のハッシュタグが付けられた投稿に限定した目次とかを作りたい場合には役に立つかもしれません。^^;
リファレンス【投稿本文関連要素(オプション)】


▼その他の細かな機能改善:
管理画面の投稿記事一覧での表示件数を設定する機能を追加。(デフォルトは100件)
既存の投稿を一覧できる画面では、従来のバージョンでは1ページあたり100件固定で表示されていました。この件数を自由に設定できるようになりました。「500」を指定すれば500件ずつ表示されますし、充分大きな数を指定すれば全投稿を一覧することもできます。
投稿一覧画面のページ番号設定・表示件数設定

●Spotify埋め込みボタンの表示機能を追加。
Spotify音楽を埋め込むための専用記法を入力できるボタンは、デフォルトで表示されています。ボタンを非表示にしたい場合や、ボタンのラベルを変更したい場合は、管理画面の[設定]→[投稿欄の表示]→【リンクボタンの表示設定】→[表示するリンクボタンの選択]表内から自由に変更できます。
Spotify音楽を埋め込む書き方

(キャプション自動取得対象外)

OGPの出力で「og:descriptionにもog:titleと同じ内容を出力する」オプション設定を追加。
てがろぐ本文では「続きを読む」機能を使ってネタバレ部分を隠すことができますが、(TwitterやFacebook等のSNSにURLが書かれた際に表示される)OGPでは隠された部分も含めて全文の冒頭がそのまま表示されます。 それによって、本文ではネタバレを防げているのに、OGPの段階でネタバレしてしまう可能性があります。それを防ぐため、最大でも投稿本文の冒頭30文字しかOGPには含まれなくなる選択肢を追加しました。
OGPやTwitter Cardに見える本文でネタバレしてしまうのを防ぐOGP+Twitter Cardの設定方法

(キャプション自動取得対象外)

ハッシュタグに全角文字と半角文字を混ぜたときの角括弧を表示上では消す(見えなくする)機能を追加。
ハッシュタグが角括弧の存在で見栄えが悪いと感じる場合のために、角括弧を見えなく設定できるようになりました。この機能をONにすると、投稿時(編集時)には角括弧が必要ですが、実際のページ上では角括弧なしで表示されるようになります。(デフォルトではOFFです。)
ハッシュタグの角括弧を表示上では消す方法

ハッシュタグ簡単入力機能の先頭に『「#」記号だけを単独で入力できる項目』の追加機能を追加。
モバイル端末のソフトキーボードでは「#」記号の入力がやや面倒な場合があります。そこで、入力欄の下部にあるハッシュタグ簡単入力機能(既存のハッシュタグを再挿入できるプルダウンメニュー)の先頭に「 # 」記号だけを単独で挿入できる項目を追加できるようにしました。(デフォルトでは追加されていません。)
ハッシュタグ簡単入力機能の先頭に#記号だけを単独入力できる項目を追加する方法

(キャプション自動取得対象外)


▼スキンの追加:
🌻新スキン「サイトマップページ(skin-sitemap)」を追加
新機能サイトマップページモードのためのスキンを追加しました。完全構成パッケージ(ZIP)に含まれています。(最小構成パッケージには含まれていません。)
(キャプション自動取得対象外)

🌻既存の各スキンに、カテゴリアイコン用の装飾CSSを追加
標準添付の各スキンに、カテゴリアイコンをうまく表示するための装飾CSSを追加しました。
カテゴリアイコンが無駄に大きく表示されてしまうのを防ぐためのCSSを、標準添付の各スキンに加えました。標準添付スキンをそのままお使いの場合は、同梱のスキンファイルを上書きアップロードして下さい。(この装飾を使わなくても表示は可能です。ただ、この装飾がないと、カテゴリアイコンに指定された画像の実寸サイズが大きい場合には、そのまま原寸で表示されてしまいます。)

標準スキンでは、カテゴリツリー用の装飾として以下のようなCSSを加えてあります。(カテゴリアイコンの高さを1.2文字分に制限し、横幅を自動調整することで、画像の縮尺を維持したままテキストとほぼ同じサイズでアイコンを表示するための装飾です。)

カテゴリツリー用の追加装飾CSS例:
/* ………………………………………………………………………………………… */
/* ▼カテゴリツリー内の各要素(アイコン・カテゴリ名・該当件数・概要等) */
/* ………………………………………………………………………………………… */
/* ▽カテゴリアイコン */
.categoryTree .caticon img {
   height: 1.2em;         /* アイコンの高さを1.2文字分に制限する */
   width: auto;         /* アイコンの横幅は自動調整する */
   vertical-align: text-top;   /* アイコンの上端位置をテキストの上端に合わせる */
}

/* 間隔調整:カテゴリアイコンとカテゴリ名が並ぶ際には間隔を空ける */
.categoryTree .caticon + .cattext,
.categoryTree .cattext + .caticon {
   margin-left: 3px;
}

/* ▽該当件数 */
.categoryTree .num {
   display: inline-block;
   margin-left: 0.4em;
   font-size: 0.9em;
   color: #aaa;
}

/* ▽カテゴリ概要文 */
.categoryTree .catdescription {
   font-size: smaller;
   color: #555;
}
畳む

投稿1つ1つの所属カテゴリ表示用の装飾CSS例:
/* ▽カテゴリアイコン */
.categoryicon img {
   height: 1.2em;
   width: auto;
   vertical-align: text-top;
   margin: 0 1px;
}
畳む


標準添付の各スキンをそのままお使いの場合は、完全構成パッケージ(ZIP)に含まれている最新のスキンを上書きアップロードするのが簡単です。

🌻既存の各スキンに「サイトマップページ」用リンクを追加
標準添付の各スキン(ギャラリーモード用スキンと、チャットタイプスキンを除く)に、サイトマップページへのリンクを加えました。

#不具合修正
❎ギャラリーモードで、skin=パラメータを使って別スキンを適用しているとき、[[PARMAURL:PURE]] の記述を使っても、デフォルトスキンではなく、現在適用中のスキンが維持されてしまう不具合を解消。
❎一時適用中のスキンを適用しないリンクが出力されるハズの各記法、[[PARMAURL:PURE]]、[[USERURL:PURE]]、[[CATEGORYLINKS:PURE]] が、設定によっては正しく動作しなかった不具合を修正。
上記の2点は Ver 2.7.0 あたりから発生していた、長く気付かないまま放置されていた不具合でした。修正対応のご意見募集に答えて下さった方々に感謝致します。

❎新着リスト(最近の投稿)の文字数表示で、大幅に値が増えてしまう不具合を修正。
投稿本文内にリンク(任意リンクやハッシュタグリンク等)が含まれている際に、文字数表示が大幅に増えてしまう不具合を解消しました。

❎投稿1行目に文字装飾記法やエスケープ記法等が含まれているとき、新着リスト(最近の投稿)でのタイトルの表示がおかしい(各種記法ソースがそのまま表示されてしまう)不具合を解消。
1行目に文字装飾記法が含まれているとき、新着リストのタイトルとして「 C:yellowgreen 」のような記法のソースが表示されてしまう不具合を解消しました。


以上、ご活用頂ければ幸いです。

※不具合の修正も含んでおりますので、使いたい追加機能がない場合でもアップグレード頂くことをお勧め致します。(アップグレードしても、ログインし直す必要はありません。ログイン状態は維持されます。)

なお、開発進捗状況報告サイトでフォロー頂くと、てがろぐCGIの最新β版や正式版の公開時にメールで連絡を受け取ることもできますので、ぜひご活用下さい。(╹◡╹)ノ
フォロー数が増えると、私の開発モチベーションが向上するメリットもあります。(笑)

:7920文字 修正

DASHBOARD

■リリースノート内を検索:

■最近の投稿:

■その他のご案内:

▼現在の公開バージョン:

正式版:Ver 4.3.0
β版は適宜。)

▼ご質問やご要望がある場合:

ご質問やご要望がある場合は、動作テスト用てがろぐもご利用下さい。事実上のサポート掲示板にもなっておりますので。(^_^;)

編集

■日付検索:

▼現在の表示条件での投稿総数:

5件

このリリースノートも、てがろぐCGIを使って生成しています。
てがろぐCGIでページの生成に使用しているスキンファイルの実体は普通のHTMLファイルですから、一般のウェブページと同様の手順で自由に書き換えられます。

Powered by てがろぐ Ver 4.3.0.

--- 当サイト内を検索 ---