Skip to content

Commit 792212b

Browse files
authored
Merge pull request #307 from frappe/update-readme
Update README.md
2 parents c394ab3 + b9bfec6 commit 792212b

File tree

1 file changed

+92
-39
lines changed

1 file changed

+92
-39
lines changed

README.md

+92-39
Original file line numberDiff line numberDiff line change
@@ -1,57 +1,110 @@
1-
<br>
2-
<br>
3-
41
<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>
72

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>
95

10-
---
6+
**Open Source Documentation Tool**
117

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-
[![Wiki](https://img.shields.io/endpoint?url=https://cloud.cypress.io/badge/simple/w2jgcb/master&style=flat&logo=cypress)](https://cloud.cypress.io/projects/w2jgcb/runs)
17-
[![CI](https://github.com/frappe/wiki/actions/workflows/ci.yml/badge.svg?event=push)](https://github.com/frappe/wiki/actions/workflows/ci.yml)
8+
[![Wiki](https://img.shields.io/endpoint?url=https://cloud.cypress.io/badge/simple/w2jgcb/master&style=flat&logo=cypress)](https://cloud.cypress.io/projects/w2jgcb/runs)
9+
[![CI](https://github.com/frappe/wiki/actions/workflows/ci.yml/badge.svg?event=push)](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>
1818
</div>
1919

20-
## Introduction
20+
## Frappe Wiki
2121

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.
2323

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>
2528

26-
```bash
27-
# get app
28-
$ bench get-app https://github.com/frappe/wiki
2929

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
3338

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.
3645

37-
## Features
46+
### Under the Hood
3847

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.
4649

47-
## Screenshots
50+
- [**Ace Editor**](https://github.com/ajaxorg/ace): Ace is an embeddable code editor written in JavaScript.
4851

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.
5153

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>
5470

55-
#### License
71+
## Development Setup
5672

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

Comments
 (0)