むぅたん - JavaScript MVC framework system

A.はじめに
B.特徴
C.製作環境
D.動作環境
E.いんすとーる方法
F.設定方法
G.簡単な使い方
H.注意点
I.よくある質問
J.その他の情報
K.こぴーらいと＆らいせんす


A.はじめに

 いろいろと探してみたけど，さーばさいどと切り離せなかったり，中を見てみたら
 ただのらいぶらりだったり，常駐してあどれすが変わるのを監視してたりって
 これというのが見つからなかったので創ってみましたです☆ヾ（・ｘ・。【みかん

---- >8 ---- きりとり ---- >8 ----

B.特徴

 1.XMLHttpRquest付きのJavaScriptをさぽーとしてるぶらうざなら動くはず
 2.でぃれくとりやあくしょん毎に設定を変更できるようになってますです
 3.おーぷんそーすなのでやな部分はこあでも書き換えおっけぃ
 4.pure JavaScriptってことで外部jsの置けるさ～ばならどこでも使えますです
 5.いちおう言語ふぁいる機能もあるから多言語に対応できるかも？
 6.たぶんきっといろいろと取替えがしやすくなってる・・・といいなぁ・・・
 7.HTMLはそのままにこあふぁいるを読み込むだけで使えるかも？

---- 8< ---- きりとり ---- 8< ----

C.製作環境

 OS       win2k,winXP
 ぶらうざ Firefox1.5 + FireBug + WebDeveloper
 えでぃた Eclipse + JSEclipse

 こんなかんじになってますです☆ヾ（・ｘ・。【みかん

---- >8 ---- きりとり ---- >8 ----

D.動作環境

 XMLHttpRequestをさぽーとしたJavaScriptが動くぶらうざならたぶんきっとだいじょ～ぶ☆
 ただ組み込みおぶじぇくとに手を出すようならいぶらりとは相性が悪そうにう・・・
 いちおう
 win2K + IE6,Firefox1.5
 winXP + IE7,Firefox1.5,Opera9,Netscape7,Netscape8
 で動作確認は取れてますです☆

---- 8< ---- きりとり ---- 8< ----

E.いんすとーる方法

 さーばの外部からあくせすできる場所に置いてhtmlふぁいるから

  <script id="mutanrootpath" type="text/javascript" src="http://localhost/mutan/core.js"></script>

 こんなかんじでIDを指定して読み込むだけ☆

---- >8 ---- きりとり ---- >8 ----

F.設定方法

 読み込んだHTMLふぁいるとおんなじでぃれくとりに"config.js"というふぁいる置くだけ☆
 最低限の中身は

  {
  }

 みたいにからっぽおぶじぇくとだけでおっけぃ☆
 それ以外の設定項目は

  項目名             内容
 ------------------------------------------------------------------
  actionPath         使用するあくしょんおぶじぇくとのでぃれくとり
  configPath         あくしょん毎に使用するこんふぃぐのでぃれくとり
  filterFile         使用するふぃるたおぶじぇくとのふぁいる名
  filterPath         使用するふぃるたおぶじぇくとのでぃれくとり
  language           使用する言語
  languageFile       使用する言語おぶじぇくとのふぁいる名
  languagePath       使用する言語おぶじぇくとのでぃれくとり
  languagesPath      使用する言語ふぁいるのでぃれくとり
  loggerFile         使用するろぐおぶじぇくとのでぃれくとり
  loggerPath         使用するろぐおぶじぇくとのでぃれくとり
  modelPath          使用するもでるおぶじぇくとのでぃれくとり
  onloadAction       ぺ～じが読み込みに起動するあくしょん名
  renderFile         使用するれんだーおぶじぇくとのふぁいる名
  renderPath         使用するれんだーおぶじぇくとのでぃれくとり
  requestFile        使用するりくえすとおぶじぇくとのふぁいる名
  requestPath        使用するりくえすとおぶじぇくとのでぃれくとり
  sysLangPath        使用するしすてむ言語ふぁいるのでぃれくとり
  useCustomConfig    あくしょん毎に設定を変更する？
  useCustomLanguage  あくしょん毎に言語ふぁいるを使用する？
  useDebug           でばっぐもーどを使用する？
  useDirConfig       でぃれくとり毎に設定を変更する？
  useDirLanguage     でぃれくとり毎に言語ふぁいるを使用する？
  validatorFile      使用するばりでーたおぶじぇくとのふぁいる名
  validatorPath      使用するばりでーたおぶじぇくとのでぃれくとり
 ------------------------------------------------------------------
  template           使用するてんぷれ～と（あくしょん内でも変更可）
  templatePath       てんぷれ～との入ってるでぃれくとり
 ------------------------------------------------------------------
  navigationString   なびげーしょんとして表示する文字列

 こんなかんじになってますです☆

