neon_arch commited on
Commit
34ae87e
β€’
1 Parent(s): 1a310ca

chore: revise and improve the readme

Browse files
Files changed (2) hide show
  1. README.md +20 -62
  2. images/main_page.png +0 -0
README.md CHANGED
@@ -5,68 +5,26 @@
5
  <b align="center"><a href="README.md">Readme</a></b> |
6
  <b><a href="https://discord.gg/SWnda7Mw5u">Discord</a></b> |
7
  <b><a href="https://github.com/neon-mmd/websurfx">GitHub</a></b> |
8
- <b><a href="https://github.com/neon-mmd/websurfx/wiki">Documentation</a></b>
9
  <br /><br />
10
- <a href="./LICENSE">
11
- <img
12
- alt="GitHub"
13
- src="https://img.shields.io/github/license/neon-mmd/websurfx?style=flat-square"
14
- />
15
- </a>
16
- <a href="https://github.com/neon-mmd/websurfx/stargazers">
17
- <img
18
- alt="GitHub Repo stars"
19
- src="https://img.shields.io/github/stars/neon-mmd/websurfx?style=flat-square"
20
- />
21
- </a>
22
- <a href="https://github.com/neon-mmd/websurfx/forks">
23
- <img
24
- alt="GitHub forks"
25
- src="https://img.shields.io/github/forks/neon-mmd/websurfx?style=flat-square"
26
- />
27
- </a>
28
  <a href="#">
29
  <img
30
  alt="GitHub code size in bytes"
31
  src="https://img.shields.io/github/languages/code-size/neon-mmd/websurfx?style=flat-square"
32
  />
33
  </a>
34
- <a href="https://github.com/neon-mmd/websurfx/issues">
35
- <img
36
- alt="GitHub issues"
37
- src="https://img.shields.io/github/issues/neon-mmd/websurfx?style=flat-square"
38
- />
39
- </a>
40
- <a href="https://github.com/neon-mmd/websurfx/pulls">
41
- <img
42
- alt="GitHub pull requests"
43
- src="https://img.shields.io/github/issues-pr/neon-mmd/websurfx?style=flat-square"
44
- />
45
- </a>
46
  <a href="https://github.com/neon-mmd/websurfx/actions">
47
  <img
48
  alt="GitHub Workflow Status"
49
  src="https://img.shields.io/github/actions/workflow/status/neon-mmd/websurfx/rust.yml?style=flat-square"
50
  />
51
  </a>
52
- <a href="">
53
- <img
54
- alt="GitHub release (latest by date including pre-releases)"
55
- src="https://img.shields.io/github/v/release/neon-mmd/websurfx?include_prereleases"
56
- />
57
- </a>
58
  <a href=""
59
  ><img
60
  alt="Maintenance"
61
  src="https://img.shields.io/maintenance/yes/2023?style=flat-square"
62
  />
63
  </a>
64
- <a href="">
65
- <img
66
- alt="GitHub contributors"
67
- src="https://img.shields.io/github/contributors-anon/neon-mmd/websurfx?style=flat-square"
68
- />
69
- </a>
70
  <a href="https://gitpod.io/#https://github.com/neon-mmd/websurfx">
71
  <img
72
  alt="Gitpod"
@@ -126,7 +84,7 @@
126
 
127
  <img align="center" src="./images/404_error_page.png" />
128
 
