Difference between revisions of "Manual:Extension/BlueSpiceInsertLink"

[unchecked revision][quality revision]
(Created page with "==About Wiki Links== Linking pages is one of the most important features of browser-based knowledge documentation. The links often differ in their function. Links to Wikiseite...")
 
 


About Wiki Links

How do I create links?[edit | edit source]

Linking pages is one of the most important features an important feature of browser-based knowledge documentation. The links often differ in their function. Links to Wikiseiten connect wiki pages with:

  • other wiki pages
  • external websites
  • to files (images, PDF files, Word documents,...)
  • to files stored on other drives
How do I create links?[edit | edit source]


Links can be easily inserted via the function "Insert link" from VisualEditor or with Use the Insert link menu item in VisualEditor or use the shortcut Ctrl+K. In both cases, the corresponding a dialog box opens: .

Insert link to a wiki page
Insert link to a wiki page

Link to a wiki page[edit | edit source]

Internal links link connect related pages or other content that provides more information. Page names can exist multiple times in different namespaces. Therefore, under "Search pages", enter the namespace as if the destination page is not in the same namespace as the current page.

If you have selected some text on the page, you will find some page suggestions are already listed in the "Search pages" tab. Here, you can adjust the search term accordingly or create a link to a new page.

Then click on "done" Done.


In the source text, the links are created with the following structure:

  • Link to a wiki page: [[landing page name|caption]]
  • Link to a wiki page in another namespace: [[namespace:landing page name|caption]]
  • Link to a category page: [[:Category:category name|caption]] To create a link to a category, the source code is preceded by a colon set before the category name. For exampleIn contrast, the link "Category: BlueSpice" would create a category called BlueSpice instead of linking to the category BlueSpice.
  • Interwiki Linklink: [[Imdb:tt2709692]]If your wiki links to other wikis, you can use the "Pages" also tab Search pages also to directly link to a page in a related wiki. For example, if your administrator maintains an interwikilink interwiki link for the IMDb movie database, it can be typed in as in the example above. Ask your administrator which interwikilinks are createdinterwiki links are available in your wiki.

Link to an external website[edit | edit source]

To link to an external website, mark text on your page, e.g. the word "Wikipedia". Press Ctrl+K and switch to the tab "External link". There you enter the web address. Then click on "done": External link.png Insert.

External link.png

Note: To easily maintain external links on your wiki, use the page Special:LinkSearch. This page allows you to search for external links in your entire wiki. The page also contains a link to the associated Mediawiki help page.


Link to a file in the wiki[edit | edit source]

To link a file (for example, a picture or a PDF file) in the current page, go to the "Link to File" tab. There, you can search for a file or upload a new file: .

Insert link to a file
Insert link to a file
  • Search for a file in the wiki and include it as a link: Enter the file name and select the desired file. Then click on "Paste". A link to the file has been added to the page. You can then change the displayed link text.
  • Upload file or integrate via the media manager: Click "Pick file" if you want to create the link via the media manager. This has the advantage that you can upload a file first if it does not already exist on the wiki. In addition, you have more options to determine the type of link: Do you want to create a text link or a preview image of the file? For instructions on how to insert a file using the Media Manager, see VisualEditor: Uploading and Pasting Files.
  • Link file to a network drive: If you want to connect to a file on your company network, enter the path under "Link to file" in the text field and activate "Network share path (URI)". The file path is entered using the following syntax - [[:file:///Z:/myfolder/vacatio]]:
    Linkk.png
Technical Details
  • . this only works if your wiki has been configured to work with network files. This function also depends on your individual browser security settings.

    Link to a network file
    Link to a network file

Link to a file in the local network[edit | edit source]

The Insert Link function is based on the BlueSpice extension BlueSpiceInsertLink.

If you want to link to a file on your company network, you can also use the Link to file tab.

Important! Links to network drives (UNC links) pose a security risk. Therefore, current browsers block these links by default.


It is also possible that your wiki has been configured to disable links to network files.


Talk to your IT department if you have any questions about guidelines related to your browser. If your IT department does not offer a solution, files linked in the wiki can still be copied by wiki users and pasted into the address bar of Windows Explorer.


For more info about UNC-Links, see: https://www.mediawiki.org/wiki/UNC_links.


Insert a link to a local network file:

Insert local file link
Insert local file link
  1. Click Insert link in the visual editor.
  2. Click on the tab Link to file.
  3. Activate the switch Netzwerkpfad (URI). In the file search field (4) you now see the link symbol.
  4. Enter the path to your file. You can get this path by right-clicking on the file properties in Windows Explorer. From the tab Security you can copy the object name and paste it into the wiki accordingly.
    File properties
    File properties

  5. Click Insert. The link is automatically added in the correct format (file://S:/7_Benutzer/....). Whether the link can be directly followed through the browser, depends on your browser security settings and installed add-ons. Talk to your IT department to get help if the links are not active.

Related info


Attachments

Discussions