Manual:Extension/BlueSpiceDiscovery/Main navigation/Language support and Templates download/Minutes for teams: Difference between pages

Latest revision as of 16:01, 10 February 2022

This template contains a combined roll-up page for creating meeting minutes of different teams. A standard protocol page template is also included.

The template can be expanded with additional page templates for different types of meeting minutes.

Importing the template

The import file is included in the archive file HW-Minutes.zip. Unpack the zip file first.

On the page Special:Import follow these steps:

Select file and choose HW-Minutes.xml.
Enter an Interwiki prefix. Since this field is required, simply add hw (for hallowelt).
Keep the selection Import to default locations.
Click Sie Upload file... .

The template is now available in your wiki.

Pages included in the import

The xml import creates the following files in your wiki:

Meeting minutes (in the Main namespace)

Template:Meeting minutes
Template:Meeting minutes/styles.css
Template:Meeting minutes standard

Using the template

Create a namespace

Over time, you will create many pages for meeting minutes. It therefore makes sense to store them in their own namespace. We suggest that you create the "Minutes" namespace for this purpose. The template for minutes requires that this namespace is available.

If you do not want to use the "Minutes" namespace in your wiki, you can adjust the expected namespace in the file Template:Meeting minutes. To do this, change the prefix Minutes in the inputbox tag:

