// :行頭でその行はコメントになる ////から//// :ブロック内がすべてコメント@@ -537,14 +545,14 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
- 1. オリジナル先のリンクをしっかりしておこう @@ -510,26 +511,33 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
- -
- - +
- + -
- +
- + + +
+
-
+
2. コメント類
-
+
-
コメント部分は、最終出力から除外されます
+
-
+
3. 文字飾り
-
+
-
+
-
+
-
基本
`*_`でサンドイッチすることで表現。空白含む場合は **単語A 単語B** の様に２個ずつつけるとよい
+
4. 見た目(ボタンとアイコン)
-
+
-
+
5. セクション（章節）
-
+
-
=␣<セクション>で始める行がセクションになる。セクションの区切りには空白行が必要。=の数でセクションレベルが決まる
+
-= ドキュメントのタイトル == 章最初のタイトル @@ -694,20 +702,23 @@ _イタリック_
+
6. 箇条書き
-
+
-
+
-
-
-
- +
-
*␣<項目>、-␣<項目>で始める。異なる記号を使えば、階層的に表現できる
- - +
-
形状変更は
[square],[circle],[disc]を指定
+ -
+
チェックボックスは
+*␣[ ]␣ <項目>で []の中に[x]or[*]or[ ]
- 項目1 * サブ項目1 @@ -779,29 +806,30 @@ _イタリック_ ブロックを記述できる -- - 項目2 - -.形状変更 +形状変更 [square] * square - [circle] * circle - [disc] -* disc |
+* disc
+チェックボックス
+* [*] checked
+* [x] also checked
+* [ ] not checked
+
7. 箇条書き（数字）
-
+
-
+
-
.␣<項目>（ピリオド）で始める。階層構造は…␣と連ねる。
番号は[arabic]/[decimal]/[loweralpha]/[upperroman]などで階層ごとに指定
+
8. ラベル
-
+
-
+
-
-
-
- +
-
<ラベル名>::(後ろのコロン２つ）でラベルをつける。コロンを増やせば階層化できる。
- - +
-
[horizontal]指定で一行目から、行が開始される
+
9. ブロックラベル
-
-
+
.ブロックラベル(ドット）でラベルをつける。スペースは不要。箇条書き（数字）になってしまう。
+
10. ブロック
-
+
-
+
-
-
-
- +
-
以下の記号４文字のキーワード行で囲む。それぞれ動作、意味が異なる
- - +
-
$$～ $$で囲むとパスされる → エスケープ方法
+
- コードブロックに指定できる言語
-
-+-+-
@@ -1029,7 +1057,7 @@ _イタリック_C,C++,HTML,Python,Ruby,JavaScript,JSON,Java,XML,YAML ,Clojure,CSS,Delphi,diff,ERB,Go,Groovy,HAML,Lua ,PHP,Sass,SQL,Taskpaper+
-@@ -1064,13 +1092,13 @@ echo(a,b); +11. 警告、重要、情報などのアイコン
-+-適用するには属性
:icons: fontが必要+
-@@ -1162,11 +1190,11 @@ NOTE: <内容> +-■カスタムアイコンの利用方法PNGもしくはSVGデータとしてこれらのアイコンを変更することができます。iconsフォルダにファイル名"NOTE,WARNING,IMPORTANT,TIP,CAUTION"で、拡張子を
.svgもしくは.pngのファイルを配置すればよい。+
-Table 5. アイコンの属性を変更 @@ -1193,7 +1221,7 @@ NOTE: <内容> +-@@ -1205,14 +1233,14 @@ NOTE: <内容> +- ※その他方法
-
以下でも一時的に変更することも可能。拡張子は
-:icontype: xxxと同じなら 拡張子を省略可能です+--+[NOTE, icon=NoteCustom.svg ]
====
カスタムNOTEアイコン
@@ -1225,13 +1253,13 @@ NOTE: <内容>+12. 区切り線
-+----（ハイフン）3個のみ。+
-Table 6. 区切り線 @@ -1254,20 +1282,20 @@ NOTE: <内容> +13. 改行
-+--
-
- +
-
␣+で繋ぐ。
- - +
-
もしくは
[%hardbreaks]で段落全体で改行を有効にする（段落毎にリセットされる）。ドキュメント全体で設定するなら:hardbreaks:属性をつけるとよい。個別の解除は{set:hardbreaks!}。
+
-Table 7. 改行 @@ -1292,23 +1320,23 @@ NOTE: <内容> +14. 段落 揃え
-+--
-
- +
-
[.text-left],[.text-right],[.text-center]で調整する
- - +
-
[.text-justify]はよくわからない
- - +
-
[align=xxxx]、 xxxx=left,center,right,…でもよい
+
-@@ -1343,24 +1371,24 @@ NOTE: <内容> +-This paragraph is aligned right
+-This paragraph is aligned center
+--This paragraph is aligned left. This paragraph is aligned left. This paragraph is aligned left. This paragraph is aligned left. This paragraph is aligned left. This paragraph is aligned left. This paragraph is aligned left.
+This paragraph is justified, which is the default.This paragraph is justified, which is the default.This paragraph is justified, which is the default.This paragraph is justified, which is the default.
+15. コメント
-+-// コメント行 @@ -1371,10 +1399,10 @@ NOTE: <内容>
+16. エスケープ方法
-+
-@@ -1427,13 +1455,13 @@ NOTE: <内容> +17. 特殊記号
-+-特殊記号は
{}を使う。もしくは&#<10進数>;or&#x<10進数>;など。+
-特殊記号の一覧 @@ -1685,32 +1713,32 @@ NOTE: <内容> +18. 色
-+-[色 色-background]#コンテンツ#で指定する+--+赤いコンテンツ、黄色の背景 ←
[red yellow-background]## 赤いコンテンツ、黄色の背景 ##+-
-
- +
-
色名の一覧はwikiのWebColor一覧から取れる
-+--+HTML color names
この内の基本の16種の色のみ定義されている+- asciidoctor-pdfは以下の定義みたい(rubyの中)
- @@ -1724,7 +1752,7 @@ asciidoctor-default.css
- 一覧
-
-
+
@@ -1795,22 +1823,22 @@ asciidoctor-default.css - +-※色を拡張したければインラインで定義するか、CSSを拡張するかです。
+Example 1. インラインで拡張-+--+-:SpanRed: pass:[<span style="color:#FF00FF;background-color:#00FFFF">] // Spanの終了は共通{SpanEnd} :SpanEnd: pass:[</span>]+@@ -1818,53 +1846,53 @@ asciidoctor-default.cssこのように定義しておいて
{SpanRed} 適当な文字列 {SpanEnd} → 適当な文字列+Example 2. CSSで拡張--+未記載
+-The application is called MyApp2.
+-example-caption=Example
figure-caption=Figure+-Red `sum_(i=1)\^n i=(n(n+1))/2`$ ←AsciiMathML formula
+--pass_attribute=the 'Example' ※ passすると[%hardbreaks]などリセットされちゃう
+lang={lang}
menu=
keyboad=F11
-docdate=2021-01-18
+docdate=2021-03-03
user-home=C:\Users\AA004035+19. 独自のマクロみたいなの
-+--
-
- +
-
HTML文法における
id/class指定の対応
+-<div id="baz" class="foo bar">
+-idは要素そのもののユニークなID、classはCSSの指定でスタイルを指定可能。
これは以下の２通りで表現可能
[#<ID>.<CLASSList1>.<CLASSList1>]⇐ これでよいと思う
@@ -1872,7 +1900,7 @@ user-home=C:\Users\AA004035[[<ID>]]
[role="<CLASSList1> <CLASSList1>]+-[#baz.foo.bar] ---- @@ -1886,17 +1914,17 @@ user-home=C:\Users\AA004035 ----
+-xabc
+-{ZZ} abc
+ -+-{set:cellbgcolor:gray} [grid=none, frame=none] @@ -1906,10 +1934,10 @@ user-home=C:\Users\AA004035 {set:cellbgcolor!}+-+
-@@ -1921,13 +1949,13 @@ user-home=C:\Users\AA004035 +-+-{
+
-20. リンク
-+-WebページなののURLへのリンク。<url>[リンク表示]
Windowsファイルパスの場合は、link:<path>[リンク表示]+ -+
-Table 8. タイトル例 @@ -1979,22 +2007,28 @@ Windowsファイルパスの場合は、link:<path>[リンク表示] +21. イメージリンク
-+-
-
- +
-
通常
-+--image::im.JPG[代替テキスト,x,y,.... align="right/left/center"]
+image::im.JPG[代替テキスト,x,y,.... align="right/left/center"] + +x,yは表示ピクセル数を指定するか +もしくは%を用いて実際の表示幅からの割合表示が可能 +image::im.JPG[代替テキスト,"50%"] +また明示的に記載も可能(width,height) +image::im.JPG[代替テキスト,width="50%"]
- +
インライン（行内)
-+-@@ -2002,24 +2036,24 @@ Windowsファイルパスの場合は、link:<path>[リンク表示]image:im.JPG[代替テキスト]
+---+
-行で
++行で
をいれる+22. テーブル
-+-テーブルの表現 .タイトル例
+
-@@ -2099,7 +2133,7 @@ Windowsファイルパスの場合は、link:<path>[リンク表示] +-@@ -2111,18 +2145,18 @@ Windowsファイルパスの場合は、link:<path>[リンク表示] +- 寄せの設定
-
-+-
[cols="<,>,^"]
+-+
@@ -2141,15 +2175,15 @@ Windowsファイルパスの場合は、link:<path>[リンク表示] - 寄せの設定2
- -
+-[cols="{左右}.{上下}, {左右}.{上下}, {左右}.{上下}, ..."] [cols="{左右}.{上下}, {左右}.{上下}, {左右}.{上下}, ..."]+-+
-@@ -2162,7 +2196,7 @@ Windowsファイルパスの場合は、link:<path>[リンク表示] +
-@@ -2175,7 +2209,7 @@ Windowsファイルパスの場合は、link:<path>[リンク表示] +
@@ -2194,7 +2228,7 @@ Windowsファイルパスの場合は、link:<path>[リンク表示] - 寄せの設定3
-+-行定義|の左側に<,>,^を記述する方法もある。1列ごとに改行して定義する。 ※ヘッダ行とデータ行の間に改行が必要 @@ -2204,11 +2238,11 @@ Windowsファイルパスの場合は、link:<path>[リンク表示] <.^|item
+- 列幅の設定
-
-+-
以下の自動幅autowidth:OK,様々指定方法がある。どれか一つ。 [options="header,autowidth"] @@ -2224,10 +2258,10 @@ Windowsファイルパスの場合は、link:<path>[リンク表示]
+23. テーブルを段組に使う技
-+-@@ -2239,7 +2273,7 @@ Windowsファイルパスの場合は、link:<path>[リンク表示] +
-テーブルを段組みに使う（2分割） @@ -2249,7 +2283,7 @@ Windowsファイルパスの場合は、link:<path>[リンク表示] @@ -2294,7 +2328,7 @@ Windowsファイルパスの場合は、link:<path>[リンク表示]-
画像タイトル名+-表現は以下のとおり[title="ｘｘｘ",caption="",cols="a,a",frame="none",grid="all"] @@ -2325,115 +2359,139 @@ Windowsファイルパスの場合は、link:<path>[リンク表示]
+24. テキストの折り畳み
-+-[%collapsible]で記述する
--.タイトル
+
-[%collapsible]
-$====$
-～
-$====$+-+.タイトル +[%collapsible] +==== +～ ※[%collapsiblee%open]と指定すると初期状態で展開される +====
++折り畳みテキスト
-+折り畳み内容
-25. アンカー(内部参照)
+++25. インクルード
+++++
+include::../../hoge.adoc[]で別のAsciiDocファイル指定する。 +[]内にオプションを指定できる++++include::path[leveloffset=offset,lines=ranges,tag(s)=name(s),indent=depth,opts=optional]
+++-
+
- leveloffset= +n +
-
+
セクション階層を変更する。＋の数値を指定することで、階層を下げる。マージしたadocのセクション階層と、include先のadocも単独で参照するようなケースに有効です
+
+
+26. アンカー(内部参照)
-+--
-
- +
-
内部参照へのリンクを表現する。 [[アンカー名 ]]で設定し、<<アンカー名 >>で参照する。設定された直後の章名がアンカー表示名になる。
- - +
-
アンカー参照時の表示名を別名にしたいときは、設定箇所で[[アンカー名,表示名]]とする。
- - +
-
デフォルトで、章は、アンカーが設定されており,<<_章名>>(先頭にアンダーバー)で参照できる。vscodeプレビューは日本語でリンクに飛べなかった？
+-例.
+--+-26. 属性設定のサンプル
+ -その他
-+その他
+--
-
- +
-
(済)アンカー(内部参照)
- - +
-
色名
- - +
-
本
+1. オリジナル先のリンクをしっかりしておこう
-+ -+ -+ -+ - -Nested Tables
-+Nested Tables
+ -+1. Nested tables
-+-To nest a table in a table we must use
!as table separator instead of|. Also the type of the column or cell must be set toaso Asciidoc markup is processed.+
-@@ -2477,13 +2535,13 @@ is processed. +-MyAp2
+-MyApp2
+-@@ -2491,12 +2549,12 @@ CPUここが長くなってしまうとどうする The brain of the computer.
-+-
-
- +
-
a
- - +
-
b
+-+--+ .Q and A
+-
アスキードックとは？
@@ -2542,7 +2600,7 @@ RAM
+-@@ -2555,7 +2613,7 @@ WARNING: It’s possible to use Unicode glyphs as admonition icons. +-@@ -2568,43 +2626,43 @@ WARNING: It’s possible to use Unicode glyphs as admonition icons. +-ruby, asciidocto
+-\$sqrt(4) = 2\$+-\$sqrt(4)\$+-latexmath:[C = \alpha + \beta Y^{\gamma} + \epsilon
+-An open block can be an anonymous container, or it can masquerade as any other block. pass:[dfsa]
+--An open block can be an anonymous container, or it can masquerade as any other block. dfsa
+.
まとめ
-+まとめ
+1. タイトル
-+-。。。（。。。）+
-Table 9. タイトル例 @@ -2631,14 +2689,14 @@ WARNING: It’s possible to use Unicode glyphs as admonition icons. 属性関係の設定
-+属性関係の設定
+-脱Word、脱Markdown、asciidocでドキュメント作成する際のアレコレ
+ -+-// :stylesdir: // どこでも有効になる様子 //:stylesdir:でCSSのフォルダを:stylesheet:でCSSファイルを指定可能 @@ -2651,31 +2709,31 @@ WARNING: It’s possible to use Unicode glyphs as admonition icons. // :pdf-style: themes/default-theme.yml
+--
-
- +
-
stylesdir=.
- - +
-
stylesheet=
- - +
-
pdf-style={pdf-style}
+-- +-以下のパスを書き換えた：1.2emに。 1.0が今の表示の様子。 C:\Users\AA004035\.vscode\extensions\joaompinto.asciidoctor-vscode-2.7.6\media\asciidoctor-editor.css
+.literalblock pre, .listingblock>.content>pre:not(.highlight), @@ -2690,10 +2748,10 @@ C:\Users\AA004035\.vscode\extensions\joaompinto.asciidoctor-vscode-2.7.6\media\a
+1. テストコード
-+-[IMPORTANT] ==== @@ -2705,9 +2763,9 @@ C:\Users\AA004035\.vscode\extensions\joaompinto.asciidoctor-vscode-2.7.6\media\a IMPORTANT: 本文の記載
+--+結局これが一番わかり易いかも .AsciiDocのチートシート AsciiDocのチートシート
@@ -2716,27 +2774,27 @@ IMPORTANT: 本文の記載