govuk frontend jinja
3.4.0
Gov.uk Frontend Jinja - это общественный инструмент системы проектирования Gov.uk. Команда System Design не несет ответственности за это и не может поддержать вас в использовании. Свяжитесь с сопровождающими напрямую, если вам нужна помощь, или вы хотите запросить функцию.
Этот репозиторий предоставляет полный набор макросов Jinja, которые поддерживаются в курсе и 100%, соответствующие оригинальным макросам Gov.uk Frontend Nunjucks. Портирование преднамеренно ручное, а не автоматизировано, чтобы обновлять обновления проще, чем поддержание автоматизированной процедуры преобразования. Комплексный набор тестов обеспечивает соблюдение последних и каждого последующего выпуска Gov.uk Frontend.
Если вы хотите построить полностью изготовленное приложение Flask, которое интегрируется с gov.uk Frontend Jinja и Gov.uk Frontend WTForms, пожалуйста, используйте репозиторий шаблона фронта Gov.uk для создания вашего приложения.
В следующей таблице показана версия Gov.uk Frontend Jinja, которую вы должны использовать для вашей целевой версии Gov.uk Frontend:
| Gov.uk frontend jinja версия | Target Gov.uk Frontend Version |
|---|---|
| 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" }) }} Параметры, доступные для каждого компонентного макроса, можно найти в оригинальной документации компонентов System Design Gov.uk. Поскольку этот проект представляет собой похожий на порт, единственная разница между примерами Nunjucks и их эквивалентами Jinja приходится цитировать ключевые имена, например, 'text' вместо text .
Тесты запускаются в конвейере действий GitHub, но если вы хотите запустить их на локальном уровне, вам нужно будет установить Govuk-Fontend-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 .
Мы используем 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 проверки вложенных атрибутов, проверять длины массива или логические операторы, такие как is , not и in .Смотрите полный список участников на GitHub
Это программное обеспечение предоставляется «как есть» без гарантии. Поддержка предоставляется на основе «лучших усилий» со стороны сопровождающих и сообщества с открытым исходным кодом.
Если вы являетесь государственным служащим, вы можете зарегистрироваться в цифровом рабочем пространстве правительства Великобритании, чтобы связаться с сохраненными вышеуподателями, и сообществом людей, использующих этот проект в канале #Govuk-Design-System.
В противном случае, пожалуйста, смотрите руководящие принципы взноса для того, как поднять отчет об ошибке или запрос функции.
