tdf#125636 (part) Include Help for "Start Certificate Manager"

+ some refactor Change-Id: I7d15ece2c87ab32568f9d40a7dfff8349d45a31e Reviewed-on: https://gerrit.libreoffice.org/c/help/+/125969 Tested-by: Jenkins Reviewed-by: Adolfo Jayme Barrientos <fitojb@ubuntu.com>
author: Olivier Hallot <olivier.hallot@libreoffice.org> 2021-11-28 09:49:32 -0300
committer: Adolfo Jayme Barrientos <fitojb@ubuntu.com> 2021-11-29 13:13:21 +0100
commit: b5735b8715ec8e86033fa9bf826829235bd69018 (patch)
tree: e061e91bb1b01208e16c266b8076bf672fe01af0 /source
parent: fe3d13ce1750ba2cd5bc64ff76d20a11e93e446e (diff)
3 files changed, 19 insertions, 9 deletions
diff --git a/source/text/shared/01/digitalsignatures.xhp b/source/text/shared/01/digitalsignatures.xhp
index 70b358f3c2..3c677701b3 100644
--- a/source/text/shared/01/digitalsignatures.xhp
+++ b/source/text/shared/01/digitalsignatures.xhp
@@ -28,7 +28,7 @@
    </meta>
    <body>
    <bookmark xml-lang="en-US" branch="hid/xmlsec/ui/digitalsignaturesdialog/@@nowidget@@" id="bm_@@nowidget@@" localize="false"/>
-      <bookmark xml-lang="en-US" branch="hid/xmlsec/ui/digitalsignaturesdialog/DigitalSignaturesDialog" id="bm_id3150017" localize="false"/>
+    <bookmark xml-lang="en-US" branch="hid/xmlsec/ui/digitalsignaturesdialog/DigitalSignaturesDialog" id="bm_id3150017" localize="false"/>
       <section id="digitalsignatures">
 <bookmark xml-lang="en-US" branch="hid/.uno:Signature" id="bm_id9475924" localize="false"/>
 <h1 id="par_idN10544"><link href="text/shared/01/digitalsignatures.xhp">Digital Signatures</link></h1>
@@ -61,5 +61,15 @@
 <bookmark xml-lang="en-US" branch="hid/xmlsec/ui/digitalsignaturesdialog/remove" id="bm_id4170964" localize="false"/>
 <h2 id="par_idN10596">Remove</h2>
       <paragraph xml-lang="en-US" id="par_idN1059A" role="paragraph"><ahelp hid=".">Removes the selected signature from the list. Removes all subsequent signatures as well, in case of PDF.</ahelp></paragraph>
+<bookmark xml-lang="en-US" branch="hid/xmlsec/ui/digitalsignaturesdialog/start_certmanager" id="bm_id291638102005622" localize="false"/>
+<h2 id="hd_id61638092292670">Start Certificate Manager</h2>
+<paragraph role="paragraph" id="par_id441638095576834">Opens the installed certificate manager of your system.</paragraph>
+<switch select="sys">
+    <case select="MAC"><paragraph role="paragraph" id="par_id481638101674763">On macOS, the default certificate manager is <emph>Keychain Access</emph>.</paragraph></case>
+    <case select="WIN"><paragraph role="paragraph" id="par_id701638101681340">On Windows systems, the default certificate manager is <emph>Certmgr.msc</emph>, a Microsoft Management Console snap-in using Certmgr.exe, and does not manage OpenPGP certificates. To manage both X509 and OpenPGP certificates install the <emph>gpg4win</emph> tool.</paragraph></case>
+</switch>
+<section id="relatedtopics">
+    <paragraph role="paragraph" id="par_id221638101291847" localize="false"><embedvar href="text/shared/guide/digitalsign_send.xhp#digitalsign_send" markup="ignore"/></paragraph>
+</section>
    </body>
 </helpdocument>
