Some documentation for the usage of the "abstract" element.

This commit is contained in:
Michael Vogel 2016-02-23 22:45:06 +01:00
parent d27ed6e9d8
commit 86339cdb97
2 changed files with 114 additions and 2 deletions

View file

@ -143,6 +143,62 @@ Map
You can embed maps from coordinates or addresses.
This require "openstreetmap" addon version 1.3 or newer.
-----------------------------------------------------------
Abstract for longer posts
-------------------------
If you want to spread your post to several third party networks you can
have the problem that these networks have (for example) a length
limitation. (Like on Twitter)
Friendica is using a semi intelligent mechanism to generate a fitting
abstract. But it can be interesting to define an own abstract that will
only be displayed on the external network. This is done with the
[abstract]-element. Example:
<pre>[abstract]Totally interesting! A must-see! Please click the link![/abstract]
I want to tell you a really boring story that you really never wanted
to hear.</pre>
Twitter would display the text "Totally interesting! A must-see! Please
click the link!". On Friendica you would only see the text after "I
want to tell you a really ..."
It is even possible to define abstracts for separate networks:
<pre>
[abstract]Hi friends Here are my newest pictures![abstract]
[abstract=twit]Hi my dear Twitter followers. Do you want to see my new
pictures?[abstract]
[abstract=apdn]Helly my dear followers on ADN. I made sone new pictures
that I wanted to share with you.[abstract]
Today I was in the woods and took some real cool pictures ...
</pre>
For Twitter and App.net the system will use the defined abstracts. For
other networks (e.g. when you are using the Statusnet connector) the
general abstract element will be used.
If you use (for example) the "buffer" connector to post to Facebook or
Google+ you can use this element to define an abstract for a longer
blogpost that you don't want to post completely to these networks.
Networks like Facebook or Google+ aren't length limited. For this reason
the [abstract] element isn't used. Instead you have to name the explicit
network:
<pre>
[abstract]These days I had a strange encounter ...[abstract]
[abstract=goog]Helly my dear Google+ followers. You have to read my
newest blog post![abstract]
[abstract=face]Hello my Facebook friends. These days happened something
really cool.[abstract]
While taking pictures in the woods I had a really strange encounter ... </pre>
The [abstract] element isn't working with the native OStatus connection
or with connectors where we post the HTML. (Like Tumblr, Wordpress or
Pump.io)
Special
-------
@ -150,5 +206,3 @@ Special
If you need to put literal bbcode in a message, [noparse], [nobb] or [pre] are used to escape bbcode:
<pre>[noparse][b]bold[/b][/noparse]</pre> : [b]bold[/b]

View file

@ -145,6 +145,64 @@ eine Karte von [OpenStreetmap](http://openstreetmap.org) eingebettet werden. Zur
oder eine Adresse in obiger Form verwendet werden.
Zusammenfassung für längere Beiträge
------------------------------------
Wenn man seine Beiträge über mehrere Netzwerke verbreiten möchte, hat
man häufig das Problem, dass diese Netzwerke z.B. eine
Längenbeschränkung haben. (Z.B. Twitter).
Friendica benutzt zum Erzeugen eines Anreißtextes eine halbwegs
intelligente Logik. Es kann aber dennoch von Interesse sein, eine eigene
Zusammenfassung zu erstellen, die nur auf dem Fremdnetzwerk dargestellt
wird. Dies geschieht mit dem [abstract]-Element. Beispiel:
<pre>[abstract]Total spannend! Unbedingt diesen Link anklicken![/abstract]
Hier erzähle ich euch eine total langweilige Geschichte, die ihr noch
nie hören wolltet.</pre>
Auf Twitter würde das "Total spannend! Unbedingt diesen Link anklicken!"
stehen, auf Friendica würde nur der Text nach "Hier erzähle ..."
erscheinen.
Es ist sogar möglich, für einzelne Netzwerke eigene Zusammenfassungen zu
erstellen:
<pre>
[abstract]Hallo Leute, hier meine neuesten Bilder![abstract]
[abstract=twit]Hallo Twitter-User, hier meine neuesten Bilder![abstract]
[abstract=apdn]Hallo App.net-User, hier meine neuesten Bilder![abstract]
Ich war heute wieder im Wald unterwegs und habe tolle Bilder geschossen ...
</pre>
Für Twitter und App.net nimmt das System die entsprechenden Texte. Bei
anderen Netzwerken, bei denen der Inhalt gekürzt wird (z.B. beim
Statusnet-Connector) wird dann die Zusammenfassung unter [abstract]
verwendet.
Wenn man z.B. den "buffer"-Connector verwendet, um nach Facebook oder
Google+ zu posten, kann man dieses Element ebenfalls verwenden, wenn man
z.B. einen längeren Blogbeitrag erstellt hat, aber ihn nicht komplett in
diese Netzwerke posten möchte.
Netzwerke wie Facebook oder Google+ sind nicht in der Postinglänge
beschränkt. Aus diesem Grund greift nicht die
[abstract]-Zusammenfassung. Stattdessen muss man das Netzwerk explizit
angeben:
<pre>
[abstract]Ich habe neulich wieder etwas erlebt, was ich euch mitteilen möchte.[abstract]
[abstract=goog]Hallo meine Google+-Kreislinge. Ich habe neulich wieder
etwas erlebt, was ich euch mitteilen möchte.[abstract]
[abstract=face]Hallo Facebook-Freunde! Ich habe neulich wieder etwas
erlebt, was ich euch mitteilen möchte.[abstract]
Beim Bildermachen im Wald habe ich neulich eine interessante Person
getroffen ... </pre>
Das [abstract]-Element greift nicht bei der nativen OStatus-Verbindung
oder bei Connectoren, die den HTML-Text posten wie z.B. die Connectoren
zu Tumblr, Wordpress oder Pump.io.
Spezielle Tags
-------