Difference between revisions of "Help:Editing/Advanced"

From IntactiWiki
Jump to navigation Jump to search
m (WikiAdmin moved page Editing/Advanced to Help:Editing/Advanced: This is an internal article from the IntactiWiki manual and shouldn't be present in the Main space.)
m (adjusted external links)
 
(10 intermediate revisions by the same user not shown)
Line 3: Line 3:
 
So this is the advanced section of the IntactiWiki manual. Here you will learn how to do things that are beyond the scope of a beginner. You'll find various advanced Wiki markup tricks listed into categories below. This subpage will probably never be complete.
 
So this is the advanced section of the IntactiWiki manual. Here you will learn how to do things that are beyond the scope of a beginner. You'll find various advanced Wiki markup tricks listed into categories below. This subpage will probably never be complete.
  
== Helpful templates ==
+
== Templates ==
There are many templates available already which really help keeping the general article structure in shape. Templates are always used by writing the template name (without the prefix '''Template:''') in double curly brackets.
+
There are many helpful templates available already which really help keeping the general article structure in shape. Templates are always used by writing the template name (without the prefix '''Template:''') in double curly brackets.
 +
 
 +
'''''Example:'''''
 +
<pre>{{Incomplete}}</pre>
 +
'''''Result:'''''
 +
{{Incomplete}}
  
 
=== Templates for section headlines ===
 
=== Templates for section headlines ===
Line 16: Line 21:
 
== References ==
 
== References ==
 
<references/>        ->  use {{REF}} instead.</pre>
 
<references/>        ->  use {{REF}} instead.</pre>
 +
 +
We use templates even for rather simple content like the ones shown above, because we see in the Wikipedia that there are many different ways of using these default headlines (like "Also see" instead of "See also", "Weblinks" instead of "External links"). Using templates, you can change them all at once by just changing the template content.
  
 
=== Templates for references and quotations ===
 
=== Templates for references and quotations ===
 
These are explained in the IntactiWiki manual chapter [[Editing/References|References]].
 
These are explained in the IntactiWiki manual chapter [[Editing/References|References]].
 +
 +
=== Templates overview ===
 +
In the page [[Special:AllPages]], you can list all available templates by chosing the Template namespace. [http://en.intactiwiki.org/index.php/Special:AllPages?from=&to=&namespace=10 Or simply click here.]
 +
 +
=== Template development ===
 +
If you think you're missing a template, you might try and create one on your own, if you are familiar with the MediaWiki language and understand how templates work. If so, please check whether your desired template already exists or if you could use a similar one for your needs. If you believe your skills aren't sufficient for developing IntactiWiki templates, please don't hesitate to ask [[User_talk:WikiAdmin]] for a new template. He'll advise you how to do or create one for you.
  
 
== Localization ==
 
== Localization ==
IntactiWiki supports various localized instances. Currently, Danish, German, English, Farsi, French, Hebrew, Swahili language, and Turkish are available. You will basically see the links to the other IntactiWiki instances on the Main page of each IntactiWiki:
+
IntactiWiki supports various localized instances. Currently, the following languages are available. You will basically see the links to the other IntactiWiki instances on the Main page of each IntactiWiki:
  
* [http://da.intactiwiki.org Dansk]
+
{| class="wikitable sortable"
* [http://de.intactiwiki.org Deutsch]
+
|-
* [http://fa.intactiwiki.org فارسی]
+
! ISO code !! English name !! Localized name
* [http://fr.intactiwiki.org Français]
+
|-
* [http://he.intactiwiki.org עברית]
+
| ar || Arabic || [https://ar.intactiwiki.org العربية]
* [http://sw.intactiwiki.org Kiswahili]
+
|-
* [http://tr.intactiwiki.org Türkçe]
+
| da || Danish || [https://da.intactiwiki.org Dansk]
 +
|-
 +
| de || German || [https://de.intactiwiki.org Deutsch]
 +
|-
 +
| en || English|| [https://en.intactiwiki.org English]
 +
|-
 +
| es || Spanish || [https://es.intactiwiki.org Español]
 +
|-
 +
| fa || Farsi || [https://fa.intactiwiki.org فارسی]
 +
|-
 +
| fi || Finnish || [https://fi.intactiwiki.org Suomi]
 +
|-
 +
| fr || French || [https://fr.intactiwiki.org Français]
 +
|-
 +
| he || Hebrew || [https://he.intactiwiki.org עברית]
 +
|-
 +
| is || Icelandic || [https://is.intactiwiki.org Íslenska]
 +
|-
 +
| nl || Dutch || [https://nl.intactiwiki.org Nederlands]
 +
|-
 +
| sv || Swedish || [https://sv.intactiwiki.org Svenska]
 +
|-
 +
| sw || Swahili language || [https://sw.intactiwiki.org Kiswahili]
 +
|-
 +
| tr|| Turkish|| [https://tr.intactiwiki.org Türkçe]
 +
|}
  
 
If you have created an article on the English IntactiWiki, you may want to (have someone) do a German translation, too. Therefore, you should add an ''Interlanguage''<ref>https://en.wikipedia.org/wiki/Help:Interlanguage_links</ref> link at the very bottom of your article, which starts with the two-characters language code of the other IntactiWiki. An example:
 
If you have created an article on the English IntactiWiki, you may want to (have someone) do a German translation, too. Therefore, you should add an ''Interlanguage''<ref>https://en.wikipedia.org/wiki/Help:Interlanguage_links</ref> link at the very bottom of your article, which starts with the two-characters language code of the other IntactiWiki. An example:
Line 36: Line 74:
  
 
This will create an interlanguage link on the navigation bar (on the left in left-to-right languages) in the "In other languages" section.
 
This will create an interlanguage link on the navigation bar (on the left in left-to-right languages) in the "In other languages" section.
 +
 +
If you are sure the page title won't be localized in other languages (like proper names), you may also use
 +
<pre>[[de:{{FULLPAGENAME}}]]</pre>
 +
which then creates an interlanguage link with the identical page title. So you can just exchange the 2-characters language code if you need more interlanguage links.
  
 
== Highlighting ==
 
== Highlighting ==
If you ever want to <span style="background:#FFE87C">highlight</span> text (which basically should be avoided), use the following:
+
If you ever want to {{Highlighting|highlight}} text (which basically should be avoided), use the following template:
<pre><span style="background:#FFE87C">highlighted text here</span></pre>
+
<pre>{{Highlighting|highlighted text here}}</pre>
 +
 
 +
== Tooltips ==
 +
Thanks to the extension [https://www.mediawiki.org/wiki/Extension:SimpleTooltip SimpleTooltip], you can use tooltips for simple clarification of e.g. abbreviations and acronyms in articles.
 +
=== Examples ===
 +
'''Simple tooltip:''' <pre>{{#tip-text:RCT|Randomized controlled trial}}</pre>
 +
{{#tip-text:RCT|Randomized controlled trial}}<br>
 +
 
 +
'''Tip info:''' <pre>{{#tip-info:I am an important information.}}</pre>
 +
{{#tip-info:I am an important information.}}
 +
 
 +
== Graphic content ==
 +
Chances are that an IntactiWiki article refers to genitals or sexuality and uses pictures for this. If such articles are linked on social media (such as Facebook), this can lead to the person being blocked there because they have allegedly published pornographic material or violated the rule "no representation of naked genitals". In order to prevent this, the IntactiWiki has to tell Facebook which of multiple images on an article page should be picked as the default image (aka main image) for the Facebook preview.
 +
 
 +
This is done by using the '''<nowiki>{{GraphicWarning}}</nowiki>''' template. Place it in the first line of your article. It will show an appropriate warning image then which is defined as the default image using the HTML meta tag '''og:image'''. Here is how the currently used image looks like:
 +
 
 +
{{GraphicWarning}}
  
 
== Other ==
 
== Other ==

Latest revision as of 18:02, 9 November 2022

Writing and editing IntactiWiki articles can become an addiction. There is so much one can enhance, add and change. Because the IntactiWiki uses the same engine that is used by the Wikipedia (called: MediaWiki), the techniques are identical. In the MediaWiki, you will find each and everything you might probably want to know about writing and editing Wiki articles. But there's also a big overload of information there.

So this is the advanced section of the IntactiWiki manual. Here you will learn how to do things that are beyond the scope of a beginner. You'll find various advanced Wiki markup tricks listed into categories below. This subpage will probably never be complete.

Templates

There are many helpful templates available already which really help keeping the general article structure in shape. Templates are always used by writing the template name (without the prefix Template:) in double curly brackets.

Example:

{{Incomplete}}

Result:

Work in progress: The following information does not claim to be complete. More content will be added gradually.

Templates for section headlines

Some of these e.g. format frequently used section headlines, like:

== Publications ==    ->  use {{PUB}} instead.

== See also ==        ->  use {{SEEALSO}} instead.

== External links ==  ->  use {{LINKS}} instead.

== References ==
<references/>         ->  use {{REF}} instead.

We use templates even for rather simple content like the ones shown above, because we see in the Wikipedia that there are many different ways of using these default headlines (like "Also see" instead of "See also", "Weblinks" instead of "External links"). Using templates, you can change them all at once by just changing the template content.

Templates for references and quotations

These are explained in the IntactiWiki manual chapter References.

Templates overview

In the page Special:AllPages, you can list all available templates by chosing the Template namespace. Or simply click here.

Template development

If you think you're missing a template, you might try and create one on your own, if you are familiar with the MediaWiki language and understand how templates work. If so, please check whether your desired template already exists or if you could use a similar one for your needs. If you believe your skills aren't sufficient for developing IntactiWiki templates, please don't hesitate to ask User_talk:WikiAdmin for a new template. He'll advise you how to do or create one for you.

Localization

IntactiWiki supports various localized instances. Currently, the following languages are available. You will basically see the links to the other IntactiWiki instances on the Main page of each IntactiWiki:

ISO code English name Localized name
ar Arabic العربية
da Danish Dansk
de German Deutsch
en English English
es Spanish Español
fa Farsi فارسی
fi Finnish Suomi
fr French Français
he Hebrew עברית
is Icelandic Íslenska
nl Dutch Nederlands
sv Swedish Svenska
sw Swahili language Kiswahili
tr Turkish Türkçe

If you have created an article on the English IntactiWiki, you may want to (have someone) do a German translation, too. Therefore, you should add an Interlanguage[1] link at the very bottom of your article, which starts with the two-characters language code of the other IntactiWiki. An example:

[[de:Bearbeiten/Fortgeschritten]]

This will create an interlanguage link on the navigation bar (on the left in left-to-right languages) in the "In other languages" section.

If you are sure the page title won't be localized in other languages (like proper names), you may also use

[[de:{{FULLPAGENAME}}]]

which then creates an interlanguage link with the identical page title. So you can just exchange the 2-characters language code if you need more interlanguage links.

Highlighting

If you ever want to highlight text (which basically should be avoided), use the following template:

{{Highlighting|highlighted text here}}

Tooltips

Thanks to the extension SimpleTooltip, you can use tooltips for simple clarification of e.g. abbreviations and acronyms in articles.

Examples

Simple tooltip:

{{#tip-text:RCT|Randomized controlled trial}}

RCT

Tip info:

{{#tip-info:I am an important information.}}

Graphic content

Chances are that an IntactiWiki article refers to genitals or sexuality and uses pictures for this. If such articles are linked on social media (such as Facebook), this can lead to the person being blocked there because they have allegedly published pornographic material or violated the rule "no representation of naked genitals". In order to prevent this, the IntactiWiki has to tell Facebook which of multiple images on an article page should be picked as the default image (aka main image) for the Facebook preview.

This is done by using the {{GraphicWarning}} template. Place it in the first line of your article. It will show an appropriate warning image then which is defined as the default image using the HTML meta tag og:image. Here is how the currently used image looks like:

IntactiWikiGraphicWarning.png


Other

More to come soon ...

See also

References