Forum Help: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
(Simplify punctuation)
(Updated content; used this: http://forum.qt.io/topic/52200/forum-general-guide)
Line 1: Line 1:
{{Delete | reason=Obsolete information.}}
[[Category:General]]
[[Category:General]]


= Help on using the Forum =
= Help on using the Forum =


== Getting started ==
Our forum is located at [http://forum.qt.io forum.qt.io].
 
* First thing is to spend a few seconds to see the 3 golden rules in the [http://forum.qt.io/rules friendly forum rules page…]
* The forum and the wiki uses a simple [http://txstyle.org/ Textile] formatting syntax
* Be sure to visit the [http://qt.io/ranks ranks] page to see how ranks and points work.
* Be sure to also see the [http://qt.io/whatisratings ratings] and [http://qt.io/whatistags tags] links to understand how they work.


== Asking questions ==
== Before asking a question ==


* Make sure that the question or comment you have, hasn't been already asked. Use the search field on the top right of the screen for this purpose.
* Make sure that the question or comment you have, hasn't been already asked. Use the search field on the top right of the screen for this purpose.
* You could search by [http://qt.io/tags/ tags] too
* You could search by [http://forum.qt.io/tags tags] too
* There are over [http://qt.io/faq 400+ FAQs] covering many topics already
* There are over 400 [[Technical FAQ | FAQs]] covering many topics already
* Browse the various forums already available and post your new thread under relevant forum.  
* Browse the various forums already available and post your new thread under relevant forum.  
* The forum home page has a brief description on each of the available forums, if not sure post it in "Desktop" and one of the moderators will help you out.
* The forum home page has a brief description on each of the available forums, if not sure post it in "General and Desktop".
* Use the preview option to check your edits before you save unless you are 120% sure that you '''never''' make mistakes.
* Use the preview to check your edits before you save unless you are 120% sure that you '''never''' make mistakes.
* You could tag important keywords, to help the next person who wants to search
* Once your question has been answered, be sure to confirm that your problem has been solved
* Common practice is to tag such posts with "solved" or also prefix the subject with [Solved]. This will help the next search.
* Post subsequent or related questions in a new thread (you can refer the old one), this way one thread per question. Again easy to search later
* Post subsequent or related questions in a new thread (you can refer the old one), this way one thread per question. Again easy to search later


== Code Wrapping and Syntax highlighting ==
== Voting ==
 
In the toolbar you will find a code tag (an "at" sign) to make code highlighted like this:
 
<code> #include <QtGui>
#include "window.h"
 
int main(int argv, char *'''args)
{
QApplication app(argv, args);
 
Window window;
window.show();
 
return app.exec();
}</code>
 
Qt classes are of course supported.
 
''' Be sure to add the @ tag before and after your code.
* You can use the link feature available in the toolbar when you type in any links.
* Properly format your code for easy reading
* If you need the @ in your code, replace it with @ or @
* Use [http://www.ascii.cl/htmlcodes.htm html codes] for displaying other special characters in code
 
'''Hint''' : if you want to try out some code that has syntax highlighting, then double click in a code block to select it. Copy paste it in Qt Creator and play with it. If you manually select the code by dragging, you can end up with one line of code because that way linefeeds are not used.
 
== SOLVED and CLOSED threads ==
 
On a ''CLOSED'' thread no one can post comments anymore. This state can be set by forum admins. It's usually done when the discussion becomes too off topic or things escalate in another way.
 
Marking a thread as ''SOLVED'' is just an addition to the thread's topic. The original poster (or a forum moderator) can change the topic, just click on the ''edit'' link below your avatar and user name. It usually marks that a question is answered sufficiently. It does ''not'' mean that further discussions are prohibited. That would not be a good idea either: Although a problem is solved, discussion may bring up even better solutions.
 
== Voting by Polls ==
 
* Start a new thread as usual
* Give some background about the poll in the text field (links to previous discussions are useful!)
* Click the link below the text field to add a poll to your thread
* Make sure your question is as clear and understandable as possible, the same goes for all the optional answers
* You can edit your poll as long as no user has voted
* Every user can only vote once, multiple options are not possible
* A neutral option might be useful in some cases.
* Submit
* Below the poll, the thread behaves as any other in the forum
 
== Explanation of the editor ==
 
=== There are 9 buttons beneath "Post a reply" ===
 
The first 5 are straightforward
1) Bold
2) Italic
3) Stroke through
4) Bulleted list
5) Numeric list
 
6) Picture
To insert pictures you need an internet service which stores your picture. There are free services like Imgur, DropBox. Just make sure you put the picture in the public area. Then you use the link to that picture on the internet (http://db.rrt/CODE) and you paste this in the dialogbox that appears when you click the Picture button..
Make sure that you are using a link to the picture. You can see with the ''"preview" button'' that the picture is actually displayed in your post. There are services (e.g. imageshack.us) providing only a link to a webpage containing the picture. The ''"preview" button'' will show you that the link is broken. Check out how to get the proper link to the picture.
(Note: dropbox has no more public folder for people making a dropbox account now. Only old users can benefit from it)
 
7) Link
When you click this button you get a dialog box in which you can type or paste an internet address. This address will appear in the editor with a prefix text highlighted. Just type to change the text to something more useful e.g." Link to bug report". The result is a clickable hyperlink with a descriptive text and a location like [bugreports.qt.nokia.com] .
 
8) Quote
Select a text, push this button and it will appear with a distinctive gray background
 
9) Code
Select your code and it will get row numbers you can refer to and also syntax highlighting and colors.
 
=== Below the text editor ===
 
You can select :
''Notify me via email when someone posts in this thread''
If you want emails sent to you when somebody replies to this topic.
 
The ''"preview" button'' shows you your post as it would appear to others. This helps to see if everything is well made up.
 
Finally you click the ''"Post reply" button'' and your text will appear in the forum.


=== On the right of your topic ===
In the topic and reply headers you'll find a host of functions. Following, flagging for moderation and favouriting for later looking at are all the bread and butter of forums.
Next to those you'll find the voting buttons, up, 0, down. (down only if you have been around for a while)


Use the "''quote''" link to make a copy of the post with the name of the one that posted it.
Use the up button to say thanks to the poster. These votes impact the reputation of the poster. And we want to know who provides good answers. Votes on a topic can also be used to find hot topics and searching.
Use the down button to signify that the post is off topic or otherwise not good content.


Sometimes you only see errors after posting your message. Then you can use the "''edit''" link on the right of your post to change things. Please use Edit : if there are big changes made.
== Posting topics ==


If you click on "link" then you get a web adress in the edit field of your webbrowser like this:
When you post a topic, please use tags. Tags are a wonderful way to find things later on.
http://forum.qt.io/viewthread/7709/#45281
Check which category you should be posting to. There is a huge number of categories here.
Which you can use to point to a specific post.


The ''"report"'' link is used if you want to report anything like topics that don't belong here.
== The editor ==
For instance spam or report to the admins that a topic is getting out of hand, or that you think somebody is making a personal attack on another user.


== Need help? ==
The editor accepts markdown. You can find [https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet cheat sheets] on the web.


Just start a thread on the [http://forum.qt.io/viewforum/5/ Beta Testing Forum], and someone will help you
The most important tags to remember are:


… this article is "work in progress" …
# makes a heading, ## makes a sub-heading
The triple backtick ``` marks the start and end of a code block. (the highlighter will try to guess the language, but you can force it by writing cplusplus or js or something on the same line as the three backticks)
A single backtick ` marks the start and end of a code snippet
A star * will create lists
Numbered lists are made with numbering the lines 1. 2. 3. and so on
Indents in lists are two spaces at the start of the line
The backslash \ will let you escape characters, if you want to write a * at the start of a line for instance.


TODO:
== Marking a thread as solved ==


* FAQ based on questions in the forums
After you get a satisfactory answer, please go and vote the answer up and select the topic as solved from the 'Topic Tools' menu under your original post.
* Styling guidelines

Revision as of 16:52, 23 March 2016


Help on using the Forum

Our forum is located at forum.qt.io.

Before asking a question

  • Make sure that the question or comment you have, hasn't been already asked. Use the search field on the top right of the screen for this purpose.
  • You could search by tags too
  • There are over 400 FAQs covering many topics already
  • Browse the various forums already available and post your new thread under relevant forum.
  • The forum home page has a brief description on each of the available forums, if not sure post it in "General and Desktop".
  • Use the preview to check your edits before you save unless you are 120% sure that you never make mistakes.
  • Post subsequent or related questions in a new thread (you can refer the old one), this way one thread per question. Again easy to search later

Voting

In the topic and reply headers you'll find a host of functions. Following, flagging for moderation and favouriting for later looking at are all the bread and butter of forums. Next to those you'll find the voting buttons, up, 0, down. (down only if you have been around for a while)

Use the up button to say thanks to the poster. These votes impact the reputation of the poster. And we want to know who provides good answers. Votes on a topic can also be used to find hot topics and searching. Use the down button to signify that the post is off topic or otherwise not good content.

Posting topics

When you post a topic, please use tags. Tags are a wonderful way to find things later on. Check which category you should be posting to. There is a huge number of categories here.

The editor

The editor accepts markdown. You can find cheat sheets on the web.

The most important tags to remember are:

  1. makes a heading, ## makes a sub-heading

The triple backtick ``` marks the start and end of a code block. (the highlighter will try to guess the language, but you can force it by writing cplusplus or js or something on the same line as the three backticks) A single backtick ` marks the start and end of a code snippet A star * will create lists Numbered lists are made with numbering the lines 1. 2. 3. and so on Indents in lists are two spaces at the start of the line The backslash \ will let you escape characters, if you want to write a * at the start of a line for instance.

Marking a thread as solved

After you get a satisfactory answer, please go and vote the answer up and select the topic as solved from the 'Topic Tools' menu under your original post.