diff --git a/source/text/shared/guide/digital_signatures.xhp b/source/text/shared/guide/digital_signatures.xhp
index 382b9abc24..c57804bb98 100644
--- a/source/text/shared/guide/digital_signatures.xhp
+++ b/source/text/shared/guide/digital_signatures.xhp
@@ -102,7 +102,7 @@
       <section id="relatedtopics">
           <paragraph role="paragraph" id="par_id681543699425744" localize="false"><embedvar href="text/shared/guide/openpgp.xhp#openpgph1" markup="ignore"/></paragraph>
          <paragraph xml-lang="en-US" id="par_id3204443" role="paragraph"><link href="https://wiki.documentfoundation.org/How_to_use_digital_Signatures" name="wiki.documentfoundation.org: How to use digital Signatures">English Wiki page on digital signatures</link></paragraph>
-         <paragraph xml-lang="en-US" id="par_id486465" role="paragraph"><link href="text/shared/guide/digitalsign_send.xhp">Applying digital signatures</link></paragraph>
+        <paragraph role="paragraph" id="par_id221638101291847" localize="false"><embedvar href="text/shared/guide/digitalsign_send.xhp#digitalsign_send" markup="ignore"/></paragraph>
          <paragraph xml-lang="en-US" id="par_id3448591" role="paragraph"><link href="text/shared/guide/digitalsign_receive.xhp">Opening a document using WebDAV over HTTPS</link></paragraph>
       </section>
    </body>
diff --git a/source/text/shared/guide/digitalsign_send.xhp b/source/text/shared/guide/digitalsign_send.xhp
index 18fdad9f3f..998faee4f5 100644
--- a/source/text/shared/guide/digitalsign_send.xhp
+++ b/source/text/shared/guide/digitalsign_send.xhp
@@ -30,15 +30,15 @@
 <bookmark xml-lang="en-US" branch="index" id="bm_id7430951"><bookmark_value>signing documents with digital signatures</bookmark_value>
       <bookmark_value>digital signatures;getting/managing/applying</bookmark_value>
 </bookmark><comment>mw transferred one entry from digital_signatures.xhp and added a new entry</comment>
-<paragraph xml-lang="en-US" id="hd_id344248" role="heading" level="1"><variable id="digitalsign_send"><link href="text/shared/guide/digitalsign_send.xhp">Applying Digital Signatures</link>
-</variable></paragraph><comment>MW created this file by splitting shared/guide/digital_signatures.xhp</comment>
-<paragraph xml-lang="en-US" id="par_idN1063C" role="heading" level="2">Getting a Certificate</paragraph>
+<h1 id="hd_id344248"><variable id="digitalsign_send"><link href="text/shared/guide/digitalsign_send.xhp">Applying Digital Signatures</link>
+</variable></h1><comment>MW created this file by splitting shared/guide/digital_signatures.xhp</comment>
+<h2 id="par_idN1063C">Getting a Certificate</h2>
 <paragraph xml-lang="en-US" id="par_idN10640" role="paragraph">You can get a certificate from a certification authority. No matter if you choose a governmental institution or a private company it is common to be charged for this service, for example when they certify your identity. Few other authorities issue certificates free of costs, like the Open Source Project <link href="https://www.CAcert.org/"><emph>CAcert</emph></link> which is based on the well-known and reliable Web of Trust model and is of growing popularity.</paragraph>
-      <paragraph xml-lang="en-US" id="par_idN106F6" role="heading" level="2">Managing your Certificates</paragraph>
+      <h2 id="par_idN106F6">Managing your Certificates</h2>
 <switch select="sys">
 <case select="UNIX">
     <paragraph xml-lang="en-US" id="par_idN1071D" role="paragraph">If you are using Linux, macOS or Solaris, you must install a recent version of Thunderbird or Firefox. %PRODUCTNAME will then access their certificate storage.</paragraph>
