For Sone to work you will need a running Freenet node, of course. You will also need the Web of Trust plugin from the official plugins listed on your nodeās plugin manager page (*Configuration ā Plugins* in the menu).
-If you already have a web of trust identity, you can skip the next section.
-
-You will also need to create an identity in the web of trust. Select *Community* from the menu, choose āGenerateā and follow the instructions on-screen until your identity has been created.
+You will also need a web of trust identity to use Sone. If you do not already have a web of trust identity, select *Community* from the menu, choose āGenerateā and follow the instructions on-screen until your identity has been created.
### Loading/Installing
-For Sone to work you will need a running Freenet node and the WebOfTrust plugin. Loading Sone happens from Freenetās web interface using the āAdd an Unofficial Plugin from Freenetā section from the nodeās plugin manager at *Configuration ā Plugins*, at the bottom of the page. Enter the key of the plugin (starting with āUSK@ā) into the text field and press the āLoadā button. The plugin should then be downloaded from Freenet and started once itās ready.
+#### From Freenet
+
+If you just want to run the latest version of Sone you first have to obtain the plugin key from [Soneās homepage in Freenet](USK@nwa8lHa271k2QvJ8aa0Ov7IHAV-DFOCFgmDt3X6BpCI,DuQSUZiI~agF8c-6tjsFFGuZ8eICrzWCILB60nT8KKo,AQACAAE/sone/75/). Now head over to your nodeās plugin manager which you can reach from the menu at *Configuration ā Plugins*. At the bottom of the page thereās a section called āAdd an Unofficial Plugin from Freenet.ā Enter the key of the plugin into the text field and press the āLoadā button. The plugin should then be downloaded from Freenet and started once itās ready.
+
+#### From Disk
+
+If you have compiled Sone yourself, thereās a different section on the plugin manager page, called āAdd an Unofficial Plugin.ā Enter the full path name of the JAR file created by Gradle and press the āLoadā button. Sone should then be ready instantly.
The node will remember which plugins you loaded so that you donāt need to do that again after your node restarts (e.g. for updates).
When displaying posts and replies, Sone first parses the text. Special elements, such as Freenet URIs and Sone elements with a special syntax, are replaced with formatting that allow your browser to navigate the elements. Sone recognizes the following elements:
-* Links to Freenet URIs are linked to as-is. Make sure to separate the URI from surrounding text by whitespace, such as space or line breaks.
+* Links to Freenet URIs are linked to as-is. Make sure to separate the URI from surrounding text by whitespace, such as space or line breaks, or interpunction, such as commas and periods.
* Links to other Soneās profiles are added by the prefix āsone://ā followed by the ID of the Sone. It is also possible to get the link for a Sone from a post or reply by that Sone; just copy the URL behind the ā[link author]ā link.
* Links to other posts are added by the prefix āpost://ā followed by the ID of the post. You can also find the post ID behind the ā[link post]ā link below a post.