govuk frontend jinja 다운로드 -Govuk govuk frontend jinja 소스 코드 다운로드

govuk frontend jinja

타사 구성 요소

3.4.0

다운로드

gov.uk 프론트 엔드 Jinja Macros

Gov.uk Frontend Jinja는 Gov.uk 디자인 시스템의 커뮤니티 도구입니다. 디자인 시스템 팀은 책임을지지 않으며이를 사용하여 지원할 수 없습니다. 도움이 필요하거나 기능을 요청하려면 관리자에게 직접 문의하십시오.

이 저장소는 최신 Gov.uk Frontend Nunjucks 매크로를 최신 상태로 유지하고 100% 준수하는 완전한 Jinja 매크로 세트를 제공합니다. 포팅은 자동 변환 루틴을 유지하는 것보다 업데이트를 더 간단하게 만들기 위해 자동화되지 않고 의도적으로 수동입니다. 포괄적 인 테스트 스위트는 최신 및 모든 후속 gov.uk 프론트 엔드 릴리스에 대한 준수를 보장합니다.

Gov.uk Frontend Jinja 및 Gov.uk Frontend Wtforms와 통합되는 완전히 특징 플라스크 앱을 구축하려면 Gov.uk Frontend Flask Template Repository를 사용하여 앱을 생성하십시오.

호환성

다음 표는 Gov.uk Frontend의 대상 버전에 사용해야하는 Gov.uk Frontend Jinja 버전을 보여줍니다.

Gov.uk Frontend Jinja 버전	대상 gov.uk 프론트 엔드 버전
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 프론트 엔드는 여전히 호환 될 수 있지만 구체적으로 테스트 및 검증되지 않았습니다.

사용 방법

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 Actions 파이프 라인에서 실행되지만 로컬로 실행하려면 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.4)를 비교하십시오.
package/govuk/components/<component>/template.njk 에서 템플릿에 대한 변경 사항이 있으면 Diff를 읽고 govuk_frontend_jinja/templates/components/<component>/macro.html 의 Jinja 등가 템플릿에 동일한 변경 사항을 적용합니다.
Nunjucks와 Jinja가 그 템플릿을 해석하는 방법 사이의 특유성을 고려하십시오. 예를 None 중첩 속성을 점검하고, 배열 in is not
위에서 설명한대로 테스트를 실행하십시오
예상되는 HTML 출력을 테스트 도구에서보고 한 실제 HTML과 비교하여 실패한 테스트 해결
위의 호환성 테이블에 새 행을 추가하여 Gov.uk Frontend 버전의 다음 릴리스가 타겟팅 할 것입니다.
모든 테스트가 통과되면 기여 가이드 라인을 따라 풀 요청을 제기합니다.
풀 요청이 병합 된 후 Semver 규칙에 따라 새 릴리스 및 태그를 작성하십시오.
GitHub Actions는 새 태그에서 실행되어 패키지를 작성하여 PYPI에 게시합니다. 프로젝트 페이지를 확인하여 패키지가 최신 릴리스 태그로 업데이트되었는지 확인하십시오.