XFFXFF commited on
Commit
05eda69
β€’
2 Parent(s): 9fc5300 5b70670

Merge pull request #64 from neon-mmd/readme-revision

Browse files
Files changed (2) hide show
  1. README.md +25 -65
  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,20 +94,22 @@
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
 
147
  ``` shell
148
  git clone https://github.com/neon-mmd/websurfx.git
149
  cd websurfx
150
- cargo build
151
  redis-server --port 8082 &
152
- ./target/debug/websurfx
153
  ```
154
 
155
  Once you have started the server, open your preferred web browser and navigate to <http://127.0.0.1:8080> to start using Websurfx.
@@ -157,36 +117,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 +162,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 +184,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 +211,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 +231,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
+ Before you can start building `websurfx`, you will need to have `Cargo` installed on your system. You can find the installation instructions [here](https://doc.rust-lang.org/cargo/getting-started/installation.html).
104
 
105
+ To get started with Websurfx, clone the repository, edit the config file, which is located in the `websurfx/` 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:
106
 
107
  ``` shell
108
  git clone https://github.com/neon-mmd/websurfx.git
109
  cd websurfx
110
+ cargo build -r
111
  redis-server --port 8082 &
112
+ ./target/release/websurfx
113
  ```
114
 
115
  Once you have started the server, open your preferred web browser and navigate to <http://127.0.0.1:8080> to start using Websurfx.
 
117
  > **Warning**
118
  > Please be aware that the project is still in the testing phase and is not ready for production use.
119
 
120
+ **[⬆️ Back to Top](#--)**
121
 
122
  # Configuration πŸ”§
123
 
124
+ > For full configuration instructions, see: [**Configuration**](./docs/configuration.md)
125
 
126
  Websurfx is configured through the config.lua file, located at `websurfx/config.lua`.
127
 
128
+ **[⬆️ Back to Top](#--)**
129
 
130
  # Theming 🎨
131
 
132
+ > For full theming and customization instructions, see: [**Theming**](./docs/theming.md)
133
 
134
  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.
135
 
136
+ **[⬆️ Back to Top](#--)**
137
 
138
  # Multi-Language Support 🌍
139
 
140
  > **Note**
141
  > 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.
142
 
143
+ **[⬆️ Back to Top](#--)**
144
 
145
  # System Requirements πŸ“Š
146
 
147
  At present, we only support x86_64 architecture systems, but we would love to have contributions that extend to other architectures as well.
148
 
149
+ **[⬆️ Back to Top](#--)**
150
 
151
  # FAQ (Frequently Asked Questions) πŸ—¨οΈ
152
 
 
162
 
163
  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.
164
 
165
+ **[⬆️ Back to Top](#--)**
166
 
167
  # More Contributers Wanted πŸ“£
168
 
169
  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.
170
 
171
+ **[⬆️ Back to Top](#--)**
172
 
173
  # Supporting Websurfx πŸ’–
174
 
 
184
  - Submit a PR to add a new feature, fix a bug, update the docs, add a theme, widget, or something else.
185
  - Star Websurfx on GitHub.
186
 
187
+ **[⬆️ Back to Top](#--)**
188
 
189
  # Documentation πŸ“˜
190
 
191
  > **Note**
192
+ > We welcome any contributions to the [documentation](./docs/) as this will benefit everyone who uses this project.
193
 
194
+ **[⬆️ Back to Top](#--)**
195
 
196
  # Roadmap πŸ›£οΈ
197
 
198
  > Coming soon!! πŸ™‚.
199
 
200
+ **[⬆️ Back to Top](#--)**
201
 
202
  # Contributing πŸ™‹
203
 
 
211
 
212
  If you are a developer, have a look at the [CONTRIBUTING.org](CONTRIBUTING.md) document for more information.
213
 
214
+ **[⬆️ Back to Top](#--)**
215
 
216
  # License πŸ“œ
217
 
218
  Websurfx is licensed under the [AGPLv3](LICENSE) license.
219
 
220
+ **[⬆️ Back to Top](#--)**
221
 
222
  # Credits 🀝
223
 
 
231
  <br />
232
  </p>
233
 
234
+ **[⬆️ Back to Top](#--)**
235
 
236
  ---
237
 
images/main_page.png CHANGED