Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add OpenGraph metadata #258

Closed
qwertygc opened this issue Jul 6, 2015 · 14 comments
Closed

Add OpenGraph metadata #258

qwertygc opened this issue Jul 6, 2015 · 14 comments
Labels
feature template HTML rendering
Milestone

Comments

@qwertygc
Copy link

qwertygc commented Jul 6, 2015

it's possible to implante h-entry on shaarli ?

@nodiscc
Copy link
Member

nodiscc commented Jul 6, 2015

What does this do?

@qwertygc
Copy link
Author

qwertygc commented Jul 6, 2015

@nodiscc
Copy link
Member

nodiscc commented Jul 6, 2015

I suggest enabling more Opengraph metadata on Shaarlis instead. Opengraph is a well known and widely used standard, and as far as I can see, the opengraph metadata properties supersede the h-card properties.

Or does h-card do something that opengraph does not?

There is no commit messages on #259 which doesn't help knowing what your edits actually do.

Explaining in french is also fine.

@virtualtam
Copy link
Member

Hello @qwertygc,

Could you elaborate a bit what h-cards are, and in which way(s) they could benefit to Shaarli?

  • h-cards seem to have a purpose very similar to vCards, that is, holding an individual's information (address, contact, websites, etc.)
  • OpenGraphs look like inserting Semantic Web elements (namely, RDF schemas) into a web page, using <meta> tags

Could you squash the commits from #259 and provide a more explanatory commit message?

Here's an example:

semantics: implement h-card support

Adds <some feature> because of <some reason/user need>

Reference:
 - http://microformats.org/wiki/h-card
 - <any useful link>

Modifications:
 - <Shaarli features impacted by the commit>

@qwertygc
Copy link
Author

qwertygc commented Jul 6, 2015

sorry, it's more easy for me to speak in french.

En gros les h-card permettent de rajouter de la sémantique. Les h-card sont un truc standardisés. Il est utilisé par indewebcamp (http://indiewebify.me/) pour faire un réseau social décentralisé, dans le même objectif que shaarli. À terme, je compte rendre totalement compatible avec ce qui est décrit (avec POSS rt webmentions et autres, cf leur wiki).

Opengraph est quand a lui spécifique à Facebook et ne sert que ce dernier.

Au final, voulez-vous etre asservi à facebook en utilisant un protocole quasiment propriétaire ou être libre en faisant quelque chose de décentralisé ?

@qwertygc
Copy link
Author

qwertygc commented Jul 6, 2015

Opengraph n'est pas reconnu par le w3c hcard si.

@virtualtam
Copy link
Member

If you don't mind, I'll translate questions / remarks and answer to them in English :)

h-cards allow to add semantics

hCard is a microformat, that allows using HTML classes to add personal information semantics (see Wikipedia links for examples)

h-cards are a standard

As far as the W3C is concerned, hCard is currently an experimental profile specification, derived from the vCard RFC:

[h-card] is used by IndieWebCamp to provide a decentralized social network, serving the same purpose as Shaarli

Though it encourages self-hosting, and keeping an eye on your personal data, Shaarli has no decentralized nor social role by itself.

RSS/Atom agregators, as well as Shaarli River, on the other hand, bring a decentralized, social (yet limited) dimension to Shaarli.

eventually, I want to be fully compatible with the [IndieWeb] specifications (POSSE, Webmention)

For Shaarli to be IndieWeb-ready, you'll need at least to:

  • add semantics to all published content
    • store additional information
    • modify RainTPL templates to support semantics
  • implement a Pingback / Webmention feature, to notify websites when publishing a link on your Shaarli

OpenGraph is specific to Facebook, which it only serves

There are plenty of examples of cool OpenSource projects delivered by corporate entities, that can be used for self-hosting:

do you want to be enslaved to Facebook by using an almost proprietary protocol

By the very moment a piece of software has been declared Open Source, it tends to be assimilated by its community, which will fork it in case of a disagreement. The best examples that come to mind are most projects that were developed by Sun, and that have been forked when the company was bought by Oracle:

  • OpenOffice => LibreOffice
  • Hudson => Jenkins
  • MySQL => MariaDB
  • ... hey, why is there no VirtualBox fork yet‽

From an ethical point of view, I agree that it seems uncomfortable to use libraries developed by companies turning your personal data into profit, to design self-hosting solutions.

