この投稿は Fujitsu Advent Calender 2016 の 12日目の記事です。 この記事に書かれた見識は個人のものであり、所属する会社・組織を代表するものではありません🐸。 12/12修正: asciidoctor-pdfインストールコマンドに誤りがありました。 サンプルのスタイルファイル名を confidential_style.yaml から public_style.ymlに変更し、機密区分表記をPublicにしました（不適当だったため）。 合わせてサンプルPDFドキュメントの画像を差し替えています。 その他タイポを修正しました。 背景・動機🐸 技術職にかぎらず、仕事をする上でドキュメントを書く機会はたくさんありますが、大なり小なり組織に所属している以上、好き勝手にオレオレフォーマットを作って、「これがオフィシャルです」・というのはなかなか難しく、組織の内で用意さ
気軽にドキュメントを書くシリーズです。 asciidocで書き、asciidoctor-pdfでさくっとPDFにするというソリューションがあるようなので試行錯誤を繰り返した結果、この.adocをこのPDFに変換できるようになりました。 使い方ではまった箇所をメモしておきます。 インストール githubのREADMEに書いてある通り、gemでインストールするだけ。 $ gem install --pre asciidoctor-pdf デフォルトのテーマでPDFに変換する asciidoctor-pdfコマンドを利用します。 $ asciidoctor-pdf basic-example.adoc 自作テーマを利用してPDFに変換する Asciidoctor PDF Theming Guideに記載されている通り、自分なりのテーマを作ることができます。テーマを自作するにあたっては、デフォル
追記4（2022/10/8） asciidoctor-pdf 2.0あたりでテーマファイルを指定する引数が変更されています。 この記事で紹介しているテーマファイルの指定方法ではうまくかなくなっています。 対応方法については、このことを気づかせてくれた記事「 asciidoctor-pdfでのテーマファイルの指定」を参照することをお勧めします。また、テーマの各パラメータにも変更があります。そちらは、asciidoctor-pdfのテーマファイルのリファレンスを見れば解決できるでしょう。 追記3（2021/07/12） この記事の説明は、asciidoctor-pdfの1.5.x までに対応したものです。 それ以外の体裁に関するテーマの設定は、まだ使えると思います（全部は確認していませんのであしからず）。 asciidoctor-pdfの1.6以降では、 asciidoctor-pdf-cjk
GitHub - asciidoctor/asciidoctor-pdf: :page_with_curl: Asciidoctor PDF: A native PDF converter for AsciiDoc based on Asciidoctor and Prawn, written entirely in Ruby.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert
asciidoctor-pdf/docs/theming-guide.adoc at main · asciidoctor/asciidoctor-pdf
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert
Asciidoctor PDFの表紙をカスタマイズする
Asciidoctor PDFの表紙をあれこれ弄ってみた記録です。 その1：標準レイアウトまずは標準レイアウトで出力してみましょう。 = Asciidoctor PDFにおける表紙生成サンプル: 標準レイアウト :author: 田中 太郎 :revdate: 2018/12/8 :revnumber: 1.0 :lang: ja :doctype: book こんな感じの表紙が生成されます。特に凝っていないドキュメントならこれで十分。 サンプル1 標準レイアウト (PDFを開く) その2：表記のカスタマイズまずは簡単なところから。アトリビュートを変更することでいくつかの表記をカスタマイズできます。 = Asciidoctor PDFにおける表紙生成サンプル: 表記のカスタマイズ :author: 田中 太郎 :revdate: 2018年12月8日 :revnumber: 1.0版 :l
はじめに 2019_09_Asciidocを使っていてせっかくAsciidoctor-PDF環境を構築したのに出力したPDFの日本語が表示されなくて困っている人へ で困っていた人になって動いている環境をそーっとしておいたのですが、再度調べたら本家が対応してくれていたのがわかったので書いておきます。 さきに結論（いままで使っていた方向け） -r asciidoctor-pdf-cjk に代わって -a scripts=cjk を使います。 asciidoctor-pdf-cjk はメンテナンス終了なので利用を止めたほうがよいです。asciidoctor-pdf 1.6.0で使うと以下のようにエラーが出ます。
デフォルトの表紙 asciidoctor-pdfでは、H1と以下2行をもとに表紙が生成されます。 = ウルトラスペシャル ハイパーギガンティックサービス サービス仕様書: ミラクルマジカル編 ほげほげ株式会社 <doc.writer@example.jp> v1.0, 2014-01-01 テーマをカスタマイズせずにPDFを生成すると、以下のような形になります。 テーマファイルを使って表紙をカスタマイズする テーマファイルのコンフィグ例をもとに、表紙をカスタマイズしてみます。 title_page: align: center title_top: 40% title_font_size: $heading_h1_font_size title_font_color: 000000 title_line_height: 0.9 subtitle_font_size: $heading_h3
Asciidoctor PDFの日本語フォントを変更する
Asciidoctor PDF は標準でもそこそこ綺麗な日本語PDFが生成できます。どうやらmplus1p-regularが適用される模様。M+ FONTSですね。 このままでも悪くないんですが、フォントを変更するとどうなるか試してみましょう。 まずはフォントの調達。Asciidoctor PDFで利用できるフォントはttfだけです。 定番のNotoファミリーを使おうと思ったのですが、あいにくttf形式で提供されていないので派生フォントから選ぶことにします。ゴシックは源真ゴシック、明朝は源樣明體をチョイス。 源真ゴシック (げんしんゴシック) | 自家製フォント工房ButTaiwan/genyo-font: Free font derived from Source Han Serif源樣明體はNoto Serif CJK(源ノ明朝)を TrueType に変換したものです。台湾の方が作っ
How to render document header at top of first main page (like a journal article) · Issue #95 · asciidoctor/asciidoctor-pdf
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert
PDFの出力において、フォントを変えたくなることがあります。現在、「asciidoctor-pdf」が対応しているフォントは、TrueTypeフォント（ttfファイル）とOpenTypeフォント（otfファイル）です。 ここでは、フリーで手に入る以下のフォントについて簡単に説明します 懐源ゴシックフリーのフォントである「源ノ角ゴシック」を、TrueType形式に変換した派生フォントです。asciicoctor-pdf用に作成されたようです。かな漢字の斜体が使用可能です！こちらからttfファイルをダウンロードすることが可能です。「Sorry, This gem is no longer maintained, I suggest follow the asciidoctor-pdf theme guides to use your local font.」となったようです。源真ゴシックフリー
asciidoctor-pdfで複数行のフッタを作る
会社のWordテンプレのフッターが複数行なので、asciidoctor-pdfで複数行のフッタを出力する方法を調べました。 テーマファイルの書き方 今回は、PDFのフッタにページ番号とコピーライトをつけます。その場合、テーマファイルを以下のように記載します。参考：Running header & footer footer: font_size: $base_font_size_small font_color: $base_font_color border_color: dddddd border_width: 0.25 height: 25mm padding: [3mm,0,0,0] vertical_align: top recto_content: center: | {page-number} / {page-count} + Copyright © hogehog
asciidoctor-pdf を使ってPDFかっこいいPDFを作る(1) の続きです。 設定を調整して見栄えのよいPDFを作成した手順を紹介しています。 追記（2021/07/12） asciidoctor-pdf 本体でフォントの対応について見直してもらえたようです。 この記事の説明のうち、フォントに関する部分については、 asciidoctor-pdfで日本語を含むPDFの出力を行う を参考にするとよいでしょう。 それ以外の体裁に関するテーマの設定は、まだ使えると思います（全部は確認していませんのであしからず）。 タイトルページを設定する タイトルページの、背景色、文字の大きさ、色、配置などを調整します。 （略） title_page: align: center background_color: DAF0EA title: top: 20% font_family: $headi
WindowsでAsciidocからPDFを作成する（Asciidoctor PDF v1.5.0 alpha 13） - Qiita
エディタはAtomを導入してみます。 Atom（https://atom.io ） インストール後、以下のPackageをインストールする。 asciidoc-preview language-asciidoc これで、Asciidocのプレビューはできちゃいます。Crtl + Shift + a でプレビューペインが開きます。 GitHub Desktop（https://desktop.github.com ） ドキュメントはGitリポジトリにある想定なのでGit環境を最も手軽に設定できるGitHub Desktopを導入します。 Ruby RubyInstaller（http://rubyinstaller.org/ ）を導入してみました。 Ruby 2.3.1 (x64)もしくはRuby 2.3.1をダウンロードしてインストール。 Ruby gemsのアップデート を参考にRuby
asciidoctor-pdf を使ってPDFかっこいいPDFを作る(1)、 asciidoctor-pdf を使ってPDFかっこいいPDFを作る(2) の続きです。 設定を調整して見栄えのよいPDFを作成した手順を紹介しています。 追記（2021/07/12） asciidoctor-pdf 本体でフォントの対応について見直してもらえたようです。 この記事の説明のうち、フォントに関する部分については、 asciidoctor-pdfで日本語を含むPDFの出力を行う を参考にするとよいでしょう。 それ以外の体裁に関するテーマの設定は、まだ使えると思います（全部は確認していませんのであしからず）。 文書にソースコードを追加する 設定の効果を見るために、先にソースコードを含む文書を用意して、現状を確認します。 example06.adocを修正してexample07.adocを作ります。 （略
PDFのドキュメントを作るのはやめよう、asciidoctor-pdfをやめた理由 - Qiita
前回、脱Word、脱Markdown、asciidocでドキュメント作成する際のアレコレでasciidocをHTMLとPDFに変換する方法を紹介した。 asciidoctor・・・asciidocファイルをHTMLファイルに変換するruby製ツール asciidoctor-pdf・・・asciidocファイルをPDFファイルに変換するruby製ツール 当初はドキュメントをHTMLとPDF両方のフォーマットで公開していた。 が、asciidoctor-pdfを使ったPDF変換はあまりにも面倒なので、メンテするのを止めた。 その理由を記載する。 理由1. 文字の色が変えられない markdownと違って、asciidocでは文字色は変えられるが、asciidoctor-pdfのバグか、文字の色が変えられない。 理由2. レイアウトが崩れる 長い表の場合などレイアウトが崩れる。 理由3. HTM
rbenvでRubyをインストールする MacOS標準のRuby (v2.3.0) を使いたくないのでrbenvをインストールする。 ここを参考に 【2018年版】macにrbenvを入れてrubyを管理できるようにしちゃう とりあえずStableバージョンの最新を入れる。 asciidoctor-pdfをインストールする こちらを参考にasciidoctor-pdfをインストールする asciidoctor-pdfでかっこいいPDFを作る(1) 上のドキュメント通りインストールしてもなぜか出力されたPDFに日本語が表示されない。 どうやら、asciidoctor-pdf-cjkでインストールされるNotoSansフォントのサブセットには日本語フォントが含まれないようだ。 そこで、CJKフォントが含まれるasciidoctor-pdf-cjk-kai_gen_gothicを追加でインストー
asciidoctor-pdf-linewrap-ja
asciidoctor-pdf-linewrap-jaというAsciidoctor PDFのextensionを作ってみました。 Asciidoctor PDFで日本語を使うときの定番はasciidoctor-pdf-cjkなんですが、コード読んでみたらかなりざっくりした処理でした。もう少し細かく禁則処理したほうがいいんじゃないかなー、と思ったのが開発の発端です。 ま、紆余曲折の末、結果的には大差ないものができたのですが、せっかく作ったし公開しちゃえ！という感じ。 gemはおろかRuby自体初めてだったので色々嵌りましたが、どうにか動くところまで漕ぎつけました。とりあえず使えるレベルにはなっているんじゃないかと思います。 以下が結果比較のためのサンプルです。 デフォルト asciidoctor-pdf-cjk asciidoctor-pdf-linewrap-ja asciidoctor-
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
asciidoctor-pdfで社内ドキュメントを書こう - Qiita
asciidocをPDFに変換してみた（asciidoctor-pdf） – Aimless
asciidoctor-pdfでかっこいいPDFを作る(1) - Qiita
asciidoctor-pdfで日本語を含むPDFの出力を行う - Qiita
asciidoctor-pdfでそれっぽい表紙を作る – Aimless
.html)
asciidoctor-pdfによるPDF出力(フォント): WAKU-TAKE-A PROGRAM
asciidoctor-pdfでかっこいいPDFを作る(2) - Qiita
asciidoctor-pdfでかっこいいPDFを作る(3) - Qiita
Asciidoctor-PDFをMacOS Mojaveにセットアップする - Qiita