ログインしてさらにmixiを楽しもう

コメントを投稿して情報交換!
更新通知を受け取って、最新情報をゲット!

テキスト音楽「サクラ」コミュの[Project]Sakura Referece Manual

  • mixiチェック
  • このエントリーをはてなブックマークに追加
 以前より、クジラ飛行机氏及び、みじんこ氏には構想を伝えてあるのですが、コミュニティーとして移す前に、こっちで土台を作った方がいいのかなぁ〜と。

 とりあえず、いま、雛型となるファイルを作成中です。
月刊サクラのサーバー借りちゃっていいですか?>みじんこさん

 MML研究会の後、adasさんにちょこっと見ていただいて、この機に、1年以上前から構想があったのだから始動しよう!と。
下のも、2003年12月にかいた文章ですが…。
───────────────────────────
■概要
 現状の使いにくいさくらのマニュアルを改善することを目的とします。
 私が使ってみた感じでは、その原因は検索性に優れないことであると思い、
そこで以下の改善案を提案します。皆様の意見をお待ちします。



■目的
 現状の使いにくいさくらのマニュアルを改善することを目的とします。
また、リファレンスマニュアルをもっと分かりやすくしよう試みです。

■改善案
 検索性に優れないのは、何故か?
1.目的の項目にたどり着くまでに多くのリンクをたどる必要がある。
2.大きなジャンル分けがされてなく、すべての命令が一列に並んでいる。

これらを改善するために、ツリー式のメニューを実装します。これによって、上記の事項が改善されるほかに、
・マニュアルの全体像が把握しやすくなり、目的の項目を探しやすくなる。
といったメリットがあると考えております。
 ツリーに関しては、JavsScriptという技術を使用しているため、
私がメインにやりますが、ここはこうした方が良い等の意見がありましたら、どんどん、提案して下さい。

 また、リファレンス・マニュアルの各命令の説明には、未完全なものも多く、同時にそれらの説明も解りやすいものに作り直そうというプロジェクトです。

■構想
<ページ構成>
・Command:直接的にMIDI(SMF)に影響する命令。
      音符、休符、コントロールチェンジ、テンポ
      エクスクルーシブ、メタイベント等
・Option :先行指定
・System :間接的にMIDI(SMF)に影響する命令。
      トラック、制御構想、システム・オプション
・Script :スクリプト用の命令
・Define :各種定義ファイルによって実装されている命令

ここから、小項目に展開し、各命令の一覧にリンクするとわけです。

コメント(15)

しまったーーーーーーーーーーーーーーーーーーーーーー。
どっちか、消せます?>管理人様
おおお!
とうとう、新解説ページプロジェクトの
スタートですかっ!!

一応・・・一人で作成するよりかは、
有志を、このコミュニティ内から募ってみてはいかがっすか?

一応、解説1ページにつき、書式を決めて・・・
もしくは雛形を作っておいて、
そこに書き込んで、ある場所に集めておくといった、
感じなど、どうでしょう???

とりあえず、コチラも、「一応」ひと段落したところで、
何か新しい「補助ソフト」の企画を発動させようかなぁ〜と
思っていたところなので、お手伝いできそうなものは、
やりたいとは思ってます〜〜。
いま、考えてる雛形はこんな感じです。
あとで、サーバーにアップして、色々環境を整備しようと思ってます。作業形態だとかも決めていかないとならないので。
色々、整ったら、作成用BBSだとかも立ち上げてやろうかなぁ〜と考えてます。


<!DOCTYPE HTML PUBLIC '-//W3C//DTD HTML 4.01 Transitional//EN'
'http://www.w3.org/TR/html4/loose.dtd'>

<html lang='ja'>

<head>
<meta http-equiv='Content-Type' content='text/html;charset=Shift_JIS'>
<meta http-equiv='Content-Style-Type' content='text/css'>
<meta name='ROBOTS' content='ALL'>
<meta name='keywords'
content='Sakura Reference Manual'>
<meta name='description'
content='Sakura Reference Manual'>
<meta name='GENERATOR' content='Microsoft Visual J++ 6.0'>
<meta name='ProgId' content='Visual J++.Editor.Document'>
<title>Sakura Reference Manual</title>
</head>