---- 8< ---- きりとり ---- 8< ----

G.簡単な使い方

 1.まずはぱっけーじをだうんろーど＆解凍して以下の構成になっているかちぇっく☆

  + mutan
     + docs
     |  - api.txt
     |  - api-jp.txt
     |  - license.txt
     |  - license-jp.txt
     |  - readme.txt
     |  - readme-jp.txt
     + mutan
     |  + lang
     |  |  + en
     |  |  |  - system.js
     |  |  + jp
     |  |     - system.js
     |  + lib
     |  |  + abstract
     |  |  |  - abstractAction.js
     |  |  |  - abstractFilter.js
     |  |  |  - abstractModel.js
     |  |  |  - abstractValidator.js
     |  |  + core
     |  |  |  - domUtils.js
     |  |  |  - httpRequestUtils.js
     |  |  |  - mController.js
     |  |  |  - mUtils.js
     |  |  + interface
     |  |  |  - interfaceLogger.js
     |  |  |  - interfaceRender.js
     |  |  |  - interfaceRequest.js
     |  |  - filter.js
     |  |  - language.js
     |  |  - logger.js
     |  |  - validator.js
     |  + render
     |  |  - domRender.js
     |  |  - dummyRender.js
     |  |  - easyTemplateRender.js
     |  |  - formRender.js
     |  |  - hashRender.js
     |  |  - htmlRender.js
     |  |  - queryRender.js
     |  + request
     |  |  - dummyRequest.js
     |  |  - formRequest.js
     |  |  - hashRequest.js
     |  |  - queryRequest.js
     |  - config.js
     |  - core.js
     + sample
        + actions
        |  - helloWorldAction.js
        |  - onloadAction.js
        + configs
        |  - helloWorldConfig.js
        |  - onloadConfig.js
        + models
        |  - helloWorldModel.js
        |  - onloadModel.js
        - config.js
        - index.html
 なかんじになってたらおっけぃ☆

 2.ぶじに解凍できてたら
  /mutan/mutan
  /mutan/sample
  って２つのでぃれくとりをどきゅめんとるーとにせっと☆

 3."/sample/index.html"にれっつあくせす☆ヾ（・ｘ・。【みかん

 4."click"ってぼたんをくりっく☆

 5.ちょっと下に"Hello World"って表示が出たらてすと完了☆
   mController.doAction('あくしょん名');
  で指定したあくしょんを起動できるので，
   /sample/helloWorldAction.js
   /sample/helloWorldModel.js
  を見てなんとなくわかりそうなひとはいろいろ変更してみてくださいなです☆

 *どきゅめんとるーと以外に置いたときは
  /sample/index.html
 にあるぱすを書き換える必要がありますです☆

---- >8 ---- きりとり ---- >8 ----

H.注意点

 1.基本的にむぅたんからあくせすできるふぁいるはみんなが見れますです
 2.ということでぱすわーどみたいな大事なでーたは描かないでくださいです
 3.JavaScriptの制限上ろーかるのふぁいるはcookieぐらいしか触れませんです
 4.っていうかさーば上のふぁいるでもむぅたん単品では読み込み専用になりますです
 5.途中で読み込まれるすくりぷとは無名おぶじぇくととして記述してくださいです
 6.ascii以外の文字を使うときは文字こーどをUTF-8にしてくださいです
 7.JavaScriptおふなひとのことも忘れないでくださいです

---- 8< ---- きりとり ---- 8< ----

I.よくある質問

 Q1.変な英語
 A1.仕様で・・・っていうか翻訳さいとさんに聞いてくださいです（´ω｀；【みかん

 Q2.日本語も変
 A2.こっちも仕様・・・
  っていうかreadmeのほうがこ～どよりも大変なのです（つｘ；【みかん

 Q3.なんでこんな名称なの？
 A3.なんとなく

 Q4.こんな機能が欲しい
 A4.せっかくのお～ぷんそ～すなんだから自由に創ってくださいなです☆
  内容によってはお手伝いぐらいならできるかもしれないけど・・・

---- >8 ---- きりとり ---- >8 ----

J.その他の情報

 たぶんきっとここよりも
  SourceForgeのぷろじぇくとぺーじ(http://sourceforge.jp/projects/mutan/)
  むぅたんぷろじぇくとぺーじ(http://mutan.sourceforge.jp/)
  むうみんのぶろぐ(http://wishstar.info/blog/index.php?user_id=0&cat_id=43)
 あたりを探すとなにか見つかるかもしれませんです☆

---- 8< ---- きりとり ---- 8< ----

K.こぴーらいと＆らいせんす

 らいせんすはArtistic Licenseっておーぷんそーすのらいせんすになりますです☆
 詳しくは"/mutan/docs/license.txt"を見てくださいなです☆

 Copyright (C) 2006 Mumin Cacao


