岩石です。この間の日曜日、横浜で開催された カメラと写真映像の展示会 CP+2016に行ってきました。
天気も良かったので、山下公園や赤レンガ倉庫などを一人で歩きながら、会場に向かいました。
日々の気忙しい感じからリフレッシュできた気がしています。
当の会場の方では、カメラも大好きなので堪能しましたが、展示の作りやセミナーの構成など特に注目していました。
弊社もよく展示やセミナーなど行いますので、今後の参考にできたら良いなと感じています。
前回のブログでは、社内の規程類の文書管理として文書の作成をSphinx、版管理をMercurial(アプリケーションとしてはKallithea)で管理していることを書きました。
今回はその公開について書きます。
文書の作成に使用するSphinxでは、 reStructuredText形式 で書かれた文書のソースファイルから様々な形式の文書を作成することが可能です。
例えば、
その他拡張を行うと
などの出力も出来るそうです。
弊社では、皆が簡単に閲覧することを考え、 html形式 で出力し各自のPCからブラウザで閲覧することにしました。
html形式の文書をブラウザで皆が閲覧するとなると、Webサーバが必要となります。
htmlの文書を公開するために大きなサーバを用意するのはもったいないです。
ブラウザで閲覧するのは静的なページですので、サーバスペックも高性能なものは必要ありません。
弊社ではRaspberry PIを使う事にしました。
Raspberry PI
先日Raspberry PI 3も発表され、高性能化が益々進むボードコンピュータですが、弊社で使用しているのはメインメモリ256MBで、媒体がSDカードの初代のRaspberry PI 1 Model Aです。
このサーバにリポジトリから文書のソースファイルをダウンロードし、サーバ上でhtmlファイルを生成して公開の準備ができあがります。
静的なページのみですので、静的ファイルの転送が速い(と言われている?)nginxで配信をしています。
プルリクエストが取り込まれリポジトリが更新された場合も、簡単な操作でサーバ側のファイルを更新し、最新の文書を生成します。
リポジトリが更新されたのを判別し、自動的に最新文書の生成まで行う仕組みも検討しましたが、
などを考慮し手動での操作としています。
文書を作成・更新する際の、
と、この一連の作業について権限を分離し、それぞれの権限者が行うことで、改訂の承認や最新で誤りの無い文書の公開が行える仕組みとしています。
しかしながら、文書がそこにあるとわかっていても、積極的に見る理由が無ければ、存在を忘れてしまいがちです。
弊社の業務はほとんどがWebのシステムを利用していることから、強い働きかけでは無いですが、ブラウザでサーバにアクセスしたときに最初に表示するページを業務のリンク集として作成し、 社内ポータル として利用できるようにしました。
私は、ブラウザの初期画面をこのポータルに設定し、常にこの画面から業務に進むようにしています。
ポータルのリンクは、用途で分類し、必要性や緊急性を考え、順序を決めて並べています。
となっています。
最初に表示する、一番上の画面では、弊社イメージキャラクターの村井容子さんの写真を使っています。
2回に分けて、弊社の社内文書管理の話を書かせていただきました。
2024年5月11日 オライリー本の全冊公開日のお知らせ(もくもく勉強会も同時開催) ファーエンドテクノロジーが所蔵するオライリー本(全冊)公開日のご案内です。公開日には「もくもく勉強会」も同時開催します。 |
|
入門Redmine 第6版 出版記念企画セミナー「Redmineのアクセス制御」【2024/5/30開催】 入門Redmine 第6版(2024年3月23日発売)の書籍から「Redmineのアクセス制御」について解説します。 |
|
My Redmine 初回ご契約で「入門Redmine 第6版」プレゼントのお知らせ Redmineのクラウドサービス「My Redmine」を初めてご契約いただいたお客様にRedmine解説書「入門Redmine 第6版」を進呈いたします。 |
|
2024年度ブランドパートナーに島根県在住のモデル ユイさんを継続起用 ユイさん(モデルスタジオミューズ所属)をファーエンドテクノロジーの2024年度ブランドパートナーとして継続して起用します。 |
|
Redmineの最新情報をメールでお知らせする「Redmine News」配信中 新バージョンやセキュリティ修正のリリース情報、そのほか最新情報を迅速にお届け |