<BODY BGCOLOR='White' TEXT='Black' link='Olive' alink='yellow' vlink='silver'>
<!--[if gte mso 9]><xml>
<v:background id='_x0000_s1025' o:bwmode='white' fillcolor='#cf0'>
</v:background></xml><![endif]-->

<!-----------------------------------------------------------------------------
ツールバー(レイヤー2)
------------------------------------------------------------------------------>
<div class='Section2' id='Layer2'
style='position:absolute;left:16px;top:16px;width:640px;height:64px;z-index:2'>

<table bgcolor='#77FFFF'>
<tr><td width='640pt'><i>Sakura Reference Manual</i></td></tr>
<tr><td width='640pt'>
<a href='../index.html'>Top</a>\
<a href='index.html'>Note</a>\
</td></tr>
</table>
<!--(↑このコンテンツの位置。)-->

</div>
<!-----------------------------------------------------------------------------
コンテンツ本体(レイヤー1)
------------------------------------------------------------------------------>
<div class='Section1' id='Layer1'
style='position:absolute;left:16px;top:64px;width:640px;height:64px;z-index:1;'>

<h2>CommandXX</h2> <!--(コマンドの名前。)-->
<hr><!------------------------------------------------------------->
<h3>■概要</h3>
 この機能は、_______を実現する為に用います。<br>
 特徴として、_______。<br>
<!--(↑一目で内容が理解できる文章。詳細は不要。)-->
<br>


<br>
<h3>■書式</h3>
CommandXX( <font color='red'><i>value1</i></font>,
<font color='red'><i>value2</i></font>
);<br>
すととん( <font color='red'><i>value1</i></font>,
<font color='red'><i>value2</i></font>
)<br>
<!--(↑MMLとストトン両方書く。無ければどちらか。)-->

<br>
[備考]<br>
※この命令は、コンパイラ内部で以下のMMLに変換されます。<br>
Comand(<font color='red'><i>value1</i></font>); Comand; Comand;<br>
<!--(↑雛型として、一応書いておく。特にコンパイラ側で変換の無い場合は消す。)-->

<br>
<h3>■引数</h3>
<table border='1'>
<tr><td width='128pt'>引数名 </td><td width='512pt'>機能 </td></tr>
<tr><td><font color='red'><i>value1</i></font> </td><td>引数1の説明 </td></tr>
<tr><td><font color='red'><i>value2</i></font> </td><td>引数2の説明 </td></tr>
</table><br>


<br>
<h3>■返り値</h3>
無し<br>
<br>
_____の計算結果を、返り値に渡します。<br>
<!--(↑返り値がある場合は、こんなかんじ)-->
<br>

<br>
<h3>■説明</h3>
 ______を行います。<br>
<font color='red'><i>value1</i></font>で指定された値を、___________です。<br>
<!--(↑専門知識が無くても解るように、詳細を具体的に。)-->
<!--(図による説明も、ここで行う。ファイル名は、"コマンド名_xx.jpg"等)-->
<br>

<br>
<h3>■使用例</h3>
<table border='1'>
<tr><td width='640pt'>List.1 </td></tr>
<tr><td><pre>
TR(1) o4 l4 cdefgabc
</pre></td></tr>
</table><br>


<br>
<hr><!------------------------------------------------------------->
<h3>■関連項目</h3>
<table border='1'>
<tr><td width='128pt'>機能名 </td><td width='512pt'>概要 </td></tr>
<tr><td><a href='index.html'>ページ名</a> </td><td>機能の概要 </td></tr>
<tr><td><a href='index.html'>ページ名</a> </td><td>機能の概要 </td></tr>
</table><br>
<!--(↑このコマンドに関連するコマンドの一覧及びリンク。)-->

