0
Thanks

A few words of thanks would be greatly appreciated.

Formatting articles of the knowledge base

Be careful : Don't do a copy/paste of a tip found on another website. First of all, it's unuseful since the same tip is twice on internet. Moreover it's possible that there's a copyright on the tip. If you have nothing further to add, don't write anything.


The knowledge base (also called KB or FAQ) section Tips & Tricks uses a formatting type Wiki. Here are the possibilities.
  • The overall title is placed between the "equal" ("=").
  • The title of level 1 is placed between 2 equal signs ("==").
  • The title of level 2 is placed between 3 equal signs ("===").
  • .. etc ...


Warning : the line must begin and finish with the sign "="
=title of level 1=
==title of level 2==
=====title of level 5=====
* Bullet of level 1
** Bullet of level 2
*** Bullet of level 3


Note that it is not advisable to begin with a bullet of level 2, because the display will be preceded by an empty bullet of level! For the same reason, you should not skip level between each item.
*Test1
*Test2
**Test2.1
**Test2.2
***Test2.2.1
***Test2.2.2
**Test2.3
***Test2.3.1
****Test2.3.1.1
**Test2.4
**Test2.5
*Test3
*Test4
  • Test1
  • Test2
    • Test2.1
    • Test2.2
      • Test2.2.1
      • Test2.2.2
    • Test2.3
      • Test2.3.1
        • Test2.3.1.1
      • Test2.4
      • Test2.5
    • Test3
    • Test4
****Example


*


*
        • Example
*Test1
*Test2
***Test2.1.1
*Test3
  • Test1
  • Test2
  • Test2.1.1
  • Test2.1.1
  • Test3
Write twice underscore ("__") on each side of TOC (written in capitals), which will automatically create table of contents (with links) based on titles and subtitles.



Note that you must avoid putting links in your titles and subtitles! To create a link, simply use the following syntax :

[url text]


It is important to leave a space between the URL and the text. If you put no text, the URL will be used as text. You can also make a direct link to an article using the following syntax:
[[Keyword]]


For example, [[motherboard]] will automatically create a link to the article about motherboard. You can use the "anchors" to create a direct link to a specific paragraph of the article using titles of level 1 or 2.
You have to put the anchor between brackets [], use the anchor (# immediately followed by the title of level 1 or 2), followed by a space and finally by the visible text which will see to the reading. ... go to the paragraph [without space here #3-table-of-contents 3 - Table of Contents without space here] ... go to the paragraph 3 - Table of Contents
  • Use only tiny letters without an accent
  • No punctuation
  • Replace the spaces by a hyphen "-"
  • Replace the apostrophe " ' " by a hyphen "-"
  • Don't put links in the titles of level 1 or 2
  • Don't use parentheses ()
  • "1 - title" becomes "# 1-title"
To add an image, just use the following syntax :
[[Image: url_of_the_image]]
It is possible to use additionnal attibutes which can be combined. The attributes are separated by the sign "|" (AltGr+6). They can be placed in any order but the ALT attribute must be always be the last.
  • Positioning the image left :
    [[Image: url_of_the_image|left]]
  • Positioning the image right :
    [[Image: Image: url_of_the_image|right]]
  • Positioning the image centered (by default) :
    [[Image: url_of_the_image]]
  • Resizing the image (pixels) :
    [[Image: url_of_the_image|200px]]
  • The ALT of the image, it is the last attribute before the bracket :
    [[Image: url_of_the_image|right|150px|The ALT attribute of the image]]
With those tags, you can post some programming source code which would require a non-proportional font. The text put between the code tags will be automatically indented, and the spacing will be preserved.
<code>Code</code>
<gras>Text in bold</gras>
<ital>Text in italics</ital>
<souligne>Underlined text</souligne>
0
Thanks

A few words of thanks would be greatly appreciated.

Ask a question
CCM is a leading international tech website. Our content is written in collaboration with IT experts, under the direction of Jean-François Pillou, founder of CCM.net. CCM reaches more than 50 million unique visitors per month and is available in 11 languages.
This document, titled « Formatting articles of the knowledge base », is available under the Creative Commons license. Any copy, reuse, or modification of the content should be sufficiently credited to CCM (ccm.net).

Subscribe To Our Newsletter!

The Best of CCM in Your Inbox

Subscribe To Our Newsletter!