Meryam Sahin (talk | contribs)
Created page with "<bookshelf src="Book:User manual" /> An important aspect of the wiki principle is that content can be created, edited and shared quickly with others. Changes to wiki pages can be tracked and reversed at any time via the version history. Therefore, a wiki should limit editing rights sparingly to allow for the greatest possible collaboration. ==Creating a page== '''To create a page:''' #'''Click''' the + button in the Header. A dia..."
 
Meryam Sahin (talk | contribs)
No edit summary
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
<bookshelf src="Book:User manual" />
'''in Real Helpdesk!'''<status color="green" light="true">done</status> <br>
An important aspect of the wiki principle is that content can be created, edited and shared quickly with others. Changes to wiki pages can be tracked and reversed at any time via the version history. Therefore, a wiki should limit editing rights sparingly to allow for the greatest possible collaboration.
Before creating a new page, consider where the information belongs and whether a suitable page already exists. Using the existing structure of the wiki helps avoid duplicate content and keeps information easier to find and maintain.
 
== Creating a new page ==
==Creating a page==
Pages can be created from different areas of the BlueSpice Galaxy using the '''New content''' button. Depending on where the button is located, the menu provides different page creation options:
'''To create a page:'''
* The '''New content''' button in the header creates a new page.
 
* The '''New content''' button next to a page title in the main navigation creates a new subpage of that page.
#'''Click''' the + button in the [[Manual:Extension/BlueSpiceDiscovery|Header]]. A dialog window opens.
=== Create a page ===
#'''Enter <nowiki/>'''a page name. If th'''''<nowiki/>'''''e page already exists, it will be listed under the text field. If you want to create the page in an existing [[Manual:The concept of namespaces|namespace]], add the namespace name as a prefix, followed by a colon. Example: <code>Manual:Visual editing</code> [[File:Manual Create pages 1748245897327.png|alt=Dialog field with the new page name "Community"|center|thumb|Create a new page]]
'''To create a new page''':
#'''Click''' done.
# Select the '''New content''' button in the header. A dialog opens.
#'''C''<nowiki/>''hoose''' ''Blank Page'' or a page template if your wiki offers a selection page templates page as the next step. This step is omitted if no page templates are available. The page now opens in edit mode.
# Enter a page title. If a page with this title already exists, it is displayed as a suggestion below the text field.
#'''Save''' the page.  After saving the page for the first time, the page exists in the wiki.  Click the edit icon of the page to switch back to edit mode.
[[File:create-page-dialog.png|alt=Dialog field with the new page name "Community"|center|thumb|Create a new page]]
 
# Select '''Create'''.
==Changing the page name==
# If available, select an option from the card layout. To create a page without predefined content, select '''Empty page'''. Templates provide a predefined structure for specific types of content.
If you want to change the page name later (e.g., to store it in another [[Manual:The concept of namespaces|namespace]]), you need to [[Manual:Rename and move pages|move]] the page.
# The new page opens in edit mode. Add the content and save the page. <br>
 
