{"title":"はじめての Django アプリ作成、その 6","version":"2.0","locale":"ja","docname":"intro/tutorial06","url":"/ja/2.0/intro/tutorial06/","canonical":"https://djangodocs.dev/ja/2.0/intro/tutorial06/","summary":"このチュートリアルは チュートリアル 5 の続きです。Web 投票アプリケーションのテストが完成したので、今度はスタイルシートや画像を追加しましょう。…","html":"<h1>はじめての Django アプリ作成、その 6<a class=\"heading-anchor\" href=\"#writing-your-first-django-app-part-6\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>このチュートリアルは <a class=\"reference internal\" href=\"/ja/2.0/intro/tutorial05/\"><span class=\"doc\">チュートリアル 5</span></a> の続きです。Web 投票アプリケーションのテストが完成したので、今度はスタイルシートや画像を追加しましょう。</p>\n<p>サーバで生成するHTML以外に、Webアプリケーションは一般的に完全なWebページをレンダリングするために、画像、JavaScript、CSSなど必要なファイルを提供する必要があります。Djangoでは、これらのファイルを &quot;静的 (static) ファイル&quot; と呼びます。</p>\n<p>小さなプロジェクトではこのことは大きな問題になりません。 Web サーバが見つけられる場所で静的ファイルを単に管理することができるからです。しかし、もっと大きな プロジェクトで、特に複数のアプリケーションからなる場合は、各アプリケーションが 持っている静的ファイルの集まりを複数扱うことになり、ややこしくなってきます。</p>\n<p><code class=\"docutils literal notranslate\"><span class=\"pre\">django.contrib.staticfiles</span></code> はまさにそのためにあります。これは静的なファイ ルを各アプリケーションから (さらに指定した別の場所からも) 一つの場所に集め、運用環境で公開しやすくするものです。</p>\n<section id=\"customize-your-app-s-look-and-feel\">\n<h2><em>アプリ</em> の構造をカスタマイズする<a class=\"heading-anchor\" href=\"#customize-your-app-s-look-and-feel\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>最初に、 <code class=\"docutils literal notranslate\"><span class=\"pre\">polls</span></code> ディレクトリの中に、 <code class=\"docutils literal notranslate\"><span class=\"pre\">static</span></code> ディレクトリを作成します。Django はそこから静的ファイルを探します。Django が <code class=\"docutils literal notranslate\"><span class=\"pre\">polls/templates/</span></code> からテンプレートを探す方法と同様です。</p>\n<p>Django の <a class=\"reference internal\" href=\"/ja/2.0/ref/settings/#std-setting-STATICFILES_FINDERS\"><code class=\"xref std std-setting docutils literal notranslate\"><span class=\"pre\">STATICFILES_FINDERS</span></code></a> は、さまざまなソースから静的ファイルを検索する方法を知っているファインダのリストです。デフォルトのファイダの一つは <code class=\"docutils literal notranslate\"><span class=\"pre\">AppDirectoriesFinder</span></code> で、<a class=\"reference internal\" href=\"/ja/2.0/ref/settings/#std-setting-INSTALLED_APPS\"><code class=\"xref std std-setting docutils literal notranslate\"><span class=\"pre\">INSTALLED_APPS</span></code></a> に書かれた各アプリケーションに対して、ちょうど今作った <code class=\"docutils literal notranslate\"><span class=\"pre\">polls</span></code> のような &quot;static&quot; サブディレクトリを検索してくれます。管理サイトの静的ファイルにも、これと同じディレクトリ構造が使われます。</p>\n<p>今作った <code class=\"docutils literal notranslate\"><span class=\"pre\">static</span></code> ディレクトリの中に、<code class=\"docutils literal notranslate\"><span class=\"pre\">polls</span></code> という名前の新しいディレクトリを作り、さらにその中に、<code class=\"docutils literal notranslate\"><span class=\"pre\">style.css</span></code> という名前のファイルを作成します。つまり、このスタイルシートは <code class=\"docutils literal notranslate\"><span class=\"pre\">polls/static/polls/style.css</span></code> に保存します。<code class=\"docutils literal notranslate\"><span class=\"pre\">AppDirectoriesFinder</span></code> の動作のしくみのおかげで、Django では、ただ <code class=\"docutils literal notranslate\"><span class=\"pre\">polls/style.css</span></code> と書くだけでこの静的ファイルを参照することができます。これは、テンプレートのパスを参照する時と同じです。</p>\n<aside class=\"admonition-static-file-namespacing admonition\">\n<p class=\"admonition-title\">静的ファイルの名前空間</p>\n<p>テンプレートと同様に、<code class=\"docutils literal notranslate\"><span class=\"pre\">polls</span></code> という別のサブディレクトリを作らずに、直接 <code class=\"docutils literal notranslate\"><span class=\"pre\">polls/static</span></code> の中に静的ファイルを置いてもいいのではないか、と思うかもしれませんね。しかし、それは実際には悪い考えです。Django は、名前がマッチした最初のテンプレートを使用するので、もし <em>異なる</em> アプリケーションの中に同じ名前のテンプレートがあった場合、Django はそれらを区別することができません。そのため、Django に正しいテンプレートを教えてあげる必要がありますが、一番簡単な方法は、それらに <em>名前空間を与える</em> ことです。アプリケーションと同じ名前をつけた <em>もう一つの</em> ディレクトリの中にテンプレートを置いたのは、そういうわけなのです。</p>\n</aside>\n<p>スタイルシートに次のコードを配置します (<code class=\"docutils literal notranslate\"><span class=\"pre\">polls/static/polls/style.css</span></code>):</p>\n<figure class=\"code-block code-block-captioned\" data-language=\"css\"><figcaption class=\"code-block-caption\"><code>polls/static/polls/style.css</code></figcaption><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Css</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"polls/static/polls/style.css\"><code><span class=\"nt\">li</span><span class=\"w\"> </span><span class=\"nt\">a</span><span class=\"w\"> </span><span class=\"p\">{</span>\n<span class=\"w\">    </span><span class=\"k\">color</span><span class=\"p\">:</span><span class=\"w\"> </span><span class=\"kc\">green</span><span class=\"p\">;</span>\n<span class=\"p\">}</span>\n</code></pre></figure>\n<p>次に、<code class=\"docutils literal notranslate\"><span class=\"pre\">polls/templates/polls/index.html</span></code> の上部に追加します:</p>\n<figure class=\"code-block code-block-captioned\" data-language=\"html+django\"><figcaption class=\"code-block-caption\"><code>polls/templates/polls/index.html</code></figcaption><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Django template</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"polls/templates/polls/index.html\"><code><span class=\"cp\">{%</span> <span class=\"k\">load</span> <span class=\"nv\">static</span> <span class=\"cp\">%}</span>\n\n<span class=\"p\">&lt;</span><span class=\"nt\">link</span> <span class=\"na\">rel</span><span class=\"o\">=</span><span class=\"s\">&quot;stylesheet&quot;</span> <span class=\"na\">type</span><span class=\"o\">=</span><span class=\"s\">&quot;text/css&quot;</span> <span class=\"na\">href</span><span class=\"o\">=</span><span class=\"s\">&quot;</span><span class=\"cp\">{%</span> <span class=\"k\">static</span> <span class=\"s1\">&#39;polls/style.css&#39;</span> <span class=\"cp\">%}</span><span class=\"s\">&quot;</span> <span class=\"p\">/&gt;</span>\n</code></pre></figure>\n<p><code class=\"docutils literal notranslate\"><span class=\"pre\">{%</span> <span class=\"pre\">static</span> <span class=\"pre\">%}</span></code> テンプレートタグは、静的ファイルの完全 URL を生成します。</p>\n<p>開発でするべきことはこれだけです。<code class=\"docutils literal notranslate\"><span class=\"pre\">http://localhost:8000/polls/</span></code> をリロードすれば、質問のリンクが緑色 (Django のスタイル！) に変わったはずです。これで、スタイルシートがちゃんと読み込まれたことがわかりました。</p>\n</section>\n<section id=\"adding-a-background-image\">\n<h2>背景画像を追加する<a class=\"heading-anchor\" href=\"#adding-a-background-image\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>つぎに、画像のためのサブディレクトリを作りましょう。<code class=\"docutils literal notranslate\"><span class=\"pre\">images</span></code> サブディレクトリを <code class=\"docutils literal notranslate\"><span class=\"pre\">polls/static/polls/</span></code> ディレクトリの中に作成します。このディレクトリの中に、<code class=\"docutils literal notranslate\"><span class=\"pre\">background.gif</span></code> という名前の画像を置きます。つまり、画像は <code class=\"docutils literal notranslate\"><span class=\"pre\">polls/static/polls/images/background.gif</span></code> に置きます。</p>\n<p>さらに、スタイルシート (<code class=\"docutils literal notranslate\"><span class=\"pre\">polls/static/polls/style.css</span></code>) に次のコードを追加します。</p>\n<figure class=\"code-block code-block-captioned\" data-language=\"css\"><figcaption class=\"code-block-caption\"><code>polls/static/polls/style.css</code></figcaption><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Css</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"polls/static/polls/style.css\"><code><span class=\"nt\">body</span><span class=\"w\"> </span><span class=\"p\">{</span>\n<span class=\"w\">    </span><span class=\"k\">background</span><span class=\"p\">:</span><span class=\"w\"> </span><span class=\"kc\">white</span><span class=\"w\"> </span><span class=\"nb\">url</span><span class=\"p\">(</span><span class=\"s2\">&quot;images/background.gif&quot;</span><span class=\"p\">)</span><span class=\"w\"> </span><span class=\"kc\">no-repeat</span><span class=\"p\">;</span>\n<span class=\"p\">}</span>\n</code></pre></figure>\n<p><code class=\"docutils literal notranslate\"><span class=\"pre\">http://localhost:8000/polls/</span></code> をリロードすると、読み込んだ背景画像がスクリーンの左上部に確認できるでしょう。</p>\n<aside class=\"admonition admonition-warning\" role=\"note\">\n<p class=\"admonition-title\">警告</p>\n<p>もちろん、<code class=\"docutils literal notranslate\"><span class=\"pre\">{%</span> <span class=\"pre\">static</span> <span class=\"pre\">%}</span></code> テンプレートタグは、スタイルシートのような Django が生成しない静的ファイル内では使用できません。そのため、2つの静的ファイルを互いにリンクするときには、必ず <strong>相対パス</strong> を使用するべきです。そうすれば、<a class=\"reference internal\" href=\"/ja/2.0/ref/settings/#std-setting-STATIC_URL\"><code class=\"xref std std-setting docutils literal notranslate\"><span class=\"pre\">STATIC_URL</span></code></a> (<a class=\"reference internal\" href=\"/ja/2.0/ref/templates/builtins/#std-templatetag-static\"><code class=\"xref std std-ttag docutils literal notranslate\"><span class=\"pre\">static</span></code></a> テンプレートタグが URL を生成する時に使われる) を変更しても、静的ファイルのパスを書き換えずに済みます。</p>\n</aside>\n<p>これらは静的ファイルの <strong>基本</strong> です。設定方法やフレームワークの機能の詳細については、<a class=\"reference internal\" href=\"/ja/2.0/howto/static-files/\"><span class=\"doc\">静的ファイルの配信</span></a> と <a class=\"reference internal\" href=\"/ja/2.0/ref/contrib/staticfiles/\"><span class=\"doc\">staticfiles のリファレンス</span></a> を読んでください。<a class=\"reference internal\" href=\"/ja/2.0/howto/static-files/deployment/\"><span class=\"doc\">静的ファイルのデプロイ</span></a> では、実際のサーバでの静的ファイルの使い方について説明しています。</p>\n<p>静的ファイルを使いこなせるようになったら、<a class=\"reference internal\" href=\"/ja/2.0/intro/tutorial07/\"><span class=\"doc\">チュートリアル その7</span></a> に進んで、Django が自動生成する管理サイトのカスタマイズをしてみましょう。</p>\n</section>","rootId":"writing-your-first-django-app-part-6","toc":[{"title":"アプリ の構造をカスタマイズする","anchor":"customize-your-app-s-look-and-feel","children":[]},{"title":"背景画像を追加する","anchor":"adding-a-background-image","children":[]}],"breadcrumbs":[{"docname":"intro/index","title":"さぁ始めましょう","url":"/ja/2.0/intro/"}],"prev":{"docname":"intro/tutorial05","title":"はじめての Django アプリ作成、その 5","url":"/ja/2.0/intro/tutorial05/"},"next":{"docname":"intro/tutorial07","title":"はじめての Django アプリ作成、その 7","url":"/ja/2.0/intro/tutorial07/"},"formats":{"html":"/ja/2.0/intro/tutorial06/","markdown":"/ja/2.0/intro/tutorial06.md","json":"/ja/2.0/intro/tutorial06.json"},"source":"https://github.com/django/django/blob/stable/2.0.x/docs/intro/tutorial06.txt","official":"https://docs.djangoproject.com/ja/2.0/intro/tutorial06/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","zh-hans","fr","ja","id","pt-br","ko","es","el","pl"]}