Gov.uk Frontend Jinja เป็นเครื่องมือชุมชนของระบบออกแบบ gov.uk ทีมระบบการออกแบบไม่รับผิดชอบและไม่สามารถสนับสนุนคุณได้ ติดต่อผู้ดูแลโดยตรงหากคุณต้องการความช่วยเหลือหรือคุณต้องการขอคุณสมบัติ
พื้นที่เก็บข้อมูลนี้ให้ชุดมาโคร jinja ที่สมบูรณ์ซึ่งได้รับการปรับปรุงให้ทันสมัยและสอดคล้องกับ 100% กับ Macros Nunjucks Frontend Frontend Nunjucks ดั้งเดิม การพอร์ตเป็นแบบแมนนวลโดยเจตนาแทนที่จะเป็นแบบอัตโนมัติเพื่อให้การอัปเดตง่ายกว่าการบำรุงรักษารูทีนการแปลงอัตโนมัติ ชุดทดสอบที่ครอบคลุมทำให้มั่นใจได้ว่าการปฏิบัติตามส่วนหน้าล่าสุดและทุกครั้งที่ตามมา Gov.uk Frontend
หากคุณกำลังมองหาการสร้างแอพ Flask ที่โดดเด่นอย่างเต็มที่ซึ่งรวมเข้ากับ Gov.uk Frontend Jinja และ Gov.uk frontend wtforms โปรดใช้ที่เก็บเทมเพลต Frontend Flask Flask Gov.uk เพื่อสร้างแอปของคุณ
ตารางต่อไปนี้แสดงเวอร์ชันของ Gov.uk Frontend Jinja ที่คุณควรใช้สำหรับ Frontend Gov.uk เวอร์ชันเป้าหมายของคุณ:
| gov.uk frontend jinja เวอร์ชัน | Target Gov.uk Frontend เวอร์ชัน |
|---|---|
| 3.4.0 | 5.7.1 |
| 3.3.0 | 5.6.0 |
| 3.2.0 | 5.5.0 |
| 3.1.0 | 5.4.0 |
| 3.0.0 | 5.1.0 |
| 2.8.0 | 4.8.0 |
| 2.7.0 | 4.7.0 |
| 2.6.0 | 4.6.0 |
| 2.5.0 | 4.5.0 |
| 2.4.0 | 4.4.1 |
| 2.3.0 | 4.2.0 |
| 2.2.0 | 4.1.0 |
| 2.1.0 | 4.0.1 |
| 2.0.0 | 4.0.0 |
| 1.6.0 | 3.15.0 |
| 1.5.1 | 3.14.0 |
| 1.4.0 | 3.13.0 |
| 1.3.0 | 3.12.0 |
| 1.2.1 | 3.11.0 |
| 1.1.0 | 3.10.2 |
| 1.0.0 | 3.8.1 |
| 0.2.1 | 3.7.0 |
Gov.uk Frontend รุ่นอื่น ๆ ที่ไม่ได้แสดงด้านบน อาจ ยังเข้ากันได้ แต่ยังไม่ได้รับการทดสอบและตรวจสอบโดยเฉพาะ
หลังจากเรียก pip install govuk-frontend-jinja ให้แน่ใจว่าคุณบอก jinja ว่าจะโหลดเทมเพลตจากการใช้ PackageLoader ได้อย่างไรดังนี้:
from flask import Flask
from jinja2 import ChoiceLoader , PackageLoader , PrefixLoader
app = Flask ( __name__ )
app . jinja_loader = ChoiceLoader (
[
PackageLoader ( "app" ),
PrefixLoader ({ "govuk_frontend_jinja" : PackageLoader ( "govuk_frontend_jinja" )}),
]
)ในการใช้ส่วนประกอบในเทมเพลตโครงการของคุณคุณต้องนำเข้าและโทรหาแมโครคอมโพเนนต์และส่งผ่านตัวเลือกที่เกี่ยวข้องเช่น:
{%- from 'govuk_frontend_jinja/components/button/macro.html' import govukButton -%}
{{ govukButton({ 'text': "Save and continue" }) }} ตัวเลือกที่มีให้กับมาโครส่วนประกอบแต่ละตัวสามารถพบได้ในเอกสารประกอบระบบการออกแบบ Gov.uk ดั้งเดิม เนื่องจากโครงการนี้เป็นพอร์ตที่เหมือนกันความแตกต่างเพียงอย่างเดียวระหว่างตัวอย่าง Nunjucks และ Jinja เทียบเท่าของพวกเขาคือต้องอ้างชื่อคีย์เช่น 'text' แทน text
การทดสอบจะทำงานในท่อดำเนินการของ GitHub แต่ถ้าคุณต้องการเรียกใช้ในพื้นที่คุณจะต้องติดตั้ง Govuk-Frontend-Diff
มีเซิร์ฟเวอร์ทดสอบที่ tests/utils/app.py ซึ่งคุณจะต้องเรียกใช้โดยใช้คำสั่งต่อไปนี้:
(cd tests/utils && python -m flask run --port 3000) จากนั้นคุณสามารถเรียกใช้การทดสอบโดยใช้ govuk-frontend-diff ดังนี้:
./govuk-frontend-diff http://localhost:3000 --govuk-frontend-version=v4.8.0 ทั้งหมดนี้ถูกห่อหุ้มด้วย ./test.sh สำหรับการทำงานแบบง่าย (ต้องใช้ Docker)
เราใช้ semver สำหรับการกำหนดเวอร์ชัน สำหรับเวอร์ชันที่มีให้ดูที่แท็กในที่เก็บนี้
เรายินดีต้อนรับการมีส่วนร่วมจากชุมชน หากคุณต้องการมีส่วนร่วมในโครงการนี้โปรดตรวจสอบหลักปฏิบัติหลักปฏิบัติและแนวทางการบริจาค
วิธีอัปเดตแพ็คเกจนี้หลังจากเปิดตัว Gov.uk Frontend ใหม่:
govuk-frontend เปรียบเทียบแท็กที่เข้ากันได้ล่าสุดและแท็กล่าสุดเช่น https://github.com/alphagov/govuk-frontend/compare/v4.3.1...v4.4.0package/govuk/components/<component>/template.njk อ่าน diff และใช้การเปลี่ยนแปลงเดียวกันกับเทมเพลต Jinja เทียบเท่าใน govuk_frontend_jinja/templates/components/<component>/macro.htmlNone การตรวจสอบแอตทริบิวต์ที่ซ้อนกันตรวจสอบความยาวของรายการอาร์เรย์หรือตัวดำเนิน not is inดูรายชื่อผู้มีส่วนร่วมทั้งหมดใน GitHub
ซอฟต์แวร์นี้มีให้ "เป็น" โดย ไม่มีการรับประกัน การสนับสนุนมีให้บนพื้นฐาน "ความพยายามที่ดีที่สุด" โดยผู้ดูแลและชุมชนโอเพ่นซอร์ส
หากคุณเป็นข้าราชการพลเรือนคุณสามารถลงทะเบียนไปยังพื้นที่ทำงาน Digital Slack ของรัฐบาลสหราชอาณาจักรเพื่อติดต่อผู้ดูแลที่ระบุไว้ข้างต้นและชุมชนของผู้คนที่ใช้โครงการนี้ในช่อง #Govuk-Design-System
มิฉะนั้นโปรดดูแนวทางการบริจาคสำหรับวิธีการเพิ่มรายงานข้อผิดพลาดหรือคำขอคุณสมบัติ