Navigation - Revision history

Mlink-rodrigue at 13:30, 27 July 2021

2021-07-27T13:30:37Z

Mlink-rodrigue at 13:01, 11 May 2021

2021-05-11T13:01:18Z

Mlink-rodrigue at 12:11, 14 January 2021

2021-01-14T12:11:47Z

Mlink-rodrigue at 08:38, 14 January 2021

2021-01-14T08:38:04Z

Mlink-rodrigue at 09:03, 20 November 2020

2020-11-20T09:03:40Z

Mlink-rodrigue at 10:16, 30 July 2020

2020-07-30T10:16:23Z

Mlink-rodrigue at 10:08, 30 July 2020

2020-07-30T10:08:13Z

Mlink-rodrigue at 10:07, 30 July 2020

2020-07-30T10:07:03Z

Mlink-rodrigue at 10:06, 30 July 2020

2020-07-30T10:06:39Z

Mlink-rodrigue at 10:05, 30 July 2020

2020-07-30T10:05:29Z

@@ Line 31: / Line 31: @@
 In the navigation example above, the page description ''From A to Z'' links to the page ''Special:AllPages'' .{{Box_Note|Note text = It is not possible to create sub-items in the navigation bar.|boxtype=note}}
 ==Changing the icons==
 You can assign different icons to each menu item in the main navigation. Let's assume you have a menu item called ''Quality assurance''. The default BlueSpice icon is a ''page'' icon:
@@ Line 77: / Line 84: @@
 In the upper line you can click through different fonts, below you find the icons with the corresponding character keys. In ''MediaWiki:Common.css'' you have to adjust the entries ''font-family'' (entypo, fontawesome, icomoon, ...) and ''content'' (character key) accordingly.
