From 965724a89fb88f693e85da64a1e8b6a1556d373c Mon Sep 17 00:00:00 2001
From: Olivier Hallot <olivier.hallot@libreoffice.org>
Date: Wed, 10 Jul 2019 22:13:37 -0300
Subject: tdf#124299 Redaction Help page

Change-Id: Ia85c95ca63e1d11b1aabd2b5cabd3d962c5161cd
Reviewed-on: https://gerrit.libreoffice.org/75387
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
---
 AllLangHelp_shared.mk                  |   1 +
 source/auxiliary/scalc.tree            |   3 +-
 source/auxiliary/simpress.tree         |   3 +-
 source/auxiliary/swriter.tree          |   3 +-
 source/text/shared/guide/redaction.xhp | 101 +++++++++++++++++++++++++++++++++
 5 files changed, 108 insertions(+), 3 deletions(-)
 create mode 100644 source/text/shared/guide/redaction.xhp

diff --git a/AllLangHelp_shared.mk b/AllLangHelp_shared.mk
index e1d6e12881..dcc2d4c21c 100644
--- a/AllLangHelp_shared.mk
+++ b/AllLangHelp_shared.mk
@@ -696,6 +696,7 @@ $(eval $(call gb_AllLangHelp_add_helpfiles,shared,\
     helpcontent2/source/text/shared/guide/print_blackwhite \
     helpcontent2/source/text/shared/guide/print_faster \
     helpcontent2/source/text/shared/guide/protection \
+    helpcontent2/source/text/shared/guide/redaction \
     helpcontent2/source/text/shared/guide/redlining \
     helpcontent2/source/text/shared/guide/redlining_accept \
     helpcontent2/source/text/shared/guide/redlining_doccompare \
diff --git a/source/auxiliary/scalc.tree b/source/auxiliary/scalc.tree
index 28830bb55c..52f2631dce 100644
--- a/source/auxiliary/scalc.tree
+++ b/source/auxiliary/scalc.tree
@@ -86,10 +86,11 @@
 <topic id="scalc/text/scalc/01/04060199.xhp">Operators in %PRODUCTNAME Calc</topic>
 <topic id="scalc/text/scalc/guide/userdefined_function.xhp">User-Defined Functions</topic>
 		</node>
-		<node id="0804" title="Loading, Saving, Importing, and Exporting">
+		<node id="0804" title="Loading, Saving, Importing, Exporting and Redacting">
 <topic id="scalc/text/scalc/guide/webquery.xhp">Inserting External Data in Table (WebQuery)</topic>
 <topic id="scalc/text/scalc/guide/html_doc.xhp">Saving and Opening Sheets in HTML</topic>
 <topic id="scalc/text/scalc/guide/csv_formula.xhp">Importing and Exporting Text Files</topic>
+<topic id="shared/text/shared/guide/redaction.xhp">Redacting a Spreadsheet</topic>
 		</node>
 		<node id="0805" title="Formatting">
 <topic id="scalc/text/scalc/guide/text_rotate.xhp">Rotating Text</topic>
diff --git a/source/auxiliary/simpress.tree b/source/auxiliary/simpress.tree
index e7a85dd83c..10316e0c01 100644
--- a/source/auxiliary/simpress.tree
+++ b/source/auxiliary/simpress.tree
@@ -58,7 +58,7 @@
                      <topic id="shared/text/shared/main0227.xhp">Edit Points Bar</topic>
                  </node>
          </node>
-         <node id="0403" title="Loading, Saving, Importing, and Exporting">
+         <node id="0403" title="Loading, Saving, Importing, Exporting and Redacting">
              <topic id="simpress/text/simpress/guide/html_export.xhp">Saving a Presentation in HTML Format</topic>
              <topic id="simpress/text/simpress/guide/html_import.xhp">Importing HTML Pages Into Presentations </topic>
              <topic id="simpress/text/simpress/guide/palette_files.xhp">Loading Color, Gradient, and Hatching Lists</topic>
@@ -66,6 +66,7 @@
              <topic id="simpress/text/simpress/guide/table_insert.xhp">Including Spreadsheets in Slides</topic>
              <topic id="sdraw/text/sdraw/guide/graphic_insert.xhp">Inserting Graphics</topic>
              <topic id="simpress/text/simpress/guide/page_copy.xhp">Copying Slides From Other Presentations</topic>
+             <topic id="shared/text/shared/guide/redaction.xhp">Redacting a Presentation</topic>
          </node>
          <node id="0404" title="Formatting">
              <topic id="simpress/text/simpress/guide/palette_files.xhp">Loading Color, Gradient, and Hatching Lists</topic>
diff --git a/source/auxiliary/swriter.tree b/source/auxiliary/swriter.tree
index 061e185386..b0f8fcebfa 100644
--- a/source/auxiliary/swriter.tree
+++ b/source/auxiliary/swriter.tree
@@ -205,9 +205,10 @@
 <topic id="swriter/text/swriter/guide/insert_beforetable.xhp">Inserting Text Before a Table at the Top of Page</topic>
 <topic id="swriter/text/swriter/guide/jump2statusbar.xhp">Going to Specific Bookmark</topic>
 		</node>
-		<node id="0219" title="Loading, Saving, Importing, and Exporting">
+		<node id="0219" title="Loading, Saving, Importing, Exporting and Redacting">
 <topic id="swriter/text/swriter/guide/send2html.xhp">Saving Text Documents in HTML Format</topic>
 <topic id="swriter/text/swriter/guide/textdoc_inframe.xhp">Inserting an Entire Text Document</topic>
+<topic id="shared/text/shared/guide/redaction.xhp">Redacting a Text Document</topic>
 		</node>
 		<node id="0220" title="Master Documents">
 <topic id="swriter/text/swriter/guide/globaldoc.xhp">Master Documents and Subdocuments</topic>
diff --git a/source/text/shared/guide/redaction.xhp b/source/text/shared/guide/redaction.xhp
new file mode 100644
index 0000000000..ebd4aada4f
--- /dev/null
+++ b/source/text/shared/guide/redaction.xhp
@@ -0,0 +1,101 @@
+<?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="redaction" indexer="include" status="PUBLISH">
+            <title id="tit" xml-lang="en-US">Redaction</title>
+            <filename>/text/shared/guide/redaction.xhp</filename>
+        </topic>
+    </meta>
+    <body>
+    <bookmark xml-lang="en-US" branch="index" id="bm_id821562797360035">
+        <bookmark_value>spreadsheet; redacting contents</bookmark_value>
+        <bookmark_value>presentations; redacting contents</bookmark_value>
+        <bookmark_value>text documents; redacting contents</bookmark_value>
+        <bookmark_value>redaction</bookmark_value>
+    </bookmark>
+    <section id="redaction01">
+        <bookmark id="bm_id981562795247716" xml-lang="en-US" branch="hid/.uno:RedactDoc" localize="false"/>
+        <h1 id="hd_id171562795247717"><link href="text/shared/guide/redaction.xhp" name="redaction">Redacting Documents</link></h1>
+        <paragraph id="par_id471562795247717" role="paragraph" xml-lang="en-US"><variable id="redaction"><ahelp hid=".">Redacting documents blocks out words or portions of a document for authorized use or viewing.</ahelp></variable> Redaction protects sensitive information and help enterprises and organizations to comply with regulations, confidentiality or privacy.</paragraph>
+    </section>
+    <section id="howtoget">
+        <paragraph role="paragraph" id="par_id961562795751821">Choose <menuitem>Tools - Redact</menuitem></paragraph>
+    </section>
+    <h2 id="hd_id281562795791927">How redaction works in %PRODUCTNAME?</h2>
+    <paragraph role="paragraph" id="par_id791562795799809">The current document is exported to a drawing document edited in %PRODUCTNAME Draw. The redacted text or contents is removed from the drawing document and replaced by the redaction block of pixels, preventing any attempt to restore or copy the original contents. The redacted drawing document is often exported to PDF for publication or sharing.</paragraph>
+    <paragraph role="paragraph" id="par_id671562795811658">When redacting, the redaction shapes are transparent and in gray so the user can see what is being redacted.</paragraph>
+    <note id="par_id81562795822462">The source document (text, spreadsheet or presentation) is not affected by redaction and can continue to be edited.</note>
+    <tip id="par_id411562795827608">Save and share the in-redaction copies of the document with peers either in the modifiable (drawing) or the verbatim (PDF) format at your option.</tip>
+    <h2 id="hd_id221562796409113">The redaction toolbar</h2>
+    <paragraph role="paragraph" id="par_id441562796415026">The redaction toolbar consist of four tools</paragraph>
+    <table id="tab_id31562796423552">
+        <tablerow>
+            <tablecell>
+                <paragraph id="par_id691562796423552" role="paragraph">
+                    <image src="cmd/sc_rect.svg" id="img_id41562796484514" width="1cm" height="1cm"><alt xml-lang="en-US" id="alt_id151562796484514">Rectangle Redaction tool icon</alt></image>
+                </paragraph>
+            </tablecell>
+            <tablecell>
+                <paragraph id="par_id731562796423552" role="paragraph">The <emph>Rectangle Redaction</emph> tool is used to mark the content for redaction by drawing transparent rectangles covering the content. Use the handles to resize the redaction rectangle. </paragraph>
+            </tablecell>
+        </tablerow>
+    </table>
+    <table id="tab_id491562796560552">
+        <tablerow>
+            <tablecell>
+                <paragraph id="par_id401562796560552" role="paragraph">
+                    <image src="cmd/sc_freeline_unfilled.svg" id="img_id4156296484514" width="1cm" height="1cm"><alt xml-lang="en-US" id="alt_id15152796484514">Freeform Redaction tool icon</alt></image>
+                </paragraph>
+            </tablecell>
+            <tablecell>
+                <paragraph id="par_id641562796560552" role="paragraph">The <emph>Freeform Redaction</emph> tool allows the user to mark the content for redaction by drawing free-form lines or polygons covering the content.</paragraph>
+            </tablecell>
+        </tablerow>
+    </table>
+    <table id="tab_id921562796701222">
+        <tablerow>
+            <tablecell>
+                <paragraph id="par_id961562796701222" role="paragraph">
+                    <image src="cmd/sc_redactedexportwhite.svg" id="img_id4156296484514" width="1cm" height="1cm"><alt xml-lang="en-US" id="alt_id15152796484514">White Redacted Export tool icon</alt></image>
+                    <image src="cmd/sc_redactedexportblack.svg" id="img_id4156296484514" width="1cm" height="1cm"><alt xml-lang="en-US" id="alt_id15152796484514">Black Redacted Export tool icon</alt></image>
+                </paragraph>
+            </tablecell>
+            <tablecell>
+                <paragraph id="par_id231562796701222" role="paragraph">The <emph>Redacted Export</emph> button box has two options:</paragraph>
+                <list type="unordered">
+                    <listitem>
+                        <paragraph id="par_id551562796791417"  role="listitem"><emph>Redacted Export (Black)</emph>: finalize your document by converting the transparent grey redaction shapes to opaque black and export as a pixellized PDF file.</paragraph>
+                    </listitem>
+                    <listitem>
+                        <paragraph id="par_id191562796822685"  role="listitem"><emph>Redacted Export (White)</emph>: finalize your document by converting the transparent grey redaction shapes to opaque white shapes, and export as a pixellized PDF file.</paragraph>
+                    </listitem>
+                </list>
+            </tablecell>
+        </tablerow>
+    </table>
+    <table id="tab_id151562796947231">
+        <tablerow>
+            <tablecell>
+                <paragraph id="par_id961562796947231" role="paragraph">
+                    <image src="cmd/sc_exportdirecttopdf.svg" id="img_id4156296484514" width="1cm" height="1cm"><alt xml-lang="en-US" id="alt_id15152796484514">Direct Export to PDF icon</alt></image>
+                </paragraph>
+            </tablecell>
+            <tablecell>
+                <paragraph id="par_id901562796947232" role="paragraph"><emph>Direct Export to PDF</emph>: Makes an in-redaction copy of the document in PDF to share as a verbatim copy for review</paragraph>
+            </tablecell>
+        </tablerow>
+    </table>
+    <section id="relatedtopics">
+        <embed href="text/shared/01/ref_pdf_export.xhp#ref_pdf_export"/>
+    </section>
+</body>
+</helpdocument>
-- 
cgit