django-template-mảnh vỡ là một người trợ giúp cho các mẫu được sử dụng trong khuôn khổ client JavaScript.
Introduction
Thông thường, khi bạn sử dụng một client-side khung javascript (ví dụ như xương sống / ember / góc / wathever), bạn sẽ muốn mẫu nhỏ để làm cho trang của bạn. Vấn đề bắt đầu khi:
- Bạn vẫn muốn để có thể sử dụng django mẫu động cơ
- Và bạn muốn có một nơi mát mẻ để định nghĩa các mẫu nhỏ của bạn.
Đó là 2 vấn đề mà ứng dụng django này cố gắng giải quyết. Nó cũng đi kèm với các chức năng trợ giúp cho những loại mẫu, như templatetags nguyên văn từ 1,5 django đang dev mà cho phép bạn xác định một khu vực nơi django sẽ không giải thích bất cứ điều gì để tránh xung đột với các ngôn ngữ như mẫu mustache.js.
Với nó, bạn xác định tất cả các mẫu nhỏ của bạn trong cùng một thư mục và bạn sẽ có thể truy cập chúng trong các mảnh vỡ javascript đối tượng chứa (đưa ra bởi django) mẫu.
Cài đặt
Từ pip:
pips cài đặt django-template-mảnh
Từ setup.py:
git clone git: //github.com/Psycojoker/django-template-fragments.git
cd django-template-mảnh
python setup.py cài đặt
Tạo một thư mục mà bạn muốn để lưu trữ các mảnh vỡ của bạn, sau đó thêm FRAGMENTS_DIR để settings.py của bạn, nó phải là một đường dẫn tuyệt đối.
Tôi muốn xác định FRAGMENTS_DIR của tôi như thế này:
os nhập khẩu
PROJECT_PATH = os.path.abspath (os.path.split (__ __ tập) [0])
SUBPROJECT_PATH = os.path.split (PROJECT_PATH) [0]
FRAGMENTS_DIR = os.path.join (SUBPROJECT_PATH, "mảnh vỡ")
Điều này sẽ đặt nó vào thư mục project_name / mảnh (nơi settings.py của bạn là trong project_name / project_name / settings.py).
Tiếp theo, hãy viết một số đoạn html nhỏ trong thư mục này.
Sau đó, thêm một cái gì đó như thế này để urls.py của bạn
url (r '^', bao gồm ('fragments.urls')),
Và ở đâu đó trong mẫu cơ sở của bạn
Điều này sẽ cung cấp cho bạn một mảnh đối tượng javascript có chứa tất cả các mảnh vỡ của bạn, chính là tên tập tin của phân mảnh mà không có phần mở rộng.
Ví dụ: object_list.html sẽ có thể truy cập vào các đoạn phản đối như thế này: fragments.object_list
Nếu bạn đặt đoạn trong một subdir trong FRAGMENTS_DIR, chìa khóa sẽ là tên tập tin mà không có phần mở rộng của Trung Quốc cùng với đường dẫn subdir nơi / được thay thế bởi _.
Không rõ ràng? Dưới đây là một ví dụ: tập tin FRAGMENTS_DIR / một / hai / three.html sẽ có thể truy cập tại one_two_three trọng.
hỗ trợ HamlPy
Nếu bạn có HamlPy cài đặt và rằng tên mảnh của bạn kết thúc với .haml, django-template-mảnh vỡ sẽ đưa nó vào tài khoản và sử dụng HamlPy để tạo ra html.
tag Verbatim
Bạn có phải đặt mảnh vỡ trong các ứng dụng cài đặt của bạn trong settings.py này để làm việc.
Tôi đã lấy mã từ các chi nhánh dev của django 1.5 cho phép việc sử dụng các templatetags đúng nguyên để tránh xung đột giữa cú pháp django mẫu và cú pháp mẫu động cơ khác (ví dụ như bộ ria mép).
Ví dụ:
{% Tải mảnh vỡ%}
{{}} Will_be_interpreted
{% Nguyên văn%}
{{}} Wont_be_interpredted
{% Endverbatim%}
Bạn cũng có thể chọn một thẻ đóng cụ thể như mô tả trong tài liệu hướng dẫn django.
Ví dụ từ doc:
{% Tải mảnh vỡ%}
{% Myblock verbatim}%
& Nbsp; Tránh mẫu vẽ qua {% nguyên văn%} {% endverbatim%} block.
{% Endverbatim myblock%}
file Bỏ qua phần mở rộng
By django-template-mảnh mặc định bỏ qua mọi tập tin kết thúc bằng một trong những: pyc .swo SWP ~
. Bạn có thể chỉ định một danh sách riêng của bạn bằng cách xác định FRAGMENTS_IGNORED_FILE_TYPES trong settings.py của bạn
Yêu cầu :
- Python
- Django
Bình luận không