[Libreoffice-commits] help.git: AllLangHelp_shared.mk help3xsl/index2.html help3xsl/online_transform.xsl source/text
Libreoffice Gerrit user
logerrit at kemper.freedesktop.org
Thu Aug 23 19:15:21 UTC 2018
AllLangHelp_shared.mk | 1
help3xsl/index2.html | 2
help3xsl/online_transform.xsl | 2
source/text/shared/05/new_help.xhp | 131 +++++++++++++++++++++++++++++++++++++
4 files changed, 134 insertions(+), 2 deletions(-)
New commits:
commit f39dae6ac2f4e5d0fa8eed19595c118f20d59ee5
Author: Olivier Hallot <olivier.hallot at libreoffice.org>
AuthorDate: Wed Aug 22 17:39:37 2018 -0300
Commit: Olivier Hallot <olivier.hallot at libreoffice.org>
CommitDate: Thu Aug 23 21:15:00 2018 +0200
Add help pages for new Help
Exlplain the new browser-based help system and user interface.
Change-Id: I418b5fe148661a40b4e0291776ac43f4f207743e
Reviewed-on: https://gerrit.libreoffice.org/59472
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot at libreoffice.org>
diff --git a/AllLangHelp_shared.mk b/AllLangHelp_shared.mk
index dbee24f06..7a97be4bc 100644
--- a/AllLangHelp_shared.mk
+++ b/AllLangHelp_shared.mk
@@ -514,6 +514,7 @@ $(eval $(call gb_AllLangHelp_add_helpfiles,shared,\
helpcontent2/source/text/shared/05/00000140 \
helpcontent2/source/text/shared/05/00000150 \
helpcontent2/source/text/shared/05/00000160 \
+ helpcontent2/source/text/shared/05/new_help \
helpcontent2/source/text/shared/05/err_html \
helpcontent2/source/text/shared/06/youtubevideos \
helpcontent2/source/text/shared/06/svx_screenshots \
diff --git a/help3xsl/index2.html b/help3xsl/index2.html
index 12c7711c4..503e6d149 100644
--- a/help3xsl/index2.html
+++ b/help3xsl/index2.html
@@ -58,7 +58,7 @@
var system = 'WIN';
if (navigator.userAgent.indexOf("Mac") != -1) system = 'MAC';
if (navigator.userAgent.indexOf("Linux") != -1) system = 'UNIX';
- window.location.href = existingLang(navigator.language) + '/text/shared/main0108.html?&DbPAR=WRITER&System=' + system;
+ window.location.href = existingLang(navigator.language) + '/text/shared/05/new_help.html?&DbPAR=WRITER&System=' + system;
}
</script>
</body>
diff --git a/help3xsl/online_transform.xsl b/help3xsl/online_transform.xsl
index 06fe3c0ef..dc57f0772 100644
--- a/help3xsl/online_transform.xsl
+++ b/help3xsl/online_transform.xsl
@@ -167,7 +167,7 @@
<div class="header-extrawurst">
<header>
<div class="logo-container">
- <a class="logo" href="{$target}{$lang}/text/shared/main0108.html">
+ <a class="logo" href="{$target}{$lang}/text/shared/05/new_help.html">
<div class="symbol"></div>
<p><xsl:value-of select="$ui_logo"/></p>
</a>
diff --git a/source/text/shared/05/new_help.xhp b/source/text/shared/05/new_help.xhp
new file mode 100644
index 000000000..fbe7b5d87
--- /dev/null
+++ b/source/text/shared/05/new_help.xhp
@@ -0,0 +1,131 @@
+<?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/.
+ -->
+
+ <meta>
+ <topic id="textshared0500000110xml" indexer="include" status="PUBLISH">
+ <title xml-lang="en-US" id="tit">The %PRODUCTNAME Help Window</title>
+ <filename>/text/shared/05/new_help.xhp</filename>
+ </topic>
+ </meta>
+ <body>
+ <bookmark xml-lang="en-US" branch="index" id="bm_id301534906947308">
+ <bookmark_value>%PRODUCTNAME Help</bookmark_value>
+ <bookmark_value>Help pages;Index</bookmark_value>
+ <bookmark_value>Help pages;search in index</bookmark_value>
+ <bookmark_value>search;Help index</bookmark_value>
+ <bookmark_value>Help pages;contents</bookmark_value>
+ </bookmark>
+ <bookmark xml-lang="en-US" branch="hid/.uno:HelpOnHelp" id="bm_id3706162" localize="false"/>
+ <paragraph xml-lang="en-US" id="hd_id3153884" role="heading" level="1"><variable id="00000110"><link href="text/shared/05/00000110.xhp" name="The %PRODUCTNAME Help Window">The %PRODUCTNAME Help</link></variable></paragraph>
+ <bookmark xml-lang="en-US" branch="hid/SFX2_HID_HELP_TOOLBOX" id="bm_id3153114" localize="false"/>
+ <paragraph role="paragraph" id="par_id171534888116942" xml-lang="en-US">%PRODUCTNAME Help pages are displayed in your system default web browser.</paragraph>
+ <embed href="text/shared/05/00000100.xhp#neuehilfe"/>
+ <paragraph xml-lang="en-US" id="par_id3156183" role="warning">The Help system for all versions of the software is based on the same source files. Some of the functions described in Help may not be included in this particular distribution. Some features specific to a distribution may not be mentioned in this Help.</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3147143" role="paragraph"><ahelp hid=".uno:HelpOnHelp" visibility="hidden">Provides an overview of the Help system.</ahelp></paragraph>
+ <paragraph xml-lang="en-US" id="par_id341534965962279" role="note">Help pages of %PRODUCTNAME Extensions still use the old Help system. The old Help system help pages <link href="text/shared/05/00000110.xhp" name="oldhelp">are available from here</link>.</paragraph>
+ <paragraph role="heading" id="hd_id701534964258231" level="2" xml-lang="en-US">The %PRODUCTNAME Help pages features</paragraph>
+ <paragraph role="heading" id="hd_id561534964266978" level="3" xml-lang="en-US">The Module List</paragraph>
+ <paragraph role="paragraph" id="par_id851534964274673" xml-lang="en-US">Located on the top of the page, click to open the drop-down list and select the %PRODUCTNAME module to display the module Help main entry page.</paragraph>
+ <paragraph role="heading" id="hd_id1001534964280630" level="3" xml-lang="en-US">The Language List (Help online only).</paragraph>
+ <paragraph role="paragraph" id="par_id801534964285706" xml-lang="en-US">Available only in the online version, select the language to display the current help page.</paragraph>
+
+ <paragraph role="heading" id="hd_id821534891267696" level="3" xml-lang="en-US">The Help Index</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3151351" role="paragraph">The Help Index displays a list of keywords for all %PRODUCTNAME modules. Click on any keyword in the list to open the linked Help page.</paragraph>
+ <paragraph role="heading" id="hd_id151534901836252" level="3" xml-lang="en-US">Searching the Help Index</paragraph>
+ <paragraph role="paragraph" id="par_id311534901893169" xml-lang="en-US">Type the keyword in the Search text box. The search is performed immediately, while you type the keyword.</paragraph>
+ <paragraph role="paragraph" id="par_id201534891524377" xml-lang="en-US">The search results is displayed as a filtered list of matches. The module name is displayed as a heading on the list. The <emph>GLOBAL</emph> heading indicates a match for keywords relevant to more than one %PRODUCTNAME module. For example, cell borders applies to spreadsheets cells as well as text and presentation table cells or frames.</paragraph>
+ <paragraph role="paragraph" id="par_id261534891513315" xml-lang="en-US">Use the arrow keys below the Index to scroll forward or backward in the Index or filtered result list.</paragraph>
+ <paragraph role="heading" id="hd_id901534891620807" level="3" xml-lang="en-US">The Contents - The Main Help Topics</paragraph>
+ <paragraph xml-lang="en-US" id="par_id3145748" role="paragraph">Displays an index of the main topics of all modules.</paragraph>
+ <list type="unordered">
+ <listitem>
+ <paragraph role="paragraph" id="par_id3150774" xml-lang="en-US">Click a closed folder (<emph>⊞</emph>) to open it and display the subfolders and Help pages.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph role="paragraph" id="par_id3154749" xml-lang="en-US">Click an open folder (<emph>⊟</emph>) to close it and hide the subfolders and Help pages.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph role="paragraph" id="par_id3152909" xml-lang="en-US">Click a link to display the corresponding Help page.</paragraph>
+ </listitem>
+ </list>
+ <paragraph role="heading" id="hd_id441534964525171" level="2" xml-lang="en-US">Using the browser for %PRODUCTNAME Help</paragraph>
+ <paragraph role="heading" id="hd_id471534889101620" level="3" xml-lang="en-US">Navigating in Help pages</paragraph>
+ <paragraph role="paragraph" id="par_id871534889171418" xml-lang="en-US">Use the <emph>Back</emph> and <emph>Forward</emph> buttons of the browser to navigate between pages. In most browsers, a long click on the <emph>Back</emph> button displays a dropdown list of previously visited pages and a long click on the <emph>Forward</emph> button display a list of visited pages after the current one.</paragraph>
+
+ <paragraph role="heading" id="hd_id321534889287756" level="3" xml-lang="en-US">Bookmarking Help pages</paragraph>
+ <paragraph role="paragraph" id="par_id581534889349758" xml-lang="en-US">Use the bookmark feature of the browser for quick access to relevant Help pages. To bookmark a page in most browsers:</paragraph>
+ <list type="ordered">
+ <listitem>
+ <paragraph id="par_id71534889492593" role="listitem" xml-lang="en-US">Open the <emph>Bookmark</emph> menu of the browser,</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id71534889724361" role="listitem" xml-lang="en-US">select <emph>Add bookmark</emph>, or</paragraph>
+ <paragraph role="paragraph" id="par_id961534889672410" xml-lang="en-US">Press <switchinline select="sys">
+ <caseinline select="MAC"><emph>Command</emph></caseinline><defaultinline><emph>Ctrl</emph></defaultinline></switchinline><emph>+D</emph> on most browsers.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id191534889878558" role="listitem" xml-lang="en-US">Enter the name, folder and meaningful tags for the bookmark.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id771534889897625" role="listitem" xml-lang="en-US">Close the bookmark dialog of the web browser.</paragraph>
+ </listitem>
+ </list>
+
+ <paragraph role="heading" id="hd_id571534890260376" level="3" xml-lang="en-US">Help Pages Navigation History</paragraph>
+ <paragraph role="paragraph" id="par_id411534890266018" xml-lang="en-US">Each Help page visited is recorded in the web browser history. To open the navigation history:</paragraph>
+ <list type="ordered">
+ <listitem>
+ <paragraph id="par_id401534890287783" role="listitem" xml-lang="en-US">Choose the <emph>History</emph> menu of the web browser,</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id991534890295828" role="listitem" xml-lang="en-US">Select <emph>Show History</emph>.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id591534890299255" role="listitem" xml-lang="en-US">Click on any entry of the history main window to open the corresponding help page.</paragraph>
+ </listitem>
+ </list>
+
+ <paragraph role="heading" id="hd_id841534888870987" level="3" xml-lang="en-US">Copying Help contents to clipboard</paragraph>
+ <paragraph xml-lang="en-US" id="par_idN10926" role="paragraph">You can copy contents from the Help page to the clipboard on your operating system with standard copy commands. For example:</paragraph>
+ <list type="ordered">
+ <listitem>
+ <paragraph xml-lang="en-US" id="par_idN1092C" role="paragraph">On a Help page, select the text that you want to copy.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph xml-lang="en-US" id="par_idN10930" role="paragraph">Press <switchinline select="sys"><caseinline select="MAC"><emph>Command</emph></caseinline><defaultinline><emph>Ctrl</emph></defaultinline></switchinline><emph>+C</emph>.</paragraph>
+ </listitem>
+ </list>
+ <paragraph role="paragraph" id="par_id791534903145827" xml-lang="en-US">Some contents in help pages can be copied to the system clipboard with only one mouse click. In these cases a tooltip appears when hovering the mouse on the copy-enabled contents. For example, the following line is copy-enabled:</paragraph>
+ <paragraph role="paragraph" id="par_id381534903133044" xml-lang="en-US"><item type="input">=SUM(A1:A10)</item></paragraph>
+ <paragraph role="heading" id="hd_id201534888332793" level="3" xml-lang="en-US">Searching in current page</paragraph>
+ <paragraph xml-lang="en-US" id="par_idN10933" role="paragraph">To search in the current Help page:</paragraph>
+ <list type="ordered">
+ <listitem>
+ <paragraph xml-lang="en-US" id="par_idN10939" role="paragraph">Open the View menu of your default web browser and choose <emph>Find on this Page</emph> entry.</paragraph>
+ <paragraph xml-lang="en-US" id="par_idN10A36" role="paragraph">You can also press <switchinline select="sys"><caseinline select="MAC"><emph>Command</emph></caseinline><defaultinline><emph>Ctrl</emph></defaultinline></switchinline><emph>+F</emph>.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph xml-lang="en-US" id="par_idN10A22" role="paragraph">In the <emph>Search for</emph> box, enter the text that you want to find.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph xml-lang="en-US" id="par_idN10A48" role="paragraph">Select the search options that you want to use.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph xml-lang="en-US" id="par_idN10A26" role="paragraph">Press <emph>Enter</emph>.</paragraph>
+ </listitem>
+ </list>
+ <paragraph xml-lang="en-US" id="par_idN10A59" role="paragraph">To find the next occurrence of the search term on the page, click on the <emph>Up arrow</emph> or <emph>Down arrow</emph> to find the previous or next occurrence.</paragraph>
+ <paragraph role="heading" id="hd_id141534964599864" level="2" xml-lang="en-US">Contents general information</paragraph>
+ <embed href="text/shared/05/00000002.xhp#symbole"/>
+ <section id="relatedtopics">
+ <embed href="text/shared/05/00000001.xhp#00000001"/>
+ </section>
+</body>
+</helpdocument>
More information about the Libreoffice-commits
mailing list