Manual:Extension/BlueSpiceInsertLink and Manual:Displaying page sections as cards: Difference between pages

(Difference between pages)
No edit summary
Tag: 2017 source edit
 
(Created page with "{{Featurepage|featured=true|featuredesc=Seitenabschnitte als Karten (Spalten) formatieren|featurestart=03/21/2022}}Abschnitte einer Wikiseite können mit etwas Geschick leicht...")
Tag: 2017 source edit
 
Line 1: Line 1:
{{DISPLAYTITLE:Insert links}}
{{Featurepage|featured=true|featuredesc=Seitenabschnitte als Karten (Spalten) formatieren|featurestart=03/21/2022}}Abschnitte einer Wikiseite können mit etwas Geschick leicht in Form von "Karten" dargestellt werden.
<bookshelf scr="Book:User manual" />


==How do I create links?==
== Was sind Karten? ==
Linking pages is an important feature of browser-based knowledge documentation. The links often differ in their function. Links connect wiki pages with:
Karten sind Kombinationen von zusammenhängenden Spalten, die sich durch ein bestimmtes Format auszeichnen. Jede Wikiseite kann solche Karten beinhalten.<gallery widths="480" heights="250">
Datei:Handbuch:karten-before.png|alt=Wikiseite ohne Karten|Wikiseite ohne Karten
Datei:Handbuch:karten-after.png|alt=Wikiseite mit Karten|Wikiseite mit Karten
</gallery>


