2.1 Create

(Created page with "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...")
Tag: 2017 source edit
 
No edit summary
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<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.
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.


==Create a page==
==Creating a page==
'''To create a page:'''
'''To create a page:'''


#'''Click''' the New button in the [[Manual:Extension/BlueSpiceDiscovery|Header]]. A dialog window opens.
#'''Click''' the New button in the [[Manual:Extension/BlueSpiceDiscovery|Header]]. A dialog window opens.
#'''Enter'<nowiki/>'' a new page name '<nowiki/>'''''. If the page does not exist yet, you will see a red link.[[File:Manual:Create page dialog.png|alt=Create a new page|center|thumb|350x350px|Create a new page]]
#'''Enter <nowiki/>'''a page name. If th'''''<nowiki/>'''''e page does not exist yet, you will see a red link. f you want to create the page in an existing namespace, add the namespace name as a prefix, followed by a colon. Example: <code>Manual:Visual editing</code> I[[File:Manual:Create page dialog.png|alt=Create a new page|center|thumb|350x350px|Create a new page]]
#'''Click''' done.
#'''Click''' done.
#'''Choose''' ''Blank Page'' or a page template. This step is omitted if no page templates are available. The page now opens in edit mode. You can now use the [[Manual:Extension/VisualEditor|editor bar]] to switch between visual editing and source code editing.
#'''Choose''' ''Blank Page'' or a page template if your wiki shows the page templates page as the next step. This step is omitted if no page templates are available. The page now opens in edit mode.
#'''Save''' the page. It now exists in the main wiki namespace.
#'''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.


==Change a page name==
==Changing the page name==
If you want to change the page name later (e.g. to store it in another [[Manual:The concept of namespaces|Namespace]]), you can use the [[Manual:Rename and move pages|Move the page]].
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.


==Create subpages==
==Adding subpages==
To create a [[Manual:Subpage|Subpage]] for the current page, select the ''New subpage'' function from the ''New'' button menu.
To create a [[Manual:Subpage|subpage]] for the current page, select the ''New subpage'' link from the ''New'' menu.
[[File:Manual:Create a subpage.png|alt=Create a subpage|center|thumb|150x150px|Create a subpage]]
[[File:Manual:Create a subpage.png|alt=Create a subpage|center|thumb|150x150px|Create a subpage]]


 
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''.
The subpage is then created accordingly 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. So you can't create a wiki page called ''When/how to take vacation'' as this will result in a main page ''When'' with subpage ''How to take vacation''.


==Page name conventions==
==Page name conventions==


*'''Title choice:''' In a wiki, titles are very important. In wikis with many entries, it happens that authors "on the off chance" set links to pages that they consider important in the context of their entry. It should therefore be ensured that the title describes as briefly and precisely as possible what the page is about. Single words work well, but short phrases like "why wikis work" can also be useful 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.
*'''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.


*'''Namespaces:''' To create a <span class="mw-lingo-term">article</span> in another <span class="mw-lingo-term">namespace</span>, the respective article 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.
*'''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.
*'''Special characters:''' The following characters '''not''' can 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].
*'''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].
*'''Spelling:''' When linking to an already existing page via the source text mode, you should pay attention to the exact spelling. For example, if you enter <nowiki>[[Hello world]]</nowiki> instead of <nowiki>[[Hello World]]</nowiki>, a new page is created again because the links were written differently. You should therefore also take into account upper and lower case letters and spaces. Only with the first letter does it make no difference whether you write it in upper or lower case.
*'''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.


==Alternate options==
==Alternate options==
There are other handy ways to create a page in the wiki:
There are other handy ways to create a page in the wiki:


*'''Search:''' <span class="ve-pasteProtect" style="color: rgb(51, 51, 51)">Maybe a page on your topic already exists. Before you create a new page, you can use the search function to enter terms related to your topic and check existing pages. If there is no suitable page yet, click on the red link "Page</span> ''[page name]'' <span class="ve-pasteProtect" style="color: rgb(51, 51, 51)">create " in the search results of the quick menu. There is also a <code>+</code> button for creating a new page in the Search Center.</span>
*'''Search:''' <span class="ve-pasteProtect" style="color: rgb(51, 51, 51)">Maybe a page about your topic already exists. Before you create a new page, you can use the search function to enter terms related to your topic and check existing pages. If there is no suitable page yet, click on the red link "Page</span> ''[page name]'' <span class="ve-pasteProtect" style="color: rgb(51, 51, 51)">create " in the search results of the quick menu. There is also a <code>+</code> button for creating a new page in the Search Center.</span>
*'''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. <span class="ve-paste
*'''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. <span class="ve-paste
*'''rowser 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.
*'''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.
*'''Form:''' In BlueSpice pro, there is also the possibility to create pages using [[Reference:Page Forms|forms]].
*'''[[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.
*'''[[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.




{{Box_Links-en | Topic1 =[[Rename_and_move_pages|Rename and move pages]]| Topic2 =[[Redirects|Redirects - Using Synonyms]] | Topic3 =[[Reference:BlueSpicePageTemplates|Creating and Using Page Templates]] | Topic4 = }}
{{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}}]]
[[en:{{FULLPAGENAME}}]]
[[de:Seiten_erstellen]]
[[de:Seiten_erstellen]]


[[Category:Editing]]
[[Category:Editing]]

Latest revision as of 12:54, 23 July 2024

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:

  1. Click the New button in the Header. A dialog window opens.
  2. Enter a page name. If the page does not exist yet, you will see a red link. f you want to create the page in an existing namespace, add the namespace name as a prefix, followed by a colon. Example: Manual:Visual editing I
    Create a new page
    Create a new page
  3. Click done.
  4. Choose Blank Page or a page template if your wiki shows the page templates page as the next step. This step is omitted if no page templates are available. The page now opens in edit mode.
  5. 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.

Changing the page name

If you want to change the page name later (e.g., to store it in another namespace), you need to move the page.

Adding subpages

To create a subpage for the current page, select the New subpage link from the New menu.

Create a subpage
Create a subpage

The subpage is then created as page current page/subpage, 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 / 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.

Page name conventions

  • 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.
  • Namespaces: To create an article in another namespace, its name must be preceded by the namespace prefix, i.e. namespace:articlename. An article name can exist multiple times in the wiki as long as it is in different namespaces.
  • Special characters: The following characters cannot be used in titles: { } & ? < > \ and , . You can find more about this at Mediawiki.
  • 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 [[Hello world]] instead of [[Hello World]], 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.

Alternate options

There are other handy ways to create a page in the wiki:

  • Search: Maybe a page about your topic already exists. Before you create a new page, you can use the search function to enter terms related to your topic and check existing pages. If there is no suitable page yet, click on the red link "Page [page name] create " in the search results of the quick menu. There is also a + button for creating a new page in the Search Center.
  • 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. <span class="ve-paste
  • 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.
  • 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.
  • 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.


Related info




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