.. OMake documentation master file, created by
   sphinx-quickstart on Sat Nov  7 12:10:51 2009.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

.. 1-guide:

1. ガイド
==================
.. 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.

あなたがOMakeを始めて使うのであれば、 :doc:`quickstart` はどのようにプロジェクトを始めるべきなのかについて、簡単に説明してくれるでしょう。 :doc:`build-examples` ではプロジェクトをビルドするための、より詳細なコードサンプルを紹介しています。そして :doc:`language` では実際にプログラミングするときに役立つ、いくつかの一例を紹介しています。

1.1 注意事項
------------------
*OMakeマニュアル 日本語訳 v1.3.2*

このドキュメントは `OMake <http://omake.metaprl.org/>`_ バージョン0.9.8.6の `マニュアル <http://omake.metaprl.org/manual/omake.html>`_ を日本語訳したものです。原文のニュアンスを忠実に翻訳するよう心がけていますが、意図しない翻訳ミスやドキュメントの不備があるかもしれません。よって、 **内容の正確さについて保証することはできません。**

1.2 コンテンツ
-------------------

.. toctree::
   :hidden:
   
   quickstart
   build-examples
   language
   language-naming
   detail
   language-examples
   rules
   base
   system
   shell
   pervasives
   build
   autoconf
   osh
   omake-options
   omake-grammar

* :ref:`2. クイックスタート<label2>`

  OMakeを利用するためのクイックスタートガイド
  
* :ref:`3. ビルドサンプル<label3>`

  さらに発展したOMakeのビルドサンプルについての解説
  
* :ref:`4. OMake言語<label4>`

  OMake言語のオブジェクト、式、値について解説します
  
* :ref:`5. 変数と名前空間<label5>`

  OMake言語の変数、名前、環境について説明します
  
* :ref:`6. 式と値<label6>`

  スコープ、評価、オブジェクトを含んだ、さらなるOMake言語の解説
  
* :ref:`7. さらなる言語例<label7>`

  OMakeの言語についての、より詳しい解説
  
* :ref:`8. ビルドルール<label8>`

  プログラムをビルドするために用いるルールの定義方法について学びます
  
* :ref:`9. 基本的なビルドイン関数<label9>`

  標準ライブラリの核となる関数や変数についての解説
  
* :ref:`10. システム関数<label10>`

  ファイル、入出力、システムコマンドについての関数
  
* :ref:`11. シェルコマンド<label11>`

  OMakeのシェルを用いてコマンドラインを操作します
  
* :ref:`12. 標準的なオブジェクト群<label12>`

  広く使われているビルドインオブジェクトについての解説
  
* :ref:`13. ビルド関数とユーティリティ<label13>`

  OMakeの標準ライブラリを使って、プログラミング言語のビルド設定を行います
  
* :ref:`14. 自動設定用の変数と関数<label14>`

  自動的に設定テストを行うための、OMake標準ライブラリ
  
* :ref:`15. OSHシェル<label15>`

  ``osh`` コマンドラインインタープリターについての解説

* **付録**

  * :ref:`A. OMake コマンドラインオプション<labelA>`
  
    ``omake`` のコマンドラインオプション

..  * :ref:`B. OMakeの文法<labelB>`

      OMake言語についての、さらに詳細な解説

1.3 翻訳に関して
-------------------
1.3.1 索引と検索
^^^^^^^^^^^^^^^^^^^^^^^^^^^
* 『OMakeマニュアル 日本語訳』では、独自に索引機能を搭載しております。右上もしくは右下にある『 `索引 <http://omake-japanese.sourceforge.jp/genindex.html>`_ 』リンクをクリックすることで、検索したい用語をたどることができます。
* 分かりやすさのため、関数には ``()`` が接尾辞として付与されています。
* クイック検索も左にありますが、(使ってみれば分かると思いますが)あまり役に立ちません。大抵の場合、索引のほうがより早く目的の情報にアクセスできます。

1.3.2 PDF版のダウンロード
^^^^^^^^^^^^^^^^^^^^^^^^^^^
* (10/10/26)すべてのコンテンツを一つに纏めたPDF版を新しく制作しました。iPadなどの電子書籍で閲覧したり、ネットに接続できない職場でも閲覧できるよう製本する必要がある場合に便利です。

  ダウンロードを望むユーザの方は、 `<http://omake-japanese.sourceforge.jp/OMake.pdf>`_ よりダウンロードをお願いします。

1.3.3 その他の考慮事項
^^^^^^^^^^^^^^^^^^^^^^^^^^^
* 忠実に翻訳するというよりは読みやすさを重視して、多少崩した形の翻訳となっています。
* 特に指定されていない括弧内の意見は全て原作者の意見です。翻訳者の意見はすべて *『訳注:』* をつけています。
* 字句解析については翻訳者の専門外ですので、意図しない翻訳ミスが含まれている可能性が高いです。
* OMake独自の専門用語も分かりやすさのため翻訳していますが、後に原文と比較できるようにするため、括弧書きで原文を載せています。
* 原文と翻訳文を比較したい方は左の『ソースコードを表示』で.rstファイルを参照してください。コメントに原文を載せています。
* このドキュメントはSphinxを用いて生成しました。元のコードは全て `Gitリポジトリ上で管理 <http://git.sourceforge.jp/view?p=omake-japanese/omake_trans.git>`_ しています。
* (10/01/28)HTMLドキュメントの印刷に対応しました。Sphinxのデフォルトの状態では印刷が正常に行えなかったのですが、CSSを独自に変更して対応しました。

1.3.4 翻訳者について
^^^^^^^^^^^^^^^^^^^^^^^^^^^
このドキュメントは *Masaki Saito* が翻訳しました。
翻訳に関して不備がある場合は連絡をいただけるとありがたいです。

* mailaddr: rezoolab@gmail.com
* blog_url: http://mglab.blogspot.com/