Appearance
User
Blob top right menu
About
In the About page you can find a short description of a specific blob install. This About page description can be modified by the admins.
Below the description, a list of the sources is displayed. For every source you have an overlook, namely:
- a feed link, created by the blob install
- the number of posts taken from the source
- the name of the source
- the web link of the source
- the description of the source.
N.B.: the source name and description can be overridden by admins if there is no suitable name/descrition into the feed of the source. Therefore, name and description may not be the responsibility of the source.
Menu items
Menu items displayed in home page, such as here, are created accordingly to blobs. A single blob is a mix of content taken from selected sources, filtered by tags. E.g. the NEWS page is the blob News from SINCERE partners displayed in as a Menu item in the home page.
Search the blobs
Search the blobs is not case-sensitive and full-text search of the selected contents taken from the selected sources. Hit ENTER to make it works!
Blobs
A Blob is a grouping of content taken from chosen sources, possibly filtered by tag. Blobs are the blobs collected by a given blob instance.
Tags
Tags are all the tags categorizing the contents taken from the sources. There is an interactive Search to easily browse tags, just start typing into the Search field.
Search the Tags
Search the Tags is not case-sensitive and full-text search through the tags. Just start typing to make it works. E.g. if you start typing "p", you will have a first selection including "privacy" tag (start with "p"), but also "GDPR" tag (it has a capital "P" in the third position).
Share a blob
The share menu gives you the possibility to embed a blob into your website or anywhere else on the web.
- Select an existing blob from the list
- Choose between Dark Mode or Light Mode, Sidebar (no images) or Body (with images).
- Once you've found your preferred embedding, copy the code snippet below.
- Now paste the snippet into a page of your website and save.
- Finally, replace the string "myexample.domain" with the blob domain you're taking the blob from.
et voilà! The blob is now feeding back your website.
N.B.: In the blob 1.0 release you have four embedding style combination: Dark Mode + Sidebar; Light Mode + Sidebar; Dark Mode + Body; Light Mode + Body.
What is the code snippet?
Have a look at the share menu, choose your preferred Mode for the embedding. Below will appear the code snippet,
Something like:
<script src="https://myexample.domain/blob-share.js" async defer></script>
<blob-share blob="2" baseurl="https://myexample.domain" sidebar="true" dark="false"></blob-share>
N.B.: remember to replace the string "myexample.domain" with the blob domain you're taking the blob from.
Administration
Sign In
Add a new source
Add a new URL
You can also add a specific page or post using its fix URL on the search field at the home page.
Note: Image and description need to be available at the Open Graph section of the page.
Create a new user
Reset user password
Remove a user
Check source RSS status
A very useful tool to check the RSS feed status of the sources is the Firefox add-on "Livemarks". https://addons.mozilla.org/en-US/firefox/addon/livemarks/
Even if the RSS feed is displayed correctly on the browser it might not appear on your blob platform. The W3C Feed validator will most probably give some warning which can help you improve the RSS feed at the source: https://validator.w3.org/feed/.
In any case, please create an issue with the problematic source here: https://codeberg.org/lesion/blob/issues
Source admin
RSS is enabled by default in many popular CMSes like Wordpress, Kiwix, grav, and more.
However, in every case there are special issues to be taken care of.
Enable RSS feed
It is possible that RSS is not enabled although supported and you need to check how it works for your CMS.
In the case of Wordpress, RSS is enabled by default for the posts, and not for static pages.
Validate RSS
To be sure that your RSS feed will display properly on a blob platform it is important to validate it here: https://validator.w3.org/feed/
Generate RSS feed
When RSS is not supported it is possible that it is manually implemented. We are exploring different solutions for this option, to be documented here.