From 86339cdb976f4ca28499b61e849cbcaa3f245e8b Mon Sep 17 00:00:00 2001 From: Michael Vogel Date: Tue, 23 Feb 2016 22:45:06 +0100 Subject: [PATCH 1/4] Some documentation for the usage of the "abstract" element. --- doc/BBCode.md | 58 ++++++++++++++++++++++++++++++++++++++++++++++-- doc/de/BBCode.md | 58 ++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 114 insertions(+), 2 deletions(-) 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 ------- From db9266346675b164a37c1ff3ea393f02d37af47f Mon Sep 17 00:00:00 2001 From: Michael Vogel Date: Wed, 24 Feb 2016 07:33:20 +0100 Subject: [PATCH 2/4] One line, one sentence --- doc/BBCode.md | 29 +++++++---------------------- doc/de/BBCode.md | 40 +++++++++------------------------------- 2 files changed, 16 insertions(+), 53 deletions(-) diff --git a/doc/BBCode.md b/doc/BBCode.md index a45431f586..75cad5d96f 100644 --- a/doc/BBCode.md +++ b/doc/BBCode.md @@ -148,22 +148,15 @@ 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) +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: +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 ..." +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: @@ -176,17 +169,11 @@ 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. +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. +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: +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]
@@ -196,9 +183,7 @@ newest blog post![abstract]
 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) +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 ------- diff --git a/doc/de/BBCode.md b/doc/de/BBCode.md index 0856c30e50..d299072d61 100644 --- a/doc/de/BBCode.md +++ b/doc/de/BBCode.md @@ -131,8 +131,7 @@ Außerdem kann *url* die genaue url zu einer ogg Datei sein, die dann per H 
[url]*url*[/url]
-Wenn *url* entweder oembed oder opengraph unterstützt wird das eingebettete -Objekt (z.B. ein Dokument von scribd) eingebunden. +Wenn *url* entweder oembed oder opengraph unterstützt wird das eingebettete Objekt (z.B. ein Dokument von scribd) eingebunden. Der Titel der Seite mit einem Link zur *url* wird ebenfalls angezeigt. Um eine Karte in einen Beitrag einzubinden, muss das *openstreetmap* Addon aktiviert werden. Ist dies der Fall, kann mit @@ -148,25 +147,17 @@ 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). +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: +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. +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: +Es ist sogar möglich, für einzelne Netzwerke eigene Zusammenfassungen zu erstellen: 
 [abstract]Hallo Leute, hier meine neuesten Bilder![abstract]
@@ -175,20 +166,11 @@ erstellen:
 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. +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. +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: +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]
@@ -199,9 +181,7 @@ 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. +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 ------- @@ -209,5 +189,3 @@ Spezielle Tags Wenn Du über BBCode Tags in einer Nachricht schreiben möchtest, kannst Du [noparse], [nobb] oder [pre] verwenden um den BBCode Tags vor der Evaluierung zu schützen: 
[noparse][b]fett[/b][/noparse]
: [b]fett[/b] - - From 8369e6ce596b766745ccae3e70b74d2b0a6b50ae Mon Sep 17 00:00:00 2001 From: Michael Vogel Date: Wed, 24 Feb 2016 07:37:18 +0100 Subject: [PATCH 3/4] Clarification between statusnet and GNU Social. --- doc/BBCode.md | 2 +- doc/de/BBCode.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/BBCode.md b/doc/BBCode.md index 75cad5d96f..5aa33fd81b 100644 --- a/doc/BBCode.md +++ b/doc/BBCode.md @@ -169,7 +169,7 @@ 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. +For Twitter and App.net the system will use the defined abstracts. For other networks (e.g. when you are using the "statusnet" connector that is used to post to GNU Social) 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. diff --git a/doc/de/BBCode.md b/doc/de/BBCode.md index d299072d61..5f24fa2b61 100644 --- a/doc/de/BBCode.md +++ b/doc/de/BBCode.md @@ -166,7 +166,7 @@ Es ist sogar möglich, für einzelne Netzwerke eigene Zusammenfassungen zu erste 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. +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, der für das Posten nach GNU Social verwendet wird) 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. From 68d7beb2981c22e4251542c835fac0ac40421390 Mon Sep 17 00:00:00 2001 From: Michael Vogel Date: Wed, 24 Feb 2016 07:43:13 +0100 Subject: [PATCH 4/4] Welcome to the live editing and commenting of the pull request ;-) --- doc/BBCode.md | 18 +++++++++++++----- doc/de/BBCode.md | 14 ++++++++++---- 2 files changed, 23 insertions(+), 9 deletions(-) diff --git a/doc/BBCode.md b/doc/BBCode.md index 5aa33fd81b..803f716aeb 100644 --- a/doc/BBCode.md +++ b/doc/BBCode.md @@ -148,15 +148,20 @@ 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) +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: +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 ..." +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: @@ -173,7 +178,9 @@ For Twitter and App.net the system will use the defined abstracts. For other net 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: +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]
@@ -183,7 +190,8 @@ newest blog post![abstract]
 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) +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 ------- diff --git a/doc/de/BBCode.md b/doc/de/BBCode.md index 5f24fa2b61..cd9fa7673e 100644 --- a/doc/de/BBCode.md +++ b/doc/de/BBCode.md @@ -147,9 +147,13 @@ 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). +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: +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 
@@ -166,11 +170,13 @@ Es ist sogar möglich, für einzelne Netzwerke eigene Zusammenfassungen zu erste
 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, der für das Posten nach GNU Social verwendet wird) wird dann die Zusammenfassung unter [abstract] verwendet. +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, der für das Posten nach GNU Social verwendet wird) 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: +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]