{{#tag:inputbox|
 ...
 prefix=Minutes:{{{1|{{PAGENAME}}}}}/

to your own namespace, here exemplified as Your_namespace:

{{#tag:inputbox|
  ...
  prefix=Your_namespace:{{{1|{{PAGENAME}}}}}/

Add a navigation link

To easily find and create meeting minutes, you should provide a direct link to the Minutes roll-up page in the main navigation. By default, the page Meeting minutes is located in the main namespace. You can move it to any namespace you want.

Customizing the template

Creating individual teams

Three adjustments need to be made for each team section on the main Meeting minutes page:

The box heading with the team name.
The team name used to create the file path for this team's minutes. This generates the main page prefix used for any meeting time for this team before the date. For example Marketing/2021-07-01.
The page template you want to use for the team's meeting minutes. By default, there is only one template (Meeting minutes standard) for all meeting minutes. Simply create a new page in the template namespace and assign it here as a preload template for a team.

Example of a team:

<div class="block">
== My team==
{{Meeting minutes|My team|preload=Template:Meeting minutes my team}}
</div>

Result:

Inputbox for creating meeting minutes

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

@@ Line 1: / Line 1: @@
+<div class="downloadarea">
+<span class="getButton">[[Media:HW-Minutes.zip|Download]]</span>
-== Support for the user language settings ==
+[[File:HW-Minutes-en.png|450x450px]]
-If you want to make sure that your menu items are shown in the language a user has set under their ''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.
+</div>This template contains a combined roll-up page for creating meeting minutes  of different teams. A standard protocol page template is also included.
-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.
+The template can be expanded with additional page templates for different types of meeting minutes.
+==Importing the template==
+The import file is included in the archive file ''HW-Minutes.zip''. Unpack the zip file first.
-'''To create the labels in EN, DE and DE-formal:'''
+On the page ''Special:Import'' follow these steps:
-#Create or edit the page ''MediaWiki:QA'' and add the text for the English label (''Quality assurance'').Save the page.
+#'''Select file''' and choose ''HW-Minutes.xml''.
-#Create or edit the page ''MediaWiki:QA''/''de'' and add the text for the German label (''Qualitätssicherung'').Save the page.
+#'''Enter''' an Interwiki prefix. Since this field is required, simply add ''hw'' (for hallowelt).
-#Create or edit the page ''MediaWiki:QA''/''de-formal'' and add the text for the German label (''Qualitätssicherung''). Save the page.
+#'''Keep''' the selection ''Import to default locations''.
-#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.
+#'''Click''' Sie ''Upload file...'' .
-==<span class="mw-headline">Navigation in multilingual wikis</span>==
+The template is now available in your wiki.<br />
-{{Messagebox|boxtype=important|Note text=These instructions do not apply in a farm environment or in separate language wikis. These instructions are used for maintaining languages via sub-pages.}}
+==Pages included in the import==
+The xml import creates the following files in your wiki:
-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.<div>
+*Meeting minutes (in the ''Main'' namespace)
-{{Messagebox|boxtype=note|Note text=To avoid having to set up different navigation pages for formal (de-formal) and informal German (de), you can create a policy, which language setting should be used by your users.}}
-</div>In the previous section, we already created the labels when a user switches languages. Now we also have to create different link targets for these pages. If the main language is English and the page is called ''About quality assurance,'' the translations can be located in subpages. For example, the German version is located under ''About quality assurance/de''.
-'''To create the link targets to the language pages:'''
+*Template:Meeting minutes
+*Template:Meeting minutes/styles.css
+*Template:Meeting minutes standard
-#Create or edit the page ''MediaWiki:QA-url'' and add the link to the English page ''About quality assurance''. The link is entered without brackets, in plain text. Save the page.
+==Using the template==
-#Create or edit the page ''MediaWiki:QA''-url/''de'' and add the text for the German page (''About quality assurance''/de). The link is entered without brackets, in plain text. Save the page.
-#Create or edit the page ''MediaWiki:QA''-url/''de-formal'' and add the text for the German page (''About quality assurance''/de). The link is entered without brackets, in plain text. Save the page.
-In the link to the ''Quality assurance'' page, change the link from
+===Create a namespace===
+Over time, you will create many pages for meeting minutes. It therefore makes sense to store them in their own namespace. We suggest that you create the "Minutes" namespace for this purpose. The template for minutes requires that this namespace is available.
-<code>**About_quality_assurance|QA</code>
+If you do not want to use the "Minutes" namespace in your wiki, you can adjust the expected namespace  in the file ''Template:Meeting minutes''. To do this, change the prefix ''Minutes'' in the ''inputbox'' tag:<syntaxhighlight lang="text">
+{{#tag:inputbox|
+ ...
+ prefix=Minutes:{{{1|{{PAGENAME}}}}}/
+</syntaxhighlight>to your own namespace, here exemplified as ''Your_namespace'':<syntaxhighlight lang="text">
+{{#tag:inputbox|
+  ...
+  prefix=Your_namespace:{{{1|{{PAGENAME}}}}}/
+</syntaxhighlight>
-to
+===Add a navigation link===
+To easily find and create meeting minutes, you should provide a direct link to the Minutes roll-up page in the [[Manual:Extension/BlueSpiceDiscovery/Main navigation|main navigation]]. By default, the  page ''Meeting minutes'' is located in the main namespace. You can move it to any namespace you want.
-<code>**QA-url|QA</code>
+==Customizing the template==
-This achieves the language switch for the target pages (QA-url) and for the label of the menu item.
+===Creating individual teams===
+Three adjustments need to be made for each team section on the main ''Meeting minutes'' page:
-Depending on the language settings of the user, the user is now directly directed to the correct language version.
+#The '''box heading''' with the team name.
+#'''The team name''' used to create the file path for this team's minutes. This generates the main page prefix used for any meeting time for this team before the date. For example ''Marketing''/2021-07-01.
+#The '''page template''' you want to use for the team's meeting minutes. By default, there is only one template (Meeting minutes standard) for all meeting minutes. Simply create a new page in the template namespace and assign it here as a preload template for a team.
+Example of a team:<syntaxhighlight lang="text">
+<div class="block">
+== My team==
+{{Meeting minutes|My team|preload=Template:Meeting minutes my team}}
+</div>
+</syntaxhighlight>Result:
+[[File:HW-Minutes-inputbox.png|center|thumb|350x350px|Inputbox for creating meeting minutes|link=Special:FilePath/HW-Minutes-inputbox.png]]
+<br />
+__NOTOC__