Skip to content

Commit

Permalink
Merge commit 'de9083f03a7025837c79659a0a3b74a24706cae3'
Browse files Browse the repository at this point in the history
  • Loading branch information
h1romas4 committed Sep 28, 2023
2 parents 4c61ea7 + de9083f commit 31e230b
Show file tree
Hide file tree
Showing 15 changed files with 216 additions and 189 deletions.
2 changes: 1 addition & 1 deletion docs/Chapter02/images/directory-structure-1.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion docs/Chapter02/images/directory-structure-2.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion docs/Chapter02/images/directory-structure-3.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed docs/Chapter02/images/vscode-extention1.png
Binary file not shown.
Binary file removed docs/Chapter02/images/vscode-extention2.png
Binary file not shown.
232 changes: 122 additions & 110 deletions docs/index.html

Large diffs are not rendered by default.

Binary file modified docs/index.pdf
Binary file not shown.
4 changes: 2 additions & 2 deletions src/docs/asciidoc/Chapter00/index.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ Asciidoc の表現力を示すひとつの例は、このような脚注表現

手間がかかることが多い PDF 出力に関しても、フォントセットや禁則処理設定をプロジェクトに持たせることにより、実行環境に関わらず同一出力が得られるように調整しました。

Asciidoc による文書の執筆は形式的で効率が良く、また更新差分が取りやすいため、文書履歴管理や共同執筆環境としても有効です。このメリットをさらに活用するため、本手順ではテキストダイアグラム記法による図形や数式のベクター画像挿入をサポートしています
Asciidoc による文書の執筆は形式的で効率が良く、また更新差分が取りやすいため、文書履歴管理や共同執筆環境としても有効です。このメリットをさらに活用するため、本文書ではバージョン管理システムの Git やテキストダイアグラム記法による図形や数式のベクター画像挿入をフォローしています

本文書がみなさんの執筆活動のお手伝いになれば幸いです。

Expand Down Expand Up @@ -54,7 +54,7 @@ What is Asciidoctor?
Asciidoctor is a fast, open source, text processor for parsing AsciiDoc into a document model, then converting it to output formats such as HTML 5, DocBook 5, man(ual) pages, PDF, and EPUB 3. Asciidoctor is written in the Ruby programming language.
____

同プロジェクトにおいて、ウェブブラウザ上で Asciidoc の動作を実現する Asciidoctor.js や、PDF 出力を行う Asciidoctor PDF が提供されています。AsciidoctorJ は、Ruby 実装である Asciidoctor を Java でかかれた Ruby 実行環境である JRuby を使って Java VM 上で動作させるプロダクトです
同プロジェクトにおいて、ウェブブラウザ上で Asciidoc の動作を実現する Asciidoctor.js や、PDF 出力を行う Asciidoctor PDF が提供されています。また、AsciidoctorJ は、Ruby 実装である Asciidoctor を Java でかかれた Ruby 実行環境である JRuby を使って Java VM 上で動作させるプロダクトとなっています

<<<

Expand Down
6 changes: 3 additions & 3 deletions src/docs/asciidoc/Chapter01/index.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ include::../attribute.adoc[]

== Asciidoc 文書変換用スクリプトを使う準備

本手順で用いる Asciidoc 文書変換用スクリプトはビルドツールである Gradle を活用しており、実行するためには Java 実行環境が必要です。
本文書で用いる Asciidoc 文書変換用スクリプトはビルドツールである Gradle を活用しており、実行するためには Java 実行環境が必要です。

お使いのコンピューターのコマンドライン環境(macOS/Linux ではターミナル、Windows では cmd.exe か powershell.exe)で ``java -version`` コマンドを入力し、Java 11 以上のバージョンが表示されるようであれば既に環境の準備は整っています。

Expand All @@ -26,11 +26,11 @@ OpenJDK Runtime Environment Temurin-11.0.20.1+1 (build 11.0.20.1+1)
OpenJDK 64-Bit Server VM Temurin-11.0.20.1+1 (build 11.0.20.1+1, mixed mode)
----

NOTE: 本文書では Java 11 を用いて解説します。また、ビルド時に僅かに内部処理のワーニングが出力されますが Java 17 でも期待通り動作することを確認しています。Java 21 に関しては周辺ツールの対応待ちのステータスです
NOTE: 本文書では Java 11 を用いて解説します。また、ビルド時に僅かに内部処理のワーニングが出力されますが Java 17 でも期待通り動作することを確認しています。Java 21 に関しては周辺ツール対応待ちのステータスです

.Graphviz の導入
****
macOS 及び Linux の場合で、後述する PlantUML 以外のダイアグラム記法を使う場合は Graphviz の導入が必要です。この文書のサンプルソースでも使っている部分が一部ありますので、ワーニングなしに本文書の完全なファイルを生成したい場合は次のようにインストールしてください。Windows の場合、この操作は不要です。
macOS 及び Linux で、後述するダイアグラム記法の全てを変換するには Graphviz 画像ライブラリの導入が必要です。この文書のサンプルソースでも依存している部分が一部ありますので、ワーニングなしに本文書の完全なファイルを生成したい場合は次のようにインストールしてください。Windows の場合は内部で処理されるため、この操作は不要です。
[source, bash]
[caption=""]
Expand Down
Loading

0 comments on commit 31e230b

Please sign in to comment.