検索インストールプロジェクトをビルドすると赤枠で囲んだ部分が勝手に追加されます。_siteの中にHTML版ドキュメントが作成されているGitHub等でなんとなく見覚えのあるサイトが立ち上がります(^^;)。PDFにするにはdocfx.jsonをいじる必要ありますが、HTMLだけならデフォルトで大丈夫。コードを変更しビルドする度にドキュメントが更新されます。ずぼらな人間でもこれくらいならメンテできそう。良いドキュメントを目指すならsummaryとreturns以外のタグも覚えましょう。※マークダウンファイルも追加されますが、日本語で編集する場合は文字コードをUTF-8に変える必要あり。default※nugetでインストールした場合はPathが通っていないのでdocfxの前にパスを追加必要。インストール場所が分からない場合はソリューションエクスプローラーで依存関係→NuGet→docfx.consoleを選択しプロパティで探す。実際にフォルダを開き、exeの場所を確認。エクスポートが成功すると、下記のようなフォルダが作成される。token.jsonをコピーpdf用のテンプレートと区別がつきやすいようにhtmljaとしましたが、エクスポートしたテンプレート名+jaの方が良かったかも。フォルダ名は任意です(docfx.jsonでフォルダ名指定)。ここではhtmljaで通します。token.jsonを編集そのままだと日本語を入れると文字化けするので、文字コードをユニコードに変更key:valueのvalue側を日本語に。filterがtoken.jsonに無いんですけど...。しょうがないのでエクスポートしたテンプレートの下でfilterでグレップ。toc.html.tmplがヒット。これもtoken.jsonと同じようにhtmljaフォルダ内にコピーし、必要個所を日本語に変更、文字コードをユニコードに変えて保存。ARTICLEを書き換える上記と同じ操作を繰り返す。今度のファイル(docfx.js)はstylesフォルダの下にあるので、htmljaフォルダ側でもstylesフォルダを作成し、その中にペースト。最終的には下記のような形。おまけstylesフォルダ内には空のmain.cssファイルが用意されているので、上書きしたいCSSがある場合はhtmljaのstylesフォルダ内にmain.cssを新規追加ておくと便利。Markdownでドキュメントを作成articlesフォルダにひな形が既に作成されているので、初めてのマークダウン。Editorを入れる。.mdファイルを開くと、画面が2分割され右側にプレビューが表示される。Markdown)には対応していないよう。上で編集したtoken.jsonにあった「IMPORTANT」や「WARNING」がちゃんと日本語になるかはビルドして確認。DocFXでPDF作成Information晴れの日の休日は掃除、洗濯、草引きで一日つぶれますが、雨の日は時間が余ります。