Django與TEJ API (Part 1)

Photo by Carlos Muza on Unsplash

本文重點概要

  • 文章難度:★☆☆☆☆
  • Django前置作業
  • 閱讀建議: 本系列主要的目的是介紹Django套件常見的應用,以及其如何與TEJ API資料庫搭配使用,因此並不會深入討論Django的技術細節、網頁前端後端的知識。若讀者想要了解相關原理,可以參考這個學習指南,裡面的解釋得相當清楚。

前言

Django為開源的Python基於web開發而設計的應用框架,因為其擁有既定的框架、豐富的函示庫的優點,使用者能夠以更簡單、快速的方式開發網站。

本系列將會介紹Django設置環境、架構基本介紹、串接TEJ API的資料庫、建立後台資料庫、導入css, js、包裝成exe檔等等,一步一步幫助讀者建立出如同下方這種,容易維護、一目了然的財經網頁,而本週將會完整地介紹Django的開發環境建立流程,避免後期調整網頁時出現許多不必要的麻煩。

圖(一)

編輯環境及模組需求

本文使用 Windows OS 並以 Visual Studio 作為環境開發

虛擬環境建立

Step 1. 進入VS後,開啟新建立的空白資料夾 medium

圖(二)

Step 2. 進到資料夾後新增終端機,並輸入python -m venv (環境名稱)建立一個名為django_venv 的虛擬環境,這麼做的目的在於避免各種套件的版本改變而影響到專案的執行。

圖(三)

Step 3.輸入(虛擬環境名稱)Scriptsactivate 開啟虛擬環境,前方出現綠色的字即代表成功進入。此時可放心使用pip安裝Django套件,記得之後只要進到這個專案、安裝套件,都要進到這個虛擬環境

圖(四)

建立專案

Step 1. 終端機輸入 django-admin.py startproject finance(專案名),會在medium資料夾底下產生名為 finance(可自行取名) 專案資料夾,產生的檔案結構如左邊所示

圖(五)

Step 2. 進入finance專案資料夾後,輸入 python manage.py runserver (port)啟動簡單的網站伺服器。若不輸入則預設port為8000,這邊可按當前使用狀況自行調整

圖(六)

Step 3. 點擊下方網站連結,即可看到專案在網站伺服器上成功執行的畫面

圖(七)

新增應用 (app)

當專案較大時,通常會將其分成多個項目(app)獨立開發,因此這邊我們也需要於專案資料夾底下建立 app

Step 1. 若不想關掉已開啟的網頁伺服器,可再新增一個終端機,並以綠字確定目前仍在虛擬環境。接著進到專案資料夾內輸入 python manage.py startapp dashboard生成第一個app,這邊將其取名為 dashboard(可自行改名),最後可以看到左邊多了dashboard這個app資料夾。

圖(八)

Step 2. 為了讓Django知道新建立的app也需要納入管理,因此要從左方版面進到設定檔 (financefinancesettings.py)調整。找到INSTALLED_APPS區塊,並新增反白區塊(剛剛建立的APP名稱)後儲存。

圖(九)

Step 3. 目前專案資料夾下的檔案結構

finance
├── manage.py
├── finance
│   ├── __init__.py
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
└── dashboard
    ├── __init__.py
    ├── admin.py
    ├── migrations
    ├── models.py
    ├── tests.py
    └── views.py

結論

本文主要介紹的是Django開發的前置作業,包含虛擬環境、專案與app的建立,其中有不少細節需要注意,像是虛擬環境的進入、檔案結構的認識與設定檔的修改,否則之後會出現很多問題,也因此才會獨立出一篇文章來介紹。在確保目前專案資料夾沒有問題之後,我們便能於下篇文介紹Django的MTV架構與開始建立財經網頁的雛形!

延伸閱讀

相關連結

返回總覽頁
Procesing