Most pages are created in the main namespace. Other namespaces, such as '''Controlled document''' or '''Minutes''', are used for specific types of content and provide dedicated creation options through the different dashboards.
==Adding subpages==
== Choosing a page title ==
To create a [[Manual:Subpage|subpage]] for the current page, select the ''New subpage'' link from the ''New'' menu.
* '''Choose a meaningful title:''' Meaningful page titles help users understand the purpose of a page and make information easier to find. Choose clear and concise titles that describe the content. Single words can work well for general topics, while short phrases are often useful when they provide more context. Avoid overly general or unnecessarily long page titles because page titles are used in links and URLs.
[[File:Create a subpage.png|alt=BlueSpice "new" button menu|center|thumb|218x218px|Create a subpage]]
* '''Avoid special characters:''' The following characters cannot be used in titles: <code>{</code>, <code>}</code>, <code>&</code>, <code>?</code>, <code><</code>, <code>></code>, <code>\</code>, and <code>,</code>. For more information, see [https://www.mediawiki.org/wiki/Manual:Page_title?action=view MediaWiki].
 
* '''Use exact spelling:''' When linking to an existing page, use the exact page title to ensure that links point to the correct content. For example, <code><nowiki>[[Hello world]]</nowiki></code> and <code><nowiki>[[Hello World]]</nowiki></code> can refer to different pages. Pay particular attention to spelling when creating links manually.
The subpage is then created  as page <code>current page/subpage</code>, e.g. ''VisualEditor/Tables''. If a page has subpages, the path is displayed via the breadcrumb navigation at the top of the page. The character <code>/</code> is only used to create a subpage. This means that you cannot create a wiki page called ''When/how to take a vacation'' as this will result in a main page ''When'' with its subpage ''how to take a vacation''.
== Creating a subpage ==
 
<excerpt-block name="subpage" hidden="false">Subpages help organize information within a specific topic. A page can have multiple subpages that organize related information into smaller sections, for example by separating a general topic from more specific information. <br>There are several ways to create a subpage. One option is to use the '''New content''' button next to the page title in the main navigation.
==Page name conventions==
===Create a subpage from the New content menu===
 
'''To create a subpage from an existing page''':
*'''Title choice:''' In a wiki, titles are very important. In wikis with many entries, it happens that authors set links to pages that they consider important in the context of their entry. Single words work well, but short phrases like "why wikis work" can also be goood page names. In addition, meaningful page titles also make it easier for readers to find their way around and to search for an article using the title search.
#Select the '''New content''' button next to the page title in the main navigation.
 
#Select '''New subpage'''.
*'''Namespaces:''' To create an <span class="mw-lingo-term">article</span> in another <span class="mw-lingo-term">namespace</span>, its name must be preceded by the <span class="mw-lingo-term">namespace prefix</span>, i.e. <code>namespace:articlename</code>. An article name can exist multiple times in the wiki as long as it is in different namespaces.
[[File:create-subpage-menu.png|alt=BlueSpice "new" button menu|center|thumb|218x218px|Create a subpage]]
*'''Special characters:''' The following characters cannot be used in titles: <code>{ } & ? < > \</code> and <code>,</code> . You can find more about this at [https://www.mediawiki.org/wiki/Manual:Page_title?action=view Mediawiki].
The subpage is created under the current page. For example, a subpage called <code>Tables</code> under the page <code>VisualEditor</code> is displayed as <code>VisualEditor/Tables</code>. <br>
*'''Spelling:''' When linking to an already existing page in source edit mode, you should pay attention to the exact spelling. For example, if you enter <code><nowiki>[[Hello world]]</nowiki></code> instead of <code><nowiki>[[Hello World]]</nowiki></code>, links to two different pages are created, because the page names are case sensitive. Only the first letter of a (parent) page is case-insensitive. Subpage names are completely case-sensitive.
The page hierarchy is shown in the breadcrumb navigation at the top of the page. <br>
 
The slash (<code>/</code>) separates the parent page from the subpage. Do not use the slash as a regular character in a page title. For example, <code>When/how to take a vacation</code> creates a main page called <code>When</code> with a subpage called <code>how to take a vacation</code>, rather than a page with the title <code>When/how to take a vacation</code>.</excerpt-block>
== Alternative options for page creation ==
== Renaming and moving pages ==
There are other handy ways to create a page in the wiki:
As content changes, existing pages may need to be renamed or moved. Use the '''Move''' function for existing pages instead of creating a new page with the desired title. <br>For more information, see [[Rename_and_move_pages|Rename/move]].
 
== Other ways to create pages ==
*'''Redlink:''' If you are currently editing a wiki page, you can directly select a text passage and set a link to a non-existent page. This creates a red-formatted link (redlink) for which there is no wiki page yet. The non existing page is then also listed on the special page <code>Wanted files</code>.
In addition to the standard creation options, there are other ways to create pages depending on the configuration of the wiki:
*'''Browser address bar:''' You can also create a page directly from the address bar of your web browser. To do this, simply replace the title of the current page with a new page name. If you then press Enter, the new page will open.
* '''Create page:''' Editors can provide predefined page creation options using the '''Create page''' function from the '''Content droplet'''.
*'''[[Manual:Extension/InputBox|Inputbox]]''': Input field that can easily be added to any page that includes predefined parameters to ensure the page is created in a particular namespace or using a particular page template.
* '''Red links:''' While editing a wiki page, a link can be created to a page that does not yet exist. These links are displayed as red links and provide a direct way to create missing content. Selecting the link opens the new page for creation.
*'''[[Reference:Page Forms|Form]]:''' In BlueSpice pro, there is also the possibility to create pages using forms. This has the advantage that you can pass different page parameters, such as a page template or various template parameter values to a new page during page creation.
* '''Browser address bar:''' A page can be created directly from the address bar of a web browser by replacing the current page title with a new page title. When the address is confirmed, the new page opens for creation.
 
 
{{Box_Links-en | Topic1 =[[Manual:Rename_and_move_pages|Rename and move pages]]| Topic2 =[[Manual:Redirects|Redirects - using synonyms]] | Topic3 =[[Manual:Extension/BlueSpicePageTemplates|Page templates]] | Topic4 = }}
[[en:{{FULLPAGENAME}}]]
[[de:Handbuch:Seiten_erstellen]]
 
[[Category:Editing]]

Latest revision as of 11:34, 19 October 2026

in Real Helpdesk!done
Before creating a new page, consider where the information belongs and whether a suitable page already exists. Using the existing structure of the wiki helps avoid duplicate content and keeps information easier to find and maintain.

Creating a new page

Pages can be created from different areas of the BlueSpice Galaxy using the New content button. Depending on where the button is located, the menu provides different page creation options:

  • The New content button in the header creates a new page.
  • The New content button next to a page title in the main navigation creates a new subpage of that page.

Create a page

To create a new page:

  1. Select the New content button in the header. A dialog opens.
  2. Enter a page title. If a page with this title already exists, it is displayed as a suggestion below the text field.
Dialog field with the new page name "Community"
Create a new page
  1. Select Create.
  2. If available, select an option from the card layout. To create a page without predefined content, select Empty page. Templates provide a predefined structure for specific types of content.
  3. The new page opens in edit mode. Add the content and save the page.

Most pages are created in the main namespace. Other namespaces, such as Controlled document or Minutes, are used for specific types of content and provide dedicated creation options through the different dashboards.

Choosing a page title

  • Choose a meaningful title: Meaningful page titles help users understand the purpose of a page and make information easier to find. Choose clear and concise titles that describe the content. Single words can work well for general topics, while short phrases are often useful when they provide more context. Avoid overly general or unnecessarily long page titles because page titles are used in links and URLs.
  • Avoid special characters: The following characters cannot be used in titles: {, }, &, ?, <, >, \, and ,. For more information, see MediaWiki.
  • Use exact spelling: When linking to an existing page, use the exact page title to ensure that links point to the correct content. For example, [[Hello world]] and [[Hello World]] can refer to different pages. Pay particular attention to spelling when creating links manually.

Creating a subpage

Subpages help organize information within a specific topic. A page can have multiple subpages that organize related information into smaller sections, for example by separating a general topic from more specific information.
There are several ways to create a subpage. One option is to use the New content button next to the page title in the main navigation.

Create a subpage from the New content menu

To create a subpage from an existing page:

  1. Select the New content button next to the page title in the main navigation.
  2. Select New subpage.
BlueSpice "new" button menu
Create a subpage

The subpage is created under the current page. For example, a subpage called Tables under the page VisualEditor is displayed as VisualEditor/Tables.
The page hierarchy is shown in the breadcrumb navigation at the top of the page.
The slash (/) separates the parent page from the subpage. Do not use the slash as a regular character in a page title. For example, When/how to take a vacation creates a main page called When with a subpage called how to take a vacation, rather than a page with the title When/how to take a vacation.

Renaming and moving pages

As content changes, existing pages may need to be renamed or moved. Use the Move function for existing pages instead of creating a new page with the desired title.
For more information, see Rename/move.

Other ways to create pages

In addition to the standard creation options, there are other ways to create pages depending on the configuration of the wiki:

  • Create page: Editors can provide predefined page creation options using the Create page function from the Content droplet.
  • Red links: While editing a wiki page, a link can be created to a page that does not yet exist. These links are displayed as red links and provide a direct way to create missing content. Selecting the link opens the new page for creation.
  • Browser address bar: A page can be created directly from the address bar of a web browser by replacing the current page title with a new page title. When the address is confirmed, the new page opens for creation.