PyCharm 2025.2 ヘルプ

Django テンプレートを追加する

Django プラグインを有効にする

この機能は、デフォルトで PyCharm にバンドルされて有効になっている Django プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。

  1. Ctrl+Alt+S を押して設定を開き、プラグインを選択します。

  2. インストール済みタブを開き、Django プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。

PyCharm を使用すると、サポートされているテンプレート言語の 1 つで記述されたテンプレートを作成およびレンダリングできます。

実際にテンプレート言語をインストールせずにテンプレートを編集できることに注意することが重要です。ただし、テンプレートを作成またはレンダリングし、ビューとテンプレート間を移動するには、対応するテンプレート言語を適切にインストールする必要があります。

テンプレートの作成

ビューのテンプレートを作成する

まだ存在しない index.html テンプレートファイルを参照するとします。

  1. index.html は未解決の参照としてマークされています。

    Template not found

    Alt+Enter を押すか、Intention bulb をクリックして、欠落しているテンプレートを作成することを選択します。

    Create a template

    テンプレートの作成ダイアログが表示され、読み取り専用のテンプレート名 ( テンプレートパスフィールド) と、可能なテンプレートの場所のリスト ( テンプレートのルートフィールド) が表示されます。

    Creating the index.html file
  2. 新しいテンプレートが作成されるテンプレートディレクトリを選択します。

    テンプレートのルートフィールドは、新しいテンプレートの可能な場所のリストを提供します。このリストには、IDE 設定 Ctrl+Alt+Sプロジェクト構造ページで指定されたテンプレートディレクトリと、アプリディレクトリ内にあるすべての templates フォルダー (存在する場合) が含まれます。

  3. OK をクリックします。

    指定した場所に空の .html ファイルが作成されます

特定のテンプレート言語を使用する前に、IDE 設定 Ctrl+Alt+Sテンプレート言語セクションで構成し、既存のテンプレートのファイルタイプが適切に認識されるようにします。

プロジェクトのテンプレート言語を構成する

  1. IDE 設定 Ctrl+Alt+S を開き、言語 & フレームワーク | テンプレート言語に移動します。

  2. テンプレート言語リストから、プロジェクトで使用する特定のテンプレート言語を選択します。

  3. テンプレートファイルタイプ領域で、テンプレートタグが認識されるファイルの種類を指定します。

    HTML では、XHTML、XML ファイルテンプレートは常に認識されます。

    追加および除去ボタンを使用して、希望のファイルタイプのリストを作成します。

Django テンプレートをすばやく作成するには、ライブテンプレートを使用できます。ライブテンプレートを使用すると、短い略語を入力して一般的な Django テンプレートタグを挿入できます。

ライブテンプレートを使用してテンプレートタグを挿入する

  1. 目的のテンプレートタグの省略形を入力し、Tab を押します。

    Inserting a template tag by using a live template
  2. ライブテンプレートに変数が含まれている場合、キャレットは最初のテンプレートに移動します。

    変数の値を入力し、Tab を押して次の変数に移動します。

    前の変数に戻る必要がある場合は、Shift+Tab を押します。

Django テンプレートファイルで使用可能なライブテンプレートのリストを表示するには、設定 | エディター | ライブテンプレートに移動し、Django ノードを展開します。

Django Live Templates

ライブテンプレートを作成するに従って、既存のテンプレートを編集するか、新しいテンプレートを作成できます。

ディレクトリの構成

Django アプリケーションを作成するときに、テンプレートを保存するフォルダーをすぐに指定できます。

テンプレートディレクトリを定義する

  1. IDE 設定 Ctrl+Alt+S を開き、プロジェクトノードを展開して、プロジェクト構造ページをクリックします。

  2. テンプレートルートとしてマークするディレクトリを選択します。

  3. 以下のいずれか 1 つを実行します:

    • コンテンツルートペインのツールバーで テンプレートをクリックします。

    • ディレクトリのコンテキストメニューでテンプレートを選択します。

プロジェクトツールウィンドウで、フォルダーをテンプレートディレクトリとして直接マークすることもできます。

