Serene Bach | ヘ�E徂嬾�

TIPS

項目

複数のSerene Bachを設置す�E/a>

ウェブ�前コンテンツを全て動的に出力す�E/a>

管理画面の自動�前イ�E/a>

Serene Bach自体はMovable Typeのような複数ウェブ�前笹椪機能をサポートしていません。複数のウェブ�前を管理したい�E隋△修諒��Serene Bachを設置す�E�廚�△蠅泙后�

複数のSerene Bachを設置す�E檗△修�E召�E�Serene Bachに対して、lib/, ext/, doc/, plugin/ を用意しても構�E覆い里任垢��韻献侫．ぅ�E鯤未両�E蠅砲い�弔眞屬�里肋蘢垢任垢掘▲弌璽献腑鵐▲奪廚砲蘯�E屬��蠅泙后�

Serene Bachではlib/, ext/, doc/, plugin/ を共有して利用す�E伝箸澆鰺儖佞靴討い泙后�泙拭��召垢�E覆蕕� lock/ も共有して利用できます。

ここでは具体例を挙げながら、各ディ�E�肇蠅鯤�瑤�Serene Bachで共有化す�E�，砲弔い得睫世靴泙后�

以下のような構成を想定します。

/public_html/sb0/と/public_html/sb1/に設置す�E�
lib/, ext/, doc/, plugin/をそ�E召�Eq>/public_html/内に置く。

ディ�E�肇�E柔�楼焚爾里茲Δ砲覆蠅泙后�

/public_html/

sb0/

index.html

style.css

admin.cgi

sb.cgi

cnt.cgi

mb.cgi

init.cgi

addlib.cgi

data/

log/

img/

lock/

sb1/

index.html

style.css

admin.cgi

sb.cgi

cnt.cgi

mb.cgi

init.cgi

addlib.cgi

data/

log/

img/

lock/

doc/

lib/

ext/

plugin/

sb0/とsb1/の中に置か�E討い�Eq>addlib.cgiというファイ�E肪淼椶靴討�世気ぁ�海離侫．ぅ�E惑柯曠◆璽�ぅ屬砲牢泙泙�E討い泙擦鵝�

addlib.cgiの中身は以下のようになります。

use lib qw(../lib ../lib/lang ../ext);
1;

適当なテキストエディタで上記の内容を保存します。ここで../libとなってい�E里�sb.cgiから見たlib/ディ�E�肇蠅琉銘屬砲覆蠅泙后�

今回の例ですと、sb0/とsb1/に置くaddlib.cgiの内容は全く�E�E嚢修い泙擦鵝�

続いて、init.cgiの設定を見てみます。

今回の例で、/public_html/がウェブ上ではhttps://www.example.com/でアクセスでき�E箸靴泙靴腓Α�

sb0/に置か�E�init.cgiの設定は以下のようになります。

DataDir ./data/
DataSuffix .cgi
HelpSrv https://www.example.com/doc/
TempSrv https://www.example.com/lib/resource/
TempDir ../lib/resource/
WeblogId sb0
PluginDir ../plugin/

HelpSrv, TempSrv, TempDirなどは標準のinit.cgiでは設定さ�E討い覆す猝椶任垢�▲悒�E廛疋⑤絅瓮鵐箸箚浜�萍未罵�僂気�E討い�E菫�E僉璽弔魘ν④垢�E櫃防�廚砲覆蠅泙后�

WeblogIdは複数のSerene Bachを設置した際に、そ�E召�E�Serene Bachで管理画面のCookie情報を混同しないようにす�E燭瓩里發里任后�

sb1/に置か�E�init.cgiの設定もほとんど�E�E任后０曚覆�E��魘�瓦靴討い泙后�

DataDir ./data/
DataSuffix .cgi
HelpSrv https://www.example.com/doc/
TempSrv https://www.example.com/lib/resource/
TempDir ../lib/resource/
WeblogId sb1
PluginDir ../plugin/

以上の設定で、複数のSerene Bachで各ディ�E�肇蠅魘ν④垢�E海箸�椎修任后４超㍉瀋蠅覆匹呂修�E召�E�Serene Bach毎に保存さ�E泙后�

Serene BachではScriptPathは必須の設�E猝椶任呂△蠅泙擦鵝�ScriptPathの設定はインストーラで設定す�E海箸�任④泙后�

ウェブ�前コンテンツを全て動的に出力す�E/h3>

保存形式を「None」に設定していても、Serene Bachではトップページ(index.html)を静的に出力します。

