Qvitter/doc/faq.html
Hannes Mannerheim 94fe4284a0 not a clip
2014-11-28 03:42:13 +01:00

282 lines
25 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<p id="top">This a guide to {instance-name} especially for new users. It concentrates on how to get along, without going too much into details. For specific technical questions (e.g., how to set up a GNU Social-instance) please ask in the groups <a href="https://status.vinilox.eu/group/gnusocial">!gnusocial</a> and <a href="http://sn.postblue.info/group/sn">!sn</a>, or on {instance-name}'s Public Timeline. You may also find technical information at <a href="http://federation.skilledtests.com/">http://federation.skilledtests.com/</a></p>
<p>Other GNU Social / StatusNet FAQs & wikis:<br>
<a href="https://wiki.loadaverage.org/gnusocial/begin_to_be_social">https://wiki.loadaverage.org/gnusocial/begin_to_be_social</a><br>
<a href="http://wiki.gnusocial.de">http://wiki.gnusocial.de</a> (in German)</p>
<h2 id="faq-table-of-contents">Table of contents</h2>
<ul>
<li><a href="#faq-1">What is {instance-name}?</a></li>
<li><a href="#faq-2">What is GNU Social/StatusNet and the Federation?</a></li>
<li><a href="#faq-3">How to create an avatar image</a></li>
<li><a href="#faq-4">Why can't I find any "{instance-name} app" in Google Play Store or Apple's AppStore?</a></li>
<li><a href="#faq-5">What clients are there for GNU Social/StatusNet/{instance-name}?</a></li>
<li><a href="#faq-6">Where is the URL-shortener?</a></li>
<li><a href="#faq-7">How to set email preferences</a></li>
<li><a href="#faq-8">New {instance-name} and Classic {instance-name}</a></li>
<li><a href="#faq-9">What are those three Timelines on New {instance-name}?</a></li>
<li><a href="#faq-10">How to manage follower requests</a></li>
<li><a href="#faq-11">Can I delete my {instance-name} account?</a></li>
<li><a href="#faq-12">How to connect your {instance-name} account to your Twitter account</a></li>
<li><a href="#faq-13">How to write Direct Messages</a></li>
<li><a href="#faq-14">Favourites and Repeats/Requeets</a></li>
<li><a href="#faq-15">What does the "My colleagues at {instance-name}" option do?</a></li>
<li><a href="#faq-16">Groups</a></li>
<li><a href="#faq-17">Lists</a></li>
<li><a href="#faq-18">How to block</a></li>
<li><a href="#faq-19">How to follow someone on a remote instance</a></li>
<li><a href="#faq-20">How to manage the visibility of your notices</a></li>
<li><a href="#faq-21">How to cite conversations or parts of them</a></li>
<li><a href="#faq-22">How to follow keywords and hashtags</a></li>
<li><a href="#faq-23">Why doesn't my Repeat/Requeet show up on other instances?</a></li>
</ul>
<!-- 1 -->
<h2 id="faq-1">What is {instance-name}? <a href="#faq-table-of-contents">Top</a></h2>
<p>{instance-name} is one of many GNU Social-/StatusNet-<em>instances</em>. </p>
<p>{instance-name} is a project using the GNU Social-/StatusNet-system, combined with a familiar user interface (UI).</p>
<p>The original GNU Social-/StatusNet-web UI is available as "Classic {instance-name}", selectable from your header avatar (upper right).</p>
<!-- 2 -->
<h2 id="faq-2">What is GNU Social/StatusNet and the Federation? <a href="#faq-table-of-contents">Top</a></h2>
<p>GNU Social/StatusNet is a decentralised microblogging platform.</p>
<p>Users of one instance can follow, be followed by, and communicate with users of any other instance.</p>
<p>Other instances are, e.g., <a href="https://loadaverage.org/">loadaverage.org</a>, <a href="http://status.vinilox.eu/">status.vinilox.eu</a>, <a href="http://micro.fragdev.com/">micro.fragdev.com</a>, <a href="https://gnusocial.de/">gnusocial.de</a>, <a href="https://indy.im/">indy.im</a>, <a href="https://quitter.no/">quitter.no, <a href="http://rainbowdash.net/">rainbowdash.net</a>, etc. The current number of microblogging instances using the GNU Social/StatusNet software is probably about 50, {instance-name} is one of them. As they all use the same software (GNU Social/StatusNet) and transmission protocol (OStatus), they can talk to each other just like e-mail servers can talk to each other, even though they are independant and run by different companies.</p>
<p>Connections between instances are established by users following each other. Via such followings all these instances can (at least in principle) be joined into one compound structure or network of self-contained instances. This is called the Federation. GNU Social/StatusNet is structured in such a way that there needs to be only one following of a user <strong>a</strong> from instance <strong>A</strong> to a user <strong>b</strong> from instance to <strong>B</strong> to make <strong>b</strong> visible to everybody in instance <strong>A</strong> via <em>The Whole Known Network</em>. (See below on the <a href="#faq-9">Three Timelines</a>) The Whole Known Network is the wider network of instances as seen by {instance-name}. It looks different on, say, loadaverage, because on loadaverage there are different followings to remote instances than on {instance-name}. </p>
<p>There is no central "unit" the breakdown of which could bring down the whole network. If one instance goes down or the admins starts doing things you don't like, you can create your account on another instance. You will still be on the GNU Social-network and still be able to communicate with your GNU Social-friends. You just need to tell your contacts your new address.</p>
<p>Addresses on GNU Social look like this:</p>
<p class="indent">@user@instance.org</p>
<p>Your address is:</p>
<p class="indent">@{nickname}@{instance-url}</p>
<p>If you follow another user, or if the user is on the same instance, you may omit the ...@instance.org part and just use the short address</p>
<p class="indent">@user</p>
<!-- 3 -->
<h2 id="faq-3">How to create an avatar image <a href="#faq-table-of-contents">Top</a></h2>
<p>In New {instance-name}, go to your header avatar (upper right), then</p>
<p class="indent">"Edit profile" → Camera icon on top of your avatar</p>
<p>Use the + and - buttons to zoom in. Crop the image by dragging it with the mouse.</p>
<!-- 4 -->
<h2 id="faq-4">Why can't I find any "{instance-name} app" in Google Play Store or Apple's AppStore? <a href="#faq-table-of-contents">Top</a></h2>
<p>The network's name is GNU Social or StatusNet, so what you want is a GNU Social/StatusNet app.</p>
<p>(Remember, {instance-name} is just one instance of the GNU Social- or StatusNet-federation.)</p>
<!-- 5 -->
<h2 id="faq-5">What clients are there for GNU Social/StatusNet/{instance-name}? <a href="#faq-table-of-contents">Top</a></h2>
<p><strong>You can find information on clients and links to downloads here:</strong><br>
<a href="http://federation.skilledtests.com/Statusnet_clients.html">http://federation.skilledtests.com/Statusnet_clients.html</a><br>
<a href="http://wiki.gnusocial.de/gnusocial:clients">http://wiki.gnusocial.de/gnusocial:clients</a> (in German)</p>
<h3>Android clients</h3>
<p><em>Andstatus</em> (currently in active development by <a href="https://loadaverage.org/andstatus">@andstatus@loadaverage.org</a>)<br>
<em>has great conversation view as hierarchical tree<br>
Image upload and display of image attachments<br>
oversized notices can be opened via web browser</em></p>
<p><em>Mustard 0.3.5c</em> (Android 2.x - current) (many prefer this one, worth trying: GreyBubble theme)</p>
<p><em>Mustard 0.4.1</em> (Android 3.x - current) (a rather experimental new approach with newer look)</p>
<p><em>Mustard{MOD}</em> (Android 3.x - current)</p>
<p><em>All Mustards support geolocation, upload and display of image attachments, display of oversized notices from instances with larger character limit (open as attachment)</em></p>
<p><strong>Some usable Android Twitter clients (some features like sending DM / img upload may not work):</strong><br>
<em>Twidere</em><br>
<em>Seesmic 1.7.6</em> (use only this version!) (closed source)<br>
<em>Zwitscher</em><br>
<em>Twydroid</em> (closed source)<br>
<h3>iPhone clients</h3>
<p><em>Mayo</em> aka Mayonnaise <br>
<em>Meteoric</em> (payware)</p>
<h3>Windows clients</h3>
<p>Some Twitter clients (some features like sending DM / img upload not working):<br>
<em>Tweetdeck 0.38.2</em> (closed source) (last version before Twitter took over TweetDeck) is usable for basic functions. Download: <a href="http://www.oldversion.com/windows/download/tweetdeck-0-38-2">http://www.oldversion.com/windows/download/tweetdeck-0-38-2</a> Instructions: <a href="http://qttr.at/dmm">http://qttr.at/dmm</a> <a href="http://qttr.at/dmn">http://qttr.at/dmn</a><br>
<em>Qwit</em> (Download: <a href="https://code.google.com/p/qwit/">https://code.google.com/p/qwit/</a>)</p>
<h3>Mac OSX clients</h3>
<p><em>Tweetdeck 0.38.2</em> (closed source) Download: <a href="http://www.oldversion.com/mac/tweetdeck/">http://www.oldversion.com/mac/tweetdeck/</a> Instructions: see above.<br>
— Adium (Download: <a href="https://adium.im/">https://adium.im/</a>)</p>
<h3>GNU/Linux clients</h3>
<p><em>Choqok</em><br>
<em>Hotot</em> (use 0.9.7.32, that's the version that comes with Debian Wheezy)<br>
<em>Heybuddy</em> <br>
— more: <a href="http://federation.skilledtests.com/Statusnet_clients.html">http://federation.skilledtests.com/Statusnet_clients.html</a></p>
<!-- 6 -->
<h2 id="faq-6">Where is the URL-shortener? <a href="#faq-table-of-contents">Top</a></h2>
<p>In New {instance-name}:
<p class="indent">Links needs to be shortened manually before posting the notice. The "URL ><"-button will shorten any URLs pasted or written in the notice form.
<p>In Classic {instance-name}:
<p class="indent">Links are shortened automatically after the notice is posted. The settings are personal.<br>
<br>
Settings → URL<br>
<br>
Best use the settings:<br>
- qttr.at<br>
- URL longer than 30<br>
- Text longer than 139<br>
Screenshot: <a href="http://quitter.se/attachment/710078">http://quitter.se/attachment/710078</a></p>
<!-- 7 -->
<h2 id="faq-7">How to set email preferences <a href="#faq-table-of-contents">Top</a></h2>
<p>On New {instance-name} go to</p>
<p class="indent">Your header avatar (upper right) → Settings → Email</p>
<p>check accordingly:<br>
<em>— Send me notifications of new subscriptions through email. <br>
— Send me email when someone adds my notice as a favorite. <br>
— Send me email when someone sends me a private message. <br>
— Send me email when someone sends me an "@-reply". <br>
— Allow friends to nudge me and send me an email. </em></p>
<!-- 8 -->
<h2 id="faq-8">New {instance-name} and Classic {instance-name} <a href="#faq-table-of-contents">Top</a></h2>
<p>New {instance-name} is the default user interface. It is visually very similiar to other well known commercial microblogging services. Its technical name is "Qvitter". In discussions "Qvitter" and "New {instance-name}" can mean the same thing, but "Qvitter" mostly refers to the software and "New {instance-name}" refers to the installation of the Qvitter-software on {instance-name}.</p>
<p>Classic {instance-name} is the canonical GNU Social-/StatusNet-interface. At the moment some settings and features (e.g., creating a group) have to be done in Classic {instance-name} as they are not yet implemented in New {instance-name}.</p>
<p>To switch to Classic {instance-name} go to</p>
<p class="indent">Your header avatar (upper right) → Classic {instance-name}</p>
<!-- 9 -->
<h2 id="faq-9">What are those three Timelines on New {instance-name}? <a href="#faq-table-of-contents">Top</a></h2>
<p>There are three timelines that show differerent notices (depending on the sources):</p>
<p><strong>Timeline ("Home"):</strong><br>
all notices from the people you follow (not just the ones they send to people you happen to follow as well).</p>
<p><strong>Public Timeline:</strong><br>
all notices posted by {instance-name} accounts.</p>
<p><strong>The Whole Known Network:</strong><br>
not only all notices of the Public Timeline but also those of all people on other ("remote") instances of the GNU Social-/StatusNet-federation followed by at least one {instance-name} user (i.e. accounts known to {instance-name}).</p>
<!-- 10 -->
<h2 id="faq-10">How to manage follower requests <a href="#faq-table-of-contents">Top</a></h2>
<p>In general, you will want to stick with the default settings:</p>
<p class="indent">yes to "let anyone follow me" (1)</p>
<p class="indent">no to "Make updates visible only to my followers"</p>
<p>If you really want to change these settings in New {instance-name} go to: </p>
<p class="indent">Your header avatar (upper right) → Settings → Profile</p>
<p><em>(1): Change to "Ask me first" and you will receive e-mail notifications when someone wants to follow you. It leaves the subscription request pending until you either confirm or reject it. (But this does not work in New {instance-name} yet, so be careful with this setting.)</em></p>
<!-- 11 -->
<h2 id="faq-11">Can I delete my {instance-name} account? <a href="#faq-table-of-contents">Top</a></h2>
<p>You can delete your account, but all your notices will be deleted on {instance-name} as well and this will break conversation threads. If you restore your account on another instance, it's better to rename your {instance-name} account to something like MyNickhasmovedtoFragdev instead of deleting it.</p>
<p>To delete your account go to:</p>
<p class="indent">Your header avatar (upper right) → Settings → Profile → Delete account (right column)</p>
<!-- 12 -->
<h2 id="faq-12">How to connect your {instance-name} account to your Twitter account <a href="#faq-table-of-contents">Top</a></h2>
<p>You can forward your notices to Twitter.</p>
<p>In New {instance-name}:</p>
<p class="indent">Your header avatar (upper right) → Settings → Twitter</p>
<p>You are forwarded to Twitter and have to authorise {instance-name} to use your Twitter account.</p>
<p><em>According to user reports this doesn't always work on the first or second attempt. If it doesn't, you may have to try again later. The cause of the problem may be on Twitter's side. Your browser must not block Javascript or Cookies.</em></p>
<!-- 13 -->
<h2 id="faq-13"> How to write Direct Messages <a href="#faq-table-of-contents">Top</a></h2>
<p>Direct Messages are only supported in Classic {instance-name} at the time of writing (Messages in the left menu).</p>
<p class="indent">Your header avatar (upper right) → Classic Quitter → Messages (left column)</p>
<p>You can use apps like Mustard and Mayo to send DMs.</p>
<p><em>Note:</em><br>
- Direct Messaging only works within the same instance ({instance-name} in this case)<br>
- to send DMs you need to mutually follow each other</p>
<!-- 14 -->
<h2 id="faq-14">Favourites and Repeats/Requeets <a href="#faq-table-of-contents">Top</a></h2>
<p>In all the three timelines you can click on a notice to expand it and see who has favoured or repeated it.</p>
<p>(You can setup <a href="#faq-7"><em>E-mail Notifications</em></a> to notify you when your notices have been fav'ed.</p>
<p>Favs and Repeats/Requeets look like this in New {instance-name}: <a href="http://qttr.at/du6">http://qttr.at/du6</a> and like this in Classic {instance-name}: <a href="http://qttr.at/du5">http://qttr.at/du5</a></p>
<!-- 15 -->
<h2 id="faq-15">What does the "My colleagues at {instance-name}" option do? <a href="#faq-table-of-contents">Top</a></h2>
<p>In Classic {instance-name}, there is an option to post to "My colleagues at {instance-name}". This will stop the notice from "federating". It will only be visible to your followers on {instance-name}.</p>
<!-- 16 -->
<h2 id="faq-16">Groups <a href="#faq-table-of-contents">Top</a></h2>
<h3>Public Groups</h3>
<p>You can create a group for nearly any topic, like Feminism, Football, FreeBSD. ("nearly" because Swedish law prohibits slander and hate speech and holds the owner of a site responsible for such content.)</p>
<p>You can be a member of as many groups as you like. As group-member you can post to the whole group by attaching ! to the group name, e.g., <em>!feminism</em>, in the notice. All group members, whether or not they follow you, will get the notice in their Home Timelines. You follow and unfollow a group like you follow and unfollow a person. </p>
<p>A list of groups <em>hosted on {instance-name}</em> can be found here:<br>
<a href="{instance-url-with-protocol}groups">{instance-url-with-protocol}groups</a></p>
<p>A list of groups <em>hosted also on remote instances</em> can be found here:<br>
<a href="http://www.skilledtests.com/wiki/List_of_federated_Statusnet_groups">http://www.skilledtests.com/wiki/List_of_federated_Statusnet_groups</a></p>
<p>To create a group go to:</p>
<p class="indent"><a href="{instance-url-with-protocol}groups">{instance-url-with-protocol}groups</a> → Create new group</p>
<h3>Private Groups</h3>
<p>An admin of a group has the option to declare it <em>private</em>. This means:</p>
<p>1) new members must be approved by the admin(s), and</p>
<p>2) all notices are forced to be <em>private</em>, i.e.,</p>
<p class="indent">notices in the group are only visible to group members (they don't appear in the Public Timeline), and</p>
<p class="indent">it's not possible for users of other instances to be members of a private group on {instance-name}.</p>
<!-- 17 -->
<h2 id="faq-17">Lists <a href="#faq-table-of-contents">Top</a></h2>
<p>Lists are available only in Classic {instance-name}. Due to feature merges in GNU Social, they do work but are a bit messy to manage.</p>
<h3>Adding users to a list</h3>
<p>The main hurdle with lists on {instance-name} is to create a new one. After its creation, you can manage it and add people from {instance-name} as well as from remote instances on its newly created page (see below).</p>
<p>To start a list in Classic {instance-name} you best proceed by browsing through the subscription lists of someone who has an account on {instance-name}, not on a remote instance. In the latter case you will not be able to add people from their subscription lists to your list, i.e, create a list at all.</p>
<p>In both subscription lists you'll find beneath each person listed a tiny box with an edit-symbol. As they show up in these lists, it's no longer problematic whether they have their account on {instance-name} or on a remote instance. Click on that and type the name of your list. You'll receive an error message, but don't mind, just click "ok" and refresh the page. The list has been successfully created and is now shown in the left hand side column.</p>
<h3>Managing your lists</h3>
<p>To manage your list, go to your page in Classic {instance-name} and open the list by clicking on its name in the left column. On its page, click "Edit" and a menue opens.</p>
<p>In the section "Add or remove people" below you can now search every person known to {instance-name} from the whole network by name and add her to your list. (Which isn't possible when the person appears only in subscription lists of people on remote instances. See above.) Likewise you can remove the person from the lists here.</p>
<p>Right now you can remove people from a list, even empty a list, but you cannot delete the list in the upper section. Trying to delete it only returns an error message that is effective this time. So be careful not to create too many lists that later on clutter your left hand side column.</p>
<p>In the upper section you can reword the list's name and give it a description that shows up on its page. With the option "private" you can make the list invisible to other people on {instance-name}.</p>
<!-- 18 -->
<h2 id="faq-18">How to block <a href="#faq-table-of-contents">Top</a></h2>
<p>To block a {instance-name} user, go to their profile in Classic {instance-name}</p>
<p class="indent">{instance-url-with-protocol}&lt;username&gt;</p>
<p>and click "block" below their profile desription</p>
<p>We don't recommend blocking people from remote instances as there are still issues with this feature.</p>
<!-- 19 -->
<h2 id="faq-19">How to follow someone on a remote instance <a href="#faq-table-of-contents">Top</a></h2>
<p>If you click a remote nickname in New {instance-name} you are brought to a small profile window showing the full remote address, e.g., @blabla@status.vinilox.eu</p>
<p>Click the button "Follow". In New {instance-name} that should be all.</p>
<p>In Classic {instance-name} you're forwarded to the remote instance's user profile (which may differ in layout and theme from Classic {instance-name}). Look for the Subscribe-button (usually in the upper right). A subscription box opens and you are prompted to enter your own "webfinger address", i.e., {nickname}@{instance-url} Subscribe and you are redirected to your Classic {instance-name} page where you have to confirm the subscription.</p>
<!-- 20 -->
<h2 id="faq-20">How to manage the visibility of your notices <a href="#faq-table-of-contents">Top</a></h2>
<p>There are several ways to make notices visible only to selected people, not to the public. <strong>None of these work in New {instance-name} yet.</strong></p>
<p>All four methods only work within the same instance. Users outside {instance-name} won't be able to see the notice.</p>
<p>a. Direct Messages → The notice will be visible only to its recipient in his DM inbox (there are no Direct Messages to more than one person).</p>
<p>b. Set your account to "Make updates visible only to my followers" and "Ask me first if someone wants to follow me" in</p>
<p class="indent">Settings → Profile → Subscription policy (below)</p>
<p>c. Post to a private group of which you are a member → The post will only be visible to the group members (see above under "Groups")</p>
<p>(Note to c: You can use any client to post to a private group by using the !group-tag.)</p>
<p>d. Post to a public group and close the lock on the right of the drop-down menu beneath the message field → The post will only be visible to the group members. (Although at the time of writing, this does not work. The post will be visible to everyone.)</p>
<p><em>(Note to d: Make sure you don't leave "Everyone" or "My Colleagues at {instance-name}" selected, otherwise your post will go to the timelines of every {instance-name} user, which is not what you want if you close the lock)</em></p>
<p><em>(Note to d: The lock method is only available in Classic {instance-name}. There is no lock feature in New {instance-name} or any other known client at the time of writing.)</em></p>
<!-- 21 -->
<h2 id="faq-21">How to cite conversations or parts of them <a href="#faq-table-of-contents">Top</a></h2>
<p>Sometimes in a blog-post or email, you don't want to cite just one notice but a whole conversation. Each notice, each reply, and each conversation has its own URL, and the ways to find them differ slightly in Classic {instance-name} and in New {instance-name}.</p>
<p><strong>New {instance-name}</strong></p>
<p>In New {instance-name} click on the time stamp of a notice (or "details" if you have expanded it). This will show the notice page with the conversation expanded.</p>
<p><strong>Classic {instance-name}</strong></p>
<p>Click on the the time stamp of any notice. The notice will reappear on a separate page. Click "in context". The whole conversation that this notice is involved in will be displayed on a new page, with the selected notice either in the top or further down.</p>
<!-- 22 -->
<h2 id="faq-22">How to follow keywords and hashtags <a href="#faq-table-of-contents">Top</a></h2>
<p>Similar to following persons or groups you can, in Classic {instance-name}, subscribe to (or follow) hashtags and search words. Notices containing them will then appear in your timeline. </p>
<p>Following search words and hashtags is not limited to notices from accounts on {instance-name} but includes notices from remote instances as well.</p>
<p>To follow hashtags (# + ...), put the word with the hashtag-symbol # prefixed into the search box of Classic {instance-name} and press Enter. You'll arrive at the search result page. Similiar, to subscribe to search words, put them without hashtag-symbol into the search box. You'll get a much larger list because the search not only covers individual words but also looks for occurrences of the phrase inside larger phrases. To both the hashtag and the search word, click on the tiny "Subscribe"-button in the upper right corner of the lists. You'll then receive the notices containing them in your timeline.</p>
<p>Following one word often yields too many results, so it is expedient to combine words and follow them as complete phrases.</p>
<p>You can unfollow those notices by unfollowing the hashtags and search phrases.</p>
<p>For an overview which phrases you follow, enter the URLs for<br>
hashtags: <a href="{instance-url-with-protocol}{nickname}/tag-subscriptions">{instance-url-with-protocol}{nickname}/tag-subscriptions</a><br>
search words and phrases: <a href="{instance-url-with-protocol}{nickname}/search-subscriptions">{instance-url-with-protocol}{nickname}/search-subscriptions</a></p>
<p>On those pages you can manage your subscriptions, that is, add more phrases and hashtags or unfollow them.</p>
<!-- 23 -->
<h2 id="faq-23">Why doesn't my Repeat/Requeet show up on other instances? <a href="#faq-table-of-contents">Top</a></h2>
<p>In the latest versions of GNU Social, repeats/requeets do not get sent to your followers on other instances. This was possible some time ago in StatusNet, but this feature has been removed due to a security issue. GNU Social developers are working on a solution. In the meantime, if you really want your Repeat/Requeet to federate, you can always do a "manual repeat", i.e., write RQ @username, and then copy-paste the notice.</p>
<p class="faq-credits"><em>Thanks to <a href="https://quitter.se/simsa0">@simsa0</a> and <a href="https://quitter.se/mcscx">@mcscx</a> for their work on this FAQ. Any errors are due to bad editing by <a href="https://quitter.se/hannes2peer">@hannes2peer</a>.</em></p>