a2x - 클라우드에서 온라인

프로그램:

이름

a2x - AsciiDoc용 도구 모음 관리자(Asciidoc 텍스트 파일을 다른 파일로 변환
형식)

개요

a2x [옵션] 소스 파일

기술

AsciiDoc 텍스트 파일을 번역하는 DocBook 도구 체인 관리자 소스 파일 PDF로,
EPUB, DVI, PS, LaTeX, XHTML(단일 페이지 또는 청크), 매뉴얼 페이지, HTML 도움말 또는 일반 텍스트
형식 아시도크(1) 및 기타 응용 프로그램(필수 항목 참조). 소스 파일
확장자가 .xml인 DocBook 파일이기도 합니다.

옵션

-ㅏ --기인하다=속성
세트 아시도크(1) 속성 값(바로 가기 --asciidoc-opt="-NS 기인하다" 선택권).
이 옵션은 두 번 이상 지정할 수 있습니다.

--asciidoc-opt=ASCIIDOC_OPTS
추가 아시도크(1) 옵션. 이 옵션은 두 번 이상 지정할 수 있습니다.

--conf 파일=CONF_FILE
구성 파일을 로드합니다. CONF 파일 섹션을 참조하십시오.

-NS, --대상-디렉토리=DESTINATION_DIR
출력 디렉토리. 기본값: 소스 파일 예배 규칙서. 이 옵션은 다음에만 적용됩니다.
HTML 기반 출력 형식(청크가 된, EPUB, html도움말, xhtml).

-NS, --doctype=DOCTYPE
DocBook 문서 유형: 기사, 맨 페이지 or 책. 기본 문서 유형: 기사
형식이 아닌 경우 맨 페이지 (이 경우 기본적으로 맨 페이지).

-NS, -백엔드=백엔드
백엔드 설치된 백엔드 플러그인의 이름입니다. 이 옵션이 지정되면 a2x
파일 이름 로드 시도 a2x-backend.py 인사말 백엔드 플러그인 디렉토리 그 다음
변환 소스 파일 에 백엔드 전역 함수를 사용하여 형식화된 출력 파일
정의 a2x-backend.py 라는 to_BACKEND.

-NS, --체재=FORMAT
출력 형식 : 청크가 된, 문서 책, dvi, EPUB, html도움말, 맨 페이지, PDF (기본값), ps,
텍스, 본문, xhtml. 아스키독 a2x 형식 속성 값은 다음으로 설정됩니다. FORMAT.

-시간, --도움
명령줄 구문 및 프로그램 옵션을 stdout에 인쇄합니다.

--아이콘
출력 문서에 훈계 또는 탐색 아이콘 이미지를 사용하십시오. 기본 동작은
아이콘 대신 텍스트를 사용합니다.

--아이콘-디렉터리=PATH
경고 및 탐색 아이콘이 포함된 경로(출력 파일에 상대적). 기본값
이미지/아이콘에. NS --아이콘 이 옵션이 사용되는 경우 옵션은 암시적입니다.

-케이, --아티팩트 유지
임시 빌드 파일을 삭제하지 마십시오.

--스라소니
스라소니(1) 텍스트 형식의 출력을 생성합니다. 기본 동작은 다음을 사용하는 것입니다. w3m(1).

-엘, --no-xmllint
asciidoc 출력을 확인하지 마십시오. xmllint(1).

---이펍체크
다음을 사용하여 EPUB 출력 확인 에펍체크(1).

-N, -건조
아무 작업도 하지 말고 완료되었을 작업을 인쇄하십시오.

-NS, --자원=자원_사양
리소스를 지정합니다. 이 옵션은 두 번 이상 지정할 수 있습니다. 참조 리소스
자세한 내용은 섹션을 참조하십시오.

-미디엄, --리소스 매니페스트=FILE
FILE 목록 리소스를 포함합니다(한 줄에 하나씩). 명백한 FILE 항목이 형식화됨
처럼 --자원 옵션 인수. 환경 변수 및 물결표 홈
디렉토리가 허용됩니다.

--스타일시트=스타일시트
스타일 지정에 사용되는 하나 이상의 CSS 스타일시트 파일 이름을 공백으로 구분한 목록
DocBook XSL 스타일시트에 의해 생성된 HTML 출력. 기본값: docbook-xsl.css. 그만큼
스타일시트는 목록 순서대로 처리됩니다. 스타일시트는 유효한
리소스 파일 위치. HTML 형식에 적용: xhtml, EPUB, 청크가 된, html도움말
형식.

-V, --말 수가 많은
작동 세부 정보를 stderr에 인쇄합니다. XNUMX초 -v 옵션은 verbose 옵션을 적용합니다.
도구 체인 명령.