Serene Bachではトップページも含めて全てのページを動的出力に切�E悗┐�E海箸皺椎修任后７搬單渡辰�蕕離▲�札垢鮗�鞍淑未気擦燭い茲Δ幣�E腓僕Ⅳ悊扮人冓�，砲覆蠅泙后�

以下のような�E腓砲覆蠅泙后�

sb.cgiの名前を「inidex.cgi」に変え�E/li>
index.htmlの名前を適当な名称に変更す�E/li>
init.cgiにMainScriptとTopIndexの設定を追加す�E/li>
.htaccessの設定を行う
保存形式を「None」に設定す�E/li>

1番目と2番目の設定は念のためです。また、4番目の設定は環境によっては必要ありません。

sb.cgiの名前を「index.cgi」に変更します。こ�E魯肇奪廛據璽犬離▲�札浩茲髻�index.html」という静的なファイ�E�薀好��E廛箸棒擇�E悗┐�E燭瓩硫悉猗�任后�

index.htmlの名前を例えば、「dummy.html」の名前にしておきます。Serene Bachではトップページ用のファイ�E�覆い抜浜�萍未妊┘蕁爾砲覆辰討靴泙Δ燭瓠▲瀬漾爾離侫．ぅ�E��廚砲覆蠅泙后�

1番目と2番目で行った名称変更の設定を反映させ�E燭瓠�init.cgiの設定を変更します。上述の例の�E隋�

MainScript index.cgi
TopIndex dummy.html

を追加します。TopIndexは変更後のindex.htmlの名称を指定します。

環境によっては必要ありませんが、Serene Bachを設置したディ�E�肇蠅�.htaccessを以下のように設定します。

DirectoryIndex index.cgi

この設定でウェブサーバ上のディ�E�肇�E▲�札浩茲�index.cgiにす�E海箸�任④泙后�

記事の固�E�E鵐�鯑暗�侘呂里發里砲垢�E燭瓩法∧歛厳措阿髻�None」にす�E�廚�△蠅泙后�

管理画面の自動�前イ�E/h3>

管理画面にアクセスした際、通�E暠哀ぅ鷁萍未�充┐気�E泙后�

Serene Bachでは標準で管理ユーザ情報をCookieとしてブラウザに保存していますので、管理画面のアクセス方法を若干修正す�E弌▲暠哀ぅ鷁萍未鯣瑤个垢海箸�任④泙后�

管理画面に対して、例えば、https://www.example.com/sb/admin.cgiでアクセスしてい�E�E隋△海離▲疋�E垢�Eq>https://www.example.com/sb/admin.cgi?__mode=statusに変更します。

管理画面のCookie有効�E崙發任△�E弌▲暠哀ぅ鷁萍未鯣瑤个靴謄好董璽織慌萍未飽楾圓靴泙后�

通�E�Serene Bachの管理画面のCookie有効�E屬�1�E棒瀋蠅気�E討い泙后�海�E鯤儿垢靴燭ぞ�E隋⇔磴┐弌⇒Ⅳ昀�E屬�E�E棒瀋蠅靴燭ぞ�E腓蓮�init.cgiに以下のような設定を追加します。

AdminCookieDay 7

XML-RPC APIについて

以下のXML-RPCメソッドをサポートしています。

blogger.newPost
blogger.editPost
blogger.getRecentPosts
blogger.getUsersBlogs
blogger.getUserInfo
blogger.deletePost
metaWeblog.getPost
metaWeblog.newPost
metaWeblog.editPost
metaWeblog.getRecentPosts
metaWeblog.newMediaObject
mt.getCategoryList
mt.setPostCategories
mt.getPostCategories
mt.getRecentPostTitles
mt.publishPost
mt.supportedMethods
mt.supportedTextFilters
sb.getMediaObjectList
sb.getMediaObject
sb.deleteMediaObject

Serene Bachの仕様と適合しない�E瑤離僖薀瓠璽燭鰐技�E気�E泙后�XML-RPC APIを利用す�E海箸砲茲蝓�XML-RPCクライアントからウェブ�前を更新す�E海箸�椎修任后�

blogid ならびに appkey は Serene Bach では利用さ�E泙擦鵝Ｇぐ佞諒源﨓鵑鮖慊蠅垢�E海箸�任④泙后�

XML-RPC APIのエンドポイントは管理用スク�E廛�(admin.cgi)のアド�E垢砲覆蠅泙后�

blogger.newPost

機能: 新しい記事を�E討靴泙后�
引�E/dt>: appkey [string], blogid [string], username [string], password [string], content [string], publish [boolean]
返値: 成功す�E筏Ⅶ�ID(string)を返します。

blogger.editPost

