index.rst

   1 .. OMake documentation master file, created by
   2    sphinx-quickstart on Sat Nov  7 12:10:51 2009.
   3    You can adapt this file completely to your liking, but it should at least
   4    contain the root `toctree` directive.
   5
   6 .. 1-guide:
   7
   8 1. ガイド
   9 ==================
  10 .. If you are new to OMake, you the omake-quickstart presents a short introduction that describes how to set up a project. The omake-build-examples gives larger examples of build projects, and omake-language-examples presents programming examples.
  11
  12 あなたがOMakeを始めて使うのであれば、 :doc:`quickstart` はどのようにプロジェクトを始めるべきなのかについて、簡単に説明してくれるでしょう。 :doc:`build-examples` ではプロジェクトをビルドするための、より詳細なコードサンプルを紹介しています。そして :doc:`language` では実際にプログラミングするときに役立つ、いくつかの一例を紹介しています。
  13
  14 1.1 注意事項
  15 ------------------
  16 *OMakeマニュアル 日本語訳 v1.2.4*
  17
  18 このドキュメントは `OMake <http://omake.metaprl.org/>`_ バージョン0.9.8.5の `マニュアル <http://omake.metaprl.org/manual/omake.html>`_ を日本語訳したものです。 **この翻訳に関して原作者の許可は取っておりませんので、正当な権利者からの申し立てにより予告なく削除する場合があります。**
  19
  20 原文のニュアンスを忠実に翻訳するよう心がけていますが、意図しない翻訳ミスやドキュメントの不備があるかもしれません。よって、 **内容の正確さについて保証することはできません。**
  21
  22 1.2 コンテンツ
  23 -------------------
  24
  25 .. toctree::
  26    :hidden:
  27
  28    quickstart
  29    build-examples
  30    language
  31    language-naming
  32    detail
  33    language-examples
  34    rules
  35    base
  36    system
  37    shell
  38    pervasives
  39    build
  40    autoconf
  41    osh
  42    omake-options
  43    omake-grammar
  44
  45 * :ref:`2. クイックスタート<label2>`
  46
  47   OMakeを利用するためのクイックスタートガイド
  48
  49 * :ref:`3. ビルドサンプル<label3>`
  50
  51   さらに発展したOMakeのビルドサンプルについての解説
  52
  53 * :ref:`4. OMake言語<label4>`
  54
  55   オブジェクト、式、値を含んだ、OMake言語について解説します
  56
  57 * :ref:`5. 変数と名前空間<label5>`
  58
  59   OMake言語の変数、名前、環境について説明します
  60
  61 * :ref:`6. 式と値<label6>`
  62
  63   スコープ、評価、オブジェクトを含んだ、さらなるOMake言語の解説
  64
  65 * :ref:`7. さらなる言語例<label7>`
  66
  67   OMakeの言語についての、より詳しい解説
  68
  69 * :ref:`8. ビルドルール<label8>`
  70
  71   プログラムをビルドするためのルールの定義方法について学びます
  72
  73 * :ref:`9. 基本的なビルドイン関数<label9>`
  74
  75   標準ライブラリの核となる関数や変数についての解説
  76
  77 * :ref:`10. システム関数<label10>`
  78
  79   ファイル、入出力、システムコマンドについての関数
  80
  81 * :ref:`11. シェルコマンド<label11>`
  82
  83   OMakeのシェルを用いてコマンドラインを操作します
  84
  85 * :ref:`12. 標準的なオブジェクト群<label12>`
  86
  87   広く使われているビルドインオブジェクトについての解説
  88
  89 * :ref:`13. ビルド関数とユーティリティ<label13>`
  90
  91   OMakeの標準ライブラリを使って、プログラミング言語のビルド設定を行います
  92
  93 * :ref:`14. 自動設定用の変数と関数<label14>`
  94
  95   自動的に設定テストを行うための、OMake標準ライブラリ
  96
  97 * :ref:`15. OSHシェル<label15>`
  98
  99   ``osh`` コマンドラインインタープリターについての解説
 100
 101 * **付録**
 102
 103   * :ref:`A. OMake コマンドラインオプション<labelA>`
 104
 105     ``omake`` のコマンドラインオプション
 106
 107 ..  * :ref:`B. OMakeの文法<labelB>`
 108
 109       OMake言語についての、さらに詳細な解説
 110
 111 1.3 翻訳に関して
 112 -------------------
 113 1.3.1 索引と検索
 114 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 115 * 『OMakeマニュアル 日本語訳』では、独自に索引機能を搭載しております。右上もしくは右下にある『 `索引 <http://omake-japanese.sourceforge.jp/genindex.html>`_ 』リンクをクリックすることで、検索したい用語をたどることができます。
 116 * 分かりやすさのため、関数には ``()`` が接尾辞として付与されています。
 117 * クイック検索も左にありますが、(使ってみれば分かると思いますが)あまり役に立ちません。大抵の場合、索引のほうがより早く目的の情報にアクセスできます。
 118
 119 1.3.2 その他の考慮事項
 120 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 121 * 忠実に翻訳するというよりは読みやすさを重視して、多少崩した形の翻訳となっています。
 122 * 特に指定されていない括弧内の意見は全て原作者の意見です。翻訳者の意見はすべて *『訳注:』* をつけています。
 123 * 字句解析については翻訳者の専門外ですので、意図しない翻訳ミスが含まれている可能性が高いです。
 124 * OMake独自の専門用語も分かりやすさのため翻訳していますが、後に原文と比較できるようにするため、括弧書きで原文を載せています。
 125 * 原文と翻訳文を比較したい方は左の『ソースコードを表示』で.rstファイルを参照してください。コメントに原文を載せています。
 126 * このドキュメントはSphinxを用いて生成しました。元のコードは全て `Gitリポジトリ上で管理 <http://git.sourceforge.jp/view?p=omake-japanese/omake_trans.git>`_ しています。
 127 * (10/01/28)HTMLドキュメントの印刷に対応しました。Sphinxのデフォルトの状態では印刷が正常に行えなかったのですが、CSSを独自に変更して対応しました。
 128
 129 1.3.3 翻訳者について
 130 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 131 このドキュメントは *rezoo* が翻訳しました。
 132 翻訳に関して不備がある場合は連絡をいただけるとありがたいです。
 133
 134 * mailaddr: rezoolab@gmail.com
 135 * blog_url: http://mglab.blogspot.com/
 136