The thing is, they may be more robust, more actively developed, and better documented, than many community-driven projects...

@ArthurHoaro
Copy link
Member

While Shaarli doesn't have any social role by itself, I don't see any problem complying with a decentralized standard. If Shaarli's content can be understand through these standards, why not. Especially if it's only a matter of CSS classes and/or meta tags.

However, h-card standard doesn't seem to be much known and used. There is no point complying with a standard if we're the only one to do so.

I'll review your PR later if we decide to go with hcards.

@qwertygc
Copy link
Author

qwertygc commented Jul 7, 2015

Je comprends les arguments et je les entends. Néanmoins, shaarli est bien décentralisé. mise a part le my de shaarli.fr, on est obliger de l'installer sur son serveur.

Si on met pas les hcards, puis-je au moins améliorer shaarli à coup de

et de ?

@qwertygc
Copy link
Author

qwertygc commented Jul 7, 2015

Rhaa. De balise time et article

@nodiscc
Copy link
Member

nodiscc commented Jul 8, 2015

OpenGraph has the advantage of being widely used already - a lot of services and applications, bot Free and proprietary - do publish and/or parse og metadata (by the way, the generic thumbnailer patch uses og:image to find thumbnails).

You could also use og:article:published_time (check http://ogp.me/#no_vertical) to publish article dates.

Minor point, Shaarli is not decentralized/distributed (just self-hostable), but using metadata as provided by OpenGraph or hCard could allow federation of Shaarlis.

@qwertygc
Copy link
Author

qwertygc commented Jul 8, 2015

Ok for the minor point, you have understand my thought.
I have ask the question on forum's alsacreations (http://forum.alsacreations.com/topic-2-76328-1-Opengraphouh-entry.html), a french website for web standards.

The implantation is easy, because just template change.

@virtualtam virtualtam changed the title Implante h-entry Add hCard / h-entry semantics Jul 8, 2015
@virtualtam virtualtam mentioned this issue Jul 29, 2015
@virtualtam virtualtam modified the milestone: 0.8.0 Jul 30, 2015
@ArthurHoaro ArthurHoaro added template HTML rendering and removed feedback needed labels Feb 28, 2016
@mro
Copy link

mro commented Mar 1, 2016

@qwertygc what do you want to achieve with hCard? Machine readability comes already with the atom feed.

@ArthurHoaro ArthurHoaro modified the milestones: 0.9.0, 0.9.1 Jan 25, 2017
@virtualtam virtualtam modified the milestones: 0.9.1, 0.10.0 Jul 29, 2017
@virtualtam virtualtam removed this from the 0.9.1 milestone Jul 29, 2017
@virtualtam virtualtam modified the milestones: 0.10.0, 0.10.1 Jan 10, 2018
@ArthurHoaro ArthurHoaro changed the title Add hCard / h-entry semantics Add OpenGraph metadata Jul 28, 2018
@ArthurHoaro ArthurHoaro modified the milestones: 0.10.1, 0.10.2 Jul 29, 2018
@ArthurHoaro ArthurHoaro modified the milestones: 0.10.2, 0.10.3 Aug 11, 2018
ArthurHoaro added a commit to ArthurHoaro/Shaarli that referenced this issue Aug 13, 2018
Includes:
  - og:title
  - og:type -> article
  - og:image -> if there is a thumbnail
  - og:url -> permalink
  - og:description -> first 300 chars of raw description
  - article:published_time
  - article:modified_time
  - article:tag -> one OG meta tag for each shaare tag

Fixes shaarli#258
ArthurHoaro added a commit to ArthurHoaro/Shaarli that referenced this issue Aug 13, 2018
Includes:
  - og:title
  - og:type -> article
  - og:image -> if there is a thumbnail
  - og:url -> permalink
  - og:description -> first 300 chars of raw description
  - article:published_time
  - article:modified_time
  - article:tag -> one OG meta tag for each shaare tag

Fixes shaarli#258
@Lucas-C
Copy link

Lucas-C commented Jul 16, 2020

I do not want to re-open a similar issue, but I would also be interested in adding microformats semantic attributes/metadata on Shaarli...

I would also be interested in developping a plugin to send linbacks (Pingback, Webmention). I have just written one for Pelican :)

As this been totally dismissed ? Should I open another issue ?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
feature template HTML rendering
Projects
None yet
Development

No branches or pull requests

6 participants