weseek__growi/README_JP.md

Documentation / Demo

GROWI

demonstration

目次

• 機能紹介
• さっそくはじめてみる
  • docker-compose を使ってはじめる
  • Helm (Experimental)
  • オンプレミス
• 環境変数
• ドキュメント
• ライセンス

機能紹介

• 機能紹介
  • マークダウンを使用してページを階層構造で作成できます。 -> 5 分間チュートリアルはこちら
  • HackMD(CodiMd)[https://hackmd.io/] と連携することで同時多人数編集ができます。
  • - GROWI Docs: HackMD(CodiMD) 連携
  • LDAP / Active Direcotry , OAuth 認証をサポートしています。
  • SAML を用いた Single Sign On が可能です。
  • Slack/Mattermost, IFTTT と連携することができます。
  • GROWI Docs: 機能紹介
• プラグイン
  • You can find plugins from npm or github!
  • npm または github! から 便利なプラグインを見つけることができます。
• Docker の準備
• Docker Compose の準備
  • GROWI Docs: 複数の GROWI を起動
  • GROWI Docs: Let's Encrypt による HTTPS 運用

さっそくはじめてみる

docker-compose を使ってはじめる

• GROWI Docs: Launch with docker-compose (en/ja)

Helm (Experimental) でデプロイする

• GROWI Helm Chart

オンプレミスではじめる

Crowi からの マイグレーションガイドは こちら。 (en/ja)

• GROWI Docs: Ubuntu Server 上でインストール
• GROWI Docs: CentOS 上でインストール

設定

See GROWI Docs: 管理者ガイド (en/ja).

環境変数

GROWI Docs: 環境変数 (en/ja) をご覧ください。

開発環境

依存関係

• Node.js v12.x or v14.x
• npm 6.x
• yarn
• MongoDB 4.x

確認済みのバージョン をご覧ください。

Optional Dependencies

• Redis 3.x
• ElasticSearch 6.x (needed when using Full-text search)
  • 注意: 次のプラグインが必要です
  • Japanese (kuromoji) Analysis plugin
  • ICU Analysis Plugin

コマンド詳細

コマンド	説明
yarn run build:prod	クライアントをビルドします。
yarn run server:prod	サーバーを立ち上げます。
yarn start	yarn run build:prod と yarn run server:prod を呼び出します。

For more info, see GROWI Docs: List of npm Commands.

ドキュメント

• GROWI Docs
• GROWI Developers Wiki

コントリビューション

バグがありましたか？

もし、ソースコード上でバグを発見したら、GitHub Repository 上でイシューを作成してもらえると助かります。バグを修正してプルリクエストを提出してもらえるとなお助かります。 If you found a bug in the source code, you can help us by submitting an issue to our GitHub Repository. Even better, you can submit a Pull Request with a fix.

機能が足りませんか？

私たちの GitHub 上にイシューを出して新しい機能をリクエストすることができます。もし新機能を実装したい場合、まず、ご提案内容を確認させていただくために、イシューを提出してください。どのような変更を提案されるのかを明確にしていただきます。

You can request a new feature by submitting an issue to our GitHub Repository. If you would like to implement a new feature, firstly please submit the issue with your proposal to make sure we can confirm it. Please clarify what kind of change you would like to propose.

• For a Major Feature, firstly open an issue and outline your proposal so it can be discussed. 大規模な機能追加につきましては、まずイシューを open にした上で、提案された概要を説明し、議論できるようにします。 It also allows us to coordinate better, prevent duplication of work and help you to create the change so it can be successfully accepted into the project. また、より良い調整を行い、作業の重複を防ぐことで、プロジェクトに導入されるように変更を作成することができます

• Small Features can be created and directly submitted as a Pull Request.

• 小規模の機能追加につきましては イシューを作成し、直接プルリクエストを提出してください。

GitHub 上での言語について

イシューとプルリクエストの作成は英語・日本語どちらでも受け付けています。

GROWI について話し合いましょう！

もし、質問や提案があれば、私たちの Slack team にぜひご参加ください！ いつでも、どこでも GROWI について議論しましょう！ If you have questions or suggestions, you can join our Slack team and talk about anything, anytime.

ライセンス

• The MIT License (MIT)
• See LICENSE and THIRD-PARTY-NOTICES.md.