機能: 記事ID(postid)の記事を上書きします。
引�E/dt>: appkey [string], postid [string], username [string], password [string], content [string], publish [boolean]
返値: 成功す�E�trueを返します。

blogger.getRecentPosts

機能

Serene Bachに�E討気�E慎Ⅶ�琉�E�鮗萋世靴泙后�

引�E/dt>

appkey [string], blogid [string], username [string], password [string], numberOfPosts [int]

返値

取得に成功した記事の数だけ記事情報を含んだ構造体の配列を返します。

補足

記事情報は以下の項目を含みます。

dateCreated [dateTime.iso8601]
userid [string]
postid [string]
content [string]

blogger.getUsersBlogs

機能

ユーザーが�E堂椎修淵ΕД屮暠阿両霾鵑鮗萋世靴泙后�

引�E/dt>

appkey [string], username [string], password [string]

返値

�E堂椎修淵ΕД屮暠鮎霾鵑旅渋ぢ里魎泙鵑税枸�ESerene Bachの�E腓劼箸�)を返します。

補足

ウェブ�前情報は以下の項目を含みます。

url [string]
blogid [string]
blogName [string]

blogger.getUserInfo

機能

ユーザーの情報を取得します。

引�E/dt>

appkey [string], username [string], password [string]

返値

ユーザー情報の構造体を返します。

補足

ユーザー情報は以下の項目を含みます。

userid [string]
firstname [string]
lastname [string]
nickname [string]
email [string]
url [string]

blogger.deletePost

機能: 記事ID(postid)の記事を�E�E靴泙后�
引�E/dt>: appkey [string], postid [string], username [string], password [string], publish [boolean]
返値: 成功す�E�trueを返します。

metaWeblog.newPost

機能

新しい記事を�E討靴泙后�

引�E/dt>

blogid [string], username [string], password [string], content [struct], publish [boolean]

返値

成功す�E筏Ⅶ�ID(string)を返します。

補足

content [struct]は以下の項目を含みます。

title [string]
description [string]
dateCreated [dateTime.iso8601]
mt_allow_comments [int]
mt_allow_pings [int]
mt_convert_breaks [string]
mt_text_more [string]
mt_excerpt [string]
mt_keywords [string]
mt_tb_ping_urls [array]

metaWeblog.editPost

機能

記事ID(postid)の記事を上書きします。

引�E/dt>

postid [string], username [string], password [string], content [struct], publish [boolean]

返値

成功す�E�trueを返します。

補足

content [struct]は以下の項目を含みます。

title [string]
description [string]
dateCreated [dateTime.iso8601]
mt_allow_comments [int]
mt_allow_pings [int]
mt_convert_breaks [string]
mt_text_more [string]
mt_excerpt [string]
mt_keywords [string]
mt_tb_ping_urls [array]

metaWeblog.getPost

機能

記事ID(postid)の記事情報を取得します。

引�E/dt>

postid [string], username [string], password [string]

返値

成功す�E筏Ⅶ�霾鵑旅渋ぢ里鯤屬靴泙后�

補足

記事情報は以下の項目を含みます。

dateCreated [dateTime.iso8601]
userid [string]
postid [string]
title [string]
description [string]
link [string]
permaLink [string]
mt_allow_comments [int]
mt_allow_pings [int]
mt_convert_breaks [string]
mt_text_more [string]
mt_excerpt [string]
mt_keywords [string]

metaWeblog.getRecentPosts

機能

Serene Bachに�E討気�E慎Ⅶ�琉�E�鮗萋世靴泙后�

引�E/dt>

blogid [string], username [string], password [string], numberOfPosts [int]

返値

取得に成功した記事の数だけ記事情報を含んだ構造体の配列を返します。

補足

記事情報は以下の項目を含みます。

dateCreated [dateTime.iso8601]
userid [string]
postid [string]
title [string]
description [string]
link [string]
permaLink [string]
mt_allow_comments [int]
mt_allow_pings [int]
mt_convert_breaks [string]
mt_text_more [string]
mt_excerpt [string]
mt_keywords [string]

metaWeblog.newMediaObject

機能

ファイ�E鬟機璽个謀樵�靴泙后�

引�E/dt>

blogid [string], username [string], password [string], file [struct]

返値

転送したファイ�E� url を返します。

補足

file [struct]は以下の項目を含みます。

bits [base64]
name [string]
type [string]

mt.getCategoryList

機能

ウェブ�前に設定さ�E織�謄乾蝓式�E�鮗萋世靴泙后�

引�E/dt>

blogid [string], username [string], password [string]

返値

カテゴリー情報を含んだ構造体の配列を返します。

