Difference between revisions of "Manual:Extension/BlueSpiceInterWikiLinks"

<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. 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]]
        
        
        
        ===Interwiki link syntax===
        
        
        
        Admins can create and delete Interwikilinks with 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 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.
        
        
        
        ==Using interwiki links on a page==
        
        
        
        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 the Wikipedia article "Tree house" is:
        
        
        
        
        <code><nowiki>https://en.wikipedia.org/wiki/Tree_house</nowiki></code>
        
        
        
        Wikipedia is a default entry in the  Interwiki link manager:
        
        
        
        
        <code>prefix: wikipedia, url: https://en.wikipedia.org/wiki/$1</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>
        
        
        {{clear}}
        
        ==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''':
        
        
        
        #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==
        
        
        
        [[Reference:InterWikiLinks|Reference page]] for this extension.
        
        
        
        {{Translation}}