asciidoctor-web-pdf

(★ 492)

Convert AsciiDoc documents to PDF using web technologies

파일 탐색기

최종 버전 다운로드 (.zip)

- - build.yml
  - release.yml
- FUNDING.yml
- asciidoctor-pdf
- asciidoctor-web-pdf
- - book.css
  - title-document-numbering.css
  - title-page.css
- asciidoctor.css
- document.css
- antora.yml
- - book.adoc
  - book.css
  - book.pdf
  - chapter_1.adoc
  - chapter_2.adoc
  - README.md
  - template.js
- - maven-security-cheat-sheet.adoc
  - maven-security-cheat-sheet.pdf
  - README.md
- - basic-example.adoc
  - basic-example.html
  - basic-example.pdf
  - document-ref.pdf
  - document.adoc
  - document.html
  - document.pdf
  - orly.adoc
  - orly.css
  - orly.html
  - orly.jpg
  - orly.pdf
  - piracy.adoc
  - piracy.html
  - piracy.pdf
  - README.md
  - report.adoc
  - report.css
  - report.html
  - report.pdf
- - complex-footer.png
  - front-cover-image.png
- - asciidoctor.svg
  - letter.adoc
  - letter.css
  - letter.pdf
  - README.md
  - signature.svg
  - template.js
- - asciidoctor.css
  - presentation.adoc
  - presentation.css
  - presentation.pdf
  - README.md
  - template.js
- - mail.svg
  - phone.svg
  - photo.jpg
  - README.md
  - resume.adoc
  - resume.pdf
  - style.css
  - template.js
- DroidSansMono-Regular.woff2
- NotoSerif-Bold.ttf
- NotoSerif-BoldItalic.ttf
- NotoSerif-Italic.ttf
- NotoSerif-Regular.ttf
- OpenSans-Italic.ttf
- OpenSans-Light.ttf
- OpenSans-LightItalic.ttf
- OpenSans-Regular.ttf
- OpenSans-SemiBold.ttf
- OpenSans-SemiBoldItalic.ttf
- - document-converter.js
  - stem.js
  - syntax-highlighter.js
- browser.js
- cli.js
- converter.js
- lock.js
- metadata.js
- outline.js
- pdf-destinations.js
- - header-content.hbs
- prepare-binaries.js
- update-font-face.js
- paragraph.njk
- - anchor-with-diacritics.adoc
  - black-title-page.css
  - collapsible-block.adoc
  - custom-template-override.adoc
  - custom.css
  - debug.js
  - docinfo-pdf.html
  - document-with-counters.adoc
  - document-with-left-toc.adoc
  - document-with-only-title.adoc
  - document-with-source-code.adoc
  - document-with-source-code.pdf
  - document-with-stem.adoc
  - document-with-title-and-section.adoc
  - document-with-title-preamble-and-section.adoc
  - footnotes.adoc
  - highlighted-code-near-page-break.adoc
  - list-split-across-pages.adoc
  - list.adoc
  - ordered-list-numbering-across-pages.adoc
  - orphaned-table-header.adoc
  - orphaned-table-header.css
  - press.css
  - repeat-table-elements.adoc
  - running-elements-book-docinfo-running-pdf.html
  - running-elements-book-no-docinfo.adoc
  - running-elements-book.adoc
  - section-ids.adoc
  - section-ids.pdf
  - sections.adoc
  - showtitle-disabled.adoc
  - sidebar-avoid-page-break.adoc
  - simple-docinfo-footer-pdf.html
  - simple-docinfo-running-pdf.html
  - simple.adoc
  - source-code-split-across-pages.adoc
  - stem-custom-page-size.adoc
  - stem-custom-page-size.css
  - table-cell-long-word.adoc
  - table-column-alignment.adoc
  - table-frame-with-grid-rows.adoc
  - table-spanning-pages.adoc
  - table-with-images-marker.png
  - table-with-images-spanning-pages.adoc
  - theme.css
  - title-page-metadata.adoc
  - title-page.adoc
  - toc-macro-dot-leader.adoc
  - toc-preamble-book-doctype.adoc
  - variable.css
- - .gitkeep
- cli_test.js
- converter_test.js
- docker-smoke-test.md5sum
- Dockerfile
- document_convert_test.js
- helper.js
- metadata_test.js
- pdf_test.js
- templates_test.js
.dockerignore
.editorconfig
.gitignore
antora-playbook.yml
biome.json
CHANGELOG.md
CLAUDE.md
CONTRIBUTING.adoc
Dockerfile
LICENSE
Makefile
netlify.toml
package-lock.json
package.json
README.md
RELEASE.md
renovate.json5

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/ggrossetie/asciidoctor-web-pdf

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd asciidoctor-web-pdf

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. 공식 설치 스크립트

쉬움 추천

사전 준비물

Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다.

npm i -g asciidoctor-pdf

npm 레지스트리에 배포된 패키지를 전역으로 설치합니다. 소스 클론이 필요 없습니다.

✅ 설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

3. Docker

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Docker Desktop 컨테이너를 빌드하고 실행하려면 필요합니다. 설치 후 실행해서 백그라운드에 켜두세요.

docker run --rm ggrossetie/asciidoctor-web-pdf --version

빌드된 이미지를 실제 컨테이너로 실행합니다.

✅ 터미널에 docker compose ps 를 입력해 컨테이너들이 Up 상태인지 확인하세요. README에 포트 번호가 적혀있다면 브라우저에서 http://localhost:포트번호 로 접속해보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

4. Node.js

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

npm i -g asciidoctor-pdf

npm 레지스트리에 배포된 패키지를 전역으로 설치합니다. 소스 클론이 필요 없습니다.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

5. Make

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.

make

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

✅ 에러 없이 끝나면 성공입니다. 생성된 실행 파일을 직접 실행해보세요.