Django公式サイトのチュートリアルを咀嚼しながらやってみる

% django-admin startproject mysite

> myproject/
    + mysite/ (外側のmysite)
        + manage.py
        + mysite/ (内側のmysite)
            + __init__.py
            + settings.py
            + urls.py
            + asgi.py
            + wsgi.py
      myvenv/

% cd mysite

myproject/
  > mysite/ (外側のmysite)
        manage.py
        mysite/ (内側のmysite)
            (省略)
    myvenv/

% python manage.py runserver

% python manage.py startapp polls

myproject/
  > mysite/ (外側のmysite)
        manage.py
        mysite/ (内側のmysite)
            (省略)
      + polls/
          + __init__.py
          + admin.py
          + apps.py
          + migrations/
          + __init__.py
          + models.py
          + tests.py
          + views.py
        myvenv/

from django.shortcuts import render
# 最初から入ってるコード。
# テンプレートを使うときに必要になるらしい。
# 現時点では特に関係ないので、放っておいていい。（コメントアウトしてもいい。）

from django.http import HttpResponse
# django.http モジュールの HttpResponse を読み込む という意味。
# django.http モジュールは、具体的には
# myvenv/lib/python3.7/site-packages/django/http にある。

# import [モジュール] だと、モジュール全体
# from [モジュール] import [モジュールの属性(オブジェクト)] だとモジュールの属性
# がそれぞれ使えるようになる。そのへんの話は以下のページがわかりやすかった。

# Pythonのモジュールとimportとfrom入門 - Qiita
# https://qiita.com/niwaka_dev/items/6e3d9ff6d797243c77c3

#インデックス ページ
def index(request):
    return HttpResponse("Hello, world. You're at the polls index.")
    # 実行すると django.http モジュールの HttpResponse を使ってメッセージを返す。
    # HttpResponse はほかにも使い方いろいろ。
    # https://docs.djangoproject.com/en/3.2/ref/request-response/#httpresponse-objects

from django.urls import path
# django.urls モジュールの path を読み込んでいる。
# myvenv/lib/python3.7/site-packages/django/urls

from . import views
# from の .（ドット）は相対パスで同階層のディレクトリを意味している。
# よって同階層にある views モジュール（views.py）を読み込んでいる。

urlpatterns = [
    # ex: /polls/
    path('', views.index, name='index'),
    # polls/ (pollsのroot) にアクセスすると views.index を呼び出す という意味。
    # name は template から url を参照するときに便利らしい。
    #
    # python、djangoのurls.pyで設定するnameってなんやねん？？ - Qiita
    # https://qiita.com/sr2460/items/11a1129975913ed584d3
]
# path()
# https://docs.djangoproject.com/ja/3.2/ref/urls/#path

# path(route, view, kwargs=None, name=None)
# route: urlパターン
# view: 呼び出すview関数
# kwargs: 任意のキーワード引数を辞書としてviewに渡す
# name: urlの名前（別名？）

myproject/
    mysite/ (外側のmysite)
        manage.py
        mysite/ (内側のmysite)
            (省略)
        polls/
            __init__.py
            admin.py
            apps.py
            migrations/
            __init__.py
            models.py
            tests.py
          + urls.py
            views.py
    myvenv/

from django.contrib import admin
from django.urls import include, path
# urlpatterns で使う include を追加する。

urlpatterns = [
    path('polls/', include('polls.urls')),
    path('admin/', admin.site.urls),
]
# polls/ へのアクセスは polls.urls (polls/urls.py) を参照する。
# admin.site.urls はよくわからんけどそういうものらしい。深く考えなくていいもの。
# urlpatterns は上から順番に走査される。

% python manage.py runserver