Difference between revisions of "Manual:Extension/BlueSpiceInterWikiLinks"

[unchecked revision][quality revision]
(Tag: 2017 source edit)
 


What is InterWikiLinks?[edit | edit source]

InterWikiLinks simplifies Interwiki links are shortcodes for linking to other wikis. An InterWikiLink is an abbreviation, which stands for the beginning of an internet address (better: URL). This makes links much shorter. The actual address The extension InterWikiLinks allows creating abbreviations for various external wikis. The full URL only needs to be known when defining the InterWikiLink, rather than each the interwiki link is defined and not every time it is used.

Create and Manage Interwikilinks[edit | edit source]

Where to Find Interwikilinks Manager

Interwiki links manager[edit | edit source]

There is an extra manager for Interwikilinks in the admin area of the main navigation. In the list, under "Administration", you will find the Interwikilinks list point, which will lead you directly to the Interwikilinks manager.

Alternatively, you can also find a link in the list of all special pages Special:SpecialPages (also linked in the admin area). Look for Interwikilinks in the "BlueSpice" section. Or you can call the corresponding special page directly via Special:InterWikiLinks.
Prerequisites for all these accesses are administrative rights for the wiki. Overview of all Interwikilinks

Interwiki links are managed from the page Special:InterwikiLinks. It can be loaded from the navigation item Global actions > Management > Interwiki links.


Interwiki links manager
Interwiki links manager


While all users with edit permissions can see this page, a user needs administrative rights to edit the interwiki links:

Interwiki link syntax[edit | edit source]

Admins can create and delete new Interwikilinks at the special page. The links are sorted alphabetically ascending by prefix (link name) in the table. The abbreviations (prefix) and the corresponding links can be edited via the tool symbol. Any number of links can be generated. The manager shows 25 links per page. Use the arrows to navigate to further pages.

Edit Interwikilinks[edit | edit source]

The prefixes and associated URLs of individual wikis can be edited via the tool icon on the right sidewith the Interwiki links manager. 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 the URL interwiki links is:

http://URL_OF_THE_WIKI/$1

$1 is the placeholder for the article title of the other wiki.


Use Interwikilinks in Articles
Editing an interwiki link
l

Using interwiki links on a page[edit | edit source]

In both the visual editor and the WikiCode, you can open the dialog for inserting links (see also: InsertLink). To do this, click on this button in the menu: Btn-WYSIWYG-InsertLink.png 

Insert an InterWiki link with InsertLink

Here you need to switch to the tab "Link to another Wiki". There the prefix, which stands for the URL of the other wiki, can be selected. Now you only have to specify the page name, according to the article in the other Wiki. You can also enter a description, which is then displayed as a link in the article.

An 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 the Wikipedia article "Tree house" is:

https://en.wikipedia.org/wiki/Tree_house

will be inserted as Wikipedia is a default entry in the Interwiki link manager:

prefix: wikipedia, url: https://en.wikipedia.org/wiki/$1

As a result, a link to any wikipedia page can be inserted by using the wikipedia prefix.

[[wikipedia:Tree_house|Wikipedia article about tree houses]]

with interwikilinks.

Special UseCase: MultilingualismSpecial use case: multilingualism[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:

  1. Create interwiki links for the required languages ​​and configure them in the
Interwikilink
  1. Interwiki link manager (see above) of all language sites. The prefix must always be an ISO-3166 country code, e.g. de, en, fr.
Deposit the corresponding URL of the wiki with the appropriate language.
Step 2:
  1. 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
  1. 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
  1. interwiki links:
                    [[en:{{FULLPAGENAME}}]]
                
                      
[[de:Baum]]

                
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 article page with the related german article page "Baum" in the german wiki.

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. From three languages, a drop-down menu is provided to select the language.

Interwikilinks Flags.png

See also[edit | edit source]

Our reference page.

German wiki and generates the German flag as a switch in the header toolbar:
Language switch with interwiki links
To view a list of all pages on a wiki that don't have interwiki links, an administator can review the page Special:WithoutInterwiki.

Related info


Attachments

Discussions