Quelltext der Seite Planungskompendium Energieverteilung:Syntax

'''This page provides details on the syntax to be used in the Electrical Installation Wiki, in particular for elements that are specific to this wiki.'''

Some of the more complex elements are detailed in subpages:
{{Special:PrefixIndex/{{FULLPAGENAME}}/ |hideredirects=1 |stripprefix=1}}

__TOC__

== Fig.xx ==

Use the syntax below to add "Fig.XX" inside the text, when referring to a figure. This ensures to always have the same look&feel (same acronym/text, bolded ...)

=== See Fig.xx ===
Syntax:

<pre>
{{FigRef|<fignum>}}

where <fignum> is the figure number (example: A14)
</pre>
 
result: {{FigRef|A14}}

=== See Figure xx ===
Almost the same syntax:

<pre>
{{FigureRef|<fignum>}}
</pre>
 
result:  {{FigureRef|A14}}

=== Reference to several figures ===
Just add more parameters:
<pre>{{FigRef|A11|A12|A22}}</pre>

result:
{{FigRef|A11|A12|A22}}

== Highlight Boxes ==

These are the "boxes" added in the left column of the book in PDF, to highlight an important point. Below is the syntax for their equivalent in the wiki.

=== syntax ===

<pre style="color:black; font-size:14px;">{{Highlightbox | text=
This is the text for the highlight box
}}</pre>

example:
{{Highlightbox | text=
This is the text for the highlight box
}}

If the text to highlight is short, it is possible to put everything on one line:
<pre style="color:black; font-size:14px;">{{Highlightbox | text=This is the text for the highlight box}}</pre>

It is also possible to skip the "text =" part of the syntax, but this is not recommended as it will not work properly if the text to highlight contains an "=" sign

=== syntax for "local specific" highlight boxes (French wiki) ===

