wikijs-fork/README.md

171 lines
9.2 KiB
Markdown
Raw Normal View History

2017-04-22 18:20:04 +00:00
![Wiki.js](https://raw.githubusercontent.com/Requarks/wiki-site/1.0/assets/images/logo.png)
2016-08-17 18:39:30 +00:00
2017-02-15 01:48:39 +00:00
[![Release](https://img.shields.io/github/release/Requarks/wiki.svg?style=flat-square&maxAge=3600)](https://github.com/Requarks/wiki/releases)
[![License](https://img.shields.io/badge/license-AGPLv3-blue.svg?style=flat-square)](https://github.com/requarks/wiki/blob/master/LICENSE)
[![Backers on Open Collective](https://opencollective.com/wikijs/backers/badge.svg)](#backers)
[![Sponsors on Open Collective](https://opencollective.com/wikijs/sponsors/badge.svg)](#sponsors)
2017-02-15 01:48:39 +00:00
[![npm](https://img.shields.io/badge/npm-wiki.js-blue.svg?style=flat-square)](https://www.npmjs.com/package/wiki.js)
[![Downloads](https://img.shields.io/github/downloads/Requarks/wiki/total.svg?style=flat-square)](https://www.npmjs.com/package/wiki.js)
2017-10-14 19:33:13 +00:00
![Build Status](https://requarks.visualstudio.com/_apis/public/build/definitions/5850c090-02b9-4312-b4ce-0e1f5677b574/6/badge)
2017-02-15 01:48:39 +00:00
[![Codacy Badge](https://img.shields.io/codacy/grade/1d0217a3153c4595bdedb322263e55c8/master.svg?style=flat-square)](https://www.codacy.com/app/Requarks/wiki)
[![Standard - JavaScript Style Guide](https://img.shields.io/badge/code%20style-standard-brightgreen.svg?style=flat-square)](http://standardjs.com/)
2017-07-09 19:25:30 +00:00
[![Chat on Gitter](https://img.shields.io/badge/chat-on_gitter-CC2B5E.svg?style=flat-square&logo=image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAcAAAAOCAMAAADUg/YpAAAABlBMVEUAAAD///%2Bl2Z/dAAAAAXRSTlMAQObYZgAAABVJREFUeAFjwAUYYTQByAAh0WicAAAFnwAYeB5bLwAAAABJRU5ErkJggg==)](https://gitter.im/Requarks/wiki)
[![Twitter Follow](https://img.shields.io/badge/follow-%40requarks-blue.svg?style=flat-square)](https://twitter.com/requarks)
2016-08-17 01:13:48 +00:00
##### A modern, lightweight and powerful wiki app built on NodeJS, Git and Markdown
2017-08-12 19:12:37 +00:00
- **[Official Website](https://wiki.js.org/)**
- **[Getting Started](https://wiki.js.org/get-started.html)**
2017-08-12 19:12:37 +00:00
- **[Documentation](https://docs.requarks.io/wiki/)**
2017-03-19 19:35:06 +00:00
- [Requirements](#requirements)
- [Change Log](https://github.com/Requarks/wiki/blob/master/CHANGELOG.md)
2017-04-25 02:43:10 +00:00
- [Feature Requests](https://wikijs.canny.io/features)
2017-04-21 00:34:13 +00:00
- [Milestones](#milestones)
- [Chat with us](#gitter)
2017-05-03 02:24:15 +00:00
- [Translations](#translations) *(We need your help!)*
- [Special Thanks](#special-thanks)
2016-08-17 01:13:48 +00:00
2017-09-23 15:43:53 +00:00
<a target='_blank' rel='nofollow' href='https://app.codesponsor.io/link/roGruqDX64HMJwmnvjhaQ7kt/Requarks/wiki'>
<img alt='Sponsor' width='888' height='68' src='https://app.codesponsor.io/embed/roGruqDX64HMJwmnvjhaQ7kt/Requarks/wiki.svg' />
</a>
2017-04-21 00:34:13 +00:00
## Requirements
Wiki.js can run on virtually all platforms where Node.js can (Windows, Mac, Linux, etc.).
2017-07-17 01:32:33 +00:00
- Node.js **6.11.1** or later
2017-03-04 16:27:00 +00:00
- MongoDB **3.2** or later
- Git **2.7.4** or later
- An empty Git repository (optional)
2017-04-23 22:32:44 +00:00
> Read the full [prerequisites](https://docs.requarks.io/wiki/prerequisites) article for full details.
2017-06-10 17:32:53 +00:00
## Cloud Install
2017-06-10 17:34:44 +00:00
[![Deploy to Heroku](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/requarks/wiki-heroku)
2017-06-10 17:32:53 +00:00
2017-08-12 03:49:06 +00:00
*Docker Cloud, Azure, IBM Bluemix and more coming soon!*
2017-06-10 17:32:53 +00:00
## Docker
A docker Wiki.js image is available on Docker Hub:
[![Docker Image](https://raw.githubusercontent.com/Requarks/wiki-site/master/assets/images/docker-deploy.png)](https://hub.docker.com/r/requarks/wiki/)
2017-08-12 19:12:37 +00:00
You can also use a Dockerfile ([see example](https://github.com/Requarks/wiki/blob/master/tools/Dockerfile)) or Docker Compose ([see example](https://github.com/Requarks/wiki/blob/master/tools/docker-compose.yml)) to run Wiki.js.
2017-04-21 00:34:13 +00:00
## Milestones
Current and upcoming milestones *(major features only, see the [changelog](https://github.com/Requarks/wiki/blob/master/CHANGELOG.md) for complete list of features and bug fixes)*:
2017-04-21 00:34:13 +00:00
2017-10-14 18:44:40 +00:00
### 1.0.11 - Stable
2017-07-09 19:19:26 +00:00
![Progress](http://progressed.io/bar/100)
2017-09-25 03:31:30 +00:00
**Note**: As 2.0 is under development, no new features are being developed in the 1.0 branch.
2017-10-14 18:44:40 +00:00
- [x] Japanese localization
- [x] Fix for name search when using OpenLDAP
- [x] Added referrer policy header
2017-07-21 21:49:07 +00:00
2017-07-22 17:58:19 +00:00
### 2.0.0 - Dev
![Progress](http://progressed.io/bar/35)
2017-09-25 03:31:30 +00:00
**Goals**:
- Decouple front-end and back-end completely.
- All operations and queries will be made via GraphQL API.
- New fully responsive layout, with better customization capabilities.
- Full localization support, especially for non-latin languages.
2017-07-05 00:11:05 +00:00
2017-07-22 17:58:19 +00:00
**Breaking Changes**: MongoDB is being phased out in favor of PostgreSQL + Redis. An upgrade tool will be provided to migrate existing data to the new system.
2017-09-04 17:12:14 +00:00
- [x] GraphQL API
2017-08-20 02:51:58 +00:00
- [x] Comments
2017-08-19 22:25:51 +00:00
- [x] Documents
2017-09-04 17:12:14 +00:00
- [x] Files
2017-08-14 00:34:31 +00:00
- [x] Folders
2017-08-13 23:55:19 +00:00
- [x] Groups
2017-08-20 02:51:58 +00:00
- [x] Rights
2017-08-19 22:25:51 +00:00
- [x] Settings
2017-08-14 00:34:31 +00:00
- [x] Tags
2017-09-25 03:31:30 +00:00
- [x] Translations
2017-08-13 23:55:19 +00:00
- [x] Users
2017-07-30 04:07:17 +00:00
- [x] Migrate to PostgreSQL + Redis datastore
2017-10-21 17:02:31 +00:00
- [ ] Themes
2017-09-04 17:12:14 +00:00
- [ ] New Login page
2017-07-09 03:09:35 +00:00
- [ ] History / Revert to previous version
2017-07-08 20:09:14 +00:00
- [ ] Optional Two-Steps Authentication (2FA)
- [x] Docker support + Auto compile/publish to Docker Hub
2017-09-25 03:31:30 +00:00
- [x] Support sub-directory installations (e.g. example.com/wiki)
2017-07-09 19:19:26 +00:00
- [ ] Persist system settings to database instead of file-based
- [ ] User Groups + Better permissions management
2017-08-13 23:55:19 +00:00
- [x] Make use of all available CPU cores, distributed jobs queue
2017-07-29 04:01:27 +00:00
- [ ] Tags per document / folder
- [ ] Comments / Discussion per document
- [ ] Profile page per user
- [ ] Preview changes directly from the editor, without saving
2017-07-30 04:07:17 +00:00
- [x] Modular authentication providers
2017-08-01 22:04:25 +00:00
- [ ] High Availability support (multiple concurrent instances)
2017-04-21 00:34:13 +00:00
- [ ] Insert Link modal in Editor
- [ ] Better simultaneous user editing handling
## Gitter
2017-03-15 01:27:44 +00:00
Want to discuss features, ideas or issues? Join our [gitter channel](https://gitter.im/Requarks/wiki). We are very active and friendly!
2017-04-21 00:34:13 +00:00
## Twitter
Follow our Twitter feed to learn about upcoming updates and new releases!
2017-04-06 01:21:41 +00:00
[![Twitter Follow](https://img.shields.io/badge/follow-%40requarks-blue.svg?style=flat-square)](https://twitter.com/requarks)
2017-05-03 02:22:09 +00:00
## Translations
We are looking for translators to make Wiki.js available in multiple languages. If your language is not listed below and would like to contribute to this project, contact us on our [gitter channel](https://gitter.im/Requarks/wiki) and we'll provide you with the necessary tool to add translations, no coding required!
**Languages that are already translated:**
- [x] English
- [x] Chinese - *Thanks to [@choicky](https://github.com/choicky)*
- [x] Dutch - *Thanks to [@weirdwater](https://github.com/weirdwater)*
- [x] French
2017-10-21 17:02:31 +00:00
- [x] German - *Thanks to [@joetjengerdes](https://github.com/joetjengerdes), [@MyZeD](https://github.com/MyZeD)*
2017-10-14 18:44:40 +00:00
- [x] Japanese - *Thanks to [@johnnyshields](https://github.com/johnnyshields)*
- [x] Korean - *Thanks to [@junwonpk](https://github.com/junwonpk)*
- [x] Persian - *Thanks to [@ashkang](https://github.com/ashkang)*
- [x] Portuguese - *Thanks to [@felipeplets](https://github.com/felipeplets)*
2017-05-09 13:11:41 +00:00
- [x] Russian - *Thanks to [@efimlosev](https://github.com/efimlosev)*
- [x] Spanish - *Thanks to [@MatiasArriola](https://github.com/MatiasArriola)*
2017-05-03 02:22:09 +00:00
2017-04-21 00:34:13 +00:00
## Special Thanks
2016-12-19 19:05:05 +00:00
2017-04-23 23:14:25 +00:00
![Browserstack](https://wiki.js.org/assets/images/logo_browserstack.png)
2016-12-19 19:05:05 +00:00
[Browserstack](https://www.browserstack.com/) for providing access to their great cross-browser testing tools.
2016-12-23 18:31:10 +00:00
2017-10-02 02:42:45 +00:00
[![DigitalOcean](https://wiki.js.org/assets/images/logo_digitalocean.png)](https://m.do.co/c/5f7445bfa4d0)
[DigitalOcean](https://m.do.co/c/5f7445bfa4d0) for providing hosting of the Wiki.js documentation site.
## Contributors
This project exists thanks to all the people who contribute. [[Contribute]](CONTRIBUTING.md).
<a href="graphs/contributors"><img src="https://opencollective.com/wikijs/contributors.svg?width=890" /></a>
## Backers
Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/wikijs#backer)]
<a href="https://opencollective.com/wikijs#backers" target="_blank"><img src="https://opencollective.com/wikijs/backers.svg?width=890"></a>
## Sponsors
Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/wikijs#sponsor)]
<a href="https://opencollective.com/wikijs/sponsor/0/website" target="_blank"><img src="https://opencollective.com/wikijs/sponsor/0/avatar.svg"></a>
<a href="https://opencollective.com/wikijs/sponsor/1/website" target="_blank"><img src="https://opencollective.com/wikijs/sponsor/1/avatar.svg"></a>
<a href="https://opencollective.com/wikijs/sponsor/2/website" target="_blank"><img src="https://opencollective.com/wikijs/sponsor/2/avatar.svg"></a>
<a href="https://opencollective.com/wikijs/sponsor/3/website" target="_blank"><img src="https://opencollective.com/wikijs/sponsor/3/avatar.svg"></a>
<a href="https://opencollective.com/wikijs/sponsor/4/website" target="_blank"><img src="https://opencollective.com/wikijs/sponsor/4/avatar.svg"></a>
<a href="https://opencollective.com/wikijs/sponsor/5/website" target="_blank"><img src="https://opencollective.com/wikijs/sponsor/5/avatar.svg"></a>
<a href="https://opencollective.com/wikijs/sponsor/6/website" target="_blank"><img src="https://opencollective.com/wikijs/sponsor/6/avatar.svg"></a>
<a href="https://opencollective.com/wikijs/sponsor/7/website" target="_blank"><img src="https://opencollective.com/wikijs/sponsor/7/avatar.svg"></a>
<a href="https://opencollective.com/wikijs/sponsor/8/website" target="_blank"><img src="https://opencollective.com/wikijs/sponsor/8/avatar.svg"></a>
<a href="https://opencollective.com/wikijs/sponsor/9/website" target="_blank"><img src="https://opencollective.com/wikijs/sponsor/9/avatar.svg"></a>