Files
help/source/text/shared/guide/redlining_doccompare.xhp
Ilmari Lauhakangas 7e42394ecb tdf#152323 drop name attribute from <link> elements
Replacement done with

find . -name \*.xhp -print0 |xargs -0 -P 0 perl -CS -pi -e \
        's#(<link[^>]*?) +name *="[^"]*" *( [^>]+|) *>#$1$2>#g'

(note some inconsistencies with space between name and = and also having
empty value, and some more complicated expression to also clear up
double space before/after the attribute)

translation files will be prepped with:

find */helpcontent2 -name \*.po -print0 |xargs -0 -P 0 perl -CS -pi -e \
    $'s#(<link[^>]*?) +name=(?:\\\\"[^"]*\\\\"|\'[^\']*\') *( [^>]+|) *(/?>)#$1$2$3#g unless /^#/'

(note that not all languages use the " as quote character for the
attributes, but that also single quotes appera in the po file. Hence
the use of the shell $'string' syntax to be able to quote ' as \'
It also requires to quote the backslash, so that it needs to be escaped
once for the shell, then another time for perl. Also don't work on
obsolete strings (those are prefixed with #~ in the po files)
Also note that <link..></link> gets turned into <link ../> during
translation extraction (along with removal of the space between the
attribute name and the value), so the pattern needs to be slightly
different here)

Change-Id: I95e53a08e6b0095cd894109ea0de154cc4859d8f
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/143713
Tested-by: Jenkins
Reviewed-by: Christian Lohmaier <lohmaier+LibreOffice@googlemail.com>
2022-12-07 17:39:02 +00:00

68 lines
4.4 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<!--
* 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/.
*
* This file incorporates work covered by the following license notice:
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed
* with this work for additional information regarding copyright
* ownership. The ASF licenses this file to you under the Apache
* License, Version 2.0 (the "License"); you may not use this file
* except in compliance with the License. You may obtain a copy of
* the License at http://www.apache.org/licenses/LICENSE-2.0 .
-->
<helpdocument version="1.0">
<meta>
<topic id="textsharedguideredlining_doccomparexml" indexer="include" status="PUBLISH">
<title id="tit" xml-lang="en-US">Comparing Versions of a Document</title>
<filename>/text/shared/guide/redlining_doccompare.xhp</filename>
</topic>
<history>
<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created>
</history>
</meta>
<body>
<bookmark xml-lang="en-US" branch="index" id="bm_id3154788"><bookmark_value>documents; comparing</bookmark_value>
<bookmark_value>comparisons;document versions</bookmark_value>
<bookmark_value>versions; comparing documents</bookmark_value>
<bookmark_value>changes;comparing to original</bookmark_value>
<bookmark_value>review function; comparing documents</bookmark_value>
</bookmark><comment>mw made "comparing..." a two level entry</comment>
<h1 id="hd_id3154788"><variable id="redlining_doccompare"><link href="text/shared/guide/redlining_doccompare.xhp">Comparing Versions of a Document</link>
</variable></h1>
<note id="par_id4186223">The review function is available in %PRODUCTNAME for text documents and spreadsheet documents.</note>
<paragraph role="paragraph" id="par_id3995178" xml-lang="en-US">Imagine you have some co-authors or reviewers who collaborate with you writing your original document. One day you send out copies of your document to all reviewers. You ask them to edit the copy and send it back.</paragraph>
<paragraph role="paragraph" id="par_id9948423" xml-lang="en-US">Normally, the reviewers enable change tracking by <emph>Edit - Track Changes - Record</emph> and you can easily see the changes.</paragraph>
<paragraph role="paragraph" id="par_id3155421" xml-lang="en-US">If one of the authors has made changes to a document without recording them, you can compare the changed document to your original document.</paragraph>
<list type="ordered">
<listitem>
<paragraph role="listitem" id="par_id3153087" xml-lang="en-US">Open the reviewer's document and then choose <emph>Edit - Track Changes - Compare Document</emph>.<comment>changed workflow, see i72652</comment></paragraph>
<paragraph role="listitem" id="par_id4208807" xml-lang="en-US">You should always start with opening the newer document and compare it with the older document.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3145315" xml-lang="en-US">A file selection dialog appears. Select your older original document and confirm the dialog.</paragraph>
<paragraph role="listitem" id="par_id3149762" xml-lang="en-US">
<item type="productname">%PRODUCTNAME</item> combines both documents into the reviewer's document. All text passages that occur in the reviewer's document but not in the original are identified as having been inserted, and all text passages that got deleted by the reviewer are identified as deletions.</paragraph>
</listitem>
<listitem>
<paragraph role="listitem" id="par_id3145674" xml-lang="en-US">You can now accept or reject the insertions and deletions. At the end you may save the reviewer's document as a new original with a new name.</paragraph>
</listitem>
</list>
<section id="relatedtopics">
<embed href="text/shared/guide/redlining.xhp#redlining"/>
<switch select="appl">
<case select="WRITER"><embed href="text/shared/guide/redlining_navigation.xhp#redlining_navigation"/></case>
</switch>
<embed href="text/shared/guide/redlining_enter.xhp#redlining_enter"/>
<embed href="text/shared/guide/redlining_accept.xhp#redlining_accept"/>
<embed href="text/shared/guide/redlining_docmerge.xhp#redlining_docmerge"/>
<embed href="text/shared/guide/redlining_versions.xhp#redlining_versions"/>
</section>
</body>
</helpdocument>