diff options
author | Olivier Hallot <olivier.hallot@libreoffice.org> | 2021-06-08 21:03:18 -0300 |
---|---|---|
committer | Olivier Hallot <olivier.hallot@libreoffice.org> | 2021-06-10 16:31:49 +0200 |
commit | db2d4a1373cc1a025888c4ef0359620eac3f88f6 (patch) | |
tree | 901745f34b12b4182ebfd99bd4187699130ae3fe | |
parent | e5ac483bab252537ccbd087e6a133230cb8bae70 (diff) |
tdf#112685 Advanced TSCP classification help page
* Refactor TSCP pages
* Add help page for Classification dialog
* Add Help page for Classification Toolbar
Change-Id: Id11c15d6937400b7cd28a5d80c4e9438693b28a1
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/116874
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
-rw-r--r-- | AllLangHelp_shared.mk | 3 | ||||
-rw-r--r-- | AllLangHelp_swriter.mk | 1 | ||||
-rw-r--r-- | source/text/shared/01/classificationbar.xhp | 54 | ||||
-rw-r--r-- | source/text/shared/01/classificationdialog.xhp | 81 | ||||
-rw-r--r-- | source/text/shared/guide/classification.xhp (renamed from source/text/swriter/classificationbar.xhp) | 55 |
5 files changed, 158 insertions, 36 deletions
diff --git a/AllLangHelp_shared.mk b/AllLangHelp_shared.mk index 6ebe3e7db2..efb7959be8 100644 --- a/AllLangHelp_shared.mk +++ b/AllLangHelp_shared.mk @@ -331,6 +331,8 @@ $(eval $(call gb_AllLangHelp_add_helpfiles,shared,\ helpcontent2/source/text/shared/01/07080000 \ helpcontent2/source/text/shared/01/about_meta_tags \ helpcontent2/source/text/shared/01/certificatepath \ + helpcontent2/source/text/shared/01/classificationbar \ + helpcontent2/source/text/shared/01/classificationdialog \ helpcontent2/source/text/shared/01/digitalsignatures \ helpcontent2/source/text/shared/01/digitalsignaturespdf \ helpcontent2/source/text/shared/01/addsignatureline \ @@ -634,6 +636,7 @@ $(eval $(call gb_AllLangHelp_add_helpfiles,shared,\ helpcontent2/source/text/shared/guide/chart_insert \ helpcontent2/source/text/shared/guide/chart_legend \ helpcontent2/source/text/shared/guide/chart_title \ + helpcontent2/source/text/shared/guide/classification \ helpcontent2/source/text/shared/guide/cmis-remote-files \ helpcontent2/source/text/shared/guide/cmis-remote-files-setup \ helpcontent2/source/text/shared/guide/collab \ diff --git a/AllLangHelp_swriter.mk b/AllLangHelp_swriter.mk index 07ec0ed3de..05c173f556 100644 --- a/AllLangHelp_swriter.mk +++ b/AllLangHelp_swriter.mk @@ -412,7 +412,6 @@ $(eval $(call gb_AllLangHelp_add_helpfiles,swriter,\ helpcontent2/source/text/swriter/main0216 \ helpcontent2/source/text/swriter/main0220 \ helpcontent2/source/text/swriter/main0503 \ - helpcontent2/source/text/swriter/classificationbar \ helpcontent2/source/text/swriter/menu/insert_header_footer \ helpcontent2/source/text/swriter/menu/insert_footnote_endnote \ helpcontent2/source/text/swriter/menu/insert_frame \ diff --git a/source/text/shared/01/classificationbar.xhp b/source/text/shared/01/classificationbar.xhp new file mode 100644 index 0000000000..e05fd9396a --- /dev/null +++ b/source/text/shared/01/classificationbar.xhp @@ -0,0 +1,54 @@ +<?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="classificationbar" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Classification Bar</title> + <filename>/text/shared/01/classificationbar.xhp</filename> + </topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="hid/sfx/ui/classificationbox/combobox" id="bm_id561623196336451" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/sfx/ui/classificationbox/@@nowidget@@" id="bm_id401623196376608" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id030820161853495457"> + <bookmark_value>classification toolbar;display</bookmark_value> +</bookmark> +<section id="toolbar"> +<h1 id="hd_id3150342"><variable id="classbarh1"><link href="text/shared/01/classificationbar.xhp" name="Classification Bar">Classification Toolbar</link></variable></h1> +<paragraph id="par_id3150202" role="paragraph" xml-lang="en-US">The <emph>Classification</emph> bar contains tools to help secure document handling.</paragraph> +<paragraph id="par_id030820161754171423" role="paragraph" xml-lang="en-US">The <emph>Classification</emph> toolbar contains listboxes to help in selecting the security of the document, according to the <item type="acronym">BAF</item> category policy and <item type="acronym">BAILS</item> levels. %PRODUCTNAME will add custom fields in the document properties (<item type="menuitem">File - Properties</item>, <emph>Custom Properties</emph> tab) to store the classification policy as document metadata.</paragraph> +</section> +<section id="howtoget"> +<paragraph id="par_id030820161754175408" role="paragraph" xml-lang="en-US">Choose <menuitem>View - Toolbars - TSCP Classification</menuitem></paragraph> +</section> + +<h2 id="hd_id121623158675627">Levels</h2> +<embed href="text/shared/guide/classification.xhp#levels"/> +<switch select="appl"> +<case select="WRITER"> +<section id="mandocclas"> +<h2 id="hd_id891623158683293">Manage Document Classification</h2> +<paragraph role="paragraph" id="par_id501623161122070">Opens the <link href="text/shared/01/classificationdialog.xhp" name="classification dialog">Classification dialog</link> for document classification.</paragraph> +</section> +<h2 id="hd_id971623158688684">Manage Paragraph Classification</h2> +<paragraph role="paragraph" id="par_id871623161127282">Opens the <link href="text/shared/01/classificationdialog.xhp" name="classification dialog">Classification dialog</link> for paragraph classification.</paragraph> +</case> +<case select="IMPRESS"> +<embed href="text/shared/01/classificationbar.xhp#mandocclas"/> +</case> +</switch> +<section id="relatedtopics"> +<embed href="text/shared/guide/classification.xhp#classdoc"/> +<embed href="text/shared/01/classificationdialog.xhp#classdialogh1"/> +<paragraph role="paragraph" id="par_id51623177298121"><link href="https://wiki.documentfoundation.org/TSCP-classification" name="wiki classification">Wiki page on document classification</link></paragraph> +</section> +</body> +</helpdocument> diff --git a/source/text/shared/01/classificationdialog.xhp b/source/text/shared/01/classificationdialog.xhp new file mode 100644 index 0000000000..aa4c71079b --- /dev/null +++ b/source/text/shared/01/classificationdialog.xhp @@ -0,0 +1,81 @@ +<?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="page_topic" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Classification Dialog</title> + <filename>/text/shared/01/classificationdialog.xhp</filename> + </topic> +</meta> +<body> +<bookmark id="bm_id891623159004193" xml-lang="en-US" branch="hid/svx/ui/classificationdialog/AdvancedDocumentClassificationDialog" localize="false"/> +<bookmark id="bm_id891623159002193" xml-lang="en-US" branch="hid/svx/ui/classificationdialog/@@nowidget@@" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id481623178809365"> + <bookmark_value>classification;contents</bookmark_value> + <bookmark_value>classification;licenses</bookmark_value> + <bookmark_value>classification;part numbers</bookmark_value> + <bookmark_value>classification;markings</bookmark_value> + <bookmark_value>classification;paragraph</bookmark_value> + <bookmark_value>paragraph;classification</bookmark_value> +</bookmark> +<section id="classificationdialog"> + <h1 id="hd_id21623159004194"><variable id="classdialogh1"><link href="text/shared/01/classificationdialog.xhp" name="classificationdialog">Document and Paragraph Classification Dialog</link></variable></h1> +</section> + +<paragraph role="paragraph" id="par_id461623164674397">Applies classification policy to the current document or paragraph. The dialog helps to assemble the classification policy terms of the document or paragraph by using predefined classification terms or by entering custom classification terms. The dialog display several lists of predefined items, which are loaded from the <link href="text/shared/guide/classification.xhp#configfile" name="config file">BAILS-xml TSCP policy file</link>.</paragraph> +<section id="howtoget"> + <paragraph role="paragraph" id="par_id201623197455516">Enable the <emph>TSCP Classification</emph> toolbar in <menuitem>View - Toolbars - TSCP Classification</menuitem> and click on the <menuitem>Manage Document Classification</menuitem> or <menuitem>Manage Paragraph Classification</menuitem> buttons.</paragraph> +</section> +<h2 id="hd_id831623165018680">Content</h2> +<paragraph role="paragraph" id="par_id301623172724879">The <emph>Content</emph> text box displays the classification text created by the dialog and displays the existing document or paragraph classification terms. You can add your own terms in addition to the existing text in the box and the classification terms from the <link href="text/shared/guide/classification.xhp#configfile" name="config file">classification policy configuration file</link>.</paragraph> + <h3 id="hd_id951623171171522">Bold icon (document classification only)</h3> + <paragraph role="paragraph" id="par_id931623171330037">Apply bold character formatting to the document or paragraph classification terms.</paragraph> + <h3 id="hd_id921623171177576">Sign Paragraph (paragraph classification only)</h3> + <paragraph role="paragraph" id="par_id431623171280325">Opens the Select Certification dialog box to choose the certificate to use to sign the paragraph.</paragraph> +<h2 id="hd_id391623165024206">Recently used</h2> +<paragraph role="paragraph" id="par_id451623170670589">List the recently used classification terms.</paragraph> +<h2 id="hd_id511623165030442">Classification</h2> +<paragraph role="paragraph" id="par_id891623168935957">The Classification list contains the translated elements of the Business Authorization Identification and Labeling Scheme (BAILS). The %PRODUCTNAME defaults are:</paragraph> +<embed href="text/shared/guide/classification.xhp#levellist"/> +<h2 id="hd_id461623165035145">International</h2> +<paragraph role="paragraph" id="par_id21623168943133">The International list are the elements of the BAILS, not localized. The default is:</paragraph> +<list type="unordered"> + <listitem> + <paragraph id="par_id030820161747135421" role="ul_item" xml-lang="en-US" localize="false"><emph>Non-Business</emph></paragraph> + </listitem> + <listitem> + <paragraph id="par_id030820161747132341" role="ul_item" xml-lang="en-US" localize="false"><emph>General Business</emph></paragraph> + </listitem> + <listitem> + <paragraph id="par_id030820161747139845" role="ul_item" xml-lang="en-US" localize="false"><emph>Confidential</emph></paragraph> + </listitem> + <listitem> + <paragraph id="par_id030820161747138519" role="ul_item" xml-lang="en-US" localize="false"><emph>Internal use only</emph></paragraph> + </listitem></list> + <note id="par_id411623172250101">The Classification and International drop-down lists are actually the same list. A change in one list changes the other.</note> + <h2 id="hd_id811623165656089">Marking</h2> +<paragraph role="paragraph" id="par_id41623173977713">Display a list of pre-existing markings available to be added to the Contents text box. Double click one entry to have it added to the contents text box at the cursor location. The markings are defined in the <link href="text/shared/guide/classification.xhp#configfile" name="config file">classification policy configuration file</link>.</paragraph> + <h2 id="hd_id941623165039690">License</h2> + <paragraph role="paragraph" id="par_id1001623174051869">Displays the existing intellectual property licenses. Double click the license to have it displayed in the <emph>Part text</emph> box below. Click the <emph>Add</emph> button to place the license text in the <emph>Content</emph> box.The licenses are defined in the <link href="text/shared/guide/classification.xhp#configfile" name="config file">classification policy configuration file</link>.</paragraph> + <h2 id="hd_id741623165044190">Part number</h2> + <paragraph role="paragraph" id="par_id191623174046018">Displays the existing intellectual property part numbers. Double click the part number to have it displayed in the <emph>Part text</emph> box below and click the <emph>Add</emph> button to place the part number in the <emph>Content</emph> text box. The part numbers are defined in the <link href="text/shared/guide/classification.xhp#configfile" name="config file">classification policy configuration file</link>.</paragraph> + <h2 id="hd_id791623165049158">Part text:</h2> +<paragraph role="paragraph" id="par_id471623174526628">Use this box to enter contents to be added to the <emph>Content</emph> text box.</paragraph> + <h2 id="hd_id491623165052989">Add</h2> +<paragraph role="paragraph" id="par_id591623174559160">Click to add the contents of the <emph>Part text</emph> box to the <emph>Content</emph> box.</paragraph> +<note id="par_id571623174784742">Settings of the Classification dialog are part of the document custom properties.</note> +<section id="relatedtopics"> +<embed href="text/shared/guide/classification.xhp#classdoc"/> +<embed href="text/shared/01/classificationbar.xhp#classbarh1"/> +<paragraph role="paragraph" id="par_id51623177298121"><link href="https://wiki.documentfoundation.org/TSCP-classification" name="wiki classification">Wiki page on document classification</link></paragraph> +</section> +</body> +</helpdocument> diff --git a/source/text/swriter/classificationbar.xhp b/source/text/shared/guide/classification.xhp index 0a0937a5b9..2ec67b0f57 100644 --- a/source/text/swriter/classificationbar.xhp +++ b/source/text/shared/guide/classification.xhp @@ -12,13 +12,13 @@ <meta> <topic id="textswriterclassificationbarxml" indexer="include" status="PUBLISH"> <title id="tit" xml-lang="en-US">Document Classification</title> - <filename>/text/swriter/classificationbar.xhp</filename> + <filename>/text/shared/guide/classification.xhp</filename> </topic> </meta> <body> -<paragraph id="hd_id3156324" role="heading" level="1" xml-lang="en-US"><variable id="classdoc"><link href="text/swriter/classificationbar.xhp" name="Document Classification">Document Classification</link> </variable></paragraph> +<h1 id="hd_id3156324"><variable id="classdoc"><link href="text/shared/guide/classification.xhp" name="Document Classification">Document Classification</link></variable></h1> <bookmark xml-lang="en-US" branch="index" id="bm_id030820161847569710"> <bookmark_value>classification;BAILS levels</bookmark_value> <bookmark_value>classification;BAF category</bookmark_value> @@ -42,7 +42,7 @@ <paragraph id="par_id030820161744126871" role="ul_item" xml-lang="en-US">Business Authorization Identification and Labeling Scheme (<item type="acronym">BAILS</item>) specifies how to refer to such a <item type="acronym">BAF</item> policy in a document. The concepts in <item type="acronym">BAILS</item> are so generic that they can be applied to any format that supports document-level user-defined properties.</paragraph> </listitem></list> -<paragraph id="hd_id030820161800093929" role="heading" level="2" xml-lang="en-US">BAF Categories</paragraph> +<h2 id="hd_id030820161800093929">BAF Categories</h2> <bookmark xml-lang="en-US" branch="index" id="bm_id030820161856432825"> <bookmark_value>classification;displayed in user interface</bookmark_value> <bookmark_value>classification;headers and footers</bookmark_value> @@ -51,15 +51,17 @@ </bookmark> <paragraph id="par_id030820161800092823" role="paragraph" xml-lang="en-US">The default BAF categories for %PRODUCTNAME are listed below.</paragraph> -<paragraph id="par_id030820161800098142" role="tip" xml-lang="en-US">Only the "Intellectual Properties" category will modify the layout of the document with a watermark, fields in the header and footer and an information bar on top of the document area. Each item inserted in the document is controlled by the classification configuration file.</paragraph> -<paragraph id="par_idN106B0" role="heading" level="3" xml-lang="en-US">Intellectual Property</paragraph> +<tip id="par_id030820161800098142">Only the "Intellectual Properties" category will modify the layout of the document with a watermark, fields in the header and footer and an information bar on top of the document area. Each item inserted in the document is controlled by the classification configuration file.</tip> +<h3 id="par_idN106B0">Intellectual Property</h3> <paragraph id="par_idN106C0" role="paragraph" xml-lang="en-US">Intellectual property is a generic term for the nature of the contents of the document. Select this category for general purpose document classification.</paragraph> -<paragraph id="par_idN106CD" role="heading" level="3" xml-lang="en-US">National Security</paragraph> +<h3 id="par_idN106CD">National Security</h3> <paragraph id="par_idN106DD" role="paragraph" xml-lang="en-US">Selects the category of this document for the national security policy type. The selected category is saved together with the document as BAILS metadata in the file properties and no modifications is carried in the document layout or the user interface.</paragraph> -<paragraph id="par_idN106EA" role="heading" level="3" xml-lang="en-US">Export Control</paragraph> +<h3 id="par_idN106EA">Export Control</h3> <paragraph id="par_idN106FA" role="paragraph" xml-lang="en-US">Selects the category of this document for the export control policy type. The selected category is saved together with the document as BAILS metadata in the file properties and no modifications is carried in the document layout or the user interface.</paragraph> -<paragraph id="par_id030820161800091021" role="warning" xml-lang="en-US">Refer to your corporate data security policy and information security officers for support in document classification.</paragraph> -<paragraph id="hd_id030820161747122444" role="heading" level="2" xml-lang="en-US">Default levels of classification</paragraph> +<warning id="par_id030820161800091021">Refer to your corporate data security policy and information security officers for support in document classification.</warning> + +<section id="levels"> +<h2 id="hd_id030820161747122444">Default levels of classification</h2> <bookmark xml-lang="en-US" branch="index" id="bm_id030820161849574719"> <bookmark_value>classification levels;Internal use only</bookmark_value> <bookmark_value>classification levels;Confidential</bookmark_value> @@ -68,7 +70,7 @@ </bookmark> <paragraph id="par_id030820161747139337" role="paragraph" xml-lang="en-US">%PRODUCTNAME provides default levels of document classification (<item type="acronym">BAILS</item>) shown below, sorted by increasing level of business sensitivity:</paragraph> - +<section id="levellist"> <list type="unordered"> <listitem> <paragraph id="par_id030820161747135421" role="ul_item" xml-lang="en-US"><emph>Non-Business</emph>: Information in document has no impact in business, if made public.</paragraph> @@ -82,42 +84,27 @@ <listitem> <paragraph id="par_id030820161747138519" role="ul_item" xml-lang="en-US"><emph>Internal use only</emph>: Major damage. Negative national media, lawsuits, fines, long term brand damages.</paragraph> </listitem></list> - -<paragraph id="hd_id030820161747134459" role="heading" level="2" xml-lang="en-US">Customizing classification levels.</paragraph> +</section> +</section> +<section id="configfile"> +<h2 id="hd_id030820161747134459">Customizing classification levels.</h2> <bookmark xml-lang="en-US" branch="index" id="bm_id030820161851045883"> <bookmark_value>custom;classification levels</bookmark_value> <bookmark_value>classification levels;customizing</bookmark_value> </bookmark> <paragraph id="par_id030820161747133280" role="paragraph" xml-lang="en-US">%PRODUCTNAME allows customization of the levels of classification for your business. To customize the number and the name of the levels, copy the file <item type="literal">example.xml</item> located in <switchinline select="sys"><caseinline select="MAC"><menuitem>%PRODUCTNAME - Preferences</menuitem></caseinline><defaultinline><menuitem>Tools - Options</menuitem></defaultinline></switchinline><menuitem> - LibreOffice - Paths - Classification</menuitem> into a local folder and edit the contents.</paragraph> -<paragraph id="par_id03082016174713477" role="tip" xml-lang="en-US">Use the file with your %PRODUCTNAME locale in the name as example.</paragraph> +<tip id="par_id03082016174713477">Use the file with your %PRODUCTNAME locale in the name as example.</tip> <paragraph id="par_id030820161747137522" role="paragraph" xml-lang="en-US">Save the file and make the adequate changes to the classification path above to access the file.</paragraph> -<paragraph id="par_id030820161747135133" role="tip" xml-lang="en-US">Your system administrator can place the file in a network folder and make all users access the classification settings file.</paragraph> - -<paragraph id="hd_id03082016174713354" role="heading" level="2" xml-lang="en-US">Pasting contents in documents with different levels of classification.</paragraph> +<tip id="par_id030820161747135133">Your system administrator can place the file in a network folder and make all users access the classification settings file.</tip> +</section> +<h2 id="hd_id03082016174713354">Pasting contents in documents with different levels of classification.</h2> <bookmark xml-lang="en-US" branch="index" id="bm_id030820161851512902"> <bookmark_value>document classification;pasting contents</bookmark_value> </bookmark> - <paragraph id="par_id030820161747134188" role="paragraph" xml-lang="en-US">To prevent a breach in the security policy, contents with high classification level pasted to documents with lower classification level are not allowed. %PRODUCTNAME will display a warning message wherever it detects that the contents of the clipboard have higher security classification than the target document.</paragraph> -<section id="toolbar"> - -<paragraph id="hd_id3150342" role="heading" level="1" xml-lang="en-US"><link href="text/swriter/classificationbar.xhp" name="Classification Bar">Classification Bar</link></paragraph> -<bookmark xml-lang="en-US" branch="index" id="bm_id030820161853495457"> - <bookmark_value>Classification toolbar;display</bookmark_value> -</bookmark> - -<paragraph id="par_id3150202" role="paragraph" xml-lang="en-US"><ahelp hid=".">The <emph>Classification</emph> bar contains tools to help secure document handling.</ahelp></paragraph> -<paragraph id="par_id030820161754171423" role="paragraph" xml-lang="en-US">The <emph>Classification</emph> toolbar contains listboxes to help in selecting the security of the document, according to the <item type="acronym">BAF</item> category policy and <item type="acronym">BAILS</item> levels. %PRODUCTNAME will add custom fields in the document properties (<item type="menuitem">File - Properties</item>, <emph>Custom Properties</emph> tab) to store the classification policy as document metadata.</paragraph> - -<section id="howtoget"> -<paragraph id="par_id030820161754175408" role="paragraph" xml-lang="en-US">Go to menu <item type="menuitem">View - Toolbars</item> and select <item type="menuitem">Classification</item></paragraph> -</section> - - <section id="relatedtopics"> - <list type="unordered"> <listitem> <paragraph id="par_id030820161818081317" role="ul_item" xml-lang="en-US"><link href="https://www.tscp.org/about-tscp/"><item type="acronym">TSCP</item> (Transglobal Secure Collaboration Participation, Inc.) website</link>.</paragraph> @@ -129,7 +116,5 @@ <paragraph id="par_id030820161818085901" role="ul_item" xml-lang="en-US"><link href="http://www.tscp.org/wp-content/uploads/2013/08/TSCP_BAILSv1.pdf">Business Authorization Identification and Labeling Scheme (<item type="acronym">BAILS</item>) document (PDF)</link></paragraph> </listitem></list> </section> -</section> </body> - </helpdocument> |