Template

上一章我們學到了怎麼設定網址跟對應的action，但畫面的呈現不可能永遠只有一個Hello BookStore!這麼美好。很多時候程式設計師是需要跟美術設計師合作的，通常的流程是工程師會從設計手上拿到HTML + CSS的檔案，如果你曾經用PHP開發過網站，我猜大概你可能是把拿到的.html改成.php，然後開始HTML裡面塞PHP程式碼。Django的MTV架構也差不多，而且Django雖然是Python寫的，但不同的是你不可以在Template裡寫Python的程式碼，你在Template只能用Template提供的API，以及一些filter跟tag(不管是內建或是自己寫的)。

主要的目的就是希望大家不要把以前那種寫義大利程式碼(Spaghetti code)的不良習慣帶來Django。

回來看一下我們原來的book/views.py：

from django.http import HttpResponse

def index(request):
  return HttpResponse("Hello BookStore!")

def detail(request, book_id):
  return HttpResponse("Book ID = %s" % book_id)

接著我們把原本的HttpResponse改寫成：

from django.http import HttpResponse
from django.shortcuts import render_to_response

def index(request):
  return render_to_response('book/index.html')

def detail(request, book_id):
  return HttpResponse("Book ID = %s" % book_id)

如果你有注意到shortcuts字樣，應該不難猜得出來因為這個功能太常用了，所以本來其實要寫一堆東西(例如要用loader把template抓出來，再把結果render出來)，變成一行render_to_response就搞定，我很偷懶，所以平常幾乎都是用render_to_response就夠了。

你可能會好奇，這個book/index.html要放在哪裡? 先等等，我們先改個設定，請打開專案根目錄的settings.py，在TEMPLATE_DIRS裡加一些東西：

TEMPLATE_DIRS = (
    'templates',
    # Put strings here, like "/home/html/django_templates" or "C:/www/django/templates".
    # Always use forward slashes, even on Windows.
    # Don't forget to use absolute paths, not relative paths.
)

設定這個的目的是要告訴Django要去哪邊取得template的檔案，這裡我設定了templates。接著，我們要來自己在專案根目錄底下建立一個templates的資料夾，然後結構像這樣：

原來的這行程式碼：

return render_to_response('book/index.html')

就會知道去哪邊找index.html這個檔案了。

這樣一來，你從設計那邊拿到的HTML檔案，就可以依照像index.html這樣的規則來擺放了。

Template API

前面提到，在Template裡不可以放Python的程式碼，只能放Template提到的API。什麼是Template API? 我直接從Django官網文件偷一小段程式碼來看：

Template API Demo (template_api_demo.py) download

{% if latest_poll_list %}
    <ul>
    {% for poll in latest_poll_list %}
        <li><a href="/polls/{{ poll.id }}/">{{ poll.question }}</a></li>
    {% endfor %}
    </ul>
{% else %}
    <p>No polls are available.</p>
{% endif %}