Skip to content

Releases: stucco-software/octothorp.es

v0.5.1

30 Sep 03:15

Choose a tag to compare

Full Changelog: v0.5.0...v0.5.1

Fix: Check for extant backlinks correctly to avoid creating duplicate blank nodes.

v0.5.0

19 Sep 20:30
60467cf

Choose a tag to compare

v0.5 turns Octothorpes into Octothorpe Protocol

This release is a line in the sand to divide our early prototyping from the more structured development of Octothorpe Protocol.

Major features established in 0.5 are, harmonizers, the advanced API, updates to link statements, webrings, and a refreshed UI for the standard relay frontend. Core methods and schemas have been established in the indexing pipeline, security has been tightened on acceptable params, and utils.js has been added for various conveience functions. Additionally, a new, up-to-date documentation site has been added at https://docs.octothorp.es/

For more, see our announcement blog post

Advanced API

  • get/[what]/[by]/[[as]]/server.js creates a unified API for complex queries suitable as data sources or subscribable feeds.
  • The endpoint serves as an adapter to translate URL params to a json schema called a blobject.
  • Core SPARQL methods now exist to accept blobjects to define datastore queries

See full documentation here

Debugging tools

  • Using debug as a value for [[as]] will output the full blobject created from params and the SPARQL query created from the blobject

Define indexable content with Harmonizers

Indexing now uses a harmonizer, defined via JSON schema, to match elements in the HTML of pages sent to the system. The default harmonizer is defined in lib/getHarmonizer.

Debugging tools

Harmonizers can be tested at debug/orchestra-pit?uri=[url]&h=[harmonizer id]

Further updates to OP

v0.5 introduces some new core vocabulary and features.

No tags necessary

OP will now index any page you ask it to, whether or not it has octothorpes on it, making them available as /posted on the API.

All kinds of links

Previously, we had hashtags, backlinks, and bookmarks. Now, every non-hashtag octothorpe is simply a link, with an extensible vocabulary of subtypes.

Backlinks are the only subtype that can't be assigned. A link is marked as a backlink when the target site either links back to the referrer or specifically endorses the referrer's domain.

Otherwise you are free to label links as you wish. The default harmonizer includes ids for bookmarks and citations.

Webrings 💍 ‼️

The most notable addition to the OP vocabulary is webrings. Just as links can now have a subtype, webrings introduce the idea of types for URLs. Right now, webring is the only type that has any meaning in the system.