--번역
프로그램 버전을 stdout으로 인쇄합니다.

--xsltproc-opts=XSLTPROC_OPTS
추가 xsltproc(1) 옵션. 이 옵션은 두 번 이상 지정할 수 있습니다.

--xsl 파일=XSL_파일
사용자 지정 XSL 스타일시트로 기본 제공 XSL 스타일시트 재정의 XSL_파일.

--팝
FOP를 사용하여 PDF를 생성합니다. 기본 동작은 다음을 사용하는 것입니다. dblatex(1). 그만큼 --팝 선택권
이 옵션을 사용하는 경우 암시적입니다.

--fop-opts=FOP_OPTS
추가 맵시 꾼(1) 옵션. 이 옵션이 지정되면 FOP가 PDF를 생성하는 데 사용됩니다.
이 옵션은 두 번 이상 지정할 수 있습니다.

--dbtex-opts=DBLATEX_OPTS
추가 dblatex(1) 옵션. 이 옵션은 두 번 이상 지정할 수 있습니다.

--백엔드 옵션=BACKEND_OPTS
에 의해 지정된 백엔드 플러그인에 대한 옵션 -백엔드 옵션. 이 옵션은
두 번 이상 지정됩니다.

옵션은 AsciiDoc 소스 파일에서도 설정할 수 있습니다. 만약에 소스 파일 주석이 포함되어 있습니다
로 시작하는 줄 // 2배: 그러면 나머지 줄은 다음과 같이 처리됩니다. a2x
명령줄 옵션. 예를 들어:

// a2x 기본 옵션.
// a2x: -dbook --epubcheck
// dblatex 출력에서 ​​개정 기록을 억제합니다.
// a2x: --dblatex-opts "-P latex.output.revhistory=0"

· 여러 주석 행에 걸쳐 있는 옵션이 연결됩니다.

· 선행 사이에 공백 문자가 XNUMX개 이상 나타날 수 있습니다. // 과 2배:.

· 명령줄 옵션은 소스 파일에 설정된 옵션보다 우선합니다.

출력 파일

출력 파일은 다음에 의해 지정된 디렉토리에 기록됩니다. --대상-디렉토리 옵션. 그렇지 않은 경우
--대상-디렉토리 옵션이 설정되면 출력 파일이 소스 파일 디렉토리.

출력 파일의 이름은 다음과 같습니다. 소스 파일 그러나 적절한 파일 이름으로
확장자: .html xhtml; 에 대한 .epub EPUB; .hhp에 대한 html도움말; .pdf PDF; .텍스트
본문, .xml 문서 책. 관례상 맨페이지에는 .man 확장자가 없습니다(맨페이지 섹션
숫자만). 청크 HTML 디렉토리 이름에는 .chunked 확장자가 있습니다. 청크 HTML 도움말
디렉토리 이름에는 .htmlhelp 확장자가 있습니다.

동일한 이름의 기존 파일을 덮어씁니다.

HTML 파일을 생성하는 것 외에도 xhtml, EPUB, 청크가 된 과 html도움말 형식 보장
리소스 파일은 올바른 대상 디렉터리 위치에 복사됩니다.

리소스

리소스는 HTML 기반 출력에 필요한 파일(일반적으로 CSS 및 이미지)입니다.
(xhtml, EPUB, 청크가 된, html도움말 형식). a2x 생성된 HTML 파일을 스캔하고 빌드합니다.
필수 CSS 및 이미지 파일 목록. 추가 리소스 파일을 지정할 수 있습니다.
명시적으로 사용 --자원 옵션을 선택합니다.

a2x 다음 위치에서 다음 순서로 리소스 파일을 검색합니다.

1. 그만큼 소스 파일 디렉토리.

2. 다음에 의해 지정된 리소스 디렉토리 --자원 옵션(재귀적으로 검색됨).

3. 다음에 의해 지정된 리소스 디렉토리 --리소스 매니페스트 옵션(재귀적으로 검색됨
매니페스트 파일에 나타나는 순서대로).

4. 스톡 이미지 및 스타일시트 디렉토리 아시도크(1) 구성 파일
디렉토리(재귀적으로 검색됨).

5. 대상 디렉토리.

리소스 파일이 발견되면 올바른 상대 대상 디렉터리로 복사됩니다.
누락된 대상 하위 디렉터리가 자동으로 생성됩니다.

추가 리소스를 지정하기 위한 두 가지 고유한 메커니즘이 있습니다.

1. 누락된 리소스 파일을 재귀적으로 검색할 리소스 디렉토리.

2. 출력 대상 디렉토리에 복사될 리소스 파일.

리소스는 다음으로 지정됩니다. --자원 다음 중 하나일 수 있는 옵션 값
형식 :


