• Home
• コーポレートブログ
• RedMica（Redmine互換のオープンソースウェア）のユーザーズガイドを作りました

石原です。2月にRedMica ユーザーズガイド（https://redmica-guide-ja.readthedocs.io/）を公開しました。今回原稿作成を担当したのでそのお話をしたいと思います。

『RedMica ユーザーズガイド』を公開　Redmine互換のプロジェクト管理オープンソースソフトウェアのリファレンス

RedMica ユーザーズガイドとは

RedMicaとは 、プロジェク管理ソフトウェア「Redmine」互換のオープンソースソフトウェアです。開発はファーエンドテクノロジーが行っています。半年ごとの定期的なバージョンアップにより、Redmineの次期バージョンの新機能を先行して利用できる特徴があります。

RedMica ユーザーズガイドは、RedMicaの管理者向けの機能や設定画面を解説したリファレンスです。半年ごとにバージョンアップするRedMicaの使い方をいつでも参照できるよう作成しました。プロジェクトの設定項目やRedMica全体の管理画面の設定などを一つ一つ解説しています。リファレンスはRedMicaにあわせて作成していますが、RedMicaはRedmineと互換性があるのでRedmineユーザーの方にも活用いただけます。

Sphinxを使用

今回、Redmineの書籍「入門Redmine 第4版」（弊社代表取締役前田著）の原稿をもとにユーザーズガイドの原稿を作成しました。入門Redmine 第4版は2014年に発売された書籍でRedmine 2.6に対応しています。それ以降のRedmineに追加された設定の解説を追加するのと、変更された設定の解説を更新するのが今回の作業です。画面も変わっているのでスクリーンショットを撮って差し替えました。

原稿の作成には、ドキュメント生成ツール Sphinx を使用しました。Sphinxを使用して執筆された書籍でも紹介されているとおり「入門Redmine 第4版」の原稿はSphinxで作られているためです。今回初めてSphinxを利用したので、インストールから始めました。環境準備はSphinx-Users.jpのサイトを参考にしました。

1. Sphinxをインストール
   https://sphinx-users.jp/gettingstarted/install_unix.html#pip-macos-unix-linux
2. プロジェクトを作ってhtmlを作成できることを確認
   https://sphinx-users.jp/gettingstarted/make_project.html

なお、ユーザーズガイドのソースコードはGitHubに公開しています。
https://github.com/redmica/redmica-guide-ja

サポート業務で活用

My Redmineのサポート業務で「入門Redmine」を見ながら設定を確認することがあります。Webだと本を開かなくても検索をして簡単に見つけることができるし、書籍を持っていないお客様にもURLをご案内できるのが便利です。

今月はRedMica 1.3がリリースされる予定です。新しいバージョンにも対応していけるよう更新していきます。また、管理機能以外の設定や機能についての情報も今後追加していく予定です。たくさんの人に役立つユーザーズガイドを作成していきますのでぜひご活用ください！