*other wiki pages
== Kartenstile anlegen ==
*external websites
Bevor Abschnitte als Karten formatiert werden können, muss ein Benutzer mit Admin-Rechten folgende Information zur Seite MediaWiki:Common.css hinzufügen und speichern:<syntaxhighlight lang="css">
*files (images, PDF files, Word documents,...)
/* Styles for section cards */
*files stored on other drives
.sectionflex {display: flex; flex-wrap: wrap; justify-content:space-between;}
.sectionflex.col1 > div {flex-basis:100%; padding:10px 20px 20px 20px; margin:10px 0;}
.sectionflex.col2 > div {flex-basis:49%; padding:10px 20px 20px 20px; margin:10px 0;}
.sectionflex.col3 > div {flex-basis:32%; padding:10px 20px 20px 20px; margin:10px 0;}
.sectionflex > div h2 {margin:0 0 1em 0}
.sectionflex.frame > div {border: 1px solid #e7e7e7}
.sectionflex.background> div {background: #f1f3f9}
.sectionflex .ve-ce-branchNode-slug {display:none}
@media (max-width: 767px) {.sectionflex.col2 > div, .sectionflex.col3 > div {flex-basis:100%; margin-top:2em}}


</syntaxhighlight>


Use the ''Insert link'' menu item in [[Manual:VisualEditor|VisualEditor]] or use the shortcut ''Ctrl+K''. In both cases, a dialog box opens.
== Karten erstellen ==
<br />
Um Abschnitte als Karten zu formatieren:
[[File:Manual:Insert_link.png|alt=Insert link to a wiki page|center|thumb|351x351px|Insert link to a wiki page<br />]]


==Link to a wiki page==
# '''Legen''' Sie eine Seite '''an''', die verschiedene Abschnitte beinhaltet. Abschnitte sind durch Überschriften gekennzeichnet.
Internal links 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 if the destination page is not in the same namespace as the current page.
# '''Öffnen''' Sie die Seite im Quelltextbearbeitungsmodus.
# '''Fügen''' Sie den Anfang für den Kartencontainer <code><nowiki><div class="sectionflex col2 background"></nowiki></code> überhalb der gewünschten ersten Karte (d.h. über der ersten gewünschten Überschrift) '''ein'''. Eine Überschrift beginnt und endet mit zwei Ist-gleich-Zeichen.:<syntaxhighlight lang="text">
<div class="sectionflex col2 background">
==Introduction==
With more than 165,000 inhabitants, Regensburg is the fourth-largest city in the State of Bavaria after Munich, Nuremberg and Augsburg.
</syntaxhighlight>
# '''Umschließen''' Sie nun alle Abschnitte, die Sie in diesem Container als Karte anzeigen wollen mit einem Start <code><nowiki><div></nowiki></code> und einem End <code><nowiki></div></nowiki>:</code><syntaxhighlight lang="text">
<div class="sectionflex col2 background">
<div>
==Introduction==
With more than 165,000 inhabitants, Regensburg is the fourth-largest city in the State of Bavaria after Munich, Nuremberg and Augsburg.(...)
</div>
<div>
==Topography==
Regensburg is situated on the northernmost part of the Danube river at the geological crossroads of four distinct landscapes (...)
</div>
</syntaxhighlight>
# '''Schließen''' Sie den sectionflex-Container selbst mit einem End <code><nowiki></div></nowiki></code>, um das Kartenlayout zu beenden:<syntaxhighlight lang="text">
<div class="sectionflex col2 background"> <! --- Start des Kartenlayouts-->
<div> <! --- Start einer Karte -->
==Introduction==
With more than 165,000 inhabitants, Regensburg is the fourth-largest city in the State of Bavaria after Munich, Nuremberg and Augsburg.(...)
</div> <! --- Ende einer Karte -->
<div> <! --- Start einer Karte -->
==Topography==
Regensburg is situated on the northernmost part of the Danube river at the geological crossroads of four distinct landscapes (...)
</div> <! --- Ende einer Karte -->
</div>  <! --- Ende des Kartenlayouts-->
</syntaxhighlight>Die beiden Abschnitte sollten nun so aussehen:[[Datei:Handbuch:karten-after.png|alternativtext=Zwei aufeinanderfolgende Abschnitte im Kartenlayout|zentriert|mini|750x750px|Zwei aufeinanderfolgende Abschnitte im Kartenlayout: <code><nowiki><div class="sectionflex col2 background"></nowiki></code>]]


If you have selected some text on the page, you will find some page suggestions already listed in the ''Search pages'' tab. Here, you can adjust the search term accordingly or create a link to a new page.
== Verfügbare Kartenformate ==
Wahlweise können Sie so 1-spaltige ("col1"), 2-spaltige ("col2") oder 3-spaltige ("col3") Karten mit grauem Hintergrund ("background") oder grauem Rahmen ("frame")  erstellen. Zum Beispiel:


Then click on ''Done''.
[[Datei:Handbuch:karten-col3-frame.png|alternativtext=3-spaltig mit Rahmen|zentriert|mini|750x750px|3-spaltig mit Rahmen:  <code><nowiki><div class="sectionflex col3 frame"></nowiki></code>]]


== Kombination von Karten ==
Es ist möglich unterschiedliche Kartenformate auf einer Seite zu kombinieren:<syntaxhighlight lang="css">
<div class="sectionflex col2 frame">
<div>
==Abschnitt 1==
Inhalt Abschnitt 1
</div>
<div>
==Abschnitt 2==
Inhalt Abschnitt 1
</div>
</div>


In the source text,  links are created with the following structure:
<div class="sectionflex col3 background">
<div>
==Abschnitt 3==
Inhalt Abschnitt 3
</div>
<div>
==Abschnitt 4==
Inhalt Abschnitt 4
</div>
<div>
==Abschnitt 5==
Inhalt Abschnitt 5
</div>
</div>


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


==Link to an external website==
</syntaxhighlight>
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 ''Insert''.
[[de:{{FULLPAGENAME}}]]
 
[[en:Manual:Displaying page sections as cards)]]
[[File:Manual:External link.png|center|alt=external link|350x350px]]
 
{{Messagebox|boxtype=note|Note text=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==
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.
<br />
[[File:Manual:Links.png|alt=Insert link to a file|center|thumb|350x350px|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.
*'''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 - <code>[[:file:///Z:/myfolder/vacatio]<nowiki>]</nowiki></code>. this only works if your wiki has been configured to work with network files. This function also depends on your individual browser security settings.<br /><br />[[File:Manual:Linkk.png|alt=Link to a network file|center|thumb|300x300px|Link to a network file]]
 
==Link to a file in the local network==
If you want to link to a file on your company network, you can  also use the ''Link to file'' tab.
{{Box Note|boxtype=important|Note text=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:'''
 
[[File:Manual:ve-link-einfügen-EN.png|alt=Insert local file link|center|thumb|350x350px|Insert local file link]]
 
#'''Click''' ''Insert link'' in the visual editor.
#'''Click''' on the tab ''Link to file.''
#'''''Activate''''' ''the switch Netzwerkpfad (URI).'' In the file search field (4) you now see the link symbol.
#'''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. <br />[[File:Manual:ve-link-einfügen-pfad-EN.png|alt=File properties|center|thumb|439x439px|File properties]]<br />
#'''Click''' ''Insert''. The link is automatically added in the correct format (<code><nowiki>file://S:/7_Benutzer/</nowiki>....</code>). 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.<br />
{{Box Links-en|Topic1=[[Reference:BlueSpiceInsertLink]] |Topic2 = [[Manual:Extension/VisualEditor]]}}
 
[[en:{{FULLPAGENAME}}]]
[[de:Handbuch:Erweiterung/BlueSpiceInsertLink]]
[[Category:Editing]]

Revision as of 17:22, 21 March 2022

Abschnitte einer Wikiseite können mit etwas Geschick leicht in Form von "Karten" dargestellt werden. 

Was sind Karten?

Karten sind Kombinationen von zusammenhängenden Spalten, die sich durch ein bestimmtes Format auszeichnen. Jede Wikiseite kann solche Karten beinhalten.

Kartenstile anlegen

Bevor Abschnitte als Karten formatiert werden können, muss ein Benutzer mit Admin-Rechten folgende Information zur Seite MediaWiki:Common.css hinzufügen und speichern:

/* Styles for section cards */
.sectionflex {display: flex; flex-wrap: wrap; justify-content:space-between;}
.sectionflex.col1 > div {flex-basis:100%; padding:10px 20px 20px 20px; margin:10px 0;}
.sectionflex.col2 > div {flex-basis:49%; padding:10px 20px 20px 20px; margin:10px 0;}
.sectionflex.col3 > div {flex-basis:32%; padding:10px 20px 20px 20px; margin:10px 0;}
.sectionflex > div h2 {margin:0 0 1em 0}
.sectionflex.frame > div {border: 1px solid #e7e7e7}
.sectionflex.background> div {background: #f1f3f9}
.sectionflex .ve-ce-branchNode-slug {display:none}
@media (max-width: 767px) {.sectionflex.col2 > div, .sectionflex.col3 > div {flex-basis:100%; margin-top:2em}}

Karten erstellen

Um Abschnitte als Karten zu formatieren:

  1. Legen Sie eine Seite an, die verschiedene Abschnitte beinhaltet. Abschnitte sind durch Überschriften gekennzeichnet.
  2. Öffnen Sie die Seite im Quelltextbearbeitungsmodus.
  3. Fügen Sie den Anfang für den Kartencontainer <div class="sectionflex col2 background"> überhalb der gewünschten ersten Karte (d.h. über der ersten gewünschten Überschrift) ein. Eine Überschrift beginnt und endet mit zwei Ist-gleich-Zeichen.:
    <div class="sectionflex col2 background">
    ==Introduction==
    With more than 165,000 inhabitants, Regensburg is the fourth-largest city in the State of Bavaria after Munich, Nuremberg and Augsburg.
    
  4. Umschließen Sie nun alle Abschnitte, die Sie in diesem Container als Karte anzeigen wollen mit einem Start <div> und einem End </div>:
    <div class="sectionflex col2 background">
    <div>
    ==Introduction==
    With more than 165,000 inhabitants, Regensburg is the fourth-largest city in the State of Bavaria after Munich, Nuremberg and Augsburg.(...)
    </div>
    <div>
    ==Topography==
    Regensburg is situated on the northernmost part of the Danube river at the geological crossroads of four distinct landscapes (...)
    </div>
    
  5. Schließen Sie den sectionflex-Container selbst mit einem End </div>, um das Kartenlayout zu beenden:
    <div class="sectionflex col2 background"> <! --- Start des Kartenlayouts-->
    <div> <! --- Start einer Karte -->
    ==Introduction==
    With more than 165,000 inhabitants, Regensburg is the fourth-largest city in the State of Bavaria after Munich, Nuremberg and Augsburg.(...)
    </div> <! --- Ende einer Karte -->
    <div> <! --- Start einer Karte -->
    ==Topography==
    Regensburg is situated on the northernmost part of the Danube river at the geological crossroads of four distinct landscapes (...)
    </div> <! --- Ende einer Karte -->
    </div>  <! --- Ende des Kartenlayouts-->
    
    Die beiden Abschnitte sollten nun so aussehen:alternativtext=Zwei aufeinanderfolgende Abschnitte im Kartenlayout|zentriert|mini|750x750px|Zwei aufeinanderfolgende Abschnitte im Kartenlayout: <div class="sectionflex col2 background">

Verfügbare Kartenformate

Wahlweise können Sie so 1-spaltige ("col1"), 2-spaltige ("col2") oder 3-spaltige ("col3") Karten mit grauem Hintergrund ("background") oder grauem Rahmen ("frame") erstellen. Zum Beispiel:

alternativtext=3-spaltig mit Rahmen|zentriert|mini|750x750px|3-spaltig mit Rahmen: <div class="sectionflex col3 frame">

Kombination von Karten

Es ist möglich unterschiedliche Kartenformate auf einer Seite zu kombinieren:

<div class="sectionflex col2 frame">
<div>
==Abschnitt 1==
Inhalt Abschnitt 1
</div>
<div>
==Abschnitt 2==
Inhalt Abschnitt 1
</div>
</div>

<div class="sectionflex col3 background">
<div>
==Abschnitt 3==
Inhalt Abschnitt 3
</div>
<div>
==Abschnitt 4==
Inhalt Abschnitt 4
</div>
<div>
==Abschnitt 5==
Inhalt Abschnitt 5
</div>
</div>



To submit feedback about this documentation, visit our community forum.

Discussions