2003年12月23日
川俣晶の縁側ソフトウェアMagSite1開発日誌ダウンロード total 3224 count

MagSite1 Version 0.24

Written By: 川俣 晶連絡先

趣旨説明 §

 MagSite1自身のファイル配布をMagSite1自身で行うという実験です。

 MagSite1は、2003年12月23日現在、アルファテスト中で、アルファテスト希望者に対して無償で提供されています。

ダウンロード §

 以下のリンクよりダウンロードできます。

MagSite1 Version 0.24

前バージョンとの相違点 §

  • 最上位キーワードの権限を持たない一般ライター権限でコンテンツを削除できない問題を解消

readmeファイル内容 §

MagSite1(仮称) Readme File

Alpha-Test Version 0.24

2003年12月23日 Copyright (c) 2003 by Pie Dey Co.,Ltd.

● このファイルについて

 このファイルは、MagSite1(仮称) についての基本的な情報を提供します。

 このファイルは必ずお読み下さい。

● 概要

 小規模なウェブマガジンを少ない手間で作成します。

● アルファテストについて

 本ソフトはアルファテスト版です。全ての機能は実装されておらず、動作の保証もありません。将来の正規版は、リーズナブルな価格での有償提供となる予定です。アルファテスト版は無償で使用できます。

 2004年12月31日までの利用期限が設定されています。この日付を超えて利用することはできません。

● 対象ユーザー

 本ソフトは、IIS(Internet Information Server)およびASP.NETの管理運用が可能なスキルを持った管理者が設定することを前提に公開しています。このような特別な管理技能を持たないユーザーは、近い将来行われるであろうイースト株式会社が行う有償によるサービス提供機能(サーバ上にインストール済みの本ソフトを利用する形態)を利用することを推奨します。

● 動作環境

 ASP.NET (IIS5またはIIS6)

 .NET Framework 1.1

● 注意点

・ ファイルをアップロードする機能を実現するために、AdminWrite.aspxファイルでは、form要素のenctype属性を使用しています。そのため、IE6では動いても、IE5以前では動かないかも知れません。

・ 本ソフトの拡張子.aspxなどのファイルが存在するディレクトリの下に自動的に生成されるattachディレクトリと、resizeディレクトリを削除しないように注意して下さい。本ソフトをバージョンアップするために、削除して入れ替える場合などに、同時に削除してしまう危険があります。

● インストール方法

 サイト内の配置と関係するため、インストーラは作成していません。

 まず、本ソフトを配置するディレクトリを、IISの公開ディレクトリ内の適当な位置に作成します。また、このディレクトリには、エクスプローラなどを用いて、ASP.NETの権限で実行されるプログラムがファイルやディレクトリを書き込めるようにしておいて下さい。分からない場合は、(本来は好ましくありませんが)エクスプローラでEveryoneにフルコントロールを与えて下さい。

 アーカイブファイルを解凍後、用意したディレクトリに解凍したファイルを丸ごとコピーします。binディレクトリの内容が正しくコピーされている必要があります。

 次に、コントロールパネル内で、管理ツールのインターネットインフォメーションサービスを開きます。ここで、用意したディレクトリを、スクリプトの実行を可能とするように設定します。(初期状態では、同梱のWeb.configファイルにより、Adminで始まるファイル名のページはWindows認証を要求する設定になっています)

 そのままの設定で利用を開始すると、c:\MagSiteDataというディレクトリと、ファイルを置いたディレクトリ下にデータを保存します。c:\MagSiteDataを変更する場合は、以下のデータディレクトリのカスタマイズを参照して下さい。

● データディレクトリのカスタマイズ

 データディレクトリの初期値c:\MagSiteDataは変更することができます。

 本ソフトの拡張子.aspxなどのファイルが存在するディレクトリに、以下のようなXML文書をcustomize.xmlというファイル名で保存します。Windows 2000/XP/Server 2003のメモ帳で以下のような内容を作成して、UTF-8形式で保存すればOKです。

<?xml version="1.0" ?>

<settings xmlns="http://www.piedey.co.jp/ns/magsite1/customize">

<dataDirectory>d:\TestMagSiteData</dataDirectory>

</settings>

 dataDirectory要素の内容は、必要なディレクトリ名に書き換えて使用して下さい。

● 管理者認証について

 初期状態では、AdministratorというIDで認証した場合のみ、管理できるようになっています。これは、全ての管理が可能なマスターIDです。

 もし、AdministratorというIDでログオンできない場合は、以下の手順を取って、マスターIDを変更します。

 まず、通常のアクセス方法でWebブラウザからdefault.aspxファイルを表示されます。これで初期状態のデータディレクトリが作成されます。

 データを保存するディレクトリ(デフォルトではc:\MagSiteData)の下のauth\master.xmlファイルを、UTF-8を扱えるテキストエディタ(Windows XP等のメモ帳など)で開きます。そして、<id>Administrator</id>という部分を、<id>マスターIDとしたいID名</id>と書き換えて保存します。

 そのあと、IISのプロセスを再起動します。管理ツールのインターネットインフォメーションサービスで止めて開始させるだけでは不十分です。良く分からない場合は、サーバを再起動させて下さい。

 これで、マスターIDが変更されます。

 認証についての詳しい説明は、MagSite1開発日誌の以下のコンテンツを参照願います。

