Difference between revisions of "Manual:Extension/BlueSpiceInterWikiLinks"

<bs:bookshelf src="Book:User manual" />
            
            
            
            __TOC__
            
            
            
            ==What is InterWikiLinks?==
            
            
            
            '''InterWikiLinks''' simplifies {{DISPLAYTITLE:Interwiki links}}
            
            
            
            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 addressThe extension '''InterWikiLinks''' allows creating abbreviations for various external wikis. The full URL only needs to be known when defining the InterWikiLink, rather than each interwiki link is defined and not every 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===Interwiki links manager==
            
            Interwiki links are managed from the page ''Special:InterwikiLinks''. It can be loaded from the navigation item ''Global actions > Management > Interwiki link''s.
            
            
            
            
            <br />
            
            [[File:Manual:verwaltung-interwikilinksEN.png|alt=Interwiki links manager|center|thumb|450x450px|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==
        
        
        
        Admins can create and delete new Interwikilinks atwith 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 URLInterwiki 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.
        
        
        
            
            
            <gallery mode="packed">
            
            
        <br />[[File:Interwikilinks_NavigationInterwikiLinks3.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
            
            
            
            
        Editing an interwiki link|l|center|650x650px|alt=Editing an interwiki link|thumb]]
            
            ==Using interwiki links on a page==
            
            
            
            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>
        
        
        
            
            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 ==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 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. 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.German flag as a switch in the header toolbar:
            
            [[File:interwikilink-flag.png|alt=Language switch with interwiki links|center|500x500px|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''.
            
            
            
            {{Box Links-en
            
            |Topic1=[[Reference:InterWikiLinks]]
            
            }}
            
            
            
            
            
            {{Translation}}
            
            
            
            [[Category:Organization]]