====== Formatting Texts with Wiki Notation ======

The wiki notation allows for simple emphasis -- no matter whether in standalone texts, questions, items, or verbal scale anchors.

**Tip:** Use emphasis __very__ sparingly. A homogeneous layout usually looks considerably more professional. More than 2 or 3 instances of emphasis per page tend to result in a chaotic appearance rather than in orientation.


===== Overview of the Wiki Notation =====

^ Description ^ Format Code ^ Example ^ Result ^
| underlined | <nowiki>__Text__</nowiki> | <nowiki>I am __not__ in favor of the proposal</nowiki> | I am __not__ in favor of the proposal |
| bold | <nowiki>**Text**</nowiki> | <nowiki>What is **your opinion** on this?</nowiki> | What is **your opinion** on this? |
| italic | <nowiki>//Text//</nowiki> | <nowiki>Rating between //never// and //often//</nowiki> | Rating between //never// and //often// |
| Heading 1 | <nowiki>=== Text ===</nowiki> | <nowiki>=== A. Main Part ===</nowiki> | {{:de:create:scr.texts.example.h1.png}} |
| Heading 2 | <nowiki>== Text ==</nowiki> | <nowiki>== A.1. Definition ==</nowiki> | {{:de:create:scr.texts.example.h2.png}} |
| Dividing line | <nowiki>--</nowiki> | Paragraph\\ <nowiki>--</nowiki>\\ Paragraph | {{:de:create:scr.texts.example.hr.png}}|
| no line break | <nowiki>$$Text$$</nowiki> | <nowiki>No line break at the hyphen: $$e-mail-</nowiki>\\ <nowiki>address$$</nowiki> | No line break at the hyphen:\\ e-mail-address |
| Tooltip | <nowiki>((*|Content))</nowiki> | <nowiki>Wiki ((notation|Notation means a way of writing))</nowiki> |
| Link | <nowiki>[[URL|Title]]</nowiki> | <nowiki>[[https://www.soscisurvey.de/|SoSci Survey]]</nowiki> | [[https://www.soscisurvey.de/|SoSci Survey]] |

A special form of the wiki notation is the definition of text parts "for display in the questionnaire only" by means of double curly brackets. Such text parts are displayed in the questionnaire, but not in the variable labels of your dataset or when retrieved by means of [[:en:create:functions:value|value()]] in combination with the format code ''label''.

^ Description ^ Format Code ^ Example ^ Display in the Questionnaire ^ In the Dataset ^
| Show in the questionnaire only | <nowiki>{{Text}}</nowiki> | <nowiki>Other{{s:}}</nowiki> | Others: | Other |


===== Inserting Links =====

With the wiki code ''%%[[Link|Label]]%%'', you insert a link (hyperlink) into a text. A link usually refers...

  * to a website or
  * to a document (for example, a PDF) that shall be downloaded or opened.

The link can be either

  * a complete internet address (URL), usually starting with ''https://''
  * or the file name of a file that you have uploaded in the survey project.

Only the label is displayed in the text, so ''%%[[https://www.soscisurvey.de|SoSci Survey]]%%'' becomes, for example, [[https://www.soscisurvey.de|SoSci Survey]]. Omit the label (''%%[[Link]]%%'') to have the internet address displayed in the text: ''%%[[https://www.soscisurvey.de]]%%'' is displayed as [[https://www.soscisurvey.de|www.soscisurvey.de]].

{{:de:create:fig.texts.hyperlink-wiki.png?nolink&800|Creating a link by means of wiki notation}}

**Tip:** You type the vertical bar (''|''), called the "pipe" symbol, ...

  * on Windows with a German keyboard layout by means of [Alt Gr] + [<]
  * on MacOS with a German keyboard layout with [alt] + [7] or [option] + [7], or [⌥] + [7], respectively.

An alternative to wiki links are [[texts-html#inserting_links|HTML links]].


==== Example: Privacy Policy ====

You have uploaded a file ''PrivacyPolicy.pdf'' under **Images and Media Files** in your survey project and would like to link this PDF in the welcome text.

**Important:** The text must use the display mode "Simple text". If you use the display mode "HTML code", please take a look at [[texts-html#inserting_links|HTML links]].

Insert the link into the text as follows.

<code wiki>
You will find details in our [[PrivacyPolicy.pdf|privacy policy]].
</code>

**Important:** The file name must be written exactly as the file is named after uploading. Upper and lower case (also in the file name extension ''.pdf'') must be correct as well.