http://mag.autumn.org/content.aspx?id=20031222162438

● 初期設定

 Admin.aspxを開きます。認証は、Administratorまたは、マスターIDを変更した場合は、そのIDで行います。

 「このキーワードへの操作」の下にある[このキーワードの表示をカスタマイズする]をクリックします。

 キーワードのページ設定のページ設定が表示されます。ここに設定した内容は、今後追加される全てのキーワードの設定に反映されますので、適切に設定しておきます。(それぞれのキーワードごとに設定は上書きできます)

 このページで、少なくとも、サイトのタイトル(自由な名前を設定できます)、管理者の名前、管理者電子メールアドレス、ヘッダー文章(このサイトは何かを短く説明)、フッター文章(サイト利用上の注意点など)を設定して下さい。

 更に、メール送信機能で使用するSMTPサーバのホスト名を設定することを推奨します。これを設定すると、追加されたコンテンツの内容が管理者電子メールアドレス宛に送信され、確認することができます。

 設定するボタンを押すと、「処理結果のレポート」ページに移動します。エラーが起きていないことを確認してから、「このキーワードの管理ページ」のリンクをクリックします。

● 最初のコンテンツの作成

 そのままコンテンツを書き込むことができますが、通常はキーワードによるカテゴリ分けを行います。そのため、これから書き込もうとするコンテンツが所属するキーワードを、コンテンツ作成の前に行います。

 まず、Admin.aspxを開きます。

 「新しい下位キーワードの追加」の下に、新しい下位キーワードと、URLで使う短い名前を入力します。新しい下位キーワードはどのようなキーワードでも構いません。たとえば、「システム管理者からのお知らせ」「プレスリリース」「面白い話」「日記」といった文字列を指定します。URLで使う短い名前は、URLが長くなりすぎないように短い名前を半角アルファベットで指定します。通常利用者が読むものではないので、短い方が使いやすいと言えます。たとえば、「fromsys」「pressrel」「humor」「dialy」といった文字列を使います。

 (キーワードは変更できませんが、URLで使う短い名前はあとで変更できます)

 追加実行ボタンをクリックすると、「処理結果のレポート」に移ります。エラーが起きていないことを確認してから、「このキーワードの管理ページ」のリンクをクリックします。

 これで、たった今作成したキーワードの名前を含む「【▲→××××】の管理ページ」が表示されます。次に、[このキーワードに新しいコンテンツを追加する]のリンクをクリックします。これにより、コンテンツの作成ページが表示されます。

 「タイトル:」の右側に、コンテンツのタイトルを入力します。

 「本文:」の下の広いエリアに、本文の文章を入力します。

 入力が終わったら、確認ボタンをクリックします。(確認ボタンは2つありますが、どちらを使っても結果は同じです)

 内容が実際に利用者から読まれるのと同様のデザインで表示されるので、内容をチェックします。問題があれば、タイトルや本文を編集して、再度確認ボタンをクリックします。問題がなければ、「書き込む」ボタンをクリックします。

 再びキーワードの管理ページに戻ります。ここで「このキーワードのコンテンツ一覧」の下に、たった今作成したコンテンツのタイトルがあることを確認します。

 このタイトルをクリックすると、コンテンツを読むことができます。その右側の編集をクリックすると、再び編集することができます。削除をクリックすると削除することができます。

 これ以後、同様の手順で、コンテンツを追加することができます。また、必要に応じて、キーワードも追加することが出来ます。キーワードの下にキーワードを作成することもできます。

● コンテンツに画像を付加する

 まず、付加する画像ファイルを用意します。本ソフトでは、JPEGおよびPNG形式の画像ファイルのみに対応します。それぞれ、拡張子が.jpg、.pngでなければなりません。

 次に、コンテンツの作成ページで、コンテンツを入力します。そして、「添付ファイルの追加」の下の「ファイルの説明」に画像の見出しを入力します。「送信するファイルのフルパス」に送信するファイルのフルパス名を入力するか、参照ボタンを押してファイルを指定します。以上が終わったら、送信ボタンをクリックします。これでコンテンツに画像が付加されました。確認ボタンをクリックして、付加されたことを確認します。

 画像はいくつでも追加することができます。

