= Vine Linux Magazine の書き方とアップロード =
Vine Linux Magazine(vlmag)の作成には !VineSeed Trac/BTS account が必要です。
== Subversion ==
vlmag の原稿は Subversion で管理されています。執筆の前に subversion パッケージをインストールしておいてください。[[br]]
Subversion では「コピー・修正・マージ」の手順で操作します。
1. 自 PC の作業用ディレクトリで「チェックアウト」して Vine Linux Web ソースのリポジトリツリー(の一部)をコピー
2. 自 PC 上で原稿を作成/追加/修正
3. 完成/修正した原稿を「コミット」して Vine Linux Web ソースのリポジトリにマージ
== チェックアウトしてリポジトリをコピー ==
1. 自 PC にチェックアウト用のディレクトリを作成します。ここでは ~/vlmag を作成したとします。
$ mkdir ~/vlmag
2. Subversion で Vine Linux サイトの Web ソースリポジトリをチェックアウトします。
$ cd ~/vlmag[[br]]
$ svn co !http://trac.vinelinux.org/repos/projects/web/trunk
Vine Linux のサーバ上の Web ソースファイルが ~/vlmag に取り込まれます。
vlmag 執筆者に関連するファイルは以下のものです。
{{{
trunk
|-- Makefile
|-- css
| |-- dlwin.css
| |-- docs.css
| `-- layout.css
`-- vlmagazine
|-- yyyymmdd.dat
`-- images
`-- yyyymmdd-*.{png,jpeg,etc.}
}}}
== 記事を作成する ==
執筆/作成するのは以下のファイルです。
* trunk/vlmagazine/yyyymmdd.dat(HTMLの元になる記事本文)
* trunk/vlmagazine/images/yyyymmdd-*.{png,jpeg,svg,etc.}(HTML がリンクする画像)
yyyymmdd は作成した vlmag の公開(予定)日になります。適当な yyyymmdd.dat をコピーして雛形として作業を始めます。
$ cd ~/vlmag/trunk/vlmagazine[[br]]
$ cp someones-yyyymmdd.dat your-yyyymmdd.dat
$ cd ../[[br]]
$ make
すると、yyyymmdd.dat から yyyymmdd.html が生成されます。
「html ls: /home/ftp/pub/Vine/VineSeed/pool/*.rpm にアクセスできません: そのようなファイルやディレクトリはありません
rpmq: 問い合わせのための引数が指定されていません。」というような警告がいくつか出ますが、無視してかまいません。
生成されたのは確認用の HTML です。エディタで開いて css のリンク PATH を以下のように修正してブラウザで確認してください。
この HTML を作成用に使ってもかまいませんが、'''$ make clean コマンドを走らせると、~/vlmag/trunk 以下のすべての HTML が削除される'''ので要注意。
使えるタグ、書式規則とも、冒頭の{,,,}を除き、通常の HTML と変わりません。 と言われてわかる方はそういう風に書いてください。
使い慣れた HTML エディタなどがある方はそれで書いて と に挟まれた部分を yyyymmdd.dat に貼り付けても良いでしょう。
原稿は .dat 形式で完成させます。完成したら
$ make clean ; make
して HTML で最終確認を行なってください。
== 出版する ==
出来上がった原稿を Vine Linux サイトの Web ソースリポジトリにマージします。yyyyddmm が有効な日付か再度確認しておいてください。
=== ファイルを Subversion 管理下に追加 ===
追加するのは your-yyyymmdd.dat と画像ファイルです。make で生成した '''確認用/執筆用 HTML は追加しません'''。
$ cd ~/vlmag/trunk[[br]]
$ svn add vlmagazine/'''''your-yyyymmdd.dat'''''
同様に vlmagazine/images 以下に追加した画像も全て管理下に追加します。
=== Vine Linux リポジトリに送る ===
$ svn commit -m ''''''commit log(簡潔なコミットコメント)''''''
!VineSeed Trac/BTS account のユーザ名、パスワードを訊かれます。
{{{
追加しています vlmagazine/your-yyyymmdd.dat
追加しています (バイナリ) vlmagazine/images/your-yyyymmdd_01.jpg
追加しています (バイナリ) vlmagazine/images/your-yyyymmdd_02.png
……
}}}
などとなれば OK。http://trac.vinelinux.org/browser/projects/web/trunk/vlmagazine を確認してください。
リポジトリに格納されても、公開日までは http://vinelinux.org/vlmagazine/ の「記事一覧」には現れませんが、!http://vinelinux.org/vlmagazine/your-yyyymmd.html で確認できます。ミスを発見したら、速攻修正、再 commit。