diff --git a/doc/BBCode.md b/doc/BBCode.md index fe7c1481f6..a45431f586 100644 --- a/doc/BBCode.md +++ b/doc/BBCode.md @@ -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: + +
[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.+ +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: + +
+[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 ... ++ +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: + +
+[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 ...+ +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:
[noparse][b]bold[/b][/noparse]: [b]bold[/b] - - diff --git a/doc/de/BBCode.md b/doc/de/BBCode.md index d3e205f0fa..0856c30e50 100644 --- a/doc/de/BBCode.md +++ b/doc/de/BBCode.md @@ -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: + +
[abstract]Total spannend! Unbedingt diesen Link anklicken![/abstract] +Hier erzähle ich euch eine total langweilige Geschichte, die ihr noch +nie hören wolltet.+ +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: + +
+[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 ... ++ +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: + +
+[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 ...+ +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 -------