● コンテンツにファイルを付加する

 コンテンツに何かファイルを付加して、利用者がダウンロード可能にすることができます。この手順は、画像ではないファイルを扱うことを除き、上記「コンテンツに画像を付加する」と全く同じです。

 ファイルはいくつでも追加することができます。

● コンテンツに添付されたファイルを管理する

 コンテンツの作成ページの下部にある「ファイルの管理」を用いて、添付ファイルに付加された名前の変更と削除ができます。

 名前を変更する場合は、リストから1つのファイルをクリックして選択し、新しい名前を入力後に、「選択したファイルの名前を新しい名前に変更」ボタンをクリックします。

 削除するには、リストから1つのファイルをクリックして選択し、「選択したファイルの削除」をクリックします。

● コンテンツ本文をMagMLで記述する

 本ソフト独自のコンテンツ記述言語、MagMLがあります。

 詳しい情報は、MagSite1開発日誌などを参照願います。

MagSite1開発日誌:

http://mag.autumn.org/default.aspx?s=magsite1

● コンテンツ本文をXHTMLで記述する

 コンテンツの作成ページで、ドロップダウンリストを開いて、XHTMLを選んで下さい。

 本文として、XHTMLで書き込むことができます。

 ページの大枠はシステム側で用意されていますので、html要素、body要素、head要素などは書き込むことはできません。p要素などを用いて内容を記述します。実際に用いられる際は、前後に<div>と</div>が付加されます。確認ボタンを押した際は、前後に<div>と</div>を付加した状態で整形式として正しいかどうかをチェックします。デフォルト名前空間URIはhttp://www.w3.org/1999/xhtmlが設定されるので、指定する必要はありません。

 コンテンツの作成ページの「XHTML化」ボタンをクリックすることで、XHTMLではないコンテンツの内容をXHTMLに変換することができます。(元に戻す方法はないので、ご注意下さい)

 現バージョンでは、スキーマを用いた詳細なチェックはサポートされていません。そのため、XHTMLとして正しくない文書を作成することもできます。

 本ソフトのXHTMLは、XHTML1.0 Strictです。

● コンテンツにAmazon.co.jpの商品情報を付ける

 コンテンツ作成ページで、ASINコードを5つまで指定することができます。Amazon.co.jpのサイトで、各商品の情報にASINコードと呼ばれる一連の記号が記述されています。このコードを指定することで、Amazon.co.jpの商品情報をコンテンツに付加することができます。この機能を使用した場合、利用規約上、そのページから他のオンライン販売サイトにリンクすることはできません。この機能は、Amazon.co.jpに顧客を紹介することと引き替えに、無償で商品情報を提供してもらう形になるので、Amazon.co.jpへの購入リンクを外すことはできません。

 ASINコードは書籍の場合ISBNコードと同一です。

● Amazon.co.jpの商品情報を付ける際、アソシエイト・プログラムを使う

 コンテンツにAmazon.co.jpの商品情報を付ける際、Amazonアソシエイト・プログラムのIDを指定することができます。IDは、各キーワードの管理ページより、[このキーワードの表示をカスタマイズする]を選び、Amazon アソシエイトIDの欄に入力後、「設定する」ボタンをクリックすることで設定されます。IDが設定された状態では、購入リンクの後ろに、(by Amazon Associate Program)の文字が付加されます。

● データのバックアップ (重要)

 本ソフトに書き込まれたデータは、以下の3つの場所に保存されます。バックアップする場合は、これらのディレクトリ下のファイルを全てワンセットの組としてバックアップして下さい。

 最初のものは、c:\MagSiteDataまたはデータディレクトリのカスタマイズで変更したディレクトリです。

 2番目のものは、本ソフトの拡張子.aspxなどのファイルが存在するディレクトリの下に自動的に生成されるattachディレクトリです。(送信された添付ファイルの保管用)

 3番目のものは、本ソフトの拡張子.aspxなどのファイルが存在するディレクトリの下に自動的に生成されるresizeディレクトリです。(サイズ変更された画像の保存場所)

● 一般読者としてコンテンツを読む

 利用者の立場で見るには、default.aspxを開きます。

 このページでは、「最近のコンテンツ一覧」「過去3日間に最も読まれたコンテンツ」「過去3日間に最も読まれたキーワード」「下位のキーワード一覧」などの情報が提供されます。

 ここで、キーワードをクリックすると、そのキーワードの表紙ページに移動します。キーワードの表紙ページは、そのキーワードとそのキーワードの下に作成されたキーワードに属するコンテンツのみが表示されます。たとえば、「男性向け」と「女性向け」という2つのキーワードを作成してコンテンツを作成している場合、「男性向け」というキーワードの表紙ページは、「女性向け」に属するコンテンツを表示しません。

 特定キーワードに属する全コンテンツのリストを見るには、キーワードの表紙ページ下部の「このキーワードのコンテンツ全リスト」のリンクをクリックします。

