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 -------