Acidoctor를 사용하여 대상 정의

3175 단어 asciidoctor
Asciidoctor에서 속성 및 Passthrough 사용
다양한 패스워드를 시도해 봤고, 스스로 해결했다.알았어. 왜 준비 안 했어?표준 기능으로 일반화할 수 있기 때문이다.
:br: pass:p[ +]

a{br}b
결과의 인상(Activedoc를 사용할 수 없기 때문에 Mardown 기법으로 결과를 재현함)
a
b
해설
  • pass: [~] 입력한 출력을 가공하지 않습니다.
  • p는 Post Replace ements의 약어입니다.[~]의 텍스트에서 Post Replace ements가 발견되었을 때 + 줄 바꿈 문자로 바꿉니다.(이런 기법은 실제로pdf에서도 순조롭게 진행될 수 있다.)
  • pass:q,p,...[~]は、「~」で書式適用、改行置換などを適用したテキストを、そのまま出力する。
  • passマクロの応用例

    PDF向けには画像を出して、HTML出力向けにはフォントを使う。

    image は macros でマクロを置換してから、passすれば良い。

    ifeval::["{backend}" == "html5"]
    :phi: pass:r[𝜙]
    endif::[]
    
    ifeval::["{backend}" == "pdf"]
    :phi: pass:macros[image:U03D5_phi_straight.svg[]]
    endif::[]
    
    {phi}
    

    そもそも、PDFはいらない子という話はあるかもしれないが、アイコン等を埋め込んだ文書を作るには良いのかもしれない。

    HTMLタグを埋め込む

    ルビを入れることもできる。PDFは無理。
    この例は、pass 指定しないと、 AsciiDoc 文書と思われて、&や<>などの記号が通常の文字に置換されてしまう。pass指定で、生のHTMLをそのまま出力できる。

    ifeval::["{backend}" == "html5"]
    pass:[<ruby><rb>hello world</rb><rp>(</rp><rt>こんにちは世界</rt><rp>)</rp></ruby>]
    endif::[]
    

    こういうのは、属性とあわせて使うと力を発揮するものと思われる。
    ただ、外道(道を外れた使い方)ではある。こういうのに頼らずに済めばよいのだが、まずは出来ることが重要。

    太字のマークアップ付きの属性を定義する

    q は quote の略。太字/斜体(slant?)/オーバーライン/アンダーラインなど、マークアップを変換した後、passthrough する。html的に言うと、 Z--quote-><strong>Z</strong>--pass-><strong>Z</strong>의 느낌에 적용.

    :ZZ: pass:q[**Z**]
    
    {ZZ}
    
    먼저 기록된 물건을 가공해서 외관을 좋게 해라.
    필기를 하고 나서.
    ----
      i     j
    1 2 3 4 5 6
    1 2 3 5 4 6
    1 2 5 3 4 6
    1 5 2 3 4 6
    
    1 5 2 3 4 6
    1 5 3 2 4 6
    1 5 3 4 2 6
      ^     ^
    ----
    
    강조하고 싶은 곳에 표시를 하다
    [subs="quotes"]
    ----
      i     j
    1 2 3 4 *5* 6
    1 2 3 *5* 4 6
    1 2 *5* 3 4 6
    1 *5* 2 3 4 6
    
    1 5 *2* 3 4 6
    1 5 3 *2* 4 6
    1 5 3 4 *2* 6
      ^     ^
    ----
    
    결과 표시

    끝말
    Activedoc가 attribute를 능숙하게 사용할 수 있다면 굵게, 기울임꼴을 포함하는 입력을 간소화할 수 있습니다.나는 필기도 매우 실용적이라고 생각한다.
    참고 자료
  • How to insert sequential blank lines · asciidoctor/asciidoctor Wiki ...
  • 매크로 테이블
    설명서를 보면 기재가 있으니, 우선.

    좋은 웹페이지 즐겨찾기