summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRafael Lima <rafael.palma.lima@gmail.com>2023-12-14 01:56:33 +0100
committerOlivier Hallot <olivier.hallot@libreoffice.org>2023-12-14 15:10:23 +0100
commit8a730f3601264c1c389599df9c0b8b4809fb6d9b (patch)
tree967e9ca1a94c20a6576ebc0be786e25213061356
parent77565bf3bbd61c832c906ea42d89677f8ad0a7b1 (diff)
Related tdf#142926 Create help page about built-in help installation
Change-Id: Ie71d9e5427a0bcdfeb9c20474e76635ca68a3f2a Reviewed-on: https://gerrit.libreoffice.org/c/help/+/160696 Tested-by: Jenkins Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org> (cherry picked from commit e99617c55d064c67d0caa82adb53925f5589c6bb) Reviewed-on: https://gerrit.libreoffice.org/c/help/+/160708
-rw-r--r--AllLangHelp_shared.mk1
-rw-r--r--source/text/shared/guide/builtin_help.xhp84
2 files changed, 85 insertions, 0 deletions
diff --git a/AllLangHelp_shared.mk b/AllLangHelp_shared.mk
index 64888b0d18..c5b7d27797 100644
--- a/AllLangHelp_shared.mk
+++ b/AllLangHelp_shared.mk
@@ -683,6 +683,7 @@ $(eval $(call gb_AllLangHelp_add_helpfiles,shared,\
helpcontent2/source/text/shared/guide/background \
helpcontent2/source/text/shared/guide/border_paragraph \
helpcontent2/source/text/shared/guide/border_table \
+ helpcontent2/source/text/shared/guide/builtin_help \
helpcontent2/source/text/shared/guide/breaking_lines \
helpcontent2/source/text/shared/guide/change_title \
helpcontent2/source/text/shared/guide/chart_axis \
diff --git a/source/text/shared/guide/builtin_help.xhp b/source/text/shared/guide/builtin_help.xhp
new file mode 100644
index 0000000000..b5a11e973c
--- /dev/null
+++ b/source/text/shared/guide/builtin_help.xhp
@@ -0,0 +1,84 @@
+<?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="BuiltinHelp" indexer="include" status="PUBLISH">
+ <title id="tit" xml-lang="en-US">Installation of the built-in help</title>
+ <filename>/text/shared/guide/builtin_help.xhp</filename>
+ </topic>
+</meta>
+
+<body>
+ <bookmark xml-lang="en-US" localize="false" branch="index" id="bm_id261582733781001">
+ <bookmark_value>Built-in help;installation</bookmark_value>
+ </bookmark>
+
+ <h1 id="hd_id861702496632045">Installing the Built-in Help</h1>
+ <paragraph role="paragraph" id="par_id311702497450126">The instructions for installing the built-in help depend on the method used for installing %PRODUCTNAME on your device. For the purpose of this guide, consider the two following approaches:</paragraph>
+ <list type="ordered">
+ <listitem>
+ <paragraph id="par_id817024975911605" role="listitem">Installation using the official binaries obtained from the <link href="https://www.libreoffice.org/download/download-libreoffice/">%PRODUCTNAME download</link> page.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id641702498270425" role="listitem">Installation using third-party repositories. This is mainly the case for Linux operating systems that maintain their own packages.</paragraph>
+ </listitem>
+ </list>
+ <note id="par_id641702498633778">This guide provides instruction for installing the built-in help for packages provided by Ubuntu and Fedora. If your installation method is not covered here, please contact the maintainers of the packages installed on your system.</note>
+
+ <h2 id="hd_id821702498482709">Installing from the Official Download page</h2>
+ <paragraph role="paragraph" id="par_id961702496644653">The instructions in this section are suitable when %PRODUCTNAME was installed using the official binaries. Follow the steps below to obtain the installation file for the offline built-in help:</paragraph>
+ <list type="ordered">
+ <listitem>
+ <paragraph id="par_id501702499294806" role="listitem">Visit the <link href="https://www.libreoffice.org/download/download-libreoffice/">%PRODUCTNAME download</link> page.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id481702499297711" role="listitem">Make sure your current operating system is selected in the <menuitem>Choose your operating system</menuitem> section.</paragraph>
+ </listitem>
+ <listitem>
+ <paragraph id="par_id451702507347283" role="listitem">Click the link <menuitem>Help for offline use</menuitem> and save the binary file to your device.</paragraph>
+ </listitem>
+ </list>
+ <tip id="par_id881702507455686">Before clicking the link <menuitem>Help for offline use</menuitem>, make sure the desired language is selected. Click <menuitem>need another language</menuitem> if a different language is desired.</tip>
+
+ <h3 id="hd_id191702507618250">Windows</h3>
+ <paragraph role="paragraph" id="par_id701702507635522">Open the location where the <emph>.msi</emph> binary file was downloaded to and execute the installer. Follow the installer instructions.</paragraph>
+ <h3 id="hd_id621702507782214">MacOS</h3>
+ <paragraph role="paragraph" id="par_id761702507959835">Open the location where the <emph>.dmg</emph> binary file was downloaded to and execute the installer. After the installation window appears, drag and drop the %PRODUCTNAME icon onto the <menuitem>Applications</menuitem> icon.</paragraph>
+ <h3 id="hd_id301702508628711">DEB installer</h3>
+ <paragraph role="paragraph" id="par_id851702508657689">The <emph>.deb</emph> installer is meant for Ubuntu-based Linux distributions and it is available as a <emph>.tar.gz</emph> compressed file.</paragraph>
+ <paragraph role="paragraph" id="par_id1001702509285820">Download the <emph>.tar.gz</emph> file to your device and extract it. The <emph>.deb</emph> file will be inside a folder named <emph>DEBS</emph>.</paragraph>
+ <paragraph role="paragraph" id="par_id521702509438353">Open the <menuitem>Terminal</menuitem> application, use the <literal>cd</literal> command to navigate to the folder where the <emph>.deb</emph> file is located and run the following command:</paragraph>
+ <paragraph role="paragraph" id="par_id101702508909145"><input>$ sudo dpkg -i libobasis7.6-en-us-help_7.6.4.1-1_amd64.deb</input></paragraph>
+ <note id="par_id801702509255083">The name of the downloaded file contains the version number, therefore the actual file name may differ from the example above.</note>
+ <h3 id="hd_id711702509065077">RPM installer</h3>
+ <paragraph role="paragraph" id="par_id531702509077373">The <emph>.rpm</emph> installer is meant for Red Hat-based Linux distributions and it is available as a <emph>.tar.gz</emph> compressed file.</paragraph>
+ <paragraph role="paragraph" id="par_id100170250925775">Download the <emph>.tar.gz</emph> file to your device and extract it. The <emph>.rpm</emph> file will be inside a folder named <emph>RPMS</emph>.</paragraph>
+ <paragraph role="paragraph" id="par_id521702509438482">Open the <menuitem>Terminal</menuitem> application, use the <literal>cd</literal> command to navigate to the folder where the <emph>.deb</emph> file is located and run the following command:</paragraph>
+ <paragraph role="paragraph" id="par_id31702509923602"><input>$ sudo rpm -i libobasis7.6-en-US-help-7.6.4.1-1.x86_64.rpm</input></paragraph>
+ <note id="par_id21702508510371">After installation, restart %PRODUCTNAME to be able to use the built-in help.</note>
+
+ <h2 id="hd_id101702511392350">Installing from Third-party Repositories</h2>
+ <paragraph role="paragraph" id="par_id731702511460352">Linux distributions usually provide their own %PRODUCTNAME packages, hence the method to install the built-in help will be different for each distribution.</paragraph>
+ <paragraph role="paragraph" id="par_id481702513590717">Next are the installation instructions for help packages provided by Ubuntu and Fedora.</paragraph>
+ <h3 id="hd_id191702513810620">Ubuntu-based Distributions</h3>
+ <paragraph role="paragraph" id="par_id481702513852446">Open the <menuitem>Terminal</menuitem> application and run the following command (the example below installs the en_US built-in help):</paragraph>
+ <paragraph role="paragraph" id="par_id511702513867478"><input>$ sudo apt install libreoffice-help-en-us</input></paragraph>
+ <h3 id="hd_id851702514430704">Fedora</h3>
+ <paragraph role="paragraph" id="par_id651702514440648">Open the <menuitem>Terminal</menuitem> application and run the following command (the example below installs the en_US built-in help):</paragraph>
+ <paragraph role="paragraph" id="par_id1001702515062635"><input>$ sudo dnf install libreoffice-langpack-en</input></paragraph>
+ <h3 id="hd_id451702514031171">Snap packages</h3>
+ <paragraph role="paragraph" id="par_id491702514043307">The %PRODUCTNAME Snap package is provided with the built-in help preinstalled in various languages.</paragraph>
+
+ <section id="relatedtopics">
+ <embed href="text/shared/05/new_help.xhp#newhlp"/>
+ </section>
+</body>
+</helpdocument>