Difference between revisions of "Manual:Extension/BlueSpicePageTemplates"

<bs:bookshelf src="Book:User manual" />
        
        
        
        __TOC__
        
        
        
        ==What is PageTemplates?==
            
            
            
            '''PageTemplates''' offer the possibility to select from predefined content structures (templates, eg content directory, blocks, layout, content elements) when creating a new page, thus creating uniformity for certain page types.
            
            
            
            ==How to create PageTemplates as an administrator?==
            
            
            
            If you have admin rights in the wiki, you can choose the page "Page Templates" in the user sidebar in the left hand navigation menu under "Admin". You will then be forwarded to the administration page. This allows you to define existing pages as templates in your wiki.
            
            
            
            ::: [[File:PgeTmlts1.jpg|500x313px]]
            
            
            
            Go to the management page '''PageTemplates''' via the '''Admin''' tab. You can see all the templates which already exist. You can edit or delete these. <br />The button [[File:Seitenvorlage_neu_anlegen.PNG]] lets you add new templates. 
            
            
            
            ::: [[File:PgeTmlts2.jpg|500x302px]]
            
            
            
            ::: [[File:PTemplates3.jpg|500x311px]]
            
            
            
            In the new window, you need to enter the following information:
            
            
            
            * '''Name''': Enter a name for your template.
            
            * '''Description''': A short description of your template.
            
            * '''Namespace''': In which namespaces the new template is to be used.
            
            * '''Namespace of the template''': The namespace of the page which you want to be used as the template.
            
            * '''Template''': The page you want to use at the template (filtered by the namespace of the template).
            
            
            
            After clicking "Ok" you will get:
            
            
            
            ::: [[File:PgeTmlts3.jpg|500x308px]]
            
            
            
            ::: [[File:PTemplates6a.jpg|500x309px]]
            
            
            
            Create template article, insert content you want to appear on the pages using this template. If, for example, an infobox is integrated, you will need to enter the wikicode view to enter the data.
            
            
            
            ::: [[File:PTemplates7.jpg|500x309px]]
            
            
            
            Save the article to see how your PageTemplate with all the content in it looks like:
            
            
            
            ::: [[File:PTemplates8.jpg|500x296px]]
            
            
            
            ==How to use PageTemplates?==
            
            
            
            If you are an author in the wiki creating a new article you will see the template view. You can choose a fitting template from those which already exist. 
            
            
            
            The selection of page templates you have available as a user depends on various factors.
            
            
            
            * The page template "empty page" is always available
            
            * Page templates for particular namespaces are only available when creating a new page in that namespace
            
            * Page templates for all namespaces are available for all new pages
            
            
            
            Templates can contain a list of contents, blocks, a particular layout or specific elements of content.
            
            
            
            After choosing the template your new page will be preloaded with the contents of Template:Standard Article page.
            
            
            
            
        BlueSpicePageTemplates?==
            
            
            
            '''BlueSpicePageTemplates''' offers creating new pages using predefined templates to set basic page structure.
            
            
            
            [[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]]
            
            ==Usage==
            
            
            
            ===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.
            
            Therefore, before creating a page template.
            
            
            
            ===Creating page templates===
            
            
            
            Wiki admins can create new page templates, as well as edit and remove existing ones in Page template 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 the "Plus" button above the template list.
            
            
            
            ===Template fields===
            
            
            
            When creating or editing a page template, following information need to be inserted.
            
            
            
            * '''Name''' - the name of the template
            
            * '''Description''' - a short description of the template
            
            * '''Namespace''' - list of namespace where using this template will be offered
            
            * '''Template''' - page from the Template namespace 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, 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.
        
        
        * If you use the BlueSpice package <nowiki>[bookmaker]</nowiki> to create online manuals, page templates can safe a lot of time for you. Create a page template for articles in a manual including the fitting "Bookshelf-tag". So you don't have to copy the chapter navigation into every single article.
            
            
            
            ==Classical PageTemplates with MediaWiki==
            
            
            
            PageTemplates can also be manually embedded in wikis without page template manager. The prerequisite is that the wiki has the extension ''PageTemplates''.
            
            
            
            ==See also==
            
            
            
            Our [[Reference:PageTemplates|reference page.]]
            
            
            
            {{Box_Links-en | Thema1 =[[Create_new_articles|Create new article]] | Thema2 =[[Reference:NamespaceCss|Change style of single namespaces]] | Thema3 =[[Bookmaker|Structure of a book in the Wiki]] | Thema4 = }}
            
            ==See also==
            
            
            
            [[Reference:PageTemplates|Reference page]] for this extension.