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.hal...@libreoffice.org>
AuthorDate: Wed Aug 22 17:39:37 2018 -0300
Commit: Olivier Hallot <olivier.hal...@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.hal...@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>
_______________________________________________
Libreoffice-commits mailing list
libreoffice-comm...@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/libreoffice-commits
