.. The Pyramid Web Application Development Framework .. _index: ================================================= Pyramid Web アプリケーション開発フレームワーク ================================================= .. :app:`Pyramid` is a small, fast, down-to-earth Python web application .. development framework. It is developed as part of the `Pylons Project .. `_. It is licensed under a `BSD-like license .. `_. :app:`Pyramid` は、小さく、速く、堅実 (down-to-earth) な Python ウェブ アプリケーション開発フレームワークです。 Pyramid は Pylons プロジェクトの 一部として開発されています。 `BSD-like なライセンス `_ の下でライセンスされています。 .. Here is one of the simplest :app:`Pyramid` applications you can make: 最も単純な :app:`Pyramid` アプリケーションはこのようになります: .. literalinclude:: narr/helloworld.py .. After you install :app:`Pyramid` and run this application, when you visit .. ``http://localhost:8080/hello/world`` in a browser, you will see the .. text ``Hello, world!`` :app:`Pyramid` をインストールしてアプリケーションを起動した後で、 ブラウザで ``http://localhost:8080/hello/world`` を訪れれば、 ``Hello, world!`` というテキストが見えるはずです。 .. See :ref:`firstapp_chapter` for a full explanation of how this application .. works. Read the :ref:`html_narrative_documentation` to understand how .. :app:`Pyramid` is designed to scale from simple applications like this to .. very large web applications. このアプリケーションがどのようにして動くのかについての完全な説明は、 :ref:`firstapp_chapter` を参照してください。 :app:`Pyramid` がこの ような単純なアプリケーションから非常に大きなウェブアプリケーションまで スケールするためにどのように設計されているかを理解するには :ref:`html_narrative_documentation` を読んでください。 .. Front Matter まえがき ============ .. toctree:: :maxdepth: 1 copyright.rst conventions.rst .. "What's New" What's New ========== .. toctree:: :maxdepth: 1 whatsnew-1.3 whatsnew-1.2 whatsnew-1.1 whatsnew-1.0 .. Narrative documentation .. _html_narrative_documentation: マニュアル ======================= .. Narrative documentation in chapter form explaining how to use .. :app:`Pyramid`. :app:`Pyramid` を使用する方法について説明した、章形式のマニュアル (Narrative documentation) です。 .. toctree:: :maxdepth: 2 narr/introduction narr/install narr/firstapp narr/configuration narr/project narr/startup narr/router narr/urldispatch narr/views narr/renderers narr/templates narr/viewconfig narr/assets narr/webob narr/sessions narr/events narr/environment narr/logging narr/paste narr/commandline narr/i18n narr/vhosting narr/testing narr/resources narr/hellotraversal narr/muchadoabouttraversal narr/traversal narr/security narr/hybrid narr/hooks narr/introspector narr/extending narr/advconfig narr/extconfig narr/scaffolding narr/threadlocals narr/zca .. Tutorials チュートリアル ============== .. Tutorials explaining how to use :app:`Pyramid` to build various types of .. applications, and how to deploy :app:`Pyramid` applications to various .. platforms. 様々なタイプのアプリケーションを構築するために :app:`Pyramid` を使用 する方法や、 :app:`Pyramid` アプリケーションを様々なプラットフォームへ 展開する方法について説明したチュートリアルです。 .. toctree:: :maxdepth: 2 tutorials/wiki2/index.rst tutorials/wiki/index.rst tutorials/bfg/index.rst tutorials/modwsgi/index.rst API Documentation ================== .. Documentation for every :app:`Pyramid` API. すべての :app:`Pyramid` API に対するドキュメント .. toctree:: :maxdepth: 2 api .. Change History 変更履歴 ============== .. toctree:: :maxdepth: 1 changes .. Design Documents 設計ドキュメント ================ .. toctree:: :maxdepth: 1 designdefense .. Sample Applications サンプルアプリケーション ======================== .. `cluegun `_ is a simple pastebin .. application based on Rocky Burt's `ClueBin .. `_. It demonstrates form .. processing, security, and the use of :term:`ZODB` within a :app:`Pyramid` .. application. Check this application out via: `cluegun `_ は、 Rocky Burt の `ClueBin `_ を基にした単純な pastebin アプリケーションです。 Pyramid アプリケーションでの フォーム処理、セキュリティ、 :term:`ZODB` の使用を実証します。 次のようにしてこのアプリケーションをチェックアウトしてください: .. code-block:: text git clone git://github.com/Pylons/cluegun.git .. `virginia `_ is a very simple dynamic .. file rendering application. It is willing to render structured text .. documents, HTML documents, and images from a filesystem directory. .. It's also a good example of :term:`traversal`. An .. earlier version of this application runs the `repoze.org .. `_ website. Check this application out via: `virginia `_ は非常に単純な動的 ファイル表示アプリケーションです。ファイルシステム上のディレクトリから、 構造化テキストドキュメント、HTML ドキュメント、画像を表示しようとします。 これは :term:`traversal` のよい例でもあります。このアプリケーションの 初期のバージョンは repoze.org ウェブサイトを動かしていました。次のように してこのアプリケーションをチェックアウトしてください: .. code-block:: text git clone git://github.com/Pylons/virginia.git .. `shootout `_ is an example "idea .. competition" application by Carlos de la Guardia and Lukasz Fidosz. It .. demonstrates :term:`URL dispatch`, simple authentication, integration .. with `SQLAlchemy `_ and ``pyramid_simpleform``. .. Check this application out of version control via: `shootout `_ は、 Carlos de la Guardia と Lukasz Fidosz による「アイデア競争」アプリケーションの例です。 :term:`URL dispatch` 、簡易認証、 `SQLAlchemy `_ と ``pyramid_simpleform`` の統合を実証します。次のようにしてこの アプリケーションをバージョン管理からチェックアウトしてください: .. code-block:: text git clone git://github.com/Pylons/shootout.git .. `KARL `_ is a moderately-sized application (roughly .. 80K lines of Python code) built on top of :app:`Pyramid`. It is an open .. source web system for collaboration, organizational intranets, and knowledge .. management. It provides facilities for wikis, calendars, manuals, searching, .. tagging, commenting, and file uploads. See the `KARL site .. `_ for download and installation details. `KARL `_ は :app:`Pyramid` の上に構築された 中程度のサイズ (およそ 80K 行の Python コード) のアプリケーションです。 それは、共同作業、組織的なイントラネット、ナレッジマネジメント用の オープンソース・ウェブシステムで、 Wiki 、カレンダー、マニュアル、検索、 タグ付け、コメント、ファイルアップロード機能を提供します。 ダウンロードとインストールの詳細については、 `KARL サイト `_ を参照してください。 .. Support and Development サポートと開発 ======================= .. The `Pylons Project web site `_ is the main online .. source of :app:`Pyramid` support and development information. `Pylons Project ウェブサイト `_ は、 :app:`Pyramid` のサポートおよび開発情報についてのオンラインの主な情報源です。 .. To report bugs, use the `issue tracker .. `_. バグを報告するためには、 `issue tracker `_ を使用してください。 .. If you've got questions that aren't answered by this documentation, .. contact the `Pylons-discuss maillist .. `_ or join the `#pyramid .. IRC channel `_. このドキュメントが答えていない質問がある場合は、 `Pylons-discuss メーリン グリスト `_ に連絡するか、 `#pyramid IRCチャンネル `_ に join してください。 .. Browse and check out tagged and trunk versions of :app:`Pyramid` via .. the `Pyramid GitHub repository `_. .. To check out the trunk via ``git``, use this command: `Pyramid GitHub リポジトリ `_ 経由で :app:`Pyramid` のタグや trunk バージョンを閲覧、チェックアウトしてください。 ``git`` を使って trunk をチェックアウトするためには、このコマンドを使用してください: .. code-block:: text git clone git@github.com:Pylons/pyramid.git .. To find out how to become a contributor to :app:`Pyramid`, please see the .. `contributor's section of the documentation .. `_. Pyramid の貢献者になる方法を理解するためには、 `ドキュメントの貢献者の セクション `_ を 参照してください。 .. Index and Glossary 索引と用語集 ================== * :ref:`glossary` * :ref:`genindex` * :ref:`search` .. add glossary, foreword, and latexindex in a hidden toc to avoid warnings .. toctree:: :hidden: glossary foreword.rst latexindex.rst