Talk:Wiki Editing Hints

From Qt Wiki
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Handling in-text keywords

I've seen a lot of different usage on when to use Italic, Bold, I+B and also <tt>. The main reason is for distinguishing different symbols in blocktexts. The question is, when should we use italic, bold, both or <tt> tag?

I'll just set some examples:

From Editing How to Use QPushButton

  • An instance of QPushButton is created. Signal released() is connected to slot handleButton() which changes the text and the size of the button.

From QtWhitepaper (pretty much edited by myself)

  • Qt applications can be built visually using Qt Designer, a flexible user interface builder with support for IDE integration.
  • This snippet will show the message- "Ready" on status bar. You can set property statusHint in any widget.
  • The QAction class encapsulates this concept. It allows programmers to define an action in one place.

Selfreferred articles

A lot of articles are written in a subjective manner. Should these articles be rewritten for a neutral stand? There are no authors left within the wiki-context, which kind of makes the 'I did find' or 'I always asked myself' and similar idiom kind of surreal.

Code Blocks

Currently, <code> blocks are used. <code> is meant for single line code snippets and should be embedded within a <pre> tag for multi line code blocks[1]. The result is as follows:

<code>
#include <something.h>

int main()
{
    return 0;
}
</code>

As can be seen, the <code> tags are shown, but the text is formatted over multiple lines.

However, using <syntaxhighlight lang="cpp"> will cause the text to be formatted and colored. The result is as follows:

#include <something.h>

int main()
{
    return 0;
}

This section may be relevant to Handling in-text keywords as the examples where <tt> are used should possibly be switched to <code> based on their needs.