FSWikiから GitLab Pages と HonKit に載せ替えた話 - Qiita
この記事は、Wano Group Advent Calendarの12日目の記事です。 前置き 社内にはかなりたくさんのドキュメントがあるのですが、FSWikiという、とても年季のはいったシステムで動いていました。 変えたいよねーという話は幾数年前から言われてきたのですが、代替するものとして決定打にかけて放置されてました(単に忙しかっただけかもしれない)。 今回、意を決してGitLab Pagesに載せ替えました。 載せ替え候補にあがったもの 検討した載せ替え候補とやめた理由を雑に書いておきます。 GitLab Wiki ... 一覧性が悪い。 Notion ... 気軽に壊せすぎる。PlantUML使えない。 Docbase ... 階層構造不可 Confluence ... 重い 他にも色々検討したものの、すべて帯に短しタスキに長しだし、お金払わないといけないし...といことで、最終的
mdocで書いたScalaドキュメントをHonkitとGitHub Actionsを使ってGitHub Pagesに自動デプロイする
Scala のプロジェクトのドキュメントを mdoc で書いて、Honkit と GitHub Pages でドキュメントを公開し、GitHub Actions でデプロイを自動化する、までをやってみました。 サンプルコード 本記事で作成したサンプルコードです。 サンプルコードは下記の GitHub Pages にデプロイされています。 プロジェクトの作成 まず、ベースとなる Scala プロジェクトを作成します。 ドキュメントを作りたい既存のプロジェクトがあれば、そのプロジェクトを用いてください。 % sbt new sbt/scala-seed.g8 [info] welcome to sbt 1.3.13 (Oracle Corporation Java 10.0.1) [info] loading settings for project global-plugins from i
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