補足

カテゴリー情報は以下の項目を含みます。

categoryId [string]
categoryName [string]

mt.setPostCategories

機能

記事ID(postid)のカテゴリーを設定します。

引�E/dt>

postid [string], username [string], password [string], categories [array]

返値

成功す�E�trueを返します。

補足

categories [array]の各項目は以下の項目を含む構造体です。

categoryId [string]
isPrimary [boolean]

mt.getPostCategories

機能

記事ID(postid)のカテゴリーを取得します。

引�E/dt>

postid [string], username [string], password [string]

返値

その記事に設定さ�E織�謄乾蝓湿霾鵑魎泙鵑盛渋ぢ里稜枸鵑鯤屬靴泙后�

補足

カテゴリー情報は以下の項目を含みます。

categoryId [string]
categoryName [string]
isPrimary [boolean]

mt.getRecentPostTitles

機能

Serene Bachに�E討気�E慎Ⅶ�琉�E�鮗萋世靴泙后�

引�E/dt>

blogid [string], username [string], password [string], numberOfPosts [int]

返値

取得に成功した記事の数だけ記事情報を含んだ構造体の配列を返します。

補足

記事情報は以下の項目を含みます。

dateCreated [dateTime.iso8601]
userid [string]
postid [string]
title [string]

mt.publishPost

機能: 指定した記事とトップページを再構築します。
引�E/dt>: postid [string], username [string], password [string]
返値: 成功す�E�trueを返します。
補足: Serene Bachでは指定した記事のステータスは変更さ�E泙擦�E非公開記事は非公開のまま)。トップページは再構築さ�E泙后Ｊ歛厳措阿砲茲辰討狼Ⅶ��泙泙�E�Etmlファイ�E鮃獣曚慶召靴泙后�

mt.supportedMethods

機能: Serene Bachがサポートしてい�E瓮愁奪桧�E�鮗萋世靴泙后�
引�E/dt>: なし
返値: サポートしてい�E瓮愁奪匹稜枸鵑鯤屬靴泙后�

mt.supportedTextFilters

機能: 該当ウェブ�前でサポートしてい�E謄⑤好肇侫��E唇�E�鮗萋世靴泙后�
引�E/dt>: なし
返値: サポートしてい�E謄⑤好肇侫��E疹霾鵑稜枸鵑鯤屬靴泙后�

sb.getMediaObjectList

機能

アップ�充ドさ�E討い�E菫�E侫．ぅ�E�E�鮗萋世靴泙后�

引�E/dt>

blogid [string], username [string], password [string], numberOfObjects [int]

返値

アップ�充ドさ�E討い�E菫�E侫．ぅ�E霾鵑稜枸鵑鯤屬靴泙后�

補足

画�E侫．ぅ�E霾鵑楼焚爾旅猝椶魎泙澆泙后�

objectid [string]
dateCreated [dateTime.iso8601]
name [string]
url [string]

sb.getMediaObject

機能: アップ�充ドさ�E討い�E菫�E侫．ぅ�E鮗萋世靴泙后�
引�E/dt>: blogid [string], objectid [string], username [string], password [string]
返値: 指定さ�E寝菫�E侫．ぅ�E�base64でエンコードした内容を返します。

sb.deleteMediaObject

機能: アップ�充ドさ�E討い�E菫�E侫．ぅ�E鮑�E�E靴泙后�
引�E/dt>: blogid [string], objectid [string], username [string], password [string]
返値: 成功す�E�trueを返します。
補足: サムネイ�E菫�E�△�E�E隋▲汽爛優ぅ�E菫�E眛瓜�忘�E�E靴泙后�

あま�E鬚卜�燭覆ね儻�E�

ウェブ�前: ウェブ�前はウェブ上に綴ら�E燭△�E�海靴慎Ⅶ��(�E④覆�)を称す�E海箸�燭い茲Δ任后�屮暠阿噺鴇里気�E�E海箸發△蠅泙后�
エントリー: 個別の記事のことをSerene Bachではエントリーと呼ぶことがあります。
コメント: Serene Bachでは登録さ�E慎Ⅶ�紡个靴同寨�圓�灰瓮鵐箸魎鵑擦�E海箸�侏茲泙后�
トラックバック: あ�EⅦ�E元記�Eに対して言及した記事があった�E隋�亀Ⅶ�紡个靴童正擇靴燭海箸鯣昭�暗�膨銘里垢�E伝箸澆任后８亀Ⅶ��藐正攀Ⅶ�紡个靴銅�暗�縫�E鵐��修蕕�E�E海箸�燭い茲Δ任后�
JUGEM