home *** CD-ROM | disk | FTP | other *** search
/ DOS/V Power Report 1999 July / VPR9907A.BIN / OLS / xmlman01 / xmlman01.lzh / xmlman0.1 / readme.txt < prev   
Text File  |  1999-04-10  |  4KB  |  104 lines
  1.                       ＸＭＬでマニュアル作成
  2.  
  3. ●これは何をするソフトなのか？
  4.  
  5.   ＸＭＬで文書を作成し、レイアウト情報を付加して変換し、ＨＴＭＬファイルを
  6.   作成するソフトです。
  7.  
  8.   マニュアル作成（特に関数リファレンスのようなもの）に便利だと思います。
  9.   レイアウト情報は、別ファイルになっていますので、ひょっとすると別の用途にも
  10.   使えるかもしれません。
  11.  
  12.   例）毎日日記をつけていて、目次ページも更新するのが面倒とか．．
  13.  
  14. ●開発動機
  15.   xyzzyというエディタの解説ページを作っているのですが、似たようなレイアウトの
  16.   ページを沢山作っています。
  17.   ホームページ上の飾りの部分は、どの文書にも同じパターンで存在し、コピーして
  18.   使いまわしていたのですが、
  19.     ・あとあと文書を直す時に、余計な飾りのＨＴＭＬの部分が見にくい。
  20.       文書の内容だけに着目できると見やすい（編集しやすい）と思った。
  21.     ・ＣＳＳとかのスタイルシートを使おうと思っても、ブラウザの差を気にする
  22.       のが面倒。
  23.     ・あとあと飾りの部分を変更しようと思っても大変。
  24.     ・関連項目へのリンクとか、手修正するのは大変。
  25.  
  26.   そんな時、ある方からＸＭＬの存在を教えてもらいました。
  27.   Jadeとかいくつかのツールを試そうとしたのですが、私には難しすぎて使いこなせ
  28.   ませんでした。
  29.   そこで仕方なく、VisualBasic5とIE5のＤＯＭで変換するツールを自作してしまい
  30.   ました。^^;
  31.  
  32. ●稼動条件
  33.   IE5のＤＯＭという機能を利用していますので、
  34.   IE5の正式版が、あらかじめインストールされている必要があります。
  35.   --------------------------------------------------------------
  36.   VB5のSP3で開発してありますので、VB5のランタイムが別途必要です。
  37.   ホームページには、近日中にランタイムを含むファイルも置く予定です。
  38.  
  39.   (ひょっとするとＩＥ５を入れなくてもＤＯＭのＤＬＬだけ入れれば動くかも
  40.    しれないと思ってますが・・・今度実験してみます^^;)
  41.  
  42. ●インストール方法
  43.   インストーラはありません。
  44.   ＬＺＨを展開したら、以下のファイルが出来ているはずです。
  45.     project1.
  46.     xml.in/       サンプル文書が入っている
  47.     xml.out/      変換後のＨＴＭＬ文書を入れるフォルダ（最初は空っぽ）
  48.     img/          サンプル文書で使うイメージが入っている
  49.   ショートカットとかは自分で行ってください。
  50.  
  51. ●使い方
  52.   project1.exeを起動します。
  53.   入力ディレクトリ：   xml.inのディレクトリを指定します。
  54.   出力ディレクトリ：   xml.outのディレクトリを指定します。
  55.   実行ボタンを押します。
  56.   xml.outのディレクトリの下に変換後のＨＴＭＬファイルが出来上がります。
  57.  
  58.   操作は以上終わりです ^^;  簡単でしょ?
  59.  
  60.   できあがったファイルはxml.outの下にあり、
  61.       index.html                 目次ページ
  62.       a001.html ～ a003.html     内容ページ
  63.   となっております。こいつをホームページにアップロードする訳です。
  64.  
  65.   元文書はxml.inの下にあります。
  66.       doc1.xml                  おおもとの文書ファイルです。
  67.       index-skel.xml            目次ページの飾りの部分です。
  68.       cont-skel2.xml            内容ページの飾りの部分です。
  69.  （全部ファイル名は固定です。変なファイル名ですみません^^;)
  70.  
  71.   doc1.xmlの書き方
  72.    <chapter>～</chapter>  の部分が１つのファイルとして a???.htmlに変換されます。
  73.    <title>～</title>  の部分が目次ページに記入されます。
  74.             関数名なので、愛想がないですが m(. .)m  (目次らしくないという意味)
  75.    <seealso>～</seealso> の部分で関連項目へのリンクを張れます。
  76.             飛び先のtitleを指定します。
  77.             複数指定可能です。
  78.  
  79.   もーちょっと詳しい解説を近日中にホームページに公開する予定です。
  80.  
  81. ●ソフトウエア種別
  82.   フリーソフト、寄付は歓迎
  83.   感想とか、励ましメールとか、改善要望とか、寄付とか頂けると、とっても
  84.   嬉しいかも。
  85.  
  86. ●配布条件
  87. 　転載、配布する時は事前に作者に連絡をお願いします。
  88.  
  89. ●動作確認環境
  90.   DOS/V自作機 + Windows95 OSR2 + IE5正式版 + VB5SP3
  91.  
  92. ●免責
  93. 　  本プログラムを使用した上で生じたいかなる損害についても、作者は一切の責任を
  94.   負いません。
  95.  
  96. ●ホームページ
  97.   http://www.netlaputa.ne.jp/~henmi/xml
  98.   「自作のツール」の所に解説ページとか、最新バージョンとか、今後置いていく
  99.   つもりです。毎週末更新（努力^^;)目標ですので、気が向いたらいらしてください
  100.  
  101. ●変更履歴
  102. 　Version 0.10  93/04/11  初版公開
  103.  
  104.