1
0
Fork 0
mirror of https://github.com/Nutomic/ibis.git synced 2024-11-22 17:41:09 +00:00
ibis/README.md

25 lines
1.6 KiB
Markdown
Raw Permalink Normal View History

2023-12-20 16:08:19 +00:00
Ibis - A federated Wikipedia Alternative
2023-11-15 00:38:16 +00:00
===
2023-11-28 13:18:51 +00:00
A federated Wikipedia alternative. Main objects in terms of federation are the `Instance` and `Article`. Each article belongs to a single origin instance, the one where it was originally created. Articles have a collection of `Edit`s a custom ActivityPub type containing a diff. The text of any article can be built by starting from empty string and applying all associated edits in order. Instances can synchronize their articles with each other, and follow each other to receive updates about articles. Edits are done with diffs which are generated on the backend, and allow for conflict resolution similar to git. Editing also works over federation. In this case an activity `Update/Edit` is sent to the origin instance. If the diff applies cleanly, the origin instance sends the new text in an `Update/Article` activity to its followers. In case there is a conflict, a `Reject` activity is sent back, the editor needs to resolve and resubmit the edit.
2023-11-15 00:38:16 +00:00
2023-12-20 16:08:19 +00:00
## Name
The Ibis is a [bird which is related to the Egyptian god of knowledge and science](https://en.wikipedia.org/wiki/African_sacred_ibis#In_myth_and_legend).
2024-01-09 11:41:44 +00:00
## Development
2024-01-11 15:21:44 +00:00
You need to install [cargo](https://rustup.rs/) and [trunk](https://trunkrs.dev). Then run the following commands in separate terminals:
2024-01-09 11:41:44 +00:00
```
2024-01-16 15:07:01 +00:00
# start backend, with separate target folder to avoid rebuilds from arch change
cargo run --target-dir target/backend
# or with automatic rebuild on changes using cargo-watch
CARGO_TARGET_DIR=target/backend cargo watch -c -x run
2024-01-11 15:21:44 +00:00
2024-01-16 15:07:01 +00:00
# start frontend, automatic rebuild on changes
trunk serve -w src/frontend/
2024-01-09 11:41:44 +00:00
```
2023-11-15 00:38:16 +00:00
## License
[AGPL](LICENSE)