mirror of https://github.com/requarks/wiki
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
187 lines
10 KiB
187 lines
10 KiB
|
|
|
|
[](https://github.com/Requarks/wiki/releases)
|
|
[](https://github.com/requarks/wiki/blob/master/LICENSE)
|
|
[](#backers)
|
|
[](#sponsors)
|
|
[](https://www.npmjs.com/package/wiki.js)
|
|
[](https://hub.docker.com/r/requarks/wiki/)
|
|
|
|
[](https://www.codacy.com/app/Requarks/wiki)
|
|
[](http://standardjs.com/)
|
|
[](https://gitter.im/Requarks/wiki)
|
|
[](https://twitter.com/requarks)
|
|
|
|
##### A modern, lightweight and powerful wiki app built on NodeJS, Git and Markdown
|
|
|
|
- **[Official Website](https://wiki.js.org/)**
|
|
- **[Getting Started](https://wiki.js.org/get-started.html)**
|
|
- **[Documentation](https://docs.requarks.io/wiki/)**
|
|
- [Requirements](#requirements)
|
|
- [Demo](#demo)
|
|
- [Change Log](https://github.com/Requarks/wiki/blob/master/CHANGELOG.md)
|
|
- [Feature Requests](https://requests.requarks.io/wiki)
|
|
- [Milestones](#milestones)
|
|
- [Chat with us](#gitter)
|
|
- [Translations](#translations) *(We need your help!)*
|
|
- [Special Thanks](#special-thanks)
|
|
- [Contribute](#contributors)
|
|
|
|
## Requirements
|
|
|
|
Wiki.js can run on virtually all platforms where Node.js can (Windows, Mac, Linux, etc.).
|
|
|
|
- Node.js **6.11.1** or later
|
|
- MongoDB **3.2** or later
|
|
- Git **2.7.4** or later
|
|
- An empty Git repository (optional)
|
|
|
|
> Read the full [prerequisites](https://docs.requarks.io/wiki/prerequisites) article for full details.
|
|
|
|
## Cloud Install
|
|
|
|
[](https://heroku.com/deploy?template=https://github.com/requarks/wiki-heroku)
|
|
|
|
*Docker Cloud, Azure, IBM Bluemix and more coming soon!*
|
|
|
|
## Docker
|
|
|
|
A docker Wiki.js image is available on Docker Hub:
|
|
|
|
[](https://hub.docker.com/r/requarks/wiki/)
|
|
|
|
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.
|
|
|
|
## Demo
|
|
|
|
Wiki.js documentation site is actually running Wiki.js! [Check it out »](https://docs.requarks.io/wiki/)
|
|
|
|
> <span style="font-size: .8em;">We do not provide a demo with write access because of potential security / spam issues. The best way to try it is to install it on your own server / computer. It's easy!</span>
|
|
|
|
## 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)*:
|
|
|
|
### 1.0.66 - Stable
|
|
|
|
|
|
**Note**: As 2.0 is under development, no new features are being developed in the 1.0 branch.
|
|
|
|
- [x] Swedish locale is now available (thanks to @pontus-andersson)
|
|
- [x] Fix: Strip /create and /edit when check path permissions
|
|
|
|
### 2.0.0 - Dev
|
|
|
|
|
|
**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.
|
|
|
|
**Release Date**: Q1 2018
|
|
|
|
**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.
|
|
- Node.js 8.9 LTS or later is now the minimum supported version.
|
|
|
|
**Milestones**:
|
|
- [x] GraphQL API
|
|
- [x] Migrate to PostgreSQL + Redis datastore
|
|
- [x] Telemetry for analytics and crash reporting (Optional and fully anonymized)
|
|
- [x] Docker support + Auto compile/publish to Docker Hub
|
|
- [x] Support sub-directory installations (e.g. example.com/wiki)
|
|
- [x] Make use of all available CPU cores, distributed jobs queue
|
|
- [x] Modular authentication providers (+ new Auth0, Discord and Twitch providers)
|
|
- [x] Shared kernel for both app and setup
|
|
- [x] Improved installation wizard
|
|
- [x] Modular logging providers
|
|
- [x] New Login page
|
|
- [x] Two-Factor Authentication (2FA)
|
|
- [ ] New Navigation Concept :rocket:
|
|
- [ ] Themes :rocket:
|
|
- [ ] Modular editors, user-selectable: SimpleMDE (markdown), Monaco (code) or TinyMCE (wysiwyg)
|
|
- [ ] Modular content parser
|
|
- [ ] History / Revert to previous version
|
|
- [ ] Persist system settings to database instead of file-based
|
|
- [ ] User Groups + Better permissions management
|
|
- [ ] Tags per document / folder
|
|
- [ ] Comments / Discussion per document
|
|
- [ ] Profile page per user
|
|
- [ ] Preview changes directly from the editor, without saving
|
|
- [ ] Diagrams as code (Mermaid module)
|
|
- [ ] High Availability support (multiple concurrent instances)
|
|
- [ ] Insert Link modal in Markdown Editor
|
|
- [ ] Better simultaneous user editing handling
|
|
- [ ] Multilingual versions of the same page (i18n)
|
|
- [ ] PostgreSQL search engine
|
|
|
|
:rocket: = Currently in development
|
|
|
|
## Gitter
|
|
|
|
Want to discuss features, ideas or issues? Join our [gitter channel](https://gitter.im/Requarks/wiki). We are very active and friendly!
|
|
[](https://gitter.im/Requarks/wiki)
|
|
|
|
## Twitter
|
|
|
|
Follow our Twitter feed to learn about upcoming updates and new releases!
|
|
[](https://twitter.com/requarks)
|
|
|
|
## 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] Czech - *Thanks to [@braniqvranik](https://github.com/braniqvranik)*
|
|
- [x] Dutch - *Thanks to [@weirdwater](https://github.com/weirdwater)*
|
|
- [x] Estonian - *Thanks to [@vonforum](https://github.com/vonforum)*
|
|
- [x] French
|
|
- [x] German - *Thanks to [@joetjengerdes](https://github.com/joetjengerdes), [@MyZeD](https://github.com/MyZeD)*
|
|
- [x] Italian - *Thanks to [@CupCakeArmy](https://github.com/CupCakeArmy)*
|
|
- [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)*
|
|
- [x] Russian - *Thanks to [@efimlosev](https://github.com/efimlosev)*
|
|
- [x] Slovak - *Thanks to [@braniqvranik](https://github.com/braniqvranik)*
|
|
- [x] Spanish - *Thanks to [@MatiasArriola](https://github.com/MatiasArriola)*
|
|
- [x] Swedish - *Thanks to [@pontus-andersson](https://github.com/pontus-andersson)*
|
|
|
|
## Special Thanks
|
|
|
|
|
|
[Browserstack](https://www.browserstack.com/) for providing access to their great cross-browser testing tools.
|
|
|
|
[](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>
|