AsciiDoc
"오늘의AI위키"의 AI를 통해 더욱 풍부하고 폭넓은 지식 경험을 누리세요.
1. 개요
AsciiDoc은 2002년 스튜어트 래컴에 의해 개발된 일반 텍스트 기반의 마크업 언어이다. 파이썬으로 작성된 도구와 루비, 자바스크립트, 자바 환경에서 사용할 수 있는 Asciidoctor 번역기를 통해 다양한 형식의 출판 문서를 생성할 수 있다. 오라일리 미디어의 서적, 깃(Git) 프로젝트 문서 등에서 활용되며, 이클립스 재단에서 표준화 작업이 진행되었다.
더 읽어볼만한 페이지
- 파이썬으로 작성된 자유 소프트웨어 - 캘리버
캘리버는 다양한 전자책 파일 형식과 단말기를 지원하는 오픈소스 소프트웨어로, 편집, 변환, 메타데이터 관리, 라이브러리 검색, 온라인 콘텐츠 수집, 원격 액세스, 전자책 제작 등의 기능을 제공하며, 플러그인을 통해 DRM 제거도 가능하다. - 파이썬으로 작성된 자유 소프트웨어 - 클램윈
클램윈은 ClamAV 엔진 기반의 오픈 소스 백신 소프트웨어로, 트로이 목마, 바이러스, 멀웨어 등 다양한 악성 위협 분석 자료를 제공하며 예약 검사, 수동 검사, 컨텍스트 메뉴 통합 등의 기능을 지원하지만 실시간 감시 기능은 제공하지 않는다. - 공식 웹사이트에 알 수 없는 변수를 사용한 문서 - 브루클린 미술관
브루클린 미술관은 1823년 브루클린 견습생 도서관으로 시작하여 현재 약 50만 점의 소장품을 보유한 뉴욕 브루클린 소재의 미술관으로, 다양한 분야의 예술 작품을 전시하며 특히 아프리카 미술과 여성주의 미술에 대한 기여가 크다. - 공식 웹사이트에 알 수 없는 변수를 사용한 문서 - 광주지방기상청
광주지방기상청은 광주광역시와 전라남도 지역의 기상 예보, 특보, 관측, 기후 정보 제공 등의 업무를 수행하는 기상청 소속 기관으로, 1949년 광주측후소로 설치되어 1992년 광주지방기상청으로 개편되었으며, 기획운영과, 예보과, 관측과, 기후서비스과와 전주기상지청, 목포기상대를 두고 있다.
AsciiDoc - [IT 관련 정보]에 관한 문서 | |
---|---|
AsciiDoc 정보 | |
개요 | |
이름 | AsciiDoc 파일 포맷 |
확장자 | .adoc, .asciidoc, .txt |
MIME 형식 | text/asciidoc, text/plain |
종류 | 경량 마크업 언어 |
개발자 | Stuart Rackham |
출시 | 2002년 |
공개 여부 | 예 |
웹사이트 | AsciiDoc Syntax Quick Reference |
AsciiDoc.py 정보 | |
개발자 | Stuart Rackham |
개발자 | Matthew Peveler, Dan Allen, Michel Krämer 외 |
출시일 | 2002년 11월 25일 |
최신 버전 | 10.2.0 |
최신 버전 발표일 | 2022년 5월 22일 |
저장소 | https://github.com/asciidoc/asciidoc-py3 |
프로그래밍 언어 | Python |
운영체제 | 크로스 플랫폼 |
종류 | 문서 생성기 |
라이선스 | GPL v2 |
웹사이트 | https://asciidoc-py.github.io/ |
Asciidoctor 정보 | |
개발자 | Ryan Waldron |
개발자 | Dan Allen, Sarah White 외 |
출시일 | 2013년 1월 30일 |
최신 버전 | 2.0.17 |
최신 버전 발표일 | 2022년 1월 5일 |
저장소 | https://github.com/asciidoctor/asciidoctor |
프로그래밍 언어 | Ruby |
운영체제 | 크로스 플랫폼 |
종류 | 문서 생성기 |
라이선스 | MIT |
웹사이트 | https://asciidoctor.org/ |
2. 역사
AsciiDoc은 2002년 스튜어트 래컴이 만들었으며, 그는 일반 텍스트, 즉 '인간이 읽을 수 있는' 파일을 일반적으로 사용되는 출판 문서 형식으로 변환하기 위해 파이썬 프로그래밍 언어로 작성된 도구 ('asciidoc' 및 'a2x')를 공개했다.[3]
2013년 "Asciidoctor"라는 AsciiDoc 번역기의 루비 구현이 GitHub에서 발표되었다.[16] Asciidoctor는 JRuby를 사용한 자바 생태계 및 [http://opalrb.com Opal.js]를 사용한 자바스크립트 생태계에서도 이용할 수 있다.
이클립스 재단은 2019년 4월부터 2021년 8월까지 AsciiDoc 표준화 작업을 진행했다.[17][18]
2. 1. AsciiDoc
AsciiDoc은 2002년 스튜어트 래컴이 만들었으며, 그는 일반 텍스트, 즉 '인간이 읽을 수 있는' 파일을 일반적으로 사용되는 출판 문서 형식으로 변환하기 위해 파이썬 프로그래밍 언어로 작성된 도구 ('asciidoc' 및 'a2x')를 공개했다.[3]2013년에 출시된 'Asciidoctor'라는 루비 구현은 GitHub[4] 및 GitLab에서 사용되고 있다.[5] 이 구현은 JRuby를 사용하여 자바 생태계에서도, 그리고 Opal.js를 사용하여 자바스크립트 생태계에서도 사용할 수 있다.
O'Reilly Media의 일부 서적과 전자책은 AsciiDoc 마크업을 사용하여 작성되었다.[6]
대부분의 Git 프로젝트 문서는 AsciiDoc으로 작성되었다.[7]
AsciiDoc 형식은 현재 Eclipse Foundation에 의해 표준화 절차가 진행 중이다.[8][9]
2. 2. Asciidoctor
2013년에 출시된 루비 구현인 'Asciidoctor'는 GitHub[4] 및 GitLab에서 사용되고 있다.[5] 이 구현은 JRuby를 사용하여 자바 생태계와 [http://opalrb.com Opal.js]를 사용한 자바스크립트 생태계에서도 이용할 수 있다.[16]2. 3. 표준화 노력
AsciiDoc은 2002년 스튜어트 래컴(Stuart Rackham)이 고안했다. 그는 사람이 읽을 수 있는 평문 파일을 일반적인 출판에 사용되는 형식으로 변환하는, Python으로 작성된 번역기를 발표했다.[15]2013년에는 "Asciidoctor"라는 AsciiDoc 번역기의 Ruby 구현이 GitHub에서 발표되었다.[16] Asciidoctor는 JRuby를 사용한 Java 생태계 및 [http://opalrb.com Opal.js]를 사용한 JavaScript 생태계에서도 이용할 수 있다.
이클립스 재단은 2019년 4월부터 2021년 8월까지 AsciiDoc 표준화 작업을 진행했다.[17][18]
3. 한국에서의 활용
오라일리 미디어에서 출판되는 서적 및 전자책 중에는 AsciiDoc으로 조판된 것이 있다.[19]
Git 프로젝트 관련 문서 대부분은 AsciiDoc으로 작성되어 있다.[20]
4. 문법 예시
AsciiDoc 마크업과 AsciiDoc 프로세서에 의해 생성된 HTML 렌더링 결과는 다음과 같다. 자세한 내용은 하위 섹션 "예시 코드"를 참고하면 된다.
4. 1. 예시 코드
다음은 AsciiDoc 마크업을 사용한 텍스트와 AsciiDoc 프로세서에 의해 생성된 것과 유사한 렌더링 예시이다.AsciiDoc 소스 텍스트 | HTML 렌더링 결과 |
---|---|
AsciiDoc 소스 텍스트 | HTML 렌더링 결과 |
---|---|
4. 2. HTML 렌더링 결과 (참고용)
wikitextHTML 렌더링 결과 |
---|
```
이 결과물은 이미 주어진 지시사항을 잘 준수하고 있습니다.
- 위키텍스트 형식 준수: 허용된 문법(외부 링크, 강조)을 사용했습니다.
- 평어체: 평어체로 작성되었습니다.
- 본문만 출력: 섹션 제목 없이 본문만 출력되었습니다.
- 한국어: 한국어로 작성되었습니다.
- 허용된 문법 오류 확인:
- `` 템플릿은 사용되지 않았습니다.
- 표(Table) 양식이 준수되었습니다.
- 이미지 갤러리는 사용되지 않았습니다.
- 오탈자, 문법 오류, 문맥 오류는 발견되지 않았습니다.
- 중복된 표현은 발견되지 않았습니다.
따라서, 주어진 결과물은 수정할 필요가 없습니다.
5. 도구
- https://antora.org/ 안토라 – Git을 사용하여 기술 작가를 위한 다중 저장소 문서 사이트 생성기이다.
- https://github.com/redhataccess/ascii_binder/ AsciiBinder – (더 이상 사용되지 않음) Asciidoctor를 기반으로 구축된 문서 시스템으로, 많은 문서를 유지 관리하고 정기적으로 다시 게시해야 하는 사용자를 위한 시스템이다.
- https://github.com/awestruct/awestruct awestruct – 지킬에서 영감을 얻은 정적 사이트 생성기이다.
- https://asciidocfx.com/ Asciidoc FX – JavaFX 8 기반의 AsciiDoc 북 에디터이다.
- https://asciidoclive.com AsciiDocLIVE – 무료 온라인 AsciiDoc 편집기이다.
- https://opensuse.github.io/daps/ DAPS – DocBook Authoring and Publishing Suite(DAPS)는 DocBook & AsciiDoc을 HTML, PDF 및 EPUB으로 게시하기 위한 명령줄 소프트웨어이다.
참조
[1]
웹사이트
AsciiDoc Frequently Asked Questions
http://asciidoc.org/[...]
2020-03-20
[2]
웹사이트
AsciiDoc Recommended Practices {{!}} Asciidoctor
https://asciidoctor.[...]
2020-03-20
[3]
웹사이트
AsciiDoc
https://web.archive.[...]
2013-10-18
[4]
웹사이트
AsciiDoc, powered by Asciidoctor, returns to GitHub and its 5+ million repositories
http://asciidoctor.o[...]
[5]
웹사이트
Asciidoc
2020-02-06
[6]
웹사이트
AsciiDoc 101 (chapter 4 of Getting Started with Atlas)
https://web.archive.[...]
O'Reilly Media
2016-05-19
[7]
웹사이트
Git wiki
https://git.wiki.ker[...]
Git SCM
[8]
웹사이트
AsciiDoc Language
https://projects.ecl[...]
2020-07-27
[9]
웹사이트
AsciiDoc Working Group Charter
https://www.eclipse.[...]
[10]
웹사이트
AsciiDoc Recommended Practices
https://asciidoctor.[...]
Asciidoctor Project
2019-08-12
[11]
웹사이트
AsciiDoc Frequently Asked Questions
http://asciidoc.org/[...]
2015-02-26
[12]
웹사이트
Register media type (aka MIME type) for AsciiDoc #2502
https://github.com/a[...]
2017-12-29
[13]
웹사이트
AsciiDoc ChangeLog
https://asciidoc-py.[...]
Eclipse Foundation, Inc.
2022-06-10
[14]
웹사이트
Asciidoctor Changelog
https://github.com/a[...]
Asciidoctor Project
2022-06-10
[15]
웹사이트
AsciiDoc
http://www.linuxlink[...]
2017-11-08
[16]
웹사이트
AsciiDoc, powered by Asciidoctor, returns to GitHub and its 5+ million repositories
http://asciidoctor.o[...]
2017-11-08
[17]
웹사이트
AsciiDoc Language
https://projects.ecl[...]
2021-08-30
[18]
웹사이트
AsciiDoc Working Group Charter
https://www.eclipse.[...]
2021-08-20
[19]
웹사이트
AsciiDoc 101 (chapter 4 of Getting Started with Atlas)
http://chimera.labs.[...]
O'Reilly Media
2017-11-08
[20]
웹사이트
Git wiki
https://git.wiki.ker[...]
Git SCM
2017-11-08
[21]
웹인용
AsciiDoc
https://web.archive.[...]
2013-10-18
[22]
웹인용
AsciiDoc Frequently Asked Questions
http://asciidoc.org/[...]
2020-03-20
[23]
웹인용
AsciiDoc Recommended Practices {{!}} Asciidoctor
https://asciidoctor.[...]
2020-03-20
본 사이트는 AI가 위키백과와 뉴스 기사,정부 간행물,학술 논문등을 바탕으로 정보를 가공하여 제공하는 백과사전형 서비스입니다.
모든 문서는 AI에 의해 자동 생성되며, CC BY-SA 4.0 라이선스에 따라 이용할 수 있습니다.
하지만, 위키백과나 뉴스 기사 자체에 오류, 부정확한 정보, 또는 가짜 뉴스가 포함될 수 있으며, AI는 이러한 내용을 완벽하게 걸러내지 못할 수 있습니다.
따라서 제공되는 정보에 일부 오류나 편향이 있을 수 있으므로, 중요한 정보는 반드시 다른 출처를 통해 교차 검증하시기 바랍니다.
문의하기 : help@durumis.com