[= ]
. =

어디에:


디렉토리를 지정합니다(절대 또는 상대 소스 파일) 검색되는
누락된 리소스 파일에 대해 재귀적으로 모호함을 없애기 위해 이름
디렉토리 구분 문자로 끝나야 합니다.


리소스 파일을 지정합니다(절대 또는 상대 소스 파일) 것입니다
복사 . 만약에 지정되지 않은 경우
와 동일 .


복사된 소스 파일의 대상을 지정합니다. NS 경로는
대상 디렉토리에 상대적입니다(절대 경로는 허용되지 않음). 위치
대상 디렉토리의 출력에 따라 다릅니다. FORMAT (참조 출력 파일
자세한 내용은 섹션):

청크, htmlhelp
청크된 출력 디렉터리입니다.

EPUB
아카이브된 OEBPS 디렉토리.

xhtml
출력 DESTINATION_DIR.

. =
EPUB 파일에 리소스를 추가할 때 mimetype은
file> 확장자, mimetype을 추측할 수 없는 경우 오류가 발생합니다. NS
. = 리소스 구문을 사용하여 명시적으로 mimetype을 설정할 수 있습니다. ~이다
파일 이름 확장자, 해당 MIME 유형입니다.

리소스 옵션 예:

--리소스 ../이미지/
--리소스 문서/README.txt=README.txt
--자원 ~/이미지/tiger.png=이미지/호랑이.png
--resource .ttf=응용 프로그램/x-글꼴-ttf

사용 예

a2x -f pdf doc/source-highlight-filter.txt
doc/source-highlight-filter.pdf 파일을 생성합니다.

a2x -f xhtml -D ../doc --icons -r ../images/team.txt
HTML 파일 ../doc/team.html을 만들고, 경고 아이콘을 사용하고,
누락된 리소스에 대한 ../images/ 디렉토리.

a2x -f 맨페이지 문서/asciidoc.1.txt
doc/asciidoc.1 맨페이지를 생성합니다.

필수 조건

a2x 다음 프로그램을 사용합니다.

· 아스키독: http://asciidoc.org/

· xsltproc: (텍스트를 제외한 모든 형식): http://xmlsoft.org/XSLT/

· DocBook XSL 스타일 시트 (텍스트를 제외한 모든 형식):
http://docbook.sourceforge.net/projects/xsl/

· dblatex (pdf, dvi, ps, tex 형식): http://dblatex.sourceforge.net/

· FOP (pdf 형식 — 대체 PDF 파일 생성기): http://xmlgraphics.apache.org/fop/

· w3m (텍스트 형식): http://w3m.sourceforge.net/index.en.html

· 스라소니 (텍스트 형식 — 대체 텍스트 파일 생성기): http://lynx.isc.org/

· 에펍체크 (epub 형식 — EPUB 파일 유효성 검사기): http://code.google.com/p/epubcheck/

최신 README 파일도 참조하십시오.

회의 파일

구성 파일에는 전역을 재정의하는 실행 가능한 Python 코드가 포함되어 있습니다.
a2x.py의 구성 매개변수. 선택적 구성 파일은
다음 순서:

1. a2x.conf가 포함된 디렉토리에서 a2x.py 실행 파일.

2. AsciiDoc 전역 구성 디렉토리의 a2x.conf. 다음과 같은 경우 이 단계를 건너뛰십시오.
로컬로 설치된(시스템 전체가 아닌) 복사본을 실행합니다.

3. AsciiDoc $HOME/.asciidoc 구성 디렉토리의 a2x.conf.

4. 그만큼 CONF_FILE 에 지정된 --conf 파일 옵션을 선택합니다.

다음은 기본 구성 파일 옵션 값입니다.

# 선택적 환경 변수 사전이 전달됨
# 프로그램을 실행하고 있습니다. 없음으로 설정된 경우 기존
# 환경이 사용됩니다.
환경 = 없음

# 외부 실행 파일.
ASCIIDOC = '아스키독'
XSLTPROC = 'xsltproc'
DBLATEX = 'dblatex' # pdf 생성.
FOP = 'fop' # pdf 생성(--fop 옵션).
W3M = 'w3m' # 텍스트 생성.
LYNX = 'lynx' # 텍스트 생성(w3m이 없는 경우).
XMLLINT = 'xmllint' # 비활성화하려면 ''로 설정합니다.
EPUBCHECK = 'epubcheck' # 비활성화하려면 ''로 설정합니다.
# 외부 실행 가능 기본 옵션.
ASCIIDOC_OPTS = ''
DBLATEX_OPTS = ''
FOP_OPTS = ''
XSLTPROC_OPTS = ''

onworks.net 서비스를 사용하여 온라인으로 a2x 사용