Difference between revisions of "Manual:Extension/BlueSpiceInterWikiLinks"

[quality revision][quality revision]
m
(Changed categories.)
 


Contents

  • 1 What are interwiki links?
  • 2

    Interwiki links

    manager
  • 3 Interwiki link syntax
  • 4 Using interwiki links on a page
  • 5 Special use case: multilingualism
  • 6 Related info
  • What

    are

    interwiki links?[edit | edit source]

    Interwiki links are shortcodes for linking to other wikis. The extension BlueSpiceInterWikiLinks InterWikiLinks allows creating abbreviations for various external wikis. The full URL nonly only needs to be known if when the interwiki link is defined and not every time it is used.

    Interwiki links manager[edit | edit source]

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


    Interwiki links manager
    Interwiki links manager


    This links to the page Special:InterWikiLinks. 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 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:

    http://URL_OF_THE_WIKI/$1

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


    Editing an interwiki link
    Editing an interwiki link

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

    When in 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:

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

    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]]

    Special use case: multilingualism[edit | edit source]

    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:

    1. 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.
    2. 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]]
    
                    
    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:
    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

    {{DISPLAYTITLE:Interwiki links}}
            __TOC__
                
    
                ==What are interwiki links?==
                
                Interwiki links are shortcodes for linking to other wikis. The extension '''BlueSpiceInterWikiLinksInterWikiLinks''' allows creating abbreviations for various external wikis. The full URL nonlyonly needs to be known ifwhen the interwiki link is defined and not every time it is used.
            
    
            ==Interwiki links manager==
            
            Interwiki links are managed under ''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]]
            This links to the page ''Special:InterWikiLinks''. 
                
    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 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.
                <br />[[File:InterwikiLinks3.png|Editing a an interwiki link|link=https://en.wiki.bluespice.com/wiki/File:InterwikiLinks3.png|center|650x650px|alt=Editing an interwiki link|thumb]]
            
            ==Using interwiki links on a page==
            
    When in 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>
            
            ==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|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 <code>''Special:WithoutInterwiki</code>''.
            
    
            {{Box Links-en
            
            |Topic1=[[Reference:InterWikiLinks]]
            
            }}
            
    
            {{Translation}}
                
    
                [[Category:Organization]]
    (3 intermediate revisions by the same user not shown)
    Line 1: Line 1:
     
    {{DISPLAYTITLE:Interwiki links}}
     
    {{DISPLAYTITLE:Interwiki links}}
    __TOC__
     
      
    ==What are interwiki links?==
    +
    Interwiki links are shortcodes for linking to other wikis. The extension '''InterWikiLinks''' allows creating abbreviations for various external wikis. The full URL only needs to be known when the interwiki link is defined and not every time it is used.
    Interwiki links are shortcodes for linking to other wikis. The extension '''BlueSpiceInterWikiLinks''' allows creating abbreviations for various external wikis. The full URL nonly needs to be known if the interwiki link is defined and not every time it is used.
     
      
     
    ==Interwiki links manager==
     
    ==Interwiki links manager==
    Interwiki links are managed under ''Global actions > Management > Interwiki link''s.
    +
    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]]
     
    [[File:Manual:verwaltung-interwikilinksEN.png|alt=Interwiki links manager|center|thumb|450x450px|Interwiki links manager]]
    This links to the page ''Special:InterWikiLinks''. While all users with edit permissions can see this page, a user needs administrative rights  to edit the interwiki links:
    +
     
     +
     
     +
    While all users with edit permissions can see this page, a user needs administrative rights  to edit the interwiki links:
     
    ==Interwiki link syntax==
     
    ==Interwiki link syntax==
      
    Admins can create and delete Interwikilinks with the Interwiki links manager..
    +
    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.
    +
    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:
     
    The syntax for interwiki links is:
    Line 18: Line 20:
     
    <code><nowiki>http://URL_OF_THE_WIKI/$1</nowiki></code>
     
    <code><nowiki>http://URL_OF_THE_WIKI/$1</nowiki></code>
      
    <code>$1</code> is the placeholder for the article title of the other wiki.[[File:InterwikiLinks3.png|Editing a link|link=https://en.wiki.bluespice.com/wiki/File:InterwikiLinks3.png|center|650x650px]]
    +
    <code>$1</code> is the placeholder for the article title of the other wiki.
     +
    <br />[[File:InterwikiLinks3.png|Editing an interwiki link|link=https://en.wiki.bluespice.com/wiki/File:InterwikiLinks3.png|center|650x650px|alt=Editing an interwiki link|thumb]]
     
    ==Using interwiki links on a page==
     
    ==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.
    +
    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:
     
    For example:
    Line 51: Line 54:
     
    [[de:Baum]]
     
    [[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:
     
    </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]]To view a list of all pages on a wiki that don't have interwiki links, an administator can review the page <code>Special:WithoutInterwiki</code>.
    +
    [[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
     
    {{Box Links-en
    Line 59: Line 62:
      
     
    {{Translation}}
     
    {{Translation}}
     +
     +
    [[Category:Organization]]

    Attachments

    Discussions