AsciidocFX

실시간 미리보기 및 다중 플랫폼 지원

AsciidocFX는 실시간 미리보기를 제공하며, Windows, macOS, Linux 등 JavaFX가 지원되는 운영 체제에서 실행할 수 있습니다.

문서 및 책 생성 기능

AsciiDoc 문서를 기반으로 PDF, HTML, Epub, Mobi 및 Docbook 형식의 책과 문서를 생성할 수 있습니다. 또한 Reveal.js 및 Deck.js를 사용한 슬라이드 생성도 지원합니다.

확장 기능 지원

PlantUML, Mermaid, ditaa, MathJax, MathML, 파일시스템 트리, JavaFX 차트 등 다양한 확장을 지원하여 UML 다이어그램, 흐름도, 수식, 파일 트리 시각화 등을 문서에 삽입할 수 있습니다.

소스 코드 하이라이팅 및 터미널 에뮬레이터

Ace 편집기를 기반으로 한 소스 코드 하이라이팅과 가상 터미널 에뮬레이터 기능을 제공하여 개발 문서 작성에 유용합니다.

설치·시작·기본 사용

JavaFX 20 런타임을 설치한 후, 공식 웹사이트 또는 GitHub 저장소에서 AsciidocFX를 다운로드하여 설치합니다. 프로그램을 실행하고 AsciiDoc 파일을 열어 편집한 후, 파일을 저장하면 됩니다. Linux에서는 Deb 또는 RPM 패키지, 아카이브 파일을 통해 설치할 수 있으며, 실행 권한을 부여한 후 bin 디렉터리에서 실행 파일을 실행합니다.

활용 예시

AsciidocFX를 사용하여 기술 문서, 전자책, 프레젠테이션 슬라이드 등을 작성할 수 있습니다. PlantUML 확장을 통해 시퀀스 다이어그램, 클래스 다이어그램 등을 텍스트로 작성하고 이미지로 변환할 수 있으며, MathJax 확장을 통해 LaTeX 또는 MathML 형식의 수식을 삽입할 수 있습니다. 파일시스템 트리 확장을 통해 폴더 구조를 문서에 자동으로 표현할 수 있습니다.

지원 환경·요구사항

JavaFX 20 런타임이 설치된 Windows, macOS, Linux 시스템에서 실행할 수 있습니다. 아키텍처는 x64를 지원하며, 일부 확장 기능은 외부 도구 설치가 필요할 수 있습니다.

제한·라이선스·확인사항

JavaFX 20 런타임이 필수이며, 다른 버전의 JavaFX 또는 JDK에서는 정상 동작하지 않을 수 있습니다. PDF 출력 시 Linux 플랫폼에서 텍스트가 모두 ####로 표시되는 알려진 문제가 있으며, 이는 Microsoft Core 폰트 설치를 통해 해결할 수 있습니다. macOS에서는 JavaFX 버그로 인해 QWERTY 키보드 레이아웃만 인식되어, 비QWERTY 레이블 사용 시 undo/redo 단축키가 swapped될 수 있습니다. 텍스트에 레인보우 아티팩트가 나타날 경우, VM 옵션에 -Dprism.text=t2k 및 -Dprism.lcdtext=false를 추가하여 해결할 수 있습니다. 이 소프트웨어는 Apache-2.0 라이선스 하에 배포됩니다.