<br>
<table bgcolor='#77FFFF'>
<tr><td width='512pt'><i>Sakura Reference Manual</i></td>
<td width='128pt'><i>text2music</i></td></tr>
</table>

</div>
</BODY>
</html>
あと、各機能の説明で必要そうな項目って何でしょう?
こちらでも、色々練ってから、もうちょっと、形にしてみます。
 この雛形を本に、色々な人が作っていく、
ユーザーによるマニュアルを作ろうと思っているのですが、
(勿論、私も、コンテンツ作成側としても参加。)
どうやって、ファイルを共有する化だとか、バッティングへの対処など、色々悩んでいます。

 まぁ、まずは、フレームと雛形を、なんとか作ってみれば、案が出てくるかなぁ〜と思い、もうちょっと、こちらで進めてみます。
 コミュニティーに移す前に、mixiのコア?なサクラユーザーで話し合ってから、月刊サクラなり、独自企画なりに移そうと考えてます。

 まずは、オムニバスCD2優先で動きますので、実質的には8月末くらいから、動く感じでしょうか?
了解しやした〜〜。

と・・・短いですが(w
 ユーザーの視点からも反映する為と、ユーザーのレベルアップを兼ねて、
 サクラ・ユーザーにも広くお手伝いを頼もうと考えているのですが、
 データベース用意して、cgiでマニュアルを作ってしまうと、
 今後chm形式(ヘルプ等で使われる、コンパイル済みHTMLファイル)にするときに、
 変換できないので、HTMLファイルで作るしかないのですが、考えられる案としては、

(1) HTMLファイルを管理者に渡して、管理者がリンクを張る。
・作業バッティング等は、管理者が管理する。

(2) FTP等を用いて、各自にHTMLファイルを登録してもらう。
・これだと、複数の人が同じコンテンツを作った時に、片方の人が、
 もう片方の人のコンテンツを上書きして消してしまう可能性が懸念されます。
・案の段階では、以下の項目に分けているのですが、この項目でチームリーダーを決めてやる感じでしょうか?

   [+]Content
   ├1.)[+]MML Reference
   |  ├1-1.)[+]一般命令     …音符や、コントロールチェンジ等
   |  ├1-2.)[+]先行指定     …先行指定
   |  ├1-3.)[+]システム命令   …擬似命令・メタイベント等
   |  ├1-4.)[+]スクリプト    …スクリプト用の命令等
   |  └1-5.)[+]各種定義ファイル …定義ファイルによって提供される関数等
   |       ├ chord5.h や、gm.h 等、それぞれ項目を作って。
   └2.)[+]DLL Reference
      ├2-1.)[+]技術情報
      ├2-2.)[+]関数一覧
コマンドに関する事なんですが、合わせて使うケースが多いもの(関連項目というんでしょうか)の表記はどうでしょうか。人力が足りるかどうかという問題もありますが。(笑)

