Difference between revisions of "Nested comments (Userscript)"

From diaspora* project wiki
Jump to: navigation, search
(Usage: Added "Note that (...)" not sure you'll find it useful.)
(Drop i18n template)
 
(14 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Languages}}
 
 
{{Work_in_progress|date=2014-11-15}}
 
 
 
[[File:NestedComments Streamview.png|thumb|250px|right|Example of a nested comment discussion in the stream-view.]]
 
[[File:NestedComments Streamview.png|thumb|250px|right|Example of a nested comment discussion in the stream-view.]]
  
Line 9: Line 5:
 
== Functionality ==
 
== Functionality ==
  
'''Nested Comments''' allows the user to answer direct to a single comment instead just to a post. If the Script is used these comments are shown as a tree like subcomment.
+
'''Nested Comments''' allows the user to answer directly to a comment. If the script is used, these comments are shown as tree-like subcomments.
  
=== A little Tech ===
+
=== A little tech ===
  
What technicly happens is this: The Script creates a link at the beginning of and comment that shows to another comment. The text the link shows doesn't matter just its target. If the target is found on the current page the comment containing the link is considered and shown as a subcomment of that one that is linked.
+
What technically happens is this: the script creates a link, at the beginning of a comment, which leads to another comment. The text shown by the link doesn't matter, just its target. If the target is found on the current page, the comment containing the link is shown as a subcomment of the one it is linking to.
  
This way the script works totally transparent, also for those who do not use it, they can just click the link and will get to the comment this one is the answer to.
+
This way, the script works totally transparently, not only for the script users but also for those who do not use it. They can just click the link (and read the text hovering over the link, when the hovering option is used) to know the comment it is commenting on.
  
 
=== Usage ===
 
=== Usage ===
  
[[File:NestedComments Hover.gif|400px|thumb|right|Location of the comment button.]]Usage is simple, whenever you'd like to comment a comment and not the post move your cursor to the upper right corner of that comment, where you can usually delete your own comments or abuse others. There you will find a little plus (+) symbol, click on it and the comment-area will be prefilled with the code for a link.
+
[[File:NestedComments Hover.gif|400px|thumb|right|Location of the comment button.]]Usage is simple: whenever you'd like to comment on a comment, not the post itself, move your cursor to the upper right corner of that comment (that's where you can delete your own comments or flag abuse).  
 +
 
 +
There, you will find a little plus (+) symbol; click on it and the comment-area at the bottom of the page will be prefilled with the code for a nested comment link.
 +
 
 +
You can just write your comment after that link and you're done.
  
You can just write your comment behind that link and you're done.
+
Slightly more advanced users can also edit the link. The link's target should be kept untouched, otherwise the script will not be able to recognize it, but you can change the text the link shows (you may even leave a nearly invisible single dot) and edit or add the title-text (that is the text shown when you hover a link).
  
Little advanced users can also slightly edit the link. The links target itself should keep untouched otherwise the script will not be able to recognize it. But you can change the text the link shows (even to a nearly not visible single dot) and edit or add the title-text (that is the text shown when you hover a link).
+
You may use a quote to provide more context. To do so just select some text of the comment and hit the plus(+) while the quote is selected.  
  
You may use a quote to provide more context. If the quote you use is long (more than 20 characters), it will appear as an hover effect on the name of the commentator which appears at the beginning of your response. Otherwise, your quote appears instead of his of her name.
+
If the quote you use is long (more than 20 characters), it will appear as an hover effect on the name of the commentator which appears at the beginning of your response. Otherwise, your quote appears instead of his or her name.
 
[[File:long.gif|400px|thumb|right|Using quotes.]]
 
[[File:long.gif|400px|thumb|right|Using quotes.]]
  
Note that:
+
== Installation ==
 +
 
 +
=== Requirements ===
 +