-    <paragraph xml-lang="en-US" id="par_idN10720" role="tip">If you have created different profiles in Thunderbird or Firefox and you want to use certificates from one specific user profile, select the profile in <switchinline select="sys"><caseinline select="MAC"><menuitem>%PRODUCTNAME - Preferences</menuitem></caseinline><defaultinline><menuitem>Tools - Options</menuitem></defaultinline></switchinline><menuitem> - Security - Certificate Path</menuitem>. Alternatively, you can set the environment variable MOZILLA_CERTIFICATE_FOLDER to point to the folder containing that profile.</paragraph>
+    <tip id="par_idN10720">If you have created different profiles in Thunderbird or Firefox and you want to use certificates from one specific user profile, select the profile in <switchinline select="sys"><caseinline select="MAC"><menuitem>%PRODUCTNAME - Preferences</menuitem></caseinline><defaultinline><menuitem>Tools - Options</menuitem></defaultinline></switchinline><menuitem> - Security - Certificate Path</menuitem>. Alternatively, you can set the environment variable MOZILLA_CERTIFICATE_FOLDER to point to the folder containing that profile.</tip>
     <list type="ordered">
         <listitem>
             <paragraph xml-lang="en-US" id="par_id944242" role="paragraph">Open your web browser’s preferences, select the <emph>Advanced</emph> section, click on the <emph>Certificates</emph> tab, and then choose <emph>View Certificates</emph>. The <emph>Certificate Manager</emph> dialog will appear.</paragraph>
@@ -59,7 +59,7 @@
     <paragraph role="paragraph" id="par_id351519764024243" xml-lang="en-US">The general management of public and private keys on your PC will vary depending on the version of Windows you are operating. For more information, use the "Help and Support" topic of your Windows version and search for "digital signature".</paragraph>
 </default>
 </switch>
-<paragraph xml-lang="en-US" id="par_idN10681" role="heading" level="2">Signing a document</paragraph>
+<h2 id="par_idN10681">Signing a document</h2>
       <list type="ordered">
          <listitem>
             <paragraph xml-lang="en-US" id="par_idN10688" role="paragraph">Choose <emph>File - Digital Signatures - Digital Signatures</emph>.</paragraph>
@@ -80,7 +80,7 @@
       <paragraph xml-lang="en-US" id="par_idN106C3" role="paragraph">A signed document shows an icon
 <image id="img_id262764" src="xmlsecurity/res/certificate_16.png" width="0.2228in" height="0.2228in"><alt xml-lang="en-US" id="alt_id262764">Icon</alt></image> in the status bar. You can double-click the icon in the status bar to view the certificate.</paragraph>
       <paragraph xml-lang="en-US" id="par_id2008200911381426" role="paragraph">The result of the signature validation is displayed in the status bar and within the <emph>Digital Signature</emph> dialog. Several documents and macro signatures can exist inside an ODF document. If there is a problem with one signature, then the validation result of that one signature is assumed for all signatures. That is, if there are ten valid signatures and one invalid signature, then the status bar and the status field in the dialog will flag the signature as <emph>invalid</emph>.</paragraph>
-      <paragraph xml-lang="en-US" id="par_idN106E0" role="heading" level="2">Signing the macros inside a document</paragraph>
+      <h2 id="par_idN106E0">Signing the macros inside a document</h2>
       <paragraph xml-lang="en-US" id="par_idN106E4" role="paragraph">Normally, macros are part of a document. If you sign a document, the macros inside the document are signed automatically. If you want to sign only the macros, but not the document, proceed as follows:</paragraph>
       <list type="ordered">
          <listitem>
author	Olivier Hallot <olivier.hallot@libreoffice.org>	2021-11-28 09:49:32 -0300
committer	Adolfo Jayme Barrientos <fitojb@ubuntu.com>	2021-11-29 13:13:21 +0100
commit	b5735b8715ec8e86033fa9bf826829235bd69018 (patch)
tree	e061e91bb1b01208e16c266b8076bf672fe01af0 /source
parent	fe3d13ce1750ba2cd5bc64ff76d20a11e93e446e (diff)