From b5e28c8d11f9da824150c8df291ec4573359c6ad Mon Sep 17 00:00:00 2001 From: "Schimon Jehudah, Adv." Date: Wed, 20 Nov 2024 18:38:06 +0200 Subject: [PATCH] Automate installation process; Update document README; Thank you to LeXofLeviafan from the project jarun/buku. --- README.md | 68 ++++++++++--------- blasta.sql => blasta/configs/blasta.sql | 0 settings.toml => blasta/configs/settings.toml | 0 3 files changed, 35 insertions(+), 33 deletions(-) rename blasta.sql => blasta/configs/blasta.sql (100%) rename settings.toml => blasta/configs/settings.toml (100%) diff --git a/README.md b/README.md index 6cac84a..eb428dc 100644 --- a/README.md +++ b/README.md @@ -1,33 +1,44 @@ -# Blasta - The agreeable and cordial civic bookmarking system. +# Blasta - The agreeable and cordial civic annotation system. -Blasta is a collaborative bookmarks manager for organizing online content. It -allows you to add links to your personal collection of links, to categorize them -with keywords, and to share your collection not only among your own software, -devices and machines, but also with others. +Blasta is a collaborative bookmarks manager for organizing online content. -What makes Blasta a collaborative system is its ability to display to you the -links that other people have collected, as well as showing you who else has -bookmarked a specific link. You can also view the links collected by others, and -subscribe to the links of people whose lists you deem to be interesting. +It allows you to add links to your personal collection of links, to categorize +them with keywords, and to share and synchronize your collection among your own +software, devices, machines, and also with others. + +The ability of Blasta to display to you the links that other people have +collected and shared, as well as showing you who else has bookmarked a specific +link is what makes Blasta a collaborative system. + +You can also view the links collected by others, and subscribe to the links of +people whose lists you deem to be interesting. Blasta does not limit you to save links of certain types; you can save links of types adc, dweb, ed2k, feed, ftp, gemini, geo, gopher, http, ipfs, irc, magnet, mailto, monero, mms, news, sip, udp, xmpp and any scheme and type that you desire. +## Instances + +* https://blasta.woodpeckersnest.eu + ## Screenshots [browse view](blasta/screenshot/browse.png) [tags view](blasta/screenshot/tag.png) +## Videos + +* [Blasta - An XMPP PubSub Annotation Management System](https://video.xmpp-it.net/w/cfozoUeVLFbBFMCCSCJ1Dn) [06:38] + ## Technicalities Blasta is a federated bookmarking system which is based on XMPP and stores bookmarks on your own XMPP account; to achieve this task, Blasta utilizes the following XMPP specifications: -- [XEP-0163: Personal Eventing Protocol](https://xmpp.org/extensions/xep-0163.html) -- [XEP-0060: Publish-Subscribe](https://xmpp.org/extensions/xep-0060.html) +* [XEP-0163: Personal Eventing Protocol](https://xmpp.org/extensions/xep-0163.html) +* [XEP-0060: Publish-Subscribe](https://xmpp.org/extensions/xep-0060.html) Blasta operates as an XMPP client, and therefore, does not have a bookmarks system nor an account system, of its own. @@ -40,21 +51,21 @@ The connection to the Blasta system is made with XMPP accounts. ## Features -- Private bookmarks; -- Public bookmarks; -- Read list; -- Search; -- Syndication; -- Tags. +* Private bookmarks; +* Public bookmarks; +* Read list; +* Search; +* Syndication; +* Tags. ## Future features -- ActivityPub; -- Federation; -- Filters; -- Pin; -- Publish-Subscribe; -- Report. +* ActivityPub; +* Federation; +* Filters; +* Pin; +* Publish-Subscribe; +* Report. ## Requirements @@ -103,22 +114,13 @@ $ pipx uninstall blasta $ pipx install git+https://git.xmpp-it.net/sch/Blasta ``` -### Configure - -Copy files `blasta.sql` and `settings.toml` to `~/.config/blasta/`. - -Copy directories `stylesheet`, `graphic`, `template`, and `script` to -`~/.local/share/blasta/`. - -Create directories `data`, `export`, `items` under `~/.cache/blasta/`. - ### Start ``` $ blasta ``` -Open URL http://localhost:8000 and connect with your Jabber ID. +Open URL http://localhost:8000 ## License diff --git a/blasta.sql b/blasta/configs/blasta.sql similarity index 100% rename from blasta.sql rename to blasta/configs/blasta.sql diff --git a/settings.toml b/blasta/configs/settings.toml similarity index 100% rename from settings.toml rename to blasta/configs/settings.toml