내 워크플로우

작업 이름: Spec Prod

tl;dr: 저는 W3C 에코시스템에서 사양의 컴파일, 검증 및 배포를 단순화하는 GitHub 작업을 만들었습니다.

이 게시물은 제출만을 목적으로 합니다. 내 다른 블로그 게시물에서 작업 및 개발에 대해 자세히 알아보십시오. .

제출 카테고리:

DIY 배포

Yaml 파일 또는 코드 링크

시드비슈노이 / 사양 제품

ReSpec/Bikeshed 사양을 구축하고 출력을 검증하며 GitHub 페이지 또는 W3C에 게시하기 위한 GitHub 작업

사양 제품

이 GitHub 작업을 통해 다음을 수행할 수 있습니다.

빌드 ReSpec 및 Bikeshed 사양.

생성된 문서의 마크업을 확인하고 끊어진 하이퍼링크가 있는지 확인합니다.

생성된 사양을 GitHub Pages 및/또는 w3.org(Echidna 사용)에 게시합니다.

기본 사용법

풀 요청 중 작업은 다음과 같습니다.

은 ReSpec(index.html) 또는 Bikeshed(index.bs)

를 사용하는지 파악합니다.

ReSpec/Bikeshed 소스 문서를 일반 HTML로 변환합니다

.

깨진 하이퍼링크 검사기를 실행하고 W3C nu 유효성 검사기를 사용하여 마크업 유효성 검사

또한 커밋이 "main"브랜치로 푸시되면 작업은 빌드된 사양을 "gh-pages"브랜치로 배포합니다.

# .github/workflows/pr-push.yml
name: CI
on:
  pull_request: {}
  push:
    branches: [main]

jobs:
  main:
    name: Build, Validate and Deploy
    runs-on: ubuntu-20.04
    steps:
      - uses: actions/checkout@v2
      - uses: sidvishnoi/spec-prod@v1
        with:
          GH_PAGES_BRANCH: gh-pages

the available options에 대해 자세히 읽고 usage examples에서 배우십시오.



View on GitHub

추가 리소스/정보

이 작업을 사용하는 프로젝트

https://github.com/w3c/gamepad/

https://github.com/w3c/web-share/

and more (모든 W3C 사양 🤞) 출시 예정!