-== Group-specific navigation ==
+==Group-specific navigation==
 It is possible to show navigation elements for specific user groups only. Please note that the pipe symbol (|) between the page name and its label has to be escaped as <code><nowiki>{{!}}</nowiki></code>  within this function.<syntaxhighlight lang="text">
 {#ifingroup:sysop,widgeteditor |

@@ Line 77: / Line 77: @@
 In the upper line you can click through different fonts, below you find the icons with the corresponding character keys. In ''MediaWiki:Common.css'' you have to adjust the entries ''font-family'' (entypo, fontawesome, icomoon, ...) and ''content'' (character key) accordingly.
 ==Supporting language settings==
 If you want to make sure that your menu items are shown in the language a user has set under ''Preferences'', you need to provide  a separate message page for each menu item. These message pages need to reside in the namespace ''MediaWiki''. Since BlueSpice supports English and German (both de and de-formal), you need three language pages for each menu item in the sidebar.

@@ Line 56: / Line 56: @@
 <br />
-=== Navigationlinks with special characters ===
+===Navigationlinks with special characters===
 If the text for the menu items contains special characters,  they are converted in the HTML code of the page. In this case, right-click on the corresponding entry and, depending on the browser used, select "Inspect" or similar.
+There you can see the underlying source code and should see a line item that has this form:
 <pre><a id="n-MENUENTRY" class="list-group-item" ..... ></pre>
-Use the exact id value shown in the page inspector in your stylesheet.For example, the German menu item Qualitätssicherung is shown as ''n-Qualit.C3.A4tssicherung''. The selector in Common.css is ''#n-Qualit.C3.A4tssicherung''.
+For example, the German menu item ''Qualitätssicherung'' is shown as ''n-Qualit.C3.A4tssicherung''. The selector in Common.css is ''#n-Qualit.C3.A4tssicherung''.<syntaxhighlight lang="css">
 ===Available icons===

@@ Line 54: / Line 54: @@
 Reload the page or empty the browser cache if the changes are not immediately visible.
-If the text for the menu items contains special characters,  there might be issues because they are converted in the HTML code of the page. In this case, right-click on the corresponding entry and, depending on the browser used, select "Examine element" or similar.
+<br />
 You will now see the underlying source code and should see a line item that has this form:
 <pre><a id="n-MENUENTRY" class="list-group-item" ..... ></pre>

@@ Line 6: / Line 6: @@
 The main navigation is visible to all wiki users. By default, it is on the left side of the wiki layout. You can always switch to the main navigation by clicking on the associated icon at the top of the navigation bar.<br />
 [[File:navmenu-top.png|alt=Navigation menu|center|thumb|250x250px|Navigation menu]]
@@ Line 78: / Line 79: @@
 ==Navigation in multilingual wikis==
 If you have content in multiple languages, you want that users with English language preference settings not only see the corresponding menu labels. They should also be directed to the English page when they click on a menu item. Users with German language settings should see the German content after clicking on the German menu link. In this case, you also have to create separate link targets in addition to the language labels.

@@ Line 3: / Line 3: @@
 Users with administrator rights can change the menu items in the main navigation.
-==About the main navigation==
+==Changing the menu items==
-The main navigation is visible to all wiki users. By default, it is on the left side of the wiki layout. You can always switch to the main navigation by clicking on the associated icon at the top of the navigation bar:
+The main navigation is visible to all wiki users. By default, it is on the left side of the wiki layout. You can always switch to the main navigation by clicking on the associated icon at the top of the navigation bar.<br />
-<br />
+[[File:navmenu-top.png|alt=Navigation menu|center|thumb|250x250px|Navigation menu]]
-==Changing the menu items==
-To activate the edit link, hover over the last menu item in the main navigation:
+To activate the edit link, hover over the last menu item in the main navigation.[[File:navmenu-edit.png|alt=Edit sidebar|center|220x220px|thumb|Edit sidebar]]
 The  link ''Edit sidebar'' loads the page ''Mediawiki:Sidebar:''
@@ Line 51: / Line 49: @@
 The icon is now customized to an ''eye'' icon:
-[[File:navmenu-icon-eye.png|alt=Screenshot: custom icon in main navigation|center|170x170px]]
+[[File:navmenu-icon-eye.png|alt=Custom icon|center|170x170px|thumb|Custom icon]]
 Reload the page or empty the browser cache if the changes are not immediately visible.

@@ Line 101: / Line 101: @@
 This achieves the language switch for the target pages (QA-url) and for the label of the menu item.<br /><br />Depending on the language settings of the user, the user is now directly directed to the correct language version.<br />
-{{Box Links-en|Topic1=[[Template/Example/Translate| Translation of pages within a wiki]]|Topic2=[[Manual:Extension/BlueSpiceUserSideBar | Personal navigation]]}}
+{{Box Links-en
 [[en:{{FULLPAGENAME}}]]
 [[De:Navigation]]
 [[Category:Administration]]

@@ Line 1: / Line 1: @@
 {{DISPLAYTITLE:Customize the main navigation}}
 Users with administrator rights can change the menu items in the main navigation.
 ==About the main navigation==
@@ Line 60: / Line 61: @@
 ===Available icons===
-[[File:all-icons.png|alt=Screenshot: BlueSpice icon chart|right|300x300px|[https://wiki.hallowelt.com/extensions/BlueSpiceFoundation/resources/bs.icons.php?icons=entypo]]]
+You can see all available icons on the page <code>w/extensions/BlueSpiceFoundation/resources/bs.icons.php</code> of your wiki.
-You can see all available icons in the extensions folder of your installation ( ''../extensions/BlueSpiceFoundation/resources/bs.icons.php)'' of your wiki.
+[https://en.wiki.bluespice.com/w/extensions/BlueSpiceFoundation/resources/bs.icons.php A list with all icons] and their character keys on this helpdesk is available here and is the same for any default installation of a BlueSpice wiki.
 In the upper line you can click through different fonts, below you find the icons with the corresponding character keys. In ''MediaWiki:Common.css'' you have to adjust the entries ''font-family'' (entypo, fontawesome, icomoon, ...) and ''content'' (character key) accordingly.
 ==Supporting language settings==
-If you want to make sure that your menu items are shown in the language a user has set under ''Preferences'', you need provide  a separate message page for each menu item. These message pages need to reside in the namespace ''MediaWiki''. Since BlueSpice supports English and German (both de and de-formal), you need three language pages for each menu item in the sidebar.
+If you want to make sure that your menu items are shown in the language a user has set under ''Preferences'', you need to provide  a separate message page for each menu item. These message pages need to reside in the namespace ''MediaWiki''. Since BlueSpice supports English and German (both de and de-formal), you need three language pages for each menu item in the sidebar.
 In the following example, we create a menu item called ''Quality assurance.'' A user who specified German (de) or formal German (de-formal in their preferences, should see the label ''Qualitätssicherung'' instead.
@@ Line 78: / Line 77: @@
 #Create or edit the page ''MediaWiki:QA''/''de'' and add the text for the German label (''Qualitätssicherung'').Save the page.
 #Create or edit the page ''MediaWiki:QA''/''de-formal'' and add the text for the German label (''Qualitätssicherung''). Save the page.
-#Create the link on the page ''<code>MediaWiki:Sidebar</code>'':  <code>**About_quality_assurance|QA</code>  This creates a link in the main navigation to the page ''About quality assurance'' and displays the label that is located in the different language message pages. To test the languages, go to ''Preferences > User Profile'' in your user profile menu. In the section ''Internationalisation'', set the language from English to German or vice versa and save the setting. The language of the menu item now displays in the correct language.
+#Create the link on the page ''MediaWiki:Sidebar'':  <code>**About_quality_assurance|QA</code>  This creates a link in the main navigation to the page ''About quality assurance'' and displays the label that is located in the different language message pages. To test the languages, go to ''Preferences > User Profile'' in your user profile menu. In the section ''Internationalisation'', set the language from English to German or vice versa and save the setting. The language of the menu item now displays in the correct language.
 ==Navigation in multilingual wikis==
@@ Line 103: / Line 102: @@
 This achieves the language switch for the target pages (QA-url) and for the label of the menu item.<br /><br />Depending on the language settings of the user, the user is now directly directed to the correct language version.<br />
 {{Box Links-en|Topic1=[[Template/Example/Translate| Translation of pages within a wiki]]}}
 [[en:{{FULLPAGENAME}}]]
 [[De:Navigation]]
 [[Category:Administration]]