Django ドキュメント¶
Django を使いこなすための全てがここにあります。
助けを求める¶
困り事ですか?手を貸しましょう!
- Try the FAQ – it’s got answers to many common questions.
- Looking for specific information? Try the 索引, モジュール索引 or the detailed table of contents.
- django-users メーリングリストのアーカイブを検索してみてください。もし良い質問が見つからなければ、ぜひ 質問を投稿してください 。
- Ask a question in the #django IRC channel, or search the IRC logs to see if it’s been asked before.
- Report bugs with Django in our ticket tracker.
ドキュメントの構成¶
Django にはドキュメントがたくさんあります。あらかじめドキュメントの構成の大まかな概要を知っておけば、特定のトピックを探すときに、どこを探せばいいかすぐに分かるようになるでしょう。
- チュートリアル では、一連のステップを通して、実際に手を動かしながら Web アプリケーションを作ります。もし Django や Web アプリケーションの開発が初めてなら、ここから読み始めてください。下の「 最初のステップ 」のセクションも読んでみてください。
- トピックガイド では、重要なトピックや概念について大まかに解説し、役に立つ背景情報や説明を行っています。
- リファレンスガイド は、API や他の側面から見た Django の仕組みの技術的なリファレンスです。ここでは、Django の仕組みとその使い方について説明していますが、重要な概念については基本的に理解していることを前提に書かれています。
- How-to ガイド はレシピ集です。よくある問題やユースケースに対して、どんなステップを踏んで解決すればいいかを説明しています。チュートリアルより発展的な内容で、Django の仕組みについてはある程度は理解していることを前提に書いてあります。
最初のステップ¶
Django やプログラミングは初めてですか? それなら、ここから始めましょう!
- 何もないところから始めるなら: 概要 | インストール
- チュートリアルはこちら: その 1: リクエストとレスポンス | その 2: モデルと管理サイト | その 3: ビューとテンプレート | その 4: フォームと汎用ビュー | その 5: テスト | その 6: 静的ファイル | その 7: 管理サイトのカスタマイズ
- 高度なチュートリアル: 再利用可能なアプリケーションの書き方 | Django へのパッチを初めて書くには
モデル層¶
Django は、Web アプリケーションのデータ構造を定義、操作するための抽象レイヤとして「モデル (models)」と呼ばれるしくみを提供しています。次のリンクから、詳細を学びましょう。
- モデルとは: モデル の定義方法 | フィールド型 | インデックス | Meta オプション | モデルクラス
- QuerySets: queryを作成する | QuerySetメソッドリファレンス | 検索式
- モデルインスタンス詳説: インスタンスメソッド解説 | リレーション先オブジェクトへのアクセス
- マイグレーションとは: マイグレーションの解説 | 操作方法リファレンス | SchemaEditor | マイグレーションを書くには
- モデルの高度な話題: マネージャ (Manager) | 素の SQL を扱うには | トランザクション | アグリゲーション (Aggregation) | 検索 | フィールド型を自作するには | 複数データベースを扱うには | lookup フィルタを自作するには | クエリを書くには | 条件分岐をするには | データベースの機能
- その他: データベースのサポート状況 | レガシーなデータベースを扱う | 初期データを投入するには | データベースアクセスの最適化 | PostgreSQLの特有の機能を扱うには
ビュー層¶
Django には「ビュー (views)」と呼ばれる概念があります。ビューは、ユーザーリクエストを処理してレスポンスを返すロジックをカプセル化したものです。以下のリンクから、ビューの詳細を学びましょう。
- ビューの基本: URLconf とは | ビュー関数とは | 便利なショートカット | デコレータ
- リファレンス: 組み込みのビュー | リクエスト/レスポンスオブジェクト | テンプレートレスポンスオブジェクト
- ファイルアップロードに対応するには: ファイルアップロード対応の概要 | File オブジェクトリファレンス | ストレージ API | ファイルの管理 | ストレージを自作するには
- クラスベースビュー: クラスベースビューの概要 | 組み込みの表示用ビュー | 組み込みの編集用ビュー | Mixin を使うには | API リファレンス | 索引
- より高度なビューの話題: CSV を出力するには | PDF を出力するには
- ミドルウェア: ミドルウェアとは | 組み込みのミドルウェアクラス
テンプレート層¶
テンプレート層は、ユーザに表示される情報をレンダリングするための、デザイナーにも書きやすい構文を提供します。デザイナーによるテンプレートの構文の使い方や、プログラマーが構文を拡張する方法について学びましょう。
- 基本: 概要
- デザイナー向けの情報: テンプレートの書き方概要 | 組み込みタグとフィルタ | 人間にやさしい出力生成
- プログラマー向けの情報: テンプレート API | タグやフィルタを自作するには
フォーム¶
Django には、フォームを簡単に作成したり、フォームに入力されたデータを簡単に操作できるようにしてくれる、多機能なフレームワークがあります。
- フォームの基礎: フォーム機能の概要 | フォーム API | 組み込みフォームフィールドリファレンス | 組み込みウィジェットリファレンス
- 高度な話題: モデルに対応したフォームを生成するには | メディアファイルを組み込むには | フォームセットを扱うには | バリデータを自作するには
開発プロセス¶
Django アプリケーションの開発とテストに役立つ、さまざまなコンポーネントとツールについて学ましょう。
- 設定: 設定ファイルとは | 設定項目リファレンス
- アプリケーション: 概要
- 例外: 例外の概要
- django-admin.py と manage.py: 概要 | 自作の管理コマンドを追加するには
- テスト: テストの紹介 | テストの書き方と実行方法 | テストのツール | 高度な話題
- デプロイ: デプロイの概要 | WSGI サーバ | 静的ファイルのデプロイ | エラーの発生をメールで追跡するには
セキュリティ¶
セキュリティは Web アプリケーションを開発する中でも最も重要なトピックです。Django は、複数のプロテクションのためのツールとメカニズムを提供しています。
国際化と地域化¶
Django は堅牢な国際化 (internationalization) 、地域化 (localization) フレームワークを提供しています。これらのフレームワークを使えば、多言語、世界の各地域に対応したアプリケーションが簡単に開発できます。
- 概要 | 国際化 | 地域化 | 地域化されたUIフォーマットとフォームインプット
- タイムゾーン
ジオグラフィックフレームワーク¶
GeoDjango は世界規模のジオグラフィック Web フレームワークを目指しています。 GeoDjango の目的は、地理情報システム (GIS) のWeb アプリケーションの開発をより簡単にし、空間データ (spatially enabled data) を活用することにあります。
一般的な Web アプリケーションツール群¶
Django は Web アプリケーションの開発でいつも必要になるツール群を提供しています。
その他のコア機能¶
Django フレームワークの、その他の主要機能について学びましょう。
オープンソースプロジェクトとしての Django¶
Django プロジェクト自身の開発プロセスと、プロジェクトに貢献する方法について学びましょう。
- コミュニティ: 参加するには | リリースプロセス | チーム組織 | Djangoのソースコードリポジトリ | セキュリティポリシー | メーリングリスト
- 設計思想: 概要
- ドキュメントの仕組み: ドキュメントの仕組みと書き方
- サードパーティが配布している Django: 概要と、ディストリビュータへのお願い
- Django と長く付き合うために: どの API が安定なのか | リリースノート一覧とアップグレードの手順 | 不要な機能の撤廃、削除スケジュール