Files
help/source/text/shared/guide/standard_template.xhp
Ilmari Lauhakangas 7e42394ecb tdf#152323 drop name attribute from <link> elements
Replacement done with

find . -name \*.xhp -print0 |xargs -0 -P 0 perl -CS -pi -e \
        's#(<link[^>]*?) +name *="[^"]*" *( [^>]+|) *>#$1$2>#g'

(note some inconsistencies with space between name and = and also having
empty value, and some more complicated expression to also clear up
double space before/after the attribute)

translation files will be prepped with:

find */helpcontent2 -name \*.po -print0 |xargs -0 -P 0 perl -CS -pi -e \
    $'s#(<link[^>]*?) +name=(?:\\\\"[^"]*\\\\"|\'[^\']*\') *( [^>]+|) *(/?>)#$1$2$3#g unless /^#/'

(note that not all languages use the " as quote character for the
attributes, but that also single quotes appera in the po file. Hence
the use of the shell $'string' syntax to be able to quote ' as \'
It also requires to quote the backslash, so that it needs to be escaped
once for the shell, then another time for perl. Also don't work on
obsolete strings (those are prefixed with #~ in the po files)
Also note that <link..></link> gets turned into <link ../> during
translation extraction (along with removal of the space between the
attribute name and the value), so the pattern needs to be slightly
different here)

Change-Id: I95e53a08e6b0095cd894109ea0de154cc4859d8f
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/143713
Tested-by: Jenkins
Reviewed-by: Christian Lohmaier <lohmaier+LibreOffice@googlemail.com>
2022-12-07 17:39:02 +00:00

138 lines
8.3 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<!--
* This file is part of the LibreOffice project.
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*
* This file incorporates work covered by the following license notice:
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed
* with this work for additional information regarding copyright
* ownership. The ASF licenses this file to you under the Apache
* License, Version 2.0 (the "License"); you may not use this file
* except in compliance with the License. You may obtain a copy of
* the License at http://www.apache.org/licenses/LICENSE-2.0 .
-->
<meta>
<topic id="textsharedguidestandard_templatexml" indexer="include" status="PUBLISH">
<title id="tit" xml-lang="en-US">Creating and Changing Default and Custom Templates</title>
<filename>/text/shared/guide/standard_template.xhp</filename>
</topic>
</meta>
<body>
<bookmark xml-lang="en-US" branch="index" id="bm_id3154285"><bookmark_value>modifying, see changing</bookmark_value>
<bookmark_value>changing, see also editing and replacing</bookmark_value>
<bookmark_value>default templates; changing</bookmark_value>
<bookmark_value>default templates; creating</bookmark_value>
<bookmark_value>defaults;documents</bookmark_value>
<bookmark_value>custom templates</bookmark_value>
<bookmark_value>updating; templates</bookmark_value>
<bookmark_value>editing;templates</bookmark_value>
<bookmark_value>templates;editing and saving</bookmark_value>
<bookmark_value>saving;templates</bookmark_value>
<bookmark_value>resetting;templates</bookmark_value>
</bookmark>
<h1 id="hd_id3154285" xml-lang="en-US"><variable id="standard_template"><link href="text/shared/guide/standard_template.xhp">Creating and Changing Default and Custom Templates</link>
</variable></h1>
<section id="text">
<paragraph role="paragraph" id="par_id3152811" xml-lang="en-US">When you open a new document with <emph>File - New</emph>, a blank document appears based on a $[officename] template. You can edit, modify, or replace this template so that the new document contains your customized Styles or other contents.</paragraph>
<note id="par_id3159152" xml-lang="en-US">You can define document templates for each $[officename] application.</note>
<h2 id="hd_id3150792" xml-lang="en-US">Creating a Default Template</h2>
<list type="ordered">
<listitem>
<paragraph role="listitem" id="par_id3154365" xml-lang="en-US"><variable id="create_template">First, open either an existing $[officename] template and modify it, or open a new document and edit it as necessary to create the desired template.</variable></paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" id="par_id3145748" xml-lang="en-US">Save the document by choosing <menuitem>File - Templates - Save as Template</menuitem>, then enter the template name, click the <emph>Set as default template</emph> checkbox, and save in the <emph>My Templates</emph> category.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" id="par_id3146901" xml-lang="en-US">The next time you open a new text document, the new document will be based on this new default template.</paragraph>
</listitem>
</list>
<h2 id="hd_id751605458425017">Modifying a Default Template</h2>
<list type="ordered">
<listitem>
<paragraph role="paragraph" id="par_id3154011" xml-lang="en-US"><variable id="edit_template">Choose <menuitem>File - Templates - Manage Templates</menuitem>.</variable></paragraph>
</listitem>
<listitem>
<paragraph id="par_id531605464645795" role="listitem">Use <emph>Filter</emph> to select the type of document.</paragraph>
</listitem>
<listitem>
<paragraph id="par_id981605464830645" role="listitem">The default template is marked with a green check mark. Right-click that template and choose <menuitem>Edit</menuitem>.</paragraph>
</listitem>
<listitem>
<paragraph id="par_id211605464919603" role="listitem"><variable id="save_template">Make desired changes, choose <menuitem>File - Save</menuitem>, and close the document.</variable></paragraph>
</listitem>
<listitem>
<paragraph id="par_id851605464921341" role="listitem">When you open a new document, the modified default template will be used.</paragraph>
</listitem>
</list>
<switch select="appl">
<case select="CALC"></case>
<case select="DRAW"></case>
<case select="IMPRESS">
<note id="par_id131605483428241">%PRODUCTNAME provides built-in presentation templates, which cannot be edited, renamed, or deleted. To modify a built-in presentation template, open a document using the template, modify, then save as a new template.</note>
</case>
<case select="WRITER">
<note id="par_id461605483905608">%PRODUCTNAME provides built-in templates for Writer, which cannot be edited, renamed, or deleted. To modify a built-in template, open a document using the template, modify, then save as a new template.</note>
</case>
<default>
</default>
</switch>
<h2 id="hd_id891605476755142">Setting a Template as Default</h2>
<list type="ordered">
<listitem>
<paragraph id="par_id501605476796634" role="listitem"><embedvar href="text/shared/guide/standard_template.xhp#edit_template"/></paragraph>
</listitem>
<listitem>
<paragraph id="par_id711605476873605" role="listitem">Right-click on template to be made default, choose <menuitem>Set as Default</menuitem>.</paragraph>
</listitem>
</list>
<h2 id="hd_id3153764" xml-lang="en-US">Creating a Custom Template</h2>
<list type="ordered">
<listitem>
<paragraph id="par_id231605475396242" role="listitem"><embedvar href="text/shared/guide/standard_template.xhp#create_template"/></paragraph>
</listitem>
<listitem>
<paragraph id="par_id251605475503009" role="listitem">Choose <menuitem>File - Templates - Save As Template</menuitem>, then enter the template name, choose a <emph>Template category</emph>, and save.</paragraph>
</listitem>
</list>
<h2 id="hd_id311605475738848">Modifying a Custom Template</h2>
<list type="ordered">
<listitem>
<paragraph id="par_id901605475822840" role="listitem"><embedvar href="text/shared/guide/standard_template.xhp#edit_template"/></paragraph>
</listitem>
<listitem>
<paragraph id="par_id51605476162735" role="listitem">Right-click on the template to be modified, and choose <menuitem>Edit</menuitem>.
</paragraph>
</listitem>
<listitem>
<paragraph id="par_id191605477448444" role="listitem"><embedvar href="text/shared/guide/standard_template.xhp#save_template"/></paragraph>
</listitem>
</list>
<h2 id="hd_id3149109" xml-lang="en-US">Saving a Template in the Template Folder</h2>
<paragraph role="paragraph" id="par_id3146918" xml-lang="en-US">You can save any document as a template by selecting "Template" file type in the Save dialog. To access the template from the Template Manager, save the template in the <emph>User Paths</emph> directory specified for <emph>Templates</emph> in <switchinline select="sys"><caseinline select="MAC"><menuitem>%PRODUCTNAME - Preferences</menuitem></caseinline><defaultinline><menuitem>Tools - Options</menuitem></defaultinline></switchinline><emph> - %PRODUCTNAME - Paths</emph>. It is often easier to save a document with <menuitem>File - Templates - Save As Template</menuitem>, because it automatically places the template in the appropriate directory.</paragraph>
<tip id="par_id271605485719890">The <link href="text/shared/guide/template_manager.xhp">Template Manager</link> is the preferred method for working with templates. <menuitem>File - New - Templates</menuitem> and <menuitem>File - Templates - Manage Templates</menuitem> are equivalent for opening the <emph>Template Manager</emph>. <switchinline select="sys"><caseinline select="MAC"><keycode>Command</keycode></caseinline><defaultinline><keycode>Ctrl</keycode></defaultinline></switchinline><keycode>+Shift+N</keycode> is the predefined shortcut key.</tip>
</section>
<section id="relatedtopics">
<switch select="appl">
<case select="WRITER">
<embed href="text/swriter/guide/templates_styles.xhp#templates_styles"/>
</case>
</switch>
<paragraph role="paragraph" id="par_id3147315" xml-lang="en-US"><link href="text/shared/01/01110000.xhp">Templates</link></paragraph>
</section>
</body>
</helpdocument>