Difference between revisions of "Manual:Extension/BlueSpiceInterWikiLinks"
[unchecked revision] | [quality revision] |
Fbaeckmann (talk | contribs) m (Tag: 2017 source edit) |
m (Tag: Visual edit) |
Contents
-
1 What is BlueSpiceInterwikiLinks?
- 1.1 Where to find Interwikilinks Manager? Interwiki links manager
- 1.2 Overview of all Interwikilinks
- 2 Use Interwikilinks in Articles Using interwiki links on a page
- 3 Special UseCaseuse case: Multilingualismmultilingualism
- 4 See also
What is BlueSpiceInterwikiLinks?[edit | edit source]
BlueSpiceInterWikiLinks simplifies linking to other wikis. Through this extension, abbreviations for different extenal wikis can be created, in order to make linking to other wikis easier, and resulting in a much shorter link. Full URL only needs to be known when defining the InterWikiLink, rather than each time it is used.
Where to find Interwikilinks Manager?. These short codes are then used for linking to pages of the different wikis.
Interwiki links manager[edit | edit source]



Manager for Interwiki links can be found in the admin area of the main navigation, under "Management". The manager can also be accessed through Special:InterWikiLinks
. User is required to have administrative rights in order Interwiki links are managed under Global actions > Management > Interwiki links. This links to the page Special:InterWikiLinks
. A user needs administrative rights to access this page.
Overview of all Interwikilinks[edit | edit source]
Admins can create and delete Interwikilinks on the special page. Existing links can be edited by clicking the "wrench" icon when the link is selected, or deleted by clicking the "X" button.
Syntax The syntax for interwiki links is:
http://URL_OF_THE_WIKI/$1
$1
is the placeholder for the article title of the other wiki.
Use Interwikilinks in ArticlesUsing interwiki links on a page[edit | edit source]
When in edit mode, links to other wikis defined in the list of Interwiki links can be are added just like links to local wiki pages, but with the Interwiki prefix at the begginingbeginning.
An For example:
The URL to the Wikipedia article "Tree house" is:
https://en.wikipedia.org/wiki/Tree_house
If we presume that Interwiki link is inserted Wikipedia is a default entry in the Interwiki link manager as:
prefix: wikipedia, url: https://en.wikipedia.org/wiki/$1
As a result, a link to any wikipedia page can be inserted on the page would be: by using the wikipedia prefix.
[[wikipedia:Tree_house|Wikipedia article about tree houses]]
Special UseCaseuse case: Multilingualismmultilingualism[edit | edit source]
The prerequisite for this is the implementation of multilingualism using the multi-wiki-concept. This means, for every language a separate wiki is used. The corresponding articles in the appropriate language wikis are connected by interwikilinks. With BlueSpice, the If you want to maintain multiple language versions of your wiki on separate wikis, you can use interwiki links to cross-reference related pages.
With BlueSpice, flag symbols are automatically inserted when the interwikilinks interwiki links with language abbreviations are set, which makes it easy to switch between the language wikis.
This is how you use interwikilinks for realizing multilingualism:
Step 1: Create interwikilinks .
Linking the language versions:
- Create interwiki links for the required languages and configure them in the
- Interwiki link manager (see above) of all language sites. The prefix must always be an ISO-3166 country code, e.g. de, en, fr.
- Add
- the interwiki links at the bottom of the related pages to create the language switch. Example: In the English article "Tree", insert the following
- interwiki links:
[[en:{{FULLPAGENAME}}]]
[[de:Baum]]
In the left navigation, the languages available are listed under "In Other Languages". At the top of the wiki, the language flags are shown, with which you can navigate the other wikis.
German wiki and generates the German flag as a switch in the header toolbar:See also[edit | edit source]
Reference page for this extension.
<bs:bookshelf src="Book:User manual" /> __TOC__ ==What is '''BlueSpiceInterwikiLinks'''?== '''BlueSpiceInterWikiLinks''' simplifies linking to other wikis. Through this extension, abbreviations for different extenal wikis can be created, in order to make linking to other wikis easier, and resulting in a much shorter link. Full URL only needs to be known when defining the InterWikiLink, rather than each time it is used. ===Where to find Interwikilinks Manager?===. These short codes are then used for linking to pages of the different wikis. ===Interwiki links manager=== Interwiki links are managed under ''Global actions > Management > Interwiki link''s. This links to the page <code>Special:InterWikiLinks</code>. A user needs administrative rights to access this page. [[File:InterwikiLinks1a.png|thumb|Accessing BlueSpiceInterwikiLinks]] [[File:InterwikiLinks2.png|thumb]] [[File:InterwikiLinks3.png|thumb|Editing a link]] Manager for Interwiki links can be found in the admin area of the main navigation, under "Management". The manager can also be accessed through <code>Special:InterWikiLinks</code>. User is required to have administrative rights in order to access this page. {{Clear}} ===Overview of all Interwikilinks=== Admins can create and delete Interwikilinks on the special page. Existing links can be edited by clicking the "wrench" icon when the link is selected, or deleted by clicking the "X" button. Syntax The syntax for interwiki links is: <code><nowiki>http://URL_OF_THE_WIKI/$1</nowiki></code> <code>$1</code> is the placeholder for the article title of the other wiki. ==Use Interwikilinks in ArticlesUsing interwiki links on a page== When in edit mode, links to other wikis defined in the list of Interwiki links can be are added just like links to local wiki pages, but with the Interwiki prefix at the beggining. Anbeginning. For example: The URL to the Wikipedia article "Tree house" is: <code><nowiki>https://en.wikipedia.org/wiki/Tree_house</nowiki></code> If we presume that Interwiki link is inserted in the manager as: Wikipedia is a default entry in the Interwiki link manager: <code>prefix: wikipedia, url: https://en.wikipedia.org/wiki/$1 link to be inserted on the page would be: </code> As a result, a link to any wikipedia page can be inserted by using the wikipedia prefix. <code><nowiki>[[wikipedia:Tree_house|Wikipedia article about tree houses]]</nowiki></code> ==Special UseCase: Multilingualism== The prerequisite for this is the implementation of multilingualism using the multi-wiki-concept. This means, for every language a separate wiki is used. The corresponding articles in the appropriate language wikis are connected by interwikilinks. With BlueSpice, the use case: multilingualism== If you want to maintain multiple language versions of your wiki on separate wikis, you can use interwiki links to cross-reference related pages. With BlueSpice, flag symbols are automatically inserted when the interwikilinks interwiki links with language abbreviations are set, which makes it easy to switch between the language wikis. This is how you use interwikilinks for realizing multilingualism: ''Step 1:'' Create interwikilinks . '''Linking the language versions''': #Create interwiki links for the required languages and configure them in the Interwikilink manager (see above)''Interwiki link manager'' (see above) of all language sites. The prefix must always be an [https://en.wikipedia.org/wiki/ISO_3166-1 ISO-3166] country code, e.g. de, en, fr. Deposit the corresponding URL of the wiki with the appropriate language. ''Step 2:'' Add interwikilinks in the articles to link them to the corresponding article in the language wikis. Where in the article the interwikilink is located, is not relevant. '''Example:''' In the #Add the interwiki links at the bottom of the related pages to create the language switch. '''Example:''' In the English article "Tree", insert the following interwikilinks: <code><nowiki>[[en:{{FULLPAGENAME}}]]</nowiki></code> <code><nowiki>[[de:Baum]]</nowiki></code> interwiki links: <syntaxhighlight lang="html"> [[en:{{FULLPAGENAME}}]] [[de:Baum]] </syntaxhighlight>The result of setting the first link is, that also the English flag will be shown in the language selection of the page header toolbar. This is not necessary and can also be omitedomitted. The second link connects the articlepage with the related german articlepage "Baum" in the germanGerman wiki. In and generates the left navigation, the languages available are listed under "In Other Languages". At the top of the wiki, the language flags are shown, with which you can navigate the other wikis. German flag as a switch in the header toolbar: [[File:interwikilink-flag.png|alt=Screenshot: Language switch with interwiki links|center|500x500px]] ==See also== [[Reference:InterWikiLinks|Reference page]] for this extension. {{Translation}}
Line 3: | Line 3: | ||
__TOC__ | __TOC__ | ||
− | ==What is | + | ==What is BlueSpiceInterwikiLinks?== |
− | '''BlueSpiceInterWikiLinks''' simplifies linking to other wikis. Through this extension, abbreviations for different extenal wikis can be created | + | '''BlueSpiceInterWikiLinks''' simplifies linking to other wikis. Through this extension, abbreviations for different extenal wikis can be created. These short codes are then used for linking to pages of the different wikis. |
− | === | + | ===Interwiki links manager=== |
+ | Interwiki links are managed under ''Global actions > Management > Interwiki link''s. This links to the page <code>Special:InterWikiLinks</code>. | ||
+ | A user needs administrative rights to access this page. | ||
[[File:InterwikiLinks1a.png|thumb|Accessing BlueSpiceInterwikiLinks]] | [[File:InterwikiLinks1a.png|thumb|Accessing BlueSpiceInterwikiLinks]] | ||
[[File:InterwikiLinks2.png|thumb]] | [[File:InterwikiLinks2.png|thumb]] | ||
[[File:InterwikiLinks3.png|thumb|Editing a link]] | [[File:InterwikiLinks3.png|thumb|Editing a link]] | ||
− | + | ||
− | |||
{{Clear}} | {{Clear}} | ||
===Overview of all Interwikilinks=== | ===Overview of all Interwikilinks=== | ||
− | Admins can create and delete Interwikilinks | + | Admins can create and delete Interwikilinks. |
Existing links can be edited by clicking the "wrench" icon when the link is selected, or deleted by clicking the "X" button. | Existing links can be edited by clicking the "wrench" icon when the link is selected, or deleted by clicking the "X" button. | ||
− | + | The syntax for interwiki links is: | |
<code><nowiki>http://URL_OF_THE_WIKI/$1</nowiki></code> | <code><nowiki>http://URL_OF_THE_WIKI/$1</nowiki></code> | ||
Line 25: | Line 26: | ||
<code>$1</code> is the placeholder for the article title of the other wiki. | <code>$1</code> is the placeholder for the article title of the other wiki. | ||
− | == | + | ==Using interwiki links on a page== |
− | When in edit mode, links to other wikis | + | When in edit mode, links to other wikis are added just like links to local wiki pages, but with the Interwiki prefix at the beginning. |
− | + | For example: | |
− | The URL to Wikipedia article "Tree house" is: | + | The URL to the Wikipedia article "Tree house" is: |
<code><nowiki>https://en.wikipedia.org/wiki/Tree_house</nowiki></code> | <code><nowiki>https://en.wikipedia.org/wiki/Tree_house</nowiki></code> | ||
− | + | Wikipedia is a default entry in the Interwiki link manager: | |
− | prefix: wikipedia, url: https://en.wikipedia.org/wiki/$1 | + | <code>prefix: wikipedia, url: https://en.wikipedia.org/wiki/$1</code> |
− | link to be inserted | + | As a result, a link to any wikipedia page can be inserted by using the wikipedia prefix. |
<code><nowiki>[[wikipedia:Tree_house|Wikipedia article about tree houses]]</nowiki></code> | <code><nowiki>[[wikipedia:Tree_house|Wikipedia article about tree houses]]</nowiki></code> | ||
− | ==Special | + | ==Special use case: multilingualism== |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | If you want to maintain multiple language versions of your wiki on separate wikis, you can use interwiki links to cross-reference related pages. | |
− | + | With BlueSpice, flag symbols are automatically inserted when the interwiki links with language abbreviations are set. | |
− | |||
− | + | '''Linking the language versions''': | |
− | In the | + | #Create interwiki links for the required languages and configure them in the ''Interwiki link manager'' (see above) of all language sites. The prefix must always be an [https://en.wikipedia.org/wiki/ISO_3166-1 ISO-3166] country code, e.g. de, en, fr. |
+ | #Add the interwiki links at the bottom of the related pages to create the language switch. '''Example:''' In the English article "Tree", insert the following interwiki links: | ||
+ | <syntaxhighlight lang="html"> | ||
+ | [[en:{{FULLPAGENAME}}]] | ||
+ | [[de:Baum]] | ||
+ | </syntaxhighlight>The result of setting the first link is that the English flag will be shown in the language selection of the page header toolbar. This is not necessary and can also be omitted. The second link connects the page with the related german page "Baum" in the German wiki and generates the German flag as a switch in the header toolbar: | ||
+ | [[File:interwikilink-flag.png|alt=Screenshot: Language switch with interwiki links|center|500x500px]] | ||
==See also== | ==See also== |