You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@openoffice.apache.org by ks...@apache.org on 2014/02/13 19:38:24 UTC
svn commit: r1568002 [10/13] -
/openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/
Added: openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-79.html
URL: http://svn.apache.org/viewvc/openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-79.html?rev=1568002&view=auto
==============================================================================
--- openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-79.html (added)
+++ openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-79.html Thu Feb 13 18:38:20 2014
@@ -0,0 +1,73 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="" xml:lang="">
+<head>
+<title>Page 79</title>
+
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<style type="text/css">
+<!--
+ p {margin: 0; padding: 0;} .ft00{font-size:13px;color:#000000;}
+ .ft01{font-size:13px;color:#000000;}
+ .ft02{font-size:11px;color:#707177;}
+ .ft03{font-size:13px;color:#5a547c;}
+ .ft04{font-size:13px;color:#000000;}
+ .ft05{font-size:11px;color:#000000;}
+ .ft06{font-size:11px;color:#000000;}
+ .ft07{font-size:13px;line-height:21px;color:#000000;}
+-->
+</style>
+</head>
+<body bgcolor="#A0A0A0" vlink="blue" link="blue">
+<div id="page79-div" style="position:relative;width:892px;height:1263px;">
+<img width="892" height="1263" src="OOo2HelpAuthoring079.png" alt="background image"/>
+<p style="position:absolute;top:136px;left:236px;white-space:nowrap" class="ft00"><b>Sections</b></p>
+<p style="position:absolute;top:162px;left:236px;white-space:nowrap" class="ft01">A  </p>
+<p style="position:absolute;top:164px;left:253px;white-space:nowrap" class="ft02">section</p>
+<p style="position:absolute;top:162px;left:309px;white-space:nowrap" class="ft01">  in the help file maps to a section in  OpenOffice.org. You can use the </p>
+<p style="position:absolute;top:184px;left:236px;white-space:nowrap" class="ft01">navigator to get an overview of existing sections or use the </p>
+<p style="position:absolute;top:185px;left:634px;white-space:nowrap" class="ft03"><b>Insert - Section</b></p>
+<p style="position:absolute;top:184px;left:778px;white-space:nowrap" class="ft01"> and </p>
+<p style="position:absolute;top:208px;left:236px;white-space:nowrap" class="ft03"><b>Format - Sections  </b></p>
+<p style="position:absolute;top:207px;left:403px;white-space:nowrap" class="ft01">menus to modify existing sections. The section  </p>
+<p style="position:absolute;top:209px;left:731px;white-space:nowrap" class="ft02">ID</p>
+<p style="position:absolute;top:207px;left:747px;white-space:nowrap" class="ft01">  maps to </p>
+<p style="position:absolute;top:230px;left:236px;white-space:nowrap" class="ft01">the section name in OpenOffice.org. Nested sections are supported. </p>
+<p style="position:absolute;top:281px;left:236px;white-space:nowrap" class="ft00"><b>Tables</b></p>
+<p style="position:absolute;top:307px;left:236px;white-space:nowrap" class="ft07">A   table   in   an  OpenOffice.org  help   file   transforms   to   a   visible   table   in   the <br/>OpenOffice.org file. The table name holds all attributes for that table. If the table has a <br/>caption defined in the help file, a paragraph is created directly after the table that <br/>contains the caption. It is important that this sequence is <i>not modified</i> since the export <br/>filter relies on that sequence. </p>
+<p style="position:absolute;top:431px;left:236px;white-space:nowrap" class="ft07">Tables   should   no   longer   be   used   for   formatting   purposes,   for   instance,   to   place <br/>images or to mimic numbered lists. Nevertheless, there still is a considerable amount <br/>of legacy help files that do that.</p>
+<p style="position:absolute;top:525px;left:236px;white-space:nowrap" class="ft00"><b>Images</b></p>
+<p style="position:absolute;top:551px;left:236px;white-space:nowrap" class="ft07">Images   are   mapped   to   image   objects   in  OpenOffice.org  that   are  <i>linked</i>  (not <br/>embedded) to the OpenOffice.org file and anchored <i>as character</i>. The alternative text <br/>is defined in the  </p>
+<p style="position:absolute;top:595px;left:354px;white-space:nowrap" class="ft03"><b>Alternative</b></p>
+<p style="position:absolute;top:594px;left:453px;white-space:nowrap" class="ft01">  property of the image object that can be accessed </p>
+<p style="position:absolute;top:617px;left:236px;white-space:nowrap" class="ft01">through   the  </p>
+<p style="position:absolute;top:618px;left:327px;white-space:nowrap" class="ft03"><b>Graphics</b></p>
+<p style="position:absolute;top:617px;left:399px;white-space:nowrap" class="ft01">  properties   dialog   (by   double-clicking   the   image)   on   the </p>
+<p style="position:absolute;top:640px;left:236px;white-space:nowrap" class="ft03"><b>Options</b></p>
+<p style="position:absolute;top:639px;left:299px;white-space:nowrap" class="ft01"> tab page. The </p>
+<p style="position:absolute;top:642px;left:401px;white-space:nowrap" class="ft02">ID</p>
+<p style="position:absolute;top:639px;left:417px;white-space:nowrap" class="ft01"> of an image is stored in the name of the image object and </p>
+<p style="position:absolute;top:662px;left:236px;white-space:nowrap" class="ft01">should not be altered manually.</p>
+<p style="position:absolute;top:715px;left:236px;white-space:nowrap" class="ft05">â· The images will only be displayed in  OpenOffice.org  correctly if the path to the image files was </p>
+<p style="position:absolute;top:734px;left:257px;white-space:nowrap" class="ft05">correctly specified in the import and export filters (<a href="OOo2HelpAuthoring-79.html">see  </a>on <a href="OOo2HelpAuthoring-79.html">page )</a>.</p>
+<p style="position:absolute;top:796px;left:236px;white-space:nowrap" class="ft00"><b>Lists</b></p>
+<p style="position:absolute;top:823px;left:236px;white-space:nowrap" class="ft07">There are two types of lists in the help (unordered and ordered) that match to the <br/>corresponding list type in OpenOffice.org. </p>
+<p style="position:absolute;top:895px;left:236px;white-space:nowrap" class="ft00"><b>Embedding</b></p>
+<p style="position:absolute;top:921px;left:236px;white-space:nowrap" class="ft07">The embedding technique is unique to the help. Therefore, we use some workarounds <br/>to implement embedding when editing the help files in OpenOffice.org: </p>
+<p style="position:absolute;top:981px;left:263px;white-space:nowrap" class="ft01">â¢</p>
+<p style="position:absolute;top:983px;left:290px;white-space:nowrap" class="ft04"><i>Sections to be embedded</i> are represented as sections. </p>
+<p style="position:absolute;top:1015px;left:263px;white-space:nowrap" class="ft01">â¢</p>
+<p style="position:absolute;top:1016px;left:290px;white-space:nowrap" class="ft04"><i>Paragraph parts to be embedded</i><b> </b>are surrounded by a </p>
+<p style="position:absolute;top:1018px;left:652px;white-space:nowrap" class="ft02">variable</p>
+<p style="position:absolute;top:1016px;left:717px;white-space:nowrap" class="ft01"> tag pair.</p>
+<p style="position:absolute;top:1048px;left:263px;white-space:nowrap" class="ft01">â¢</p>
+<p style="position:absolute;top:1049px;left:290px;white-space:nowrap" class="ft04"><i>Places where sections are embedded</i><b> </b>are designated by an </p>
+<p style="position:absolute;top:1052px;left:688px;white-space:nowrap" class="ft02">embed</p>
+<p style="position:absolute;top:1049px;left:729px;white-space:nowrap" class="ft01"> tag. </p>
+<p style="position:absolute;top:1081px;left:263px;white-space:nowrap" class="ft01">â¢</p>
+<p style="position:absolute;top:1083px;left:290px;white-space:nowrap" class="ft04"><i>Places   where   parts   of   paragraphs   are   embedded</i><b>  </b>are   designated   by   an </p>
+<p style="position:absolute;top:1108px;left:290px;white-space:nowrap" class="ft02">embedvar</p>
+<p style="position:absolute;top:1106px;left:354px;white-space:nowrap" class="ft01"> tag. </p>
+<p style="position:absolute;top:1148px;left:795px;white-space:nowrap" class="ft06"><b>79</b></p>
+</div>
+</body>
+</html>
Added: openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-8.html
URL: http://svn.apache.org/viewvc/openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-8.html?rev=1568002&view=auto
==============================================================================
--- openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-8.html (added)
+++ openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-8.html Thu Feb 13 18:38:20 2014
@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="" xml:lang="">
+<head>
+<title>Page 8</title>
+
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<style type="text/css">
+<!--
+ p {margin: 0; padding: 0;}-->
+</style>
+</head>
+<body bgcolor="#A0A0A0" vlink="blue" link="blue">
+<div id="page8-div" style="position:relative;width:892px;height:1263px;">
+<img width="892" height="1263" src="OOo2HelpAuthoring008.png" alt="background image"/>
+</div>
+</body>
+</html>
Added: openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-80.html
URL: http://svn.apache.org/viewvc/openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-80.html?rev=1568002&view=auto
==============================================================================
--- openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-80.html (added)
+++ openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-80.html Thu Feb 13 18:38:20 2014
@@ -0,0 +1,68 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="" xml:lang="">
+<head>
+<title>Page 80</title>
+
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<style type="text/css">
+<!--
+ p {margin: 0; padding: 0;} .ft00{font-size:16px;color:#000000;}
+ .ft01{font-size:13px;color:#000000;}
+ .ft02{font-size:13px;color:#000000;}
+ .ft03{font-size:11px;color:#707177;}
+ .ft04{font-size:11px;color:#000000;}
+ .ft05{font-size:11px;color:#000000;}
+ .ft06{font-size:11px;color:#000000;}
+ .ft07{font-size:13px;color:#000000;}
+ .ft08{font-size:13px;color:#5a547c;}
+ .ft09{font-size:11px;color:#000000;}
+ .ft010{font-size:13px;line-height:21px;color:#000000;}
+ .ft011{font-size:13px;line-height:21px;color:#000000;}
+ .ft012{font-size:11px;line-height:18px;color:#000000;}
+-->
+</style>
+</head>
+<body bgcolor="#A0A0A0" vlink="blue" link="blue">
+<div id="page80-div" style="position:relative;width:892px;height:1263px;">
+<img width="892" height="1263" src="OOo2HelpAuthoring080.png" alt="background image"/>
+<p style="position:absolute;top:136px;left:193px;white-space:nowrap" class="ft00"><b>Character Formatting</b></p>
+<p style="position:absolute;top:170px;left:193px;white-space:nowrap" class="ft011">Direct (hard) formatting is <i>not</i> supported. Any character with a direct format will <i>lose <br/></i>its   format   definition   on   export.   Instead,   character   formatting   is   achieved   using <br/>character   styles.   The   importing   template   already   contains   a   list   of   pre-defined <br/>character styles. All styles that begin with </p>
+<p style="position:absolute;top:236px;left:480px;white-space:nowrap" class="ft03">hlp_</p>
+<p style="position:absolute;top:234px;left:512px;white-space:nowrap" class="ft01"> can be used for character formatting </p>
+<p style="position:absolute;top:256px;left:193px;white-space:nowrap" class="ft01">except for the styles beginning with  </p>
+<p style="position:absolute;top:258px;left:446px;white-space:nowrap" class="ft03">hlp_aux_</p>
+<p style="position:absolute;top:256px;left:511px;white-space:nowrap" class="ft01">  because those are used for internal </p>
+<p style="position:absolute;top:278px;left:193px;white-space:nowrap" class="ft01">purpose.</p>
+<p style="position:absolute;top:317px;left:193px;white-space:nowrap" class="ft011">Similar   to   the   paragraph   styles,   you   can   define   new   character   styles   that   are <br/>transformed to </p>
+<p style="position:absolute;top:341px;left:295px;white-space:nowrap" class="ft03">type</p>
+<p style="position:absolute;top:339px;left:327px;white-space:nowrap" class="ft01"> attributes of </p>
+<p style="position:absolute;top:341px;left:415px;white-space:nowrap" class="ft03">item</p>
+<p style="position:absolute;top:339px;left:447px;white-space:nowrap" class="ft01"> elements in the help files on export. To do this, </p>
+<p style="position:absolute;top:361px;left:193px;white-space:nowrap" class="ft01">create a custom character style beginning with  </p>
+<p style="position:absolute;top:363px;left:524px;white-space:nowrap" class="ft03">hlp_</p>
+<p style="position:absolute;top:361px;left:556px;white-space:nowrap" class="ft01">  and ending in the type name </p>
+<p style="position:absolute;top:383px;left:193px;white-space:nowrap" class="ft01">(e.g.,  </p>
+<p style="position:absolute;top:386px;left:236px;white-space:nowrap" class="ft03">hlp_dialogname</p>
+<p style="position:absolute;top:386px;left:349px;white-space:nowrap" class="ft04">)</p>
+<p style="position:absolute;top:383px;left:357px;white-space:nowrap" class="ft01">.   This   new   style   will   be   recreated   on   loading   that   file   in </p>
+<p style="position:absolute;top:405px;left:193px;white-space:nowrap" class="ft011">OpenOffice.org  next   time.   However,   there   will   be   no   formatting   information   for <br/>OpenOffice.org  associated with it. For that, the style needs to be added to the help <br/>authoring template.</p>
+<p style="position:absolute;top:501px;left:193px;white-space:nowrap" class="ft05">â· Note that these styles don't have any effect on the help as it is displayed <i>as such</i>. In order to adjust </p>
+<p style="position:absolute;top:521px;left:214px;white-space:nowrap" class="ft012">the help appearance, the item types that are created from the character styles must be transformed <br/>by the main transformation style sheet and/or assigned to formats using the style sheets of the help.</p>
+<p style="position:absolute;top:602px;left:193px;white-space:nowrap" class="ft00"><b>Working With the Help Files</b></p>
+<p style="position:absolute;top:650px;left:193px;white-space:nowrap" class="ft05">â· Ensure that you have set up your work environment correctly as described in <a href="OOo2HelpAuthoring-75.html"><i>Setting Up the Envi</i>-</a></p>
+<p style="position:absolute;top:669px;left:214px;white-space:nowrap" class="ft06"><a href="OOo2HelpAuthoring-75.html"><i>ronment</i></a> on <a href="OOo2HelpAuthoring-75.html">page 75.</a></p>
+<p style="position:absolute;top:731px;left:193px;white-space:nowrap" class="ft07"><b>Creating A Help File</b></p>
+<p style="position:absolute;top:757px;left:220px;white-space:nowrap" class="ft01">1. Start OpenOffice.org and open a new empty Writer window.</p>
+<p style="position:absolute;top:778px;left:247px;white-space:nowrap" class="ft011">The help authoring menu is only available in the <b>Writer context</b>. So you need <br/>to have a Writer window open.</p>
+<p style="position:absolute;top:839px;left:220px;white-space:nowrap" class="ft01">2. Choose </p>
+<p style="position:absolute;top:840px;left:303px;white-space:nowrap" class="ft08"><b>Help Authoring - Create New Help File</b></p>
+<p style="position:absolute;top:839px;left:636px;white-space:nowrap" class="ft01">.</p>
+<p style="position:absolute;top:861px;left:247px;white-space:nowrap" class="ft011">You should always create a new file this way to ensure that all settings are <br/>made correctly.</p>
+<p style="position:absolute;top:921px;left:220px;white-space:nowrap" class="ft01">3. Select a file name inside the help directory structure</p>
+<p style="position:absolute;top:943px;left:247px;white-space:nowrap" class="ft011">The directory structure is described on page <a href="OOo2HelpAuthoring-75.html"> 75</a>. You will be automatically <br/>prompted to save the file. You need to save it before you can actually work on <br/>it.</p>
+<p style="position:absolute;top:1024px;left:220px;white-space:nowrap" class="ft01">4. Insert an initial comment (optional)</p>
+<p style="position:absolute;top:1046px;left:247px;white-space:nowrap" class="ft011">You will be prompted to insert a comment on file creation. This comment will <br/>be stored in the file metadata and cannot be changed using OpenOffice.org.</p>
+<p style="position:absolute;top:1148px;left:85px;white-space:nowrap" class="ft09"><b>80</b></p>
+</div>
+</body>
+</html>
Added: openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-81.html
URL: http://svn.apache.org/viewvc/openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-81.html?rev=1568002&view=auto
==============================================================================
--- openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-81.html (added)
+++ openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-81.html Thu Feb 13 18:38:20 2014
@@ -0,0 +1,74 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="" xml:lang="">
+<head>
+<title>Page 81</title>
+
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<style type="text/css">
+<!--
+ p {margin: 0; padding: 0;} .ft00{font-size:13px;color:#000000;}
+ .ft01{font-size:11px;color:#707177;}
+ .ft02{font-size:13px;color:#000000;}
+ .ft03{font-size:13px;color:#5a547c;}
+ .ft04{font-size:11px;color:#000000;}
+ .ft05{font-size:11px;color:#000000;}
+ .ft06{font-size:13px;color:#000000;}
+ .ft07{font-size:13px;color:#5a547c;}
+ .ft08{font-size:8px;color:#000000;}
+ .ft09{font-size:8px;color:#000080;}
+ .ft010{font-size:11px;color:#000000;}
+ .ft011{font-size:13px;line-height:21px;color:#000000;}
+ .ft012{font-size:11px;line-height:18px;color:#000000;}
+-->
+</style>
+</head>
+<body bgcolor="#A0A0A0" vlink="blue" link="blue">
+<div id="page81-div" style="position:relative;width:892px;height:1263px;">
+<img width="892" height="1263" src="OOo2HelpAuthoring081.png" alt="background image"/>
+<p style="position:absolute;top:136px;left:236px;white-space:nowrap" class="ft011">Now you have created a fresh empty help document. The file title is set to the generic <br/>term </p>
+<p style="position:absolute;top:160px;left:270px;white-space:nowrap" class="ft01"><Set Topic Title></p>
+<p style="position:absolute;top:157px;left:408px;white-space:nowrap" class="ft00">. To adjust the topic title see<a href="OOo2HelpAuthoring-94.html"> <i>Meta Data </i></a>on page<a href="OOo2HelpAuthoring-94.html"> 94.</a></p>
+<p style="position:absolute;top:197px;left:236px;white-space:nowrap" class="ft00">Switch the Stylist to show </p>
+<p style="position:absolute;top:198px;left:413px;white-space:nowrap" class="ft03"><b>Custom</b></p>
+<p style="position:absolute;top:197px;left:467px;white-space:nowrap" class="ft00"> styles to view a list of all styles that are allowed in </p>
+<p style="position:absolute;top:220px;left:236px;white-space:nowrap" class="ft011">the help file. None but these (and the ones created by you following the guidelines <br/>above) can be used.</p>
+<p style="position:absolute;top:294px;left:236px;white-space:nowrap" class="ft04">â· After the file is finished it needs to be added to the list of files to be processed by the help compiler. </p>
+<p style="position:absolute;top:314px;left:257px;white-space:nowrap" class="ft012">This is done by adding the file to the makefile of its directory. You can either do that manually or run <br/>the </p>
+<p style="position:absolute;top:332px;left:277px;white-space:nowrap" class="ft01">createmakefiles.pl</p>
+<p style="position:absolute;top:332px;left:423px;white-space:nowrap" class="ft04"> script when you have finished working on the help files. For details, </p>
+<p style="position:absolute;top:352px;left:257px;white-space:nowrap" class="ft04">see <a href="OOo2HelpAuthoring-19.html"><i>Building the Help Set </i></a>on page <a href="OOo2HelpAuthoring-19.html">19</a>.</p>
+<p style="position:absolute;top:414px;left:236px;white-space:nowrap" class="ft06"><b>Opening A Help File</b></p>
+<p style="position:absolute;top:440px;left:263px;white-space:nowrap" class="ft00">1. Choose </p>
+<p style="position:absolute;top:441px;left:345px;white-space:nowrap" class="ft03"><b>File â Open</b></p>
+<p style="position:absolute;top:440px;left:448px;white-space:nowrap" class="ft00"> </p>
+<p style="position:absolute;top:462px;left:290px;white-space:nowrap" class="ft00">Browse to the file you want to open and select  </p>
+<p style="position:absolute;top:463px;left:623px;white-space:nowrap" class="ft03"><b>Help (*.xhp)</b></p>
+<p style="position:absolute;top:462px;left:733px;white-space:nowrap" class="ft00">  as the file </p>
+<p style="position:absolute;top:485px;left:290px;white-space:nowrap" class="ft00">type</p>
+<p style="position:absolute;top:524px;left:263px;white-space:nowrap" class="ft00">2. Click </p>
+<p style="position:absolute;top:525px;left:326px;white-space:nowrap" class="ft03"><b>Open</b></p>
+<p style="position:absolute;top:524px;left:362px;white-space:nowrap" class="ft00"> </p>
+<p style="position:absolute;top:576px;left:236px;white-space:nowrap" class="ft06"><b>Removing A Help File</b></p>
+<p style="position:absolute;top:602px;left:236px;white-space:nowrap" class="ft011">Since a help file is referenced from multiple locations, simply deleting a file from disk <br/>is <i>not</i> sufficient for removing a help file from the set of help files.</p>
+<p style="position:absolute;top:662px;left:236px;white-space:nowrap" class="ft011">To remove a help file from the set of help files that are compiled, you need to remove <br/>it from the <i>makefile</i> of its directory. In this way, it will not be included in the index, or <br/>the full text search. However, it will still be included in the help files archive </p>
+<p style="position:absolute;top:708px;left:733px;white-space:nowrap" class="ft01">*.jar</p>
+<p style="position:absolute;top:705px;left:774px;white-space:nowrap" class="ft00">.</p>
+<p style="position:absolute;top:745px;left:236px;white-space:nowrap" class="ft011">To  delete  a   help  file  completely,  you  need  to  <i>remove  it   from   your  local  disk</i>  and <br/>remove its entry in the <i>makefile</i> of its directory. If you work on the CVS you also need <br/>to <i>remove it from the CVS repository</i>.</p>
+<p style="position:absolute;top:826px;left:236px;white-space:nowrap" class="ft011">You also  need to remove all  <i>dependency files</i>  in  the output tree that are created <br/>during a help build that refer to the deleted file See also <a href="OOo2HelpAuthoring-19.html"><i>Building the Help Set</i> </a>on page <br/><a href="OOo2HelpAuthoring-19.html">19</a>. If you haven't built the help set before you don't need to worry about this. If you <br/>have changed multiple files it is safer to remove the output tree completely and rebuild <br/>the help from scratch.</p>
+<p style="position:absolute;top:951px;left:236px;white-space:nowrap" class="ft011">Finally, you need to ensure that the deleted file is not referenced by other help files or <br/>by the content files </p>
+<p style="position:absolute;top:974px;left:365px;white-space:nowrap" class="ft01">*.tree</p>
+<p style="position:absolute;top:972px;left:413px;white-space:nowrap" class="ft00"> in the auxiliary directory.</p>
+<p style="position:absolute;top:1016px;left:236px;white-space:nowrap" class="ft07"><i>To remove a help file</i></p>
+<p style="position:absolute;top:1043px;left:263px;white-space:nowrap" class="ft00">1. If this change will be committed back to the CVS, remove the help file from </p>
+<p style="position:absolute;top:1064px;left:290px;white-space:nowrap" class="ft00">the CVS repository, for example, using the </p>
+<p style="position:absolute;top:1066px;left:575px;white-space:nowrap" class="ft01">cvs remove</p>
+<p style="position:absolute;top:1064px;left:656px;white-space:nowrap" class="ft00"> command. <a href="OOo2HelpAuthoring-81.html">[11]</a></p>
+<p style="position:absolute;top:1114px;left:128px;white-space:nowrap" class="ft08">11 See<a href="http://tools.openoffice.org/"> </a></p>
+<p style="position:absolute;top:1115px;left:170px;white-space:nowrap" class="ft09"><a href="http://tools.openoffice.org/">http://tools.openoffice.org/</a></p>
+<p style="position:absolute;top:1115px;left:170px;white-space:nowrap" class="ft09"><a href="http://tools.openoffice.org/"> </a></p>
+<p style="position:absolute;top:1115px;left:341px;white-space:nowrap" class="ft09"><a href="http://tools.openoffice.org/">    </a></p>
+<p style="position:absolute;top:1114px;left:350px;white-space:nowrap" class="ft08">for information about OpenOffice.org CVS</p>
+<p style="position:absolute;top:1148px;left:795px;white-space:nowrap" class="ft010"><b>81</b></p>
+</div>
+</body>
+</html>
Added: openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-82.html
URL: http://svn.apache.org/viewvc/openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-82.html?rev=1568002&view=auto
==============================================================================
--- openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-82.html (added)
+++ openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-82.html Thu Feb 13 18:38:20 2014
@@ -0,0 +1,79 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="" xml:lang="">
+<head>
+<title>Page 82</title>
+
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<style type="text/css">
+<!--
+ p {margin: 0; padding: 0;} .ft00{font-size:13px;color:#000000;}
+ .ft01{font-size:11px;color:#707177;}
+ .ft02{font-size:13px;color:#000000;}
+ .ft03{font-size:11px;color:#000000;}
+ .ft04{font-size:11px;color:#666666;}
+ .ft05{font-size:16px;color:#000000;}
+ .ft06{font-size:13px;color:#000000;}
+ .ft07{font-size:11px;color:#000000;}
+ .ft08{font-size:13px;line-height:21px;color:#000000;}
+ .ft09{font-size:11px;line-height:18px;color:#000000;}
+-->
+</style>
+</head>
+<body bgcolor="#A0A0A0" vlink="blue" link="blue">
+<div id="page82-div" style="position:relative;width:892px;height:1263px;">
+<img width="892" height="1263" src="OOo2HelpAuthoring082.png" alt="background image"/>
+<p style="position:absolute;top:136px;left:220px;white-space:nowrap" class="ft00">2. Delete the help file on your local disk. </p>
+<p style="position:absolute;top:175px;left:220px;white-space:nowrap" class="ft00">3. In  the  </p>
+<p style="position:absolute;top:177px;left:295px;white-space:nowrap" class="ft01">makefile.mk</p>
+<p style="position:absolute;top:175px;left:384px;white-space:nowrap" class="ft00">  of  its  directory,   locate  the  help   file's entry (it  has the </p>
+<p style="position:absolute;top:197px;left:247px;white-space:nowrap" class="ft00">extension </p>
+<p style="position:absolute;top:199px;left:315px;white-space:nowrap" class="ft01">.hzip</p>
+<p style="position:absolute;top:197px;left:356px;white-space:nowrap" class="ft00"> instead of .</p>
+<p style="position:absolute;top:199px;left:433px;white-space:nowrap" class="ft01">xhp</p>
+<p style="position:absolute;top:197px;left:458px;white-space:nowrap" class="ft00">) and delete the corresponding line.</p>
+<p style="position:absolute;top:197px;left:725px;white-space:nowrap" class="ft00"> </p>
+<p style="position:absolute;top:219px;left:247px;white-space:nowrap" class="ft00">This   step   is   not   required   if   you   use   the  </p>
+<p style="position:absolute;top:222px;left:545px;white-space:nowrap" class="ft01">createmakefile.pl</p>
+<p style="position:absolute;top:219px;left:682px;white-space:nowrap" class="ft00">  script   from </p>
+<p style="position:absolute;top:244px;left:247px;white-space:nowrap" class="ft01">helpcontent2/helpers</p>
+<p style="position:absolute;top:242px;left:409px;white-space:nowrap" class="ft00"> to update all makefiles before building the help.</p>
+<p style="position:absolute;top:281px;left:220px;white-space:nowrap" class="ft00">4. Check   if   the   help   file   is   referenced   in   on   of   the  </p>
+<p style="position:absolute;top:284px;left:653px;white-space:nowrap" class="ft01">*.tree</p>
+<p style="position:absolute;top:281px;left:701px;white-space:nowrap" class="ft00">  files   in </p>
+<p style="position:absolute;top:306px;left:247px;white-space:nowrap" class="ft01">helpcontent2/source/auxiliary</p>
+<p style="position:absolute;top:304px;left:482px;white-space:nowrap" class="ft00"> and delete its reference there, if required.</p>
+<p style="position:absolute;top:343px;left:220px;white-space:nowrap" class="ft00">5. If you have built the help before and you have an existing output tree with </p>
+<p style="position:absolute;top:365px;left:247px;white-space:nowrap" class="ft00">dependency   files  </p>
+<p style="position:absolute;top:367px;left:372px;white-space:nowrap" class="ft01">*.dphh</p>
+<p style="position:absolute;top:365px;left:421px;white-space:nowrap" class="ft00">,   delete   any   dependency   files   that   reference   the </p>
+<p style="position:absolute;top:387px;left:247px;white-space:nowrap" class="ft00">deleted help file. A dependency file lists all files that it depends on.</p>
+<p style="position:absolute;top:438px;left:193px;white-space:nowrap" class="ft02"><b>Moving A Help File</b></p>
+<p style="position:absolute;top:464px;left:193px;white-space:nowrap" class="ft08">From the build environment's view, moving a help file from one directory to another is <br/>equivalent to removing a file from one directory and creating a file in another directory.</p>
+<p style="position:absolute;top:524px;left:220px;white-space:nowrap" class="ft00">1. Copy the help files to the new directory.</p>
+<p style="position:absolute;top:563px;left:220px;white-space:nowrap" class="ft00">2. Follow the procedure described previously for removing a help file.</p>
+<p style="position:absolute;top:602px;left:220px;white-space:nowrap" class="ft00">3. Ensure that all links inside the moved help file to itself have been adjusted.</p>
+<p style="position:absolute;top:641px;left:220px;white-space:nowrap" class="ft00">4. Add the file to the </p>
+<p style="position:absolute;top:643px;left:368px;white-space:nowrap" class="ft01">makefile</p>
+<p style="position:absolute;top:641px;left:433px;white-space:nowrap" class="ft00"> of the new directory.</p>
+<p style="position:absolute;top:663px;left:247px;white-space:nowrap" class="ft00">This   step   is   not   required   if   you   use   the  </p>
+<p style="position:absolute;top:665px;left:545px;white-space:nowrap" class="ft01">createmakefile.pl</p>
+<p style="position:absolute;top:663px;left:682px;white-space:nowrap" class="ft00">  script   from </p>
+<p style="position:absolute;top:687px;left:247px;white-space:nowrap" class="ft01">helpcontent2/helpers</p>
+<p style="position:absolute;top:685px;left:409px;white-space:nowrap" class="ft00"> to update all makefiles before building the help.</p>
+<p style="position:absolute;top:739px;left:193px;white-space:nowrap" class="ft03">â· Note that moving a help file </p>
+<p style="position:absolute;top:738px;left:365px;white-space:nowrap" class="ft04">can</p>
+<p style="position:absolute;top:739px;left:387px;white-space:nowrap" class="ft03"> create new localization effort since the moved help file looks like a </p>
+<p style="position:absolute;top:758px;left:214px;white-space:nowrap" class="ft09">brand new file to the localization process. However, translation memory systems should be able to <br/>automatically translate it because the content did not change - except for internal links.</p>
+<p style="position:absolute;top:839px;left:193px;white-space:nowrap" class="ft05"><b>Sections and Paragraphs</b></p>
+<p style="position:absolute;top:873px;left:193px;white-space:nowrap" class="ft08">Sections are used to specify parts of help files that are used for referencing purpose in <br/>other files. Sections can be embedded and linked.</p>
+<p style="position:absolute;top:946px;left:193px;white-space:nowrap" class="ft02"><b>Where Are The Sections?</b></p>
+<p style="position:absolute;top:972px;left:193px;white-space:nowrap" class="ft08">Since OpenOffice.org  natively supports sections, we make use of them to represent <br/>sections in help files. The  </p>
+<p style="position:absolute;top:995px;left:374px;white-space:nowrap" class="ft01">ID</p>
+<p style="position:absolute;top:993px;left:390px;white-space:nowrap" class="ft00">  attribute of a section in the help is represented by the </p>
+<p style="position:absolute;top:1018px;left:193px;white-space:nowrap" class="ft01">name</p>
+<p style="position:absolute;top:1015px;left:225px;white-space:nowrap" class="ft00"> property of the section in OpenOffice.org.</p>
+<p style="position:absolute;top:1055px;left:193px;white-space:nowrap" class="ft08">All other properties of sections inside  OpenOffice.org  have no influence on the help <br/>sections. Any layout settings made to sections (background, visibility...) are  <i>lost</i>  on <br/>next reload.</p>
+<p style="position:absolute;top:1148px;left:85px;white-space:nowrap" class="ft07"><b>82</b></p>
+</div>
+</body>
+</html>
Added: openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-83.html
URL: http://svn.apache.org/viewvc/openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-83.html?rev=1568002&view=auto
==============================================================================
--- openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-83.html (added)
+++ openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-83.html Thu Feb 13 18:38:20 2014
@@ -0,0 +1,63 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="" xml:lang="">
+<head>
+<title>Page 83</title>
+
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<style type="text/css">
+<!--
+ p {margin: 0; padding: 0;} .ft00{font-size:13px;color:#000000;}
+ .ft01{font-size:11px;color:#707177;}
+ .ft02{font-size:13px;color:#000000;}
+ .ft03{font-size:11px;color:#666666;}
+ .ft04{font-size:13px;color:#000000;}
+ .ft05{font-size:13px;color:#5a547c;}
+ .ft06{font-size:11px;color:#000000;}
+ .ft07{font-size:11px;color:#000000;}
+ .ft08{font-size:12px;color:#000000;-moz-transform: matrix( 0, -1, 0.9960456986, 0, 0, 0);-webkit-transform: matrix( 0, -1, 0.9960456986, 0, 0, 0);-o-transform: matrix( 0, -1, 0.9960456986, 0, 0, 0);-ms-transform: matrix( 0, -1, 0.9960456986, 0, 0, 0);-moz-transform-origin: left 75%;-webkit-transform-origin: left 75%;-o-transform-origin: left 75%;-ms-transform-origin: left 75%;}
+ .ft09{font-size:13px;line-height:21px;color:#000000;}
+-->
+</style>
+</head>
+<body bgcolor="#A0A0A0" vlink="blue" link="blue">
+<div id="page83-div" style="position:relative;width:892px;height:1263px;">
+<img width="892" height="1263" src="OOo2HelpAuthoring083.png" alt="background image"/>
+<p style="position:absolute;top:136px;left:236px;white-space:nowrap" class="ft09">You can use the navigator to view and navigate sections. Nested sections are also <br/>supported ,both by the help and by OpenOffice.org.</p>
+<p style="position:absolute;top:196px;left:236px;white-space:nowrap" class="ft00">Sections start and end with a </p>
+<p style="position:absolute;top:198px;left:435px;white-space:nowrap" class="ft01">section</p>
+<p style="position:absolute;top:196px;left:492px;white-space:nowrap" class="ft00"> tag that is placed in the first paragraph directly </p>
+<p style="position:absolute;top:218px;left:236px;white-space:nowrap" class="ft00">after the section starts, and in the last paragraph before the section ends:</p>
+<p style="position:absolute;top:476px;left:236px;white-space:nowrap" class="ft09">If you want to insert something before or after a section, ensure that you place it <br/>before or after the section delimiter line, not just before or after the </p>
+<p style="position:absolute;top:500px;left:679px;white-space:nowrap" class="ft01">section</p>
+<p style="position:absolute;top:497px;left:736px;white-space:nowrap" class="ft00"> tag.</p>
+<p style="position:absolute;top:537px;left:236px;white-space:nowrap" class="ft09">If the section  <i>starts at the top</i>  of the document and you want to insert something <br/>before that section, go to the top of the section and press  </p>
+<p style="position:absolute;top:561px;left:645px;white-space:nowrap" class="ft03"><b>Alt+Return</b></p>
+<p style="position:absolute;top:558px;left:726px;white-space:nowrap" class="ft00">  to create a </p>
+<p style="position:absolute;top:581px;left:236px;white-space:nowrap" class="ft00">paragraph in front of the section.</p>
+<p style="position:absolute;top:619px;left:236px;white-space:nowrap" class="ft09">If the section <i>ends at the bottom</i> of the document and you want to insert something <br/>after that section, go to the bottom of the section and press </p>
+<p style="position:absolute;top:643px;left:648px;white-space:nowrap" class="ft03"><b>Alt+Return</b></p>
+<p style="position:absolute;top:641px;left:729px;white-space:nowrap" class="ft00"> to create a </p>
+<p style="position:absolute;top:663px;left:236px;white-space:nowrap" class="ft00">paragraph after the section.</p>
+<p style="position:absolute;top:714px;left:236px;white-space:nowrap" class="ft04"><b>Adding A Section</b></p>
+<p style="position:absolute;top:740px;left:263px;white-space:nowrap" class="ft00">1. Depending on whether you want to insert a new empty section or build a </p>
+<p style="position:absolute;top:762px;left:290px;white-space:nowrap" class="ft00">section around existing text, do one of the following:</p>
+<p style="position:absolute;top:800px;left:289px;white-space:nowrap" class="ft00">â¢</p>
+<p style="position:absolute;top:802px;left:316px;white-space:nowrap" class="ft00">Place the cursor where you want to insert the new empty section.</p>
+<p style="position:absolute;top:834px;left:289px;white-space:nowrap" class="ft00">â¢</p>
+<p style="position:absolute;top:835px;left:316px;white-space:nowrap" class="ft00">Mark the piece of the document that you want to include in a section.</p>
+<p style="position:absolute;top:867px;left:263px;white-space:nowrap" class="ft00">2. Choose </p>
+<p style="position:absolute;top:868px;left:345px;white-space:nowrap" class="ft05"><b>Help Authoring - Insert Section</b></p>
+<p style="position:absolute;top:907px;left:263px;white-space:nowrap" class="ft00">3. Insert an identifier for the section in the text box.</p>
+<p style="position:absolute;top:929px;left:290px;white-space:nowrap" class="ft00">This section identifier will be used as  </p>
+<p style="position:absolute;top:931px;left:549px;white-space:nowrap" class="ft01">ID</p>
+<p style="position:absolute;top:929px;left:566px;white-space:nowrap" class="ft00">  attribute for the section in the help </p>
+<p style="position:absolute;top:951px;left:290px;white-space:nowrap" class="ft09">file.  It   must   be  <i>unique  within  the   file</i>.   It  is  advisable  to   use  some  kind   of <br/>descriptive name. Use only letters, numbers and the underscore.</p>
+<p style="position:absolute;top:1148px;left:795px;white-space:nowrap" class="ft06"><b>83</b></p>
+<p style="position:absolute;top:441px;left:236px;white-space:nowrap" class="ft07"><i>Fig. 6: Section tags and section areas</i></p>
+<p style="position:absolute;top:357px;left:611px;white-space:nowrap" class="ft08">S</p>
+<p style="position:absolute;top:347px;left:611px;white-space:nowrap" class="ft08">ec</p>
+<p style="position:absolute;top:332px;left:611px;white-space:nowrap" class="ft08">tio</p>
+<p style="position:absolute;top:316px;left:611px;white-space:nowrap" class="ft08">n</p>
+</div>
+</body>
+</html>
Added: openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-84.html
URL: http://svn.apache.org/viewvc/openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-84.html?rev=1568002&view=auto
==============================================================================
--- openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-84.html (added)
+++ openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-84.html Thu Feb 13 18:38:20 2014
@@ -0,0 +1,56 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="" xml:lang="">
+<head>
+<title>Page 84</title>
+
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<style type="text/css">
+<!--
+ p {margin: 0; padding: 0;} .ft00{font-size:13px;color:#000000;}
+ .ft01{font-size:13px;color:#000000;}
+ .ft02{font-size:13px;color:#000000;}
+ .ft03{font-size:13px;color:#5a547c;}
+ .ft04{font-size:11px;color:#000000;}
+ .ft05{font-size:11px;color:#707177;}
+ .ft06{font-size:11px;color:#000000;}
+ .ft07{font-size:13px;line-height:21px;color:#000000;}
+-->
+</style>
+</head>
+<body bgcolor="#A0A0A0" vlink="blue" link="blue">
+<div id="page84-div" style="position:relative;width:892px;height:1263px;">
+<img width="892" height="1263" src="OOo2HelpAuthoring084.png" alt="background image"/>
+<p style="position:absolute;top:136px;left:193px;white-space:nowrap" class="ft00"><b>Adding A Subsection</b></p>
+<p style="position:absolute;top:162px;left:193px;white-space:nowrap" class="ft07">A subsection is a section that is the child of another section. OpenOffice.org supports <br/>nested  sections.  The  procedure  to  insert  a subsection  is  the  same  as  inserting  a <br/>section, except that if you insert a section with the cursor inside an existing section <br/>you will create a subsection.</p>
+<p style="position:absolute;top:265px;left:193px;white-space:nowrap" class="ft07">You cannot create overlapping sections. Neither the help format nor OpenOffice.org <br/>support this. </p>
+<p style="position:absolute;top:337px;left:193px;white-space:nowrap" class="ft00"><b>Removing A Section</b></p>
+<p style="position:absolute;top:364px;left:220px;white-space:nowrap" class="ft01">1. If   you   want   to   remove   a   section  <i>including</i>  its   content,   delete   the   section </p>
+<p style="position:absolute;top:385px;left:247px;white-space:nowrap" class="ft01">content first.</p>
+<p style="position:absolute;top:424px;left:220px;white-space:nowrap" class="ft01">2. Choose </p>
+<p style="position:absolute;top:425px;left:303px;white-space:nowrap" class="ft03"><b>Format â Sections</b></p>
+<p style="position:absolute;top:424px;left:456px;white-space:nowrap" class="ft01">.</p>
+<p style="position:absolute;top:464px;left:220px;white-space:nowrap" class="ft01">3. Select   the   section   you   want   to   remove   from   the   list   of   sections   and   click </p>
+<p style="position:absolute;top:486px;left:247px;white-space:nowrap" class="ft03"><b>Remove</b></p>
+<p style="position:absolute;top:485px;left:301px;white-space:nowrap" class="ft01">.</p>
+<p style="position:absolute;top:508px;left:247px;white-space:nowrap" class="ft07">If you remove a section that has subsections only, the selected section will be <br/>removed while the subsections will be preserved.</p>
+<p style="position:absolute;top:582px;left:193px;white-space:nowrap" class="ft04">â· If you remove a section, ensure that no other file references it to avoid broken links.</p>
+<p style="position:absolute;top:646px;left:193px;white-space:nowrap" class="ft00"><b>Linking To A Section</b></p>
+<p style="position:absolute;top:672px;left:193px;white-space:nowrap" class="ft07">You can create a link to a section by specifying the section ID as the target in the <br/>hyperlink URL when creating a link, for example</p>
+<p style="position:absolute;top:739px;left:224px;white-space:nowrap" class="ft04"><link href="text/shared/guide/file_name.xhp#section_id"></p>
+<p style="position:absolute;top:769px;left:193px;white-space:nowrap" class="ft01">For details, see <a href="OOo2HelpAuthoring-94.html"><i>Linking</i></a> on page <a href="OOo2HelpAuthoring-94.html">94.</a></p>
+<p style="position:absolute;top:820px;left:193px;white-space:nowrap" class="ft00"><b>Embedding A Section</b></p>
+<p style="position:absolute;top:846px;left:193px;white-space:nowrap" class="ft01">You can embed a section using the </p>
+<p style="position:absolute;top:849px;left:440px;white-space:nowrap" class="ft05">embed</p>
+<p style="position:absolute;top:846px;left:481px;white-space:nowrap" class="ft01"> element. You need the file name and the </p>
+<p style="position:absolute;top:869px;left:193px;white-space:nowrap" class="ft05">ID</p>
+<p style="position:absolute;top:868px;left:209px;white-space:nowrap" class="ft01">  of   the   section   that   you   want   to   embed.   The   embedded   section   preserves   its </p>
+<p style="position:absolute;top:890px;left:193px;white-space:nowrap" class="ft01">structure. For details on embedding, see <a href="OOo2HelpAuthoring-93.html"><i>Embedding Content</i></a><i> </i>on page <a href="OOo2HelpAuthoring-93.html">93.</a></p>
+<p style="position:absolute;top:941px;left:193px;white-space:nowrap" class="ft00"><b>Adding A Paragraph</b></p>
+<p style="position:absolute;top:967px;left:193px;white-space:nowrap" class="ft07">Paragraphs in the Help have some attribute values that cannot be represented in <br/>OpenOffice.org without using certain workarounds. Therefore, you need to follow the <br/>following instructions to create valid paragraphs.</p>
+<p style="position:absolute;top:1049px;left:193px;white-space:nowrap" class="ft01">You can write the paragraph content in the usual way. You only have to ensure that</p>
+<p style="position:absolute;top:1087px;left:220px;white-space:nowrap" class="ft01">â¢</p>
+<p style="position:absolute;top:1089px;left:247px;white-space:nowrap" class="ft01">the paragraph has <i>meta information</i> associated with it </p>
+<p style="position:absolute;top:1148px;left:85px;white-space:nowrap" class="ft06"><b>84</b></p>
+</div>
+</body>
+</html>
Added: openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-85.html
URL: http://svn.apache.org/viewvc/openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-85.html?rev=1568002&view=auto
==============================================================================
--- openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-85.html (added)
+++ openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-85.html Thu Feb 13 18:38:20 2014
@@ -0,0 +1,85 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="" xml:lang="">
+<head>
+<title>Page 85</title>
+
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<style type="text/css">
+<!--
+ p {margin: 0; padding: 0;} .ft00{font-size:13px;color:#000000;}
+ .ft01{font-size:13px;color:#000000;}
+ .ft02{font-size:11px;color:#707177;}
+ .ft03{font-size:11px;color:#000000;}
+ .ft04{font-size:13px;color:#5a547c;}
+ .ft05{font-size:13px;color:#000000;}
+ .ft06{font-size:8px;color:#000000;}
+ .ft07{font-size:11px;color:#707177;}
+ .ft08{font-size:11px;color:#000000;}
+ .ft09{font-size:13px;line-height:21px;color:#000000;}
+-->
+</style>
+</head>
+<body bgcolor="#A0A0A0" vlink="blue" link="blue">
+<div id="page85-div" style="position:relative;width:892px;height:1263px;">
+<img width="892" height="1263" src="OOo2HelpAuthoring085.png" alt="background image"/>
+<p style="position:absolute;top:136px;left:263px;white-space:nowrap" class="ft00">â¢</p>
+<p style="position:absolute;top:137px;left:290px;white-space:nowrap" class="ft00">the paragraph has a valid <i>paragraph format</i> assigned </p>
+<p style="position:absolute;top:169px;left:236px;white-space:nowrap" class="ft00">The paragraph <i>meta information</i> consists of the paragraph </p>
+<p style="position:absolute;top:172px;left:629px;white-space:nowrap" class="ft02">ID</p>
+<p style="position:absolute;top:169px;left:645px;white-space:nowrap" class="ft00">, the </p>
+<p style="position:absolute;top:172px;left:679px;white-space:nowrap" class="ft02">language</p>
+<p style="position:absolute;top:169px;left:744px;white-space:nowrap" class="ft00"> (which in </p>
+<p style="position:absolute;top:192px;left:236px;white-space:nowrap" class="ft00">the source files is always  </p>
+<p style="position:absolute;top:194px;left:415px;white-space:nowrap" class="ft02">en-US</p>
+<p style="position:absolute;top:192px;left:455px;white-space:nowrap" class="ft00">), the  </p>
+<p style="position:absolute;top:194px;left:497px;white-space:nowrap" class="ft02">localize</p>
+<p style="position:absolute;top:192px;left:562px;white-space:nowrap" class="ft00">  attribute, and some other attributes </p>
+<p style="position:absolute;top:214px;left:236px;white-space:nowrap" class="ft00">that are not relevant in this context.</p>
+<p style="position:absolute;top:253px;left:236px;white-space:nowrap" class="ft09">All of these values are stored in a <i>variable field</i> at the beginning of the paragraph. The <br/>paragraph </p>
+<p style="position:absolute;top:276px;left:308px;white-space:nowrap" class="ft02">ID</p>
+<p style="position:absolute;top:274px;left:324px;white-space:nowrap" class="ft00"> identifies the paragraph contents in the localization database. </p>
+<p style="position:absolute;top:328px;left:236px;white-space:nowrap" class="ft03">â· If the </p>
+<p style="position:absolute;top:328px;left:288px;white-space:nowrap" class="ft02">ID</p>
+<p style="position:absolute;top:328px;left:304px;white-space:nowrap" class="ft03"> of a paragraph gets lost or is changed it is regarded as new for the database and needs to </p>
+<p style="position:absolute;top:348px;left:257px;white-space:nowrap" class="ft03">be localized again. So tampering with </p>
+<p style="position:absolute;top:348px;left:459px;white-space:nowrap" class="ft02">IDs</p>
+<p style="position:absolute;top:348px;left:483px;white-space:nowrap" class="ft03"> must be strictly avoided.</p>
+<p style="position:absolute;top:399px;left:236px;white-space:nowrap" class="ft00">Before saving the final file, each paragraph must have a valid and unique  </p>
+<p style="position:absolute;top:402px;left:755px;white-space:nowrap" class="ft02">ID</p>
+<p style="position:absolute;top:399px;left:771px;white-space:nowrap" class="ft00">. The </p>
+<p style="position:absolute;top:421px;left:236px;white-space:nowrap" class="ft09">easiest way to do this is to place the cursor somewhere in the paragraph and to <br/>choose </p>
+<p style="position:absolute;top:444px;left:288px;white-space:nowrap" class="ft04"><b>Help Authoring - Paragraph - Set Paragraph ID</b></p>
+<p style="position:absolute;top:443px;left:694px;white-space:nowrap" class="ft00">. If the paragraph </p>
+<p style="position:absolute;top:466px;left:236px;white-space:nowrap" class="ft09">does not  have the correct style associated (see below) ID creation will be denied. <br/>Paragraph IDs are also be assigned when the file is validated using </p>
+<p style="position:absolute;top:488px;left:691px;white-space:nowrap" class="ft04"><b>HelpAuthoring </b></p>
+<p style="position:absolute;top:511px;left:236px;white-space:nowrap" class="ft04"><b>â Validate</b></p>
+<p style="position:absolute;top:511px;left:326px;white-space:nowrap" class="ft00">.</p>
+<p style="position:absolute;top:550px;left:236px;white-space:nowrap" class="ft09">Not all paragraphs get IDs. Some paragraphs only contain structural information, such <br/>as opening and closing tags, or bookmarks, and don't need an ID because they don't <br/>transform back to content paragraphs in the help file. All these paragraphs have a <br/>paragraph style assigned that starts with </p>
+<p style="position:absolute;top:616px;left:508px;white-space:nowrap" class="ft02">hlp_aux_</p>
+<p style="position:absolute;top:614px;left:573px;white-space:nowrap" class="ft00">. </p>
+<p style="position:absolute;top:654px;left:236px;white-space:nowrap" class="ft09">If you forget to assign IDs to all corresponding paragraphs, the application will do that <br/>for you on saving, provided the template was correctly installed.</p>
+<p style="position:absolute;top:726px;left:236px;white-space:nowrap" class="ft05"><b>Editing A Paragraph</b></p>
+<p style="position:absolute;top:752px;left:236px;white-space:nowrap" class="ft09">Editing the contents of a paragraph does not need any further action. The localization <br/>process finds out for itself when in the content of a paragraph has changed.[<a href="OOo2HelpAuthoring-85.html">12]</a></p>
+<p style="position:absolute;top:812px;left:236px;white-space:nowrap" class="ft00">This has two consequences for the writers:</p>
+<p style="position:absolute;top:851px;left:263px;white-space:nowrap" class="ft00">1. You do not need to worry about whether a change has an influence on the </p>
+<p style="position:absolute;top:872px;left:290px;white-space:nowrap" class="ft00">localization.</p>
+<p style="position:absolute;top:903px;left:263px;white-space:nowrap" class="ft00">2. You cannot force re-translation of a paragraph by just setting any editing flag.</p>
+<p style="position:absolute;top:933px;left:236px;white-space:nowrap" class="ft00">For basic content management purposes, the  </p>
+<p style="position:absolute;top:935px;left:554px;white-space:nowrap" class="ft02">l10n</p>
+<p style="position:absolute;top:933px;left:586px;white-space:nowrap" class="ft00">  attribute of a paragraph can be </p>
+<p style="position:absolute;top:955px;left:236px;white-space:nowrap" class="ft09">used for setting paragraph status values, since this attribute was only relevant for the <br/>migration phase.</p>
+<p style="position:absolute;top:1015px;left:236px;white-space:nowrap" class="ft00">For  instance,  you  can  set  the  paragraph  status  to  </p>
+<p style="position:absolute;top:1018px;left:595px;white-space:nowrap" class="ft02">NEW</p>
+<p style="position:absolute;top:1015px;left:619px;white-space:nowrap" class="ft00">  or  </p>
+<p style="position:absolute;top:1018px;left:647px;white-space:nowrap" class="ft02">CHG</p>
+<p style="position:absolute;top:1015px;left:672px;white-space:nowrap" class="ft00">  (changed) to  allow </p>
+<p style="position:absolute;top:1038px;left:236px;white-space:nowrap" class="ft09">reviewers to easily spot these paragraphs for content review. Any other values come <br/>from  the migration phase and are no longer relevant.  Paragraphs that  have been <br/>reviewed don't carry an </p>
+<p style="position:absolute;top:1083px;left:394px;white-space:nowrap" class="ft02">l10n</p>
+<p style="position:absolute;top:1081px;left:427px;white-space:nowrap" class="ft00"> attribute (or carry an empty one).</p>
+<p style="position:absolute;top:1114px;left:128px;white-space:nowrap" class="ft06">12 For details on the localization process see </p>
+<p style="position:absolute;top:1113px;left:347px;white-space:nowrap" class="ft07">l10n.openoffice.org</p>
+<p style="position:absolute;top:1114px;left:484px;white-space:nowrap" class="ft06">.</p>
+<p style="position:absolute;top:1148px;left:795px;white-space:nowrap" class="ft08"><b>85</b></p>
+</div>
+</body>
+</html>
Added: openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-86.html
URL: http://svn.apache.org/viewvc/openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-86.html?rev=1568002&view=auto
==============================================================================
--- openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-86.html (added)
+++ openoffice/ooo-site/trunk/content/documentation/online_help/helpauthoring/OOo2HelpAuthoring-86.html Thu Feb 13 18:38:20 2014
@@ -0,0 +1,107 @@
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="" xml:lang="">
+<head>
+<title>Page 86</title>
+
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<style type="text/css">
+<!--
+ p {margin: 0; padding: 0;} .ft00{font-size:11px;color:#000000;}
+ .ft01{font-size:11px;color:#000000;}
+ .ft02{font-size:13px;color:#000000;}
+ .ft03{font-size:13px;color:#000000;}
+ .ft04{font-size:13px;color:#000000;}
+ .ft05{font-size:13px;color:#5a547c;}
+ .ft06{font-size:11px;color:#707177;}
+ .ft07{font-size:11px;color:#000000;}
+ .ft08{font-size:11px;color:#000000;}
+ .ft09{font-size:11px;line-height:18px;color:#000000;}
+ .ft010{font-size:13px;line-height:21px;color:#000000;}
+-->
+</style>
+</head>
+<body bgcolor="#A0A0A0" vlink="blue" link="blue">
+<div id="page86-div" style="position:relative;width:892px;height:1263px;">
+<img width="892" height="1263" src="OOo2HelpAuthoring086.png" alt="background image"/>
+<p style="position:absolute;top:147px;left:193px;white-space:nowrap" class="ft00">â· Note that this attribute is evaluated  <i>nowhere</i>. It only influences the display of the paragraph in </p>
+<p style="position:absolute;top:166px;left:214px;white-space:nowrap" class="ft09">OpenOffice.org (the meta data appear with yellow background). If you want to use it, you will have <br/>to take care of its evaluation in the context of content management yourself. </p>
+<p style="position:absolute;top:246px;left:193px;white-space:nowrap" class="ft02"><b>Paragraph Formatting</b></p>
+<p style="position:absolute;top:272px;left:193px;white-space:nowrap" class="ft010">All paragraphs in a help file are formatted using paragraph styles. Direct formatting <br/>(borders,   indentation,   etc.)   is  <i>strictly  unsupported</i>.   In   fact,   all   direct   formatting   will <br/>simply be <i>lost</i> on export.</p>
+<p style="position:absolute;top:354px;left:193px;white-space:nowrap" class="ft010">Use the predefined styles to format the paragraphs. The following styles are available <br/>in the help authoring template (switch to the </p>
+<p style="position:absolute;top:376px;left:487px;white-space:nowrap" class="ft05"><b>Custom</b></p>
+<p style="position:absolute;top:375px;left:541px;white-space:nowrap" class="ft03"> view in the Stylist):</p>
+<p style="position:absolute;top:420px;left:220px;white-space:nowrap" class="ft03">â¢</p>
+<p style="position:absolute;top:423px;left:247px;white-space:nowrap" class="ft06">hlp_default</p>
+<p style="position:absolute;top:444px;left:247px;white-space:nowrap" class="ft03">This is the parent style for all  </p>
+<p style="position:absolute;top:446px;left:460px;white-space:nowrap" class="ft06">hlp_*</p>
+<p style="position:absolute;top:444px;left:501px;white-space:nowrap" class="ft03">  styles and only used as a fallback. It </p>
+<p style="position:absolute;top:466px;left:247px;white-space:nowrap" class="ft03">translates to a </p>
+<p style="position:absolute;top:469px;left:345px;white-space:nowrap" class="ft06">paragraph@role="paragraph"</p>
+<p style="position:absolute;top:466px;left:556px;white-space:nowrap" class="ft03"> in the help file.</p>
+<p style="position:absolute;top:498px;left:220px;white-space:nowrap" class="ft03">â¢</p>
+<p style="position:absolute;top:502px;left:247px;white-space:nowrap" class="ft06">hlp_paragraph</p>
+<p style="position:absolute;top:500px;left:352px;white-space:nowrap" class="ft03"> </p>
+<p style="position:absolute;top:523px;left:247px;white-space:nowrap" class="ft03">This   is   the   standard   style   to   be   used   for   paragraphs.   It   translates   to   a </p>
+<p style="position:absolute;top:547px;left:247px;white-space:nowrap" class="ft06">paragraph@role="paragraph"</p>
+<p style="position:absolute;top:544px;left:458px;white-space:nowrap" class="ft03"> in the help file.</p>
+<p style="position:absolute;top:576px;left:220px;white-space:nowrap" class="ft03">â¢</p>
+<p style="position:absolute;top:580px;left:247px;white-space:nowrap" class="ft06">hlp_head</p>
+<p style="position:absolute;top:578px;left:312px;white-space:nowrap" class="ft03">, and </p>
+<p style="position:absolute;top:580px;left:349px;white-space:nowrap" class="ft06">hlp_head1...hlp_head5</p>
+<p style="position:absolute;top:578px;left:565px;white-space:nowrap" class="ft03"> </p>
+<p style="position:absolute;top:601px;left:247px;white-space:nowrap" class="ft03">The  </p>
+<p style="position:absolute;top:603px;left:280px;white-space:nowrap" class="ft06">hlp_head</p>
+<p style="position:absolute;top:601px;left:345px;white-space:nowrap" class="ft03">  style is the parent style for the other  </p>
+<p style="position:absolute;top:603px;left:615px;white-space:nowrap" class="ft06">hlp_head*</p>
+<p style="position:absolute;top:601px;left:688px;white-space:nowrap" class="ft03">  styles and </p>
+<p style="position:absolute;top:623px;left:247px;white-space:nowrap" class="ft03">should   never   be   used   as   such.   The  </p>
+<p style="position:absolute;top:625px;left:512px;white-space:nowrap" class="ft06">hlp_head*</p>
+<p style="position:absolute;top:623px;left:585px;white-space:nowrap" class="ft03">  styles   designate   heading </p>
+<p style="position:absolute;top:645px;left:247px;white-space:nowrap" class="ft03">elements</p>
+<p style="position:absolute;top:645px;left:326px;white-space:nowrap" class="ft03"> </p>
+<p style="position:absolute;top:645px;left:349px;white-space:nowrap" class="ft03">of</p>
+<p style="position:absolute;top:645px;left:380px;white-space:nowrap" class="ft03"> </p>
+<p style="position:absolute;top:645px;left:402px;white-space:nowrap" class="ft03">different</p>
+<p style="position:absolute;top:645px;left:475px;white-space:nowrap" class="ft03"> </p>
+<p style="position:absolute;top:645px;left:497px;white-space:nowrap" class="ft03">levels.</p>
+<p style="position:absolute;top:645px;left:558px;white-space:nowrap" class="ft03"> </p>
+<p style="position:absolute;top:645px;left:581px;white-space:nowrap" class="ft03">They</p>
+<p style="position:absolute;top:645px;left:632px;white-space:nowrap" class="ft03"> </p>
+<p style="position:absolute;top:645px;left:655px;white-space:nowrap" class="ft03">translate</p>
+<p style="position:absolute;top:645px;left:731px;white-space:nowrap" class="ft03"> </p>
+<p style="position:absolute;top:645px;left:753px;white-space:nowrap" class="ft03">to </p>
+<p style="position:absolute;top:669px;left:247px;white-space:nowrap" class="ft06">paragraph@role="heading"@level="x"</p>
+<p style="position:absolute;top:667px;left:522px;white-space:nowrap" class="ft03"> in the help file with </p>
+<p style="position:absolute;top:669px;left:658px;white-space:nowrap" class="ft07">x</p>
+<p style="position:absolute;top:667px;left:666px;white-space:nowrap" class="ft03"> corresponding </p>
+<p style="position:absolute;top:689px;left:247px;white-space:nowrap" class="ft03">to the heading level.</p>
+<p style="position:absolute;top:720px;left:220px;white-space:nowrap" class="ft03">â¢</p>
+<p style="position:absolute;top:724px;left:247px;white-space:nowrap" class="ft06">hlp_listitem</p>
+<p style="position:absolute;top:745px;left:247px;white-space:nowrap" class="ft010">This is the style to be used for list items. Its use is optional, as paragraphs <br/>inside   list   items  can  also   have   the   paragraph   style.   It   translates   to   a </p>
+<p style="position:absolute;top:790px;left:247px;white-space:nowrap" class="ft06">paragraph@role="listitem"</p>
+<p style="position:absolute;top:787px;left:450px;white-space:nowrap" class="ft03"> in the help file.</p>
+<p style="position:absolute;top:819px;left:220px;white-space:nowrap" class="ft03">â¢</p>
+<p style="position:absolute;top:823px;left:247px;white-space:nowrap" class="ft06">hlp_tablehead</p>
+<p style="position:absolute;top:844px;left:247px;white-space:nowrap" class="ft03">This   is   the   style   to   be   used   for   table   header   cells.   It   translates   to   a </p>
+<p style="position:absolute;top:867px;left:247px;white-space:nowrap" class="ft06">paragraph@role="tablehead"</p>
+<p style="position:absolute;top:865px;left:458px;white-space:nowrap" class="ft03"> </p>
+<p style="position:absolute;top:865px;left:486px;white-space:nowrap" class="ft03">in   the   help   file   when   the </p>
+<p style="position:absolute;top:890px;left:247px;white-space:nowrap" class="ft06">main_transform.xsl</p>
+<p style="position:absolute;top:887px;left:393px;white-space:nowrap" class="ft03"> stylesheet is used.</p>
+<p style="position:absolute;top:919px;left:220px;white-space:nowrap" class="ft03">â¢</p>
+<p style="position:absolute;top:923px;left:247px;white-space:nowrap" class="ft06">hlp_tablecontent</p>
+<p style="position:absolute;top:921px;left:406px;white-space:nowrap" class="ft03"> </p>
+<p style="position:absolute;top:944px;left:247px;white-space:nowrap" class="ft03">This is the style to be used for table content cells. It translates to a </p>
+<p style="position:absolute;top:946px;left:693px;white-space:nowrap" class="ft06">paragraph </p>
+<p style="position:absolute;top:968px;left:247px;white-space:nowrap" class="ft06">@role="tablecontent"</p>
+<p style="position:absolute;top:966px;left:409px;white-space:nowrap" class="ft03"> in the help file.</p>
+<p style="position:absolute;top:998px;left:220px;white-space:nowrap" class="ft03">â¢</p>
+<p style="position:absolute;top:1000px;left:247px;white-space:nowrap" class="ft03">A couple of </p>
+<p style="position:absolute;top:1002px;left:326px;white-space:nowrap" class="ft06">hlp_aux_*</p>
+<p style="position:absolute;top:1000px;left:399px;white-space:nowrap" class="ft03"> styles</p>
+<p style="position:absolute;top:1000px;left:459px;white-space:nowrap" class="ft03"> </p>
+<p style="position:absolute;top:1023px;left:247px;white-space:nowrap" class="ft010">These   are   not   meant   to   be   used   by   the   writers.   These   styles   designate <br/>paragraphs that contain structural information rather than content.</p>
+<p style="position:absolute;top:1148px;left:85px;white-space:nowrap" class="ft08"><b>86</b></p>
+</div>
+</body>
+</html>