Difference between revisions of "Manual:Extension/BlueSpicePageTemplates"
[unchecked revision] | [quality revision] |
Fbaeckmann (talk | contribs) m (Tag: 2017 source edit) |
m (Tag: 2017 source edit) |
Contents
- 1 What is BlueSpicePageTemplatesa page template?
- 2 Usage Characteristics2.1
- 3 Creating a page template pages2.3
-
- 2.2 Creating page templates
- 2.
- 4 Using page templates when creating new pages
- 3 Tips for working with page templates
- 4 See also
What is a page template?[edit | edit source]
BlueSpicePageTemplates offers creating new pages using predefined templates to set basic page structure.
Usage[edit | edit source]



A page template allows you to apply a predefined content structure to new pages. Thus, certain page types can be created, which are initially always the same structure. This is especially useful for frequently used content formats such as logs, reference pages, product descriptions, or short manuals. When a page is created with a page template, the page becomes "detached" from the original page template. This means that subsequent changes to the template will not affect pages that have originally been created with that page template. This distinguishes page templates from regular templates.
Characteristics[edit | edit source]
Every page template depends on an actual page in namespace Template (NS_TEMPLATE) to provide the content that will be inserted into new pages when created using this page template. This must exist before creating a page template.
Creating page templates- Listed as template choices when a page is created
- Create an independent new page with pre-filled content
- Based on templates in the Template namespaces
Creating a page template[edit | edit source]
Wiki admins can create new page templates, as well as edit and remove existing ones in the Page template templates manager. It is located in the left navigation, in , located under "Global actions" tab, under "Management" section. From here, when selected, page template can be edited by clicking on the "wrench" icon, or deleted by clicking on the "X" icon. New templates can be created using .Note: Every page template depends on an actual page in the namespace Template. This template must exist before creating a page template.
A new page template can be created by clicking the "Plus" button above the template list.
Template fields[edit | edit source]
When creating or editing a page template, the following information need needs to be inserted. provided:- Name - the name of the template
- Description - a short description of the template
- Namespace - list of the namespace where using this template will be offeredthe template is active
- Template - page from the Template namespace from which to pull the data from
Using page templates
when creating new pages[edit | edit source]
Once the page template can be saved, it can be used new pages in namespaces that the template is set for. List of availble templates to choose from will appear when creating new page,Tips for working with page templates[edit | edit source]
- PageTemplates are particularly good for designing structures for minutes and logs, but they are also excellent for typical business or product data for marketing, sales and product management.
See also[edit | edit source]
Reference page for this extension. that is transcluded from the actual template page.
Related info
- Reference:BlueSpicePageTemplates
<bs:bookshelf src="Book:User manual" /> __TOC__ ==What is BlueSpicePageTemplates?== '''BlueSpicePageTemplates''' offers creating new pages using predefined templates to set basic page structure. ==Usage== [[File:PageTemplates1a.png|thumb|Page template manager]] [[File:PageTemplates2.png|thumb|Editing a template in the Page template manager]] [[File:PageTemplates3a.png|thumb|Available page templates when creating a new page]] ===Creating template pages=== Every page template depends on an actual page in namespace Template (NS_TEMPLATE) to provide the content that will be inserted into new pages when created using this page template. This must exist before creating a page template. ===Creating page templates=== {{DISPLAYTITLE:Page template}} ==What is a page template?== A page template allows you to apply a predefined content structure to new pages. Thus, certain page types can be created, which are initially always the same structure. This is especially useful for frequently used content formats such as logs, reference pages, product descriptions, or short manuals. When a page is created with a page template, the page becomes "detached" from the original page template. This means that subsequent changes to the template will not affect pages that have originally been created with that page template. This distinguishes page templates from regular [[templates]]. ==Characteristics== *Listed as template choices when a page is created *Create an independent new page with pre-filled content *Based on templates in the ''Template'' namespaces ==Creating a page template== [[File:PageTemplates1a.png|thumb|Page template manager]]Wiki admins can create new page templates, as well as edit and remove existing ones in the Page templatetemplates manager. It is located in the left navigation, in "Global actions" tab, under "Management" section. From here, when selected, page template can be edited by clicking on the "wrench" icon, or deleted by clicking on the "X" icon. New templates can be created using , located under "Global actions".{{Box Note|boxtype=note|Note text=Every page template depends on an actual page in the namespace Template. This template must exist before creating a page template.}} A new page template can be created by clicking the "Plus" button above the template list. ===Template fields=== [[File:PageTemplates2.png|thumb|Editing a template in the Page template manager]]When creating or editing a page template, the following information needneeds to be inserted. * provided: *'''Name''' - the name of the template * '''Description''' - a short description of the template * '''Namespace''' - list of the namespace where using this the template will be offered * is active *'''Template''' - page from the Template namespace from which to pull the data from === ==Using page templates when creating new pages=== Once the page template can be saved, it can be used when creating new pages in namespaces that the template is set for. List of availble templates to choose from will appear when creating new page, == [[File:PageTemplates3a.png|thumb|Available page templates when creating a new page]]A list of available templates appears when a user creates a new page. It is shown below the "Empty page" default template. Selecting one of these page templates will create the new page that is prefilled with the content of the page in Template namespace that choosen page template is related to. ==Tips for working with page templates== * PageTemplates are particularly good for designing structures for minutes and logs, but they are also excellent for typical business or product data for marketing, sales and product management. ==See also== [[Reference:PageTemplates|Reference page]] for this extension. {{Translation}}that is transcluded from the actual template page. {{Box Links-en|Topic1=Reference:BlueSpicePageTemplates|Reference:BlueSpicePageTemplates}} [[en:{{PAGENAME}}]][[de:Handbuch:Erweiterung/BlueSpicePageTemplates]]
Line 1: | Line 1: | ||
− | + | {{DISPLAYTITLE:Page template}} | |
− | + | ==What is a page template?== | |
− | + | A page template allows you to apply a predefined content structure to new pages. Thus, certain page types can be created, which are initially always the same structure. This is especially useful for frequently used content formats such as logs, reference pages, product descriptions, or short manuals. When a page is created with a page template, the page becomes "detached" from the original page template. This means that subsequent changes to the template will not affect pages that have originally been created with that page template. This distinguishes page templates from regular [[templates]]. | |
− | + | ==Characteristics== | |
− | + | *Listed as template choices when a page is created | |
− | + | *Create an independent new page with pre-filled content | |
− | + | *Based on templates in the ''Template'' namespaces | |
− | |||
− | + | ==Creating a page template== | |
− | + | [[File:PageTemplates1a.png|thumb|Page template manager]]Wiki admins can create new page templates, as well as edit and remove existing ones in the Page templates manager, located under "Global actions".{{Box Note|boxtype=note|Note text=Every page template depends on an actual page in the namespace Template. This template must exist before creating a page template.}} | |
− | + | A new page template can be created by clicking the "Plus" button above the template list. | |
− | |||
− | |||
− | |||
− | Wiki admins can create new page templates, as well as edit and remove existing ones in Page | ||
− | |||
− | |||
− | |||
===Template fields=== | ===Template fields=== | ||
− | When creating or editing a page template, following information | + | [[File:PageTemplates2.png|thumb|Editing a template in the Page template manager]]When creating or editing a page template, the following information needs to be provided: |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
+ | *'''Name''' - the name of the template | ||
+ | *'''Description''' - a short description of the template | ||
+ | *'''Namespace''' - list of the namespace where the template is active | ||
+ | *'''Template''' - page from the Template namespace from which to pull the data | ||
− | |||
− | + | ==Using page templates== | |
+ | [[File:PageTemplates3a.png|thumb|Available page templates when creating a new page]]A list of available templates appears when a user creates a new page. It is shown below the "Empty page" default template. Selecting one of these page templates will create the new page that is prefilled with the content that is transcluded from the actual template page. | ||
− | |||
− | + | {{Box Links-en|Topic1=Reference:BlueSpicePageTemplates|Reference:BlueSpicePageTemplates}} | |
− | {{ | + | [[en:{{PAGENAME}}]][[de:Handbuch:Erweiterung/BlueSpicePageTemplates]] |