はじめに 手順書等のドキュメントを Markdown で書いて Git でバージョン管理したい! でも、周りの方が必ずしも Markdown や Git に明るくなかったり、Markdown → PDF 等に変換しても結局それを配るのが手間だったり。。。 そこで、 Markdown で書く GitLab でバージョン管理する 静的サイトとして GitLab Pages にホスティングする ファイルが更新されたら自動でサイトも更新 サイトから簡単に編集できる という環境を今話題の(もう落ち着いたかな?) GitLab + GitLab CI (+ 静的サイトジェネレータの Hugo)を使って作ってみます。 サンプル 以下に公開していますので、参考になれば。 サンプルリポジトリ サンプルサイト
![GitLab CI + GitLab Pages + Hugo を使ってドキュメント管理環境を構築する - Qiita](https://cdn-ak-scissors.b.st-hatena.com/image/square/76e77a4dd725083deda9aab4ab84e561da6acd4e/height=288;version=1;width=512/https%3A%2F%2Fqiita-user-contents.imgix.net%2Fhttps%253A%252F%252Fcdn.qiita.com%252Fassets%252Fpublic%252Farticle-ogp-background-9f5428127621718a910c8b63951390ad.png%3Fixlib%3Drb-4.0.0%26w%3D1200%26mark64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZ3PTkxNiZoPTMzNiZ0eHQ9R2l0TGFiJTIwQ0klMjAlMkIlMjBHaXRMYWIlMjBQYWdlcyUyMCUyQiUyMEh1Z28lMjAlRTMlODIlOTIlRTQlQkQlQkYlRTMlODElQTMlRTMlODElQTYlRTMlODMlODklRTMlODIlQUQlRTMlODMlQTUlRTMlODMlQTElRTMlODMlQjMlRTMlODMlODglRTclQUUlQTElRTclOTAlODYlRTclOTIlQjAlRTUlQTIlODMlRTMlODIlOTIlRTYlQTclOEIlRTclQUYlODklRTMlODElOTklRTMlODIlOEImdHh0LWNvbG9yPSUyMzIxMjEyMSZ0eHQtZm9udD1IaXJhZ2lubyUyMFNhbnMlMjBXNiZ0eHQtc2l6ZT01NiZ0eHQtY2xpcD1lbGxpcHNpcyZ0eHQtYWxpZ249bGVmdCUyQ3RvcCZzPTA0Y2FlOGU1ZjcyZTZmMDg4NzljMzI0OGUxNThkNjQ4%26mark-x%3D142%26mark-y%3D112%26blend64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZ3PTYxNiZ0eHQ9JTQwb3R1aHNfZCZ0eHQtY29sb3I9JTIzMjEyMTIxJnR4dC1mb250PUhpcmFnaW5vJTIwU2FucyUyMFc2JnR4dC1zaXplPTM2JnR4dC1hbGlnbj1sZWZ0JTJDdG9wJnM9NDVkMmMwMzNmNTViODJlNjBkY2YyMzkwMmQ3ZjJhZWE%26blend-x%3D142%26blend-y%3D491%26blend-mode%3Dnormal%26s%3Deb45c7056a7d19cfb36f7d44bcf68ab6)