● RSSアグリゲーターを使用してコンテンツを読む

 表紙ページの下部にある「このキーワードのRSS1.0形式の情報」が指し示すURLを、RSSアグリゲーターに設定して下さい。特定キーワードの表紙ページのこのリンクを使用すると、そのキーワードとそのキーワードの下に作成されたキーワードに属するコンテンツの情報のみを含むRSS文書が提供されます。

● ファイルアップロード時のご注意

 コンテンツの作成ページが再読込されたとき、入力されたファイル名は消滅します。たとえば、ファイル名を入力後に確認ボタンを押した場合などは、入力したファイル名が消えてしまいます。ファイル名を入力した後は、すぐに送信ボタンを押すようにして下さい。

● 設定と運用の参考となるサイト

 本ソフトの開発者が、本ソフトを用いて運用している以下のサイトがあります。

 設定や運用の参考としてご覧下さい。

オータム マガジン:

http://mag.autumn.org/

● 変更履歴

2003年10月12日 Version 0.14 本ファイルが作成された最初のバージョン

2003年10月16日 Version 0.15 MagMLの実装完了 (MagML仕様書0.10)

2003年10月27日 Version 0.16 キーワード削除機能、アマゾン関係機能実装

2003年10月28日 Version 0.17 アマゾン情報でProductDescriptionを見せない

2003年10月28日 Version 0.18 Kビルド。アマゾンへのクエリをリトライさせる

2003年11月11日 Version 0.19 readme.txtの初期設定を書き直し

横120以下の画像のサムネールを正常に

入力されたASINコードをtrimする

「Amazon.co.jpより購入する」をもっと目立たせる

2003年12月 4日 Version 0.21 URL自動認識で~を一部として認識し、%7eに置き換える

添付ファイルは強制ダウンロードさせずに適切なMIME

タイプを指定する

RSS情報生成時、dc:subjectを出力し内容を改善

日付時刻にドラフトIDと重複する値を入れると、システ

ムが混乱して様々なエラーが起きる問題を解消

2003年12月22日 Version 0.22 readme.txtに、マスターIDのカスタマイズ及び復旧手順

を書く

キーワード削除実行のあとログアウトを選ぶと認証エラ

ーになる→ログアウトは認証しない

一般ライター権限の場合、一般ライター権限で行けない

場所へのリンクを作らない

WriteLib.WriteKeywordのテストでノーキーワードの時

はリンクを作らない

上位キーワードの一般ライターIDリスト作成

このキーワードの一般ライターID削除実行

このキーワードの一般ライターIDリスト作成

このキーワードの一般ライターID追加実行

管理者向けのフッタメニューにサインアウトを追加

このキーワードの一般ライターID追加UI

表紙ページの見出しで長いキーワードが折り返されて表

示されたときに上下の行が重なる

アクセス拒否が発生する場合はサインアウトする

権限のない管理ページはアクセスを拒否

マスター権限の書き換えUI

キーワード削除しても、短い名前を覚えたまま

Admin.aspx?kw=%e2%96%b2_%e3%83%86%e3%82%b9%e3%83%8

8のように指定すると存在しないキーワードの管理ペー

ジに入れてしまう

同じ名前、同じ短い名前のキーワードを作成できてしま

った

AdminResultを廃止してAdminFnに統合

一般ライター権限情報をdefファイルに追加

readme.txtに認証方法の変更を反映

web.configに認証を要求するドキュメントだけ指定

2003年12月22日 Version 0.23 spam対策としてメールアドレスを画像にする

2003年12月22日 Version 0.24 最上キーワードの権限を持たない一般ライター権限でコ

ンテンツを削除できない問題を解消

● 連絡先

 ご意見、バグレポートなどは、testml4メーリングリストまたは、株式会社ピーデーサポート宛にご送付下さい。

testml4メーリングリスト:

http://erika.piedey.co.jp:8088/1ml_main.html?MLID=testml4

株式会社ピーデーサポート:

softsupport@piedey.co.jp

● 利用許諾条件

(注:ここでいう本ソフトウェアとは、本パッケージに含まれる全実行ファイル、ヘルプファイル、オンラインマニュアルファイルを含むものとします)

 本ソフトウェアの著作権は、開発に使用したソフトウェアにより提供される部分を除き、株式会社ピーデーにあります。

 本ソフトウェアは、含まれるファイル内容、構成を変更しないことを条件に、自由に複写し、配布することができます。しかしながら、アルファテストという性格上、無制限に不特定多数に配布するサイトへの掲載は、お断りいたします。

 本ソフトウェアの使用期限は、本ソフトウェアの製品版発売後2ヶ月までとします。

 本ソフトウェアは、この条件を承諾したときのみ、利用できるものとします。

 本ソフトウェアを使用した結果については、弊社は一切責任を負いかねます。

以上