0
0
mirror of https://github.com/neon-mmd/websurfx.git synced 2024-10-18 06:22:53 -04:00

chore: revise and improve the readme

This commit is contained in:
neon_arch 2023-05-26 13:15:39 +03:00
parent 1a310ca650
commit 34ae87e4a4
2 changed files with 20 additions and 62 deletions

View File

@ -5,68 +5,26 @@
<b align="center"><a href="README.md">Readme</a></b> | <b align="center"><a href="README.md">Readme</a></b> |
<b><a href="https://discord.gg/SWnda7Mw5u">Discord</a></b> | <b><a href="https://discord.gg/SWnda7Mw5u">Discord</a></b> |
<b><a href="https://github.com/neon-mmd/websurfx">GitHub</a></b> | <b><a href="https://github.com/neon-mmd/websurfx">GitHub</a></b> |
<b><a href="https://github.com/neon-mmd/websurfx/wiki">Documentation</a></b> <b><a href="./docs/README.md">Documentation</a></b>
<br /><br /> <br /><br />
<a href="./LICENSE">
<img
alt="GitHub"
src="https://img.shields.io/github/license/neon-mmd/websurfx?style=flat-square"
/>
</a>
<a href="https://github.com/neon-mmd/websurfx/stargazers">
<img
alt="GitHub Repo stars"
src="https://img.shields.io/github/stars/neon-mmd/websurfx?style=flat-square"
/>
</a>
<a href="https://github.com/neon-mmd/websurfx/forks">
<img
alt="GitHub forks"
src="https://img.shields.io/github/forks/neon-mmd/websurfx?style=flat-square"
/>
</a>
<a href="#"> <a href="#">
<img <img
alt="GitHub code size in bytes" alt="GitHub code size in bytes"
src="https://img.shields.io/github/languages/code-size/neon-mmd/websurfx?style=flat-square" src="https://img.shields.io/github/languages/code-size/neon-mmd/websurfx?style=flat-square"
/> />
</a> </a>
<a href="https://github.com/neon-mmd/websurfx/issues">
<img
alt="GitHub issues"
src="https://img.shields.io/github/issues/neon-mmd/websurfx?style=flat-square"
/>
</a>
<a href="https://github.com/neon-mmd/websurfx/pulls">
<img
alt="GitHub pull requests"
src="https://img.shields.io/github/issues-pr/neon-mmd/websurfx?style=flat-square"
/>
</a>
<a href="https://github.com/neon-mmd/websurfx/actions"> <a href="https://github.com/neon-mmd/websurfx/actions">
<img <img
alt="GitHub Workflow Status" alt="GitHub Workflow Status"
src="https://img.shields.io/github/actions/workflow/status/neon-mmd/websurfx/rust.yml?style=flat-square" src="https://img.shields.io/github/actions/workflow/status/neon-mmd/websurfx/rust.yml?style=flat-square"
/> />
</a> </a>
<a href="">
<img
alt="GitHub release (latest by date including pre-releases)"
src="https://img.shields.io/github/v/release/neon-mmd/websurfx?include_prereleases"
/>
</a>
<a href="" <a href=""
><img ><img
alt="Maintenance" alt="Maintenance"
src="https://img.shields.io/maintenance/yes/2023?style=flat-square" src="https://img.shields.io/maintenance/yes/2023?style=flat-square"
/> />
</a> </a>
<a href="">
<img
alt="GitHub contributors"
src="https://img.shields.io/github/contributors-anon/neon-mmd/websurfx?style=flat-square"
/>
</a>
<a href="https://gitpod.io/#https://github.com/neon-mmd/websurfx"> <a href="https://gitpod.io/#https://github.com/neon-mmd/websurfx">
<img <img
alt="Gitpod" alt="Gitpod"
@ -126,7 +84,7 @@
<img align="center" src="./images/404_error_page.png" /> <img align="center" src="./images/404_error_page.png" />
**[⬆️ Back to Top](#websurfx)** **[⬆️ Back to Top](#--)**
# Features 🚀 # Features 🚀
@ -136,11 +94,11 @@
- 💨 Ad-free and clean results - 💨 Ad-free and clean results
- 🌟 and lots more... - 🌟 and lots more...
**[⬆️ Back to Top](#websurfx)** **[⬆️ Back to Top](#--)**
# Installation and Testing 🛠️ # Installation and Testing 🛠️
> For full setup instructions, see: [**Installation**](https://github.com/neon-mmd/websurfx/wiki/installation) > For full setup instructions, see: [**Installation**](./docs/installation.md)
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: 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:
@ -157,36 +115,36 @@ Once you have started the server, open your preferred web browser and navigate t
> **Warning** > **Warning**
> Please be aware that the project is still in the testing phase and is not ready for production use. > Please be aware that the project is still in the testing phase and is not ready for production use.
**[⬆️ Back to Top](#websurfx)** **[⬆️ Back to Top](#--)**
# Configuration 🔧 # Configuration 🔧
> For full configuration instructions, see: [**Configuration**](https://github.com/neon-mmd/websurfx/wiki/configuration) > For full configuration instructions, see: [**Configuration**](./docs/configuration.md)
Websurfx is configured through the config.lua file, located at `websurfx/config.lua`. Websurfx is configured through the config.lua file, located at `websurfx/config.lua`.
**[⬆️ Back to Top](#websurfx)** **[⬆️ Back to Top](#--)**
# Theming 🎨 # Theming 🎨
> For full theming and customization instructions, see: [**Theming**](https://github.com/neon-mmd/websurfx/wiki/theming) > For full theming and customization instructions, see: [**Theming**](./docs/theming.md)
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. 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.
**[⬆️ Back to Top](#websurfx)** **[⬆️ Back to Top](#--)**
# Multi-Language Support 🌍 # Multi-Language Support 🌍
> **Note** > **Note**
> 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. > 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.
**[⬆️ Back to Top](#websurfx)** **[⬆️ Back to Top](#--)**
# System Requirements 📊 # System Requirements 📊
At present, we only support x86_64 architecture systems, but we would love to have contributions that extend to other architectures as well. At present, we only support x86_64 architecture systems, but we would love to have contributions that extend to other architectures as well.
**[⬆️ Back to Top](#websurfx)** **[⬆️ Back to Top](#--)**
# FAQ (Frequently Asked Questions) 🗨️ # FAQ (Frequently Asked Questions) 🗨️
@ -202,13 +160,13 @@ Websurfx is distributed under the **AGPLv3** license to keep the source code ope
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. 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.
**[⬆️ Back to Top](#websurfx)** **[⬆️ Back to Top](#--)**
# More Contributers Wanted 📣 # More Contributers Wanted 📣
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. 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.
**[⬆️ Back to Top](#websurfx)** **[⬆️ Back to Top](#--)**
# Supporting Websurfx 💖 # Supporting Websurfx 💖
@ -224,20 +182,20 @@ Several areas that we need a bit of help with at the moment are:
- Submit a PR to add a new feature, fix a bug, update the docs, add a theme, widget, or something else. - Submit a PR to add a new feature, fix a bug, update the docs, add a theme, widget, or something else.
- Star Websurfx on GitHub. - Star Websurfx on GitHub.
**[⬆️ Back to Top](#websurfx)** **[⬆️ Back to Top](#--)**
# Documentation 📘 # Documentation 📘
> **Note** > **Note**
> We welcome any contributions to the [documentation](https://github.com/neon-mmd/websurfx/wiki) as this will benefit everyone who uses this project. > We welcome any contributions to the [documentation](./docs/) as this will benefit everyone who uses this project.
**[⬆️ Back to Top](#websurfx)** **[⬆️ Back to Top](#--)**
# Roadmap 🛣️ # Roadmap 🛣️
> Coming soon!! 🙂. > Coming soon!! 🙂.
**[⬆️ Back to Top](#websurfx)** **[⬆️ Back to Top](#--)**
# Contributing 🙋 # Contributing 🙋
@ -251,13 +209,13 @@ Check out this [video](https://youtu.be/FccdqCucVSI) by Mr. Nick on how to contr
If you are a developer, have a look at the [CONTRIBUTING.org](CONTRIBUTING.md) document for more information. If you are a developer, have a look at the [CONTRIBUTING.org](CONTRIBUTING.md) document for more information.
**[⬆️ Back to Top](#websurfx)** **[⬆️ Back to Top](#--)**
# License 📜 # License 📜
Websurfx is licensed under the [AGPLv3](LICENSE) license. Websurfx is licensed under the [AGPLv3](LICENSE) license.
**[⬆️ Back to Top](#websurfx)** **[⬆️ Back to Top](#--)**
# Credits 🤝 # Credits 🤝
@ -271,7 +229,7 @@ We would like to thank the following people for their contributions and support:
<br /> <br />
</p> </p>
**[⬆️ Back to Top](#websurfx)** **[⬆️ Back to Top](#--)**
--- ---

Binary file not shown.

Before

Width:  |  Height:  |  Size: 36 KiB

After

Width:  |  Height:  |  Size: 36 KiB