129
- **[⬆️ Back to Top](#websurfx)**
130
 
131
  # Features πŸš€
132
 
@@ -136,11 +94,11 @@
136
  - πŸ’¨ Ad-free and clean results
137
  - 🌟 and lots more...
138
 
139
- **[⬆️ Back to Top](#websurfx)**
140
 
141
  # Installation and Testing πŸ› οΈ
142
 
143
- > For full setup instructions, see: [**Installation**](https://github.com/neon-mmd/websurfx/wiki/installation)
144
 
145
  To get started with Websurfx, clone the repository, edit the config file, which is located in the `websurfx`{.verbatim} directory, and install the Redis server by following the instructions located [here](https://redis.io/docs/getting-started/) and then run the websurfx server and redis server using the following commands:
146
 
@@ -157,36 +115,36 @@ Once you have started the server, open your preferred web browser and navigate t
157
  > **Warning**
158
  > Please be aware that the project is still in the testing phase and is not ready for production use.
159
 
160
- **[⬆️ Back to Top](#websurfx)**
161
 
162
  # Configuration πŸ”§
163
 
164
- > For full configuration instructions, see: [**Configuration**](https://github.com/neon-mmd/websurfx/wiki/configuration)
165
 
166
  Websurfx is configured through the config.lua file, located at `websurfx/config.lua`.
167
 
168
- **[⬆️ Back to Top](#websurfx)**
169
 
170
  # Theming 🎨
171
 
172
- > For full theming and customization instructions, see: [**Theming**](https://github.com/neon-mmd/websurfx/wiki/theming)
173
 
174
  Websurfx comes with several themes and color schemes by default, which you can apply and edit through the config file. Supports custom themes and color schemes using CSS, allowing you to develop your own unique-looking website.
175
 
176
- **[⬆️ Back to Top](#websurfx)**
177
 
178
  # Multi-Language Support 🌍
179
 
180
  > **Note**
181
  > Currently, we do not support other languages, but in the future, we will start accepting contributions regarding language support because we believe that language should not be a barrier to entry.
182
 
183
- **[⬆️ Back to Top](#websurfx)**
184
 
185
  # System Requirements πŸ“Š
186
 
187
  At present, we only support x86_64 architecture systems, but we would love to have contributions that extend to other architectures as well.
188
 
189
- **[⬆️ Back to Top](#websurfx)**
190
 
191
  # FAQ (Frequently Asked Questions) πŸ—¨οΈ
192
 
@@ -202,13 +160,13 @@ Websurfx is distributed under the **AGPLv3** license to keep the source code ope
202
 
203
  Rust was chosen as the programming language for Websurfx because of its memory safety features, which can help prevent vulnerabilities and make the codebase more secure. Rust is also faster than C++, which contributes to Websurfx's speed and responsiveness. Furthermore, the Rust ownership and borrowing system enables secure concurrency and thread safety in the program.
204
 
205
- **[⬆️ Back to Top](#websurfx)**
206
 
207
  # More Contributers Wanted πŸ“£
208
 
209
  We are looking for more willing contributors to help grow this project. For more information on how you can contribute, check out the [project board](https://github.com/neon-mmd/websurfx/projects?query=is%3Aopen) and the [CONTRIBUTING.md](CONTRIBUTING.md) file for guidelines and rules for making contributions.
210
 
211
- **[⬆️ Back to Top](#websurfx)**
212
 
213
  # Supporting Websurfx πŸ’–
214
 
@@ -224,20 +182,20 @@ Several areas that we need a bit of help with at the moment are:
224
  - Submit a PR to add a new feature, fix a bug, update the docs, add a theme, widget, or something else.
225
  - Star Websurfx on GitHub.
226
 
227
- **[⬆️ Back to Top](#websurfx)**
228
 
229
  # Documentation πŸ“˜
230
 
231
  > **Note**
232
- > We welcome any contributions to the [documentation](https://github.com/neon-mmd/websurfx/wiki) as this will benefit everyone who uses this project.
233
 
234
- **[⬆️ Back to Top](#websurfx)**
235
 
236
  # Roadmap πŸ›£οΈ
237
 
238
  > Coming soon!! πŸ™‚.
239
 
240
- **[⬆️ Back to Top](#websurfx)**
241
 
242
  # Contributing πŸ™‹
243
 
@@ -251,13 +209,13 @@ Check out this [video](https://youtu.be/FccdqCucVSI) by Mr. Nick on how to contr
251
 
252
  If you are a developer, have a look at the [CONTRIBUTING.org](CONTRIBUTING.md) document for more information.
253
 
254
- **[⬆️ Back to Top](#websurfx)**
255
 
256
  # License πŸ“œ
257
 
258
  Websurfx is licensed under the [AGPLv3](LICENSE) license.
259
 
260
- **[⬆️ Back to Top](#websurfx)**
261
 
262
  # Credits 🀝
263
 
@@ -271,7 +229,7 @@ We would like to thank the following people for their contributions and support:
271
  <br />
272
  </p>
273
 
274
- **[⬆️ Back to Top](#websurfx)**
275
 
276
  ---
277
 
 
5
  <b align="center"><a href="README.md">Readme</a></b> |
6
  <b><a href="https://discord.gg/SWnda7Mw5u">Discord</a></b> |
7
  <b><a href="https://github.com/neon-mmd/websurfx">GitHub</a></b> |
8
+ <b><a href="./docs/README.md">Documentation</a></b>
9
  <br /><br />
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
10
  <a href="#">
11
  <img
12
  alt="GitHub code size in bytes"
13
  src="https://img.shields.io/github/languages/code-size/neon-mmd/websurfx?style=flat-square"
14
  />
15
  </a>
 
 
 
 
 
 
 
 
 
 
 
 
16
  <a href="https://github.com/neon-mmd/websurfx/actions">
17
  <img
18
  alt="GitHub Workflow Status"
19
  src="https://img.shields.io/github/actions/workflow/status/neon-mmd/websurfx/rust.yml?style=flat-square"
20
  />
21
  </a>
 
 
 
 
 
 
22
  <a href=""
23
  ><img
24
  alt="Maintenance"
25
  src="https://img.shields.io/maintenance/yes/2023?style=flat-square"
26
  />
27
  </a>
 
 
 
 
 
 
28
  <a href="https://gitpod.io/#https://github.com/neon-mmd/websurfx">
29
  <img
30
  alt="Gitpod"
 
84
 
85
  <img align="center" src="./images/404_error_page.png" />
86
 
87
+ **[⬆️ Back to Top](#--)**
88
 
89
  # Features πŸš€
90
 
 
94
  - πŸ’¨ Ad-free and clean results
95
  - 🌟 and lots more...
96
 
97
+ **[⬆️ Back to Top](#--)**
98
 
99
  # Installation and Testing πŸ› οΈ
100
 
101
+ > For full setup instructions, see: [**Installation**](./docs/installation.md)
102
 
103
  To get started with Websurfx, clone the repository, edit the config file, which is located in the `websurfx`{.verbatim} directory, and install the Redis server by following the instructions located [here](https://redis.io/docs/getting-started/) and then run the websurfx server and redis server using the following commands:
104
 
 
115
  > **Warning**
116
  > Please be aware that the project is still in the testing phase and is not ready for production use.
117
 
118
+ **[⬆️ Back to Top](#--)**
119
 
120
  # Configuration πŸ”§
121
 
122
+ > For full configuration instructions, see: [**Configuration**](./docs/configuration.md)
123
 
124
  Websurfx is configured through the config.lua file, located at `websurfx/config.lua`.
125
 
126
+ **[⬆️ Back to Top](#--)**
127
 
128
  # Theming 🎨
129
 
130
+ > For full theming and customization instructions, see: [**Theming**](./docs/theming.md)
131
 
132
  Websurfx comes with several themes and color schemes by default, which you can apply and edit through the config file. Supports custom themes and color schemes using CSS, allowing you to develop your own unique-looking website.
133
 
134
+ **[⬆️ Back to Top](#--)**
135
 
136
  # Multi-Language Support 🌍
137
 
138
  > **Note**
139
  > Currently, we do not support other languages, but in the future, we will start accepting contributions regarding language support because we believe that language should not be a barrier to entry.
140
 
141
+ **[⬆️ Back to Top](#--)**
142
 
143
  # System Requirements πŸ“Š
144
 
145
  At present, we only support x86_64 architecture systems, but we would love to have contributions that extend to other architectures as well.
146
 
147
+ **[⬆️ Back to Top](#--)**
148
 
149
  # FAQ (Frequently Asked Questions) πŸ—¨οΈ
150
 
 
160
 
161
  Rust was chosen as the programming language for Websurfx because of its memory safety features, which can help prevent vulnerabilities and make the codebase more secure. Rust is also faster than C++, which contributes to Websurfx's speed and responsiveness. Furthermore, the Rust ownership and borrowing system enables secure concurrency and thread safety in the program.
162
 
163
+ **[⬆️ Back to Top](#--)**
164
 
165
  # More Contributers Wanted πŸ“£
166
 
167
  We are looking for more willing contributors to help grow this project. For more information on how you can contribute, check out the [project board](https://github.com/neon-mmd/websurfx/projects?query=is%3Aopen) and the [CONTRIBUTING.md](CONTRIBUTING.md) file for guidelines and rules for making contributions.
168
 
169
+ **[⬆️ Back to Top](#--)**
170
 
171
  # Supporting Websurfx πŸ’–
172
 
 
182
  - Submit a PR to add a new feature, fix a bug, update the docs, add a theme, widget, or something else.
183
  - Star Websurfx on GitHub.
184
 
185
+ **[⬆️ Back to Top](#--)**
186
 
187
  # Documentation πŸ“˜
188
 
189
  > **Note**
190
+ > We welcome any contributions to the [documentation](./docs/) as this will benefit everyone who uses this project.
191
 
192
+ **[⬆️ Back to Top](#--)**
193
 
194
  # Roadmap πŸ›£οΈ
195
 
196
  > Coming soon!! πŸ™‚.
197
 
198
+ **[⬆️ Back to Top](#--)**
199
 
200
  # Contributing πŸ™‹
201
 
 
209
 
210
  If you are a developer, have a look at the [CONTRIBUTING.org](CONTRIBUTING.md) document for more information.
211
 
212
+ **[⬆️ Back to Top](#--)**
213
 
214
  # License πŸ“œ
215
 
216
  Websurfx is licensed under the [AGPLv3](LICENSE) license.
217
 
218
+ **[⬆️ Back to Top](#--)**
219
 
220
  # Credits 🀝
221
 
 
229
  <br />
230
  </p>
231
 
232
+ **[⬆️ Back to Top](#--)**
233
 
234
  ---
235
 
images/main_page.png CHANGED