ロッジと呼びます。 __イントラネット限定でも使える、ナレッジ/ノウハウ情報共有サービス__です。 手軽に導入できて、チーム内全体の情報共有やナレッジ蓄積の手助けができることを目標としています。
以下のような特徴を持ちます。
- 無料、OSS、MIT License
- イントラネット内での構築が可能なので、社外秘な情報を含むナレッジやノウハウの共有に利用可能。
- Markdown記法による直感的かつ簡単な記述でサクサク書ける
- コードのシンタックスハイライト機能
- 投稿前に確認できるプレビュー機能
- ストック機能により、お気に入りの記事やあとで見たい記事等を手軽に保存
- 記事に複数のタグをつけて管理
- タグをフォローすることによる個人ごとのフィードのカスタマイズ表示
- 全文検索や各種クエリなどを利用した高度な検索機能
- 導入までの手軽さ(すぐにインストールできます)
- コメント、Contribution、通知機能等によるコミュニケーションやナレッジ共有活動の活性化
- 編集履歴機能により記事の変更点を差分表示
- メールアドレスだけで誰でも簡単にアカウント作成が可能
- Gravatarと連携したユーザアイコン(登録メールアドレスから自動取得)
上記以外にもまだまだ新機能開発や改善を行っていく予定です。皆様のご協力をお願い致します。
一覧画面
記事閲覧画面
-
事前準備として以下が必要ですので、インストールしておきます。
- Ruby 2.1, 2.2, 2.3
- Gem 2.2以上
- MySQL (MySQLを利用する場合)
- sqlite3 (sqlite3を利用する場合)
- Bundler
-
まずは本プロジェクトをcloneしてきます。
git clone https://github.com/lodge/lodge.git
-
カレントディレクトリを移動します
cd lodge -
Bundler をインストールします
gem install bundler -
config/database.example.ymlをconfig/database.ymlとしてコピーし、以下のように編集します(SQLite3もしくはMySQLをご利用になる場合はコメントアウトを外して設定すると楽です)。default: &default # # === sqlite3 === # adapter: sqlite3 # encoding: utf8 # pool: 5 # === mysql === adapter: mysql2 host: localhost username: your_mysql_user_name password: your_mysql_password encoding: utf8 pool: 5
-
bundle installを実行し、依存ライブラリをインストールします。 -
.env.exampleを.envとしてコピーし、必要な環境変数を設定します。各コメントを参考に設定してください。最低限設定が必要な項目は以下の通りです。### アプリケーションのドメイン LODGE_DOMAIN = example.com # Cookie 検証用キーの設定 # productionモードで動かす場合に設定（`bundle exec rake secret` で生成する） SECRET_KEY_BASE = __some_random_string__ # 認証キーの設定 # productionモードで動かす場合に設定（`bundle exec rake secret` で生成する） DEVISE_SECRET_KEY = __some_random_string__ ### メールの設定 # 外部 MTA (SMTPサーバ) を利用してメール送信する場合 DELIVERY_METHOD = smtp # DELIVERY_METHOD = smtp の場合のみ # 以下の設定が有効です（それ以外は無視されます） SMTP_ADDRESS = smtp.gmail.com SMTP_PORT = 587 SMTP_USERNAME = username SMTP_PASSWORD = password SMTP_AUTH_METHOD = plain SMTP_ENABLE_STARTTLS_AUTO = true # テーマを設定します。 LODGE_THEME = lodge
-
bundle exec rake db:create RAILS_ENV=productionを実行し、データベースを作成します。 -
bundle exec rake db:migrate RAILS_ENV=productionを実行し、テーブルを作成します。
github/gemojiを利用して各種絵文字を利用できます。
絵文字をダウンロードする為、以下のコマンドを実行します。
bundle exec rake emoji以下を実行し、全文検索エンジンのセットアップを行います。
./setup/sunspot-solr/setup-sunspot-solor.sh上記により、solrの基本設定及び初回のIndex構築が行われます。
新規構築から利用する場合は通常必要ありませんが、 既存のLodgeからのアップデートを行った場合のインデックス作成や、 何らかの原因で検索インデックスを再構築したくなることがあった場合は、 Solrサーバが起動した状態で下記コマンドを実行することで再構築することができます。
bin/rake sunspot:reindex RAILS_ENV=production-
カレントディレクトリを移動します。
cd <lodgeをクローンしたディレクトリ>
-
全文検索用のSolrサーバを起動します。
bin/rake sunspot:solr:start RAILS_ENV=production
-
もし上記で起動できない場合は…
前回の起動プロセスなどが残っている可能性がありますので、
bin/rake sunspot:solr:restart RAILS_ENV=production
を何度か実行してみてください。
-
-
Railsサーバを起動します。
-
Unicorn を使う場合
bundle exec unicorn -c config/unicorn.rb -E production -
Thin を使う場合
bundle exec rails server thin -e production -
WEBrick を使う場合
bundle exec rails server -e production
-
-
ブラウザで http://localhost:3000 にアクセスできたら起動成功です
-
ログファイルは以下の場所に吐き出されます
- Unicorn の場合
<lodgeをクローンしたディレクトリ>/log/unicorn.production.log
- Thin, WEBrick の場合
<lodgeをクローンしたディレクトリ>/log/production.log
- Unicorn の場合
Solrサーバを起動することにより、ポート 8983 にSolrの管理コンソールが起動し、
ブラウザからアクセスできる状態となってしまいます。
その為、悪意あるユーザがアクセスしてしまうことが懸念される場合、 以下のような対応が必要となるでしょう。
フロントにnginxなどを立てておき、リバースプロキシ等を設定しアクセスを制限する。
Solrサーバを別のサーバや立てておき、そちらに接続しにいく形にします。
その場合は、Sunspot公式サイトに従い、
config/sunspot.yml を適切な値へ設定してください。
またこのようにSolrサーバを別に構築する場合は、膨大な記事数等がある場合に、 検索や記事作成/更新時のパフォーマンスが著しく低下してしまうような場合にも有効です。 (ただ、通常はそこまでの規模になることはほぼ無いであろうと考えられます。)
VirtualBox と Vagrant を使って、
vagrant up することで、VM上に手早く開発環境を用意することができます。
-
VirtualBox をインストール
-
Vagrant をインストール
-
vagrant plugin install vagrant-vbguest -
vagrant plugin install vagrant-librarian-chef -
vagrant plugin install vagrant-vmware-fusion -
vagrant plugin install vagrant-gatling-rsync -
vagrant plugin uninstall vagrant-vmware-fusion- vagrant-gatling-rsync をインストールするために必要だが、VMWare のライセンスを持っていないとエラーになるため削除します
-
git clone https://github.com/m-yamashita/lodge -
cd lodge -
vagrant up -
VMが起動するまで待つ
-
vagrant gatling-rsync-auto-
ホスト上の
git cloneしたソースコードを自動的にVM上の/vagrantに同期するために必要です -
vagrant rsync-autoがなぜかrsync__excludeを使ってくれないため、vagrant-gatling-rsyncを利用します -
公式ドキュメントのNFSの項目 に書かれていますが、VirtualBox の共有フォルダはパフォーマンスが悪いため使用していません。
In some cases the default shared folder implementations (such as VirtualBox shared folders) have high performance penalties.
-
-
http://localhost:3000/ にアクセスして Lodge の画面を見ることができたら成功です
- アクセス URL
- DB
- MySQL
- メールサーバ
- VM 内の Postfix
- Lodge の起動スクリプト
/etc/init.d/lodge（Unicorn を起動）
- RAILS_ROOT
/vagrant
- RAILS_ENV
development
- ログ
/vagrant/log/unicorn.development.log
まだまだ拙いLodgeの開発を手助けしていただける方を大募集中です。 新機能の開発や改善はもちろん、ソースのリファクタリングからテストの記述、 果てはマニュアル改善まで、どうぞ遠慮無くpull request頂ければと思います。 開発前に開発ガイドに目を通して頂けると幸いです。
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent