asciidoctor ghpages action
v2.3.0 :: Support git-lfs repos
CI 워크 플로에서 asciidoc github 페이지를 구축하는 github 액션. 모든 adoc 파일을 html 로 재귀 적으로 변환하여 README.html index.html 로 바꾸어 생성 된 모든 HTML 및 기존 파일을 gh-pages 브랜치로 푸시합니다. Antora와 같은 멋진 것이 필요하지 않으면이 작업은 간단한 Asciidoc 웹 사이트를 게시하는 방법 일 수 있습니다. 그러나보다 체계적인 웹 사이트가 필요하다면 Jekyll Asciidoc Quickstart가 당신을위한 것일 수 있습니다.
작업을 구성하면 GitHub 페이지는 http://your-username.github.io/your-repository 에서 제공됩니다.
조치가 실행될 때마다 gh-pages BRING이 삭제됩니다. CI 워크 플로 이외의 내용을 수동으로 추가하면 콘텐츠가 손실됩니다. |
우리는이 저장소를 Github 페이지에 게시하여 우리 자신의 약을 맛보십시오.
YML 워크 플로 파일에 작업을 추가하면됩니다. ASCIIDOCTOR 도구에 전달되는 작업에 추가 매개 변수를 제공하여 빌드를 선택적으로 사용자 정의 할 수 있습니다.
여기에서 전체 워크 플로 파일을 확인할 수 있습니다. GitHub Action 인터페이스를 사용하지 않고 해당 파일을 저장소 내부의 동일한 장소로 복사하면 상자에서 작동 할 수 있습니다.
"원격 : GitHub-Actions [BOT]에 거부 된 GIT 허가"오류가 발생하면 액세스 Settings > Actions > General 및 Read and write permissions 선택하십시오.
이 작업을 통해 AsciIdoc 파일에서 ebook.pdf 파일의 자동 생성을 활성화 할 수 있습니다. PDF는 gh-pages 지점으로도 밀립니다. 이를 가능하게하려면 다음 구성 만 추가하십시오.
pdf_build : true샘플 PDF eBook은 여기에서 제공됩니다.
이 조치를 통해 asciidoctor vacking.js 슬라이드를 구축 할 수도 있습니다. Slides.html 파일을 gh-pages 브랜치에 생성합니다. 다음 구성을 사용할 수 있습니다.
slides_build: boolean 슬라이드를 구축 할 수 있습니다. html 파일 (default false)
slides_main_adoc_file: string 슬라이드를 빌드하기 위해 asciidoc 소스 파일의 이름을 정의합니다 (기본 'readme'). 파일 확장자를 포함하지 마십시오.
slides_skip_asciidoctor_build: boolean 슬라이드를 생성하려면 asciidoctor 명령을 사용하여 일반 HTML 파일의 빌드를 skippig (default false)를 활성화합니다.
여러 asciidoc 문서에서 웹 사이트를 만드는 방법을 확인하려면이 샘플 리포지토리를 확인하십시오. 포르투갈어에만 있지만 구조를 얻을 수 있습니다.
동작은 간단하지만 다른 AsciIdoc 파일에서 여러 페이지가있는 웹 사이트를 만드는 방법을 보여주기 위해 세부 사항은 별도의 페이지에 제공됩니다. 위의 링크가 a : (i) github 리포지토리 에서이 페이지를 열 때 (i) github 페이지 에서이 페이지를 열 때 html 파일을 열 때 A : (i) adoc 파일을 가리 킵니다.
GitHub 페이지는 gh-pages 브랜치에 CNAME 파일이 필요합니다. 그러나 모든 행동이 실행되면 gh-pages 지점이 지워집니다. 사용자 정의 도메인을 작동 시키려면 main 또는 master 브랜치의 루트 디렉토리에 CNAME 파일을 추가하면 gh-pages 브랜치에 자동으로 복사됩니다. source_dir 구성이있는 경우 CNAME 파일이 구성된 source_dir 내부에 있어야합니다.