あとやはりサクラのコンセプトとして「簡単」という部分も見逃せないので、ストトン方面は書き方とかフォーマットなんかを違うものにするかどうか、なんてのも検討に値するのではないかなぁなんて思いますがいかがでしょうか。
CVS使うなら、Subversion(本家:http://subversion.tigris.org/ 日本語マニュアル等:http://subversion.bluegate.org/)がいいっすよ。
TortoiseSVN(http://tortoisesvn.tigris.org/)ってクライアントソフトが、エクスプローラーの右クリックメニュー型で使いやすいです。
いま、それを使って物書き連中と共同作業を試験中です。
 ちらっと、高見さんのリンクを見てみたんですけど、良いですね。時間があるときにいじってみます。


 とりあえず、文書の構造はこんな感じでしょうか。
これを基にある程度の雛型は出来上がっているのですが、
もう少し詰めてみてから、HPに試験的にアップしてみます。
夏コミ後に、HTMLに整形してみます。
 アイデアが思い浮かんだ時に書かないと忘れるので
とりあえず、書いた的なものです。




■MML Reference
━━━━━━━━

 1.一般命令     …音符や、コントロールチェンジ等
───────────
 ※直接、MIDI楽器に影響を与える命令

(1) 音符
  ◆概要
  ◆命令一覧
    ・音符 …c,d,e,f,g,a,b
    ・休符 …r
    ・音符属性 …l,o,p,q,etc..

(2) ポリフォニック・キープレッシャー
  ◆概要
  ◆命令一覧

(3) コントロールチェンジ
  ◆概要
    ・GM-Level.1,2との対応表。
  ◆命令一覧
      ※0x00のバンクから、全て、表を作るり、各機能の説明。
       サクラのコマンドとの対応表も作成する。
    ・yn,n
    ・EP(n)
    ・P(n)
    ・V(n)
    ・etc..

(4) プログラムチェンジ
  ◆概要
    ・GM-Level.1で定義されている音色表
    ・GM-Level.2で定義されている音色表
  ◆命令一覧
    ・@

(5) チャンネル・キープレッシャー
  ◆概要
  ◆命令一覧

(6) ピッチベンド
  ◆概要
  ◆命令一覧
   ※さくらでは、cc256であることも説明する。

(7) システムエクスクルーシブ
  ◆概要
    ・GM-Level.1で定義されているエクスクルーシブ一覧
    ・GM-Level.2で定義されているエクスクルーシブ一覧
  ◆命令一覧



 2.先行指定     
───────────
(1) 概要
(2) 命令一覧
  ・onNoteWave
  ・onNoteWaveEX
  ・etc..
   ※グラフも積極的に使う。



 3.システム命令   
───────────
(1) 概要
(2) 命令一覧



 4.スクリプト    
───────────
(1) 概要
(2) 命令一覧



 5.各種定義ファイル …定義ファイルによって提供される関数等
───────────
(1)
  ◆概要
  ◆命令一覧

(2)gm.h
  ◆概要
  ◆命令一覧

(3)gs.h
  ◆概要
  ◆命令一覧

(4)xg.h
  ◆概要
  ◆命令一覧

(5)etc..
http://e-jts.com/~fg/Sakura/index-f.html

とりあえず、ちょこちょこと作ってみた感じです。
リンク切れまくってます。

一番簡単なのは、htmlファイルをメールで送ってもらうことかなぁ。そして、僕がリンクを張ると。

提案などあったら、よろしくです。
各項目に関するページの雛形は、

3.に書いてある通りで・・・って感じで決定ですか?

まぁ・・・仮にこのままプロジェクトを起こすとして・・・

ファイルが送られる管理者側の負担が大きいように思えますねぇ・・・

となると、小グループに分けて、
それぞれの小グループ管理者にファイルをそれぞれのグループメンバーが渡し、
それを、管理者へ送るってのが一番良いかな・・と考えてみたんすけど、
これって、やっぱり人数がそれなりに集まらないときついっすよね・・・。
いっそのことロリポップあたりに安い300M借りてwiki突っ込んでやっちゃうとかダメでしょうか。w

ライブドアのwikiで試しに立ててみたら、二階層のカテゴリが既にデフォルトで決まっちゃってるし…(これでは役に立たないではないか)

xoopsは設定まわりがよく出来て「おっ」て思ったんですが、逆に設定が面倒で小回りが利かないかも。
最近、質問掲示板を良く見てると、
・MIDI規格
・GM規格

の説明が必要に感じ、まず、そちらから手を付けてみることにしました。関連項目のリンク張り作業などもあるので、仕事の合間にでも、コツコツ進めてみます。

http://www.george24.com/~sha_n/sakura/index-f.html



そのうち、掲示板つくって、文章だけでも、投稿して貰おうかしら。

ログインすると、みんなのコメントがもっと見れるよ

mixiユーザー
ログインしてコメントしよう!

テキスト音楽「サクラ」 更新情報

テキスト音楽「サクラ」のメンバーはこんなコミュニティにも参加しています

星印の数は、共通して参加しているメンバーが多いほど増えます。