Difference between revisions of "Manual:Extension/BlueSpiceInterWikiLinks"

<bs:bookshelf src="Book:User manual" />
        
        
        
        __TOC__
        
        
        
        ==What is InterWikiLinks?==
        
        
        
        '''InterWikiLinks''' simplifies 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 only needs to be known when defining the InterWikiLink, rather than each time it is used.
        
        
        
        ==Create and Manage Interwikilinks==
        
        
        
        ===Where to Find Interwikilinks Manager===
        
        
        
        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 <code>Special:SpecialPages</code> (also linked in the admin area). Look for Interwikilinks in the "BlueSpice" section. Or you can call the corresponding special page directly via <code>Special:InterWikiLinks</code>.<br /><br />Prerequisites for all these accesses are administrative rights for the wiki.
        
        
        
        ===Overview of all Interwikilinks===
        
        
        
        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===
        
        
        
        The prefixes and associated URLs of individual wikis can be edited via the tool icon on the right side.<br /><br />The syntax for the URL 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.
        
        
        
        
        <gallery mode="packed">
        
        File:Interwikilinks_Navigation.png|Interwikilinks in main navigation
        
        File:Interwikilinks_Manager.png|Interwikilinks Manager
        
        File:BlueSpice2-InterWikiLinks-Link_bearbeiten-en.png|Edit an Interwikilink
        
        
        </gallery>
        
        
        
        ==Use Interwikilinks in Articles==
        
        
        
        In both the [[VisualEditor|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: [[File:Btn-WYSIWYG-InsertLink.png]] 
        
        
        
        
        
        [[File:BlueSpice2-InsertLink-Link_in_anderes_Wiki-en.png|thumb|center|500x156px|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 example:
        
        
        
        The URL to Wikipedia article "Tree house"
        
        
        
        
        <code><nowiki>https://en.wikipedia.org/wiki/Tree_house</nowiki></code>
        
        
        
        will be inserted as
        
        
        
        
        <code><nowiki>[[wikipedia:Tree_house|Wikipedia article about tree houses]]</nowiki></code>
        
        
        
        with interwikilinks.
        
        
        
        ==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 flag symbols are automatically inserted when the interwikilinks 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 for the required languages ​​and configure them in the Interwikilink manager (see above). 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 article "Tree", insert the following interwikilinks:
        
        
        
        
        <code><nowiki>[[en:{{FULLPAGENAME}}]]</nowiki></code>
        
        
        
        
        <code><nowiki>[[de:Baum]]</nowiki></code>
        
        
        
        The result of setting the first link is, that also the English flag will be shown in the language selection. This is not necessary and can also be omited. The second link connects the article with the related german article "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.
        
        
        
        [[File:Interwikilinks_Flags.png|center]]
        
        
        
        {{Box_Links-en
        
        | Thema1 = [[InsertLink|Inserting links]]
        
        | Thema2 = [[WikiFarming|WikiFarming]]
        
        | Thema3 = [[Navigation|Multilanguage Navigation]]
        
        | Thema4 =
        
        }}
        
        
        
        ==See also==
        
        
        
        Our [[InterWikiLinks|reference page.]]