asciidoc

GitHub ActionsでAsciiDocをPDF出力しよう(3) Azure

GitHub ActionsでAsciiDocをPDF出力しよう(3)

はじめに 前回の「出力編」はPDF出力を行うにあたり、これまで手作業で環境を構築してきた方やリポジトリ内のファイルがどのように準備されるか知りたい方を対象に手順を中心に出力までを説明しました。 今回は「解説編」としてHTML出力からの変更点としてPDF出力の仕組みの理解を深めるとともに、PDF出力の…
GitHub ActionsでAsciiDocをPDF出力しよう(2) Azure

GitHub ActionsでAsciiDocをPDF出力しよう(2)

はじめに 前回はAsciiDocをPDFで出力するための基礎知識としてHTMLとPDFのフォーマットの違いとAsciidoctorに関する違いにフォーカスして説明しました。 今回から「出力編」と「解説編」に分けてPDF出力を行う方法について説明します。今回の「出力編」の内容はサンプルリポジトリをクロ…
GitHub ActionsでAsciiDocをPDF出力しよう(1) Azure

GitHub ActionsでAsciiDocをPDF出力しよう(1)

はじめに 前回までの記事でGitHub Actionsを利用したAsciiDoc出力の全体の流れについて仕組みを交えて説明してきました。今回からは再びAsciiDocの利用方法に目を向け、より便利に利用できるような使い方の紹介として「PDF出力」について解説します。PDF出力については複数回の構成に…
GitHub ActionsのAsciiDoc用アクションの仕組み(1) Azure

GitHub ActionsのAsciiDoc用アクションの仕組み(1)

はじめに 前回の記事で環境構築が面倒だと考えられていたAsciiDocが気軽に利用できることを簡単に紹介しました。今回からは前回まで利用した「Analog-inc/asciidoctor-action」の内容の解説を通してアクションの利用方法に理解を深めるとともに、利用する外部アクションの安全性も解…
GitHub Actionsを使って気軽にAsciiDocを出力しよう(2) Azure

GitHub Actionsを使って気軽にAsciiDocを出力しよう(2)

はじめに 前回の記事で環境構築が面倒だと考えられていたAsciiDocが気軽に利用できることを簡単に紹介しました。 今回は前回実際に利用したワークフローの内容に基づき本来PythonやRubyが必要な環境をなぜこんなに簡単に利用できるのか?を解説したいと思います。 今回の内容を通してお読みいただけれ…
GitHub Actionsを使って気軽にAsciiDocを出力しよう(1) Creative Solution

GitHub Actionsを使って気軽にAsciiDocを出力しよう(1)

はじめに AsciiDocを利用したいけど環境構築は面倒くさい。エンジニアが気軽に出版レベルのドキュメントを作成したりWikiより管理の容易なナレッジを作成するのに役立つAsciiDoc。その面倒な環境構築をほとんど抜きにしてGitHubでホスティングするだけでHTML作成まで自動化する方法を紹介し…
AsciiDocを利用してエンジニアのナレッジを上手に集約しよう Creative Solution

AsciiDocを利用してエンジニアのナレッジを上手に集約しよう

はじめに 流用性・検索性が高いドキュメントの作成は今後のエンジニアに求められるスキルの一つです。一方で社内ではPowerPointやWordによるドキュメント作成が頻繁に行われる事が多いのではないでしょうか?PowerPointやWordは即時性が高いフォーマットですが、流用性・検索性を確保し続ける…