Readability

Table of contents

Description

Enrichment service that adds readable versions of the web site content. As web site objects are always attached to information objects, the created contents will be connected to the information objects.

Responsible Person

Status

Status

Ready for Use

Possible Values: Ready for Use, In Development, Plannend, Broken

DevelopmentStatus

Aggregation Features

Fill

No

Update

No

Enrich

Yes

Source Code

Project: https://github.com/soziotech/CommunityMashup/tree/master/sources/ReadabilitySourceService

Tracking

0%

Planned Todos

0%

Bugs

0%

Feature Request

Used Service

Name

Readability Parser Api

Link

https://www.readability.com/

Developer Portal

https://www.readability.com/developers/api

Authentication

Api Key

 

Used Libraries

Name

Version

License

Usage

Link

Apache Http Client

4.2.1

Apache License 2.0

Compiled

http://hc.apache.org/httpcomponents-client-ga/index.html

Apache Http Core4.2.1Apache Licence 2.0Compiledhttp://hc.apache.org/httpcomponents-core-ga/
Google gson2.2.2Apache Licence 2.0Compiledhttp://code.google.com/p/google-gson/

Possible Usage Values: Compiled, Source, Extended Source, Modified Source

LibraryUsage

Configuration

Key

Description

Possible Values

Default

Required (Yes/No)

apiUrl

The url of the readability parser api service.Text

https://www.readability.com/api/content/v1/parser

No

apiKey

Api key (token) from readability.TextNoneYes

addExcerpt

Whether to add excerpt or not as content.

true/falsefalseNo

addContent

Whether to add readable website content or not

true/falsetrueNo

addAuthor

Whether to create and add the parsed author. Author parsing of Readability is not realy reliable.

true/falsetrueNo

enrichContent

Whether to enrich content websites or not.true/falsetrueNo

enrichPerson

Whether to enrich person websites or not.true/falsetrueNo

enrichOrganisation

Whether to enrich organization websites or not.true/falsetrueNo

neededMetaTag

Specific meta tag that is needed for a website to be processed.TextNoneNo

Example:

<sources bundleId="org.sociotech.communitymashup.source.ReadabilitySourceService name="Readability">
  <configuration>
     <properties Key="apiKey" Value=" "/>
  </configuration>
</sources>

Description

Adds readable content for all web site objects. Api key must be set in configuration.

Meta-Informations

Type

Description

Value

Items

MetaTagAdded to all items created by the readability source service.

readability

Item
MetaTagAdded to all created authors.

readability_author

Person
MetaTagAdded to the contents created from the excerpt values.

readability_excerpt

Content
MetaTagAdded to the readable content.

readability_content

Content
MetaTagAdded to the lead image identified by readability.

readability_lead_image

Image
MetaTagAdded to connections between persons and created content.

readability_person_content_con

Connection
MetaTagAdded to connections between organizations and created content.

readability_org_content_con

Connection
MetaTagAdded to connections between content and created content.

readability_content_content_con

Connection
Subcontent relationshipExcerpt will be sub content of full content if both are addedreferenceContent
Subcontent relationshipCreated content (full content or excerpt) will be sub content of existing content at content content relationship.referenceContent

Transformation

External

CommunityMashup

Readable web site version

Content

Excerpt of readable web site versionContent