- 追加された行はこの色です。
- 削除された行はこの色です。
[[FrontPage]]
[[FrontPage]] > かぎマニュアルズ
なによりも,有志メンバーのやる気を優先してください.興味がある分野,
#contents
* はじめに [#uf42f830]
なによりも,各メンバーのやりたいことを優先してください.興味がある分野,
最近勉強した分野で面白いなと思ったものを,記事として投稿してくだされ
ばいいなと考えています.文体や難易度,説明の分かりやすさなどはあまり
ばいいなと考えています.
文体や難易度,説明の分かりやすさなどはあまり
ばらつきがないほうが望ましいですよね.今まで物理のかぎしっぽに存在し
ている記事が,あるいは一つの指標となるかもしれません.
ている記事が,あるいは一つの指標となるかもしれません
(が,基本的に自由になさって構いません).
# が,基本的に自由になさって構いません
* 流れ [#u16271dc]
記事投稿の流れとしてはつぎのようなものが考えられます
プロジェクトメンバー書いた記事を公開するまでの,
具体的な手順を説明します.
1. こんな記事はどう?の提案
** おおまかな流れ [#pd69353d]
2. 実際に記事を書く
* 書き上がったらMLにて知らせる
* 途中で飽きたら誰かに引き継いでもらう
記事投稿全体の流れとして,つぎのようなものを考えています.
3. サーバにアップ,公開
+ こんな記事はどう?の提案
+ 実際に記事を書く
++ 書き上がったらMLにて知らせる
++ 途中で飽きたら誰かに引き継いでもらう
+ サーバにアップ,公開
1 の部分を飛ばしていきなり完成させても良いですよね.公開するまえに,
内容に不安があればメンバーに査読を依頼しましょう.公開ですが,さすが
に全員にパスワードを教える訳にはいきませんから,最終的サーバに公開で
きるのは限られた人間になります(今のところ僕だけなので,COさんにも権
限を受け取ってもらおうと思ってます).
1の部分を飛ばしていきなり完成させても良いですよね.
公開する前に,ある一定の査読期間を設けようと思います.
内容に不安がある場合,特に断っておいてください
(査読にかける時間を増やします).
公開サーバへのアップですが,さすがに全員にパスワードを教える訳にはいきませんから,最終的にサーバのファイルを操作できるのは限られた人間になります(今のところ崎間だけなので,COさんにも権限を受け取ってもらおうと思ってます).
つぎに,実際に記事をどう制作するか,です.これは,つぎのような手順を
考えています.
** 制作の流れ [#abadb17a]
1. ReStructuredText(※1) という形式に従い,テキストファイルに本
文,数式を記入.数式はできれば LaTeX フォーマットで記述.現在の
掲示板で推奨(※2)しているような簡易フォーマットでも可.
つぎに,実際に記事をどう制作するか,です.これは,
つぎのような手順を考えています.
2. COさんの作成されたツールでHTMLに変換
+ [[ReStructuredText]]という形式に従い,テキストファイルに本文,数式を記入.数式はできれば LaTeX フォーマットで記述.現在の掲示板で推奨しているような[[数式簡易フォーマット]]でも可.
+ COさんの作成された,かぎツールズでHTMLに変換しプレビュー
+ 不備がなければ完成
3. 不備がなければ完成
大半は1の作業になると思います.2の作業はサーバ経由でツールを使用できますので,各メンバーで行えます.その時間が惜しければ1でできたものを仮アップしてもらっても良いです.
※1 http://www.planewave.org/translations/rst/quickstart.ja.html
※2 http://hooktail.org/yybbs/yybbs.cgi?room=room1&mode=howto
また,COさんの制作したコンバータにより,テキストファイルの記事は物理のかぎしっぽのスタイルに自動変換されます.LaTeXの数式命令も処理され,画像として記事中に貼り付けられる予定です.
というものです.大半は 1 の作業になると思います.2 の作業はサーバ経
由でツールを使用できますので,各メンバーで行えます.その時間が惜しけ
れば 1 の成果を僕に渡してもらってもいいです.
完成した記事には,そのメンバーの名前をフッタ部分に入れておきます.
できあがった記事には,そのメンバーの名前をフッタ部分に入れておこうと
思います.ここで一旦切ります.
** 投稿された記事の管理と修正 [#b5a73e31]
記事は最終的に,[[ReStructuredText]]フォーマットのテキストファイルにて投稿していただき,すべてそのフォーマットで保存します.実際にサーバにアップロードされるファイルは,あくまでパブリッシュされたものです.
サイトのどこかに変更があれば(たとえばヘッダやフッタ),全ての[[ReStructuredText]]ファイルをリビルドし直せば,サイト自体が新しく生まれ変わるという寸法です(COさん談).