같이, 본원 asciidoc 문법 쓰기를 사용했다.
= Asciidoctor - PDF 생성 PDF 파일
Pinnsvin [email protected]
V1.0} {docdate
: plantuml-서버 URL : https://www.plantuml.com/plantuml
: TOC :
: 문서 타입 : 기사
: imagesdir : ../images
// 글꼴 멋진 수 있도록
아이콘 : 글꼴
//이 UI를 사용
: 실험 :
: 소스 -highlighter : 루즈
: idprefix : ID_
설명 ==
asciidoctor-pdf은 https : 조직 개발 Asciidoctor의 유지에 의해, 플러그로 변환 asciidoc 새우 PDF 문서에 사용되는 Asciidoctor, 호스팅 링크입니다 //github.com/asciidoctor/asciidoctor-pdf [GitHub의, 문서 간략하게 설명하는 이 플러그인 공식에서 내용의 일부를 사용합니다.
== 설치
사용 보석 설치
...
$ 보석 asciidoctor-PDF를 설치
....
구문 강조 지원
루즈 (추천, 최소 버전 : 2.0.0)는
....
$ 보석 루즈를 설치
....
Pygments는
....
$ 보석 pygments.rb를 설치
....
CodeRay는
....
$ 보석 coderay 설치
...
단지 필요가 구문 강조, 사용 .adoc다음 머리에 문서를 작성을 :
....
: 소스 - 형광펜 : 루즈
....
== 사용
기본 명령, asciidoc은 변환 된 PDF 될
...
$ asciidoctor-PDF 기본-example.adoc
$ #이 두 명령은 동일하지만, 상부의 명령보다 간결
$의 asciidoctor -r asciidoctor-PDF -b PDF basic- example.adoc
....
우리는 문서가 중국어가 포함되어있는 경우, 초기 변환 시간은 문제가 깨진 것, 설명해야한다. 솔루션 참조 링크 : 중국 문제를 왜곡 ID_ [중국 깨진] 섹션.
== 내가 자리 표시 자입니다
새로운 섹션은 무엇 후속은
== 문제
=== 중국어 쓰레기 문제
문서가 중국어가 포함되어있는 경우, 때 초기 변환 문제를 왜곡됩니다. 여기에 간단한 기본 테마 asciidoctor-PDF입니다. 당신이 asciidoctor-PDF 도움말 문서에 액세스 할 수있는 경우, 당신은 그가 정의 테마를 지원합니다 알고있다. 그 이유는 중국이 아닌 중국 리드에 사용되는 기본 테마 글꼴을 왜곡하기 때문에, 우리는 중국어 글꼴을 추가 할 필요가있다. 선택할 수있는 두 가지 해결책이 있습니다 :
- 프로젝트 / 사용자 테마 만들기
프로젝트와는 차이가 모두 사용자의 고정 된 폴더에 저장, 예를 들어의 저장 위치와 동일하지 않습니다, 같은 방법으로 사용자를 작성 ~/.config/adoc, 단지 사용 명령의 정확한 경로를 채우기 위해 시간을 생성합니다.
====
- 새로운 adoc의 경우 파일 아이콘 : 폴더 [] 글꼴 폴더, 중국 아이콘으로 글꼴을 복사 : 폴더 [] 글꼴 폴더
- 복사 asciidoctor-PDF 설치 디렉토리 아이콘 : 파일 []
data/themes/default-theme.yml현재 디렉토리, 또는 새로운 아이콘을 만들 : 파일을 [] theme.yml - 편집 수정하는
default-theme.yml주요 노드의 내용을 :
....
글꼴 :
Cataog :
노래 : # 노래는, 그 글꼴 파일은 다음 글꼴 포함 확인하십시오
STSONG.TTF : 일반
굵게 : STSONG.TTF
기울임 : STSONG.TTF
BOLD_ITALIC : STSONG.TTF
자료 :
# 글꼴을 설정
FONT_FAMILY : 노래
리터럴 :
FONT_FAMILY : 노래
.... 生成PDF
....
$ asciidoctor-의 PDF -a PDF를 스타일 = 기본-theme.yml -a PDF-fontsdir = 글꼴 test.adoc
...
====기본 테마
보기 아이콘 : 파일 [] ../bin/asciidoctor-pdf파일을 [] : 소스 코드, 그를 실제로 아이콘을 사용하여 참조하는 ../../lib/asciidoctor/pdf.rb우리가이 루비 파일을 볼 수 있습니다, 그들은 아이콘으로 이전 발견 : [폴더] ../asciidoctor-pdf폴더, 그 아이콘 : 폴더 [] ../lib/asciidoctor-pdf, 이는 아이콘이 포함되어 있습니다 파일을 [] theme_loader.rb, 기본 테마로드 아이콘이 될 것이라는 점을 것을을 발견, 소스 코드를 읽은 후,이 파일을 계속 볼 : 파일을 [] data\themes\base-theme.yml이 부하 존재하지 않는 경우, data\themes\default-theme.yml것을 수단 base-theme.yml에 비해 우선 순위가 default-theme.yml높은, 우리는 변경해야 할 base-theme.yml내용을 . 주요 / 사용자 ## 테마 섹션 ##과 함께 프로젝트를 만들 변경하는 것은 동일합니다. 수정이 완료되면, 다음 만이 수행해야합니다
...
$ asciidoctor-의 PDF test.adoc
....
아니면 수정할 수 있습니다 default-theme.yml, 당신은 주제 생성 된 파일을 지정해야하거나 자신의 테마 파일을 만듭니다
...
$ asciidoctor-의 PDF -a PDF를 스타일 = 기본-theme.yml test.adoc
....
HTTPS :이 개 솔루션 위의 당신의 마음에없는 경우에, 당신은 다음 링크를 참조 할 수 있습니다 //github.com/chloerei/asciidoctor-pdf-cjk-kai_gen_gothic [asciidoctor-PDF-CJK-kai_gen_gothic]는 asciidoc은이 프로젝트, 주로 지원 CJK 각주에 사용하는 PDF 테마 프로젝트 : [CJK 통합 표의 문자 (CJK 통합 표의 문자), 등 중국어 간체, 중국어 번체, 한국어, 일본어 및 지원.