ディレクトリをテンプレートフォルダーとしてマークする

  1. プロジェクトツールウィンドウで、目的のディレクトリを右クリックします。

  2. コンテキストメニューからディレクトリをマーク | テンプレートフォルダーを選択します。

    これにより、マークされたディレクトリがプロジェクト構造ページのテンプレートディレクトリのリストに追加されます。

それらを resources としてマークすると、Django がいくつかのフォルダーをスキップするようにすることができます (Django 言語置換を無効にします)。

Django テンプレートのデバッグ

Django テンプレートを作成したら、PyCharm を使用してデバッグできます。

ブレークポイントを設定する

  • テンプレートファイルにブレークポイントを追加します。これを行うには、ファイル templates/poll/index.html を開き、ガターをクリックします。

    Breakpoint

実行 / デバッグ構成を起動する

  • Start the debugger をクリックして、選択した実行 / デバッグ構成をデバッグモードで起動します。

    Debugging a Django template: launch debug configuration

PyCharm ウィンドウが表示されます。ブレークポイントがヒットし、デバッグツールウィンドウのスレッドと変数タブの変数の現在値が表示されていることがわかります。

Breakpoint hit
2024 年 7 月 01 日

関連ページ:

プロジェクト構造

macOS 用プロジェクトペイン:プロジェクトこのペインには、同じウィンドウで開かれたプロジェクトのリストが表示されます。リストの最初のプロジェクトがプライマリプロジェクトです。プロジェクト構造:コンテンツルートの設定ソースフォルダーをソースルートとしてマークします。そのようなフォルダーはソースルートのリストに表示されます。フォルダーがソースルートとしてマークされている場合、そのフォルダーはに追加され、それに対して解決が実行されます。このコマンドはコンテンツルートのコンテキストメニューから複

ライブテンプレート変数

ライブテンプレートの省略形を展開すると、その変数は値を入力できる入力フィールドとして表示されるか、値に置き換えられます。これらは、変更可能なデフォルト値、または関数を使用して計算された値である場合があります。テンプレート内で変数を宣言するには、次の形式を使用します: 式では、ドル文字を開閉せずに変数名を使用します(例:)。式を使用して各変数を定義し、式が評価に失敗した場合のデフォルト値を提供します。この式には、次の構成が含まれる場合があります。二重引用符で囲まれた文字列定数、ライブテンプレートで定...

ライブテンプレートを作成する

次の手順例は、現在の日付とユーザー名でコメントのテンプレートを作成する方法を示しています。を押して設定を開き、を選択します。新しいライブテンプレートを作成するテンプレートグループ(たとえば、other)を選択します。テンプレートグループを選択しない場合、ライブテンプレートがユーザーグループに追加されます。をクリックし、ライブテンプレートを選択します。テンプレートが使用可能なコンテキストを指定します。デフォルトではコンテキストは指定されておらず、PyCharm はダイアログの下部にメッセージを表示...

Django プロジェクトを作成する

Django プロジェクトは、Django を使用した生産的な Web 開発を目的としています。PyCharm は、Django アプリケーションに必要な特定のディレクトリ構造とファイルを作成し、正しい設定を提供します。Django プラグインを有効にするこの機能は、デフォルトで PyCharm にバンドルされて有効になっている Django プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インス...

プロジェクトツールウィンドウ

プロジェクトツールウィンドウを使用すると、さまざまな視点からプロジェクトを確認し、新しい項目 (ディレクトリ、ファイル、クラスなど) の作成、エディターでのファイルのオープン、必要なコードフラグメントへの移動などのさまざまなタスクを実行できます。このツールウィンドウのほとんどの機能には、コンテンツペインのコンテキストメニューコマンドとして、関連するショートカットを介してアクセスします。このビューには、作成されたスクラッチファイル、クエリコンソール、拡張スクリプトを管理できるスクラッチとコンソー...

プロジェクトで Django アプリケーションを作成する

Django プラグインを有効にするこの機能は、デフォルトで PyCharm にバンドルされて有効になっている Django プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インストール済みタブを開き、Django プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。既存の Django プロジェクトに新しいアプリケーションを追加するには、manage.py コンソールを開いてタ...