see [[#For local specific Highlightbox]]


== Section TOCs (table of contents) ==

These "section TOCs" can be added in "introductory pages", eg pages with a short text introduction (or not), followed by the contents of this section = the "sub-pages" included in this "section"

syntax:

<pre style="color:black; font-size:14px;">{{Section-TOC}}</pre>

example:  not possible to show an example, it only works in a "real" page inside the wiki content hierarchy


== Images ==

See [[Project:Syntax/Images]]


== Gallery of images ==

See [[Project:Syntax/Galleries]]

== Tables ==

See [[Project:Syntax/Tables]]


== Footnotes ==

Syntax to add a footnote call  (place it just after the last character of the related word, without a space)
 <nowiki>{{fn|<footnote-number>}}</nowiki>
 
 where:
 <footnote-number>  = 1 2 3 4 ...

Syntax to add the Notes at the end of the page:
<pre style="color:black; font-size:14px;">
{{footnotes}}
<references>
{{fn-detail|1|This is text for note 1}}
{{fn-detail|2|This is text for note 2}}
</references>
</pre>

Example:

This is my text with footnote one{{fn|1}}. This is some more text, referencing note two{{fn|2}}

And this is another place referencing nte one{{fn|1}}.

<!--I did not use the actual syntax to avoid adding a paragraph here-->
<big>'''Notes'''</big>
<references>
{{fn-detail|1|This is text for note 1}}
{{fn-detail|2|This is text for note 2}}
</references>


== Math formulas ==

Use the same syntax as previous wikis  (copy / paste formulas). Just see below § "Special characters"

To know more, see  '''[http://en.wikipedia.org/wiki/Help:Displaying_a_formula Help page about Mathematical formulas]'''

=== Multiplication sign ===
In synthesis, the rules to apply for the multiplication sign are:
* for formula written with <code><nowiki><math> ... </math></nowiki></code> syntax:
** use <code>\cdot</code> for formulas with variable names (Ib, ka, ...). Example: <code><nowiki><math>\sqrt 3\cdot U_0</math></nowiki></code> gives <math>\sqrt 3\cdot U_0</math>
** use <code>\times</code> for formulas where you only have figures. Example: <code><nowiki><math>X = 0.08 \times 5</math></nowiki></code> gives <math>X = 0.08 \times 5</math>
* for formula written in normal text:
** use special character (symbol) • for formulas with variable names. Example: I<sub>n</sub> = Σ (Ib • k<sub>s</sub>)
** use standard letter x for formulas where you only have figures. Example: 123 x 8.2

== "textual" formulas ==
see previous § for multiplication sign, and refer to [[#Special characters]] for other characters that can be used for "textual" formulas, such as √, Ω or Δ

=== Characters with special meaning in <code><nowiki><math> ... </math></nowiki></code>formulas===

Important: the following symbols are '''reserved characters''' that either have a special meaning under LaTeX or are not available in all the fonts.<br>If you enter them directly in the text of your <code><nowiki><math> ... </math></nowiki></code> formula, they will normally not render properly, but rather do things you did not intend.

 # $ % ^ & _ { } ~ \

Important in particular is the % sign, which is used in some formulas.

These characters can be entered in a formula, anyway, but you need to add a prefix backslash:

 \# \$ \% \textasciicircum{} \& \_ \{ \} \~{} \textbackslash{}

=== Math formula - other specific cases to take care of (for wiki-to-PDF export, in particular) ===

While exporting the (French) wiki into a PDF, in a few cases a formula that looks OK in the wiki is not rendered properly.

Here are the problematic syntax cases detected, and the recommended solution:
* <code>X^'d</code> : pb is that not only the ' is considered as the exponent, but also all following characters (here would result as X<sup>'d</sup>)
** '''solution''': use the syntax <code>X^{'}d</code>
* <code>65%</code> : % is a special characters, as mentioned in previous paragraphs, and should always be preceded by a \
** '''solution''': use the syntax <code>65\%</code>
* <code>\vartriangle</code> : this works in the wiki but not in export (not found in TeX reference doc also)
** '''solution''': as it is used for a Delta symbol, use the syntax <code>\Delta</code>

=== Vertical alignment of formulas with text ===

For vertical alignment of formulas that are included "inline" with text:
* use a syntax like: <nowiki><math </nowiki>'''style="vertical-align:-70%;"'''...> and play with the value in %
* for more details: '''[https://en.wikipedia.org/wiki/Help:Displaying_a_formula#Alignment_with_normal_text_flow check here]'''

== Local Specific contents (for French wiki) ==

To highlight the contents that are specific to local standards/regulations/habits, use the syntax below

=== Just for a small text ===

 <nowiki>{{Local-specific|this is the local specific text}}</nowiki>

{{Local-specific|this is the local specific text}}

=== For a long specific section ===

NOTE : pages using this syntax can only be modified with wikitext editor (not Visual editor).

 <nowiki>{{Local-specific|start}}</nowiki>
 this is the migrated content wich is french specific ...
 ... use usual syntax for wiki contents ...
 ....
 ....
 <nowiki>{{Local-specific|end}}</nowiki>


{{Local-specific|start}}
this is the migrated content wich is french specific ...<br>
... use usual syntax for wiki contents ...<br>
....<br>
....
{{Local-specific|end}}

=== For local specific Highlightbox ===

<pre style="color:black; font-size:14px;">{{Highlightbox-specific |
This is the text for the french specific highlight box
}}</pre>

example:
{{Highlightbox-specific |
This is the text for the french specific highlight box
}}

=== For a local specific cell in a table ===

<pre>
{{tb-start | id=Tab1001 | num=A1 | title=This is my table title | cols=3}}
{| class="wikitable"
|-
! header
! header
|-
| a normal cell
| {{Local-specific}} | a cell with '''local specific''' content
|}
</pre>


'''Result:'''

{| class="wikitable"
|-
! header
! header
|-
| a normal cell
| {{Local-specific}} | a cell with<br>'''local specific''' content
|}


== Other points ==

=== Warning: template "parameters" with an = sign in it ===

Any time there is an '''=''' sign in the content of a table title, figure title, table note ... passed using one of my templates, (for example '''<nowiki>{{TableEnd ...}}</nowiki>''')<br>
you will need to replace the '''=''' sign by '''<nowiki>{{=}}</nowiki>'''


== Basic Text and paragraph headings ==

{| class="wikitable"
! Description !! You type !! You get
|-
| colspan="3" {{tb-HC1}} | '''Character (inline) formatting – ''applies anywhere'''''
|-
|Italic text
| <code><nowiki>''italic''</nowiki></code>
|''italic''
|-
| Bold text
| <code><nowiki>'''bold'''</nowiki></code>
|'''bold'''
|-
| Bold and italic
| <code><nowiki>'''''bold & italic'''''</nowiki></code>
|'''''bold & italic'''''
|-
|Escape wiki markup
| <code><nowiki><nowiki>no ''markup''&lt;/nowiki></nowiki></code>
|<nowiki>no ''markup''</nowiki>
|-
| colspan="3" {{tb-HC1}} | '''Section formatting – ''only at the beginning of the line'''''
|-
|Headings of different levels 
| <pre>=level 1=
==level 2==
===level 3===
====level 4====
=====level 5=====
======level 6======</pre>
An article with 4 or more headings automatically creates a [[wikipedia:Wikipedia:Section#Table of contents (TOC)|table of contents]].

|<!-- hack to prevent TOC viewing for h1 - h6 elements: their style is hardcopied here -->
<div style="font-size: 188%; margin: 0; padding-top: .5em; padding-bottom: .17em; border-bottom: 1px solid #aaa">Level 1</div>
<div style="font-size: 150%; margin: 0; padding-top: .5em; padding-bottom: .17em; border-bottom: 1px solid #aaa">Level 2</div>
<div style="font-size: 132%; font-weight: bold">Level 3</div><!--
--><b>Level 4</b><!--
--><div style="font-size: 86%; font-weight: bold">Level 5</div><!--
--><b style="font-size: 80%">Level 6</b>
|-
|Horizontal rule
| <code>----</code>
|
----
|-
|Bullet list
|
<pre>
* one
* two
* three
** three point one
** three point two
</pre>
Inserting a blank line will end the first list and start another.
|
* one
* two
* three
** three point one
** three point two
|-
| indent text
|
<pre>: Single indent
:: Double indent
::::: Multiple indent</pre>
This workaround may be controversial from the viewpoint of accessibility.
|
: Single indent
:: Double indent
::::: Multiple indent
|}

=== Paragraphs ===

MediaWiki ignores single line breaks. To start a new paragraph, leave an empty line. You can force a line break within a paragraph with the HTML tags <code>&lt;br /></code>.


=== Titles, sub-titles ... ===

The wiki page title (defined when creating a page) is using the first title level (h1)

So when the book content to migrate includes "paragraphs", "sub-paragraphs" ... their titles should use wiki syntax for level 2 (== title ==), level 3 (=== sub-paragraph ===) etc


=== bullet lists - with content longer than just one sentence ===

{| class="wikitable"
|-
|Bullet list
|
<pre>
* one
* two
** two point one
** two point two
* three
: continued
:* three point one (:* syntax rather than **)
* four
: text paragraph inside bullet four
: several continued sentences is possible
: can also be used for an image that is part of bullet point
:[[File:Blogs icon.png|none]]
:* four point one (:* syntax rather than **)
</pre>
Inserting a blank line will end the first list and start another.

nota: there is a small bug with wiki CSS, so inside tables following text does not have proper font size  ==>  not a problem as should never happen in tables
|
* one
* two
** two point one
** two point two
* three
: continued
:* three point one (:* syntax rather than **)
* four
: text paragraph inside bullet four
: several continued sentences is possible
: can also be used for an image that is part of bullet point
:[[File:Blogs icon.png|none]]
:* four point one (:* syntax rather than **)
|}

'''It is not recommended to have more than 2 nested levels of bullet lists'''.

If there are more than 2 bullet list levels (maybe sometimes also for 2 levels), it is recommended to change the first level of bullet list to a sub-paragraph level

== Special characters ==

=== less/greater than or equal ===
* Replace the GraphSch character used in the book by standard existing characters: &le; and &ge;
* You can just paste it in a wiki page (you can copy it from here), or when editing you can use the codes <code>&amp;le;</code> and <code>&amp;ge;</code> giving same results &le; and &ge;

=== star and delta symbols ===
* for star I migrated the source from figB20.ai, insert it using <code><nowiki>[[File:star_symbol.svg]]</nowiki></code> which gives this result: [[File:star_symbol.svg]]
* for delta you can paste directly this character: Δ or use the code <code>&amp;Delta;</code> which gives the same result: &Delta;

=== ohm symbol ===
* Ω
* html code : <code>&amp;#8486;</code> giving same result &#8486;

=== square root symbol ===
* √
* html code: <code>&amp;#8730;</code> giving same result &#8730;