|
1 |
| -<br> |
2 |
| -<br> |
3 |
| - |
4 | 1 | <div align="center">
|
5 |
| -<img width="150" alt="logotype" src="https://user-images.githubusercontent.com/28212972/128001084-508e446f-2814-4e1f-a5cb-09598f5a5bdc.png"> |
6 |
| -</div> |
7 | 2 |
|
8 |
| -<br> |
| 3 | +<img width="80" alt="wiki" src="https://github.com/user-attachments/assets/4869d211-fae2-4e93-8275-de433556feb0" /> |
| 4 | +<h1>Frappe Wiki</h1> |
9 | 5 |
|
10 |
| ---- |
| 6 | +**Open Source Documentation Tool** |
11 | 7 |
|
12 |
| -<div align="center"> |
13 |
| - Wiki App built on the <a href= "https://frappeframework.com" >Frappe Framework</a> | <a href = "https://wiki-docs.frappe.cloud/use_on_frappe_cloud">Try on Frappe Cloud</a> |
14 |
| - |
15 |
| - \ |
16 |
| - [](https://cloud.cypress.io/projects/w2jgcb/runs) |
17 |
| - [](https://github.com/frappe/wiki/actions/workflows/ci.yml) |
| 8 | +[](https://cloud.cypress.io/projects/w2jgcb/runs) |
| 9 | +[](https://github.com/frappe/wiki/actions/workflows/ci.yml) |
| 10 | + |
| 11 | +<img width="1470" alt="Hero Image" src="https://github.com/user-attachments/assets/ecec722d-076f-4ffa-8630-76473d1f494f" /> |
| 12 | + |
| 13 | +<br /> |
| 14 | +<br /> |
| 15 | +<a href="https://frappe.io/wiki">Website</a> |
| 16 | +- |
| 17 | +<a href="https://docs.frappe.io/wiki/">Documentation</a> |
18 | 18 | </div>
|
19 | 19 |
|
20 |
| -## Introduction |
| 20 | +## Frappe Wiki |
21 | 21 |
|
22 |
| -Frappe Wiki is an Open Source [Wiki](https://en.wikipedia.org/wiki/Wiki) app built on the <a href= "https://frappeframework.com" >Frappe Framework</a>. It is well suited to serve dynamic, text-heavy content like documentation and knowledge base. It allows publishing small changes and even new pages on the fly without downtime. It also maintains revision history and has a change approval mechanism. |
| 22 | +Frappe Wiki is an Open Source Wiki app built on the Frappe Framework. It is well suited to serve dynamic, text-heavy content like documentation and knowledge base. It allows publishing small changes and even new pages on the fly without downtime. It also maintains revision history and has a change approval mechanism. |
23 | 23 |
|
24 |
| -## Installation |
| 24 | +<details> |
| 25 | +<summary>Screenshots</summary> |
| 26 | +<img width="1470" alt="EditvPage" src="https://github.com/user-attachments/assets/33ff0704-0f5e-4e9a-8e59-5f50cd8b664c" /> |
| 27 | +</details> |
25 | 28 |
|
26 |
| -```bash |
27 |
| -# get app |
28 |
| -$ bench get-app https://github.com/frappe/wiki |
29 | 29 |
|
30 |
| -# install on site |
31 |
| -$ bench --site sitename install-app wiki |
32 |
| -``` |
| 30 | +### Motivation |
| 31 | + |
| 32 | +Frappe Wiki, like many of our products was developed for our own needs. We were looking for a simple, clean, open source wiki to write documentation for ERPNext, but due to a lack of good options, we decided to write our own from scratch! |
| 33 | + |
| 34 | +Our goal was clear: create an open-source wiki that provides a delightful experience for writers and readers. Today, we use Frappe Wiki for all sorts of internal things – user manuals, company policies, you name it! The easy-to-use interface and simple editing features make it perfect for anyone on our team. |
| 35 | + |
| 36 | + |
| 37 | +### Key Features |
33 | 38 |
|
34 |
| -> [!NOTE] |
35 |
| -> Use `version-14` branch with Frappe Framework v14 and for v14+ use `master` branch. |
| 39 | +- **Create Wiki Pages**: Easily create and organize wiki pages to manage and share knowledge systematically. |
| 40 | +Author Content in Markdown: Write and format content effortlessly using Markdown syntax, ensuring a clean and readable structure. |
| 41 | +- **Set-up Controlled Wiki Updates**: Implement workflows to review and approve edits before publishing, ensuring content accuracy and consistency. |
| 42 | +- **Add Attachments**: Attach relevant files and documents directly to wiki pages for better context and resource sharing. |
| 43 | +- **Table of Contents**: Automatically generate a navigable table of contents for enhanced readability and structure. |
| 44 | +- **Custom Script Support via Wiki Settings**: Customize wiki behavior and extend functionality using custom scripts configured in Wiki Settings. |
36 | 45 |
|
37 |
| -## Features |
| 46 | +### Under the Hood |
38 | 47 |
|
39 |
| -1. Create Wiki Pages |
40 |
| -2. Author content in Rich Text |
41 |
| -3. Set-up Controlled Wiki Updates |
42 |
| -5. Add attachments |
43 |
| -6. Table of Contents |
44 |
| -7. Caching |
45 |
| -8. Custom Script Support via `Wiki Settings` |
| 48 | +- [**Frappe Framework**](https://github.com/frappe/frappe): A full-stack web application framework. |
46 | 49 |
|
47 |
| -## Screenshots |
| 50 | +- [**Ace Editor**](https://github.com/ajaxorg/ace): Ace is an embeddable code editor written in JavaScript. |
48 | 51 |
|
49 |
| -### 1. Rendered Page |
50 |
| -<img width="1552" alt="wiki-rendered" src="https://github.com/frappe/wiki/assets/63963181/011e976e-b572-4d3a-82e8-374d26ecd0d0.png"> |
| 52 | +- [**RedisSearch**](https://github.com/RediSearch/RediSearch): A powerful search and indexing engine built on top of Redis. |
51 | 53 |
|
52 |
| -### 2. Edit Page |
53 |
| -<img width="1552" alt="wiki-edit" src="https://github.com/frappe/wiki/assets/63963181/339d1422-6c99-450d-9e97-7348651abe63.png"> |
| 54 | +## Production Setup |
| 55 | + |
| 56 | +### Managed Hosting |
| 57 | + |
| 58 | +You can try [Frappe Cloud](https://frappecloud.com), a simple, user-friendly and sophisticated [open-source](https://github.com/frappe/press) platform to host Frappe applications with peace of mind. |
| 59 | + |
| 60 | +It takes care of installation, setup, upgrades, monitoring, maintenance and support of your Frappe deployments. It is a fully featured developer platform with an ability to manage and control multiple Frappe deployments. |
| 61 | + |
| 62 | +<div> |
| 63 | + <a href="https://frappecloud.com/marketplace/apps/wiki" target="_blank"> |
| 64 | + <picture> |
| 65 | + <source media="(prefers-color-scheme: dark)" srcset="https://frappe.io/files/try-on-fc-white.png"> |
| 66 | + <img src="https://frappe.io/files/try-on-fc-black.png" alt="Try on Frappe Cloud" height="28" /> |
| 67 | + </picture> |
| 68 | + </a> |
| 69 | +</div> |
54 | 70 |
|
55 |
| -#### License |
| 71 | +## Development Setup |
56 | 72 |
|
57 |
| -MIT |
| 73 | + |
| 74 | +### Local |
| 75 | + |
| 76 | +To setup the repository locally follow the steps mentioned below: |
| 77 | + |
| 78 | +1. Setup bench by following the [Installation Steps](https://frappeframework.com/docs/user/en/installation) and start the server |
| 79 | + |
| 80 | +``` |
| 81 | +bench start |
| 82 | +``` |
| 83 | + |
| 84 | +2. In a separate terminal window, cd into `frappe-bench` directory and run the following commands: |
| 85 | + |
| 86 | +``` |
| 87 | +# get app |
| 88 | +$ bench get-app https://github.com/frappe/wiki |
| 89 | +
|
| 90 | +# install on site |
| 91 | +$ bench --site sitename install-app wiki |
| 92 | +
|
| 93 | +``` |
| 94 | + |
| 95 | +## Learn and connect |
| 96 | +- [Telegram Public Group](https://t.me/frappewiki) |
| 97 | +- [Discuss Forum](https://discuss.frappe.io/c/wiki/72) |
| 98 | +- [Documentation](https://docs.frappe.io/wiki/) |
| 99 | +- [YouTube](https://www.youtube.com/@frappetech) |
| 100 | + |
| 101 | +<br> |
| 102 | +<br> |
| 103 | +<div align="center" style="padding-top: 0.75rem;"> |
| 104 | + <a href="https://frappe.io" target="_blank"> |
| 105 | + <picture> |
| 106 | + <source media="(prefers-color-scheme: dark)" srcset="https://frappe.io/files/Frappe-white.png"> |
| 107 | + <img src="https://frappe.io/files/Frappe-black.png" alt="Frappe Technologies" height="28"/> |
| 108 | + </picture> |
| 109 | + </a> |
| 110 | +</div> |
0 commit comments