source/text/shared/guide/template_manager.xhp | 151 +++++++++++++++++++------- 1 file changed, 112 insertions(+), 39 deletions(-)
New commits: commit ef042f162e7403d0afb776b2efe81590e5242012 Author: Seth Chaiklin <[email protected]> AuthorDate: Fri Dec 11 12:47:28 2020 +0100 Commit: Olivier Hallot <[email protected]> CommitDate: Wed Jan 6 20:42:22 2021 +0100 tdf#107229 update help page for template manager ( shared/guide/template_manager.xhp ) + variable to <h1> for embedding into Related Topics + add "Thumbnail View" and "List View" and associated icon tables - remove <note>, which only repeats the information in <howtoget> + add missing "you" in introduction + add "Presentations" to filter list and XML markup to paragraph + add "All Categories" to Category list and XML markup to paragraph * spelling correction "defaults" -> "default" * improve explanation in <tip> about adding folders to Template path and XML markup in paragraph * change "Settings button" to "Settings icon" to be consistent with the "Settings" section; add "Reset Default Template" option and explanation. + add "Rename Category" to Settings submenu, and add XML markup + Add icon tables for "Setting", "Import", "Export", "Extensions" - Remove "tip" that only says "Refer to standard template" (which was included in original version from 2017. Same link is already included in Related topics. * Correct label from "Browse templates online" --> "Extensions" * updated description for searching for templates online * templates.libreoffice.org --> extensions.libreoffice.org. Because tags are curated on that website, have added the tag for templates to the URL. (changed in two places) + add explanations about how to select multiple templates for "Move" and "Export", thereby implying that batch operations are possible. + add tip with sys-switch about shortcut key to select all in connection with "Move" and "Export" + Add <h2> heading before context menu items * Change context menu item headings from <h2> to <h3> * change "Delete" explanation to indicate that multiple templates can be deleted, and add XML markup + Add <note> that builtin templates cannot be edited, renamed, or deleted * correction to Example 1 about selecting/opening templates * correct reference to icon in Example 2 and add period. * change (e.g.,) to "for example" in Example 2 * Reworked Example 3 from "negative" formulation to "positve" statement of what can be used, and then note that unavailable features can be accessed by restarting Template Manager. Change-Id: Ie53d865545a78224bcd018928667edd33e4b51dc Reviewed-on: https://gerrit.libreoffice.org/c/help/+/107549 Tested-by: Jenkins Reviewed-by: Olivier Hallot <[email protected]> diff --git a/source/text/shared/guide/template_manager.xhp b/source/text/shared/guide/template_manager.xhp index 9d6a16f9b..8a4037178 100644 --- a/source/text/shared/guide/template_manager.xhp +++ b/source/text/shared/guide/template_manager.xhp @@ -27,7 +27,6 @@ <body> - <section id="template_manager"> <bookmark xml-lang="en-US" branch="hid/sfx/ui/templatedlg/@@nowidget@@" id="bm_@@nowidget@@" localize="false"/> <bookmark xml-lang="en-US" branch="hid/sfx/ui/templatedlg/TemplateDialog" id="bm_id041620170649376934" localize="false"/> @@ -41,9 +40,8 @@ <bookmark_value>templates;template manager</bookmark_value> </bookmark> - -<h1 id="hd_id041620170649101471"><link href="text/shared/guide/template_manager.xhp">Manage Templates</link></h1> -<paragraph id="par_id04162017064929216" role="paragraph" xml-lang="en-US"><ahelp hid=".">The Template Manager dialog makes it easy to manage templates and allows to start new documents using templates.</ahelp></paragraph> +<h1 id="hd_id041620170649101471"><variable id="manage_templates"><link href="text/shared/guide/template_manager.xhp">Manage Templates</link></variable></h1> +<paragraph id="par_id04162017064929216" role="paragraph" xml-lang="en-US"><ahelp hid=".">The Template Manager dialog makes it easy to manage templates and allows you to start new documents using templates.</ahelp></paragraph> </section> <section id="howtoget"> @@ -56,61 +54,136 @@ <paragraph id="par_id041620170723502887" role="paragraph" xml-lang="en-US">Templates save editing time by starting new documents with pre-filled contents and formatting. The Template Manager allows you to access and organize templates in %PRODUCTNAME.</paragraph> <paragraph id="par_id041620170753116381" role="paragraph" xml-lang="en-US">%PRODUCTNAME comes with a set of built-in templates that can be used to create documents, presentations, spreadsheets or drawings. You may use templates available in the template manager, create your own templates or browse online for additional templates.</paragraph> -<note id="par_id041620170723504381">If you have opened the %PRODUCTNAME start center and have not yet opened a document or application, the Template Manager may be accessed differently. <keycode>Ctrl-Shift-N</keycode> will still open the Template Manager, but it may also be accessed by choosing Templates from the left sidebar, and then choosing Manage Templates.</note> <h2 id="hd_id041620170723509935">Main Window – Template Choices</h2> <paragraph id="par_id041620170723507192" role="paragraph" xml-lang="en-US">Previews of available templates show up in the main window based on your search and filtering choices. Double-click on any template icon to open a new document with the contents and formatting of the template.</paragraph> +<paragraph role="paragraph" id="par_id921608024342429">Choose <emph>Thumbnail View</emph> or <emph>List View</emph>, at the top right, to change how the templates are displayed.</paragraph> +<table id="tab_id401608024074350"> + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id191608024074350"> +<image src="svx/res/galicon.png" id="img_id461608024074350" width="1cm" height="1cm"><alt id="alt_id211608024074350">Thumbnail View Icon</alt></image> + </paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id301608024074351" role="paragraph">Thumbnail View</paragraph> + </tablecell> + </tablerow> +</table> +<table id="tab_id121608024086461"> + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id61608024086461"> +<image src="svx/res/gallist.png" id="img_id461608024086461" width="1cm" height="1cm"><alt id="alt_id361608024086461">List View Icon</alt></image> + </paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id891608024086461" role="paragraph">Listview</paragraph> + </tablecell> + </tablerow> +</table> <bookmark xml-lang="en-US" branch="hid/sfx/ui/templatedlg/search_filter" id="bm_id041620170649376935" localize="false"/> <h2 id="hd_id041620170723501731">Search</h2> -<paragraph id="par_id041620170723505410" role="paragraph" xml-lang="en-US"><ahelp hid=".">You may search for a template by entering text in the search box at the top left. The Main window show the templates found.</ahelp></paragraph> +<paragraph id="par_id041620170723505410" role="paragraph" xml-lang="en-US"><ahelp hid=".">You may search for a template by entering text in the search box at the top left. The Main window shows the templates found.</ahelp></paragraph> <bookmark xml-lang="en-US" branch="hid/sfx/ui/templatedlg/filter_application" id="bm_id041620170649376936" localize="false"/> <h2 id="hd_id041620170723509978">Filter</h2> -<paragraph id="par_id041620170723507575" role="paragraph" xml-lang="en-US"><ahelp hid=".">You may filter for All Applications, Documents, Spreadsheets or Drawings by choosing an option from the dropdown box at the top-center. The main window displays the filtered templates.</ahelp></paragraph> +<paragraph id="par_id041620170723507575" role="paragraph" xml-lang="en-US"><ahelp hid=".">You may filter for: All Applications, Text Documents, Spreadsheets, Presentations or Drawings by choosing an option from the dropdown box at the top-center. The main window displays the filtered templates.</ahelp></paragraph> <bookmark xml-lang="en-US" branch="hid/sfx/ui/templatedlg/filter_folder" id="bm_id041620170649376937" localize="false"/> <h2 id="hd_id041620170723509321">Categories</h2> -<paragraph id="par_id041620170723507710" role="paragraph" xml-lang="en-US"><ahelp hid=".">Categories are folders where you place your templates.</ahelp> You may choose from the defaults categories My Templates, Business Correspondence, MediaWiki, Other Business Documents, Personal Correspondence and Documents, Presentations, or Styles. You may create new categories for your personal use. Use the Settings button of the Template Manager to create a new category.</paragraph> +<paragraph id="par_id041620170723507710" role="paragraph" xml-lang="en-US"><ahelp hid=".">Categories are folders where you place your templates.</ahelp> You may choose from the default categories: All Categories, My Templates, Business Correspondence, MediaWiki, Other Business Documents, Personal Correspondence and Documents, Presentations or Styles. You may also create new categories for your personal use. Use the <emph>Settings</emph> icon of the Template Manager to create a new category.</paragraph> <note id="par_id041620170946429148">Categories inside a category are not allowed.</note> - -<note id="par_id3155306">To add the templates in another folder to the <emph>My Templates</emph> category, choose <switchinline select="sys"><caseinline select="MAC">%PRODUCTNAME - Preferences</caseinline><defaultinline>Tools - Options</defaultinline></switchinline> - <link href="text/shared/optionen/01010300.xhp" name="$[officename] - Paths"><emph>$[officename] - Paths</emph></link>, and then enter the path.</note> +<note id="par_id3155306">To add templates from another folder to the <emph>My Templates</emph> category, choose <switchinline select="sys"><caseinline select="MAC"><menuitem>%PRODUCTNAME - Preferences - </menuitem></caseinline><defaultinline><menuitem>Tools - Options - </menuitem></defaultinline></switchinline><link href="text/shared/optionen/01010300.xhp" name="$[officename] - Paths"><menuitem>$[officename] - Paths</menuitem></link>, select <emph>Templates</emph>, press <widget>Edit</widget>, then press <widget>Add</widget> to open the file dialog for selecting the folder to add.</note> <bookmark xml-lang="en-US" branch="hid/sfx/ui/templatedlg/action_menu" id="bm_id041620170649376938" localize="false"/> <h2 id="hd_id041620170723509814">Settings</h2> -<paragraph id="par_id041620170723504497" role="paragraph" xml-lang="en-US"><ahelp hid=".">Click on the Settings icon at the bottom left to open the Settings menu.</ahelp> The options are create a New Category, Delete Category or Refresh. If a default template for new documents has been changed, an additional option to reset the factory default template is available.</paragraph> +<paragraph id="par_id041620170723504497" role="paragraph" xml-lang="en-US"><ahelp hid=".">Click on the <emph>Settings</emph> icon at the bottom left to open the Settings menu.</ahelp> The options are: New Category, Rename Category, Delete Category, and Refresh. If the default template for an application is changed from the initial default setting, then an additional option, Reset Default Template, is available, which allows you to reset the default template for an application back to its initial default.</paragraph> +<table id="tab_id41604581209745"> + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id816947600309745"> +<image src="sfx2/res/actionaction013.png" id="img_id381604426509745" width="1cm" height="1cm"><alt id="alt_id13162474009745">Settings Icon</alt></image> + </paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id421604400309745" role="paragraph">Settings icon</paragraph> + </tablecell> + </tablerow> +</table> -<bookmark xml-lang="en-US" branch="hid/sfx/ui/templatedlg/online_link" id="bm_id041620170649376939" localize="false"/> -<h2 id="hd_id041620170723501627">Browse Online Templates</h2> -<paragraph id="par_id041620170723503494" role="paragraph" xml-lang="en-US"><ahelp hid=".">To browse for more templates online, click on the Browse online templates icon at bottom left to open a browser window and search for templates at <link href="https://templates.libreoffice.org";>https://templates.libreoffice.org</link>.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/sfx/ui/templatedlg/move_btn" id="bm_id041620170649376940" localize="false"/> +<h2 id="hd_id041620170723508845">Move</h2> +<paragraph id="par_id041620170723518776" role="paragraph" xml-lang="en-US"><ahelp hid=".">If you want to move templates to a different category, then choose a template, or use <keycode>Ctrl+click</keycode> to select additional templates, then press the <widget>Move</widget> button at the bottom right to open a dialog box, where you can choose to move your selection to a different category or to a new category. Default templates cannot be moved, but copies can be created in other categories.</ahelp></paragraph> + +<bookmark xml-lang="en-US" branch="hid/sfx/ui/templatedlg/export_btn" id="bm_id041620170649376941" localize="false"/> +<h2 id="hd_id041620170723516791">Export</h2> +<paragraph id="par_id041620170723513192" role="paragraph" xml-lang="en-US"><ahelp hid=".">Choose a template in the main window, or use <keycode>Ctrl+click</keycode> to select additional templates, and then press the <widget>Export</widget> button at the bottom right to export your selection to a folder on your computer.</ahelp></paragraph> +<table id="tab_id31607689509896"> + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id181607689509896"> +<image src="sfx2/res/actiontemplates020.png" id="img_id171607689509896" width="1cm" height="1cm"><alt id="alt_id541607689509896">Export Icon</alt></image> + </paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id431607689509896" role="paragraph">Export button</paragraph> + </tablecell> + </tablerow> +</table> +<tip id="par_id581607995218423">To move or export all templates in a <emph>Category</emph>, press <switchinline select="sys"><caseinline select="MAC"><keycode>Command</keycode></caseinline><defaultinline><keycode>Ctrl</keycode></defaultinline></switchinline><keycode>+A</keycode>, then choose <emph>Move</emph> or <emph>Export</emph>.</tip> +<bookmark xml-lang="en-US" branch="hid/sfx/ui/templatedlg/import_btn" id="bm_id041620170649376942" localize="false"/> +<h2 id="hd_id041620170723516279">Import</h2> +<paragraph id="par_id04162017072351776" role="paragraph" xml-lang="en-US"><ahelp hid=".">Press the Import button at the bottom right, and then choose a Category to import a template from your computer to that category in the Template Manager.</ahelp></paragraph> +<table id="tab_id901607689516048"> + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id171607689516049"> +<image src="sfx2/res/actionview010.png" id="img_id201607689516049" width="1cm" height="1cm"><alt id="alt_id71607689516049">Import Icon</alt></image> + </paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id651607689516049" role="paragraph">Import button</paragraph> + </tablecell> + </tablerow> +</table> -<h2 id="hd_id041620170723503949">Open</h2> +<bookmark xml-lang="en-US" branch="hid/sfx/ui/templatedlg/online_link" id="bm_id041620170649376939" localize="false"/> +<h2 id="hd_id041620170723501627">Extensions</h2> +<paragraph id="par_id041620170723503494" role="paragraph" xml-lang="en-US"><ahelp hid=".">To browse for more templates online, click on the Extensions icon at the bottom right to open a search window. You can also search for templates at <link href="https://extensions.libreoffice.org/?Tags%5B%5D=118";>https://extensions.libreoffice.org</link>.</ahelp></paragraph> +<table id="tab_id941607690468509"> + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id431607690468509"> +<image src="cmd/lc_additionsdialog.png" id="img_id461607690468509" width="1cm" height="1cm"><alt id="alt_id891607690468509">Extensions Icon</alt></image> + </paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id41607690468510" role="paragraph">Extensions icon</paragraph> + </tablecell> + </tablerow> +</table> + +<h2 id="hd_id501607689762479">Actions with Individual Templates</h2> + +<h3 id="hd_id041620170723503949">Open</h3> <paragraph id="par_id041620170723503583" role="paragraph" xml-lang="en-US">Select a template in the main window and right-click and then choose Open, press Enter or double click to open a new document using that template.</paragraph> +<paragraph role="paragraph" id="par_id721608222737939">You can also use the <widget>Open</widget> button on the bottom left to open a new document using the selected template.</paragraph> -<h2 id="hd_id041620170723504268">Edit</h2> +<h3 id="hd_id041620170723504268">Edit</h3> <paragraph id="par_id041620170723502297" role="paragraph" xml-lang="en-US">Select a template in the main window and right-click and then choose Edit to edit the template. This function is only available for templates that are not built-in.</paragraph> -<h2 id="hd_id041620170723509251">Set as Default</h2> +<h3 id="hd_id041620170723509251">Set as Default</h3> <paragraph id="par_id041620170723501975" role="paragraph" xml-lang="en-US">Select a template in the main window and right-click and then choose Set as Default to set the template as the default template. This will cause a green tick to appear over the template and the template will automatically load when a new document is created using the matching application.</paragraph> -<tip id="par_id041620171037534321">Refer to the <link href="text/shared/guide/standard_template.xhp">Standard Template</link></tip> -<h2 id="hd_id041620170723508003">Rename</h2> +<h3 id="hd_id041620170723508003">Rename</h3> <paragraph id="par_id041620170723509003" role="paragraph" xml-lang="en-US">Select a template in the main window and right-click and then choose Rename to rename the template. This will cause a dialog box to appear where a new name may be chosen for the template. Type in the name and then choose OK or choose Cancel to revert to the name that is already set.</paragraph> -<h2 id="hd_id041620170723508658">Delete</h2> -<paragraph id="par_id041620170723504317" role="paragraph" xml-lang="en-US">Select a template in the main window and press the delete button, or right-click then choose Delete to delete the template. A dialog box will appear requesting confirmation. Choose Yes to delete or No to cancel.</paragraph> - -<bookmark xml-lang="en-US" branch="hid/sfx/ui/templatedlg/move_btn" id="bm_id041620170649376940" localize="false"/> -<h2 id="hd_id041620170723508845">Move</h2> -<paragraph id="par_id041620170723518776" role="paragraph" xml-lang="en-US"><ahelp hid=".">Choose the Move option at the bottom right after selecting a template to move it to a different category. Default templates cannot be moved, but copies can be created in other categories.</ahelp></paragraph> +<h3 id="hd_id041620170723508658">Delete</h3> +<paragraph id="par_id041620170723504317" role="paragraph" xml-lang="en-US">Select one or more templates to delete in the main window and press the <keycode>Delete</keycode> key, or right-click then choose <menuitem>Delete</menuitem> to delete the selected template(s). A dialog box will appear requesting confirmation. Choose <widget>Yes</widget> to delete or <widget>No</widget> to cancel.</paragraph> -<bookmark xml-lang="en-US" branch="hid/sfx/ui/templatedlg/export_btn" id="bm_id041620170649376941" localize="false"/> -<h2 id="hd_id041620170723516791">Export</h2> -<paragraph id="par_id041620170723513192" role="paragraph" xml-lang="en-US"><ahelp hid=".">Choose a template in the main window and then press the Export button at the bottom right to export the template to a folder on your computer.</ahelp></paragraph> - -<bookmark xml-lang="en-US" branch="hid/sfx/ui/templatedlg/import_btn" id="bm_id041620170649376942" localize="false"/> -<h2 id="hd_id041620170723516279">Import</h2> -<paragraph id="par_id04162017072351776" role="paragraph" xml-lang="en-US"><ahelp hid=".">Press the Import button at the bottom right, and then choose a Category to import a template from your computer to that category in the Template Manager.</ahelp></paragraph> +<note id="par_id141607690272821">Built-in templates cannot be edited, renamed or deleted.</note> <h2 id="hd_id041620170723515107">Examples</h2> @@ -127,7 +200,7 @@ <paragraph id="par_id041620170723513600" role="ol_item" xml-lang="en-US">Type “business letter” into the search box</paragraph> </listitem> <listitem> - <paragraph id="par_id041620170723518765" role="ol_item" xml-lang="en-US">Choose one of the templates from the main window by double-clicking on it or pressing tab to select and then Enter</paragraph> + <paragraph id="par_id041620170723518765" role="ol_item" xml-lang="en-US">Choose one of the templates from the main window by double-clicking on it or select and press <keycode>Enter</keycode>.</paragraph> </listitem> <listitem> <paragraph id="par_id041620170723511456" role="ol_item" xml-lang="en-US">A new document using that template is created in a new instance of %PRODUCTNAME Writer</paragraph> @@ -147,7 +220,7 @@ <paragraph id="par_id041620170723518639" role="ol_item" xml-lang="en-US">Press <switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+Shift+N or choose <emph>File - New - Templates</emph> to open the Template Manager</paragraph> </listitem> <listitem> - <paragraph id="par_id041620170723512689" role="ol_item" xml-lang="en-US">Click on the world icon to browse for online templates</paragraph> + <paragraph id="par_id041620170723512689" role="ol_item" xml-lang="en-US">Click on the Extensions icon to browse for online templates.</paragraph> </listitem> <listitem> <paragraph id="par_id041620170723511300" role="ol_item" xml-lang="en-US">Search for the Personal Budget Template, then download it</paragraph> @@ -156,7 +229,7 @@ <paragraph id="par_id041620170723514055" role="ol_item" xml-lang="en-US">Open Template Manager and choose the Import button</paragraph> </listitem> <listitem> - <paragraph id="par_id041620170723513485" role="ol_item" xml-lang="en-US">Select a category to save the new template in (e.g. My Templates) and press OK</paragraph> + <paragraph id="par_id041620170723513485" role="ol_item" xml-lang="en-US">Select a category to save the new template in, for example, <emph>My Templates</emph>, and press <widget>OK</widget>.</paragraph> </listitem> <listitem> <paragraph id="par_id041620170723513541" role="ol_item" xml-lang="en-US">Browse to the folder where you downloaded the template, select it and press Open</paragraph> @@ -179,10 +252,10 @@ <paragraph id="par_id041620170723525963" role="ol_item" xml-lang="en-US">Choose a template for your presentation, filter by categories or search</paragraph> </listitem> <listitem> - <paragraph id="par_id041620170723523510" role="ol_item" xml-lang="en-US">Additional features are unavailable, and you may only select a template, filter, or import.</paragraph> + <paragraph id="par_id041620170723523510" role="ol_item" xml-lang="en-US">You may also use the context menu, import a template, or search online for a template.</paragraph> </listitem> <listitem> - <paragraph id="par_id041620170723525323" role="ol_item" xml-lang="en-US">After starting %PRODUCTNAME Impress you may run the Template Manager again to access additional features.</paragraph> + <paragraph id="par_id041620170723525323" role="ol_item" xml-lang="en-US">A few features in the Template Manager are not available when first opened automatically. After starting %PRODUCTNAME Impress you may run the Template Manager again to access all features.</paragraph> </listitem> </list> <tip id="par_id041620170723521916">Make use of categories to organize your templates. Create new templates or download templates and organize in the Template Manager. Use templates to save time for repetitive documents.</tip> @@ -190,8 +263,8 @@ <section id="relatedtopics"> <paragraph id="par_id04162017072352773" role="paragraph" xml-lang="en-US">See <link href="text/swriter/guide/templates_styles.xhp">Templates and Styles</link> for related information.</paragraph> <paragraph id="par_id041620170723523966" role="paragraph" xml-lang="en-US">See <link href="text/swriter/guide/standard_template.xhp">Creating a Document Template</link> for related information.</paragraph> -<paragraph id="par_id04162017072352674" role="paragraph" xml-lang="en-US">See Chapter 3 – Using Styles and Templates in the Getting Started Guide, available from the <link href="https://documentation.libreoffice.org/en/english-documentation/getting-started-guide/";>documentation website</link>.</paragraph> -<paragraph id="par_id041620170723529524" role="paragraph" xml-lang="en-US">Refer to <link href="https://templates.libreoffice.org";>https://templates.libreoffice.org</link> for templates to download.</paragraph> +<paragraph id="par_id04162017072352674" role="paragraph" xml-lang="en-US">See Chapter 3 – Using Styles and Templates in the <link href="https://documentation.libreoffice.org/en/english-documentation/getting-started-guide/";>Getting Started Guide</link>.</paragraph> +<paragraph id="par_id041620170723529524" role="paragraph" xml-lang="en-US">Refer to <link href="https://extensions.libreoffice.org/?Tags%5B%5D=118";>https://extensions.libreoffice.org</link> for templates to download.</paragraph> </section> </body> _______________________________________________ Libreoffice-commits mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/libreoffice-commits
