My helpful timestamp site
            
            

              It is now {{ current_date }}.
            
            

            

              Thanks for visiting my site.
            
          

              
              

                My helpful timestamp site
              
              

                In {{ hour_offset }} hour(s), it will be {{ next_time }}.
              
              

              

                Thanks for visiting my site.
              
            

            

            

              Thanks for visiting my site.
            
          

這個叫做 base.html 的模板定義了一個簡單的 HTML 框架文檔，我們將在本站點的所有頁面中使用。 子模板的作用就是重載、添加或保留那些塊的內容。 （如果你一直按順序學習到這里，保存這個文件到你的template目錄下，命名為 base.html .）

我們使用一個以前已經見過的模板標簽： {% block %} 。 所有的 {% block %} 標簽告訴模板引擎，子模板可以重載這些部分。 每個{% block %}標簽所要做的是告訴模板引擎，該模板下的這一塊內容將有可能被子模板覆蓋。

現在我們已經有了一個基本模板，我們可以修改 current_datetime.html 模板來 使用它：

          
{% extends "base.html" %}

{% block title %}The current time{% endblock %}

{% block content %}

          

            It is now {{ current_date }}.
          
          
{% endblock %}


        

再為 hours_ahead 視圖創建一個模板，看起來是這樣的：

          
{% extends "base.html" %}

{% block title %}Future time{% endblock %}

{% block content %}

          

            In {{ hour_offset }} hour(s), it will be {{ next_time }}.
          
          
{% endblock %}


        

看起來很漂亮是不是？ 每個模板只包含對自己而言 獨一無二 的代碼。 無需多余的部分。 如果想進行站點級的設計修改，僅需修改 base.html ，所有其它模板會立即反映出所作修改。

以下是其工作方式。 在加載 current_datetime.html 模板時，模板引擎發現了 {% extends %} 標簽， 注意到該模板是一個子模板。 模板引擎立即裝載其父模板，即本例中的 base.html 。

此時，模板引擎注意到 base.html 中的三個 {% block %} 標簽，并用子模板的內容替換這些 block 。因此，引擎將會使用我們在 { block title %} 中定義的標題，對 {% block content %} 也是如此。 所以，網頁標題一塊將由 {% block title %}替換，同樣地，網頁的內容一塊將由 {% block content %}替換。

注意由于子模板并沒有定義 footer 塊，模板系統將使用在父模板中定義的值。 父模板 {% block %} 標簽中的內容總是被當作一條退路。

繼承并不會影響到模板的上下文。 換句話說，任何處在繼承樹上的模板都可以訪問到你傳到模板中的每一個模板變量。

你可以根據需要使用任意多的繼承次數。 使用繼承的一種常見方式是下面的三層法：

• ??? 創建 base.html 模板，在其中定義站點的主要外觀感受。 這些都是不常修改甚至從不修改的部分。
• ??? 為網站的每個區域創建 base_SECTION.html 模板(例如, base_photos.html 和 base_forum.html )。這些模板對 base.html 進行拓展，并包含區域特定的風格與設計。
• ??? 為每種類型的頁面創建獨立的模板，例如論壇頁面或者圖片庫。 這些模板拓展相應的區域模板。

這個方法可最大限度地重用代碼，并使得向公共區域（如區域級的導航）添加內容成為一件輕松的工作。

以下是使用模板繼承的一些訣竅：

• ??? 如果在模板中使用 {% extends %} ，必須保證其為模板中的第一個模板標記。 否則，模板繼承將不起作用。
• ??? 一般來說，基礎模板中的 {% block %} 標簽越多越好。 記住，子模板不必定義父模板中所有的代碼塊，因此你可以用合理的缺省值對一些代碼塊進行填充，然后只對子模板所需的代碼塊進行（重）定義。 俗話說，鉤子越多越好。
• ??? 如果發覺自己在多個模板之間拷貝代碼，你應該考慮將該代碼段放置到父模板的某個 {% block %} 中。
• ??? 如果你需要訪問父模板中的塊的內容，使用 {{ block.super }}這個標簽吧，這一個魔法變量將會表現出父模板中的內容。 如果只想在上級代碼塊基礎上添加內容，而不是全部重載，該變量就顯得非常有用了。
• ??? 不允許在同一個模板中定義多個同名的 {% block %} 。 存在這樣的限制是因為block 標簽的工作方式是雙向的。 也就是說，block 標簽不僅挖了一個要填的坑，也定義了在父模板中這個坑所填充的內容。如果模板中出現了兩個相同名稱的 {% block %} 標簽，父模板將無從得知要使用哪個塊的內容。
• ??? {% extends %} 對所傳入模板名稱使用的加載方法和 get_template() 相同。 也就是說，會將模板名稱被添加到 TEMPLATE_DIRS 設置之后。
• ??? 多數情況下， {% extends %} 的參數應該是字符串，但是如果直到運行時方能確定父模板名，這個參數也可以是個變量。 這使得你能夠實現一些很酷的動態功能。