{"title":"はじめての Django アプリ作成、その 6","version":"1.9","locale":"ja","docname":"intro/tutorial06","url":"/ja/1.9/intro/tutorial06/","canonical":"https://djangodocs.dev/ja/1.9/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/1.9/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\">django.contrib.staticfiles</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\">polls</code> ディレクトリの中に、 <code class=\"docutils literal notranslate\">static</code> ディレクトリを作成します。Django はそこから静的ファイルを探します。Django が <code class=\"docutils literal notranslate\">polls/templates/</code> からテンプレートを探す方法と同様です。</p>\n<p>Django の <a class=\"reference internal\" href=\"/ja/1.9/ref/settings/#std-setting-STATICFILES_FINDERS\"><code class=\"xref std std-setting docutils literal notranslate\">STATICFILES_FINDERS</code></a> は、さまざまなソースから静的ファイルを検索する方法を知っているファインダのリストです。デフォルトのファイダの一つは <code class=\"docutils literal notranslate\">AppDirectoriesFinder</code> で、<a class=\"reference internal\" href=\"/ja/1.9/ref/settings/#std-setting-INSTALLED_APPS\"><code class=\"xref std std-setting docutils literal notranslate\">INSTALLED_APPS</code></a> に書かれた各アプリケーションに対して、ちょうど今作った <code class=\"docutils literal notranslate\">polls</code> のような &quot;static&quot; サブディレクトリを検索してくれます。管理サイトの静的ファイルにも、これと同じディレクトリ構造が使われます。</p>\n<p>今作った <code class=\"docutils literal notranslate\">static</code> ディレクトリの中に、<code class=\"docutils literal notranslate\">polls</code> という名前の新しいディレクトリを作り、さらにその中に、<code class=\"docutils literal notranslate\">style.css</code> という名前のファイルを作成します。つまり、このスタイルシートは <code class=\"docutils literal notranslate\">polls/static/polls/style.css</code> に保存します。<code class=\"docutils literal notranslate\">AppDirectoriesFinder</code> の動作のしくみのおかげで、Django では、ただ <code class=\"docutils literal notranslate\">polls/style.css</code> と書くだけでこの静的ファイルを参照することができます。これは、テンプレートのパスを参照する時と同じです。</p>\n<aside class=\"admonition-static-file-namespacing admonition\" role=\"note\">\n<p class=\"admonition-title\">静的ファイルの名前空間</p>\n<p>テンプレートと同様に、<code class=\"docutils literal notranslate\">polls</code> という別のサブディレクトリを作らずに、直接 <code class=\"docutils literal notranslate\">polls/static</code> の中に静的ファイルを置いてもいいのではないか、と思うかもしれませんね。しかし、それは実際には悪い考えです。Django は、名前がマッチした最初のテンプレートを使用するので、もし <em>異なる</em> アプリケーションの中に同じ名前のテンプレートがあった場合、Django はそれらを区別することができません。そのため、Django に正しいテンプレートを教えてあげる必要がありますが、一番簡単な方法は、それらに <em>名前空間を与える</em> ことです。アプリケーションと同じ名前をつけた <em>もう一つの</em> ディレクトリの中にテンプレートを置いたのは、そういうわけなのです。</p>\n</aside>\n<p>スタイルシートに次のコードを配置します (<code class=\"docutils literal notranslate\">polls/static/polls/style.css</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=\"nt\">a</span> <span class=\"p\">{</span>\n    <span class=\"k\">color</span><span class=\"p\">:</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\">polls/templates/polls/index.html</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\">staticfiles</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\">{% load staticfiles %}</code> は、<a class=\"reference internal\" href=\"/ja/1.9/ref/contrib/staticfiles/#std-templatetag-staticfiles-static\"><code class=\"xref std std-ttag docutils literal notranslate\">{% static %}</code></a> テンプレートタグを <code class=\"docutils literal notranslate\">staticfiles</code> のテンプレートライブラリから読み込みます。そして、<code class=\"docutils literal notranslate\">{% static %}</code> テンプレートタグは、静的ファイルの絶対URLを生成します。</p>\n<p>開発でするべきことはこれだけです。<code class=\"docutils literal notranslate\">http://localhost:8000/polls/</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\">images</code> サブディレクトリを <code class=\"docutils literal notranslate\">polls/static/polls/</code> ディレクトリの中に作成します。このディレクトリの中に、<code class=\"docutils literal notranslate\">background.gif</code> という名前の画像を置きます。つまり、画像は <code class=\"docutils literal notranslate\">polls/static/polls/images/background.gif</code> に置きます。</p>\n<p>さらに、スタイルシート (<code class=\"docutils literal notranslate\">polls/static/polls/style.css</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=\"p\">{</span>\n    <span class=\"k\">background</span><span class=\"p\">:</span> <span class=\"kc\">white</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=\"kc\">no-repeat</span> <span class=\"kc\">right</span> <span class=\"kc\">bottom</span><span class=\"p\">;</span>\n<span class=\"p\">}</span>\n</code></pre></figure>\n<p><code class=\"docutils literal notranslate\">http://localhost:8000/polls/</code> をリロードすれば、画面の右下に、読み込まれた背景画像が表示されるはずです。</p>\n<aside class=\"admonition admonition-warning\" role=\"note\">\n<p class=\"admonition-title\">警告</p>\n<p>もちろん、<code class=\"docutils literal notranslate\">{% static %}</code> テンプレートタグは、スタイルシートのような Django が生成しない静的ファイル内では使用できません。そのため、2つの静的ファイルを互いにリンクするときには、必ず <strong>相対パス</strong> を使用するべきです。そうすれば、<a class=\"reference internal\" href=\"/ja/1.9/ref/settings/#std-setting-STATIC_URL\"><code class=\"xref std std-setting docutils literal notranslate\">STATIC_URL</code></a> (<a class=\"reference internal\" href=\"/ja/1.9/ref/templates/builtins/#std-templatetag-static\"><code class=\"xref std std-ttag docutils literal notranslate\">static</code></a> テンプレートタグが URL を生成する時に使われる) を変更しても、静的ファイルのパスを書き換えずに済みます。</p>\n</aside>\n<p>これらは静的ファイルの <strong>基本</strong> です。設定方法やフレームワークの機能の詳細については、<a class=\"reference internal\" href=\"/ja/1.9/howto/static-files/\"><span class=\"doc\">静的ファイルの配信</span></a> と <a class=\"reference internal\" href=\"/ja/1.9/ref/contrib/staticfiles/\"><span class=\"doc\">staticfiles のリファレンス</span></a> を読んでください。<a class=\"reference internal\" href=\"/ja/1.9/howto/static-files/deployment/\"><span class=\"doc\">静的ファイルのデプロイ</span></a> では、実際のサーバでの静的ファイルの使い方について説明しています。</p>\n<p>静的ファイルを使いこなせるようになったら、<a class=\"reference internal\" href=\"/ja/1.9/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/1.9/intro/"}],"prev":{"docname":"intro/tutorial05","title":"はじめての Django アプリ作成、その 5","url":"/ja/1.9/intro/tutorial05/"},"next":{"docname":"intro/tutorial07","title":"はじめての Django アプリ作成、その 7","url":"/ja/1.9/intro/tutorial07/"},"formats":{"html":"/ja/1.9/intro/tutorial06/","markdown":"/ja/1.9/intro/tutorial06.md","json":"/ja/1.9/intro/tutorial06.json"},"source":"https://github.com/django/django/blob/stable/1.9.x/docs/intro/tutorial06.txt","official":"https://docs.djangoproject.com/ja/1.9/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","fr","ja","id","pt-br","es"]}