As with [[Tools_to_use_with_Diaspora|other scripts for Diaspora]], you will need [https://addons.mozilla.org/en-US/firefox/addon/greasemonkey/ Greasemonkey] (Firefox), [https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo?hl=en Tampermonkey] (Chrome) or [http://en.wikipedia.org/wiki/Greasemonkey#Equivalents_for_other_browsers the equivalent for Safari]. Opera should run userscripts native without any extension.
  
* When reading your stream, a nested discussion will not appear as nested if a part of it is collapsed: you must click "Show more comments" to expand it and let the script process the whole discussion.
+
=== Sourcecode, Download and Installation ===
* Sometimes, the script will seem not to work. Give it a few instants.
 
  
Tips:
+
[https://github.com/DeusFigendi/Userscripts/blob/master/Diaspora/Nested_Comments.user.js Sourcecode], [https://github.com/DeusFigendi/Userscripts/raw/master/Diaspora/Nested_Comments.user.js Download and Installation]. Just click to install.
  
* You can
+
=== Troubleshooting ===
  
== Installation ==
+
==== Seems the script does not work anyhow ====
 +
 
 +
* Check if your pod is listed in the "include"-part of the script in the meta-data in the verry first 50 lines.
 +
* Check if the script is loaded (depends on browser)
 +
* Check if the script throws any errors by opening your error-console (Ctrl+Shift+J) and watching for "nested comments"-errors.
 +
 
 +
==== In a stream like view the comments ain't nested ====
 +
 
 +
* Unfold the comments by clicking "View more comments"
 +
* Be patient, wait for about 10 seconds.
 +
 
 +
==== I'm not sure I've been notified of all recent comments ====
  
=== Requirements ===
+
Scroll to the bottom of the page and refresh (Ctrl+R) to see for a few instants the discussion in non-nested view, before the script kicks in.
As with [[Tools_to_use_with_Diaspora|other scripts for Diaspora]], you will need [https://addons.mozilla.org/en-US/firefox/addon/greasemonkey/ Greasemonkey] (Firefox), [https://chrome.google.com/webstore/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo?hl=en Tampermonkey] (Chrome) or [http://en.wikipedia.org/wiki/Greasemonkey#Equivalents_for_other_browsers the equivalent for Safari].
 
  
=== Troubleshooting ===
+
==== The script's too fast! ====
  
* ''Remarks about the defective notifications system and the fact that it causes the user not to know how many new messages there are?''
+
* If trying again fails, [http://wiki.greasespot.net/images/7/7a/Win7-ff4-toolbar-monkey-menu.png deactivate the script] and refresh.
 +
* Change the timeout-values at the end of the script to higher values (e.g. 5000ms instead of 1999) to delay that "kick in".

Latest revision as of 02:46, 15 October 2018

Example of a nested comment discussion in the stream-view.

Nested Comments is an userscript by Deus Figendi that allows to create and view nested comments in diaspora-discussions.

Functionality

Nested Comments allows the user to answer directly to a comment. If the script is used, these comments are shown as tree-like subcomments.

A little tech

What technically happens is this: the script creates a link, at the beginning of a comment, which leads to another comment. The text shown by the link doesn't matter, just its target. If the target is found on the current page, the comment containing the link is shown as a subcomment of the one it is linking to.

This way, the script works totally transparently, not only for the script users but also for those who do not use it. They can just click the link (and read the text hovering over the link, when the hovering option is used) to know the comment it is commenting on.

Usage

Location of the comment button.

Usage is simple: whenever you'd like to comment on a comment, not the post itself, move your cursor to the upper right corner of that comment (that's where you can delete your own comments or flag abuse).

There, you will find a little plus (+) symbol; click on it and the comment-area at the bottom of the page will be prefilled with the code for a nested comment link.

You can just write your comment after that link and you're done.

Slightly more advanced users can also edit the link. The link's target should be kept untouched, otherwise the script will not be able to recognize it, but you can change the text the link shows (you may even leave a nearly invisible single dot) and edit or add the title-text (that is the text shown when you hover a link).

You may use a quote to provide more context. To do so just select some text of the comment and hit the plus(+) while the quote is selected.

If the quote you use is long (more than 20 characters), it will appear as an hover effect on the name of the commentator which appears at the beginning of your response. Otherwise, your quote appears instead of his or her name.

Using quotes.

Installation

Requirements

As with other scripts for Diaspora, you will need Greasemonkey (Firefox), Tampermonkey (Chrome) or the equivalent for Safari. Opera should run userscripts native without any extension.

Sourcecode, Download and Installation

Sourcecode, Download and Installation. Just click to install.

Troubleshooting

Seems the script does not work anyhow

  • Check if your pod is listed in the "include"-part of the script in the meta-data in the verry first 50 lines.
  • Check if the script is loaded (depends on browser)
  • Check if the script throws any errors by opening your error-console (Ctrl+Shift+J) and watching for "nested comments"-errors.

In a stream like view the comments ain't nested

  • Unfold the comments by clicking "View more comments"
  • Be patient, wait for about 10 seconds.

I'm not sure I've been notified of all recent comments

Scroll to the bottom of the page and refresh (Ctrl+R) to see for a few instants the discussion in non-nested view, before the script kicks in.

The script's too fast!

  • If trying again fails, deactivate the script and refresh.
  • Change the timeout-values at the end of the script to higher values (e.g. 5000ms instead of 1999) to delay that "kick in".