| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
| <HTML> |
| <HEAD> |
| <TITLE>HelpAuthoring_c</TITLE> |
| <META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
| <META name="generator" content="pdftohtml 0.36"> |
| <META name="date" content="2006-02-03T15:12:27+00:00"> |
| </HEAD> |
| <BODY bgcolor="#A0A0A0" vlink="blue" link="blue"> |
| <!-- Page 1 --> |
| <a name="1"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| .ft0{font-size:22px;font-family:Times;color:#000000;} |
| .ft1{font-size:19px;font-family:Times;color:#000000;} |
| .ft2{font-size:25px;font-family:Times;color:#000000;} |
| .ft3{font-size:13px;font-family:Times;color:#000000;} |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c001.png" alt="background image"> |
| <DIV style="position:absolute;top:479;left:286"><nobr><span class="ft0"><b>OpenOffice.org 2.0</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:527;left:286"><nobr><span class="ft1">Understanding, Authoring and Editing</span></nobr></DIV> |
| <DIV style="position:absolute;top:563;left:286"><nobr><span class="ft2"><b>OPENOFFICE.ORG HELP</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:720;left:287"><nobr><span class="ft3">Author:</span></nobr></DIV> |
| <DIV style="position:absolute;top:720;left:365"><nobr><span class="ft3">Frank Peters, Sun Microsystems (fpe@openoffice.org)</span></nobr></DIV> |
| <DIV style="position:absolute;top:746;left:287"><nobr><span class="ft3">Version:</span></nobr></DIV> |
| <DIV style="position:absolute;top:746;left:365"><nobr><span class="ft3">2.0_16</span></nobr></DIV> |
| <DIV style="position:absolute;top:772;left:287"><nobr><span class="ft3">Date:</span></nobr></DIV> |
| <DIV style="position:absolute;top:772;left:365"><nobr><span class="ft3">Feb 3, 2006</span></nobr></DIV> |
| </DIV> |
| <!-- Page 2 --> |
| <a name="2"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c002.png" alt="background image"> |
| </DIV> |
| <!-- Page 3 --> |
| <a name="3"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| .ft4{font-size:10px;font-family:Times;color:#000000;} |
| .ft5{font-size:10px;font-family:Times;color:#000000;} |
| .ft6{font-size:10px;font-family:Times;color:#00007f;} |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c003.png" alt="background image"> |
| <DIV style="position:absolute;top:94;left:128"><nobr><span class="ft4"><b>Public Documentation License Notice </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:115;left:128"><nobr><span class="ft5">The contents of this Documentation are subject to the Public Documentation License Version 1.0 (the "License"); you may only </span></nobr></DIV> |
| <DIV style="position:absolute;top:129;left:128"><nobr><span class="ft5">use this Documentation if you comply with the terms of this License. A copy of the License is available at </span></nobr></DIV> |
| <DIV style="position:absolute;top:142;left:128"><nobr><span class="ft6"><A href="http://www.openoffice.org/licenses/PDL.html">http://www.openoffice.org/licenses/PDL.html</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:142;left:362"><nobr><span class="ft5"><A href="http://www.openoffice.org/licenses/PDL.html">.</a> </span></nobr></DIV> |
| <DIV style="position:absolute;top:164;left:128"><nobr><span class="ft5">The Initial Writer of the Original Documentation is Sun Microsystems Inc. Copyright (C) 2005. All Rights Reserved. (Initial Writer </span></nobr></DIV> |
| <DIV style="position:absolute;top:178;left:128"><nobr><span class="ft5">contact(s): </span></nobr></DIV> |
| <DIV style="position:absolute;top:178;left:187"><nobr><span class="ft6"><A href="mailto:fpe@sun.com">fpe@sun.com</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:178;left:261"><nobr><span class="ft5">).</span></nobr></DIV> |
| <DIV style="position:absolute;top:200;left:128"><nobr><span class="ft5">Contributor(s): ______________________________________. </span></nobr></DIV> |
| </DIV> |
| <!-- Page 4 --> |
| <a name="4"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c004.png" alt="background image"> |
| </DIV> |
| <!-- Page 5 --> |
| <a name="5"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| .ft7{font-size:22px;font-family:Times;color:#000000;} |
| .ft8{font-size:13px;font-family:Times;color:#000000;} |
| .ft9{font-size:11px;font-family:Times;color:#000000;} |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c005.png" alt="background image"> |
| <DIV style="position:absolute;top:112;left:128"><nobr><span class="ft7">Contents</span></nobr></DIV> |
| <DIV style="position:absolute;top:164;left:236"><nobr><span class="ft8"><b>1 How OpenOffice.org Help Works............................................................................9</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:190;left:257"><nobr><span class="ft9">Help Ingredients......................................................................................................................9</span></nobr></DIV> |
| <DIV style="position:absolute;top:205;left:278"><nobr><span class="ft5">Extended Tips....................................................................................................................................9</span></nobr></DIV> |
| <DIV style="position:absolute;top:218;left:278"><nobr><span class="ft5">Context-Sensitive Help......................................................................................................................9</span></nobr></DIV> |
| <DIV style="position:absolute;top:232;left:278"><nobr><span class="ft5">Hierarchical List of Contents............................................................................................................10</span></nobr></DIV> |
| <DIV style="position:absolute;top:245;left:278"><nobr><span class="ft5">Index of Keywords...........................................................................................................................10</span></nobr></DIV> |
| <DIV style="position:absolute;top:259;left:278"><nobr><span class="ft5">Full-Text Search..............................................................................................................................10</span></nobr></DIV> |
| <DIV style="position:absolute;top:272;left:278"><nobr><span class="ft5">Bookmarks.......................................................................................................................................11</span></nobr></DIV> |
| <DIV style="position:absolute;top:285;left:278"><nobr><span class="ft5">Help Agent.......................................................................................................................................11</span></nobr></DIV> |
| <DIV style="position:absolute;top:307;left:257"><nobr><span class="ft9">Installed Help Files................................................................................................................13</span></nobr></DIV> |
| <DIV style="position:absolute;top:322;left:278"><nobr><span class="ft5">Help Modules and Help Sections.....................................................................................................13</span></nobr></DIV> |
| <DIV style="position:absolute;top:336;left:278"><nobr><span class="ft5">Help Module Configuration Files......................................................................................................14</span></nobr></DIV> |
| <DIV style="position:absolute;top:349;left:278"><nobr><span class="ft5">Help Module Contents Files (Section Archives)...............................................................................15</span></nobr></DIV> |
| <DIV style="position:absolute;top:363;left:278"><nobr><span class="ft5">Help Module Lookup Tables (Databases)........................................................................................15</span></nobr></DIV> |
| <DIV style="position:absolute;top:376;left:278"><nobr><span class="ft5">Help Module Extended Tip Files......................................................................................................15</span></nobr></DIV> |
| <DIV style="position:absolute;top:389;left:278"><nobr><span class="ft5">Help Module Index Files..................................................................................................................16</span></nobr></DIV> |
| <DIV style="position:absolute;top:403;left:278"><nobr><span class="ft5">The Main Transformation Style Sheet..............................................................................................16</span></nobr></DIV> |
| <DIV style="position:absolute;top:416;left:278"><nobr><span class="ft5">The Cascading Style Sheets............................................................................................................16</span></nobr></DIV> |
| <DIV style="position:absolute;top:438;left:257"><nobr><span class="ft9">Application Help Calls...........................................................................................................16</span></nobr></DIV> |
| <DIV style="position:absolute;top:462;left:257"><nobr><span class="ft9">Structure of the CVS Help Module........................................................................................18</span></nobr></DIV> |
| <DIV style="position:absolute;top:485;left:257"><nobr><span class="ft9">Building the Help Set.............................................................................................................19</span></nobr></DIV> |
| <DIV style="position:absolute;top:500;left:278"><nobr><span class="ft5">Setting Up a Build Environment.......................................................................................................19</span></nobr></DIV> |
| <DIV style="position:absolute;top:514;left:278"><nobr><span class="ft5">Makefiles for the Help......................................................................................................................19</span></nobr></DIV> |
| <DIV style="position:absolute;top:527;left:278"><nobr><span class="ft5">Help Build Process..........................................................................................................................21</span></nobr></DIV> |
| <DIV style="position:absolute;top:541;left:278"><nobr><span class="ft5">Adding a help file to or Removing a help file from the set of help files.............................................22</span></nobr></DIV> |
| <DIV style="position:absolute;top:554;left:278"><nobr><span class="ft5">Help Images.....................................................................................................................................22</span></nobr></DIV> |
| <DIV style="position:absolute;top:584;left:236"><nobr><span class="ft8"><b>2 Help File XML format Basics.................................................................................23</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:610;left:257"><nobr><span class="ft9">Basic Document Structure.....................................................................................................23</span></nobr></DIV> |
| <DIV style="position:absolute;top:633;left:257"><nobr><span class="ft9">Using Variables.....................................................................................................................23</span></nobr></DIV> |
| <DIV style="position:absolute;top:657;left:257"><nobr><span class="ft9">Paragraph Roles...................................................................................................................24</span></nobr></DIV> |
| <DIV style="position:absolute;top:680;left:257"><nobr><span class="ft9">Defining Index, Contents, and Context Sensitivity................................................................25</span></nobr></DIV> |
| <DIV style="position:absolute;top:695;left:278"><nobr><span class="ft5">Contents Branch..............................................................................................................................25</span></nobr></DIV> |
| <DIV style="position:absolute;top:709;left:278"><nobr><span class="ft5">Index Branch....................................................................................................................................26</span></nobr></DIV> |
| <DIV style="position:absolute;top:722;left:278"><nobr><span class="ft5">"hid" Branch.....................................................................................................................................26</span></nobr></DIV> |
| <DIV style="position:absolute;top:744;left:257"><nobr><span class="ft9">Switching Content.................................................................................................................27</span></nobr></DIV> |
| <DIV style="position:absolute;top:759;left:278"><nobr><span class="ft5">Switching Complete Paragraphs or Sections...................................................................................27</span></nobr></DIV> |
| <DIV style="position:absolute;top:773;left:278"><nobr><span class="ft5">Switching Text Fragments Inside Paragraphs..................................................................................28</span></nobr></DIV> |
| <DIV style="position:absolute;top:795;left:257"><nobr><span class="ft9">Embedding Content...............................................................................................................28</span></nobr></DIV> |
| <DIV style="position:absolute;top:810;left:278"><nobr><span class="ft5">Embedding Complete Sections........................................................................................................29</span></nobr></DIV> |
| <DIV style="position:absolute;top:823;left:278"><nobr><span class="ft5">Embedding text fragments...............................................................................................................29</span></nobr></DIV> |
| <DIV style="position:absolute;top:845;left:257"><nobr><span class="ft9">Images and Icons..................................................................................................................30</span></nobr></DIV> |
| <DIV style="position:absolute;top:869;left:257"><nobr><span class="ft9">Localization Information........................................................................................................31</span></nobr></DIV> |
| <DIV style="position:absolute;top:892;left:257"><nobr><span class="ft9">Auxiliary Files........................................................................................................................31</span></nobr></DIV> |
| <DIV style="position:absolute;top:907;left:278"><nobr><span class="ft5">Files used for building the help........................................................................................................31</span></nobr></DIV> |
| <DIV style="position:absolute;top:921;left:278"><nobr><span class="ft5">Main transformation stylesheet........................................................................................................32</span></nobr></DIV> |
| <DIV style="position:absolute;top:934;left:278"><nobr><span class="ft5">Contents definition files *.tree..........................................................................................................32</span></nobr></DIV> |
| <DIV style="position:absolute;top:964;left:236"><nobr><span class="ft8"><b>3 Help File XML Reference.......................................................................................35</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:990;left:257"><nobr><span class="ft9">Common Attributes................................................................................................................35</span></nobr></DIV> |
| <DIV style="position:absolute;top:1005;left:278"><nobr><span class="ft5">xml-Lang..........................................................................................................................................35</span></nobr></DIV> |
| <DIV style="position:absolute;top:1018;left:278"><nobr><span class="ft5">localize.............................................................................................................................................36</span></nobr></DIV> |
| <DIV style="position:absolute;top:1032;left:278"><nobr><span class="ft5">id......................................................................................................................................................36</span></nobr></DIV> |
| <DIV style="position:absolute;top:1054;left:257"><nobr><span class="ft9">Help File (*.xhp) Elements.....................................................................................................37</span></nobr></DIV> |
| <DIV style="position:absolute;top:1069;left:278"><nobr><span class="ft5">ahelp................................................................................................................................................37</span></nobr></DIV> |
| <DIV style="position:absolute;top:1082;left:278"><nobr><span class="ft5">alt.....................................................................................................................................................38</span></nobr></DIV> |
| <DIV style="position:absolute;top:1095;left:278"><nobr><span class="ft5">body.................................................................................................................................................38</span></nobr></DIV> |
| <DIV style="position:absolute;top:1109;left:278"><nobr><span class="ft5">bookmark.........................................................................................................................................39</span></nobr></DIV> |
| <DIV style="position:absolute;top:1122;left:278"><nobr><span class="ft5">bookmark_value..............................................................................................................................40</span></nobr></DIV> |
| <DIV style="position:absolute;top:1136;left:278"><nobr><span class="ft5">br.....................................................................................................................................................41</span></nobr></DIV> |
| <DIV style="position:absolute;top:1149;left:278"><nobr><span class="ft5">caption.............................................................................................................................................41</span></nobr></DIV> |
| </DIV> |
| <!-- Page 6 --> |
| <a name="6"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c006.png" alt="background image"> |
| <DIV style="position:absolute;top:94;left:236"><nobr><span class="ft5">case.................................................................................................................................................42</span></nobr></DIV> |
| <DIV style="position:absolute;top:107;left:236"><nobr><span class="ft5">caseinline.........................................................................................................................................43</span></nobr></DIV> |
| <DIV style="position:absolute;top:120;left:236"><nobr><span class="ft5">comment..........................................................................................................................................43</span></nobr></DIV> |
| <DIV style="position:absolute;top:134;left:236"><nobr><span class="ft5">created.............................................................................................................................................44</span></nobr></DIV> |
| <DIV style="position:absolute;top:147;left:236"><nobr><span class="ft5">default..............................................................................................................................................45</span></nobr></DIV> |
| <DIV style="position:absolute;top:161;left:236"><nobr><span class="ft5">defaultinline......................................................................................................................................45</span></nobr></DIV> |
| <DIV style="position:absolute;top:174;left:236"><nobr><span class="ft5">embed..............................................................................................................................................46</span></nobr></DIV> |
| <DIV style="position:absolute;top:188;left:236"><nobr><span class="ft5">embedvar.........................................................................................................................................47</span></nobr></DIV> |
| <DIV style="position:absolute;top:201;left:236"><nobr><span class="ft5">emph................................................................................................................................................48</span></nobr></DIV> |
| <DIV style="position:absolute;top:214;left:236"><nobr><span class="ft5">filename...........................................................................................................................................48</span></nobr></DIV> |
| <DIV style="position:absolute;top:228;left:236"><nobr><span class="ft5">helpdocument..................................................................................................................................49</span></nobr></DIV> |
| <DIV style="position:absolute;top:241;left:236"><nobr><span class="ft5">help-id-missing.................................................................................................................................49</span></nobr></DIV> |
| <DIV style="position:absolute;top:255;left:236"><nobr><span class="ft5">History.............................................................................................................................................50</span></nobr></DIV> |
| <DIV style="position:absolute;top:268;left:236"><nobr><span class="ft5">image...............................................................................................................................................50</span></nobr></DIV> |
| <DIV style="position:absolute;top:281;left:236"><nobr><span class="ft5">item..................................................................................................................................................51</span></nobr></DIV> |
| <DIV style="position:absolute;top:295;left:236"><nobr><span class="ft5">lastedited.........................................................................................................................................52</span></nobr></DIV> |
| <DIV style="position:absolute;top:308;left:236"><nobr><span class="ft5">link...................................................................................................................................................53</span></nobr></DIV> |
| <DIV style="position:absolute;top:322;left:236"><nobr><span class="ft5">list....................................................................................................................................................54</span></nobr></DIV> |
| <DIV style="position:absolute;top:335;left:236"><nobr><span class="ft5">listitem.............................................................................................................................................55</span></nobr></DIV> |
| <DIV style="position:absolute;top:349;left:236"><nobr><span class="ft5">meta.................................................................................................................................................56</span></nobr></DIV> |
| <DIV style="position:absolute;top:362;left:236"><nobr><span class="ft5">object...............................................................................................................................................57</span></nobr></DIV> |
| <DIV style="position:absolute;top:376;left:236"><nobr><span class="ft5">paragraph........................................................................................................................................58</span></nobr></DIV> |
| <DIV style="position:absolute;top:389;left:236"><nobr><span class="ft5">section.............................................................................................................................................59</span></nobr></DIV> |
| <DIV style="position:absolute;top:402;left:236"><nobr><span class="ft5">sort...................................................................................................................................................60</span></nobr></DIV> |
| <DIV style="position:absolute;top:416;left:236"><nobr><span class="ft5">switch...............................................................................................................................................61</span></nobr></DIV> |
| <DIV style="position:absolute;top:429;left:236"><nobr><span class="ft5">switchinline......................................................................................................................................62</span></nobr></DIV> |
| <DIV style="position:absolute;top:443;left:236"><nobr><span class="ft5">table.................................................................................................................................................63</span></nobr></DIV> |
| <DIV style="position:absolute;top:456;left:236"><nobr><span class="ft5">tablecell...........................................................................................................................................64</span></nobr></DIV> |
| <DIV style="position:absolute;top:469;left:236"><nobr><span class="ft5">tablerow...........................................................................................................................................66</span></nobr></DIV> |
| <DIV style="position:absolute;top:483;left:236"><nobr><span class="ft5">title...................................................................................................................................................67</span></nobr></DIV> |
| <DIV style="position:absolute;top:496;left:236"><nobr><span class="ft5">topic.................................................................................................................................................68</span></nobr></DIV> |
| <DIV style="position:absolute;top:510;left:236"><nobr><span class="ft5">variable............................................................................................................................................69</span></nobr></DIV> |
| <DIV style="position:absolute;top:532;left:214"><nobr><span class="ft9">Contents File (*.tree) Elements.............................................................................................70</span></nobr></DIV> |
| <DIV style="position:absolute;top:547;left:236"><nobr><span class="ft5">Tree_view........................................................................................................................................70</span></nobr></DIV> |
| <DIV style="position:absolute;top:560;left:236"><nobr><span class="ft5">help_section.....................................................................................................................................71</span></nobr></DIV> |
| <DIV style="position:absolute;top:574;left:236"><nobr><span class="ft5">Node................................................................................................................................................72</span></nobr></DIV> |
| <DIV style="position:absolute;top:587;left:236"><nobr><span class="ft5">Topic................................................................................................................................................72</span></nobr></DIV> |
| <DIV style="position:absolute;top:617;left:193"><nobr><span class="ft8"><b>4 Authoring Help With OpenOffice.org ..................................................................75</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:643;left:214"><nobr><span class="ft9">Setting Up the Environment .................................................................................................75</span></nobr></DIV> |
| <DIV style="position:absolute;top:658;left:236"><nobr><span class="ft5">Directory Hierarchy..........................................................................................................................75</span></nobr></DIV> |
| <DIV style="position:absolute;top:671;left:236"><nobr><span class="ft5">Installing the Import/Export Filters....................................................................................................76</span></nobr></DIV> |
| <DIV style="position:absolute;top:685;left:236"><nobr><span class="ft5">Installing the Supporting Macros......................................................................................................76</span></nobr></DIV> |
| <DIV style="position:absolute;top:698;left:236"><nobr><span class="ft5">Installing the Help Authoring Menu..................................................................................................77</span></nobr></DIV> |
| <DIV style="position:absolute;top:720;left:214"><nobr><span class="ft9">Editing Help Files - Basics.....................................................................................................78</span></nobr></DIV> |
| <DIV style="position:absolute;top:735;left:236"><nobr><span class="ft5">Paragraphs and Paragraph Formatting............................................................................................78</span></nobr></DIV> |
| <DIV style="position:absolute;top:748;left:236"><nobr><span class="ft5">Sections...........................................................................................................................................79</span></nobr></DIV> |
| <DIV style="position:absolute;top:762;left:236"><nobr><span class="ft5">Tables..............................................................................................................................................79</span></nobr></DIV> |
| <DIV style="position:absolute;top:775;left:236"><nobr><span class="ft5">Images.............................................................................................................................................79</span></nobr></DIV> |
| <DIV style="position:absolute;top:789;left:236"><nobr><span class="ft5">Lists.................................................................................................................................................79</span></nobr></DIV> |
| <DIV style="position:absolute;top:802;left:236"><nobr><span class="ft5">Embedding.......................................................................................................................................79</span></nobr></DIV> |
| <DIV style="position:absolute;top:824;left:214"><nobr><span class="ft9">Character Formatting............................................................................................................80</span></nobr></DIV> |
| <DIV style="position:absolute;top:848;left:214"><nobr><span class="ft9">Working With the Help Files..................................................................................................80</span></nobr></DIV> |
| <DIV style="position:absolute;top:863;left:236"><nobr><span class="ft5">Creating a Help File.........................................................................................................................80</span></nobr></DIV> |
| <DIV style="position:absolute;top:876;left:236"><nobr><span class="ft5">Opening a Help File.........................................................................................................................81</span></nobr></DIV> |
| <DIV style="position:absolute;top:889;left:236"><nobr><span class="ft5">Removing a Help File.......................................................................................................................81</span></nobr></DIV> |
| <DIV style="position:absolute;top:903;left:236"><nobr><span class="ft5">Moving a Help File...........................................................................................................................82</span></nobr></DIV> |
| <DIV style="position:absolute;top:925;left:214"><nobr><span class="ft9">Sections and Paragraphs......................................................................................................82</span></nobr></DIV> |
| <DIV style="position:absolute;top:940;left:236"><nobr><span class="ft5">Where are the Sections?.................................................................................................................82</span></nobr></DIV> |
| <DIV style="position:absolute;top:953;left:236"><nobr><span class="ft5">Adding a Section..............................................................................................................................83</span></nobr></DIV> |
| <DIV style="position:absolute;top:967;left:236"><nobr><span class="ft5">Adding a Subsection........................................................................................................................84</span></nobr></DIV> |
| <DIV style="position:absolute;top:980;left:236"><nobr><span class="ft5">Removing a Section.........................................................................................................................84</span></nobr></DIV> |
| <DIV style="position:absolute;top:994;left:236"><nobr><span class="ft5">Linking to a Section.........................................................................................................................84</span></nobr></DIV> |
| <DIV style="position:absolute;top:1007;left:236"><nobr><span class="ft5">Embedding a Section.......................................................................................................................84</span></nobr></DIV> |
| <DIV style="position:absolute;top:1020;left:236"><nobr><span class="ft5">Adding a Paragraph.........................................................................................................................84</span></nobr></DIV> |
| <DIV style="position:absolute;top:1034;left:236"><nobr><span class="ft5">Editing a Paragraph.........................................................................................................................85</span></nobr></DIV> |
| <DIV style="position:absolute;top:1047;left:236"><nobr><span class="ft5">Paragraph Formatting......................................................................................................................86</span></nobr></DIV> |
| <DIV style="position:absolute;top:1061;left:236"><nobr><span class="ft5">Creating New Styles........................................................................................................................87</span></nobr></DIV> |
| <DIV style="position:absolute;top:1074;left:236"><nobr><span class="ft5">Changing a Paragraph Style............................................................................................................87</span></nobr></DIV> |
| <DIV style="position:absolute;top:1088;left:236"><nobr><span class="ft5">Changing a Character Style.............................................................................................................87</span></nobr></DIV> |
| <DIV style="position:absolute;top:1101;left:236"><nobr><span class="ft5">Moving a Paragraph Inside a Help File............................................................................................87</span></nobr></DIV> |
| <DIV style="position:absolute;top:1114;left:236"><nobr><span class="ft5">Moving a Paragraph to a Different Help File....................................................................................87</span></nobr></DIV> |
| <DIV style="position:absolute;top:1128;left:236"><nobr><span class="ft5">Excluding a Paragraph from Localization.........................................................................................88</span></nobr></DIV> |
| <DIV style="position:absolute;top:1150;left:214"><nobr><span class="ft9">Tables ...................................................................................................................................89</span></nobr></DIV> |
| </DIV> |
| <!-- Page 7 --> |
| <a name="7"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c007.png" alt="background image"> |
| <DIV style="position:absolute;top:94;left:278"><nobr><span class="ft5">Adding a Table.................................................................................................................................89</span></nobr></DIV> |
| <DIV style="position:absolute;top:107;left:278"><nobr><span class="ft5">Modifying the Table Layout..............................................................................................................89</span></nobr></DIV> |
| <DIV style="position:absolute;top:120;left:278"><nobr><span class="ft5">Deleting a Table...............................................................................................................................90</span></nobr></DIV> |
| <DIV style="position:absolute;top:134;left:278"><nobr><span class="ft5">Using a Table for Formatting Purposes...........................................................................................90</span></nobr></DIV> |
| <DIV style="position:absolute;top:147;left:278"><nobr><span class="ft5">Adding a caption to an existing table...............................................................................................90</span></nobr></DIV> |
| <DIV style="position:absolute;top:169;left:257"><nobr><span class="ft9">Lists.......................................................................................................................................90</span></nobr></DIV> |
| <DIV style="position:absolute;top:184;left:278"><nobr><span class="ft5">Inserting, removing, modifying lists..................................................................................................90</span></nobr></DIV> |
| <DIV style="position:absolute;top:198;left:278"><nobr><span class="ft5">Interrupting a List.............................................................................................................................90</span></nobr></DIV> |
| <DIV style="position:absolute;top:220;left:257"><nobr><span class="ft9">Working with Images.............................................................................................................91</span></nobr></DIV> |
| <DIV style="position:absolute;top:235;left:278"><nobr><span class="ft5">Help Image Repository....................................................................................................................91</span></nobr></DIV> |
| <DIV style="position:absolute;top:248;left:278"><nobr><span class="ft5">Inserting a block image....................................................................................................................92</span></nobr></DIV> |
| <DIV style="position:absolute;top:262;left:278"><nobr><span class="ft5">Inserting an inline image..................................................................................................................92</span></nobr></DIV> |
| <DIV style="position:absolute;top:275;left:278"><nobr><span class="ft5">Adding an image caption.................................................................................................................93</span></nobr></DIV> |
| <DIV style="position:absolute;top:297;left:257"><nobr><span class="ft9">Embedding Content ..............................................................................................................93</span></nobr></DIV> |
| <DIV style="position:absolute;top:312;left:278"><nobr><span class="ft5">Embedding a Section or Variable.....................................................................................................93</span></nobr></DIV> |
| <DIV style="position:absolute;top:334;left:257"><nobr><span class="ft9">Linking...................................................................................................................................94</span></nobr></DIV> |
| <DIV style="position:absolute;top:349;left:278"><nobr><span class="ft5">Linking to another Help file..............................................................................................................94</span></nobr></DIV> |
| <DIV style="position:absolute;top:362;left:278"><nobr><span class="ft5">Linking to the WWW........................................................................................................................94</span></nobr></DIV> |
| <DIV style="position:absolute;top:384;left:257"><nobr><span class="ft9">Meta Data..............................................................................................................................94</span></nobr></DIV> |
| <DIV style="position:absolute;top:399;left:278"><nobr><span class="ft5">Setting the topic title........................................................................................................................95</span></nobr></DIV> |
| <DIV style="position:absolute;top:413;left:278"><nobr><span class="ft5">Setting the topic ID..........................................................................................................................95</span></nobr></DIV> |
| <DIV style="position:absolute;top:426;left:278"><nobr><span class="ft5">Excluding a file from the search index.............................................................................................95</span></nobr></DIV> |
| <DIV style="position:absolute;top:440;left:278"><nobr><span class="ft5">Changing the initial file creation comment.......................................................................................95</span></nobr></DIV> |
| <DIV style="position:absolute;top:453;left:278"><nobr><span class="ft5">Changing the Last Edited comment.................................................................................................95</span></nobr></DIV> |
| <DIV style="position:absolute;top:475;left:257"><nobr><span class="ft9">Bookmarks............................................................................................................................95</span></nobr></DIV> |
| <DIV style="position:absolute;top:490;left:278"><nobr><span class="ft5">Adding a new bookmark set with Index Entries................................................................................95</span></nobr></DIV> |
| <DIV style="position:absolute;top:503;left:278"><nobr><span class="ft5">Adding Index Entries to an existing bookmark set...........................................................................96</span></nobr></DIV> |
| <DIV style="position:absolute;top:517;left:278"><nobr><span class="ft5">Modifying Index Entries in an existing bookmark set.......................................................................97</span></nobr></DIV> |
| <DIV style="position:absolute;top:530;left:278"><nobr><span class="ft5">Adding a new bookmark set with TOC Entries[]...............................................................................97</span></nobr></DIV> |
| <DIV style="position:absolute;top:544;left:278"><nobr><span class="ft5">Adding TOC Entries to an existing bookmark set.............................................................................97</span></nobr></DIV> |
| <DIV style="position:absolute;top:557;left:278"><nobr><span class="ft5">Determining A Help ID.....................................................................................................................98</span></nobr></DIV> |
| <DIV style="position:absolute;top:571;left:278"><nobr><span class="ft5">Adding a Help ID..............................................................................................................................98</span></nobr></DIV> |
| <DIV style="position:absolute;top:592;left:257"><nobr><span class="ft9">Switching Content.................................................................................................................99</span></nobr></DIV> |
| <DIV style="position:absolute;top:607;left:278"><nobr><span class="ft5">Inline switching................................................................................................................................99</span></nobr></DIV> |
| <DIV style="position:absolute;top:621;left:278"><nobr><span class="ft5">Switching complete sections or paragraphs...................................................................................100</span></nobr></DIV> |
| <DIV style="position:absolute;top:643;left:257"><nobr><span class="ft9">Miscellaneous......................................................................................................................103</span></nobr></DIV> |
| <DIV style="position:absolute;top:658;left:278"><nobr><span class="ft5">Extended Tips................................................................................................................................103</span></nobr></DIV> |
| <DIV style="position:absolute;top:671;left:278"><nobr><span class="ft5">Sorting...........................................................................................................................................103</span></nobr></DIV> |
| <DIV style="position:absolute;top:685;left:278"><nobr><span class="ft5">Validating.......................................................................................................................................103</span></nobr></DIV> |
| <DIV style="position:absolute;top:707;left:257"><nobr><span class="ft9">Troubleshooting...................................................................................................................104</span></nobr></DIV> |
| <DIV style="position:absolute;top:722;left:278"><nobr><span class="ft5">A help file cannot be opened.........................................................................................................104</span></nobr></DIV> |
| <DIV style="position:absolute;top:735;left:278"><nobr><span class="ft5">A help file cannot be saved............................................................................................................104</span></nobr></DIV> |
| <DIV style="position:absolute;top:749;left:278"><nobr><span class="ft5">No Help file can be opened or saved.............................................................................................104</span></nobr></DIV> |
| <DIV style="position:absolute;top:762;left:278"><nobr><span class="ft5">Paragraph content has vanished on Reload..................................................................................104</span></nobr></DIV> |
| <DIV style="position:absolute;top:792;left:236"><nobr><span class="ft8"><b>5 Appendix...............................................................................................................105</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:818;left:257"><nobr><span class="ft9">Glossary..............................................................................................................................105</span></nobr></DIV> |
| <DIV style="position:absolute;top:841;left:257"><nobr><span class="ft9">XML Help Document Type Definition..................................................................................108</span></nobr></DIV> |
| </DIV> |
| <!-- Page 8 --> |
| <a name="8"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c008.png" alt="background image"> |
| </DIV> |
| <!-- Page 9 --> |
| <a name="9"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| .ft10{font-size:16px;font-family:Times;color:#000000;} |
| .ft11{font-size:13px;font-family:Times;color:#59537b;} |
| .ft12{font-size:11px;font-family:Times;color:#666666;} |
| .ft13{font-size:13px;font-family:Times;color:#000000;} |
| .ft14{font-size:11px;font-family:Times;color:#6f7176;} |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c009.png" alt="background image"> |
| <DIV style="position:absolute;top:345;left:128"><nobr><span class="ft7">1 How OpenOffice.org Help Works</span></nobr></DIV> |
| <DIV style="position:absolute;top:386;left:236"><nobr><span class="ft3">This chapter gives an overview of the OpenOffice.org 2.0 help system. It describes </span></nobr></DIV> |
| <DIV style="position:absolute;top:407;left:236"><nobr><span class="ft3">the different features of the help system, how it is organized, and how it is built from </span></nobr></DIV> |
| <DIV style="position:absolute;top:429;left:236"><nobr><span class="ft3">the source files.</span></nobr></DIV> |
| <DIV style="position:absolute;top:481;left:236"><nobr><span class="ft10"><b>Help Ingredients</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:515;left:236"><nobr><span class="ft3">The OpenOffice.org help system comprises different help features, which are </span></nobr></DIV> |
| <DIV style="position:absolute;top:536;left:236"><nobr><span class="ft3">explained in detail in the following sections.</span></nobr></DIV> |
| <DIV style="position:absolute;top:587;left:236"><nobr><span class="ft8"><b>Extended Tips</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:613;left:236"><nobr><span class="ft3">Extended Tips are yellow pop-up windows that appear on the application user </span></nobr></DIV> |
| <DIV style="position:absolute;top:634;left:236"><nobr><span class="ft3">interface (UI), and display a short reference text for an element. An extended tip for a </span></nobr></DIV> |
| <DIV style="position:absolute;top:656;left:236"><nobr><span class="ft3">particular UI element is triggered by resting the mouse over that element for a short </span></nobr></DIV> |
| <DIV style="position:absolute;top:677;left:236"><nobr><span class="ft3">amount of time (approx. 1 second). On moving the mouse, the extended tip </span></nobr></DIV> |
| <DIV style="position:absolute;top:699;left:236"><nobr><span class="ft3">disappears.</span></nobr></DIV> |
| <DIV style="position:absolute;top:737;left:236"><nobr><span class="ft3">Display of extended tips is enabled by choosing </span></nobr></DIV> |
| <DIV style="position:absolute;top:738;left:602"><nobr><span class="ft11"><b>HelpTools Options </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:761;left:236"><nobr><span class="ft11"><b>OpenOffice.org General Tips Extended Tips,</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:760;left:697"><nobr><span class="ft3"> or by pressing </span></nobr></DIV> |
| <DIV style="position:absolute;top:785;left:236"><nobr><span class="ft12"><b>Shift+F1</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:783;left:300"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:823;left:236"><nobr><span class="ft3">When the extended tips are enabled by pressing </span></nobr></DIV> |
| <DIV style="position:absolute;top:825;left:580"><nobr><span class="ft12"><b>Shift+F1,</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:823;left:653"><nobr><span class="ft3"> the tips are displayed </span></nobr></DIV> |
| <DIV style="position:absolute;top:845;left:236"><nobr><span class="ft3">without any delay. This mode is exited when a mouse button is clicked.</span></nobr></DIV> |
| <DIV style="position:absolute;top:884;left:236"><nobr><span class="ft3">Extended tips use <i>Help Ids,</i> which are assigned to UI elements to find the correct text </span></nobr></DIV> |
| <DIV style="position:absolute;top:905;left:236"><nobr><span class="ft3">for that UI element. The text itself is defined in the help files inside the </span></nobr></DIV> |
| <DIV style="position:absolute;top:907;left:705"><nobr><span class="ft14">ahelp</span></nobr></DIV> |
| <DIV style="position:absolute;top:905;left:746"><nobr><span class="ft3"> element. </span></nobr></DIV> |
| <DIV style="position:absolute;top:927;left:236"><nobr><span class="ft3">For more information about the structure of the help files, please refer to chapter <A href="HelpAuthoring_c.html#23">2:</a> </span></nobr></DIV> |
| <DIV style="position:absolute;top:949;left:236"><nobr><span class="ft3">"<i><A href="HelpAuthoring_c.html#23">Help File XML format Basics</i></a>" on page<A href="HelpAuthoring_c.html#23"> 23.</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:1000;left:236"><nobr><span class="ft8"><b>Context-Sensitive Help</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1026;left:236"><nobr><span class="ft3">OpenOffice.org Help is context-sensitive, which means that the help viewer displays </span></nobr></DIV> |
| <DIV style="position:absolute;top:1047;left:236"><nobr><span class="ft3">reference information or instructions for the current application context when the help </span></nobr></DIV> |
| <DIV style="position:absolute;top:1069;left:236"><nobr><span class="ft3">is called from within the application. </span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:801"><nobr><span class="ft4"><b>9</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 10 --> |
| <a name="10"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| .ft15{font-size:10px;font-family:Times;color:#000000;} |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c010.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:193"><nobr><span class="ft3">Context-sensitive help is invoked by pressing </span></nobr></DIV> |
| <DIV style="position:absolute;top:138;left:516"><nobr><span class="ft12"><b>F1</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:136;left:532"><nobr><span class="ft3"> or clicking the </span></nobr></DIV> |
| <DIV style="position:absolute;top:137;left:645"><nobr><span class="ft11"><b>Help</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:136;left:681"><nobr><span class="ft3"> button in a </span></nobr></DIV> |
| <DIV style="position:absolute;top:159;left:193"><nobr><span class="ft3">dialog.</span></nobr></DIV> |
| <DIV style="position:absolute;top:197;left:193"><nobr><span class="ft13"><i>Help IDs</i> are used to identify the context. A lookup table is used to find the correct </span></nobr></DIV> |
| <DIV style="position:absolute;top:219;left:193"><nobr><span class="ft3">anchor inside the help file set (see also<A href="HelpAuthoring_c.html#16"> <i>Application Help Calls</i></a> on page <A href="HelpAuthoring_c.html#16">16)</a>. </span></nobr></DIV> |
| <DIV style="position:absolute;top:272;left:193"><nobr><span class="ft5"> Not all contexts are actually mapped to help topics. In that case, the start page of the corresponding </span></nobr></DIV> |
| <DIV style="position:absolute;top:291;left:214"><nobr><span class="ft5">help section is shown.</span></nobr></DIV> |
| <DIV style="position:absolute;top:353;left:193"><nobr><span class="ft8"><b>Hierarchical List Of Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:379;left:193"><nobr><span class="ft3">There is a hierarchical list of help contents available from the </span></nobr></DIV> |
| <DIV style="position:absolute;top:380;left:611"><nobr><span class="ft11"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:379;left:683"><nobr><span class="ft3"> tab page of </span></nobr></DIV> |
| <DIV style="position:absolute;top:402;left:193"><nobr><span class="ft3">the help viewer. This should not be considered a complete table of contents, like in a </span></nobr></DIV> |
| <DIV style="position:absolute;top:423;left:193"><nobr><span class="ft3">book, but a selection of help topics sorted by different application/document types and </span></nobr></DIV> |
| <DIV style="position:absolute;top:445;left:193"><nobr><span class="ft3">task groups (see<A href="HelpAuthoring_c.html#12"> Fig. 1 </a>on page<A href="HelpAuthoring_c.html#12"> 12)</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:484;left:193"><nobr><span class="ft3">Help topics can appear more than once if they fit into multiple application/task groups. </span></nobr></DIV> |
| <DIV style="position:absolute;top:505;left:193"><nobr><span class="ft3">Currently, these contents trees are manually compiled and saved in </span></nobr></DIV> |
| <DIV style="position:absolute;top:507;left:645"><nobr><span class="ft14">*.tree</span></nobr></DIV> |
| <DIV style="position:absolute;top:505;left:693"><nobr><span class="ft3"> files.</span></nobr></DIV> |
| <DIV style="position:absolute;top:545;left:193"><nobr><span class="ft3">In the future, these contents lists will be able to be defined within the help files </span></nobr></DIV> |
| <DIV style="position:absolute;top:566;left:193"><nobr><span class="ft3">themselves. The </span></nobr></DIV> |
| <DIV style="position:absolute;top:568;left:311"><nobr><span class="ft14">*.tree</span></nobr></DIV> |
| <DIV style="position:absolute;top:566;left:360"><nobr><span class="ft3"> files will then be created when the help is compiled in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:588;left:193"><nobr><span class="ft3">software build cycle.</span></nobr></DIV> |
| <DIV style="position:absolute;top:641;left:193"><nobr><span class="ft5"> Note that, although the corresponding elements are included in the help format, these are <i>not yet </i></span></nobr></DIV> |
| <DIV style="position:absolute;top:661;left:214"><nobr><span class="ft5">evaluated by the help compiler. The tree files must still be generated <i>manually</i>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:723;left:193"><nobr><span class="ft8"><b>Index Of Keywords</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:749;left:193"><nobr><span class="ft3">The </span></nobr></DIV> |
| <DIV style="position:absolute;top:750;left:225"><nobr><span class="ft11"><b>Index</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:749;left:270"><nobr><span class="ft3"> tab page of the help viewer contains a two-level keyword index. These </span></nobr></DIV> |
| <DIV style="position:absolute;top:771;left:193"><nobr><span class="ft3">two levels allow for a basic grouping of keywords. The index is displayed per help </span></nobr></DIV> |
| <DIV style="position:absolute;top:793;left:193"><nobr><span class="ft3">module (see <A href="HelpAuthoring_c.html#12">Fig. 2</a> on page <A href="HelpAuthoring_c.html#12">12)</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:832;left:193"><nobr><span class="ft3">After selecting an OpenOffice.org help module from the dropdown list at the top left of </span></nobr></DIV> |
| <DIV style="position:absolute;top:853;left:193"><nobr><span class="ft3">the help viewer, the corresponding list of keywords is loaded.</span></nobr></DIV> |
| <DIV style="position:absolute;top:892;left:193"><nobr><span class="ft3"> Typing a search term directly causes a jump to the next suitable first-level entry in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:913;left:193"><nobr><span class="ft3">index list.</span></nobr></DIV> |
| <DIV style="position:absolute;top:952;left:193"><nobr><span class="ft3">The keywords are defined inside the help files as </span></nobr></DIV> |
| <DIV style="position:absolute;top:954;left:561"><nobr><span class="ft14">bookmark</span></nobr></DIV> |
| <DIV style="position:absolute;top:952;left:626"><nobr><span class="ft3">s. See also section </span></nobr></DIV> |
| <DIV style="position:absolute;top:974;left:193"><nobr><span class="ft13"><A href="HelpAuthoring_c.html#95"><i>Bookmarks</i></a> on page <A href="HelpAuthoring_c.html#95">95</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1025;left:193"><nobr><span class="ft8"><b>Full-Text Search</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1051;left:193"><nobr><span class="ft3">The </span></nobr></DIV> |
| <DIV style="position:absolute;top:1052;left:226"><nobr><span class="ft11"><b>Find</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1051;left:262"><nobr><span class="ft3"> tab page allows you to search through the help content. You can only </span></nobr></DIV> |
| <DIV style="position:absolute;top:1074;left:193"><nobr><span class="ft3">search through one help module at a time (see<A href="HelpAuthoring_c.html#12"> Fig. 3 </a>on page<A href="HelpAuthoring_c.html#12"> 12</a>).</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>10</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 11 --> |
| <a name="11"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c011.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:236"><nobr><span class="ft3">By default, the search engine searches for case-insensitive substrings that appear </span></nobr></DIV> |
| <DIV style="position:absolute;top:157;left:236"><nobr><span class="ft3">anywhere in a help file. You can restrict the search scope by specifying a search for </span></nobr></DIV> |
| <DIV style="position:absolute;top:179;left:236"><nobr><span class="ft3">complete words only, and to only search headings in help files.</span></nobr></DIV> |
| <DIV style="position:absolute;top:218;left:236"><nobr><span class="ft3">The results are displayed sorted by search rank, showing the best matches at the top </span></nobr></DIV> |
| <DIV style="position:absolute;top:239;left:236"><nobr><span class="ft3">of the list.</span></nobr></DIV> |
| <DIV style="position:absolute;top:290;left:236"><nobr><span class="ft8"><b>Bookmarks</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:316;left:236"><nobr><span class="ft3">The </span></nobr></DIV> |
| <DIV style="position:absolute;top:317;left:270"><nobr><span class="ft11"><b>Bookmarks</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:316;left:351"><nobr><span class="ft3"> tab page lists user-defined bookmarks that correspond to help </span></nobr></DIV> |
| <DIV style="position:absolute;top:339;left:236"><nobr><span class="ft3">pages. User-defined bookmarks from all help modules can belong to this list. The icon </span></nobr></DIV> |
| <DIV style="position:absolute;top:360;left:236"><nobr><span class="ft3">next to a bookmark indicates the help module to which the bookmark belongs (see </span></nobr></DIV> |
| <DIV style="position:absolute;top:382;left:236"><nobr><span class="ft3"><A href="HelpAuthoring_c.html#12">Fig. 4</a> on page <A href="HelpAuthoring_c.html#12">12)</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:420;left:236"><nobr><span class="ft3">Double-clicking the bookmark takes you back to the corresponding help page.</span></nobr></DIV> |
| <DIV style="position:absolute;top:459;left:236"><nobr><span class="ft3">Bookmarks can be named individually.</span></nobr></DIV> |
| <DIV style="position:absolute;top:512;left:236"><nobr><span class="ft5"> Don't confuse these bookmarks with the </span></nobr></DIV> |
| <DIV style="position:absolute;top:512;left:473"><nobr><span class="ft14">bookmark</span></nobr></DIV> |
| <DIV style="position:absolute;top:512;left:538"><nobr><span class="ft5"> element in the help XML format.</span></nobr></DIV> |
| <DIV style="position:absolute;top:576;left:236"><nobr><span class="ft8"><b>Help Agent</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:602;left:236"><nobr><span class="ft3">The <i>Help Agent</i> is a small notification window that appears when the user is in a </span></nobr></DIV> |
| <DIV style="position:absolute;top:623;left:236"><nobr><span class="ft3">certain context, for example, when the AutoCorrect function has automatically </span></nobr></DIV> |
| <DIV style="position:absolute;top:644;left:236"><nobr><span class="ft3">modified the text. Clicking the window opens the help at the location that is assigned </span></nobr></DIV> |
| <DIV style="position:absolute;top:666;left:236"><nobr><span class="ft3">to that context. </span></nobr></DIV> |
| <DIV style="position:absolute;top:705;left:236"><nobr><span class="ft3">As with the extended tips and the context sensitive help, the context for the Help </span></nobr></DIV> |
| <DIV style="position:absolute;top:726;left:236"><nobr><span class="ft3">Agent is specified using Help IDs. The IDs that trigger the display of the Help Agent </span></nobr></DIV> |
| <DIV style="position:absolute;top:747;left:236"><nobr><span class="ft3">are </span></nobr></DIV> |
| <DIV style="position:absolute;top:747;left:295"><nobr><span class="ft3">defined </span></nobr></DIV> |
| <DIV style="position:absolute;top:747;left:382"><nobr><span class="ft3">in</span></nobr></DIV> |
| <DIV style="position:absolute;top:747;left:411"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:747;left:432"><nobr><span class="ft3">the</span></nobr></DIV> |
| <DIV style="position:absolute;top:747;left:469"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:747;left:490"><nobr><span class="ft3">file</span></nobr></DIV> |
| <DIV style="position:absolute;top:747;left:543"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:750;left:548"><nobr><span class="ft14">SFX.xcu</span></nobr></DIV> |
| <DIV style="position:absolute;top:747;left:604"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:747;left:642"><nobr><span class="ft3">in</span></nobr></DIV> |
| <DIV style="position:absolute;top:747;left:671"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:747;left:692"><nobr><span class="ft3">the</span></nobr></DIV> |
| <DIV style="position:absolute;top:747;left:729"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:747;left:750"><nobr><span class="ft3">directory </span></nobr></DIV> |
| <DIV style="position:absolute;top:772;left:236"><nobr><span class="ft14">share/registry/data/org/openoffice/Office</span></nobr></DIV> |
| <DIV style="position:absolute;top:770;left:568"><nobr><span class="ft3">. This file is not part of the </span></nobr></DIV> |
| <DIV style="position:absolute;top:794;left:236"><nobr><span class="ft14">helpcontent2</span></nobr></DIV> |
| <DIV style="position:absolute;top:792;left:333"><nobr><span class="ft3"> CVS project.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>11</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 12 --> |
| <a name="12"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c012.png" alt="background image"> |
| <DIV style="position:absolute;top:460;left:94"><nobr><span class="ft15"><i>Fig. 1: List of contents</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:457;left:434"><nobr><span class="ft15"><i>Fig. 2: Keyword Index</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:839;left:94"><nobr><span class="ft15"><i>Fig. 3: Full Text Search</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:836;left:434"><nobr><span class="ft15"><i>Fig. 4: Bookmarks</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>12</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 13 --> |
| <a name="13"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| .ft16{font-size:10px;font-family:Times;color:#ffffff;} |
| .ft17{font-size:10px;font-family:Times;color:#6f7176;} |
| .ft18{font-size:11px;font-family:Times;color:#000000;} |
| .ft19{font-size:8px;font-family:Times;color:#000000;} |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c013.png" alt="background image"> |
| <DIV style="position:absolute;top:154;left:236"><nobr><span class="ft10"><b>Installed Help Files</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:197;left:236"><nobr><span class="ft3">On installation, a </span></nobr></DIV> |
| <DIV style="position:absolute;top:199;left:365"><nobr><span class="ft14">help</span></nobr></DIV> |
| <DIV style="position:absolute;top:197;left:397"><nobr><span class="ft3"> directory is created as child of the main OpenOffice.org </span></nobr></DIV> |
| <DIV style="position:absolute;top:219;left:236"><nobr><span class="ft3">directory. It contains all global files (currently only </span></nobr></DIV> |
| <DIV style="position:absolute;top:221;left:574"><nobr><span class="ft14">main_transform.xsl</span></nobr></DIV> |
| <DIV style="position:absolute;top:219;left:720"><nobr><span class="ft3">), and one or </span></nobr></DIV> |
| <DIV style="position:absolute;top:241;left:236"><nobr><span class="ft3">more subdirectories with language-dependent files. The language directories are </span></nobr></DIV> |
| <DIV style="position:absolute;top:263;left:236"><nobr><span class="ft3">designated by ISO codes, for example, </span></nobr></DIV> |
| <DIV style="position:absolute;top:265;left:513"><nobr><span class="ft14">en-US</span></nobr></DIV> |
| <DIV style="position:absolute;top:263;left:553"><nobr><span class="ft3"> for US-English. The contents of this </span></nobr></DIV> |
| <DIV style="position:absolute;top:285;left:236"><nobr><span class="ft3">language directory are as follows:</span></nobr></DIV> |
| <DIV style="position:absolute;top:326;left:243"><nobr><span class="ft16"><b>Directory/File</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:326;left:448"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:352;left:243"><nobr><span class="ft17">help/</span></nobr></DIV> |
| <DIV style="position:absolute;top:352;left:448"><nobr><span class="ft5">The main help directory</span></nobr></DIV> |
| <DIV style="position:absolute;top:379;left:243"><nobr><span class="ft17">help/main_transform.xsl</span></nobr></DIV> |
| <DIV style="position:absolute;top:379;left:448"><nobr><span class="ft5">The main transformation style sheet (<A href="HelpAuthoring_c.html#16">see <i>The Main</i></a></span></nobr></DIV> |
| <DIV style="position:absolute;top:392;left:448"><nobr><span class="ft15"><A href="HelpAuthoring_c.html#16"><i>Transformation Style Sheet</i> below)</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:418;left:243"><nobr><span class="ft17">help/{lang}</span></nobr></DIV> |
| <DIV style="position:absolute;top:418;left:448"><nobr><span class="ft5">The language dependent help files</span></nobr></DIV> |
| <DIV style="position:absolute;top:445;left:243"><nobr><span class="ft17">help/{lang}/*.css</span></nobr></DIV> |
| <DIV style="position:absolute;top:445;left:448"><nobr><span class="ft5">The cascading style sheets for displaying the help in the help </span></nobr></DIV> |
| <DIV style="position:absolute;top:458;left:448"><nobr><span class="ft5">viewer (<A href="HelpAuthoring_c.html#16">see <i>The Cascading Style Sheets</i> below)</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:484;left:243"><nobr><span class="ft17">help/{lang}/err.html</span></nobr></DIV> |
| <DIV style="position:absolute;top:484;left:448"><nobr><span class="ft5">The error file. This file is called whenever a help page can not be </span></nobr></DIV> |
| <DIV style="position:absolute;top:498;left:448"><nobr><span class="ft5">found.</span></nobr></DIV> |
| <DIV style="position:absolute;top:524;left:243"><nobr><span class="ft17">help/{lang}/shared.jar</span></nobr></DIV> |
| <DIV style="position:absolute;top:524;left:448"><nobr><span class="ft5">The help file archive for shared help files</span></nobr></DIV> |
| <DIV style="position:absolute;top:550;left:243"><nobr><span class="ft17">help/{lang}/shared.tree</span></nobr></DIV> |
| <DIV style="position:absolute;top:550;left:448"><nobr><span class="ft5">The contents file for shared help files (see <i><A href="HelpAuthoring_c.html#15">Help Module Contents</i></a></span></nobr></DIV> |
| <DIV style="position:absolute;top:564;left:448"><nobr><span class="ft15"><A href="HelpAuthoring_c.html#15"><i>Files (Section Archives)</i>)</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:590;left:243"><nobr><span class="ft17">help/{lang}/schart.jar</span></nobr></DIV> |
| <DIV style="position:absolute;top:590;left:448"><nobr><span class="ft5">The help file archive for help files dealing with charts <A href="HelpAuthoring_c.html#13">[1</a>]</span></nobr></DIV> |
| <DIV style="position:absolute;top:616;left:243"><nobr><span class="ft17">help/{lang}/schart.tree</span></nobr></DIV> |
| <DIV style="position:absolute;top:616;left:448"><nobr><span class="ft5">The contents file for help files dealing with charts (see <i><A href="HelpAuthoring_c.html#15">Help</i></a></span></nobr></DIV> |
| <DIV style="position:absolute;top:630;left:448"><nobr><span class="ft15"><A href="HelpAuthoring_c.html#15"><i>Module Contents Files (Section Archives)</i> </a>)<A href="HelpAuthoring_c.html#13">[1</a>]</span></nobr></DIV> |
| <DIV style="position:absolute;top:656;left:243"><nobr><span class="ft17">help/{lang}/{module}.cfg</span></nobr></DIV> |
| <DIV style="position:absolute;top:656;left:448"><nobr><span class="ft5">The configuration files for a help module (<A href="HelpAuthoring_c.html#14">see <i>Help Module</i></a></span></nobr></DIV> |
| <DIV style="position:absolute;top:670;left:448"><nobr><span class="ft15"><A href="HelpAuthoring_c.html#14"><i>Configuration Files</i> </a>)</span></nobr></DIV> |
| <DIV style="position:absolute;top:696;left:243"><nobr><span class="ft17">help/{lang}/{module}.db</span></nobr></DIV> |
| <DIV style="position:absolute;top:696;left:448"><nobr><span class="ft5">The lookup tables for a help module (<A href="HelpAuthoring_c.html#15">see <i>Help Module Lookup</i></a></span></nobr></DIV> |
| <DIV style="position:absolute;top:709;left:448"><nobr><span class="ft15"><A href="HelpAuthoring_c.html#15"><i>Tables (Databases)</i></a> )</span></nobr></DIV> |
| <DIV style="position:absolute;top:735;left:243"><nobr><span class="ft17">help/{lang}/{module}.ht</span></nobr></DIV> |
| <DIV style="position:absolute;top:735;left:448"><nobr><span class="ft5">The extended tips for a help module (<A href="HelpAuthoring_c.html#15">see <i>Help Module Extended</i></a></span></nobr></DIV> |
| <DIV style="position:absolute;top:749;left:448"><nobr><span class="ft15"><A href="HelpAuthoring_c.html#15"><i>Tip Files</i> </a>)</span></nobr></DIV> |
| <DIV style="position:absolute;top:775;left:243"><nobr><span class="ft17">help/{lang}/{module}.idx/</span></nobr></DIV> |
| <DIV style="position:absolute;top:775;left:448"><nobr><span class="ft5">The full text search index for a help module</span></nobr></DIV> |
| <DIV style="position:absolute;top:802;left:243"><nobr><span class="ft17">help/{lang}/{module}.jar</span></nobr></DIV> |
| <DIV style="position:absolute;top:802;left:448"><nobr><span class="ft5">The help file archive for a help module</span></nobr></DIV> |
| <DIV style="position:absolute;top:828;left:243"><nobr><span class="ft17">help/{lang}/{module}.key</span></nobr></DIV> |
| <DIV style="position:absolute;top:828;left:448"><nobr><span class="ft5">The index file for a help module (<A href="HelpAuthoring_c.html#16">see <i>Help Module Index Files </i></a>)</span></nobr></DIV> |
| <DIV style="position:absolute;top:854;left:243"><nobr><span class="ft17">help/{lang}/{module}.tree</span></nobr></DIV> |
| <DIV style="position:absolute;top:854;left:448"><nobr><span class="ft5">The contents file for a help module (see <i><A href="HelpAuthoring_c.html#15">Help Module Contents</i></a></span></nobr></DIV> |
| <DIV style="position:absolute;top:868;left:448"><nobr><span class="ft15"><A href="HelpAuthoring_c.html#15"><i>Files (Section Archives)</i> </a>)</span></nobr></DIV> |
| <DIV style="position:absolute;top:892;left:236"><nobr><span class="ft18"><i>Table 1: Help files that are installed.</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:941;left:236"><nobr><span class="ft8"><b>Help Modules And Help Sections</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:967;left:236"><nobr><span class="ft3">The help is divided into different help modules that can be selected using the drop </span></nobr></DIV> |
| <DIV style="position:absolute;top:988;left:236"><nobr><span class="ft3">down list at the top left of the help viewer. These correspond to the applications or </span></nobr></DIV> |
| <DIV style="position:absolute;top:1010;left:236"><nobr><span class="ft3">modules of OpenOffice.org.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1115;left:128"><nobr><span class="ft19">1</span></nobr></DIV> |
| <DIV style="position:absolute;top:1115;left:202"><nobr><span class="ft19">This is a legacy remainder of an older StarOffice help structure.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>13</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 14 --> |
| <a name="14"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| .ft20{font-size:8px;font-family:Times;color:#6f7176;} |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c014.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:193"><nobr><span class="ft3">Each help file (</span></nobr></DIV> |
| <DIV style="position:absolute;top:138;left:299"><nobr><span class="ft14">*.xhp</span></nobr></DIV> |
| <DIV style="position:absolute;top:136;left:339"><nobr><span class="ft3">) has a scope that consists of one or more <i>help sections</i> and </span></nobr></DIV> |
| <DIV style="position:absolute;top:158;left:193"><nobr><span class="ft3">includes the corresponding help file archives </span></nobr></DIV> |
| <DIV style="position:absolute;top:161;left:502"><nobr><span class="ft14">*.jar</span></nobr></DIV> |
| <DIV style="position:absolute;top:158;left:543"><nobr><span class="ft3">. These archives contain all help </span></nobr></DIV> |
| <DIV style="position:absolute;top:181;left:193"><nobr><span class="ft3">files of a help section. A help section <i>does not</i> correspond to an application of </span></nobr></DIV> |
| <DIV style="position:absolute;top:202;left:193"><nobr><span class="ft3">OpenOffice.org. </span></nobr></DIV> |
| <DIV style="position:absolute;top:241;left:193"><nobr><span class="ft3">In the help file viewer, the index and the full text search work within this scope only.</span></nobr></DIV> |
| <DIV style="position:absolute;top:294;left:193"><nobr><span class="ft5"> The distinction between help <i>module</i> and help <i>section</i> is confusing and will be eradicated in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:314;left:214"><nobr><span class="ft5">future. Basically, a help <i>section</i> contains all files that are found inside the </span></nobr></DIV> |
| <DIV style="position:absolute;top:313;left:604"><nobr><span class="ft14">text/{section}</span></nobr></DIV> |
| <DIV style="position:absolute;top:314;left:717"><nobr><span class="ft5"> path </span></nobr></DIV> |
| <DIV style="position:absolute;top:333;left:214"><nobr><span class="ft5">of the help source directory (see<A href="HelpAuthoring_c.html#18"> <i>Structure of the CVS Help Module</i></a> on page <A href="HelpAuthoring_c.html#18">18</a> for the structure of </span></nobr></DIV> |
| <DIV style="position:absolute;top:352;left:214"><nobr><span class="ft5">the help source module). Each help section produces a </span></nobr></DIV> |
| <DIV style="position:absolute;top:351;left:519"><nobr><span class="ft14">*.jar</span></nobr></DIV> |
| <DIV style="position:absolute;top:352;left:560"><nobr><span class="ft5"> archive containing all help files in </span></nobr></DIV> |
| <DIV style="position:absolute;top:371;left:214"><nobr><span class="ft5">that path. A help <i>module</i> takes one or more sections and combines them to form the scope of a </span></nobr></DIV> |
| <DIV style="position:absolute;top:389;left:214"><nobr><span class="ft5">module.</span></nobr></DIV> |
| <DIV style="position:absolute;top:462;left:200"><nobr><span class="ft16"><b>Help module</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:462;left:319"><nobr><span class="ft16"><b>Help Sections (Scope)</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:488;left:200"><nobr><span class="ft5">BASIC</span></nobr></DIV> |
| <DIV style="position:absolute;top:488;left:319"><nobr><span class="ft5">sbasic + shared</span></nobr></DIV> |
| <DIV style="position:absolute;top:514;left:200"><nobr><span class="ft5">Calc</span></nobr></DIV> |
| <DIV style="position:absolute;top:514;left:319"><nobr><span class="ft5">scalc + shared + schart</span></nobr></DIV> |
| <DIV style="position:absolute;top:541;left:200"><nobr><span class="ft5">Draw</span></nobr></DIV> |
| <DIV style="position:absolute;top:541;left:319"><nobr><span class="ft5">sdraw + simpress + shared + schart</span></nobr></DIV> |
| <DIV style="position:absolute;top:567;left:200"><nobr><span class="ft5">Impress</span></nobr></DIV> |
| <DIV style="position:absolute;top:567;left:319"><nobr><span class="ft5">sdraw + simpress + shared + schart</span></nobr></DIV> |
| <DIV style="position:absolute;top:593;left:200"><nobr><span class="ft5">Math</span></nobr></DIV> |
| <DIV style="position:absolute;top:593;left:319"><nobr><span class="ft5">smath + shared</span></nobr></DIV> |
| <DIV style="position:absolute;top:619;left:200"><nobr><span class="ft5">Writer</span></nobr></DIV> |
| <DIV style="position:absolute;top:619;left:319"><nobr><span class="ft5">swriter + shared + schart</span></nobr></DIV> |
| <DIV style="position:absolute;top:646;left:200"><nobr><span class="ft5">Base[<A href="HelpAuthoring_c.html#14">2</a>]</span></nobr></DIV> |
| <DIV style="position:absolute;top:646;left:319"><nobr><span class="ft5">shared/explorer/database</span></nobr></DIV> |
| <DIV style="position:absolute;top:670;left:193"><nobr><span class="ft18"><i>Table 2:OpenOffice.org help modules and scopes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:706;left:193"><nobr><span class="ft3">From the table above, it follows that the scope for the Writer help module includes all </span></nobr></DIV> |
| <DIV style="position:absolute;top:728;left:193"><nobr><span class="ft3">help files from </span></nobr></DIV> |
| <DIV style="position:absolute;top:730;left:294"><nobr><span class="ft14">swriter.jar</span></nobr></DIV> |
| <DIV style="position:absolute;top:728;left:383"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:730;left:393"><nobr><span class="ft14">shared.jar</span></nobr></DIV> |
| <DIV style="position:absolute;top:728;left:474"><nobr><span class="ft3"> and </span></nobr></DIV> |
| <DIV style="position:absolute;top:730;left:509"><nobr><span class="ft14">schart.jar</span></nobr></DIV> |
| <DIV style="position:absolute;top:728;left:590"><nobr><span class="ft3">. Each help module has a </span></nobr></DIV> |
| <DIV style="position:absolute;top:750;left:193"><nobr><span class="ft3">set of six files (</span></nobr></DIV> |
| <DIV style="position:absolute;top:752;left:296"><nobr><span class="ft14">cfg</span></nobr></DIV> |
| <DIV style="position:absolute;top:750;left:320"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:752;left:329"><nobr><span class="ft14">db</span></nobr></DIV> |
| <DIV style="position:absolute;top:750;left:345"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:752;left:355"><nobr><span class="ft14">ht</span></nobr></DIV> |
| <DIV style="position:absolute;top:750;left:371"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:752;left:380"><nobr><span class="ft14">jar</span></nobr></DIV> |
| <DIV style="position:absolute;top:750;left:404"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:752;left:413"><nobr><span class="ft14">key</span></nobr></DIV> |
| <DIV style="position:absolute;top:750;left:438"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:752;left:447"><nobr><span class="ft14">tree</span></nobr></DIV> |
| <DIV style="position:absolute;top:750;left:479"><nobr><span class="ft3">) and an </span></nobr></DIV> |
| <DIV style="position:absolute;top:752;left:541"><nobr><span class="ft14">*.idx</span></nobr></DIV> |
| <DIV style="position:absolute;top:750;left:582"><nobr><span class="ft3"> directory associated with it </span></nobr></DIV> |
| <DIV style="position:absolute;top:772;left:193"><nobr><span class="ft3">except for Draw and Base, which have no </span></nobr></DIV> |
| <DIV style="position:absolute;top:775;left:474"><nobr><span class="ft14">*.tree</span></nobr></DIV> |
| <DIV style="position:absolute;top:772;left:522"><nobr><span class="ft3"> file.<A href="HelpAuthoring_c.html#14">[3]</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:824;left:193"><nobr><span class="ft8"><b>Help Module Configuration Files</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:850;left:193"><nobr><span class="ft3">The </span></nobr></DIV> |
| <DIV style="position:absolute;top:853;left:225"><nobr><span class="ft14">*.cfg</span></nobr></DIV> |
| <DIV style="position:absolute;top:850;left:265"><nobr><span class="ft3"> configuration files are ASCII files containing </span></nobr></DIV> |
| <DIV style="position:absolute;top:853;left:573"><nobr><span class="ft14">parameter=value</span></nobr></DIV> |
| <DIV style="position:absolute;top:850;left:695"><nobr><span class="ft3"> pairs with </span></nobr></DIV> |
| <DIV style="position:absolute;top:873;left:193"><nobr><span class="ft3">configuration information. They are created and maintained manually:</span></nobr></DIV> |
| <DIV style="position:absolute;top:919;left:224"><nobr><span class="ft5">Title=%PRODUCTNAME Writer</span></nobr></DIV> |
| <DIV style="position:absolute;top:936;left:224"><nobr><span class="ft5">Copyright=Copyright 2004, Sun Microsystems, Inc.</span></nobr></DIV> |
| <DIV style="position:absolute;top:953;left:224"><nobr><span class="ft5">Language=en-US</span></nobr></DIV> |
| <DIV style="position:absolute;top:970;left:224"><nobr><span class="ft5">Order=2</span></nobr></DIV> |
| <DIV style="position:absolute;top:987;left:224"><nobr><span class="ft5">Start=text%2Fswriter%2Fmain0000.xhp</span></nobr></DIV> |
| <DIV style="position:absolute;top:1004;left:224"><nobr><span class="ft5">Heading=headingheading</span></nobr></DIV> |
| <DIV style="position:absolute;top:1021;left:224"><nobr><span class="ft5">Program=WRITER</span></nobr></DIV> |
| <DIV style="position:absolute;top:1038;left:224"><nobr><span class="ft5">07.07.04 00:00:00</span></nobr></DIV> |
| <DIV style="position:absolute;top:1080;left:85"><nobr><span class="ft19">2</span></nobr></DIV> |
| <DIV style="position:absolute;top:1080;left:106"><nobr><span class="ft19">This help section was introduced for version 2.0. For legacy reasons, all of its help files reside inside the </span></nobr></DIV> |
| <DIV style="position:absolute;top:1081;left:591"><nobr><span class="ft20">shared</span></nobr></DIV> |
| <DIV style="position:absolute;top:1080;left:629"><nobr><span class="ft19"> directory tree.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1102;left:85"><nobr><span class="ft19">3</span></nobr></DIV> |
| <DIV style="position:absolute;top:1102;left:106"><nobr><span class="ft19">For historical reasons, the contents for Draw are included in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:1102;left:404"><nobr><span class="ft20">simpress.tree</span></nobr></DIV> |
| <DIV style="position:absolute;top:1102;left:486"><nobr><span class="ft19"> file and the contents for Base (database) are included in </span></nobr></DIV> |
| <DIV style="position:absolute;top:1114;left:106"><nobr><span class="ft19">the </span></nobr></DIV> |
| <DIV style="position:absolute;top:1115;left:124"><nobr><span class="ft20">shared.tree</span></nobr></DIV> |
| <DIV style="position:absolute;top:1114;left:193"><nobr><span class="ft19"> file.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>14</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 15 --> |
| <a name="15"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c015.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:236"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:140;left:263"><nobr><span class="ft14">Title</span></nobr></DIV> |
| <DIV style="position:absolute;top:137;left:303"><nobr><span class="ft3"> specifies the help module title as displayed in the drop down list at the top </span></nobr></DIV> |
| <DIV style="position:absolute;top:160;left:263"><nobr><span class="ft3">left of the help viewer.</span></nobr></DIV> |
| <DIV style="position:absolute;top:187;left:236"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:191;left:263"><nobr><span class="ft14">Copyright</span></nobr></DIV> |
| <DIV style="position:absolute;top:189;left:336"><nobr><span class="ft3"> is a copyright string.</span></nobr></DIV> |
| <DIV style="position:absolute;top:221;left:236"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:225;left:263"><nobr><span class="ft14">Language</span></nobr></DIV> |
| <DIV style="position:absolute;top:222;left:327"><nobr><span class="ft3"> specifies the help language for the help module.</span></nobr></DIV> |
| <DIV style="position:absolute;top:254;left:236"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:258;left:263"><nobr><span class="ft14">Order</span></nobr></DIV> |
| <DIV style="position:absolute;top:256;left:303"><nobr><span class="ft3"> was used in an earlier implementation and is deprecated.</span></nobr></DIV> |
| <DIV style="position:absolute;top:287;left:236"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:291;left:263"><nobr><span class="ft14">Start</span></nobr></DIV> |
| <DIV style="position:absolute;top:289;left:303"><nobr><span class="ft3"> defines the start page for a help module. The slashes in the path name are </span></nobr></DIV> |
| <DIV style="position:absolute;top:312;left:263"><nobr><span class="ft3">encoded as </span></nobr></DIV> |
| <DIV style="position:absolute;top:314;left:349"><nobr><span class="ft14">%2F</span></nobr></DIV> |
| <DIV style="position:absolute;top:312;left:373"><nobr><span class="ft3">. The start page <i>must </i>be contained in the archive that has the </span></nobr></DIV> |
| <DIV style="position:absolute;top:334;left:263"><nobr><span class="ft3">same name as the configuration file (</span></nobr></DIV> |
| <DIV style="position:absolute;top:336;left:509"><nobr><span class="ft14">swriter.jar</span></nobr></DIV> |
| <DIV style="position:absolute;top:334;left:598"><nobr><span class="ft3"> for </span></nobr></DIV> |
| <DIV style="position:absolute;top:336;left:623"><nobr><span class="ft14">swriter.cfg</span></nobr></DIV> |
| <DIV style="position:absolute;top:334;left:713"><nobr><span class="ft3">)</span></nobr></DIV> |
| <DIV style="position:absolute;top:365;left:236"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:369;left:263"><nobr><span class="ft14">Heading</span></nobr></DIV> |
| <DIV style="position:absolute;top:367;left:319"><nobr><span class="ft3"> defines an internal value that is used by the full text search engine.</span></nobr></DIV> |
| <DIV style="position:absolute;top:399;left:236"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:403;left:263"><nobr><span class="ft14">Program</span></nobr></DIV> |
| <DIV style="position:absolute;top:400;left:319"><nobr><span class="ft3"> specifies the application name that will be used for switching content </span></nobr></DIV> |
| <DIV style="position:absolute;top:423;left:263"><nobr><span class="ft3">(see <i><A href="HelpAuthoring_c.html#99">Switching Content</i> </a>on page<A href="HelpAuthoring_c.html#99"> 99</a>)</span></nobr></DIV> |
| <DIV style="position:absolute;top:454;left:236"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:455;left:263"><nobr><span class="ft3">The last line contains the creation date. Use of this is deprecated. It is not </span></nobr></DIV> |
| <DIV style="position:absolute;top:478;left:263"><nobr><span class="ft3">evaluated anywhere.</span></nobr></DIV> |
| <DIV style="position:absolute;top:521;left:236"><nobr><span class="ft8"><b>Help Module Contents Files (Section Archives)</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:547;left:236"><nobr><span class="ft3">The </span></nobr></DIV> |
| <DIV style="position:absolute;top:549;left:269"><nobr><span class="ft14">*.jar</span></nobr></DIV> |
| <DIV style="position:absolute;top:547;left:309"><nobr><span class="ft3"> contents files contain the help topic files for a help section (see <i><A href="HelpAuthoring_c.html#13">Help</i></a></span></nobr></DIV> |
| <DIV style="position:absolute;top:569;left:236"><nobr><span class="ft13"><A href="HelpAuthoring_c.html#13"><i>Modules and Help Sections</i> </a>). It is an archive file with a subdirectory structure that </span></nobr></DIV> |
| <DIV style="position:absolute;top:590;left:236"><nobr><span class="ft3">contains all help </span></nobr></DIV> |
| <DIV style="position:absolute;top:593;left:357"><nobr><span class="ft14">xhp</span></nobr></DIV> |
| <DIV style="position:absolute;top:590;left:381"><nobr><span class="ft3"> files. There is one archive per help <i>section</i> (sbasic, shared, </span></nobr></DIV> |
| <DIV style="position:absolute;top:613;left:236"><nobr><span class="ft3">sdraw, simpress, scalc, schart, swriter, smath). Each help <i>module</i> comprises more </span></nobr></DIV> |
| <DIV style="position:absolute;top:634;left:236"><nobr><span class="ft3">than one help section (see <i><A href="HelpAuthoring_c.html#13">Help Modules and Help Sections</i></a> ).</span></nobr></DIV> |
| <DIV style="position:absolute;top:685;left:236"><nobr><span class="ft8"><b>Help Module Lookup Tables (Databases)</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:711;left:236"><nobr><span class="ft3">The lookup tables </span></nobr></DIV> |
| <DIV style="position:absolute;top:713;left:363"><nobr><span class="ft14">*.db</span></nobr></DIV> |
| <DIV style="position:absolute;top:711;left:395"><nobr><span class="ft3"> are Berkeley databases that contain a lookup table used by </span></nobr></DIV> |
| <DIV style="position:absolute;top:733;left:236"><nobr><span class="ft3">the help application to find a help page to display for a given help ID. The tables are </span></nobr></DIV> |
| <DIV style="position:absolute;top:755;left:236"><nobr><span class="ft3">used for referencing context sensitive help pages when help is called from the </span></nobr></DIV> |
| <DIV style="position:absolute;top:776;left:236"><nobr><span class="ft3">application. They are not used for calling help files from within other help files. This is </span></nobr></DIV> |
| <DIV style="position:absolute;top:797;left:236"><nobr><span class="ft3">designated by the parameter </span></nobr></DIV> |
| <DIV style="position:absolute;top:800;left:443"><nobr><span class="ft14">UseDB=no</span></nobr></DIV> |
| <DIV style="position:absolute;top:797;left:507"><nobr><span class="ft3"> in the help file URL (see <i><A href="HelpAuthoring_c.html#16">Application Help</i></a></span></nobr></DIV> |
| <DIV style="position:absolute;top:820;left:236"><nobr><span class="ft13"><A href="HelpAuthoring_c.html#16"><i>Calls</i> </a>on page<A href="HelpAuthoring_c.html#16"> 16</a>). The data for that table come from the </span></nobr></DIV> |
| <DIV style="position:absolute;top:822;left:632"><nobr><span class="ft14">bookmark</span></nobr></DIV> |
| <DIV style="position:absolute;top:820;left:697"><nobr><span class="ft3"> elements in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:842;left:236"><nobr><span class="ft3">help files (see<A href="HelpAuthoring_c.html#95"> <i>Bookmarks</i></a> on page <A href="HelpAuthoring_c.html#95">95)</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:893;left:236"><nobr><span class="ft8"><b>Help Module Extended Tip Files</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:919;left:236"><nobr><span class="ft3">The files </span></nobr></DIV> |
| <DIV style="position:absolute;top:922;left:300"><nobr><span class="ft14">*.ht</span></nobr></DIV> |
| <DIV style="position:absolute;top:919;left:332"><nobr><span class="ft3"> are Berkeley databases that contain the extended help tip text for all </span></nobr></DIV> |
| <DIV style="position:absolute;top:941;left:236"><nobr><span class="ft3">Help IDs. The application uses these files to fetch the text for an extended tip for a </span></nobr></DIV> |
| <DIV style="position:absolute;top:963;left:236"><nobr><span class="ft3">given Help ID.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1002;left:236"><nobr><span class="ft3">The data for that table come from the </span></nobr></DIV> |
| <DIV style="position:absolute;top:1004;left:511"><nobr><span class="ft14">bookmark</span></nobr></DIV> |
| <DIV style="position:absolute;top:1002;left:576"><nobr><span class="ft3"> elements in conjunction with the </span></nobr></DIV> |
| <DIV style="position:absolute;top:1026;left:236"><nobr><span class="ft14">ahelp</span></nobr></DIV> |
| <DIV style="position:absolute;top:1024;left:276"><nobr><span class="ft3"> elements in the help files (see<A href="HelpAuthoring_c.html#95"> <i>Bookmarks</i></a> on page <A href="HelpAuthoring_c.html#95">95</a>). It is extracted from the </span></nobr></DIV> |
| <DIV style="position:absolute;top:1046;left:236"><nobr><span class="ft3">help files at compile time.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>15</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 16 --> |
| <a name="16"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| .ft21{font-size:34px;font-family:Times;color:#000000;} |
| .ft22{font-size:11px;font-family:Times;color:#ffffff;} |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c016.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:193"><nobr><span class="ft8"><b>Help Module Index Files</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:162;left:193"><nobr><span class="ft3">The files </span></nobr></DIV> |
| <DIV style="position:absolute;top:164;left:259"><nobr><span class="ft14">*.key</span></nobr></DIV> |
| <DIV style="position:absolute;top:162;left:300"><nobr><span class="ft3"> are Berkeley databases that contain the index entries for the help </span></nobr></DIV> |
| <DIV style="position:absolute;top:184;left:193"><nobr><span class="ft3">modules.</span></nobr></DIV> |
| <DIV style="position:absolute;top:223;left:193"><nobr><span class="ft3">The data for that table come from the </span></nobr></DIV> |
| <DIV style="position:absolute;top:225;left:475"><nobr><span class="ft14">bookmark</span></nobr></DIV> |
| <DIV style="position:absolute;top:223;left:540"><nobr><span class="ft3"> elements in the help files (see </span></nobr></DIV> |
| <DIV style="position:absolute;top:245;left:193"><nobr><span class="ft13"><A href="HelpAuthoring_c.html#95"><i>Bookmarks</i></a> on page <A href="HelpAuthoring_c.html#95">95</a>). It is extracted from the help files at compile time.</span></nobr></DIV> |
| <DIV style="position:absolute;top:296;left:193"><nobr><span class="ft8"><b>The Main Transformation Style Sheet</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:323;left:193"><nobr><span class="ft3">The file </span></nobr></DIV> |
| <DIV style="position:absolute;top:325;left:247"><nobr><span class="ft14">main_transform.xsl</span></nobr></DIV> |
| <DIV style="position:absolute;top:323;left:393"><nobr><span class="ft3"> is global for all languages and help files and is used for </span></nobr></DIV> |
| <DIV style="position:absolute;top:345;left:193"><nobr><span class="ft3">final transformation of the xhp help file to yield an html file that is displayed by the help </span></nobr></DIV> |
| <DIV style="position:absolute;top:366;left:193"><nobr><span class="ft3">viewer component.</span></nobr></DIV> |
| <DIV style="position:absolute;top:405;left:193"><nobr><span class="ft3">This style sheet is responsible for converting XML help elements and classes into </span></nobr></DIV> |
| <DIV style="position:absolute;top:426;left:193"><nobr><span class="ft3">HTML elements and classes. The overall layout of the help file is specified using this </span></nobr></DIV> |
| <DIV style="position:absolute;top:448;left:193"><nobr><span class="ft3">style sheet. The graphical appearance is controlled by the cascading style sheets (see </span></nobr></DIV> |
| <DIV style="position:absolute;top:469;left:193"><nobr><span class="ft3"><A href="HelpAuthoring_c.html#16">The Cascading Style Sheets</a>).</span></nobr></DIV> |
| <DIV style="position:absolute;top:520;left:193"><nobr><span class="ft8"><b>The Cascading Style Sheets</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:546;left:193"><nobr><span class="ft3">The cascading style sheets </span></nobr></DIV> |
| <DIV style="position:absolute;top:549;left:390"><nobr><span class="ft14">*.css</span></nobr></DIV> |
| <DIV style="position:absolute;top:546;left:430"><nobr><span class="ft3"> describe the formatting style for the help page. </span></nobr></DIV> |
| <DIV style="position:absolute;top:569;left:193"><nobr><span class="ft3">Since different locales require different fonts and font effects, the cascading style </span></nobr></DIV> |
| <DIV style="position:absolute;top:590;left:193"><nobr><span class="ft3">sheets are language dependent. There is one set of style sheets per language. </span></nobr></DIV> |
| <DIV style="position:absolute;top:629;left:193"><nobr><span class="ft3">The OpenOffice.org help viewer only recognizes some basic CSS2 commands. There </span></nobr></DIV> |
| <DIV style="position:absolute;top:650;left:193"><nobr><span class="ft3">are five style sheets available, four of which account for special accessibility issues. </span></nobr></DIV> |
| <DIV style="position:absolute;top:671;left:193"><nobr><span class="ft3">They are selected in the application using </span></nobr></DIV> |
| <DIV style="position:absolute;top:673;left:476"><nobr><span class="ft11"><b>Tools Options OpenOffice.org </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:695;left:193"><nobr><span class="ft11"><b> General Help Formatting</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:694;left:436"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:748;left:193"><nobr><span class="ft10"><b>Application Help Calls</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:781;left:193"><nobr><span class="ft3">This section briefly describes what happens when a help file is called from the </span></nobr></DIV> |
| <DIV style="position:absolute;top:803;left:193"><nobr><span class="ft3">application or from within the help itself (links or embeddings).</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>16</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1176;left:193"><nobr><span class="ft15"><i>Fig. 5: Help Calls</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:852;left:232"><nobr><span class="ft9">Application</span></nobr></DIV> |
| <DIV style="position:absolute;top:868;left:200"><nobr><span class="ft9">(F1 or Help Button)</span></nobr></DIV> |
| <DIV style="position:absolute;top:860;left:490"><nobr><span class="ft9">Help Viewer</span></nobr></DIV> |
| <DIV style="position:absolute;top:929;left:236"><nobr><span class="ft9">$module.db</span></nobr></DIV> |
| <DIV style="position:absolute;top:1011;left:365"><nobr><span class="ft9">$module.jar</span></nobr></DIV> |
| <DIV style="position:absolute;top:1074;left:337"><nobr><span class="ft9">main_transform.xsl</span></nobr></DIV> |
| <DIV style="position:absolute;top:1134;left:386"><nobr><span class="ft9">Viewer</span></nobr></DIV> |
| <DIV style="position:absolute;top:1029;left:222"><nobr><span class="ft21">1</span></nobr></DIV> |
| <DIV style="position:absolute;top:898;left:273"><nobr><span class="ft22">1</span></nobr></DIV> |
| <DIV style="position:absolute;top:967;left:328"><nobr><span class="ft22">2</span></nobr></DIV> |
| <DIV style="position:absolute;top:967;left:464"><nobr><span class="ft22">3</span></nobr></DIV> |
| <DIV style="position:absolute;top:1043;left:407"><nobr><span class="ft22">4</span></nobr></DIV> |
| <DIV style="position:absolute;top:1106;left:406"><nobr><span class="ft22">5</span></nobr></DIV> |
| </DIV> |
| <!-- Page 17 --> |
| <a name="17"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| .ft23{font-size:10px;font-family:Times;color:#34546a;} |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c017.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:263"><nobr><span class="ft3">1. When </span></nobr></DIV> |
| <DIV style="position:absolute;top:138;left:333"><nobr><span class="ft12"><b>F1</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:136;left:350"><nobr><span class="ft3"> or a </span></nobr></DIV> |
| <DIV style="position:absolute;top:138;left:385"><nobr><span class="ft12"><b>help</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:136;left:418"><nobr><span class="ft3"> button is pressed in an OpenOffice.org application, a help </span></nobr></DIV> |
| <DIV style="position:absolute;top:158;left:290"><nobr><span class="ft3">request is sent as an URL to the help content provider.</span></nobr></DIV> |
| <DIV style="position:absolute;top:189;left:263"><nobr><span class="ft3">2. The help ID is resolved to a help file using the help lookup table for the </span></nobr></DIV> |
| <DIV style="position:absolute;top:210;left:290"><nobr><span class="ft3">application (</span></nobr></DIV> |
| <DIV style="position:absolute;top:212;left:371"><nobr><span class="ft14">$module.db</span></nobr></DIV> |
| <DIV style="position:absolute;top:210;left:452"><nobr><span class="ft3">).</span></nobr></DIV> |
| <DIV style="position:absolute;top:241;left:263"><nobr><span class="ft3">3. When a help file is called from within the help, the URL sent to the help </span></nobr></DIV> |
| <DIV style="position:absolute;top:263;left:290"><nobr><span class="ft3">content provider contains the file path. There is no need for resolving the ID.</span></nobr></DIV> |
| <DIV style="position:absolute;top:293;left:263"><nobr><span class="ft3">4. The help file is extracted from the corresponding help file archive </span></nobr></DIV> |
| <DIV style="position:absolute;top:314;left:290"><nobr><span class="ft3">(</span></nobr></DIV> |
| <DIV style="position:absolute;top:317;left:295"><nobr><span class="ft14">$module.jar</span></nobr></DIV> |
| <DIV style="position:absolute;top:314;left:384"><nobr><span class="ft3">).</span></nobr></DIV> |
| <DIV style="position:absolute;top:345;left:263"><nobr><span class="ft3">5. The extracted help file is transformed into HTML using the </span></nobr></DIV> |
| <DIV style="position:absolute;top:369;left:290"><nobr><span class="ft14">main_transform.xsl</span></nobr></DIV> |
| <DIV style="position:absolute;top:367;left:435"><nobr><span class="ft3"> style sheet and sent to the help viewer for display. The </span></nobr></DIV> |
| <DIV style="position:absolute;top:389;left:290"><nobr><span class="ft3">stylesheet </span></nobr></DIV> |
| <DIV style="position:absolute;top:391;left:362"><nobr><span class="ft14">main_transform.xsl</span></nobr></DIV> |
| <DIV style="position:absolute;top:389;left:507"><nobr><span class="ft3"> controls all conversion from xhp to html, and </span></nobr></DIV> |
| <DIV style="position:absolute;top:411;left:290"><nobr><span class="ft3">must be adjusted whenever new elements, attributes, or attribute values must </span></nobr></DIV> |
| <DIV style="position:absolute;top:433;left:290"><nobr><span class="ft3">be taken into account.</span></nobr></DIV> |
| <DIV style="position:absolute;top:463;left:236"><nobr><span class="ft3">The URLs sent to the help content provider have two forms:</span></nobr></DIV> |
| <DIV style="position:absolute;top:502;left:236"><nobr><span class="ft3">URLs from the application</span></nobr></DIV> |
| <DIV style="position:absolute;top:547;left:268"><nobr><span class="ft23">vnd.sun.star.help://swriter/12345?Language=en-US&System=UNIX</span></nobr></DIV> |
| <DIV style="position:absolute;top:584;left:236"><nobr><span class="ft3">URLs send within the help:</span></nobr></DIV> |
| <DIV style="position:absolute;top:620;left:268"><nobr><span class="ft23">vnd.sun.star.help://swriter/text/swriter/main0100.xhp?Language=en-</span></nobr></DIV> |
| <DIV style="position:absolute;top:634;left:268"><nobr><span class="ft23">US&System=UNIX&UseDB=no&DbPAR=swriter</span></nobr></DIV> |
| <DIV style="position:absolute;top:663;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:664;left:290"><nobr><span class="ft3">The protocol identifier </span></nobr></DIV> |
| <DIV style="position:absolute;top:666;left:438"><nobr><span class="ft14">vnd.sun.star.help:</span></nobr></DIV> |
| <DIV style="position:absolute;top:696;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:697;left:290"><nobr><span class="ft3">The help archive jar file to use: </span></nobr></DIV> |
| <DIV style="position:absolute;top:700;left:498"><nobr><span class="ft14">swriter</span></nobr></DIV> |
| <DIV style="position:absolute;top:729;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:731;left:290"><nobr><span class="ft3">The help ID to look up, or the name of the file to extract: </span></nobr></DIV> |
| <DIV style="position:absolute;top:733;left:744"><nobr><span class="ft14">12345</span></nobr></DIV> |
| <DIV style="position:absolute;top:731;left:785"><nobr><span class="ft3"> or </span></nobr></DIV> |
| <DIV style="position:absolute;top:754;left:290"><nobr><span class="ft14">swriter/text/swriter/main0100.xhp</span></nobr></DIV> |
| <DIV style="position:absolute;top:783;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:784;left:290"><nobr><span class="ft3">A parameter for the current language: </span></nobr></DIV> |
| <DIV style="position:absolute;top:786;left:544"><nobr><span class="ft14">Language=en-US</span></nobr></DIV> |
| <DIV style="position:absolute;top:816;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:818;left:290"><nobr><span class="ft3">A parameter for the current operating system: </span></nobr></DIV> |
| <DIV style="position:absolute;top:820;left:596"><nobr><span class="ft14">System=UNIX</span></nobr></DIV> |
| <DIV style="position:absolute;top:849;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:851;left:290"><nobr><span class="ft3">A parameter to disable help ID lookup (only for help internal URLs): </span></nobr></DIV> |
| <DIV style="position:absolute;top:853;left:740"><nobr><span class="ft14">UseDB=no</span></nobr></DIV> |
| <DIV style="position:absolute;top:883;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:884;left:290"><nobr><span class="ft3">A parameter to describe the current help context (module): </span></nobr></DIV> |
| <DIV style="position:absolute;top:887;left:703"><nobr><span class="ft14">DbPAR=swriter </span></nobr></DIV> |
| <DIV style="position:absolute;top:907;left:290"><nobr><span class="ft3">This can differ from the help archive jar file used (see also <i><A href="HelpAuthoring_c.html#13">Help Modules and</i></a></span></nobr></DIV> |
| <DIV style="position:absolute;top:929;left:290"><nobr><span class="ft13"><A href="HelpAuthoring_c.html#13"><i>Help Sections</i></a> on page <A href="HelpAuthoring_c.html#13">13)</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>17</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 18 --> |
| <a name="18"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c018.png" alt="background image"> |
| <DIV style="position:absolute;top:153;left:193"><nobr><span class="ft10"><b>Structure of the CVS Help Module</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:204;left:193"><nobr><span class="ft3">The help source files and all helper files are located in the CVS module </span></nobr></DIV> |
| <DIV style="position:absolute;top:227;left:193"><nobr><span class="ft14">helpcontent2</span></nobr></DIV> |
| <DIV style="position:absolute;top:225;left:290"><nobr><span class="ft3">. The directory layout is as follows:</span></nobr></DIV> |
| <DIV style="position:absolute;top:284;left:200"><nobr><span class="ft16"><b>Directory</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:284;left:431"><nobr><span class="ft16"><b>Content</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:310;left:200"><nobr><span class="ft5">helpcontent2/</span></nobr></DIV> |
| <DIV style="position:absolute;top:310;left:431"><nobr><span class="ft5">The module's main directory</span></nobr></DIV> |
| <DIV style="position:absolute;top:337;left:200"><nobr><span class="ft5">helpcontent2/helpers</span></nobr></DIV> |
| <DIV style="position:absolute;top:337;left:431"><nobr><span class="ft5">Files that are not used by the help content itself, like </span></nobr></DIV> |
| <DIV style="position:absolute;top:350;left:431"><nobr><span class="ft5">the DTD for the XML help format.</span></nobr></DIV> |
| <DIV style="position:absolute;top:376;left:200"><nobr><span class="ft5">helpcontent2/helpers/helpauthoring</span></nobr></DIV> |
| <DIV style="position:absolute;top:376;left:431"><nobr><span class="ft5">The help authoring environment for OpenOffice.org, </span></nobr></DIV> |
| <DIV style="position:absolute;top:390;left:431"><nobr><span class="ft5"><A href="HelpAuthoring_c.html#75">see Authoring Help With OpenOffice.org </a>on <A href="HelpAuthoring_c.html#75">page 75</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:416;left:200"><nobr><span class="ft5">helpcontent2/source</span></nobr></DIV> |
| <DIV style="position:absolute;top:416;left:431"><nobr><span class="ft5">The help source files that are used to build the help.</span></nobr></DIV> |
| <DIV style="position:absolute;top:442;left:200"><nobr><span class="ft5">helpcontent2/source/auxiliary</span></nobr></DIV> |
| <DIV style="position:absolute;top:442;left:431"><nobr><span class="ft5">Auxiliary files that do not contain help content but are </span></nobr></DIV> |
| <DIV style="position:absolute;top:455;left:431"><nobr><span class="ft5">still needed for building the help, style sheets, </span></nobr></DIV> |
| <DIV style="position:absolute;top:469;left:431"><nobr><span class="ft5">configuration files (<A href="HelpAuthoring_c.html#31">see Auxiliary Files</a> on <A href="HelpAuthoring_c.html#31">page 31)</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:495;left:200"><nobr><span class="ft5">helpcontent2/source/text</span></nobr></DIV> |
| <DIV style="position:absolute;top:495;left:431"><nobr><span class="ft5">The help content source files, the makefiles for the </span></nobr></DIV> |
| <DIV style="position:absolute;top:509;left:431"><nobr><span class="ft5">help compiler, and the localized content. Every </span></nobr></DIV> |
| <DIV style="position:absolute;top:522;left:431"><nobr><span class="ft5">subdirectory contains its own makefile and a file with </span></nobr></DIV> |
| <DIV style="position:absolute;top:535;left:431"><nobr><span class="ft5">all localized content.</span></nobr></DIV> |
| <DIV style="position:absolute;top:562;left:200"><nobr><span class="ft5">helpcontent2/source/text/sbasic</span></nobr></DIV> |
| <DIV style="position:absolute;top:562;left:431"><nobr><span class="ft5">Help files specific to BASIC (and the IDE).[<A href="HelpAuthoring_c.html#18">4</a>]</span></nobr></DIV> |
| <DIV style="position:absolute;top:588;left:200"><nobr><span class="ft5">helpcontent2/source/text/scalc</span></nobr></DIV> |
| <DIV style="position:absolute;top:588;left:431"><nobr><span class="ft5">Help files specific to the Calc module.[<A href="HelpAuthoring_c.html#18">4</a>]</span></nobr></DIV> |
| <DIV style="position:absolute;top:614;left:200"><nobr><span class="ft5">helpcontent2/source/text/schart</span></nobr></DIV> |
| <DIV style="position:absolute;top:614;left:431"><nobr><span class="ft5">Help files specific to charts.<A href="HelpAuthoring_c.html#18">[4</a>]</span></nobr></DIV> |
| <DIV style="position:absolute;top:640;left:200"><nobr><span class="ft5">helpcontent2/source/text/sdraw</span></nobr></DIV> |
| <DIV style="position:absolute;top:640;left:431"><nobr><span class="ft5">Help files specific to the Draw module.[<A href="HelpAuthoring_c.html#18">4</a>]</span></nobr></DIV> |
| <DIV style="position:absolute;top:667;left:200"><nobr><span class="ft5">helpcontent2/source/text/shared</span></nobr></DIV> |
| <DIV style="position:absolute;top:667;left:431"><nobr><span class="ft5">Help files common to two or more modules.[<A href="HelpAuthoring_c.html#18">4]</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:693;left:200"><nobr><span class="ft5">helpcontent2/source/text/simpress</span></nobr></DIV> |
| <DIV style="position:absolute;top:693;left:431"><nobr><span class="ft5">Help files specific to the Impress module.<A href="HelpAuthoring_c.html#18">[4]</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:719;left:200"><nobr><span class="ft5">helpcontent2/source/text/smath</span></nobr></DIV> |
| <DIV style="position:absolute;top:719;left:431"><nobr><span class="ft5">Help files specific to the Math module.<A href="HelpAuthoring_c.html#18">[4]</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:745;left:200"><nobr><span class="ft5">helpcontent2/source/text/swriter</span></nobr></DIV> |
| <DIV style="position:absolute;top:745;left:431"><nobr><span class="ft5">Help files specific to the Writer module.[<A href="HelpAuthoring_c.html#18">4</a>]</span></nobr></DIV> |
| <DIV style="position:absolute;top:772;left:200"><nobr><span class="ft5">helpcontent2/prj</span></nobr></DIV> |
| <DIV style="position:absolute;top:772;left:431"><nobr><span class="ft5">The build lists.</span></nobr></DIV> |
| <DIV style="position:absolute;top:798;left:200"><nobr><span class="ft5">helpcontent2/util</span></nobr></DIV> |
| <DIV style="position:absolute;top:798;left:431"><nobr><span class="ft5">The makefiles for the help linker (see <i><A href="HelpAuthoring_c.html#20">Makefiles for</i></a></span></nobr></DIV> |
| <DIV style="position:absolute;top:811;left:431"><nobr><span class="ft15"><A href="HelpAuthoring_c.html#20"><i>linking the compiled files</i> </a>on page <A href="HelpAuthoring_c.html#20">20</a>).</span></nobr></DIV> |
| <DIV style="position:absolute;top:836;left:193"><nobr><span class="ft18"><i>Table 3: Structure of the Help CVS module</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:887;left:193"><nobr><span class="ft5"> Note that the help images are no longer part of the CVS module. Starting with OpenOffice.org 2.0, </span></nobr></DIV> |
| <DIV style="position:absolute;top:906;left:214"><nobr><span class="ft5">application icons are directly taken from the </span></nobr></DIV> |
| <DIV style="position:absolute;top:906;left:465"><nobr><span class="ft14">images.zip</span></nobr></DIV> |
| <DIV style="position:absolute;top:906;left:546"><nobr><span class="ft5"> repository in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:906;left:647"><nobr><span class="ft14">share/config </span></nobr></DIV> |
| <DIV style="position:absolute;top:926;left:214"><nobr><span class="ft5">directory.</span></nobr></DIV> |
| <DIV style="position:absolute;top:990;left:193"><nobr><span class="ft5"> Images specific to the help need to be added to the CVS </span></nobr></DIV> |
| <DIV style="position:absolute;top:990;left:548"><nobr><span class="ft14">default_images</span></nobr></DIV> |
| <DIV style="position:absolute;top:990;left:661"><nobr><span class="ft5"> module in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:1010;left:214"><nobr><span class="ft14">helpimg</span></nobr></DIV> |
| <DIV style="position:absolute;top:1010;left:271"><nobr><span class="ft5"> subdirectory. These will then also be included in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:1010;left:553"><nobr><span class="ft14">images.zip</span></nobr></DIV> |
| <DIV style="position:absolute;top:1010;left:634"><nobr><span class="ft5"> archive.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1115;left:85"><nobr><span class="ft19">4</span></nobr></DIV> |
| <DIV style="position:absolute;top:1115;left:106"><nobr><span class="ft19">The subdirectory structure of this directory has historical reasons.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>18</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 19 --> |
| <a name="19"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c019.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:236"><nobr><span class="ft10"><b>Building the Help Set</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:182;left:236"><nobr><span class="ft8"><b>Setting Up A Build Environment</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:208;left:236"><nobr><span class="ft3">This is described on </span></nobr></DIV> |
| <DIV style="position:absolute;top:210;left:373"><nobr><span class="ft14">tools.openoffice.org</span></nobr></DIV> |
| <DIV style="position:absolute;top:208;left:535"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:260;left:236"><nobr><span class="ft8"><b>Makefiles For The Help</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:286;left:236"><nobr><span class="ft3">The </span></nobr></DIV> |
| <DIV style="position:absolute;top:289;left:266"><nobr><span class="ft14">helpcontent2</span></nobr></DIV> |
| <DIV style="position:absolute;top:286;left:363"><nobr><span class="ft3"> module contains three types of makefiles:</span></nobr></DIV> |
| <DIV style="position:absolute;top:326;left:263"><nobr><span class="ft3">1. <b>Makefiles for compiling the help source files</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:347;left:290"><nobr><span class="ft3">These makefiles are found in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:350;left:533"><nobr><span class="ft14">helpcontent2/source/text</span></nobr></DIV> |
| <DIV style="position:absolute;top:347;left:727"><nobr><span class="ft3"> directories. </span></nobr></DIV> |
| <DIV style="position:absolute;top:370;left:290"><nobr><span class="ft3">Every subdirectory that contains help files to be compiled has a </span></nobr></DIV> |
| <DIV style="position:absolute;top:391;left:290"><nobr><span class="ft3">corresponding makefile, for example (<i>shortened for clarity</i>):</span></nobr></DIV> |
| <DIV style="position:absolute;top:437;left:309"><nobr><span class="ft5">#***************************************************************</span></nobr></DIV> |
| <DIV style="position:absolute;top:454;left:309"><nobr><span class="ft5">#***************************************************************</span></nobr></DIV> |
| <DIV style="position:absolute;top:471;left:309"><nobr><span class="ft5"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:488;left:309"><nobr><span class="ft5"># edit to match directory level</span></nobr></DIV> |
| <DIV style="position:absolute;top:505;left:309"><nobr><span class="ft5">PRJ = ..$/..$/..$/..</span></nobr></DIV> |
| <DIV style="position:absolute;top:522;left:309"><nobr><span class="ft5"># same for all makefiles in "helpcontent2"</span></nobr></DIV> |
| <DIV style="position:absolute;top:539;left:309"><nobr><span class="ft5">PRJNAME = helpcontent2</span></nobr></DIV> |
| <DIV style="position:absolute;top:556;left:309"><nobr><span class="ft5"># edit to match the current package</span></nobr></DIV> |
| <DIV style="position:absolute;top:573;left:309"><nobr><span class="ft5">PACKAGE = text/sbasic/guide</span></nobr></DIV> |
| <DIV style="position:absolute;top:590;left:309"><nobr><span class="ft5"># uniqe name (module wide);</span></nobr></DIV> |
| <DIV style="position:absolute;top:607;left:309"><nobr><span class="ft5"># using a modified forme of package should do here</span></nobr></DIV> |
| <DIV style="position:absolute;top:624;left:309"><nobr><span class="ft5">TARGET = text_sbasic_guide</span></nobr></DIV> |
| <DIV style="position:absolute;top:641;left:309"><nobr><span class="ft5"># edit to match the current module</span></nobr></DIV> |
| <DIV style="position:absolute;top:658;left:309"><nobr><span class="ft5">MODULE = sbasic</span></nobr></DIV> |
| <DIV style="position:absolute;top:675;left:309"><nobr><span class="ft5"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:692;left:309"><nobr><span class="ft5"># --- Settings ------------------------------------------------</span></nobr></DIV> |
| <DIV style="position:absolute;top:709;left:309"><nobr><span class="ft5"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:726;left:309"><nobr><span class="ft5">.INCLUDE : settings.mk</span></nobr></DIV> |
| <DIV style="position:absolute;top:743;left:309"><nobr><span class="ft5">.INCLUDE : $(PRJ)$/settings.pmk</span></nobr></DIV> |
| <DIV style="position:absolute;top:777;left:309"><nobr><span class="ft5"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:794;left:309"><nobr><span class="ft5"># this list matches the *.xhp files to process</span></nobr></DIV> |
| <DIV style="position:absolute;top:811;left:309"><nobr><span class="ft5">HZIPFILES = \</span></nobr></DIV> |
| <DIV style="position:absolute;top:829;left:309"><nobr><span class="ft5"> control_properties.hzip \</span></nobr></DIV> |
| <DIV style="position:absolute;top:845;left:309"><nobr><span class="ft5"> create_dialog.hzip \</span></nobr></DIV> |
| <DIV style="position:absolute;top:863;left:309"><nobr><span class="ft5"> insert_control.hzip \</span></nobr></DIV> |
| <DIV style="position:absolute;top:880;left:309"><nobr><span class="ft5"> sample_code.hzip \</span></nobr></DIV> |
| <DIV style="position:absolute;top:897;left:309"><nobr><span class="ft5"> show_dialog.hzip</span></nobr></DIV> |
| <DIV style="position:absolute;top:914;left:309"><nobr><span class="ft5"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:931;left:309"><nobr><span class="ft5"># --- Targets -------------------------------------------------</span></nobr></DIV> |
| <DIV style="position:absolute;top:948;left:309"><nobr><span class="ft5"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:965;left:309"><nobr><span class="ft5">.INCLUDE : target.mk</span></nobr></DIV> |
| <DIV style="position:absolute;top:982;left:309"><nobr><span class="ft5">.INCLUDE : $(PRJ)$/makefile.pmk</span></nobr></DIV> |
| <DIV style="position:absolute;top:1012;left:290"><nobr><span class="ft3">You find a template for this makefile in </span></nobr></DIV> |
| <DIV style="position:absolute;top:1014;left:603"><nobr><span class="ft14">helpcontent2/helpers</span></nobr></DIV> |
| <DIV style="position:absolute;top:1012;left:765"><nobr><span class="ft3">. This </span></nobr></DIV> |
| <DIV style="position:absolute;top:1034;left:290"><nobr><span class="ft3">template is used when the makefiles are created using the </span></nobr></DIV> |
| <DIV style="position:absolute;top:1058;left:290"><nobr><span class="ft14">createmakefile.pl</span></nobr></DIV> |
| <DIV style="position:absolute;top:1055;left:427"><nobr><span class="ft3"> script in </span></nobr></DIV> |
| <DIV style="position:absolute;top:1058;left:502"><nobr><span class="ft14">helpcontent2/helpers</span></nobr></DIV> |
| <DIV style="position:absolute;top:1055;left:664"><nobr><span class="ft3">. Use this script for </span></nobr></DIV> |
| <DIV style="position:absolute;top:1078;left:290"><nobr><span class="ft3">makefile creation and don't modify the makefiles manually.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>19</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 20 --> |
| <a name="20"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c020.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:220"><nobr><span class="ft3">2. <b>Makefiles for linking the compiled files.</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:157;left:247"><nobr><span class="ft3">These makefiles are found in the subdirectories of </span></nobr></DIV> |
| <DIV style="position:absolute;top:160;left:596"><nobr><span class="ft14">helpcontent2/util</span></nobr></DIV> |
| <DIV style="position:absolute;top:157;left:734"><nobr><span class="ft3"> (the </span></nobr></DIV> |
| <DIV style="position:absolute;top:180;left:247"><nobr><span class="ft3">directory itself contains the third type of makefile), for example (<i>shortened for </i></span></nobr></DIV> |
| <DIV style="position:absolute;top:201;left:247"><nobr><span class="ft13"><i>clarity</i>):</span></nobr></DIV> |
| <DIV style="position:absolute;top:247;left:267"><nobr><span class="ft5">#**************************************************************</span></nobr></DIV> |
| <DIV style="position:absolute;top:264;left:267"><nobr><span class="ft5">#**************************************************************</span></nobr></DIV> |
| <DIV style="position:absolute;top:281;left:267"><nobr><span class="ft5"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:298;left:267"><nobr><span class="ft5"># edit to match directory level</span></nobr></DIV> |
| <DIV style="position:absolute;top:315;left:267"><nobr><span class="ft5">PRJ = ..$/..</span></nobr></DIV> |
| <DIV style="position:absolute;top:332;left:267"><nobr><span class="ft5"># same for all makefiles in "helpcontent2"</span></nobr></DIV> |
| <DIV style="position:absolute;top:349;left:267"><nobr><span class="ft5">PRJNAME = helpcontent2</span></nobr></DIV> |
| <DIV style="position:absolute;top:366;left:267"><nobr><span class="ft5"># uniqe name (module wide);</span></nobr></DIV> |
| <DIV style="position:absolute;top:383;left:267"><nobr><span class="ft5"># using a modified forme of package should do here</span></nobr></DIV> |
| <DIV style="position:absolute;top:400;left:267"><nobr><span class="ft5">TARGET = util_sbasic</span></nobr></DIV> |
| <DIV style="position:absolute;top:417;left:267"><nobr><span class="ft5"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:434;left:267"><nobr><span class="ft5"># --- Settings ------------------------------------------------</span></nobr></DIV> |
| <DIV style="position:absolute;top:451;left:267"><nobr><span class="ft5"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:468;left:267"><nobr><span class="ft5">.INCLUDE : settings.mk</span></nobr></DIV> |
| <DIV style="position:absolute;top:485;left:267"><nobr><span class="ft5">.INCLUDE : $(PRJ)$/settings.pmk</span></nobr></DIV> |
| <DIV style="position:absolute;top:519;left:267"><nobr><span class="ft5">.IF "$(SOLAR_JAVA)"!=""</span></nobr></DIV> |
| <DIV style="position:absolute;top:536;left:267"><nobr><span class="ft5">common_build_zip:=</span></nobr></DIV> |
| <DIV style="position:absolute;top:553;left:267"><nobr><span class="ft5">zip1generatedlangs=TRUE</span></nobr></DIV> |
| <DIV style="position:absolute;top:571;left:267"><nobr><span class="ft5">zip1langdirs=$(aux_alllangiso)</span></nobr></DIV> |
| <DIV style="position:absolute;top:587;left:267"><nobr><span class="ft5">ZIP1TARGET=xhp_sbasic</span></nobr></DIV> |
| <DIV style="position:absolute;top:605;left:267"><nobr><span class="ft5">ZIP1FLAGS= -u -r</span></nobr></DIV> |
| <DIV style="position:absolute;top:622;left:267"><nobr><span class="ft5">ZIP1DIR=$(MISC)$/$(LANGDIR)</span></nobr></DIV> |
| <DIV style="position:absolute;top:639;left:267"><nobr><span class="ft5">ZIP1LIST=$(LANGDIR)$/text$/sbasic$/* -x "*.dphh*" \</span></nobr></DIV> |
| <DIV style="position:absolute;top:656;left:267"><nobr><span class="ft5">-x "*.hzip" -x "*.created"</span></nobr></DIV> |
| <DIV style="position:absolute;top:673;left:267"><nobr><span class="ft5">.ENDIF</span></nobr></DIV> |
| <DIV style="position:absolute;top:673;left:470"><nobr><span class="ft5"># "$(SOLAR_JAVA)"!=""</span></nobr></DIV> |
| <DIV style="position:absolute;top:690;left:267"><nobr><span class="ft5"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:707;left:267"><nobr><span class="ft5">LINKNAME=sbasic</span></nobr></DIV> |
| <DIV style="position:absolute;top:724;left:267"><nobr><span class="ft5">LINKADDEDFILES= \</span></nobr></DIV> |
| <DIV style="position:absolute;top:741;left:267"><nobr><span class="ft5"> -add sbasic.cfg </span></nobr></DIV> |
| <DIV style="position:absolute;top:756;left:267"><nobr><span class="ft5">$(PRJ)$/source$/auxiliary$/LANGUAGE$/sbasic.cfg \</span></nobr></DIV> |
| <DIV style="position:absolute;top:773;left:267"><nobr><span class="ft5"> -add sbasic.tree </span></nobr></DIV> |
| <DIV style="position:absolute;top:788;left:267"><nobr><span class="ft5">$(PRJ)$/source$/auxiliary$/LANGUAGE$/sbasic.tree \</span></nobr></DIV> |
| <DIV style="position:absolute;top:805;left:267"><nobr><span class="ft5"> -add sbasic.jar $(BIN)$/xhp_sbasic_LANGUAGE.zip</span></nobr></DIV> |
| <DIV style="position:absolute;top:822;left:267"><nobr><span class="ft5"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:839;left:267"><nobr><span class="ft5"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:856;left:267"><nobr><span class="ft5">LINKADDEDDEPS= \</span></nobr></DIV> |
| <DIV style="position:absolute;top:874;left:267"><nobr><span class="ft5"> $(PRJ)$/source$/auxiliary$/LANGUAGE$/sbasic.cfg \</span></nobr></DIV> |
| <DIV style="position:absolute;top:890;left:267"><nobr><span class="ft5"> $(PRJ)$/source$/auxiliary$/LANGUAGE$/sbasic.tree \</span></nobr></DIV> |
| <DIV style="position:absolute;top:908;left:267"><nobr><span class="ft5"> $(BIN)$/xhp_sbasic_LANGUAGE.zip</span></nobr></DIV> |
| <DIV style="position:absolute;top:942;left:267"><nobr><span class="ft5"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:959;left:267"><nobr><span class="ft5">LINKLINKFILES= \</span></nobr></DIV> |
| <DIV style="position:absolute;top:976;left:267"><nobr><span class="ft5"> text$/sbasic$/guide$/control_properties.hzip \</span></nobr></DIV> |
| <DIV style="position:absolute;top:993;left:267"><nobr><span class="ft5"> text$/sbasic$/guide$/create_dialog.hzip \</span></nobr></DIV> |
| <DIV style="position:absolute;top:1010;left:267"><nobr><span class="ft5"> text$/sbasic$/guide$/insert_control.hzip \</span></nobr></DIV> |
| <DIV style="position:absolute;top:1027;left:267"><nobr><span class="ft5"> text$/sbasic$/guide$/sample_code.hzip \</span></nobr></DIV> |
| <DIV style="position:absolute;top:1044;left:267"><nobr><span class="ft5"> text$/sbasic$/guide$/show_dialog.hzip \</span></nobr></DIV> |
| <DIV style="position:absolute;top:1078;left:267"><nobr><span class="ft5"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:1095;left:267"><nobr><span class="ft5"># --- Targets -------------------------------------------------</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>20</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 21 --> |
| <a name="21"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| .ft24{font-size:8px;font-family:Times;color:#00007f;} |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c021.png" alt="background image"> |
| <DIV style="position:absolute;top:146;left:309"><nobr><span class="ft5"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:163;left:309"><nobr><span class="ft5">.INCLUDE : target.mk</span></nobr></DIV> |
| <DIV style="position:absolute;top:180;left:309"><nobr><span class="ft5">.INCLUDE : $(PRJ)$/util$/target.pmk</span></nobr></DIV> |
| <DIV style="position:absolute;top:210;left:290"><nobr><span class="ft3">You find a template for this makefile in </span></nobr></DIV> |
| <DIV style="position:absolute;top:213;left:603"><nobr><span class="ft14">helpcontent2/helpers</span></nobr></DIV> |
| <DIV style="position:absolute;top:210;left:765"><nobr><span class="ft3">. This </span></nobr></DIV> |
| <DIV style="position:absolute;top:233;left:290"><nobr><span class="ft3">template is used when the makefiles are created using the </span></nobr></DIV> |
| <DIV style="position:absolute;top:256;left:290"><nobr><span class="ft14">createmakefile.pl</span></nobr></DIV> |
| <DIV style="position:absolute;top:254;left:427"><nobr><span class="ft3"> script in </span></nobr></DIV> |
| <DIV style="position:absolute;top:256;left:502"><nobr><span class="ft14">helpcontent2/helpers</span></nobr></DIV> |
| <DIV style="position:absolute;top:254;left:664"><nobr><span class="ft3">. Use this script for </span></nobr></DIV> |
| <DIV style="position:absolute;top:276;left:290"><nobr><span class="ft3">makefile creation and not to modify the makefiles manually.</span></nobr></DIV> |
| <DIV style="position:absolute;top:315;left:263"><nobr><span class="ft3">3. A makefile for creating the stylesheet archive in </span></nobr></DIV> |
| <DIV style="position:absolute;top:317;left:670"><nobr><span class="ft14">helpcontent2/util </span></nobr></DIV> |
| <DIV style="position:absolute;top:337;left:290"><nobr><span class="ft3">(shortened for clarity):</span></nobr></DIV> |
| <DIV style="position:absolute;top:383;left:309"><nobr><span class="ft5">#**************************************************************</span></nobr></DIV> |
| <DIV style="position:absolute;top:400;left:309"><nobr><span class="ft5">#**************************************************************</span></nobr></DIV> |
| <DIV style="position:absolute;top:417;left:309"><nobr><span class="ft5"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:434;left:309"><nobr><span class="ft5"># edit to match directory level</span></nobr></DIV> |
| <DIV style="position:absolute;top:451;left:309"><nobr><span class="ft5">PRJ = ..</span></nobr></DIV> |
| <DIV style="position:absolute;top:468;left:309"><nobr><span class="ft5"># same for all makefiles in "helpcontent2"</span></nobr></DIV> |
| <DIV style="position:absolute;top:485;left:309"><nobr><span class="ft5">PRJNAME = helpcontent2</span></nobr></DIV> |
| <DIV style="position:absolute;top:502;left:309"><nobr><span class="ft5"># uniqe name (module wide);</span></nobr></DIV> |
| <DIV style="position:absolute;top:519;left:309"><nobr><span class="ft5"># using a modified forme of package should do here</span></nobr></DIV> |
| <DIV style="position:absolute;top:536;left:309"><nobr><span class="ft5">TARGET = plain_util</span></nobr></DIV> |
| <DIV style="position:absolute;top:553;left:309"><nobr><span class="ft5"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:571;left:309"><nobr><span class="ft5"># --- Settings ------------------------------------------------</span></nobr></DIV> |
| <DIV style="position:absolute;top:587;left:309"><nobr><span class="ft5">.INCLUDE : settings.mk </span></nobr></DIV> |
| <DIV style="position:absolute;top:605;left:309"><nobr><span class="ft5">.INCLUDE : $(PRJ)$/settings.pmk</span></nobr></DIV> |
| <DIV style="position:absolute;top:622;left:309"><nobr><span class="ft5"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:639;left:309"><nobr><span class="ft5">ZIP1TARGET=helpxsl</span></nobr></DIV> |
| <DIV style="position:absolute;top:656;left:309"><nobr><span class="ft5">ZIP1FLAGS= -u -r</span></nobr></DIV> |
| <DIV style="position:absolute;top:673;left:309"><nobr><span class="ft5">ZIP1DIR=$(PRJ)$/source$/auxiliary</span></nobr></DIV> |
| <DIV style="position:absolute;top:690;left:309"><nobr><span class="ft5">ZIP1LIST=main_transform*.xsl</span></nobr></DIV> |
| <DIV style="position:absolute;top:707;left:309"><nobr><span class="ft5"># --- Targets -------------------------------------------------</span></nobr></DIV> |
| <DIV style="position:absolute;top:724;left:309"><nobr><span class="ft5"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:741;left:309"><nobr><span class="ft5">.INCLUDE : target.mk</span></nobr></DIV> |
| <DIV style="position:absolute;top:758;left:309"><nobr><span class="ft5"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:775;left:309"><nobr><span class="ft5">ALLTAR : $(COMMONBIN)$/helpimg.ilst</span></nobr></DIV> |
| <DIV style="position:absolute;top:792;left:309"><nobr><span class="ft5"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:809;left:309"><nobr><span class="ft5">$(COMMONBIN)$/helpimg.ilst: helpimg.ilst</span></nobr></DIV> |
| <DIV style="position:absolute;top:826;left:309"><nobr><span class="ft5"> $(COPY) $< $@</span></nobr></DIV> |
| <DIV style="position:absolute;top:868;left:236"><nobr><span class="ft8"><b>Help Build Process</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:894;left:236"><nobr><span class="ft3">The file </span></nobr></DIV> |
| <DIV style="position:absolute;top:897;left:297"><nobr><span class="ft14">helpconten2/prj/build.lst</span></nobr></DIV> |
| <DIV style="position:absolute;top:894;left:500"><nobr><span class="ft3"> defines which directories are built using a </span></nobr></DIV> |
| <DIV style="position:absolute;top:917;left:236"><nobr><span class="ft3">directory's makefile. Dependencies (which directories need to be built first) are also </span></nobr></DIV> |
| <DIV style="position:absolute;top:938;left:236"><nobr><span class="ft3">defined here.<A href="HelpAuthoring_c.html#21">[5]</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:977;left:236"><nobr><span class="ft3">Initiate a help build by issuing the command </span></nobr></DIV> |
| <DIV style="position:absolute;top:979;left:568"><nobr><span class="ft14">build</span></nobr></DIV> |
| <DIV style="position:absolute;top:977;left:609"><nobr><span class="ft3"> while in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:979;left:711"><nobr><span class="ft14">helpcontent2 </span></nobr></DIV> |
| <DIV style="position:absolute;top:999;left:236"><nobr><span class="ft3">directory.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1103;left:128"><nobr><span class="ft19">5</span></nobr></DIV> |
| <DIV style="position:absolute;top:1103;left:149"><nobr><span class="ft19">More information about the build process for OpenOffice.org in general can be found on<A href="http://tools.openoffice.org/"> </a></span></nobr></DIV> |
| <DIV style="position:absolute;top:1103;left:558"><nobr><span class="ft24"><A href="http://tools.openoffice.org/">http://tools.openoffice.org</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:1103;left:676"><nobr><span class="ft19">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:1115;left:149"><nobr><span class="ft24"><A href="http://ooo.ximian.com/hackers-guide.html">http://ooo.ximian.com/hackers-guide.html</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:1115;left:340"><nobr><span class="ft19">, or on </span></nobr></DIV> |
| <DIV style="position:absolute;top:1115;left:373"><nobr><span class="ft24"><A href="http://go-oo.org/wiki/index.php/Main_Page">http://go-oo.org/wiki/index.php/Main_Page</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:1115;left:569"><nobr><span class="ft19"><A href="http://go-oo.org/wiki/index.php/Main_Page">.</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>21</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 22 --> |
| <a name="22"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c022.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:220"><nobr><span class="ft3">1. The help files from </span></nobr></DIV> |
| <DIV style="position:absolute;top:138;left:373"><nobr><span class="ft14">helpcontent2/source/text</span></nobr></DIV> |
| <DIV style="position:absolute;top:136;left:560"><nobr><span class="ft3"> are compiled and written to the </span></nobr></DIV> |
| <DIV style="position:absolute;top:161;left:247"><nobr><span class="ft14">misc</span></nobr></DIV> |
| <DIV style="position:absolute;top:158;left:279"><nobr><span class="ft3"> subdirectory of the platform directory of the output tree. This step produces </span></nobr></DIV> |
| <DIV style="position:absolute;top:181;left:247"><nobr><span class="ft3">a set of </span></nobr></DIV> |
| <DIV style="position:absolute;top:183;left:302"><nobr><span class="ft14">*.hzip</span></nobr></DIV> |
| <DIV style="position:absolute;top:181;left:349"><nobr><span class="ft3"> files and dependency files </span></nobr></DIV> |
| <DIV style="position:absolute;top:183;left:529"><nobr><span class="ft14">*.dphh</span></nobr></DIV> |
| <DIV style="position:absolute;top:181;left:576"><nobr><span class="ft3">. These files are the particles </span></nobr></DIV> |
| <DIV style="position:absolute;top:203;left:247"><nobr><span class="ft3">that are used to create the help modules in the next the linking step.</span></nobr></DIV> |
| <DIV style="position:absolute;top:233;left:220"><nobr><span class="ft3">2. The compiled help files are taken from the </span></nobr></DIV> |
| <DIV style="position:absolute;top:236;left:533"><nobr><span class="ft14">misc</span></nobr></DIV> |
| <DIV style="position:absolute;top:233;left:565"><nobr><span class="ft3"> directory and linked into a zip </span></nobr></DIV> |
| <DIV style="position:absolute;top:255;left:247"><nobr><span class="ft3">archive. Other files are added from the </span></nobr></DIV> |
| <DIV style="position:absolute;top:258;left:539"><nobr><span class="ft14">helpcontent2/source/auxiliary </span></nobr></DIV> |
| <DIV style="position:absolute;top:278;left:247"><nobr><span class="ft3">directory to that archive as defined in the makefiles of the subdirectories in </span></nobr></DIV> |
| <DIV style="position:absolute;top:301;left:247"><nobr><span class="ft14">helpcontent2/util</span></nobr></DIV> |
| <DIV style="position:absolute;top:299;left:380"><nobr><span class="ft3">. This results in one zip archive per help module and </span></nobr></DIV> |
| <DIV style="position:absolute;top:321;left:247"><nobr><span class="ft3">language in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:324;left:349"><nobr><span class="ft14">bin</span></nobr></DIV> |
| <DIV style="position:absolute;top:321;left:373"><nobr><span class="ft3"> subdirectory of the platform directory of the output tree.</span></nobr></DIV> |
| <DIV style="position:absolute;top:353;left:220"><nobr><span class="ft3">3. The </span></nobr></DIV> |
| <DIV style="position:absolute;top:355;left:291"><nobr><span class="ft14">helpxsl.zip</span></nobr></DIV> |
| <DIV style="position:absolute;top:353;left:377"><nobr><span class="ft3"> archive is built according to the makefile in </span></nobr></DIV> |
| <DIV style="position:absolute;top:377;left:247"><nobr><span class="ft14">helpcontent2/util</span></nobr></DIV> |
| <DIV style="position:absolute;top:375;left:380"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:406;left:220"><nobr><span class="ft3">4. All archive files are delivered according to the </span></nobr></DIV> |
| <DIV style="position:absolute;top:408;left:539"><nobr><span class="ft14">d.lst</span></nobr></DIV> |
| <DIV style="position:absolute;top:406;left:578"><nobr><span class="ft3"> file in </span></nobr></DIV> |
| <DIV style="position:absolute;top:408;left:619"><nobr><span class="ft14">helpcontent2/prj</span></nobr></DIV> |
| <DIV style="position:absolute;top:406;left:744"><nobr><span class="ft3">.[<A href="HelpAuthoring_c.html#21">5</a>]</span></nobr></DIV> |
| <DIV style="position:absolute;top:450;left:193"><nobr><span class="ft8"><b>Adding A Help File To Or Removing A Help File From The Set Of Help Files</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:476;left:193"><nobr><span class="ft3">The makefiles need to be adjusted to reflect the changes you made to the set of files. </span></nobr></DIV> |
| <DIV style="position:absolute;top:497;left:193"><nobr><span class="ft3">If you added a new file, add this to the makefile of its directory and to the link makefile </span></nobr></DIV> |
| <DIV style="position:absolute;top:518;left:193"><nobr><span class="ft3">(in </span></nobr></DIV> |
| <DIV style="position:absolute;top:521;left:216"><nobr><span class="ft14">helpcontent2/util/*</span></nobr></DIV> |
| <DIV style="position:absolute;top:518;left:370"><nobr><span class="ft3">) of any module that will contain the file. If you deleted a </span></nobr></DIV> |
| <DIV style="position:absolute;top:541;left:193"><nobr><span class="ft3">help file, remove it from the makefile of its directory and from the link makefile (in </span></nobr></DIV> |
| <DIV style="position:absolute;top:564;left:193"><nobr><span class="ft14">helpcontent2/util/*</span></nobr></DIV> |
| <DIV style="position:absolute;top:562;left:347"><nobr><span class="ft3">) of any module that contains the file.</span></nobr></DIV> |
| <DIV style="position:absolute;top:616;left:193"><nobr><span class="ft5"> The safest way is to run the create_makefiles.pl script from helpcontent2/helpers to update the </span></nobr></DIV> |
| <DIV style="position:absolute;top:635;left:214"><nobr><span class="ft5">makefiles.</span></nobr></DIV> |
| <DIV style="position:absolute;top:685;left:193"><nobr><span class="ft3">If you rebuild the help after help files have been deleted, or after dependencies </span></nobr></DIV> |
| <DIV style="position:absolute;top:706;left:193"><nobr><span class="ft3">(references) between the files have been changed, you need to remove all </span></nobr></DIV> |
| <DIV style="position:absolute;top:728;left:193"><nobr><span class="ft3">dependency files from the </span></nobr></DIV> |
| <DIV style="position:absolute;top:730;left:369"><nobr><span class="ft14">misc</span></nobr></DIV> |
| <DIV style="position:absolute;top:728;left:402"><nobr><span class="ft3"> directory that are no longer valid. To be perfectly safe, </span></nobr></DIV> |
| <DIV style="position:absolute;top:750;left:193"><nobr><span class="ft3">you can remove the complete output tree for the platform of the </span></nobr></DIV> |
| <DIV style="position:absolute;top:752;left:668"><nobr><span class="ft14">helpcontent2 </span></nobr></DIV> |
| <DIV style="position:absolute;top:772;left:193"><nobr><span class="ft3">module.</span></nobr></DIV> |
| <DIV style="position:absolute;top:815;left:193"><nobr><span class="ft8"><b>Help Images</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:841;left:193"><nobr><span class="ft3">Images that are used inside the help are stored in different modules and accessed by </span></nobr></DIV> |
| <DIV style="position:absolute;top:862;left:193"><nobr><span class="ft3">the help viewer using the </span></nobr></DIV> |
| <DIV style="position:absolute;top:865;left:365"><nobr><span class="ft14">images.zip</span></nobr></DIV> |
| <DIV style="position:absolute;top:862;left:446"><nobr><span class="ft3"> archive on runtime. Therefore, you need to add </span></nobr></DIV> |
| <DIV style="position:absolute;top:885;left:193"><nobr><span class="ft3">help images, such as screenshots, to the </span></nobr></DIV> |
| <DIV style="position:absolute;top:887;left:481"><nobr><span class="ft14">helpimg</span></nobr></DIV> |
| <DIV style="position:absolute;top:885;left:538"><nobr><span class="ft3"> directory of the </span></nobr></DIV> |
| <DIV style="position:absolute;top:887;left:652"><nobr><span class="ft14">default_images </span></nobr></DIV> |
| <DIV style="position:absolute;top:907;left:193"><nobr><span class="ft3">module. Including the help images to the </span></nobr></DIV> |
| <DIV style="position:absolute;top:909;left:477"><nobr><span class="ft14">images.zip</span></nobr></DIV> |
| <DIV style="position:absolute;top:907;left:558"><nobr><span class="ft3"> repository is controlled by the </span></nobr></DIV> |
| <DIV style="position:absolute;top:932;left:193"><nobr><span class="ft14">helpimg.ilst</span></nobr></DIV> |
| <DIV style="position:absolute;top:929;left:290"><nobr><span class="ft3"> file that is found in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:932;left:444"><nobr><span class="ft14">util</span></nobr></DIV> |
| <DIV style="position:absolute;top:929;left:477"><nobr><span class="ft3"> directory of </span></nobr></DIV> |
| <DIV style="position:absolute;top:932;left:559"><nobr><span class="ft14">helpcontent2</span></nobr></DIV> |
| <DIV style="position:absolute;top:929;left:657"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:969;left:193"><nobr><span class="ft3">The </span></nobr></DIV> |
| <DIV style="position:absolute;top:971;left:224"><nobr><span class="ft14">helpimg.ilst</span></nobr></DIV> |
| <DIV style="position:absolute;top:969;left:321"><nobr><span class="ft3"> file contains all image files to be included for </span></nobr></DIV> |
| <DIV style="position:absolute;top:971;left:634"><nobr><span class="ft14">helpcontent2</span></nobr></DIV> |
| <DIV style="position:absolute;top:969;left:731"><nobr><span class="ft3">, one </span></nobr></DIV> |
| <DIV style="position:absolute;top:991;left:193"><nobr><span class="ft3">file per line. The variable </span></nobr></DIV> |
| <DIV style="position:absolute;top:993;left:385"><nobr><span class="ft14">%GLOBALRES%</span></nobr></DIV> |
| <DIV style="position:absolute;top:991;left:474"><nobr><span class="ft3"> is used to designate the default image </span></nobr></DIV> |
| <DIV style="position:absolute;top:1013;left:193"><nobr><span class="ft3">directory:</span></nobr></DIV> |
| <DIV style="position:absolute;top:1059;left:224"><nobr><span class="ft5">%GLOBALRES%/helpimg/calcein.png</span></nobr></DIV> |
| <DIV style="position:absolute;top:1104;left:193"><nobr><span class="ft5"> Don't forget the localized files in the subdirectories.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>22</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 23 --> |
| <a name="23"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c023.png" alt="background image"> |
| <DIV style="position:absolute;top:345;left:128"><nobr><span class="ft7">2 Help File XML format Basics</span></nobr></DIV> |
| <DIV style="position:absolute;top:399;left:236"><nobr><span class="ft10"><b>Basic Document Structure</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:433;left:236"><nobr><span class="ft3">The basic structure of a valid help file for OpenOffice.org consists of a </span></nobr></DIV> |
| <DIV style="position:absolute;top:435;left:711"><nobr><span class="ft9">helpdocument </span></nobr></DIV> |
| <DIV style="position:absolute;top:458;left:236"><nobr><span class="ft14">root</span></nobr></DIV> |
| <DIV style="position:absolute;top:455;left:268"><nobr><span class="ft3"> element with one </span></nobr></DIV> |
| <DIV style="position:absolute;top:458;left:392"><nobr><span class="ft14">meta</span></nobr></DIV> |
| <DIV style="position:absolute;top:455;left:424"><nobr><span class="ft3"> and one </span></nobr></DIV> |
| <DIV style="position:absolute;top:458;left:489"><nobr><span class="ft14">body</span></nobr></DIV> |
| <DIV style="position:absolute;top:455;left:521"><nobr><span class="ft3"> sub-element containing the content (</span></nobr></DIV> |
| <DIV style="position:absolute;top:458;left:770"><nobr><span class="ft14">body</span></nobr></DIV> |
| <DIV style="position:absolute;top:455;left:803"><nobr><span class="ft3">) </span></nobr></DIV> |
| <DIV style="position:absolute;top:478;left:236"><nobr><span class="ft3">and meta information (</span></nobr></DIV> |
| <DIV style="position:absolute;top:480;left:386"><nobr><span class="ft14">meta</span></nobr></DIV> |
| <DIV style="position:absolute;top:478;left:418"><nobr><span class="ft3">). The minimum information is a topic title and the filename </span></nobr></DIV> |
| <DIV style="position:absolute;top:500;left:236"><nobr><span class="ft3">inside the elements </span></nobr></DIV> |
| <DIV style="position:absolute;top:539;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:542;left:290"><nobr><span class="ft14">/helpdocument/meta/topic/title</span></nobr></DIV> |
| <DIV style="position:absolute;top:540;left:533"><nobr><span class="ft3"> and</span></nobr></DIV> |
| <DIV style="position:absolute;top:572;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:576;left:290"><nobr><span class="ft14">/helpdocument/meta/topic/filename</span></nobr></DIV> |
| <DIV style="position:absolute;top:641;left:267"><nobr><span class="ft5"><?xml version="1.0" encoding="UTF-8"?></span></nobr></DIV> |
| <DIV style="position:absolute;top:658;left:267"><nobr><span class="ft5"><helpdocument version="1.0"></span></nobr></DIV> |
| <DIV style="position:absolute;top:676;left:267"><nobr><span class="ft5"> <meta></span></nobr></DIV> |
| <DIV style="position:absolute;top:692;left:267"><nobr><span class="ft5"> <topic id="someid" indexer="include" status="PUBLISH"></span></nobr></DIV> |
| <DIV style="position:absolute;top:710;left:267"><nobr><span class="ft5"> <title xml-lang="en-US" id="tit">Topic Title</title></span></nobr></DIV> |
| <DIV style="position:absolute;top:727;left:267"><nobr><span class="ft5"> <filename>text/swriter/01/012345.xhp</filename></span></nobr></DIV> |
| <DIV style="position:absolute;top:744;left:267"><nobr><span class="ft5"> </topic></span></nobr></DIV> |
| <DIV style="position:absolute;top:761;left:267"><nobr><span class="ft5"> </meta></span></nobr></DIV> |
| <DIV style="position:absolute;top:778;left:267"><nobr><span class="ft5"> <body></span></nobr></DIV> |
| <DIV style="position:absolute;top:795;left:267"><nobr><span class="ft5"> </body></span></nobr></DIV> |
| <DIV style="position:absolute;top:812;left:267"><nobr><span class="ft5"></helpdocument></span></nobr></DIV> |
| <DIV style="position:absolute;top:856;left:236"><nobr><span class="ft5"> The help file extension is </span></nobr></DIV> |
| <DIV style="position:absolute;top:856;left:393"><nobr><span class="ft14">xhp</span></nobr></DIV> |
| <DIV style="position:absolute;top:856;left:417"><nobr><span class="ft5">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:921;left:236"><nobr><span class="ft10"><b>Using Variables</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:954;left:236"><nobr><span class="ft3">In the help files the following variables are used to designate the name and the </span></nobr></DIV> |
| <DIV style="position:absolute;top:976;left:236"><nobr><span class="ft3">version of the product. This is to allow for correct branding of the product (for </span></nobr></DIV> |
| <DIV style="position:absolute;top:997;left:236"><nobr><span class="ft3">example, OpenOffice.org vs. StarOffice). You must never use the literal name of the </span></nobr></DIV> |
| <DIV style="position:absolute;top:1018;left:236"><nobr><span class="ft3">product but instead one of the following variables[<A href="HelpAuthoring_c.html#23">6</a>]:</span></nobr></DIV> |
| <DIV style="position:absolute;top:1100;left:128"><nobr><span class="ft19">6</span></nobr></DIV> |
| <DIV style="position:absolute;top:1100;left:149"><nobr><span class="ft19">In addition to these variables, the following two variables are still used in the help files for legacy reasons but deprecated: </span></nobr></DIV> |
| <DIV style="position:absolute;top:1100;left:713"><nobr><span class="ft17">$[officename] </span></nobr></DIV> |
| <DIV style="position:absolute;top:1114;left:149"><nobr><span class="ft19">and </span></nobr></DIV> |
| <DIV style="position:absolute;top:1113;left:169"><nobr><span class="ft17">$[officeversion]</span></nobr></DIV> |
| <DIV style="position:absolute;top:1114;left:284"><nobr><span class="ft19">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>23</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 24 --> |
| <a name="24"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c024.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:220"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:140;left:247"><nobr><span class="ft14">%PRODUCTNAME</span></nobr></DIV> |
| <DIV style="position:absolute;top:137;left:344"><nobr><span class="ft3"> designates the name of the product, for example </span></nobr></DIV> |
| <DIV style="position:absolute;top:160;left:247"><nobr><span class="ft8"><b>OpenOffice.org</b>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:191;left:220"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:195;left:247"><nobr><span class="ft14">%PRODUCTVERSION</span></nobr></DIV> |
| <DIV style="position:absolute;top:192;left:369"><nobr><span class="ft3"> designates the current version of the product, for example </span></nobr></DIV> |
| <DIV style="position:absolute;top:215;left:247"><nobr><span class="ft8"><b>2.0</b>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:245;left:193"><nobr><span class="ft3">Both variables are replaced by the main transformation style sheet </span></nobr></DIV> |
| <DIV style="position:absolute;top:269;left:193"><nobr><span class="ft14">main_transform.xsl</span></nobr></DIV> |
| <DIV style="position:absolute;top:267;left:339"><nobr><span class="ft3"> (see page <A href="HelpAuthoring_c.html#16">16)</a> when the help is displayed. The corresponding </span></nobr></DIV> |
| <DIV style="position:absolute;top:289;left:193"><nobr><span class="ft3">information is taken from the application's configuration information and passed to the </span></nobr></DIV> |
| <DIV style="position:absolute;top:311;left:193"><nobr><span class="ft3">style sheet (see<A href="HelpAuthoring_c.html#16"> <i>The Main Transformation Style Sheet</i> </a>on page<A href="HelpAuthoring_c.html#16"> 16</a>).</span></nobr></DIV> |
| <DIV style="position:absolute;top:363;left:193"><nobr><span class="ft10"><b>Paragraph Roles</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:396;left:193"><nobr><span class="ft3">The main element for help content is a </span></nobr></DIV> |
| <DIV style="position:absolute;top:399;left:476"><nobr><span class="ft14">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:396;left:548"><nobr><span class="ft3">. There is no heading element, </span></nobr></DIV> |
| <DIV style="position:absolute;top:419;left:193"><nobr><span class="ft3">instead all headings are treated as paragraphs with a heading <i>role</i>. The </span></nobr></DIV> |
| <DIV style="position:absolute;top:421;left:674"><nobr><span class="ft14">role</span></nobr></DIV> |
| <DIV style="position:absolute;top:419;left:707"><nobr><span class="ft3"> attribute </span></nobr></DIV> |
| <DIV style="position:absolute;top:441;left:193"><nobr><span class="ft3">defines the role of a paragraph with the </span></nobr></DIV> |
| <DIV style="position:absolute;top:443;left:484"><nobr><span class="ft14">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:441;left:557"><nobr><span class="ft3"> role being the standard. The </span></nobr></DIV> |
| <DIV style="position:absolute;top:463;left:193"><nobr><span class="ft3">values for the role attribute are not defined in the DTD. </span></nobr></DIV> |
| <DIV style="position:absolute;top:508;left:193"><nobr><span class="ft3">During the conversion process (XML</span></nobr></DIV> |
| <DIV style="position:absolute;top:508;left:437"><nobr><span class="ft3">HTML) the </span></nobr></DIV> |
| <DIV style="position:absolute;top:510;left:525"><nobr><span class="ft14">role</span></nobr></DIV> |
| <DIV style="position:absolute;top:508;left:557"><nobr><span class="ft3"> attribute is mapped to a </span></nobr></DIV> |
| <DIV style="position:absolute;top:510;left:725"><nobr><span class="ft14">class </span></nobr></DIV> |
| <DIV style="position:absolute;top:531;left:193"><nobr><span class="ft3">attribute of the corresponding HTML element allowing to influence the layout of the </span></nobr></DIV> |
| <DIV style="position:absolute;top:552;left:193"><nobr><span class="ft3">corresponding paragraph using cascading style sheets.[<A href="HelpAuthoring_c.html#24">7</a>]</span></nobr></DIV> |
| <DIV style="position:absolute;top:591;left:193"><nobr><span class="ft3">The following roles are currently suggested and defined in the help authoring </span></nobr></DIV> |
| <DIV style="position:absolute;top:612;left:193"><nobr><span class="ft3">template. More roles can be defined as required (see also <i><A href="HelpAuthoring_c.html#86">Paragraph Formatting</i></a> on </span></nobr></DIV> |
| <DIV style="position:absolute;top:634;left:193"><nobr><span class="ft3">page <A href="HelpAuthoring_c.html#86">86</a>):</span></nobr></DIV> |
| <DIV style="position:absolute;top:695;left:200"><nobr><span class="ft16"><b>Role</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:695;left:319"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:695;left:556"><nobr><span class="ft16"><b>Converts to...</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:722;left:200"><nobr><span class="ft5">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:722;left:319"><nobr><span class="ft5">A standard paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:722;left:556"><nobr><span class="ft5"><p class="paragraph">...</span></nobr></DIV> |
| <DIV style="position:absolute;top:735;left:556"><nobr><span class="ft5"></p></span></nobr></DIV> |
| <DIV style="position:absolute;top:761;left:200"><nobr><span class="ft5">heading</span></nobr></DIV> |
| <DIV style="position:absolute;top:761;left:319"><nobr><span class="ft5">A heading </span></nobr></DIV> |
| <DIV style="position:absolute;top:775;left:319"><nobr><span class="ft5">If this role is assigned to a paragraph, the </span></nobr></DIV> |
| <DIV style="position:absolute;top:788;left:319"><nobr><span class="ft5">heading level has to be specified using </span></nobr></DIV> |
| <DIV style="position:absolute;top:802;left:319"><nobr><span class="ft5">the level attribute of the paragraph </span></nobr></DIV> |
| <DIV style="position:absolute;top:815;left:319"><nobr><span class="ft5">element.</span></nobr></DIV> |
| <DIV style="position:absolute;top:761;left:556"><nobr><span class="ft5"><h1>...</h1></span></nobr></DIV> |
| <DIV style="position:absolute;top:775;left:556"><nobr><span class="ft5">to</span></nobr></DIV> |
| <DIV style="position:absolute;top:788;left:556"><nobr><span class="ft5"><h6>...</h6></span></nobr></DIV> |
| <DIV style="position:absolute;top:841;left:200"><nobr><span class="ft5">note</span></nobr></DIV> |
| <DIV style="position:absolute;top:841;left:319"><nobr><span class="ft5">A note</span></nobr></DIV> |
| <DIV style="position:absolute;top:841;left:556"><nobr><span class="ft5"><p class="note">...</p></span></nobr></DIV> |
| <DIV style="position:absolute;top:868;left:200"><nobr><span class="ft5">warning</span></nobr></DIV> |
| <DIV style="position:absolute;top:868;left:319"><nobr><span class="ft5">A warning</span></nobr></DIV> |
| <DIV style="position:absolute;top:868;left:556"><nobr><span class="ft5"><p class="warning">...</p></span></nobr></DIV> |
| <DIV style="position:absolute;top:894;left:200"><nobr><span class="ft5">tip</span></nobr></DIV> |
| <DIV style="position:absolute;top:894;left:319"><nobr><span class="ft5">A tip</span></nobr></DIV> |
| <DIV style="position:absolute;top:894;left:556"><nobr><span class="ft5"><p class="tip">...</p></span></nobr></DIV> |
| <DIV style="position:absolute;top:920;left:200"><nobr><span class="ft5">code</span></nobr></DIV> |
| <DIV style="position:absolute;top:920;left:319"><nobr><span class="ft5">A code fragment</span></nobr></DIV> |
| <DIV style="position:absolute;top:920;left:556"><nobr><span class="ft5"><p class="code">...</p></span></nobr></DIV> |
| <DIV style="position:absolute;top:946;left:200"><nobr><span class="ft5">example</span></nobr></DIV> |
| <DIV style="position:absolute;top:946;left:319"><nobr><span class="ft5">An example</span></nobr></DIV> |
| <DIV style="position:absolute;top:946;left:556"><nobr><span class="ft5"><p class="example"> ...</p></span></nobr></DIV> |
| <DIV style="position:absolute;top:973;left:200"><nobr><span class="ft5">tablehead</span></nobr></DIV> |
| <DIV style="position:absolute;top:973;left:319"><nobr><span class="ft5">A table head (first rows)</span></nobr></DIV> |
| <DIV style="position:absolute;top:973;left:556"><nobr><span class="ft5"><p class="tablehead"></span></nobr></DIV> |
| <DIV style="position:absolute;top:986;left:556"><nobr><span class="ft5">...</p></span></nobr></DIV> |
| <DIV style="position:absolute;top:1012;left:200"><nobr><span class="ft5">tablecontent</span></nobr></DIV> |
| <DIV style="position:absolute;top:1012;left:319"><nobr><span class="ft5">Table contents</span></nobr></DIV> |
| <DIV style="position:absolute;top:1012;left:556"><nobr><span class="ft5"><p class="tablecontent"></span></nobr></DIV> |
| <DIV style="position:absolute;top:1026;left:556"><nobr><span class="ft5">...</p></span></nobr></DIV> |
| <DIV style="position:absolute;top:1050;left:193"><nobr><span class="ft18"><i>Table 4: Paragraph Roles</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:1115;left:85"><nobr><span class="ft19">7</span></nobr></DIV> |
| <DIV style="position:absolute;top:1115;left:106"><nobr><span class="ft19">Be advised that the help viewer component does not support all of CSS2.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>24</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 25 --> |
| <a name="25"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| .ft25{font-size:13px;font-family:Times;color:#59537b;} |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c025.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:236"><nobr><span class="ft3">If you use other roles, you must ensure that they are taken into account by the CSS </span></nobr></DIV> |
| <DIV style="position:absolute;top:157;left:236"><nobr><span class="ft3">files that define the help file display format.</span></nobr></DIV> |
| <DIV style="position:absolute;top:209;left:236"><nobr><span class="ft10"><b>Defining Index, Contents, and Context Sensitivity</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:243;left:236"><nobr><span class="ft3">The help uses one unified bookmarking system to set anchors inside the help files </span></nobr></DIV> |
| <DIV style="position:absolute;top:265;left:236"><nobr><span class="ft3">which are used by the </span></nobr></DIV> |
| <DIV style="position:absolute;top:266;left:393"><nobr><span class="ft11"><b>Index</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:265;left:438"><nobr><span class="ft3"> tab, the </span></nobr></DIV> |
| <DIV style="position:absolute;top:266;left:500"><nobr><span class="ft11"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:265;left:572"><nobr><span class="ft3"> tab and for context-sensitive help. </span></nobr></DIV> |
| <DIV style="position:absolute;top:287;left:236"><nobr><span class="ft3">The main element is the </span></nobr></DIV> |
| <DIV style="position:absolute;top:290;left:419"><nobr><span class="ft14">bookmark</span></nobr></DIV> |
| <DIV style="position:absolute;top:287;left:484"><nobr><span class="ft3"> element. A bookmark has a </span></nobr></DIV> |
| <DIV style="position:absolute;top:290;left:697"><nobr><span class="ft14">branch</span></nobr></DIV> |
| <DIV style="position:absolute;top:287;left:746"><nobr><span class="ft3"> attribute </span></nobr></DIV> |
| <DIV style="position:absolute;top:310;left:236"><nobr><span class="ft3">representing the purpose of the bookmark. Currently there are three branches </span></nobr></DIV> |
| <DIV style="position:absolute;top:331;left:236"><nobr><span class="ft3">defined: </span></nobr></DIV> |
| <DIV style="position:absolute;top:333;left:293"><nobr><span class="ft14">contents</span></nobr></DIV> |
| <DIV style="position:absolute;top:331;left:358"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:333;left:366"><nobr><span class="ft14">index</span></nobr></DIV> |
| <DIV style="position:absolute;top:331;left:407"><nobr><span class="ft3">, and </span></nobr></DIV> |
| <DIV style="position:absolute;top:333;left:444"><nobr><span class="ft14">hid</span></nobr></DIV> |
| <DIV style="position:absolute;top:331;left:469"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:371;left:236"><nobr><span class="ft3">To define an anchor for a bookmark inside a help document, the element </span></nobr></DIV> |
| <DIV style="position:absolute;top:373;left:727"><nobr><span class="ft14"><bookmark> </span></nobr></DIV> |
| <DIV style="position:absolute;top:393;left:236"><nobr><span class="ft3">has to be positioned at the place the bookmark will point to. The </span></nobr></DIV> |
| <DIV style="position:absolute;top:395;left:698"><nobr><span class="ft14">branch</span></nobr></DIV> |
| <DIV style="position:absolute;top:393;left:747"><nobr><span class="ft3"> attribute </span></nobr></DIV> |
| <DIV style="position:absolute;top:415;left:236"><nobr><span class="ft3">specifies the type of bookmark to be defined (a content entry, an index entry, or a help </span></nobr></DIV> |
| <DIV style="position:absolute;top:437;left:236"><nobr><span class="ft3">ID), while the sub-element </span></nobr></DIV> |
| <DIV style="position:absolute;top:439;left:428"><nobr><span class="ft14">bookmark_value</span></nobr></DIV> |
| <DIV style="position:absolute;top:437;left:542"><nobr><span class="ft3"> contains the visible bookmark text, if </span></nobr></DIV> |
| <DIV style="position:absolute;top:459;left:236"><nobr><span class="ft3">applicable.</span></nobr></DIV> |
| <DIV style="position:absolute;top:512;left:236"><nobr><span class="ft5"> The only child element that is allowed inside the </span></nobr></DIV> |
| <DIV style="position:absolute;top:512;left:539"><nobr><span class="ft14">bookmark_value</span></nobr></DIV> |
| <DIV style="position:absolute;top:512;left:652"><nobr><span class="ft5"> is </span></nobr></DIV> |
| <DIV style="position:absolute;top:512;left:673"><nobr><span class="ft14">embedvar</span></nobr></DIV> |
| <DIV style="position:absolute;top:512;left:737"><nobr><span class="ft5"> to allow </span></nobr></DIV> |
| <DIV style="position:absolute;top:532;left:257"><nobr><span class="ft5">embedding of commonly used titles for content nodes or index entries. For examples of using </span></nobr></DIV> |
| <DIV style="position:absolute;top:550;left:257"><nobr><span class="ft5">embedded fragments inside bookmark values, refer to the next sections.</span></nobr></DIV> |
| <DIV style="position:absolute;top:612;left:236"><nobr><span class="ft8"><b>Contents Branch</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:638;left:236"><nobr><span class="ft3">Content entries are displayed on the Content tab page of the help viewer. The </span></nobr></DIV> |
| <DIV style="position:absolute;top:640;left:759"><nobr><span class="ft9">branch </span></nobr></DIV> |
| <DIV style="position:absolute;top:660;left:236"><nobr><span class="ft3">attribute takes the value </span></nobr></DIV> |
| <DIV style="position:absolute;top:662;left:405"><nobr><span class="ft14">contents</span></nobr></DIV> |
| <DIV style="position:absolute;top:660;left:470"><nobr><span class="ft3">. The bookmark value can contain any number of </span></nobr></DIV> |
| <DIV style="position:absolute;top:682;left:236"><nobr><span class="ft3">levels separated by slashes, with the last part of the bookmark value serving as the </span></nobr></DIV> |
| <DIV style="position:absolute;top:704;left:236"><nobr><span class="ft3">entry and the other parts serving as nodes.</span></nobr></DIV> |
| <DIV style="position:absolute;top:757;left:236"><nobr><span class="ft5"> Note that currently the contents branch <i>is not</i> implemented in the help build process.</span></nobr></DIV> |
| <DIV style="position:absolute;top:812;left:236"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:845;left:267"><nobr><span class="ft5"><bookmark branch="contents" </span></nobr></DIV> |
| <DIV style="position:absolute;top:861;left:267"><nobr><span class="ft5">xml-lang="en-US" id="bm1"></span></nobr></DIV> |
| <DIV style="position:absolute;top:895;left:267"><nobr><span class="ft5"> <bookmark_value></span></nobr></DIV> |
| <DIV style="position:absolute;top:912;left:267"><nobr><span class="ft5"> Text Documents/</span></nobr></DIV> |
| <DIV style="position:absolute;top:929;left:267"><nobr><span class="ft5"> Objects in Text Documents/</span></nobr></DIV> |
| <DIV style="position:absolute;top:944;left:267"><nobr><span class="ft5"> Positioning Objects</span></nobr></DIV> |
| <DIV style="position:absolute;top:959;left:267"><nobr><span class="ft5"> </bookmark_value></span></nobr></DIV> |
| <DIV style="position:absolute;top:994;left:267"><nobr><span class="ft5"></bookmark></span></nobr></DIV> |
| <DIV style="position:absolute;top:1024;left:236"><nobr><span class="ft3">A bookmark value can also contain embedded fragments for node titles. This reduces </span></nobr></DIV> |
| <DIV style="position:absolute;top:1045;left:236"><nobr><span class="ft3">redundancy, maintenance effort, and the risk of introducing errors through typos. This </span></nobr></DIV> |
| <DIV style="position:absolute;top:1066;left:236"><nobr><span class="ft3">can be avoided if the top level entries for the content tree are defined separately:</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>25</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 26 --> |
| <a name="26"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c026.png" alt="background image"> |
| <DIV style="position:absolute;top:146;left:224"><nobr><span class="ft5"><variable id="textdocs">Text Documents</variable></span></nobr></DIV> |
| <DIV style="position:absolute;top:163;left:224"><nobr><span class="ft5"><variable id="objtextdocs">Objects in Text Documents</variable></span></nobr></DIV> |
| <DIV style="position:absolute;top:193;left:193"><nobr><span class="ft3">and embedded as text fragments:</span></nobr></DIV> |
| <DIV style="position:absolute;top:239;left:224"><nobr><span class="ft5"><bookmark_value></span></nobr></DIV> |
| <DIV style="position:absolute;top:256;left:224"><nobr><span class="ft5"> <embedvar href="/text/shared/00/variables.xhp#textdocs"/>/</span></nobr></DIV> |
| <DIV style="position:absolute;top:273;left:224"><nobr><span class="ft5"> <embedvar href="/text/shared/00/variables.xhp#objtextdocs"/>/</span></nobr></DIV> |
| <DIV style="position:absolute;top:290;left:224"><nobr><span class="ft5"> ...</span></nobr></DIV> |
| <DIV style="position:absolute;top:307;left:224"><nobr><span class="ft5"></bookmark></span></nobr></DIV> |
| <DIV style="position:absolute;top:350;left:193"><nobr><span class="ft8"><b>Index Branch</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:376;left:193"><nobr><span class="ft3">Index Entries are displayed on the Index tab page of the help viewer. The </span></nobr></DIV> |
| <DIV style="position:absolute;top:378;left:717"><nobr><span class="ft9">branch </span></nobr></DIV> |
| <DIV style="position:absolute;top:398;left:193"><nobr><span class="ft3">attribute takes the value </span></nobr></DIV> |
| <DIV style="position:absolute;top:400;left:378"><nobr><span class="ft14">index</span></nobr></DIV> |
| <DIV style="position:absolute;top:398;left:419"><nobr><span class="ft3"> Currently, index entries can contain <i>two</i> levels </span></nobr></DIV> |
| <DIV style="position:absolute;top:420;left:193"><nobr><span class="ft3">separated by a semicolon.</span></nobr></DIV> |
| <DIV style="position:absolute;top:464;left:193"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:497;left:224"><nobr><span class="ft5"><bookmark branch="index" id="bm1" xml-lang="en-US"></span></nobr></DIV> |
| <DIV style="position:absolute;top:531;left:224"><nobr><span class="ft5"> <bookmark_value></span></nobr></DIV> |
| <DIV style="position:absolute;top:546;left:224"><nobr><span class="ft5"> editor;contour editor</span></nobr></DIV> |
| <DIV style="position:absolute;top:562;left:224"><nobr><span class="ft5"> </bookmark_value></span></nobr></DIV> |
| <DIV style="position:absolute;top:596;left:224"><nobr><span class="ft5"></bookmark></span></nobr></DIV> |
| <DIV style="position:absolute;top:626;left:193"><nobr><span class="ft3">As with content entries, the bookmark values for index entries can contain embedded </span></nobr></DIV> |
| <DIV style="position:absolute;top:647;left:193"><nobr><span class="ft3">text fragments by using the </span></nobr></DIV> |
| <DIV style="position:absolute;top:650;left:388"><nobr><span class="ft9">embedvar</span></nobr></DIV> |
| <DIV style="position:absolute;top:647;left:452"><nobr><span class="ft3"> element, which can be useful if names of UI </span></nobr></DIV> |
| <DIV style="position:absolute;top:670;left:193"><nobr><span class="ft3">elements are used that are subject to change.</span></nobr></DIV> |
| <DIV style="position:absolute;top:721;left:193"><nobr><span class="ft8"><b>"hid" Branch</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:747;left:193"><nobr><span class="ft3">Help IDs are never displayed but instead trigger context-sensitive help inside </span></nobr></DIV> |
| <DIV style="position:absolute;top:768;left:193"><nobr><span class="ft3">OpenOffice.org. The </span></nobr></DIV> |
| <DIV style="position:absolute;top:770;left:334"><nobr><span class="ft14">branch</span></nobr></DIV> |
| <DIV style="position:absolute;top:768;left:383"><nobr><span class="ft3"> attribute takes the value </span></nobr></DIV> |
| <DIV style="position:absolute;top:770;left:552"><nobr><span class="ft14">hid</span></nobr></DIV> |
| <DIV style="position:absolute;top:768;left:576"><nobr><span class="ft3"> and in addition contains the </span></nobr></DIV> |
| <DIV style="position:absolute;top:790;left:193"><nobr><span class="ft3">help ID associated with the bookmark.</span></nobr></DIV> |
| <DIV style="position:absolute;top:836;left:224"><nobr><span class="ft5"><bookmark id="bm_9876" xml-lang="en-US" </span></nobr></DIV> |
| <DIV style="position:absolute;top:852;left:224"><nobr><span class="ft5">branch="<b>hid/HID_SOME_HELP_ID</b>"/></span></nobr></DIV> |
| <DIV style="position:absolute;top:882;left:193"><nobr><span class="ft3">A bookmark for a given help ID can only be used <i>once</i> inside the help files since the </span></nobr></DIV> |
| <DIV style="position:absolute;top:903;left:193"><nobr><span class="ft3">bookmark defines the entry point for the help viewer when context-sensitive help is </span></nobr></DIV> |
| <DIV style="position:absolute;top:924;left:193"><nobr><span class="ft3">triggered from the UI either through the use of the </span></nobr></DIV> |
| <DIV style="position:absolute;top:927;left:527"><nobr><span class="ft12"><b>F1</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:924;left:543"><nobr><span class="ft3"> key or the </span></nobr></DIV> |
| <DIV style="position:absolute;top:927;left:617"><nobr><span class="ft12"><b>Help</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:924;left:649"><nobr><span class="ft3"> button.</span></nobr></DIV> |
| <DIV style="position:absolute;top:964;left:193"><nobr><span class="ft3">There are two types of help IDs currently used in the help files:</span></nobr></DIV> |
| <DIV style="position:absolute;top:1003;left:220"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:1004;left:247"><nobr><span class="ft8"><b>Symbolic names</b>, like </span></nobr></DIV> |
| <DIV style="position:absolute;top:1007;left:401"><nobr><span class="ft14">SID_FM_CONVERTTO_IMAGECONTROL</span></nobr></DIV> |
| <DIV style="position:absolute;top:1004;left:635"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:1036;left:220"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:1038;left:247"><nobr><span class="ft8"><b>UNO command names</b>, like </span></nobr></DIV> |
| <DIV style="position:absolute;top:1040;left:442"><nobr><span class="ft14">.uno:InsertCtrl</span></nobr></DIV> |
| <DIV style="position:absolute;top:1070;left:193"><nobr><span class="ft3">For details on determining the help ID for a UI element, see <i><A href="HelpAuthoring_c.html#98">Determining A Help ID</i></a> on </span></nobr></DIV> |
| <DIV style="position:absolute;top:1091;left:193"><nobr><span class="ft3">page <A href="HelpAuthoring_c.html#98">98</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>26</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 27 --> |
| <a name="27"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| .ft26{font-size:8px;font-family:Times;color:#000000;} |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c027.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:236"><nobr><span class="ft10"><b>Switching Content</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:170;left:236"><nobr><span class="ft3">In some cases it is necessary to distinguish between different platforms or </span></nobr></DIV> |
| <DIV style="position:absolute;top:191;left:236"><nobr><span class="ft3">applications when displaying the help. For example, on one platform a key stroke to </span></nobr></DIV> |
| <DIV style="position:absolute;top:212;left:236"><nobr><span class="ft3">achieve a certain action can differ from the key stroke used on other platforms. To </span></nobr></DIV> |
| <DIV style="position:absolute;top:234;left:236"><nobr><span class="ft3">avoid duplicating large amounts of text and to reduce redundancy, switching elements </span></nobr></DIV> |
| <DIV style="position:absolute;top:255;left:236"><nobr><span class="ft3">are available, which are used to select the correct portion of the content at runtime.</span></nobr></DIV> |
| <DIV style="position:absolute;top:294;left:236"><nobr><span class="ft3">The help content provider sends additional information along with a help request that </span></nobr></DIV> |
| <DIV style="position:absolute;top:315;left:236"><nobr><span class="ft3">states the current platform, language and application context. This information can be </span></nobr></DIV> |
| <DIV style="position:absolute;top:337;left:236"><nobr><span class="ft3">evaluated using the switch constructs to display the corresponding information.</span></nobr></DIV> |
| <DIV style="position:absolute;top:376;left:236"><nobr><span class="ft3">There are two types of content switching:</span></nobr></DIV> |
| <DIV style="position:absolute;top:414;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:416;left:290"><nobr><span class="ft3">Switching complete paragraphs or sections</span></nobr></DIV> |
| <DIV style="position:absolute;top:448;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:449;left:290"><nobr><span class="ft3">Switching text fragments inside paragraphs</span></nobr></DIV> |
| <DIV style="position:absolute;top:481;left:236"><nobr><span class="ft3">Currently, the following values are used for the select attribute of a </span></nobr></DIV> |
| <DIV style="position:absolute;top:483;left:726"><nobr><span class="ft14">switch</span></nobr></DIV> |
| <DIV style="position:absolute;top:481;left:775"><nobr><span class="ft3"> and </span></nobr></DIV> |
| <DIV style="position:absolute;top:506;left:236"><nobr><span class="ft14">switchinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:503;left:333"><nobr><span class="ft3"> element to specify the switching context:</span></nobr></DIV> |
| <DIV style="position:absolute;top:566;left:242"><nobr><span class="ft16"><b>Value</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:566;left:319"><nobr><span class="ft16"><b>Switching context</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:566;left:444"><nobr><span class="ft16"><b>Example/Comment</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:592;left:242"><nobr><span class="ft5">sys</span></nobr></DIV> |
| <DIV style="position:absolute;top:592;left:319"><nobr><span class="ft5">Operating System</span></nobr></DIV> |
| <DIV style="position:absolute;top:592;left:444"><nobr><span class="ft5">Switching content for Unix, Windows, or Mac </span></nobr></DIV> |
| <DIV style="position:absolute;top:606;left:444"><nobr><span class="ft5">platforms.</span></nobr></DIV> |
| <DIV style="position:absolute;top:632;left:242"><nobr><span class="ft5">appl</span></nobr></DIV> |
| <DIV style="position:absolute;top:632;left:319"><nobr><span class="ft5">Application</span></nobr></DIV> |
| <DIV style="position:absolute;top:632;left:444"><nobr><span class="ft5">Switching content for different OpenOffice.org applications (Writer, </span></nobr></DIV> |
| <DIV style="position:absolute;top:645;left:444"><nobr><span class="ft5">Calc,...) in files that are common to multiple applications. </span></nobr></DIV> |
| <DIV style="position:absolute;top:672;left:242"><nobr><span class="ft5">distrib</span></nobr></DIV> |
| <DIV style="position:absolute;top:672;left:319"><nobr><span class="ft5">Distribution[<A href="HelpAuthoring_c.html#27">8</a>]</span></nobr></DIV> |
| <DIV style="position:absolute;top:672;left:444"><nobr><span class="ft5">Switching content for different distributions, like OpenOffice.org </span></nobr></DIV> |
| <DIV style="position:absolute;top:685;left:444"><nobr><span class="ft5">and StarOffice, which contains extra commercial features.</span></nobr></DIV> |
| <DIV style="position:absolute;top:709;left:236"><nobr><span class="ft18"><i>Table 5: Paragraph Switching Contexts</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:746;left:236"><nobr><span class="ft3">The following values are used for the select attribute of a </span></nobr></DIV> |
| <DIV style="position:absolute;top:748;left:654"><nobr><span class="ft14">case</span></nobr></DIV> |
| <DIV style="position:absolute;top:746;left:687"><nobr><span class="ft3"> and </span></nobr></DIV> |
| <DIV style="position:absolute;top:748;left:727"><nobr><span class="ft14">caseinline </span></nobr></DIV> |
| <DIV style="position:absolute;top:768;left:236"><nobr><span class="ft3">element within a given switching context:</span></nobr></DIV> |
| <DIV style="position:absolute;top:830;left:242"><nobr><span class="ft16"><b>Switching Context</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:830;left:480"><nobr><span class="ft16"><b>Values</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:856;left:242"><nobr><span class="ft5">Operating System (sys)</span></nobr></DIV> |
| <DIV style="position:absolute;top:856;left:480"><nobr><span class="ft5">WIN UNIX MAC</span></nobr></DIV> |
| <DIV style="position:absolute;top:883;left:242"><nobr><span class="ft5">Application (appl)</span></nobr></DIV> |
| <DIV style="position:absolute;top:883;left:480"><nobr><span class="ft5">WRITER CALC DRAW IMPRESS MATH BASIC CHART</span></nobr></DIV> |
| <DIV style="position:absolute;top:907;left:236"><nobr><span class="ft18"><i>Table 6: Inline Switching Contexts</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:956;left:236"><nobr><span class="ft8"><b>Switching Complete Paragraphs Or Sections</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:982;left:236"><nobr><span class="ft3">This type is used, for example, if contents of a paragraph differ considerably on </span></nobr></DIV> |
| <DIV style="position:absolute;top:1003;left:236"><nobr><span class="ft3">different platforms or for different applications, or if a certain paragraph or section is </span></nobr></DIV> |
| <DIV style="position:absolute;top:1025;left:236"><nobr><span class="ft3">only applicable to a certain platform or application.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1092;left:128"><nobr><span class="ft19">8</span></nobr></DIV> |
| <DIV style="position:absolute;top:1092;left:149"><nobr><span class="ft19">Note, that this switch is currently <i>not evaluated</i> in the main transformation step, since the help content provider does not provide the </span></nobr></DIV> |
| <DIV style="position:absolute;top:1103;left:149"><nobr><span class="ft19">necessary information. Currently, the main transformation style sheet uses the value of the product name to distinguish between open source </span></nobr></DIV> |
| <DIV style="position:absolute;top:1115;left:149"><nobr><span class="ft19">and commercial distributions, but this is only implemented for StarOffice and OpenOffice.org.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>27</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 28 --> |
| <a name="28"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c028.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:193"><nobr><span class="ft3"> For example, while mounting a CD-ROM drive can be a necessary step on a Unix </span></nobr></DIV> |
| <DIV style="position:absolute;top:157;left:193"><nobr><span class="ft3">system, it is usually not applicable on Windows computers. The </span></nobr></DIV> |
| <DIV style="position:absolute;top:160;left:629"><nobr><span class="ft14">switch</span></nobr></DIV> |
| <DIV style="position:absolute;top:157;left:677"><nobr><span class="ft3"> element can </span></nobr></DIV> |
| <DIV style="position:absolute;top:180;left:193"><nobr><span class="ft3">be used to accomplish this distinction:</span></nobr></DIV> |
| <DIV style="position:absolute;top:226;left:224"><nobr><span class="ft5"><switch select="sys"></span></nobr></DIV> |
| <DIV style="position:absolute;top:243;left:224"><nobr><span class="ft5"> <case select="UNIX"></span></nobr></DIV> |
| <DIV style="position:absolute;top:260;left:224"><nobr><span class="ft5"> <paragraph>Mount the cd rom drive.</paragraph></span></nobr></DIV> |
| <DIV style="position:absolute;top:277;left:224"><nobr><span class="ft5"> </case></span></nobr></DIV> |
| <DIV style="position:absolute;top:294;left:224"><nobr><span class="ft5"></switch></span></nobr></DIV> |
| <DIV style="position:absolute;top:336;left:193"><nobr><span class="ft8"><b>Switching Text Fragments Inside Paragraphs</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:362;left:193"><nobr><span class="ft3">This type is used if only small text fragments differ on different platforms or </span></nobr></DIV> |
| <DIV style="position:absolute;top:384;left:193"><nobr><span class="ft3">applications. A typical case is the use of shortcuts on different systems, or the </span></nobr></DIV> |
| <DIV style="position:absolute;top:405;left:193"><nobr><span class="ft3">notation of file paths on different platforms. </span></nobr></DIV> |
| <DIV style="position:absolute;top:444;left:193"><nobr><span class="ft3">For example, while on Windows the standard installation path for OpenOffice.org </span></nobr></DIV> |
| <DIV style="position:absolute;top:465;left:193"><nobr><span class="ft3">could be something like </span></nobr></DIV> |
| <DIV style="position:absolute;top:467;left:380"><nobr><span class="ft14">C:\Program Files\OpenOffice.org-2.0</span></nobr></DIV> |
| <DIV style="position:absolute;top:465;left:669"><nobr><span class="ft3">, it could be </span></nobr></DIV> |
| <DIV style="position:absolute;top:490;left:193"><nobr><span class="ft14">~/OpenOffice.org-2.0</span></nobr></DIV> |
| <DIV style="position:absolute;top:487;left:355"><nobr><span class="ft3"> on a Unix system, making it necessary to distinguish </span></nobr></DIV> |
| <DIV style="position:absolute;top:510;left:193"><nobr><span class="ft3">between the operating environments when talking about these paths. The </span></nobr></DIV> |
| <DIV style="position:absolute;top:533;left:193"><nobr><span class="ft14">switchinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:531;left:290"><nobr><span class="ft3"> element can be used to accomplish the distinction:</span></nobr></DIV> |
| <DIV style="position:absolute;top:578;left:224"><nobr><span class="ft5"><paragraph>The software will be installed in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:595;left:224"><nobr><span class="ft5"><switchinline select="sys"></span></nobr></DIV> |
| <DIV style="position:absolute;top:612;left:224"><nobr><span class="ft5"> <caseinline select="UNIX"></span></nobr></DIV> |
| <DIV style="position:absolute;top:629;left:224"><nobr><span class="ft5"> ~/OpenOffice.org-2.0</span></nobr></DIV> |
| <DIV style="position:absolute;top:646;left:224"><nobr><span class="ft5"> </caseinline></span></nobr></DIV> |
| <DIV style="position:absolute;top:663;left:224"><nobr><span class="ft5"> <caseinline select="WIN"></span></nobr></DIV> |
| <DIV style="position:absolute;top:680;left:224"><nobr><span class="ft5"> C:\Program Files\OpenOffice.org-2.0</span></nobr></DIV> |
| <DIV style="position:absolute;top:697;left:224"><nobr><span class="ft5"> </caseinline></span></nobr></DIV> |
| <DIV style="position:absolute;top:714;left:224"><nobr><span class="ft5"> <defaultinline></span></nobr></DIV> |
| <DIV style="position:absolute;top:731;left:224"><nobr><span class="ft5"> home</span></nobr></DIV> |
| <DIV style="position:absolute;top:748;left:224"><nobr><span class="ft5"> </defaultinline></span></nobr></DIV> |
| <DIV style="position:absolute;top:765;left:224"><nobr><span class="ft5"></switchinline></span></nobr></DIV> |
| <DIV style="position:absolute;top:782;left:224"><nobr><span class="ft5">directory.</paragraph></span></nobr></DIV> |
| <DIV style="position:absolute;top:812;left:193"><nobr><span class="ft3">In the code example above, there is also a default value defined by using the optional </span></nobr></DIV> |
| <DIV style="position:absolute;top:836;left:193"><nobr><span class="ft14">defaultinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:836;left:298"><nobr><span class="ft9"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:834;left:307"><nobr><span class="ft3">element, which is shown if neither </span></nobr></DIV> |
| <DIV style="position:absolute;top:836;left:536"><nobr><span class="ft9">UNIX</span></nobr></DIV> |
| <DIV style="position:absolute;top:834;left:568"><nobr><span class="ft3"> nor </span></nobr></DIV> |
| <DIV style="position:absolute;top:836;left:598"><nobr><span class="ft9">WIN</span></nobr></DIV> |
| <DIV style="position:absolute;top:834;left:622"><nobr><span class="ft3"> is set as the platform </span></nobr></DIV> |
| <DIV style="position:absolute;top:856;left:193"><nobr><span class="ft3">value when calling the help.</span></nobr></DIV> |
| <DIV style="position:absolute;top:900;left:193"><nobr><span class="ft10"><b>Embedding Content</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:933;left:193"><nobr><span class="ft3">You can also reduce redundant content by defining reusable text fragments and </span></nobr></DIV> |
| <DIV style="position:absolute;top:955;left:193"><nobr><span class="ft3">blocks, which can be referenced from other places. The references are resolved at </span></nobr></DIV> |
| <DIV style="position:absolute;top:976;left:193"><nobr><span class="ft3">runtime when the help is displayed, and are temporarily resolved at compile time </span></nobr></DIV> |
| <DIV style="position:absolute;top:997;left:193"><nobr><span class="ft3">when the full text search index is generated.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1028;left:193"><nobr><span class="ft3">There are two ways of reusing content by means of embedding:</span></nobr></DIV> |
| <DIV style="position:absolute;top:1058;left:220"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:1060;left:247"><nobr><span class="ft3">Embedding complete sections</span></nobr></DIV> |
| <DIV style="position:absolute;top:1091;left:220"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:1093;left:247"><nobr><span class="ft3">Embedding text fragments</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>28</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 29 --> |
| <a name="29"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c029.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:236"><nobr><span class="ft8"><b>Embedding Complete Sections</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:162;left:236"><nobr><span class="ft3">Single or multiple paragraphs can apply to more than one help file. For example, </span></nobr></DIV> |
| <DIV style="position:absolute;top:183;left:236"><nobr><span class="ft3">standard steps inside procedures can be written once and embedded in multiple </span></nobr></DIV> |
| <DIV style="position:absolute;top:205;left:236"><nobr><span class="ft3">places, reducing maintenance and translation effort.</span></nobr></DIV> |
| <DIV style="position:absolute;top:244;left:236"><nobr><span class="ft3">The URL for the reference takes the form </span></nobr></DIV> |
| <DIV style="position:absolute;top:246;left:527"><nobr><span class="ft14">file#id</span></nobr></DIV> |
| <DIV style="position:absolute;top:244;left:584"><nobr><span class="ft3">. If, for instance, the section with </span></nobr></DIV> |
| <DIV style="position:absolute;top:266;left:236"><nobr><span class="ft3">the ID </span></nobr></DIV> |
| <DIV style="position:absolute;top:268;left:281"><nobr><span class="ft14">12345</span></nobr></DIV> |
| <DIV style="position:absolute;top:266;left:321"><nobr><span class="ft3"> from the file </span></nobr></DIV> |
| <DIV style="position:absolute;top:268;left:411"><nobr><span class="ft14">text/writer/01/012345.xhp</span></nobr></DIV> |
| <DIV style="position:absolute;top:266;left:613"><nobr><span class="ft3"> is to be embedded, the URL </span></nobr></DIV> |
| <DIV style="position:absolute;top:288;left:236"><nobr><span class="ft3">would be </span></nobr></DIV> |
| <DIV style="position:absolute;top:290;left:300"><nobr><span class="ft14">text/swriter/01/012345.xhp#12345</span></nobr></DIV> |
| <DIV style="position:absolute;top:288;left:560"><nobr><span class="ft3">. The file name refers to the path and </span></nobr></DIV> |
| <DIV style="position:absolute;top:310;left:236"><nobr><span class="ft3">name that is stored in the jar files.</span></nobr></DIV> |
| <DIV style="position:absolute;top:349;left:236"><nobr><span class="ft3">Complete sections can be embedded using the </span></nobr></DIV> |
| <DIV style="position:absolute;top:351;left:572"><nobr><span class="ft14">embed</span></nobr></DIV> |
| <DIV style="position:absolute;top:349;left:613"><nobr><span class="ft3"> element. The section to be </span></nobr></DIV> |
| <DIV style="position:absolute;top:371;left:236"><nobr><span class="ft3">embedded is referenced using the attribute </span></nobr></DIV> |
| <DIV style="position:absolute;top:374;left:525"><nobr><span class="ft14">ID</span></nobr></DIV> |
| <DIV style="position:absolute;top:371;left:541"><nobr><span class="ft3">, which must be unique within the file.</span></nobr></DIV> |
| <DIV style="position:absolute;top:411;left:236"><nobr><span class="ft3">If, for example, multiple processes described in the help involve logging on to a </span></nobr></DIV> |
| <DIV style="position:absolute;top:433;left:236"><nobr><span class="ft3">computer, this particular step can be written once and embedded wherever required:</span></nobr></DIV> |
| <DIV style="position:absolute;top:476;left:236"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:502;left:236"><nobr><span class="ft3">Original location (filename: </span></nobr></DIV> |
| <DIV style="position:absolute;top:504;left:417"><nobr><span class="ft14">original.xhp</span></nobr></DIV> |
| <DIV style="position:absolute;top:502;left:515"><nobr><span class="ft3">):</span></nobr></DIV> |
| <DIV style="position:absolute;top:549;left:267"><nobr><span class="ft5"><section id="logon"></span></nobr></DIV> |
| <DIV style="position:absolute;top:566;left:267"><nobr><span class="ft5"> <paragraph id="par_id12345" role="paragraph" xml-lang="en-US"></span></nobr></DIV> |
| <DIV style="position:absolute;top:583;left:267"><nobr><span class="ft5"> Log on to your computer using your user name and password.</span></nobr></DIV> |
| <DIV style="position:absolute;top:600;left:267"><nobr><span class="ft5"> </paragraph></span></nobr></DIV> |
| <DIV style="position:absolute;top:617;left:267"><nobr><span class="ft5"></section></span></nobr></DIV> |
| <DIV style="position:absolute;top:647;left:236"><nobr><span class="ft3">Referenced location:</span></nobr></DIV> |
| <DIV style="position:absolute;top:693;left:267"><nobr><span class="ft5"><paragraph id="par_id9876" role="heading" level="1" xml-lang="en-US"></span></nobr></DIV> |
| <DIV style="position:absolute;top:710;left:267"><nobr><span class="ft5"> Starting %PRODUCTNAME</span></nobr></DIV> |
| <DIV style="position:absolute;top:727;left:267"><nobr><span class="ft5"></paragraph></span></nobr></DIV> |
| <DIV style="position:absolute;top:744;left:267"><nobr><span class="ft5"><list></span></nobr></DIV> |
| <DIV style="position:absolute;top:761;left:267"><nobr><span class="ft5"> <listitem><embed href="original.xhp#logon"/></listitem></span></nobr></DIV> |
| <DIV style="position:absolute;top:778;left:267"><nobr><span class="ft5"> <listitem></span></nobr></DIV> |
| <DIV style="position:absolute;top:795;left:267"><nobr><span class="ft5"> <paragraph id="par_id9877" role="paragraph" xml-lang="en-US"></span></nobr></DIV> |
| <DIV style="position:absolute;top:812;left:267"><nobr><span class="ft5"> Start %PRODUCTNAME</paragraph></span></nobr></DIV> |
| <DIV style="position:absolute;top:829;left:267"><nobr><span class="ft5"> </listitem></span></nobr></DIV> |
| <DIV style="position:absolute;top:846;left:267"><nobr><span class="ft5"></list></span></nobr></DIV> |
| <DIV style="position:absolute;top:876;left:236"><nobr><span class="ft3">This results in the following:</span></nobr></DIV> |
| <DIV style="position:absolute;top:922;left:267"><nobr><span class="ft4"><b>Starting OpenOffice.org</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:939;left:267"><nobr><span class="ft5">1. Log on to your computer using your user name and your password.</span></nobr></DIV> |
| <DIV style="position:absolute;top:956;left:267"><nobr><span class="ft5">2. Start OpenOffice.org</span></nobr></DIV> |
| <DIV style="position:absolute;top:999;left:236"><nobr><span class="ft8"><b>Embedding Text Fragments</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1025;left:236"><nobr><span class="ft3">Text fragments can, for example, represent commonly used phrases or names of UI </span></nobr></DIV> |
| <DIV style="position:absolute;top:1046;left:236"><nobr><span class="ft3">elements. These can be specified once and used in multiple places, reducing </span></nobr></DIV> |
| <DIV style="position:absolute;top:1068;left:236"><nobr><span class="ft3">maintenance and localization effort. </span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>29</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 30 --> |
| <a name="30"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c030.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:193"><nobr><span class="ft3">The URL for the reference takes the form </span></nobr></DIV> |
| <DIV style="position:absolute;top:138;left:474"><nobr><span class="ft14">file#id</span></nobr></DIV> |
| <DIV style="position:absolute;top:136;left:531"><nobr><span class="ft3">. If, for instance, the </span></nobr></DIV> |
| <DIV style="position:absolute;top:138;left:669"><nobr><span class="ft14">variable</span></nobr></DIV> |
| <DIV style="position:absolute;top:136;left:734"><nobr><span class="ft3"> with </span></nobr></DIV> |
| <DIV style="position:absolute;top:158;left:193"><nobr><span class="ft3">the ID </span></nobr></DIV> |
| <DIV style="position:absolute;top:161;left:243"><nobr><span class="ft9">12345</span></nobr></DIV> |
| <DIV style="position:absolute;top:158;left:284"><nobr><span class="ft3"> from the file </span></nobr></DIV> |
| <DIV style="position:absolute;top:161;left:383"><nobr><span class="ft14">text/swriter/01/012345.xhp</span></nobr></DIV> |
| <DIV style="position:absolute;top:158;left:593"><nobr><span class="ft3"> is to be embedded, the </span></nobr></DIV> |
| <DIV style="position:absolute;top:181;left:193"><nobr><span class="ft3">URL would be </span></nobr></DIV> |
| <DIV style="position:absolute;top:183;left:293"><nobr><span class="ft14">text/writer/01/012345.xhp#12345</span></nobr></DIV> |
| <DIV style="position:absolute;top:181;left:544"><nobr><span class="ft3">. The file name refers to the path </span></nobr></DIV> |
| <DIV style="position:absolute;top:203;left:193"><nobr><span class="ft3">+ name that is stored in the jar files.</span></nobr></DIV> |
| <DIV style="position:absolute;top:242;left:193"><nobr><span class="ft3">These fragments can be embedded using the </span></nobr></DIV> |
| <DIV style="position:absolute;top:244;left:500"><nobr><span class="ft14">embedvar</span></nobr></DIV> |
| <DIV style="position:absolute;top:242;left:565"><nobr><span class="ft3"> element if they are previously </span></nobr></DIV> |
| <DIV style="position:absolute;top:264;left:193"><nobr><span class="ft3">defined as being </span></nobr></DIV> |
| <DIV style="position:absolute;top:266;left:310"><nobr><span class="ft9">variable</span></nobr></DIV> |
| <DIV style="position:absolute;top:264;left:375"><nobr><span class="ft3">s, so that they can be referenced. The text fragment to be </span></nobr></DIV> |
| <DIV style="position:absolute;top:286;left:193"><nobr><span class="ft3">embedded is placed inside a </span></nobr></DIV> |
| <DIV style="position:absolute;top:288;left:394"><nobr><span class="ft9">variable</span></nobr></DIV> |
| <DIV style="position:absolute;top:286;left:459"><nobr><span class="ft3"> element and assigned a unique ID using the </span></nobr></DIV> |
| <DIV style="position:absolute;top:308;left:193"><nobr><span class="ft3">element's </span></nobr></DIV> |
| <DIV style="position:absolute;top:311;left:261"><nobr><span class="ft9">id</span></nobr></DIV> |
| <DIV style="position:absolute;top:308;left:277"><nobr><span class="ft3"> attribute:</span></nobr></DIV> |
| <DIV style="position:absolute;top:348;left:193"><nobr><span class="ft3">Original location (filename: </span></nobr></DIV> |
| <DIV style="position:absolute;top:350;left:375"><nobr><span class="ft14">original.xhp</span></nobr></DIV> |
| <DIV style="position:absolute;top:348;left:472"><nobr><span class="ft3">):</span></nobr></DIV> |
| <DIV style="position:absolute;top:395;left:224"><nobr><span class="ft5"><paragraph id="par_id1234">Press the <variable id="btn_prnprev"><item </span></nobr></DIV> |
| <DIV style="position:absolute;top:410;left:224"><nobr><span class="ft5">type="button">Print Preview</item></variable> button.</paragraph></span></nobr></DIV> |
| <DIV style="position:absolute;top:440;left:193"><nobr><span class="ft3">The fragment can then be referenced in other locations using the embedvar element:</span></nobr></DIV> |
| <DIV style="position:absolute;top:479;left:193"><nobr><span class="ft3">Referenced location:</span></nobr></DIV> |
| <DIV style="position:absolute;top:525;left:224"><nobr><span class="ft5"><paragraph id="par_id9876">A preview can be shown using the <embedvar </span></nobr></DIV> |
| <DIV style="position:absolute;top:540;left:224"><nobr><span class="ft5">href="original.xhp#btn_prnprev"/> button.</span></nobr></DIV> |
| <DIV style="position:absolute;top:571;left:193"><nobr><span class="ft3">Result:</span></nobr></DIV> |
| <DIV style="position:absolute;top:616;left:224"><nobr><span class="ft5">A preview can be shown using the <b>Print Preview</b> button.</span></nobr></DIV> |
| <DIV style="position:absolute;top:647;left:193"><nobr><span class="ft3">If, for example, the name of the button changes from "Print Preview" to "Show </span></nobr></DIV> |
| <DIV style="position:absolute;top:668;left:193"><nobr><span class="ft3">Preview" you only need to update one location to make the change available in all </span></nobr></DIV> |
| <DIV style="position:absolute;top:689;left:193"><nobr><span class="ft3">referenced locations.</span></nobr></DIV> |
| <DIV style="position:absolute;top:728;left:193"><nobr><span class="ft3">You can also embed the content of paragraphs by referring to the <b>paragraph ID</b>. Note </span></nobr></DIV> |
| <DIV style="position:absolute;top:749;left:193"><nobr><span class="ft3">that only the contents of the paragraph are embedded. The paragraph formatting </span></nobr></DIV> |
| <DIV style="position:absolute;top:771;left:193"><nobr><span class="ft3">information is disregarded:</span></nobr></DIV> |
| <DIV style="position:absolute;top:810;left:193"><nobr><span class="ft3">Referenced location</span></nobr></DIV> |
| <DIV style="position:absolute;top:856;left:224"><nobr><span class="ft5"><paragraph id="par_id433122"><embedvar </span></nobr></DIV> |
| <DIV style="position:absolute;top:871;left:224"><nobr><span class="ft5">id="referenced.xhp#par_id9876"/></span></nobr></DIV> |
| <DIV style="position:absolute;top:901;left:193"><nobr><span class="ft3">Result:</span></nobr></DIV> |
| <DIV style="position:absolute;top:947;left:224"><nobr><span class="ft5">A preview can be shown using the <b>Print Preview</b> button.</span></nobr></DIV> |
| <DIV style="position:absolute;top:987;left:193"><nobr><span class="ft10"><b>Images and Icons</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1020;left:193"><nobr><span class="ft3">All images must be placed inside </span></nobr></DIV> |
| <DIV style="position:absolute;top:1022;left:459"><nobr><span class="ft14">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:1020;left:532"><nobr><span class="ft3">s. The </span></nobr></DIV> |
| <DIV style="position:absolute;top:1022;left:593"><nobr><span class="ft14">image</span></nobr></DIV> |
| <DIV style="position:absolute;top:1020;left:633"><nobr><span class="ft3"> element contains </span></nobr></DIV> |
| <DIV style="position:absolute;top:1042;left:193"><nobr><span class="ft3">information about the image source in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:1045;left:498"><nobr><span class="ft14">src</span></nobr></DIV> |
| <DIV style="position:absolute;top:1042;left:523"><nobr><span class="ft3"> element and must be assigned a </span></nobr></DIV> |
| <DIV style="position:absolute;top:1064;left:193"><nobr><span class="ft3">unique </span></nobr></DIV> |
| <DIV style="position:absolute;top:1066;left:242"><nobr><span class="ft14">ID</span></nobr></DIV> |
| <DIV style="position:absolute;top:1064;left:259"><nobr><span class="ft3">. Every </span></nobr></DIV> |
| <DIV style="position:absolute;top:1067;left:310"><nobr><span class="ft14">image</span></nobr></DIV> |
| <DIV style="position:absolute;top:1064;left:350"><nobr><span class="ft3"> element must also contain a child element </span></nobr></DIV> |
| <DIV style="position:absolute;top:1067;left:639"><nobr><span class="ft14">alt</span></nobr></DIV> |
| <DIV style="position:absolute;top:1064;left:663"><nobr><span class="ft3"> that contains a </span></nobr></DIV> |
| <DIV style="position:absolute;top:1087;left:193"><nobr><span class="ft3">short description of the image used if the visual content is not displayed or cannot be </span></nobr></DIV> |
| <DIV style="position:absolute;top:1108;left:193"><nobr><span class="ft3">accessed by visually impaired users.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>30</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 31 --> |
| <a name="31"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c031.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:236"><nobr><span class="ft3">In addition to the </span></nobr></DIV> |
| <DIV style="position:absolute;top:138;left:351"><nobr><span class="ft14">alt</span></nobr></DIV> |
| <DIV style="position:absolute;top:136;left:375"><nobr><span class="ft3"> element, there is also an optional </span></nobr></DIV> |
| <DIV style="position:absolute;top:138;left:604"><nobr><span class="ft14">caption</span></nobr></DIV> |
| <DIV style="position:absolute;top:136;left:660"><nobr><span class="ft3"> element that can take </span></nobr></DIV> |
| <DIV style="position:absolute;top:158;left:236"><nobr><span class="ft3">a long description as an image caption.</span></nobr></DIV> |
| <DIV style="position:absolute;top:197;left:236"><nobr><span class="ft3">Starting with OpenOffice.org 2.0, the help retrieves all images from the central image </span></nobr></DIV> |
| <DIV style="position:absolute;top:218;left:236"><nobr><span class="ft3">repository </span></nobr></DIV> |
| <DIV style="position:absolute;top:221;left:310"><nobr><span class="ft14">images.zip,</span></nobr></DIV> |
| <DIV style="position:absolute;top:218;left:399"><nobr><span class="ft3"> which is available in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:221;left:593"><nobr><span class="ft14">share/config</span></nobr></DIV> |
| <DIV style="position:absolute;top:218;left:691"><nobr><span class="ft3"> directory of the </span></nobr></DIV> |
| <DIV style="position:absolute;top:241;left:236"><nobr><span class="ft3">OpenOffice.org installation. This archive contains all images that OpenOffice.org </span></nobr></DIV> |
| <DIV style="position:absolute;top:262;left:236"><nobr><span class="ft3">uses, separated by modules. The OpenOffice.org Help fetches any icons displayed in </span></nobr></DIV> |
| <DIV style="position:absolute;top:283;left:236"><nobr><span class="ft3">the help files from here. Since this also is the place where the application fetched the </span></nobr></DIV> |
| <DIV style="position:absolute;top:305;left:236"><nobr><span class="ft3">icons to display in the user interface, the icons in the help will always be in sync with </span></nobr></DIV> |
| <DIV style="position:absolute;top:326;left:236"><nobr><span class="ft3">the application, even if the </span></nobr></DIV> |
| <DIV style="position:absolute;top:329;left:414"><nobr><span class="ft14">images.zip</span></nobr></DIV> |
| <DIV style="position:absolute;top:326;left:495"><nobr><span class="ft3"> archive contains a customized set of images.</span></nobr></DIV> |
| <DIV style="position:absolute;top:366;left:236"><nobr><span class="ft3">The help itself also has a subdirectory inside the </span></nobr></DIV> |
| <DIV style="position:absolute;top:368;left:564"><nobr><span class="ft14">images.zip</span></nobr></DIV> |
| <DIV style="position:absolute;top:366;left:645"><nobr><span class="ft3"> archive that contains all </span></nobr></DIV> |
| <DIV style="position:absolute;top:388;left:236"><nobr><span class="ft3">images that are specific to the help and only used by it, for instance screen captures. </span></nobr></DIV> |
| <DIV style="position:absolute;top:410;left:236"><nobr><span class="ft3">These images are stored under </span></nobr></DIV> |
| <DIV style="position:absolute;top:412;left:448"><nobr><span class="ft14">res/helpimg</span></nobr></DIV> |
| <DIV style="position:absolute;top:410;left:537"><nobr><span class="ft3"> in the archive.</span></nobr></DIV> |
| <DIV style="position:absolute;top:461;left:236"><nobr><span class="ft10"><b>Localization Information</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:494;left:236"><nobr><span class="ft3">Content that is to be localized is found inside elements with the </span></nobr></DIV> |
| <DIV style="position:absolute;top:497;left:683"><nobr><span class="ft14">xml-lang</span></nobr></DIV> |
| <DIV style="position:absolute;top:494;left:747"><nobr><span class="ft3"> attribute </span></nobr></DIV> |
| <DIV style="position:absolute;top:517;left:236"><nobr><span class="ft3">that contains the elements language code. Elements can be excluded from </span></nobr></DIV> |
| <DIV style="position:absolute;top:538;left:236"><nobr><span class="ft3">localization by specifying the </span></nobr></DIV> |
| <DIV style="position:absolute;top:540;left:441"><nobr><span class="ft14">localize</span></nobr></DIV> |
| <DIV style="position:absolute;top:538;left:506"><nobr><span class="ft3"> attribute and setting it to </span></nobr></DIV> |
| <DIV style="position:absolute;top:540;left:692"><nobr><span class="ft14">false</span></nobr></DIV> |
| <DIV style="position:absolute;top:538;left:732"><nobr><span class="ft3">. Any such </span></nobr></DIV> |
| <DIV style="position:absolute;top:560;left:236"><nobr><span class="ft3">element <i>and all of its child elements</i> will be excluded from the localization process.</span></nobr></DIV> |
| <DIV style="position:absolute;top:613;left:236"><nobr><span class="ft5"> Note that the help does <i>not</i> as yet support the pseudo-language </span></nobr></DIV> |
| <DIV style="position:absolute;top:613;left:609"><nobr><span class="ft14">x-comment</span></nobr></DIV> |
| <DIV style="position:absolute;top:613;left:682"><nobr><span class="ft5"> as value for </span></nobr></DIV> |
| <DIV style="position:absolute;top:613;left:754"><nobr><span class="ft14">xml-</span></nobr></DIV> |
| <DIV style="position:absolute;top:633;left:257"><nobr><span class="ft14">lang</span></nobr></DIV> |
| <DIV style="position:absolute;top:633;left:289"><nobr><span class="ft5"> to designate comments.</span></nobr></DIV> |
| <DIV style="position:absolute;top:685;left:236"><nobr><span class="ft3">All paragraphs contain an </span></nobr></DIV> |
| <DIV style="position:absolute;top:687;left:423"><nobr><span class="ft9">l10n</span></nobr></DIV> |
| <DIV style="position:absolute;top:685;left:455"><nobr><span class="ft3"> attribute, which is used to specify the localization </span></nobr></DIV> |
| <DIV style="position:absolute;top:707;left:236"><nobr><span class="ft3">status of the paragraph. This attribute was only used in the migration phase and is not </span></nobr></DIV> |
| <DIV style="position:absolute;top:728;left:236"><nobr><span class="ft3">evaluated. It can be used to store a paragraph authoring status to implement basic </span></nobr></DIV> |
| <DIV style="position:absolute;top:749;left:236"><nobr><span class="ft3">content management functionality.</span></nobr></DIV> |
| <DIV style="position:absolute;top:802;left:236"><nobr><span class="ft10"><b>Auxiliary Files</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:835;left:236"><nobr><span class="ft3">Some auxiliary files are necessary, apart from the help files </span></nobr></DIV> |
| <DIV style="position:absolute;top:838;left:650"><nobr><span class="ft14">*.xhp</span></nobr></DIV> |
| <DIV style="position:absolute;top:835;left:691"><nobr><span class="ft3"> to build the help </span></nobr></DIV> |
| <DIV style="position:absolute;top:858;left:236"><nobr><span class="ft3">set. These are found in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:860;left:452"><nobr><span class="ft14">source/auxiliary</span></nobr></DIV> |
| <DIV style="position:absolute;top:858;left:581"><nobr><span class="ft3"> directory of the </span></nobr></DIV> |
| <DIV style="position:absolute;top:860;left:711"><nobr><span class="ft14">helpcontent2 </span></nobr></DIV> |
| <DIV style="position:absolute;top:880;left:236"><nobr><span class="ft3">module. Some of them are just used for building the help, and some are included in </span></nobr></DIV> |
| <DIV style="position:absolute;top:901;left:236"><nobr><span class="ft3">the helpset.</span></nobr></DIV> |
| <DIV style="position:absolute;top:952;left:236"><nobr><span class="ft8"><b>Files Used For Building The Help</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:979;left:236"><nobr><span class="ft3">Apart from the makefile for this directory </span></nobr></DIV> |
| <DIV style="position:absolute;top:981;left:521"><nobr><span class="ft14">makefile.mk</span></nobr></DIV> |
| <DIV style="position:absolute;top:979;left:610"><nobr><span class="ft3">, there are a number of XSL </span></nobr></DIV> |
| <DIV style="position:absolute;top:1001;left:236"><nobr><span class="ft3">stylesheets used for help compilation:</span></nobr></DIV> |
| <DIV style="position:absolute;top:1040;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:1043;left:290"><nobr><span class="ft14">default.xsl</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>31</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 32 --> |
| <a name="32"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c032.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:220"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:140;left:247"><nobr><span class="ft14">embed.xsl</span></nobr></DIV> |
| <DIV style="position:absolute;top:137;left:320"><nobr><span class="ft3"> is used for resolving embedded sections in help files during </span></nobr></DIV> |
| <DIV style="position:absolute;top:160;left:247"><nobr><span class="ft3">compile time to correctly process embedded sections when creating keyword </span></nobr></DIV> |
| <DIV style="position:absolute;top:182;left:247"><nobr><span class="ft3">and fulltext search index</span></nobr></DIV> |
| <DIV style="position:absolute;top:212;left:220"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:216;left:247"><nobr><span class="ft14">index.xsl</span></nobr></DIV> |
| <DIV style="position:absolute;top:214;left:320"><nobr><span class="ft3"> is used by the corresponding JAVA routine for creating the full text </span></nobr></DIV> |
| <DIV style="position:absolute;top:237;left:247"><nobr><span class="ft3">search index</span></nobr></DIV> |
| <DIV style="position:absolute;top:279;left:193"><nobr><span class="ft8"><b>Main Transformation Stylesheet</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:305;left:193"><nobr><span class="ft3">The main transformation stylesheet </span></nobr></DIV> |
| <DIV style="position:absolute;top:308;left:477"><nobr><span class="ft14">main_transform.xsl</span></nobr></DIV> |
| <DIV style="position:absolute;top:305;left:622"><nobr><span class="ft3"> controls the last </span></nobr></DIV> |
| <DIV style="position:absolute;top:328;left:193"><nobr><span class="ft3">transformation step of the XML files to HTML before they are displayed in the help </span></nobr></DIV> |
| <DIV style="position:absolute;top:349;left:193"><nobr><span class="ft3">viewer. The file contains instructions on how to transform elements of the XML files to </span></nobr></DIV> |
| <DIV style="position:absolute;top:370;left:193"><nobr><span class="ft3">HTML elements to be displayed. It also takes care of some formatting issues, and is </span></nobr></DIV> |
| <DIV style="position:absolute;top:392;left:193"><nobr><span class="ft3">responsible for replacing variables used in the help files.</span></nobr></DIV> |
| <DIV style="position:absolute;top:430;left:193"><nobr><span class="ft3">The help content provider passes some parameters to the stylesheet that are used for </span></nobr></DIV> |
| <DIV style="position:absolute;top:452;left:193"><nobr><span class="ft3">file processing:</span></nobr></DIV> |
| <DIV style="position:absolute;top:491;left:220"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:494;left:247"><nobr><span class="ft14">Database</span></nobr></DIV> |
| <DIV style="position:absolute;top:492;left:312"><nobr><span class="ft3"> this parameter identifies the help module context (see also <i><A href="HelpAuthoring_c.html#13">Help</i></a></span></nobr></DIV> |
| <DIV style="position:absolute;top:515;left:247"><nobr><span class="ft13"><A href="HelpAuthoring_c.html#13"><i>Modules and Help Sections</i> </a>on page <A href="HelpAuthoring_c.html#13">13</a> ). It can have one of the values </span></nobr></DIV> |
| <DIV style="position:absolute;top:539;left:247"><nobr><span class="ft14">swriter</span></nobr></DIV> |
| <DIV style="position:absolute;top:536;left:304"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:539;left:316"><nobr><span class="ft14">scalc</span></nobr></DIV> |
| <DIV style="position:absolute;top:536;left:357"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:539;left:369"><nobr><span class="ft14">sdraw</span></nobr></DIV> |
| <DIV style="position:absolute;top:536;left:410"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:539;left:422"><nobr><span class="ft14">simpress</span></nobr></DIV> |
| <DIV style="position:absolute;top:536;left:487"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:539;left:499"><nobr><span class="ft14">schart</span></nobr></DIV> |
| <DIV style="position:absolute;top:536;left:548"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:539;left:560"><nobr><span class="ft14">sbasic</span></nobr></DIV> |
| <DIV style="position:absolute;top:536;left:609"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:539;left:621"><nobr><span class="ft14">smath</span></nobr></DIV> |
| <DIV style="position:absolute;top:536;left:662"><nobr><span class="ft3">. This value is </span></nobr></DIV> |
| <DIV style="position:absolute;top:559;left:247"><nobr><span class="ft3">used to evaluate <i>application switches</i> (see<A href="HelpAuthoring_c.html#27"> <i>Switching Content</i></a> on page <A href="HelpAuthoring_c.html#27">27</a>).</span></nobr></DIV> |
| <DIV style="position:absolute;top:589;left:220"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:593;left:247"><nobr><span class="ft14">System</span></nobr></DIV> |
| <DIV style="position:absolute;top:590;left:296"><nobr><span class="ft3"> this parameter identifies the operating system/platform. This value is </span></nobr></DIV> |
| <DIV style="position:absolute;top:613;left:247"><nobr><span class="ft3">used to evaluate <i>system switches</i> (see<A href="HelpAuthoring_c.html#27"> <i>Switching Content</i> </a>on page<A href="HelpAuthoring_c.html#27"> 27</a>).</span></nobr></DIV> |
| <DIV style="position:absolute;top:644;left:220"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:648;left:247"><nobr><span class="ft14">productname</span></nobr></DIV> |
| <DIV style="position:absolute;top:645;left:336"><nobr><span class="ft3"> and </span></nobr></DIV> |
| <DIV style="position:absolute;top:648;left:370"><nobr><span class="ft14">productversion</span></nobr></DIV> |
| <DIV style="position:absolute;top:645;left:483"><nobr><span class="ft3"> these parameters contain the name and </span></nobr></DIV> |
| <DIV style="position:absolute;top:668;left:247"><nobr><span class="ft3">version string of the product (e.g. "OpenOffice.org" "2.0", or "StarOffice" "8"). </span></nobr></DIV> |
| <DIV style="position:absolute;top:690;left:247"><nobr><span class="ft3">These are used to replace the variables </span></nobr></DIV> |
| <DIV style="position:absolute;top:692;left:624"><nobr><span class="ft14">%PRODUCTNAME</span></nobr></DIV> |
| <DIV style="position:absolute;top:690;left:721"><nobr><span class="ft3"> and </span></nobr></DIV> |
| <DIV style="position:absolute;top:714;left:247"><nobr><span class="ft14">%PRODUCTVERSION</span></nobr></DIV> |
| <DIV style="position:absolute;top:712;left:369"><nobr><span class="ft3"> in the help content (see <i><A href="HelpAuthoring_c.html#23">Using Variables</i> </a>on page<A href="HelpAuthoring_c.html#23"> 23</a>).</span></nobr></DIV> |
| <DIV style="position:absolute;top:743;left:220"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:747;left:247"><nobr><span class="ft14">imgrepos</span></nobr></DIV> |
| <DIV style="position:absolute;top:745;left:312"><nobr><span class="ft3"> this parameter contains the physical path to the image repository </span></nobr></DIV> |
| <DIV style="position:absolute;top:770;left:247"><nobr><span class="ft14">images.zip</span></nobr></DIV> |
| <DIV style="position:absolute;top:767;left:328"><nobr><span class="ft3"> used for requesting the images in the help files.</span></nobr></DIV> |
| <DIV style="position:absolute;top:799;left:220"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:803;left:247"><nobr><span class="ft14">Id</span></nobr></DIV> |
| <DIV style="position:absolute;top:800;left:263"><nobr><span class="ft3"> this parameter contains the help ID called. It is displayed in the error </span></nobr></DIV> |
| <DIV style="position:absolute;top:823;left:247"><nobr><span class="ft3">message when the corresponding help file cannot be found.</span></nobr></DIV> |
| <DIV style="position:absolute;top:853;left:220"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:857;left:247"><nobr><span class="ft14">Language</span></nobr></DIV> |
| <DIV style="position:absolute;top:855;left:312"><nobr><span class="ft3"> this parameter contains the current locale of the program.</span></nobr></DIV> |
| <DIV style="position:absolute;top:899;left:193"><nobr><span class="ft8"><b>Contents Definition Files *.tree</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:925;left:193"><nobr><span class="ft3">A number of *.tree files contain the information used to display the table of contents </span></nobr></DIV> |
| <DIV style="position:absolute;top:947;left:193"><nobr><span class="ft3">on the contents tab of the help viewer. These are XML files based on the following </span></nobr></DIV> |
| <DIV style="position:absolute;top:968;left:193"><nobr><span class="ft3">simple DTD:</span></nobr></DIV> |
| <DIV style="position:absolute;top:1013;left:225"><nobr><span class="ft23"><!ELEMENT tree_view (help_section)+></span></nobr></DIV> |
| <DIV style="position:absolute;top:1026;left:225"><nobr><span class="ft23"><!ATTLIST tree_view</span></nobr></DIV> |
| <DIV style="position:absolute;top:1040;left:225"><nobr><span class="ft23"> version CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1054;left:225"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:1081;left:225"><nobr><span class="ft23"><!ELEMENT help_section (node|topic)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:1094;left:225"><nobr><span class="ft23"><!ATTLIST help_section</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>32</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 33 --> |
| <a name="33"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c033.png" alt="background image"> |
| <DIV style="position:absolute;top:147;left:310"><nobr><span class="ft23">application CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:160;left:310"><nobr><span class="ft23">id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:174;left:310"><nobr><span class="ft23">title CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:187;left:268"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:215;left:268"><nobr><span class="ft23"><!ELEMENT node (topic)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:228;left:268"><nobr><span class="ft23"><!ATTLIST node</span></nobr></DIV> |
| <DIV style="position:absolute;top:242;left:310"><nobr><span class="ft23">id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:255;left:310"><nobr><span class="ft23">title CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:269;left:268"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:296;left:268"><nobr><span class="ft23"><!ELEMENT topic (#PCDATA)></span></nobr></DIV> |
| <DIV style="position:absolute;top:310;left:268"><nobr><span class="ft23"><!ATTLIST topic</span></nobr></DIV> |
| <DIV style="position:absolute;top:323;left:310"><nobr><span class="ft23">id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:337;left:268"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:366;left:236"><nobr><span class="ft3">The main element </span></nobr></DIV> |
| <DIV style="position:absolute;top:368;left:362"><nobr><span class="ft14">tree_view</span></nobr></DIV> |
| <DIV style="position:absolute;top:366;left:435"><nobr><span class="ft3"> encapsulates one or more </span></nobr></DIV> |
| <DIV style="position:absolute;top:368;left:620"><nobr><span class="ft14">help_section</span></nobr></DIV> |
| <DIV style="position:absolute;top:366;left:717"><nobr><span class="ft3">s that contain </span></nobr></DIV> |
| <DIV style="position:absolute;top:388;left:236"><nobr><span class="ft3">one or more </span></nobr></DIV> |
| <DIV style="position:absolute;top:390;left:346"><nobr><span class="ft14">node</span></nobr></DIV> |
| <DIV style="position:absolute;top:388;left:378"><nobr><span class="ft3">s with one or more </span></nobr></DIV> |
| <DIV style="position:absolute;top:390;left:548"><nobr><span class="ft14">topic</span></nobr></DIV> |
| <DIV style="position:absolute;top:388;left:588"><nobr><span class="ft3">s (or further </span></nobr></DIV> |
| <DIV style="position:absolute;top:389;left:695"><nobr><span class="ft9">sub</span></nobr></DIV> |
| <DIV style="position:absolute;top:389;left:720"><nobr><span class="ft14">node</span></nobr></DIV> |
| <DIV style="position:absolute;top:389;left:752"><nobr><span class="ft9">s</span></nobr></DIV> |
| <DIV style="position:absolute;top:388;left:760"><nobr><span class="ft3">). The </span></nobr></DIV> |
| <DIV style="position:absolute;top:413;left:236"><nobr><span class="ft14">help_section</span></nobr></DIV> |
| <DIV style="position:absolute;top:410;left:333"><nobr><span class="ft3">s are the top-most element in the table of contents as displayed by the </span></nobr></DIV> |
| <DIV style="position:absolute;top:433;left:236"><nobr><span class="ft3">help viewer. Below that, there are nodes, represented by "book" icons in the help </span></nobr></DIV> |
| <DIV style="position:absolute;top:454;left:236"><nobr><span class="ft3">viewer and, finally, topics that can be selected. A node can have sub-nodes.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>33</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 34 --> |
| <a name="34"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c034.png" alt="background image"> |
| </DIV> |
| <!-- Page 35 --> |
| <a name="35"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c035.png" alt="background image"> |
| <DIV style="position:absolute;top:345;left:128"><nobr><span class="ft7">3 Help File XML Reference</span></nobr></DIV> |
| <DIV style="position:absolute;top:386;left:236"><nobr><span class="ft3">This chapter lists all elements of the XML help file DTD in alphabetical order as </span></nobr></DIV> |
| <DIV style="position:absolute;top:407;left:236"><nobr><span class="ft3">presented in the Document Type Definition in the Appendix.</span></nobr></DIV> |
| <DIV style="position:absolute;top:446;left:236"><nobr><span class="ft3">The element sections presented here all share a common structure. The name of the </span></nobr></DIV> |
| <DIV style="position:absolute;top:467;left:236"><nobr><span class="ft3">element serves as a heading and is followed by element details:</span></nobr></DIV> |
| <DIV style="position:absolute;top:506;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:508;left:290"><nobr><span class="ft3">Element Description and Purpose</span></nobr></DIV> |
| <DIV style="position:absolute;top:540;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:541;left:290"><nobr><span class="ft3">Attributes</span></nobr></DIV> |
| <DIV style="position:absolute;top:573;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:574;left:290"><nobr><span class="ft3">Parent Elements</span></nobr></DIV> |
| <DIV style="position:absolute;top:606;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:608;left:290"><nobr><span class="ft3">Child Elements</span></nobr></DIV> |
| <DIV style="position:absolute;top:640;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:641;left:290"><nobr><span class="ft3">Element Definition</span></nobr></DIV> |
| <DIV style="position:absolute;top:673;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:675;left:290"><nobr><span class="ft3">Element Example</span></nobr></DIV> |
| <DIV style="position:absolute;top:706;left:236"><nobr><span class="ft3">Examples for elements can show an element within its parent or child context.</span></nobr></DIV> |
| <DIV style="position:absolute;top:759;left:236"><nobr><span class="ft10"><b>Common Attributes</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:792;left:236"><nobr><span class="ft3">The following attributes are common to several elements.</span></nobr></DIV> |
| <DIV style="position:absolute;top:844;left:236"><nobr><span class="ft8"><b>Xml-Lang</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:869;left:236"><nobr><span class="ft3">The </span></nobr></DIV> |
| <DIV style="position:absolute;top:872;left:268"><nobr><span class="ft14">xml-lang</span></nobr></DIV> |
| <DIV style="position:absolute;top:869;left:333"><nobr><span class="ft3"> attribute designates elements that need localization. The localization </span></nobr></DIV> |
| <DIV style="position:absolute;top:892;left:236"><nobr><span class="ft3">process identifies elements to be localized by this attribute. It contains the language of </span></nobr></DIV> |
| <DIV style="position:absolute;top:913;left:236"><nobr><span class="ft3">the element it belongs to as a combination of language ISO code (<i>ISO 639-1</i>) and </span></nobr></DIV> |
| <DIV style="position:absolute;top:935;left:236"><nobr><span class="ft3">country ISO code (<i>ISO 3166</i>), separated by a dash.</span></nobr></DIV> |
| <DIV style="position:absolute;top:980;left:267"><nobr><span class="ft5">xml-lang="en-US"</span></nobr></DIV> |
| <DIV style="position:absolute;top:1011;left:236"><nobr><span class="ft3">All elements containing text to be translated have an </span></nobr></DIV> |
| <DIV style="position:absolute;top:1013;left:637"><nobr><span class="ft14">xml-lang</span></nobr></DIV> |
| <DIV style="position:absolute;top:1011;left:702"><nobr><span class="ft3"> attribute: </span></nobr></DIV> |
| <DIV style="position:absolute;top:1013;left:779"><nobr><span class="ft14">alt</span></nobr></DIV> |
| <DIV style="position:absolute;top:1011;left:804"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:1035;left:236"><nobr><span class="ft14">bookmark</span></nobr></DIV> |
| <DIV style="position:absolute;top:1033;left:300"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:1035;left:309"><nobr><span class="ft14">caption</span></nobr></DIV> |
| <DIV style="position:absolute;top:1033;left:365"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:1035;left:374"><nobr><span class="ft14">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:1033;left:447"><nobr><span class="ft3">, and </span></nobr></DIV> |
| <DIV style="position:absolute;top:1035;left:484"><nobr><span class="ft14">title</span></nobr></DIV> |
| <DIV style="position:absolute;top:1033;left:525"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1073;left:236"><nobr><span class="ft3">You can use the </span></nobr></DIV> |
| <DIV style="position:absolute;top:1075;left:349"><nobr><span class="ft14">comment</span></nobr></DIV> |
| <DIV style="position:absolute;top:1073;left:406"><nobr><span class="ft3"> element to insert comments into the help file. But if they are </span></nobr></DIV> |
| <DIV style="position:absolute;top:1095;left:236"><nobr><span class="ft3">outside an element that will be localized they will not be recognized by the localizers.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>35</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 36 --> |
| <a name="36"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c036.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:193"><nobr><span class="ft8"><b>Localize</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:162;left:193"><nobr><span class="ft3">The </span></nobr></DIV> |
| <DIV style="position:absolute;top:164;left:224"><nobr><span class="ft14">localize</span></nobr></DIV> |
| <DIV style="position:absolute;top:162;left:289"><nobr><span class="ft3"> attribute can only take the value </span></nobr></DIV> |
| <DIV style="position:absolute;top:164;left:519"><nobr><span class="ft14">false</span></nobr></DIV> |
| <DIV style="position:absolute;top:162;left:560"><nobr><span class="ft3"> and designates elements that </span></nobr></DIV> |
| <DIV style="position:absolute;top:184;left:193"><nobr><span class="ft3">are excluded from the localization process. If an element contains the localize </span></nobr></DIV> |
| <DIV style="position:absolute;top:206;left:193"><nobr><span class="ft3">attribute set to </span></nobr></DIV> |
| <DIV style="position:absolute;top:208;left:297"><nobr><span class="ft14">false,</span></nobr></DIV> |
| <DIV style="position:absolute;top:206;left:345"><nobr><span class="ft3"> its contents and the contents of all child elements should not </span></nobr></DIV> |
| <DIV style="position:absolute;top:228;left:193"><nobr><span class="ft3">be translated.[<A href="HelpAuthoring_c.html#36">9</a>] If the attribute contains any other value than </span></nobr></DIV> |
| <DIV style="position:absolute;top:230;left:607"><nobr><span class="ft14">false</span></nobr></DIV> |
| <DIV style="position:absolute;top:228;left:647"><nobr><span class="ft3"> it will be ignored. </span></nobr></DIV> |
| <DIV style="position:absolute;top:250;left:193"><nobr><span class="ft3">The attribute is optional.</span></nobr></DIV> |
| <DIV style="position:absolute;top:296;left:224"><nobr><span class="ft5">localize="false"</span></nobr></DIV> |
| <DIV style="position:absolute;top:326;left:193"><nobr><span class="ft3">All elements containing text to be translated or subelements with text to be translated </span></nobr></DIV> |
| <DIV style="position:absolute;top:348;left:193"><nobr><span class="ft3">have an optional </span></nobr></DIV> |
| <DIV style="position:absolute;top:350;left:331"><nobr><span class="ft14">localize</span></nobr></DIV> |
| <DIV style="position:absolute;top:348;left:396"><nobr><span class="ft3"> attribute: </span></nobr></DIV> |
| <DIV style="position:absolute;top:350;left:478"><nobr><span class="ft14">alt</span></nobr></DIV> |
| <DIV style="position:absolute;top:348;left:502"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:350;left:518"><nobr><span class="ft14">body</span></nobr></DIV> |
| <DIV style="position:absolute;top:348;left:551"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:350;left:567"><nobr><span class="ft14">bookmark</span></nobr></DIV> |
| <DIV style="position:absolute;top:348;left:632"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:350;left:648"><nobr><span class="ft9">bookmark_value</span></nobr></DIV> |
| <DIV style="position:absolute;top:348;left:761"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:372;left:193"><nobr><span class="ft14">caption</span></nobr></DIV> |
| <DIV style="position:absolute;top:370;left:250"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:372;left:267"><nobr><span class="ft14">list</span></nobr></DIV> |
| <DIV style="position:absolute;top:370;left:300"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:372;left:317"><nobr><span class="ft14">listitem</span></nobr></DIV> |
| <DIV style="position:absolute;top:370;left:382"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:372;left:399"><nobr><span class="ft14">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:370;left:472"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:372;left:490"><nobr><span class="ft14">section</span></nobr></DIV> |
| <DIV style="position:absolute;top:370;left:546"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:372;left:564"><nobr><span class="ft14">switch</span></nobr></DIV> |
| <DIV style="position:absolute;top:370;left:613"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:372;left:630"><nobr><span class="ft14">table</span></nobr></DIV> |
| <DIV style="position:absolute;top:370;left:671"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:372;left:688"><nobr><span class="ft14">tablecell</span></nobr></DIV> |
| <DIV style="position:absolute;top:370;left:761"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:395;left:193"><nobr><span class="ft14">tablerow</span></nobr></DIV> |
| <DIV style="position:absolute;top:392;left:258"><nobr><span class="ft3">, and </span></nobr></DIV> |
| <DIV style="position:absolute;top:395;left:295"><nobr><span class="ft14">title</span></nobr></DIV> |
| <DIV style="position:absolute;top:392;left:336"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:444;left:193"><nobr><span class="ft8"><b>Id</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:470;left:193"><nobr><span class="ft3">The </span></nobr></DIV> |
| <DIV style="position:absolute;top:473;left:225"><nobr><span class="ft9">id</span></nobr></DIV> |
| <DIV style="position:absolute;top:470;left:241"><nobr><span class="ft3"> element contains a unique string used to identify the element for localization </span></nobr></DIV> |
| <DIV style="position:absolute;top:493;left:193"><nobr><span class="ft3">and referencing purposes. The ID must be <i>unique within a help file</i> so that referencing </span></nobr></DIV> |
| <DIV style="position:absolute;top:514;left:193"><nobr><span class="ft3">across files and relocating sections and paragraphs across files is possible.</span></nobr></DIV> |
| <DIV style="position:absolute;top:560;left:224"><nobr><span class="ft5">id="some_unique_value"</span></nobr></DIV> |
| <DIV style="position:absolute;top:590;left:193"><nobr><span class="ft3">All elements that can be embedded or have to be translated contain a mandatory </span></nobr></DIV> |
| <DIV style="position:absolute;top:592;left:749"><nobr><span class="ft14">id </span></nobr></DIV> |
| <DIV style="position:absolute;top:612;left:193"><nobr><span class="ft3">attribute: </span></nobr></DIV> |
| <DIV style="position:absolute;top:615;left:264"><nobr><span class="ft14">image</span></nobr></DIV> |
| <DIV style="position:absolute;top:612;left:305"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:615;left:322"><nobr><span class="ft14">bookmark</span></nobr></DIV> |
| <DIV style="position:absolute;top:612;left:387"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:615;left:404"><nobr><span class="ft14">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:612;left:477"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:615;left:494"><nobr><span class="ft14">section</span></nobr></DIV> |
| <DIV style="position:absolute;top:612;left:551"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:615;left:568"><nobr><span class="ft14">table</span></nobr></DIV> |
| <DIV style="position:absolute;top:612;left:608"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:615;left:625"><nobr><span class="ft14">title</span></nobr></DIV> |
| <DIV style="position:absolute;top:612;left:666"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:615;left:683"><nobr><span class="ft14">topic</span></nobr></DIV> |
| <DIV style="position:absolute;top:612;left:723"><nobr><span class="ft3">, and </span></nobr></DIV> |
| <DIV style="position:absolute;top:637;left:193"><nobr><span class="ft14">variable</span></nobr></DIV> |
| <DIV style="position:absolute;top:635;left:258"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:674;left:193"><nobr><span class="ft3">Valid characters for the </span></nobr></DIV> |
| <DIV style="position:absolute;top:677;left:353"><nobr><span class="ft14">id</span></nobr></DIV> |
| <DIV style="position:absolute;top:674;left:369"><nobr><span class="ft3"> value are capital or small letters from a-z, numbers from 0-</span></nobr></DIV> |
| <DIV style="position:absolute;top:697;left:193"><nobr><span class="ft3">9, and the underscore, in any combination. Other characters are not allowed.[<A href="HelpAuthoring_c.html#36">10</a>]</span></nobr></DIV> |
| <DIV style="position:absolute;top:1080;left:85"><nobr><span class="ft19">9</span></nobr></DIV> |
| <DIV style="position:absolute;top:1080;left:106"><nobr><span class="ft19">They are automatically excluded in the Sun release engineering localization process.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1100;left:85"><nobr><span class="ft19">10 For legacy reasons, the help files contain many IDs that are not valid XML "id" types. Therefore, the id attribute is defined in the DTD to be of </span></nobr></DIV> |
| <DIV style="position:absolute;top:1113;left:106"><nobr><span class="ft19">the type </span></nobr></DIV> |
| <DIV style="position:absolute;top:1112;left:147"><nobr><span class="ft14">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:1113;left:187"><nobr><span class="ft19">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>36</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 37 --> |
| <a name="37"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c037.png" alt="background image"> |
| <DIV style="position:absolute;top:154;left:236"><nobr><span class="ft10"><b>Help File (*.xhp) Elements</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:198;left:236"><nobr><span class="ft8"><b>Ahelp</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:227;left:236"><nobr><span class="ft3">This element designates text that is to be used as extended tips (for instance, tool tips </span></nobr></DIV> |
| <DIV style="position:absolute;top:249;left:236"><nobr><span class="ft3">or active help). It can contain text (</span></nobr></DIV> |
| <DIV style="position:absolute;top:251;left:470"><nobr><span class="ft14">PCDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:249;left:519"><nobr><span class="ft3">) and child elements. It can only be used as </span></nobr></DIV> |
| <DIV style="position:absolute;top:271;left:236"><nobr><span class="ft3">a child of a </span></nobr></DIV> |
| <DIV style="position:absolute;top:273;left:312"><nobr><span class="ft9">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:271;left:385"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:321;left:236"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:361;left:242"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:361;left:339"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:361;left:414"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:361;left:500"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:361;left:620"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:387;left:242"><nobr><span class="ft5">hid</span></nobr></DIV> |
| <DIV style="position:absolute;top:387;left:339"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:387;left:414"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:387;left:620"><nobr><span class="ft5">The symbolic help ID for which </span></nobr></DIV> |
| <DIV style="position:absolute;top:400;left:620"><nobr><span class="ft5">the content is to be displayed.</span></nobr></DIV> |
| <DIV style="position:absolute;top:427;left:242"><nobr><span class="ft5">visibility</span></nobr></DIV> |
| <DIV style="position:absolute;top:427;left:339"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:427;left:414"><nobr><span class="ft5">fixed value</span></nobr></DIV> |
| <DIV style="position:absolute;top:427;left:500"><nobr><span class="ft5">"hidden", "visible"</span></nobr></DIV> |
| <DIV style="position:absolute;top:427;left:620"><nobr><span class="ft5">The visibility of the ahelp content </span></nobr></DIV> |
| <DIV style="position:absolute;top:440;left:620"><nobr><span class="ft5">inside the help viewer. If set to </span></nobr></DIV> |
| <DIV style="position:absolute;top:454;left:620"><nobr><span class="ft5">"hidden" the content is only </span></nobr></DIV> |
| <DIV style="position:absolute;top:467;left:620"><nobr><span class="ft5">visible in the extended tips popup.</span></nobr></DIV> |
| <DIV style="position:absolute;top:491;left:236"><nobr><span class="ft18"><i>Table 7: Attributes of the ahelp Element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:525;left:236"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:557;left:236"><nobr><span class="ft14">caseinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:555;left:317"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:557;left:325"><nobr><span class="ft14">defaultinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:555;left:430"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:557;left:439"><nobr><span class="ft14">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:555;left:512"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:557;left:520"><nobr><span class="ft14">variable</span></nobr></DIV> |
| <DIV style="position:absolute;top:592;left:236"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:624;left:236"><nobr><span class="ft14">comment</span></nobr></DIV> |
| <DIV style="position:absolute;top:622;left:292"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:624;left:301"><nobr><span class="ft14">embedvar</span></nobr></DIV> |
| <DIV style="position:absolute;top:622;left:365"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:624;left:374"><nobr><span class="ft14">br</span></nobr></DIV> |
| <DIV style="position:absolute;top:622;left:390"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:624;left:398"><nobr><span class="ft14">emph</span></nobr></DIV> |
| <DIV style="position:absolute;top:622;left:431"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:624;left:439"><nobr><span class="ft14">item</span></nobr></DIV> |
| <DIV style="position:absolute;top:622;left:471"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:624;left:480"><nobr><span class="ft14">link</span></nobr></DIV> |
| <DIV style="position:absolute;top:622;left:512"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:624;left:521"><nobr><span class="ft14">variable</span></nobr></DIV> |
| <DIV style="position:absolute;top:659;left:236"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:695;left:268"><nobr><span class="ft23"><!ELEMENT ahelp (#PCDATA | embedvar | br | comment | emph | item | </span></nobr></DIV> |
| <DIV style="position:absolute;top:709;left:268"><nobr><span class="ft23"> link | switchinline | variable)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:722;left:268"><nobr><span class="ft23"><!ATTLIST ahelp</span></nobr></DIV> |
| <DIV style="position:absolute;top:736;left:268"><nobr><span class="ft23"> hid CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:749;left:268"><nobr><span class="ft23"> visibility (hidden | visible) #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:763;left:268"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:811;left:236"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:848;left:267"><nobr><span class="ft5"><ahelp hid="HID_SOME_HID" visibility="hidden"></span></nobr></DIV> |
| <DIV style="position:absolute;top:865;left:267"><nobr><span class="ft5">You will only see this text in the extended tips for the ui control </span></nobr></DIV> |
| <DIV style="position:absolute;top:880;left:267"><nobr><span class="ft5">with the help id HID_SOME_HID.</span></nobr></DIV> |
| <DIV style="position:absolute;top:897;left:267"><nobr><span class="ft5"></ahelp></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>37</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 38 --> |
| <a name="38"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c038.png" alt="background image"> |
| <DIV style="position:absolute;top:153;left:193"><nobr><span class="ft8"><b>Alt</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:179;left:193"><nobr><span class="ft3">This element is used to specify an alternative text for an image. It corresponds to the </span></nobr></DIV> |
| <DIV style="position:absolute;top:200;left:193"><nobr><span class="ft3">HTML attribute of the same name and can only contain PCDATA that is localized (no </span></nobr></DIV> |
| <DIV style="position:absolute;top:222;left:193"><nobr><span class="ft3">markup).</span></nobr></DIV> |
| <DIV style="position:absolute;top:265;left:193"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:302;left:200"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:302;left:296"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:302;left:375"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:302;left:457"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:302;left:577"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:328;left:200"><nobr><span class="ft5">xml-lang</span></nobr></DIV> |
| <DIV style="position:absolute;top:328;left:296"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:328;left:375"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:328;left:577"><nobr><span class="ft5">See <A href="HelpAuthoring_c.html#35">Common Attributes </a>on page </span></nobr></DIV> |
| <DIV style="position:absolute;top:341;left:577"><nobr><span class="ft5"><A href="HelpAuthoring_c.html#35">35.</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:368;left:200"><nobr><span class="ft5">id </span></nobr></DIV> |
| <DIV style="position:absolute;top:368;left:296"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:368;left:375"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:368;left:577"><nobr><span class="ft5">A unique ID to identify the </span></nobr></DIV> |
| <DIV style="position:absolute;top:381;left:577"><nobr><span class="ft5">element, <A href="HelpAuthoring_c.html#35">see Common Attributes </a></span></nobr></DIV> |
| <DIV style="position:absolute;top:394;left:577"><nobr><span class="ft5">on page <A href="HelpAuthoring_c.html#35">35</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:421;left:200"><nobr><span class="ft5">localize</span></nobr></DIV> |
| <DIV style="position:absolute;top:421;left:296"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:421;left:375"><nobr><span class="ft5">fixed value</span></nobr></DIV> |
| <DIV style="position:absolute;top:421;left:457"><nobr><span class="ft5">"false"</span></nobr></DIV> |
| <DIV style="position:absolute;top:421;left:577"><nobr><span class="ft5">See <A href="HelpAuthoring_c.html#35">Common Attributes </a>on page </span></nobr></DIV> |
| <DIV style="position:absolute;top:434;left:577"><nobr><span class="ft5"><A href="HelpAuthoring_c.html#35">35.</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:458;left:193"><nobr><span class="ft18"><i>Table 8: Attributes of the alt element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:492;left:193"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:522;left:193"><nobr><span class="ft14">image</span></nobr></DIV> |
| <DIV style="position:absolute;top:557;left:193"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:587;left:193"><nobr><span class="ft3">none</span></nobr></DIV> |
| <DIV style="position:absolute;top:623;left:193"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:659;left:225"><nobr><span class="ft23"><!ELEMENT alt (#PCDATA)></span></nobr></DIV> |
| <DIV style="position:absolute;top:673;left:225"><nobr><span class="ft23"><!ATTLIST alt</span></nobr></DIV> |
| <DIV style="position:absolute;top:686;left:225"><nobr><span class="ft23"> xml-lang CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:700;left:225"><nobr><span class="ft23"> id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:713;left:225"><nobr><span class="ft23"> localize CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:727;left:225"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:761;left:193"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:794;left:224"><nobr><span class="ft5"><image src="img/imagefile.png" id="img_id1235"></span></nobr></DIV> |
| <DIV style="position:absolute;top:811;left:224"><nobr><span class="ft5"><alt xml-lang="en-US" id="alt_id1235">Dialog File Open</alt></span></nobr></DIV> |
| <DIV style="position:absolute;top:828;left:224"><nobr><span class="ft5"></image></span></nobr></DIV> |
| <DIV style="position:absolute;top:870;left:193"><nobr><span class="ft8"><b>Body</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:896;left:193"><nobr><span class="ft3">This element contains all help content information. It cannot itself contain any </span></nobr></DIV> |
| <DIV style="position:absolute;top:918;left:193"><nobr><span class="ft3">PCDATA, but rather only child elements.</span></nobr></DIV> |
| <DIV style="position:absolute;top:954;left:193"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:994;left:200"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:994;left:296"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:994;left:372"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:994;left:457"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:994;left:577"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1020;left:200"><nobr><span class="ft14">localize</span></nobr></DIV> |
| <DIV style="position:absolute;top:1020;left:296"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:1020;left:372"><nobr><span class="ft5">fixed value</span></nobr></DIV> |
| <DIV style="position:absolute;top:1020;left:457"><nobr><span class="ft5">"false"</span></nobr></DIV> |
| <DIV style="position:absolute;top:1020;left:577"><nobr><span class="ft5">See <i><A href="HelpAuthoring_c.html#35">Common Attributes </i></a>on page </span></nobr></DIV> |
| <DIV style="position:absolute;top:1034;left:577"><nobr><span class="ft5"><A href="HelpAuthoring_c.html#35">35</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:1058;left:193"><nobr><span class="ft18"><i>Table 9: Attributes of the body element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>38</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 39 --> |
| <a name="39"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c039.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:236"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:166;left:236"><nobr><span class="ft14">helpdocument</span></nobr></DIV> |
| <DIV style="position:absolute;top:201;left:236"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:233;left:236"><nobr><span class="ft14">section</span></nobr></DIV> |
| <DIV style="position:absolute;top:230;left:292"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:233;left:301"><nobr><span class="ft14">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:230;left:374"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:233;left:382"><nobr><span class="ft14">table</span></nobr></DIV> |
| <DIV style="position:absolute;top:230;left:422"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:233;left:431"><nobr><span class="ft14">comment</span></nobr></DIV> |
| <DIV style="position:absolute;top:230;left:487"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:233;left:496"><nobr><span class="ft14">bookmark</span></nobr></DIV> |
| <DIV style="position:absolute;top:230;left:561"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:233;left:569"><nobr><span class="ft14">switch</span></nobr></DIV> |
| <DIV style="position:absolute;top:230;left:617"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:233;left:626"><nobr><span class="ft14">embed</span></nobr></DIV> |
| <DIV style="position:absolute;top:230;left:666"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:233;left:675"><nobr><span class="ft14">list</span></nobr></DIV> |
| <DIV style="position:absolute;top:230;left:707"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:233;left:715"><nobr><span class="ft14">sort</span></nobr></DIV> |
| <DIV style="position:absolute;top:275;left:236"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:307;left:268"><nobr><span class="ft23"><!ELEMENT body (section | paragraph | table | comment | bookmark | </span></nobr></DIV> |
| <DIV style="position:absolute;top:321;left:268"><nobr><span class="ft23"> switch | embed | list | sort)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:334;left:268"><nobr><span class="ft23"><!ATTLIST body</span></nobr></DIV> |
| <DIV style="position:absolute;top:348;left:268"><nobr><span class="ft23"> localize CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:361;left:268"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:395;left:236"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:428;left:267"><nobr><span class="ft5"><body></span></nobr></DIV> |
| <DIV style="position:absolute;top:445;left:267"><nobr><span class="ft5"><paragraph>This is the content of a help file</paragraph></span></nobr></DIV> |
| <DIV style="position:absolute;top:462;left:267"><nobr><span class="ft5"></body></span></nobr></DIV> |
| <DIV style="position:absolute;top:505;left:236"><nobr><span class="ft8"><b>Bookmark</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:531;left:236"><nobr><span class="ft3">This element contains information about a bookmark used in the help files. The </span></nobr></DIV> |
| <DIV style="position:absolute;top:552;left:236"><nobr><span class="ft3">bookmark type is specified inside the </span></nobr></DIV> |
| <DIV style="position:absolute;top:554;left:479"><nobr><span class="ft9">branch</span></nobr></DIV> |
| <DIV style="position:absolute;top:552;left:526"><nobr><span class="ft3"> attribute of the </span></nobr></DIV> |
| <DIV style="position:absolute;top:554;left:627"><nobr><span class="ft14">bookmark</span></nobr></DIV> |
| <DIV style="position:absolute;top:552;left:690"><nobr><span class="ft3"> element while the </span></nobr></DIV> |
| <DIV style="position:absolute;top:574;left:236"><nobr><span class="ft3">bookmark value is defined in the child element </span></nobr></DIV> |
| <DIV style="position:absolute;top:577;left:551"><nobr><span class="ft14">bookmark_value</span></nobr></DIV> |
| <DIV style="position:absolute;top:574;left:660"><nobr><span class="ft3">. For more information </span></nobr></DIV> |
| <DIV style="position:absolute;top:597;left:236"><nobr><span class="ft3">about the bookmarking system in the help please refer to <i><A href="HelpAuthoring_c.html#25">Defining Index, Contents, and</i></a></span></nobr></DIV> |
| <DIV style="position:absolute;top:618;left:236"><nobr><span class="ft13"><A href="HelpAuthoring_c.html#25"><i>Context Sensitivity</i></a> on page <A href="HelpAuthoring_c.html#25">25</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:662;left:236"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:698;left:242"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:698;left:332"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:698;left:409"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:698;left:490"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:698;left:590"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:724;left:242"><nobr><span class="ft14">branch</span></nobr></DIV> |
| <DIV style="position:absolute;top:724;left:332"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:724;left:409"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:724;left:490"><nobr><span class="ft5">"contents",</span></nobr></DIV> |
| <DIV style="position:absolute;top:737;left:490"><nobr><span class="ft5">"index",</span></nobr></DIV> |
| <DIV style="position:absolute;top:751;left:490"><nobr><span class="ft5">"hid"</span></nobr></DIV> |
| <DIV style="position:absolute;top:724;left:590"><nobr><span class="ft5">The bookmark type specified by the </span></nobr></DIV> |
| <DIV style="position:absolute;top:737;left:590"><nobr><span class="ft5">branch inside the unified bookmarks </span></nobr></DIV> |
| <DIV style="position:absolute;top:751;left:590"><nobr><span class="ft5">tree. S<A href="HelpAuthoring_c.html#25">ee <i>Defining Index, Contents, and</i></a></span></nobr></DIV> |
| <DIV style="position:absolute;top:764;left:590"><nobr><span class="ft15"><A href="HelpAuthoring_c.html#25"><i>Context Sensitivity</i> </a>on page <A href="HelpAuthoring_c.html#25">25</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:791;left:242"><nobr><span class="ft14">id</span></nobr></DIV> |
| <DIV style="position:absolute;top:791;left:332"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:791;left:409"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:791;left:590"><nobr><span class="ft5">A unique ID to identify the element, see </span></nobr></DIV> |
| <DIV style="position:absolute;top:804;left:590"><nobr><span class="ft15"><A href="HelpAuthoring_c.html#35"><i>Common Attributes </i></a>on page <A href="HelpAuthoring_c.html#35">35</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:830;left:242"><nobr><span class="ft14">xml-lang</span></nobr></DIV> |
| <DIV style="position:absolute;top:830;left:332"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:830;left:409"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:830;left:590"><nobr><span class="ft5">See <i><A href="HelpAuthoring_c.html#35">Common Attributes </i></a>on page <A href="HelpAuthoring_c.html#35">35.</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:858;left:242"><nobr><span class="ft14">localize</span></nobr></DIV> |
| <DIV style="position:absolute;top:858;left:332"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:858;left:409"><nobr><span class="ft5">fixed value</span></nobr></DIV> |
| <DIV style="position:absolute;top:858;left:490"><nobr><span class="ft5">"false"</span></nobr></DIV> |
| <DIV style="position:absolute;top:858;left:590"><nobr><span class="ft5">See <i><A href="HelpAuthoring_c.html#35">Common Attributes </i></a>on page <A href="HelpAuthoring_c.html#35">35.</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:884;left:236"><nobr><span class="ft18"><i>Table 10: Attributes of the bookmark element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:926;left:236"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:954;left:236"><nobr><span class="ft14">body</span></nobr></DIV> |
| <DIV style="position:absolute;top:952;left:268"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:954;left:276"><nobr><span class="ft14">case</span></nobr></DIV> |
| <DIV style="position:absolute;top:952;left:309"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:954;left:317"><nobr><span class="ft14">default</span></nobr></DIV> |
| <DIV style="position:absolute;top:952;left:374"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:954;left:382"><nobr><span class="ft14">section</span></nobr></DIV> |
| <DIV style="position:absolute;top:952;left:439"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:954;left:447"><nobr><span class="ft14">topic</span></nobr></DIV> |
| <DIV style="position:absolute;top:954;left:488"><nobr><span class="ft9">,</span></nobr></DIV> |
| <DIV style="position:absolute;top:952;left:496"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:954;left:500"><nobr><span class="ft14">tablecell</span></nobr></DIV> |
| <DIV style="position:absolute;top:954;left:573"><nobr><span class="ft9">,</span></nobr></DIV> |
| <DIV style="position:absolute;top:952;left:581"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:954;left:585"><nobr><span class="ft14">listitem</span></nobr></DIV> |
| <DIV style="position:absolute;top:1007;left:236"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:1037;left:236"><nobr><span class="ft14">bookmark_value</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>39</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 40 --> |
| <a name="40"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c040.png" alt="background image"> |
| <DIV style="position:absolute;top:144;left:193"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:179;left:225"><nobr><span class="ft23"><!ELEMENT bookmark (bookmark_value)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:192;left:225"><nobr><span class="ft23"><!ATTLIST bookmark</span></nobr></DIV> |
| <DIV style="position:absolute;top:206;left:225"><nobr><span class="ft23"> branch CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:220;left:225"><nobr><span class="ft23"> xml-lang CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:233;left:225"><nobr><span class="ft23"> id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:247;left:225"><nobr><span class="ft23"> localize CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:260;left:225"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:294;left:193"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:327;left:224"><nobr><span class="ft5"><bookmark branch="contents" xml-lang="en-US" id="bm_id1234"></span></nobr></DIV> |
| <DIV style="position:absolute;top:344;left:224"><nobr><span class="ft5"> <bookmark_value></span></nobr></DIV> |
| <DIV style="position:absolute;top:361;left:224"><nobr><span class="ft5"> StarOffice Writer Help/Working with Fields/Editing Field Contents</span></nobr></DIV> |
| <DIV style="position:absolute;top:378;left:224"><nobr><span class="ft5"> </bookmark_value></span></nobr></DIV> |
| <DIV style="position:absolute;top:395;left:224"><nobr><span class="ft5"></bookmark></span></nobr></DIV> |
| <DIV style="position:absolute;top:412;left:224"><nobr><span class="ft5"><bookmark branch="index" xml-lang="en-US" id="bm_id9876"></span></nobr></DIV> |
| <DIV style="position:absolute;top:429;left:224"><nobr><span class="ft5"> <bookmark_value></span></nobr></DIV> |
| <DIV style="position:absolute;top:446;left:224"><nobr><span class="ft5"> Formulas/Exporting</span></nobr></DIV> |
| <DIV style="position:absolute;top:463;left:224"><nobr><span class="ft5"> </bookmark_value></span></nobr></DIV> |
| <DIV style="position:absolute;top:480;left:224"><nobr><span class="ft5"></bookmark></span></nobr></DIV> |
| <DIV style="position:absolute;top:497;left:224"><nobr><span class="ft5"><bookmark branch="hid/12345"/></span></nobr></DIV> |
| <DIV style="position:absolute;top:540;left:193"><nobr><span class="ft8"><b>Bookmark_value</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:566;left:193"><nobr><span class="ft3">This element contains the value of a bookmark. See <A href="HelpAuthoring_c.html#25"> <i>Defining Index, Contents, and</i></a></span></nobr></DIV> |
| <DIV style="position:absolute;top:587;left:193"><nobr><span class="ft13"><A href="HelpAuthoring_c.html#25"><i>Context Sensitivity</i> </a>on page<A href="HelpAuthoring_c.html#25"> 25 </a>for details.</span></nobr></DIV> |
| <DIV style="position:absolute;top:622;left:193"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:648;left:193"><nobr><span class="ft14">bookmark</span></nobr></DIV> |
| <DIV style="position:absolute;top:682;left:193"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:708;left:193"><nobr><span class="ft14">embedvar</span></nobr></DIV> |
| <DIV style="position:absolute;top:742;left:193"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:774;left:225"><nobr><span class="ft23"><!ELEMENT bookmark_value (#PCDATA | embedvar)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:807;left:193"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:841;left:224"><nobr><span class="ft5"><bookmark branch="contents" xml-lang="en-US" id="bm_123"></span></nobr></DIV> |
| <DIV style="position:absolute;top:857;left:224"><nobr><span class="ft5"> <bookmark_value></span></nobr></DIV> |
| <DIV style="position:absolute;top:875;left:224"><nobr><span class="ft5">StarOffice Writer Help/Working with Fields/Editing Field Contents</span></nobr></DIV> |
| <DIV style="position:absolute;top:892;left:224"><nobr><span class="ft5"> </bookmark_value></span></nobr></DIV> |
| <DIV style="position:absolute;top:909;left:224"><nobr><span class="ft5"></bookmark></span></nobr></DIV> |
| <DIV style="position:absolute;top:930;left:224"><nobr><span class="ft5"><bookmark branch="index/scalc" xml-lang="en-US" id="bm_543"></span></nobr></DIV> |
| <DIV style="position:absolute;top:947;left:224"><nobr><span class="ft5"> <bookmark_value></span></nobr></DIV> |
| <DIV style="position:absolute;top:964;left:224"><nobr><span class="ft5"> Formulas/Exporting</span></nobr></DIV> |
| <DIV style="position:absolute;top:981;left:224"><nobr><span class="ft5"> </bookmark_value></span></nobr></DIV> |
| <DIV style="position:absolute;top:998;left:224"><nobr><span class="ft5"></bookmark></span></nobr></DIV> |
| <DIV style="position:absolute;top:1019;left:224"><nobr><span class="ft5"><bookmark branch="index/scalc" xml-lang="de-DE" id="bm_543"></span></nobr></DIV> |
| <DIV style="position:absolute;top:1036;left:224"><nobr><span class="ft5"> <bookmark_value></span></nobr></DIV> |
| <DIV style="position:absolute;top:1053;left:224"><nobr><span class="ft5"> Formeln/Exportieren</span></nobr></DIV> |
| <DIV style="position:absolute;top:1070;left:224"><nobr><span class="ft5"> </bookmark_value></span></nobr></DIV> |
| <DIV style="position:absolute;top:1087;left:224"><nobr><span class="ft5"></bookmark></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>40</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 41 --> |
| <a name="41"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c041.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:236"><nobr><span class="ft8"><b>Br</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:162;left:236"><nobr><span class="ft3">This element can be used to place a manual line break. It works like the </span></nobr></DIV> |
| <DIV style="position:absolute;top:183;left:236"><nobr><span class="ft3">corresponding HTML <br> element. The element itself is empty.</span></nobr></DIV> |
| <DIV style="position:absolute;top:227;left:236"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:255;left:236"><nobr><span class="ft14">ahelp</span></nobr></DIV> |
| <DIV style="position:absolute;top:253;left:276"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:255;left:284"><nobr><span class="ft14">caption</span></nobr></DIV> |
| <DIV style="position:absolute;top:253;left:341"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:255;left:350"><nobr><span class="ft14">caseinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:253;left:431"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:255;left:439"><nobr><span class="ft14">defaultinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:253;left:544"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:255;left:552"><nobr><span class="ft14">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:253;left:625"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:255;left:634"><nobr><span class="ft14">variable</span></nobr></DIV> |
| <DIV style="position:absolute;top:297;left:236"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:323;left:236"><nobr><span class="ft3">none</span></nobr></DIV> |
| <DIV style="position:absolute;top:367;left:236"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:399;left:268"><nobr><span class="ft23"><!ELEMENT br EMPTY></span></nobr></DIV> |
| <DIV style="position:absolute;top:433;left:236"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:466;left:267"><nobr><span class="ft5"><paragraph>This line must have a<b><br/></b>manual<b><br/></b>line </span></nobr></DIV> |
| <DIV style="position:absolute;top:481;left:267"><nobr><span class="ft5">break.</paragraph></span></nobr></DIV> |
| <DIV style="position:absolute;top:524;left:236"><nobr><span class="ft8"><b>Caption</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:559;left:236"><nobr><span class="ft3">This element specifies the (optional) caption of an image or a table.</span></nobr></DIV> |
| <DIV style="position:absolute;top:589;left:236"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:626;left:242"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:626;left:332"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:626;left:408"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:626;left:500"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:626;left:619"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:652;left:242"><nobr><span class="ft14">xml-lang</span></nobr></DIV> |
| <DIV style="position:absolute;top:652;left:332"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:652;left:408"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:652;left:619"><nobr><span class="ft5">S<A href="HelpAuthoring_c.html#35">ee <i>Common Attributes </i></a>on page </span></nobr></DIV> |
| <DIV style="position:absolute;top:665;left:619"><nobr><span class="ft5"><A href="HelpAuthoring_c.html#35">35.</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:692;left:242"><nobr><span class="ft14">id</span></nobr></DIV> |
| <DIV style="position:absolute;top:692;left:332"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:692;left:408"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:692;left:619"><nobr><span class="ft5">A unique ID to identify the </span></nobr></DIV> |
| <DIV style="position:absolute;top:705;left:619"><nobr><span class="ft5">element, <A href="HelpAuthoring_c.html#35">see <i>Common Attributes</a> </i></span></nobr></DIV> |
| <DIV style="position:absolute;top:718;left:619"><nobr><span class="ft5">on <A href="HelpAuthoring_c.html#35">page 35.</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:745;left:242"><nobr><span class="ft14">localize</span></nobr></DIV> |
| <DIV style="position:absolute;top:745;left:332"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:745;left:408"><nobr><span class="ft5">fixed value</span></nobr></DIV> |
| <DIV style="position:absolute;top:745;left:500"><nobr><span class="ft5">"false"</span></nobr></DIV> |
| <DIV style="position:absolute;top:745;left:619"><nobr><span class="ft5">S<A href="HelpAuthoring_c.html#35">ee <i>Common Attributes </i></a>on page </span></nobr></DIV> |
| <DIV style="position:absolute;top:758;left:619"><nobr><span class="ft5"><A href="HelpAuthoring_c.html#35">35.</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:782;left:236"><nobr><span class="ft18"><i>Table 11: Attributes of the caption element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:824;left:236"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:852;left:236"><nobr><span class="ft14">image</span></nobr></DIV> |
| <DIV style="position:absolute;top:850;left:276"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:852;left:284"><nobr><span class="ft14">table</span></nobr></DIV> |
| <DIV style="position:absolute;top:894;left:236"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:923;left:236"><nobr><span class="ft14">embedvar</span></nobr></DIV> |
| <DIV style="position:absolute;top:920;left:300"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:923;left:309"><nobr><span class="ft14">br</span></nobr></DIV> |
| <DIV style="position:absolute;top:920;left:325"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:923;left:333"><nobr><span class="ft14">emph</span></nobr></DIV> |
| <DIV style="position:absolute;top:920;left:366"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:923;left:374"><nobr><span class="ft14">item</span></nobr></DIV> |
| <DIV style="position:absolute;top:920;left:406"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:923;left:415"><nobr><span class="ft14">link</span></nobr></DIV> |
| <DIV style="position:absolute;top:920;left:447"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:923;left:455"><nobr><span class="ft14">switchinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:920;left:553"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:923;left:561"><nobr><span class="ft14">variable</span></nobr></DIV> |
| <DIV style="position:absolute;top:965;left:236"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:997;left:268"><nobr><span class="ft23"><!ELEMENT caption (#PCDATA | embedvar | br | emph | item | link | </span></nobr></DIV> |
| <DIV style="position:absolute;top:1010;left:268"><nobr><span class="ft23"> switchinline | variable)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:1024;left:268"><nobr><span class="ft23"><!ATTLIST caption</span></nobr></DIV> |
| <DIV style="position:absolute;top:1037;left:268"><nobr><span class="ft23"> xml-lang CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1051;left:268"><nobr><span class="ft23"> id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1064;left:268"><nobr><span class="ft23"> localize CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1078;left:268"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>41</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 42 --> |
| <a name="42"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c042.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:193"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:169;left:224"><nobr><span class="ft5"><table></span></nobr></DIV> |
| <DIV style="position:absolute;top:186;left:224"><nobr><span class="ft4"><b><caption xml-lang="en-US" id="cp_1234"></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:203;left:224"><nobr><span class="ft4"><b> List of all <item type="productname">StarOffice</item> slots.</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:220;left:224"><nobr><span class="ft4"><b></caption></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:237;left:224"><nobr><span class="ft5"></table></span></nobr></DIV> |
| <DIV style="position:absolute;top:280;left:193"><nobr><span class="ft8"><b>Case</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:306;left:193"><nobr><span class="ft3">This elements holds the cases of a </span></nobr></DIV> |
| <DIV style="position:absolute;top:308;left:428"><nobr><span class="ft14">switch</span></nobr></DIV> |
| <DIV style="position:absolute;top:306;left:477"><nobr><span class="ft3"> statement.</span></nobr></DIV> |
| <DIV style="position:absolute;top:358;left:193"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:398;left:200"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:398;left:296"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:398;left:371"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:398;left:457"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:398;left:577"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:424;left:200"><nobr><span class="ft14">select</span></nobr></DIV> |
| <DIV style="position:absolute;top:424;left:296"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:424;left:371"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:424;left:577"><nobr><span class="ft5">Contains the value that is to be </span></nobr></DIV> |
| <DIV style="position:absolute;top:438;left:577"><nobr><span class="ft5">evaluated. S<A href="HelpAuthoring_c.html#27">ee <i>Switching Content</a> </i></span></nobr></DIV> |
| <DIV style="position:absolute;top:451;left:577"><nobr><span class="ft5">on page <A href="HelpAuthoring_c.html#27">27</a> for more information.</span></nobr></DIV> |
| <DIV style="position:absolute;top:475;left:193"><nobr><span class="ft18"><i>Table 12: Attributes of the case element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:525;left:193"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:555;left:193"><nobr><span class="ft14">switch</span></nobr></DIV> |
| <DIV style="position:absolute;top:604;left:193"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:636;left:193"><nobr><span class="ft14">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:634;left:266"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:636;left:274"><nobr><span class="ft14">table</span></nobr></DIV> |
| <DIV style="position:absolute;top:634;left:315"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:636;left:323"><nobr><span class="ft14">comment</span></nobr></DIV> |
| <DIV style="position:absolute;top:634;left:380"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:636;left:388"><nobr><span class="ft14">bookmark</span></nobr></DIV> |
| <DIV style="position:absolute;top:634;left:453"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:636;left:461"><nobr><span class="ft14">embed</span></nobr></DIV> |
| <DIV style="position:absolute;top:634;left:502"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:636;left:510"><nobr><span class="ft14">list</span></nobr></DIV> |
| <DIV style="position:absolute;top:634;left:543"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:636;left:551"><nobr><span class="ft14">switch</span></nobr></DIV> |
| <DIV style="position:absolute;top:636;left:599"><nobr><span class="ft9">,</span></nobr></DIV> |
| <DIV style="position:absolute;top:634;left:608"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:636;left:612"><nobr><span class="ft14">section</span></nobr></DIV> |
| <DIV style="position:absolute;top:678;left:193"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:710;left:225"><nobr><span class="ft23"><!ELEMENT case (paragraph | table | comment | bookmark | embed | </span></nobr></DIV> |
| <DIV style="position:absolute;top:724;left:225"><nobr><span class="ft23"> link | list | switch | section)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:738;left:225"><nobr><span class="ft23"><!ATTLIST case</span></nobr></DIV> |
| <DIV style="position:absolute;top:751;left:225"><nobr><span class="ft23"> select CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:765;left:225"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:799;left:193"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:832;left:224"><nobr><span class="ft5"><switch select="sys"></span></nobr></DIV> |
| <DIV style="position:absolute;top:849;left:224"><nobr><span class="ft5"> <b><case select="WIN"></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:866;left:224"><nobr><span class="ft4"><b> <paragraph>This appears in Windows.</paragraph></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:883;left:224"><nobr><span class="ft4"><b> </case></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:900;left:224"><nobr><span class="ft5"> <b><case select="UNIX"></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:917;left:224"><nobr><span class="ft4"><b> <paragraph>This appears in Unix.</paragraph></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:934;left:224"><nobr><span class="ft4"><b> </case></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:951;left:224"><nobr><span class="ft5"> <default></span></nobr></DIV> |
| <DIV style="position:absolute;top:968;left:224"><nobr><span class="ft5"> <paragraph>This appears in all other cases</paragraph></span></nobr></DIV> |
| <DIV style="position:absolute;top:985;left:224"><nobr><span class="ft5"> </default></span></nobr></DIV> |
| <DIV style="position:absolute;top:1002;left:224"><nobr><span class="ft5"></switch></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>42</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 43 --> |
| <a name="43"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c043.png" alt="background image"> |
| <DIV style="position:absolute;top:153;left:236"><nobr><span class="ft8"><b>Caseinline</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:179;left:236"><nobr><span class="ft3">This element holds the cases for an </span></nobr></DIV> |
| <DIV style="position:absolute;top:181;left:477"><nobr><span class="ft14">switchinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:179;left:574"><nobr><span class="ft3"> statement.</span></nobr></DIV> |
| <DIV style="position:absolute;top:230;left:236"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:270;left:242"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:270;left:339"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:270;left:420"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:270;left:500"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:270;left:620"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:296;left:242"><nobr><span class="ft14">select</span></nobr></DIV> |
| <DIV style="position:absolute;top:296;left:339"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:296;left:420"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:296;left:620"><nobr><span class="ft5">Contains the value that is to be </span></nobr></DIV> |
| <DIV style="position:absolute;top:310;left:620"><nobr><span class="ft5">evaluated. S<A href="HelpAuthoring_c.html#27">ee <i>Switching Content </i></a></span></nobr></DIV> |
| <DIV style="position:absolute;top:323;left:620"><nobr><span class="ft5">on <A href="HelpAuthoring_c.html#27">page 27 </a>for more information.</span></nobr></DIV> |
| <DIV style="position:absolute;top:347;left:236"><nobr><span class="ft18"><i>Table 13: Attributes of the caseinline element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:389;left:236"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:415;left:236"><nobr><span class="ft14">switchinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:457;left:236"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:485;left:236"><nobr><span class="ft14">image</span></nobr></DIV> |
| <DIV style="position:absolute;top:483;left:276"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:485;left:284"><nobr><span class="ft14">embedvar</span></nobr></DIV> |
| <DIV style="position:absolute;top:483;left:349"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:485;left:358"><nobr><span class="ft14">br</span></nobr></DIV> |
| <DIV style="position:absolute;top:483;left:374"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:485;left:382"><nobr><span class="ft14">emph</span></nobr></DIV> |
| <DIV style="position:absolute;top:483;left:414"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:485;left:423"><nobr><span class="ft14">item</span></nobr></DIV> |
| <DIV style="position:absolute;top:483;left:455"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:485;left:464"><nobr><span class="ft14">link</span></nobr></DIV> |
| <DIV style="position:absolute;top:483;left:496"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:485;left:504"><nobr><span class="ft14">switchinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:483;left:602"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:485;left:610"><nobr><span class="ft14">variable</span></nobr></DIV> |
| <DIV style="position:absolute;top:483;left:675"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:485;left:683"><nobr><span class="ft14">ahelp</span></nobr></DIV> |
| <DIV style="position:absolute;top:483;left:723"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:485;left:732"><nobr><span class="ft14">object</span></nobr></DIV> |
| <DIV style="position:absolute;top:527;left:236"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:559;left:268"><nobr><span class="ft23"><!ELEMENT caseinline (#PCDATA | image | embedvar | br | emph | </span></nobr></DIV> |
| <DIV style="position:absolute;top:573;left:268"><nobr><span class="ft23"> item | link | switchinline | variable | </span></nobr></DIV> |
| <DIV style="position:absolute;top:586;left:268"><nobr><span class="ft23"> ahelp | object)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:600;left:268"><nobr><span class="ft23"><!ATTLIST caseinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:614;left:268"><nobr><span class="ft23"> select CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:627;left:268"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:666;left:236"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:703;left:267"><nobr><span class="ft5"><paragraph>Press the </span></nobr></DIV> |
| <DIV style="position:absolute;top:720;left:267"><nobr><span class="ft5"> <switchinline select="sys"></span></nobr></DIV> |
| <DIV style="position:absolute;top:737;left:267"><nobr><span class="ft5"> <b><caseinline select="WIN">Ctrl</caseinline></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:754;left:267"><nobr><span class="ft5"> <b><caseinline select="MAC">Apple</caseinline></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:771;left:267"><nobr><span class="ft5"> <defaultinline>any</defaultinline></span></nobr></DIV> |
| <DIV style="position:absolute;top:788;left:267"><nobr><span class="ft5"> </switchinline> </span></nobr></DIV> |
| <DIV style="position:absolute;top:805;left:267"><nobr><span class="ft5"> key to start.</span></nobr></DIV> |
| <DIV style="position:absolute;top:822;left:267"><nobr><span class="ft5"></paragraph></span></nobr></DIV> |
| <DIV style="position:absolute;top:865;left:236"><nobr><span class="ft8"><b>Comment</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:890;left:236"><nobr><span class="ft3">This element is used for inserting comments into the help files used by the </span></nobr></DIV> |
| <DIV style="position:absolute;top:912;left:236"><nobr><span class="ft3">author/editor/translator. They are to be removed when the help files are compiled.</span></nobr></DIV> |
| <DIV style="position:absolute;top:955;left:236"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:981;left:236"><nobr><span class="ft3">none</span></nobr></DIV> |
| <DIV style="position:absolute;top:1025;left:236"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:1053;left:236"><nobr><span class="ft14">body</span></nobr></DIV> |
| <DIV style="position:absolute;top:1051;left:268"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:1053;left:276"><nobr><span class="ft14">case</span></nobr></DIV> |
| <DIV style="position:absolute;top:1051;left:309"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:1053;left:317"><nobr><span class="ft14">default</span></nobr></DIV> |
| <DIV style="position:absolute;top:1051;left:374"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:1053;left:382"><nobr><span class="ft14">list</span></nobr></DIV> |
| <DIV style="position:absolute;top:1051;left:414"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:1053;left:423"><nobr><span class="ft14">listitem</span></nobr></DIV> |
| <DIV style="position:absolute;top:1051;left:488"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:1053;left:496"><nobr><span class="ft14">section</span></nobr></DIV> |
| <DIV style="position:absolute;top:1051;left:553"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:1053;left:561"><nobr><span class="ft14">switch</span></nobr></DIV> |
| <DIV style="position:absolute;top:1051;left:610"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:1053;left:618"><nobr><span class="ft14">tablecell</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>43</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 44 --> |
| <a name="44"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c044.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:193"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:162;left:193"><nobr><span class="ft3">none</span></nobr></DIV> |
| <DIV style="position:absolute;top:206;left:193"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:238;left:225"><nobr><span class="ft23"><!ELEMENT comment (#PCDATA)></span></nobr></DIV> |
| <DIV style="position:absolute;top:271;left:193"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:305;left:224"><nobr><span class="ft5"><section></span></nobr></DIV> |
| <DIV style="position:absolute;top:322;left:224"><nobr><span class="ft5"> <b><comment>FPE: This section is in a draft state!</comment></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:339;left:224"><nobr><span class="ft5"></section></span></nobr></DIV> |
| <DIV style="position:absolute;top:381;left:193"><nobr><span class="ft8"><b>Created</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:407;left:193"><nobr><span class="ft3">This element holds the date of document creation and additional information (author </span></nobr></DIV> |
| <DIV style="position:absolute;top:428;left:193"><nobr><span class="ft3">or comment).</span></nobr></DIV> |
| <DIV style="position:absolute;top:472;left:193"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:508;left:200"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:508;left:294"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:508;left:373"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:508;left:451"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:508;left:569"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:535;left:200"><nobr><span class="ft5">date</span></nobr></DIV> |
| <DIV style="position:absolute;top:535;left:294"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:535;left:373"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:535;left:569"><nobr><span class="ft5">Contains the date of document </span></nobr></DIV> |
| <DIV style="position:absolute;top:548;left:569"><nobr><span class="ft5">creation in the format</span></nobr></DIV> |
| <DIV style="position:absolute;top:561;left:569"><nobr><span class="ft14">YYYY-MM-DDThh:mm:ss</span></nobr></DIV> |
| <DIV style="position:absolute;top:577;left:569"><nobr><span class="ft5">where: </span></nobr></DIV> |
| <DIV style="position:absolute;top:590;left:569"><nobr><span class="ft14">YYYY</span></nobr></DIV> |
| <DIV style="position:absolute;top:590;left:601"><nobr><span class="ft5"> = four-digit year</span></nobr></DIV> |
| <DIV style="position:absolute;top:605;left:569"><nobr><span class="ft9"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:605;left:585"><nobr><span class="ft14">MM</span></nobr></DIV> |
| <DIV style="position:absolute;top:606;left:601"><nobr><span class="ft5"> = two-digit month </span></nobr></DIV> |
| <DIV style="position:absolute;top:621;left:569"><nobr><span class="ft9"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:621;left:585"><nobr><span class="ft14">DD</span></nobr></DIV> |
| <DIV style="position:absolute;top:621;left:601"><nobr><span class="ft5"> = two-digit day of month</span></nobr></DIV> |
| <DIV style="position:absolute;top:636;left:569"><nobr><span class="ft9"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:636;left:585"><nobr><span class="ft14">hh</span></nobr></DIV> |
| <DIV style="position:absolute;top:636;left:601"><nobr><span class="ft5"> = two digits of 24 hour</span></nobr></DIV> |
| <DIV style="position:absolute;top:651;left:569"><nobr><span class="ft9"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:651;left:585"><nobr><span class="ft14">mm</span></nobr></DIV> |
| <DIV style="position:absolute;top:652;left:601"><nobr><span class="ft5"> = two digits of minute</span></nobr></DIV> |
| <DIV style="position:absolute;top:667;left:569"><nobr><span class="ft9"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:667;left:585"><nobr><span class="ft14">ss</span></nobr></DIV> |
| <DIV style="position:absolute;top:667;left:601"><nobr><span class="ft5"> = two digits of second</span></nobr></DIV> |
| <DIV style="position:absolute;top:697;left:193"><nobr><span class="ft18"><i>Table 14: Attributes of the created element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:731;left:193"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:753;left:193"><nobr><span class="ft14">history</span></nobr></DIV> |
| <DIV style="position:absolute;top:791;left:193"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:812;left:193"><nobr><span class="ft3">none</span></nobr></DIV> |
| <DIV style="position:absolute;top:852;left:193"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:880;left:225"><nobr><span class="ft23"><!ELEMENT created (#PCDATA)></span></nobr></DIV> |
| <DIV style="position:absolute;top:893;left:225"><nobr><span class="ft23"><!ATTLIST created</span></nobr></DIV> |
| <DIV style="position:absolute;top:907;left:225"><nobr><span class="ft23"> date CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:920;left:225"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:950;left:193"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:979;left:224"><nobr><span class="ft5"><meta></span></nobr></DIV> |
| <DIV style="position:absolute;top:996;left:224"><nobr><span class="ft5"> <history></span></nobr></DIV> |
| <DIV style="position:absolute;top:1013;left:224"><nobr><span class="ft5"> <b><created date="2002-05-20T15:15:00">New topic created</created></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1030;left:224"><nobr><span class="ft5"> <lastedited date="2002-06-20T15:15:00">Made changes</lastedited></span></nobr></DIV> |
| <DIV style="position:absolute;top:1047;left:224"><nobr><span class="ft5"> </history></span></nobr></DIV> |
| <DIV style="position:absolute;top:1064;left:224"><nobr><span class="ft5"></meta></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>44</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 45 --> |
| <a name="45"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c045.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:236"><nobr><span class="ft8"><b>Default</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:162;left:236"><nobr><span class="ft3">This elements holds the default values for a </span></nobr></DIV> |
| <DIV style="position:absolute;top:164;left:564"><nobr><span class="ft14">switch</span></nobr></DIV> |
| <DIV style="position:absolute;top:162;left:613"><nobr><span class="ft3">. It is evaluated if all </span></nobr></DIV> |
| <DIV style="position:absolute;top:164;left:776"><nobr><span class="ft14">case </span></nobr></DIV> |
| <DIV style="position:absolute;top:184;left:236"><nobr><span class="ft3">elements of a </span></nobr></DIV> |
| <DIV style="position:absolute;top:187;left:330"><nobr><span class="ft14">switch</span></nobr></DIV> |
| <DIV style="position:absolute;top:184;left:378"><nobr><span class="ft3"> element evaluate to false.</span></nobr></DIV> |
| <DIV style="position:absolute;top:220;left:236"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:246;left:236"><nobr><span class="ft3">none</span></nobr></DIV> |
| <DIV style="position:absolute;top:281;left:236"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:307;left:236"><nobr><span class="ft14">switch</span></nobr></DIV> |
| <DIV style="position:absolute;top:341;left:236"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:369;left:236"><nobr><span class="ft14">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:367;left:309"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:369;left:317"><nobr><span class="ft14">table</span></nobr></DIV> |
| <DIV style="position:absolute;top:367;left:357"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:369;left:366"><nobr><span class="ft14">comment</span></nobr></DIV> |
| <DIV style="position:absolute;top:367;left:422"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:369;left:431"><nobr><span class="ft14">bookmark</span></nobr></DIV> |
| <DIV style="position:absolute;top:367;left:495"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:369;left:504"><nobr><span class="ft14">embed</span></nobr></DIV> |
| <DIV style="position:absolute;top:367;left:544"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:369;left:553"><nobr><span class="ft14">list</span></nobr></DIV> |
| <DIV style="position:absolute;top:369;left:585"><nobr><span class="ft9">,</span></nobr></DIV> |
| <DIV style="position:absolute;top:367;left:593"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:369;left:597"><nobr><span class="ft14">section</span></nobr></DIV> |
| <DIV style="position:absolute;top:403;left:236"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:435;left:268"><nobr><span class="ft23"><!ELEMENT default (paragraph | table | comment | bookmark | </span></nobr></DIV> |
| <DIV style="position:absolute;top:449;left:268"><nobr><span class="ft23"> embed | link | list | switch | section)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:482;left:236"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:515;left:267"><nobr><span class="ft5"><switch select="sys"></span></nobr></DIV> |
| <DIV style="position:absolute;top:532;left:267"><nobr><span class="ft5"> <case select="WIN"></span></nobr></DIV> |
| <DIV style="position:absolute;top:550;left:267"><nobr><span class="ft5"> <paragraph>This appears in Windows.</paragraph></span></nobr></DIV> |
| <DIV style="position:absolute;top:566;left:267"><nobr><span class="ft5"> </case></span></nobr></DIV> |
| <DIV style="position:absolute;top:584;left:267"><nobr><span class="ft5"> <case select="UNIX"></span></nobr></DIV> |
| <DIV style="position:absolute;top:601;left:267"><nobr><span class="ft5"> <paragraph>This appears in Unix.</paragraph></span></nobr></DIV> |
| <DIV style="position:absolute;top:618;left:267"><nobr><span class="ft5"> </case></span></nobr></DIV> |
| <DIV style="position:absolute;top:635;left:267"><nobr><span class="ft4"><b> <default></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:652;left:267"><nobr><span class="ft4"><b> <paragraph>This appears in all other cases</paragraph></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:669;left:267"><nobr><span class="ft4"><b> </default></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:686;left:267"><nobr><span class="ft5"></switch></span></nobr></DIV> |
| <DIV style="position:absolute;top:728;left:236"><nobr><span class="ft8"><b>Defaultinline</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:754;left:236"><nobr><span class="ft3">This elements holds the default values for an inline switch. It is evaluated if all </span></nobr></DIV> |
| <DIV style="position:absolute;top:778;left:236"><nobr><span class="ft14">caseinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:776;left:317"><nobr><span class="ft3"> elements of a </span></nobr></DIV> |
| <DIV style="position:absolute;top:778;left:415"><nobr><span class="ft14">switchinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:776;left:512"><nobr><span class="ft3"> element evaluate to false.</span></nobr></DIV> |
| <DIV style="position:absolute;top:820;left:236"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:846;left:236"><nobr><span class="ft3">none</span></nobr></DIV> |
| <DIV style="position:absolute;top:889;left:236"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:915;left:236"><nobr><span class="ft14">switchinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:958;left:236"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:986;left:236"><nobr><span class="ft14">image</span></nobr></DIV> |
| <DIV style="position:absolute;top:984;left:276"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:986;left:284"><nobr><span class="ft14">embedvar</span></nobr></DIV> |
| <DIV style="position:absolute;top:984;left:349"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:986;left:358"><nobr><span class="ft14">br</span></nobr></DIV> |
| <DIV style="position:absolute;top:984;left:374"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:986;left:382"><nobr><span class="ft14">emph</span></nobr></DIV> |
| <DIV style="position:absolute;top:984;left:414"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:986;left:423"><nobr><span class="ft14">item</span></nobr></DIV> |
| <DIV style="position:absolute;top:984;left:455"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:986;left:464"><nobr><span class="ft14">link</span></nobr></DIV> |
| <DIV style="position:absolute;top:984;left:496"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:986;left:504"><nobr><span class="ft14">switchinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:984;left:602"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:986;left:610"><nobr><span class="ft14">variable</span></nobr></DIV> |
| <DIV style="position:absolute;top:984;left:675"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:986;left:683"><nobr><span class="ft14">ahelp</span></nobr></DIV> |
| <DIV style="position:absolute;top:984;left:723"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:986;left:732"><nobr><span class="ft14">object</span></nobr></DIV> |
| <DIV style="position:absolute;top:1028;left:236"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:1060;left:268"><nobr><span class="ft23"><!ELEMENT defaultinline (#PCDATA | image | embedvar | br | emph | </span></nobr></DIV> |
| <DIV style="position:absolute;top:1074;left:268"><nobr><span class="ft23"> item | link | switchinline | variable | </span></nobr></DIV> |
| <DIV style="position:absolute;top:1087;left:268"><nobr><span class="ft23"> ahelp | object)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>45</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 46 --> |
| <a name="46"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c046.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:193"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:169;left:224"><nobr><span class="ft5"><paragraph>Press the </span></nobr></DIV> |
| <DIV style="position:absolute;top:186;left:224"><nobr><span class="ft5"> <switchinline select="sys"></span></nobr></DIV> |
| <DIV style="position:absolute;top:203;left:224"><nobr><span class="ft5"> <caseinline select="WIN">Ctrl</caseinline></span></nobr></DIV> |
| <DIV style="position:absolute;top:220;left:224"><nobr><span class="ft5"> <caseinline select="MAC">Apple</caseinline></span></nobr></DIV> |
| <DIV style="position:absolute;top:237;left:224"><nobr><span class="ft5"> <b><defaultinline>any</defaultinline></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:254;left:224"><nobr><span class="ft5"> </switchinline> </span></nobr></DIV> |
| <DIV style="position:absolute;top:271;left:224"><nobr><span class="ft5"> key to start.</span></nobr></DIV> |
| <DIV style="position:absolute;top:288;left:224"><nobr><span class="ft5"></paragraph></span></nobr></DIV> |
| <DIV style="position:absolute;top:331;left:193"><nobr><span class="ft8"><b>Embed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:357;left:193"><nobr><span class="ft3">This element is used to embed content from a different source at the current position. </span></nobr></DIV> |
| <DIV style="position:absolute;top:378;left:193"><nobr><span class="ft3">The only elements that can be embedded from somewhere else are </span></nobr></DIV> |
| <DIV style="position:absolute;top:381;left:680"><nobr><span class="ft14">sections</span></nobr></DIV> |
| <DIV style="position:absolute;top:378;left:745"><nobr><span class="ft3"> or </span></nobr></DIV> |
| <DIV style="position:absolute;top:403;left:193"><nobr><span class="ft14">paragraphs,</span></nobr></DIV> |
| <DIV style="position:absolute;top:401;left:282"><nobr><span class="ft3"> which are identified by their URL. For smaller text fragments, </span></nobr></DIV> |
| <DIV style="position:absolute;top:403;left:701"><nobr><span class="ft14">embedvar </span></nobr></DIV> |
| <DIV style="position:absolute;top:423;left:193"><nobr><span class="ft3">can be used. See <i><A href="HelpAuthoring_c.html#28">Embedding Content</i> </a>on page <A href="HelpAuthoring_c.html#28">28.</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:462;left:193"><nobr><span class="ft3">The optional </span></nobr></DIV> |
| <DIV style="position:absolute;top:464;left:288"><nobr><span class="ft14">role</span></nobr></DIV> |
| <DIV style="position:absolute;top:462;left:320"><nobr><span class="ft3"> attribute can override the role of a paragraph. For embedded </span></nobr></DIV> |
| <DIV style="position:absolute;top:484;left:193"><nobr><span class="ft3">sections, the </span></nobr></DIV> |
| <DIV style="position:absolute;top:486;left:281"><nobr><span class="ft14">role</span></nobr></DIV> |
| <DIV style="position:absolute;top:484;left:314"><nobr><span class="ft3"> attribute has no effect.</span></nobr></DIV> |
| <DIV style="position:absolute;top:528;left:193"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:565;left:200"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:565;left:296"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:565;left:377"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:565;left:457"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:565;left:577"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:591;left:200"><nobr><span class="ft14">href</span></nobr></DIV> |
| <DIV style="position:absolute;top:591;left:296"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:591;left:377"><nobr><span class="ft5">URL</span></nobr></DIV> |
| <DIV style="position:absolute;top:591;left:577"><nobr><span class="ft5">A URL pointing to the content to </span></nobr></DIV> |
| <DIV style="position:absolute;top:604;left:577"><nobr><span class="ft5">be embedded. The URL has the </span></nobr></DIV> |
| <DIV style="position:absolute;top:618;left:577"><nobr><span class="ft5">form </span></nobr></DIV> |
| <DIV style="position:absolute;top:619;left:605"><nobr><span class="ft17">filepath#id</span></nobr></DIV> |
| <DIV style="position:absolute;top:618;left:684"><nobr><span class="ft5">. Filepath is </span></nobr></DIV> |
| <DIV style="position:absolute;top:632;left:577"><nobr><span class="ft5">the path of the file as contained in </span></nobr></DIV> |
| <DIV style="position:absolute;top:646;left:577"><nobr><span class="ft5">the </span></nobr></DIV> |
| <DIV style="position:absolute;top:646;left:597"><nobr><span class="ft17">jar</span></nobr></DIV> |
| <DIV style="position:absolute;top:646;left:619"><nobr><span class="ft5"> archive.</span></nobr></DIV> |
| <DIV style="position:absolute;top:673;left:200"><nobr><span class="ft14">role</span></nobr></DIV> |
| <DIV style="position:absolute;top:673;left:296"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:673;left:457"><nobr><span class="ft5">see <i><A href="HelpAuthoring_c.html#24">Paragraph</i></a></span></nobr></DIV> |
| <DIV style="position:absolute;top:686;left:457"><nobr><span class="ft15"><A href="HelpAuthoring_c.html#24"><i>Roles</i> </a>on page <A href="HelpAuthoring_c.html#24">24.</a> </span></nobr></DIV> |
| <DIV style="position:absolute;top:673;left:577"><nobr><span class="ft5">The role in which the embedded </span></nobr></DIV> |
| <DIV style="position:absolute;top:686;left:577"><nobr><span class="ft5">paragraph will appear. If this </span></nobr></DIV> |
| <DIV style="position:absolute;top:700;left:577"><nobr><span class="ft5">attribute is specified the </span></nobr></DIV> |
| <DIV style="position:absolute;top:713;left:577"><nobr><span class="ft5">paragraph is displayed with this </span></nobr></DIV> |
| <DIV style="position:absolute;top:727;left:577"><nobr><span class="ft5">role overwriting its original role </span></nobr></DIV> |
| <DIV style="position:absolute;top:740;left:577"><nobr><span class="ft5">(not applicable for sections).</span></nobr></DIV> |
| <DIV style="position:absolute;top:766;left:200"><nobr><span class="ft14">level</span></nobr></DIV> |
| <DIV style="position:absolute;top:766;left:296"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:766;left:377"><nobr><span class="ft5">fixed values</span></nobr></DIV> |
| <DIV style="position:absolute;top:766;left:457"><nobr><span class="ft5">numerical value</span></nobr></DIV> |
| <DIV style="position:absolute;top:766;left:577"><nobr><span class="ft5">The heading level if the </span></nobr></DIV> |
| <DIV style="position:absolute;top:767;left:705"><nobr><span class="ft17">role </span></nobr></DIV> |
| <DIV style="position:absolute;top:781;left:577"><nobr><span class="ft5">attribute is set to "heading"</span></nobr></DIV> |
| <DIV style="position:absolute;top:805;left:193"><nobr><span class="ft18"><i>Table 15: Attributes of the embed element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:846;left:193"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:875;left:193"><nobr><span class="ft14">body</span></nobr></DIV> |
| <DIV style="position:absolute;top:872;left:225"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:875;left:234"><nobr><span class="ft14">case</span></nobr></DIV> |
| <DIV style="position:absolute;top:872;left:266"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:875;left:275"><nobr><span class="ft14">default</span></nobr></DIV> |
| <DIV style="position:absolute;top:872;left:331"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:875;left:340"><nobr><span class="ft14">listitem</span></nobr></DIV> |
| <DIV style="position:absolute;top:872;left:404"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:875;left:413"><nobr><span class="ft14">section</span></nobr></DIV> |
| <DIV style="position:absolute;top:872;left:469"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:875;left:478"><nobr><span class="ft14">tablecell</span></nobr></DIV> |
| <DIV style="position:absolute;top:917;left:193"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:943;left:193"><nobr><span class="ft3">none</span></nobr></DIV> |
| <DIV style="position:absolute;top:986;left:193"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:1018;left:225"><nobr><span class="ft23"><!ELEMENT embed EMPTY></span></nobr></DIV> |
| <DIV style="position:absolute;top:1032;left:225"><nobr><span class="ft23"><!ATTLIST embed</span></nobr></DIV> |
| <DIV style="position:absolute;top:1046;left:225"><nobr><span class="ft23"> href CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1059;left:225"><nobr><span class="ft23"> role CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1073;left:225"><nobr><span class="ft23"> level CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1086;left:225"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>46</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 47 --> |
| <a name="47"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c047.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:236"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:169;left:267"><nobr><span class="ft5"><embed href="text/swriter/guide/editing#4711"/></span></nobr></DIV> |
| <DIV style="position:absolute;top:186;left:267"><nobr><span class="ft5"><embed href="text/scalc/01/0123456#9876" role="warning"/></span></nobr></DIV> |
| <DIV style="position:absolute;top:229;left:236"><nobr><span class="ft8"><b>Embedvar</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:255;left:236"><nobr><span class="ft3">This element is used to embed smaller text fragments with and without markup, which </span></nobr></DIV> |
| <DIV style="position:absolute;top:276;left:236"><nobr><span class="ft3">were previously declared as being </span></nobr></DIV> |
| <DIV style="position:absolute;top:278;left:470"><nobr><span class="ft14">variables</span></nobr></DIV> |
| <DIV style="position:absolute;top:276;left:542"><nobr><span class="ft3">. See also<A href="HelpAuthoring_c.html#28"> <i>Embedding Content</i></a> on page </span></nobr></DIV> |
| <DIV style="position:absolute;top:298;left:236"><nobr><span class="ft3"><A href="HelpAuthoring_c.html#28">28</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:342;left:236"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:378;left:242"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:378;left:339"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:378;left:415"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:378;left:500"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:378;left:620"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:404;left:242"><nobr><span class="ft14">href</span></nobr></DIV> |
| <DIV style="position:absolute;top:404;left:339"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:404;left:415"><nobr><span class="ft5">URL</span></nobr></DIV> |
| <DIV style="position:absolute;top:404;left:620"><nobr><span class="ft5">A URL pointing to the content to </span></nobr></DIV> |
| <DIV style="position:absolute;top:418;left:620"><nobr><span class="ft5">be embedded. The URL has the </span></nobr></DIV> |
| <DIV style="position:absolute;top:432;left:620"><nobr><span class="ft5">form </span></nobr></DIV> |
| <DIV style="position:absolute;top:431;left:647"><nobr><span class="ft14">filepath#id</span></nobr></DIV> |
| <DIV style="position:absolute;top:432;left:736"><nobr><span class="ft5">. Filepath is </span></nobr></DIV> |
| <DIV style="position:absolute;top:447;left:620"><nobr><span class="ft5">the path of the file as contained in </span></nobr></DIV> |
| <DIV style="position:absolute;top:460;left:620"><nobr><span class="ft5">the </span></nobr></DIV> |
| <DIV style="position:absolute;top:460;left:640"><nobr><span class="ft14">jar</span></nobr></DIV> |
| <DIV style="position:absolute;top:460;left:664"><nobr><span class="ft5"> archive.</span></nobr></DIV> |
| <DIV style="position:absolute;top:488;left:242"><nobr><span class="ft14">markup</span></nobr></DIV> |
| <DIV style="position:absolute;top:488;left:339"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:488;left:415"><nobr><span class="ft5">fixed values</span></nobr></DIV> |
| <DIV style="position:absolute;top:488;left:500"><nobr><span class="ft5">"keep"</span></nobr></DIV> |
| <DIV style="position:absolute;top:502;left:500"><nobr><span class="ft5">"ignore"</span></nobr></DIV> |
| <DIV style="position:absolute;top:488;left:620"><nobr><span class="ft5">Specifies whether markup </span></nobr></DIV> |
| <DIV style="position:absolute;top:502;left:620"><nobr><span class="ft5">contained in the variable to be </span></nobr></DIV> |
| <DIV style="position:absolute;top:515;left:620"><nobr><span class="ft5">embedded is ignored or kept in </span></nobr></DIV> |
| <DIV style="position:absolute;top:528;left:620"><nobr><span class="ft5">the target position. The default is </span></nobr></DIV> |
| <DIV style="position:absolute;top:542;left:620"><nobr><span class="ft5">to keep markup within the text </span></nobr></DIV> |
| <DIV style="position:absolute;top:555;left:620"><nobr><span class="ft5">fragment.</span></nobr></DIV> |
| <DIV style="position:absolute;top:579;left:236"><nobr><span class="ft18"><i>Table 16: Attributes of the embedvar element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:621;left:236"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:649;left:236"><nobr><span class="ft14">ahelp</span></nobr></DIV> |
| <DIV style="position:absolute;top:647;left:276"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:649;left:284"><nobr><span class="ft14">caption</span></nobr></DIV> |
| <DIV style="position:absolute;top:647;left:341"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:649;left:350"><nobr><span class="ft14">caseinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:647;left:431"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:649;left:439"><nobr><span class="ft14">defaultinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:647;left:544"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:649;left:552"><nobr><span class="ft14">link</span></nobr></DIV> |
| <DIV style="position:absolute;top:647;left:585"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:649;left:593"><nobr><span class="ft14">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:647;left:666"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:649;left:674"><nobr><span class="ft14">variable</span></nobr></DIV> |
| <DIV style="position:absolute;top:691;left:236"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:717;left:236"><nobr><span class="ft3">none</span></nobr></DIV> |
| <DIV style="position:absolute;top:761;left:236"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:793;left:268"><nobr><span class="ft23"><!ELEMENT embedvar EMPTY></span></nobr></DIV> |
| <DIV style="position:absolute;top:806;left:268"><nobr><span class="ft23"><!ATTLIST embedvar</span></nobr></DIV> |
| <DIV style="position:absolute;top:820;left:268"><nobr><span class="ft23"> href CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:834;left:268"><nobr><span class="ft23"> markup (keep | ignore) #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:847;left:268"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:881;left:236"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:914;left:267"><nobr><span class="ft5"><paragraph>This element can be found on the <b><embedvar </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:929;left:267"><nobr><span class="ft4"><b>href="text/swriter/01/dialogs#fileopen" markup="ignore"/> </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:945;left:267"><nobr><span class="ft5">dialog.</paragraph></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>47</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 48 --> |
| <a name="48"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c048.png" alt="background image"> |
| <DIV style="position:absolute;top:153;left:193"><nobr><span class="ft8"><b>Emph</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:179;left:193"><nobr><span class="ft3">This element is used to mark emphasized content. It can only contain PCDATA.</span></nobr></DIV> |
| <DIV style="position:absolute;top:223;left:193"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:249;left:193"><nobr><span class="ft3">none</span></nobr></DIV> |
| <DIV style="position:absolute;top:292;left:193"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:320;left:193"><nobr><span class="ft14">ahelp</span></nobr></DIV> |
| <DIV style="position:absolute;top:318;left:234"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:320;left:242"><nobr><span class="ft14">caption</span></nobr></DIV> |
| <DIV style="position:absolute;top:318;left:299"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:320;left:307"><nobr><span class="ft14">caseinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:318;left:388"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:320;left:396"><nobr><span class="ft14">defaultinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:318;left:502"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:320;left:510"><nobr><span class="ft14">link</span></nobr></DIV> |
| <DIV style="position:absolute;top:318;left:542"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:320;left:551"><nobr><span class="ft14">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:318;left:624"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:320;left:632"><nobr><span class="ft14">variable</span></nobr></DIV> |
| <DIV style="position:absolute;top:362;left:193"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:391;left:193"><nobr><span class="ft14">item</span></nobr></DIV> |
| <DIV style="position:absolute;top:389;left:225"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:391;left:234"><nobr><span class="ft14">comment</span></nobr></DIV> |
| <DIV style="position:absolute;top:389;left:291"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:391;left:299"><nobr><span class="ft14">help-id-missing</span></nobr></DIV> |
| <DIV style="position:absolute;top:433;left:193"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:465;left:225"><nobr><span class="ft23"><!ELEMENT emph (#PCDATA | item | comment)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:499;left:193"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:532;left:224"><nobr><span class="ft5"><paragraph><b><emph>Never</emph></b> delete the paragraph</paragraph></span></nobr></DIV> |
| <DIV style="position:absolute;top:574;left:193"><nobr><span class="ft8"><b>Filename</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:600;left:193"><nobr><span class="ft3">This element contains the path and name of the help topic file as included in the jar </span></nobr></DIV> |
| <DIV style="position:absolute;top:622;left:193"><nobr><span class="ft3">file, for example, </span></nobr></DIV> |
| <DIV style="position:absolute;top:624;left:307"><nobr><span class="ft14">text/swriter/01/1234567.xhp</span></nobr></DIV> |
| <DIV style="position:absolute;top:622;left:526"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:666;left:193"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:692;left:193"><nobr><span class="ft3">none</span></nobr></DIV> |
| <DIV style="position:absolute;top:736;left:193"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:762;left:193"><nobr><span class="ft14">topic</span></nobr></DIV> |
| <DIV style="position:absolute;top:804;left:193"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:830;left:193"><nobr><span class="ft3">none</span></nobr></DIV> |
| <DIV style="position:absolute;top:873;left:193"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:905;left:225"><nobr><span class="ft23"><!ELEMENT filename (#PCDATA)></span></nobr></DIV> |
| <DIV style="position:absolute;top:939;left:193"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:972;left:224"><nobr><span class="ft5"><filename>text/swriter/01/08154711.xhp</filename></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>48</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 49 --> |
| <a name="49"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c049.png" alt="background image"> |
| <DIV style="position:absolute;top:153;left:236"><nobr><span class="ft8"><b>Helpdocument</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:179;left:236"><nobr><span class="ft3">This is the root element of a help document and contains the </span></nobr></DIV> |
| <DIV style="position:absolute;top:181;left:658"><nobr><span class="ft14">meta</span></nobr></DIV> |
| <DIV style="position:absolute;top:179;left:690"><nobr><span class="ft3"> and </span></nobr></DIV> |
| <DIV style="position:absolute;top:181;left:726"><nobr><span class="ft14">body</span></nobr></DIV> |
| <DIV style="position:absolute;top:179;left:759"><nobr><span class="ft3"> part of </span></nobr></DIV> |
| <DIV style="position:absolute;top:201;left:236"><nobr><span class="ft3">the help topic.</span></nobr></DIV> |
| <DIV style="position:absolute;top:245;left:236"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:281;left:242"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:281;left:339"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:281;left:415"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:281;left:500"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:281;left:620"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:307;left:242"><nobr><span class="ft14">version</span></nobr></DIV> |
| <DIV style="position:absolute;top:307;left:339"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:307;left:415"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:307;left:620"><nobr><span class="ft5">Contains the Help XML format </span></nobr></DIV> |
| <DIV style="position:absolute;top:321;left:620"><nobr><span class="ft5">version number currently 1.0) for </span></nobr></DIV> |
| <DIV style="position:absolute;top:334;left:620"><nobr><span class="ft5">compatibility to future versions.</span></nobr></DIV> |
| <DIV style="position:absolute;top:358;left:236"><nobr><span class="ft18"><i>Table 17: Attributes of the helpdocument element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:400;left:236"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:426;left:236"><nobr><span class="ft3">none</span></nobr></DIV> |
| <DIV style="position:absolute;top:469;left:236"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:498;left:236"><nobr><span class="ft14">meta</span></nobr></DIV> |
| <DIV style="position:absolute;top:495;left:268"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:498;left:276"><nobr><span class="ft14">body</span></nobr></DIV> |
| <DIV style="position:absolute;top:540;left:236"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:572;left:268"><nobr><span class="ft23"><!ELEMENT helpdocument (meta, body)></span></nobr></DIV> |
| <DIV style="position:absolute;top:586;left:268"><nobr><span class="ft23"><!ATTLIST helpdocument</span></nobr></DIV> |
| <DIV style="position:absolute;top:599;left:268"><nobr><span class="ft23"> version CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:613;left:268"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:646;left:236"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:680;left:267"><nobr><span class="ft4"><b><helpdocument version="1.0"></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:697;left:267"><nobr><span class="ft5"><meta></meta></span></nobr></DIV> |
| <DIV style="position:absolute;top:714;left:267"><nobr><span class="ft5"><body></body></span></nobr></DIV> |
| <DIV style="position:absolute;top:731;left:267"><nobr><span class="ft4"><b></helpdocument></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:773;left:236"><nobr><span class="ft8"><b>Help-id-missing</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:799;left:236"><nobr><span class="ft3">This element is only used to display the help ID for a help file that cannot be found. It </span></nobr></DIV> |
| <DIV style="position:absolute;top:820;left:236"><nobr><span class="ft3">is only used in the help error page and replaced by the missing help ID.</span></nobr></DIV> |
| <DIV style="position:absolute;top:864;left:236"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:895;left:236"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:921;left:236"><nobr><span class="ft3">None</span></nobr></DIV> |
| <DIV style="position:absolute;top:964;left:236"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:996;left:268"><nobr><span class="ft23"><!ELEMENT help-id-missing EMPTY></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>49</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 50 --> |
| <a name="50"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c050.png" alt="background image"> |
| <DIV style="position:absolute;top:153;left:193"><nobr><span class="ft8"><b>History</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:179;left:193"><nobr><span class="ft3">This element contains information about the author and the date of creation, as well </span></nobr></DIV> |
| <DIV style="position:absolute;top:200;left:193"><nobr><span class="ft3">as the same information about the last editing cycle.</span></nobr></DIV> |
| <DIV style="position:absolute;top:244;left:193"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:270;left:193"><nobr><span class="ft3">none</span></nobr></DIV> |
| <DIV style="position:absolute;top:313;left:193"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:339;left:193"><nobr><span class="ft14">meta</span></nobr></DIV> |
| <DIV style="position:absolute;top:382;left:193"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:405;left:193"><nobr><span class="ft14">created</span></nobr></DIV> |
| <DIV style="position:absolute;top:403;left:250"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:405;left:258"><nobr><span class="ft14">lastedited</span></nobr></DIV> |
| <DIV style="position:absolute;top:430;left:193"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:462;left:225"><nobr><span class="ft23"><!ELEMENT history (created, lastedited)></span></nobr></DIV> |
| <DIV style="position:absolute;top:496;left:193"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:529;left:224"><nobr><span class="ft5"><meta></span></nobr></DIV> |
| <DIV style="position:absolute;top:546;left:224"><nobr><span class="ft4"><b> <history></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:563;left:224"><nobr><span class="ft5"> <created date="2002-05-20T15:15:00">New topic created</created></span></nobr></DIV> |
| <DIV style="position:absolute;top:580;left:224"><nobr><span class="ft5"> <lastedited date="2002-06-20T15:15:00">Made changes</created></span></nobr></DIV> |
| <DIV style="position:absolute;top:597;left:224"><nobr><span class="ft4"><b> </history></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:614;left:224"><nobr><span class="ft5"></meta></span></nobr></DIV> |
| <DIV style="position:absolute;top:656;left:193"><nobr><span class="ft8"><b>Image</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:683;left:193"><nobr><span class="ft3">This element carries information about images in the document.</span></nobr></DIV> |
| <DIV style="position:absolute;top:726;left:193"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:762;left:200"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:762;left:296"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:762;left:372"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:762;left:457"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:762;left:577"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:789;left:200"><nobr><span class="ft14">src</span></nobr></DIV> |
| <DIV style="position:absolute;top:789;left:296"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:789;left:372"><nobr><span class="ft5">URL</span></nobr></DIV> |
| <DIV style="position:absolute;top:790;left:577"><nobr><span class="ft5">A URL pointing to the </span></nobr></DIV> |
| <DIV style="position:absolute;top:789;left:695"><nobr><span class="ft9">image as </span></nobr></DIV> |
| <DIV style="position:absolute;top:804;left:577"><nobr><span class="ft9">included in the picture archive </span></nobr></DIV> |
| <DIV style="position:absolute;top:820;left:577"><nobr><span class="ft14">picture.jar</span></nobr></DIV> |
| <DIV style="position:absolute;top:819;left:666"><nobr><span class="ft9">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:848;left:200"><nobr><span class="ft14">width</span></nobr></DIV> |
| <DIV style="position:absolute;top:848;left:296"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:848;left:372"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:848;left:577"><nobr><span class="ft5">The image width. If missing, it is </span></nobr></DIV> |
| <DIV style="position:absolute;top:861;left:577"><nobr><span class="ft5">set to 100%.</span></nobr></DIV> |
| <DIV style="position:absolute;top:888;left:200"><nobr><span class="ft14">height</span></nobr></DIV> |
| <DIV style="position:absolute;top:887;left:296"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:887;left:372"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:887;left:577"><nobr><span class="ft5">The image height. If missing, it is </span></nobr></DIV> |
| <DIV style="position:absolute;top:901;left:577"><nobr><span class="ft5">set to 100%.</span></nobr></DIV> |
| <DIV style="position:absolute;top:927;left:200"><nobr><span class="ft14">id</span></nobr></DIV> |
| <DIV style="position:absolute;top:927;left:296"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:927;left:372"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:927;left:577"><nobr><span class="ft5">A unique ID to identify the image, </span></nobr></DIV> |
| <DIV style="position:absolute;top:941;left:577"><nobr><span class="ft5">see <i><A href="HelpAuthoring_c.html#35">Common Attributes </i></a>on page </span></nobr></DIV> |
| <DIV style="position:absolute;top:954;left:577"><nobr><span class="ft5"><A href="HelpAuthoring_c.html#35">35.</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:980;left:200"><nobr><span class="ft14">localize</span></nobr></DIV> |
| <DIV style="position:absolute;top:980;left:296"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:980;left:372"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:980;left:577"><nobr><span class="ft5">Used to designate images that </span></nobr></DIV> |
| <DIV style="position:absolute;top:994;left:577"><nobr><span class="ft5">need localization. Used by the </span></nobr></DIV> |
| <DIV style="position:absolute;top:1007;left:577"><nobr><span class="ft5">transformation style sheet. Only </span></nobr></DIV> |
| <DIV style="position:absolute;top:1021;left:577"><nobr><span class="ft5">the value </span></nobr></DIV> |
| <DIV style="position:absolute;top:1021;left:629"><nobr><span class="ft14">true</span></nobr></DIV> |
| <DIV style="position:absolute;top:1021;left:662"><nobr><span class="ft5"> is recognized.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1047;left:193"><nobr><span class="ft18"><i>Table 18: Attributes of the image element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>50</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 51 --> |
| <a name="51"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c051.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:236"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:164;left:236"><nobr><span class="ft14">caseinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:162;left:317"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:164;left:325"><nobr><span class="ft14">defaultinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:162;left:430"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:164;left:439"><nobr><span class="ft14">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:162;left:512"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:164;left:520"><nobr><span class="ft14">variable</span></nobr></DIV> |
| <DIV style="position:absolute;top:162;left:585"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:164;left:593"><nobr><span class="ft14">tablecell</span></nobr></DIV> |
| <DIV style="position:absolute;top:206;left:236"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:235;left:236"><nobr><span class="ft14">caption</span></nobr></DIV> |
| <DIV style="position:absolute;top:232;left:292"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:235;left:301"><nobr><span class="ft14">alt</span></nobr></DIV> |
| <DIV style="position:absolute;top:277;left:236"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:309;left:268"><nobr><span class="ft23"><!ELEMENT image (caption* | alt+)?></span></nobr></DIV> |
| <DIV style="position:absolute;top:323;left:268"><nobr><span class="ft23"><!ATTLIST image</span></nobr></DIV> |
| <DIV style="position:absolute;top:336;left:268"><nobr><span class="ft23"> src CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:350;left:268"><nobr><span class="ft23"> width CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:363;left:268"><nobr><span class="ft23"> height CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:377;left:268"><nobr><span class="ft23"> id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:390;left:268"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:424;left:236"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:457;left:267"><nobr><span class="ft4"><b><image src="picture/win/common/writermainwin.xhp" id="img4711" </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:473;left:267"><nobr><span class="ft4"><b>width="75" height="75"></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:490;left:267"><nobr><span class="ft4"><b> </b><caption xml-lang="en-US" id="cp4711"></span></nobr></DIV> |
| <DIV style="position:absolute;top:507;left:267"><nobr><span class="ft5"> The <emph>main writer windows</emph> showing all </span></nobr></DIV> |
| <DIV style="position:absolute;top:524;left:267"><nobr><span class="ft5"> writer toolbars.</span></nobr></DIV> |
| <DIV style="position:absolute;top:541;left:267"><nobr><span class="ft5"> </caption></span></nobr></DIV> |
| <DIV style="position:absolute;top:558;left:267"><nobr><span class="ft5"> <alt xml-lang="en-US" id="alt4711">Main program window</alt></span></nobr></DIV> |
| <DIV style="position:absolute;top:575;left:267"><nobr><span class="ft4"><b></image></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:617;left:236"><nobr><span class="ft8"><b>Item</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:643;left:236"><nobr><span class="ft3">This generic element is used to mark up objects that are to be formatted in a unique </span></nobr></DIV> |
| <DIV style="position:absolute;top:665;left:236"><nobr><span class="ft3">way. The attribute </span></nobr></DIV> |
| <DIV style="position:absolute;top:667;left:362"><nobr><span class="ft14">type</span></nobr></DIV> |
| <DIV style="position:absolute;top:665;left:394"><nobr><span class="ft3"> is used to specify the item type (a keystroke, a menu item, a </span></nobr></DIV> |
| <DIV style="position:absolute;top:687;left:236"><nobr><span class="ft3">dialog title etc). This element resembles the </span></nobr></DIV> |
| <DIV style="position:absolute;top:689;left:529"><nobr><span class="ft14"><span class=""></span></nobr></DIV> |
| <DIV style="position:absolute;top:687;left:651"><nobr><span class="ft3"> element in HTML.</span></nobr></DIV> |
| <DIV style="position:absolute;top:731;left:236"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:768;left:242"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:768;left:339"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:768;left:414"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:768;left:500"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:768;left:620"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:794;left:242"><nobr><span class="ft14">type</span></nobr></DIV> |
| <DIV style="position:absolute;top:794;left:339"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:794;left:620"><nobr><span class="ft5">The item type that is used to </span></nobr></DIV> |
| <DIV style="position:absolute;top:807;left:620"><nobr><span class="ft5">format the data, for example </span></nobr></DIV> |
| <DIV style="position:absolute;top:821;left:620"><nobr><span class="ft5">"menuitem".</span></nobr></DIV> |
| <DIV style="position:absolute;top:845;left:236"><nobr><span class="ft18"><i>Table 19: Attributes of the item element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:886;left:236"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:915;left:236"><nobr><span class="ft14">ahelp</span></nobr></DIV> |
| <DIV style="position:absolute;top:912;left:276"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:915;left:284"><nobr><span class="ft14">caption</span></nobr></DIV> |
| <DIV style="position:absolute;top:912;left:341"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:915;left:350"><nobr><span class="ft14">caseinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:912;left:431"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:915;left:439"><nobr><span class="ft14">defaultinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:912;left:544"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:915;left:552"><nobr><span class="ft14">link</span></nobr></DIV> |
| <DIV style="position:absolute;top:912;left:585"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:915;left:593"><nobr><span class="ft14">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:912;left:666"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:915;left:674"><nobr><span class="ft14">variable</span></nobr></DIV> |
| <DIV style="position:absolute;top:912;left:739"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:915;left:747"><nobr><span class="ft14">emph</span></nobr></DIV> |
| <DIV style="position:absolute;top:957;left:236"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:983;left:236"><nobr><span class="ft3">none</span></nobr></DIV> |
| <DIV style="position:absolute;top:1026;left:236"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:1058;left:268"><nobr><span class="ft23"><!ELEMENT item (#PCDATA)></span></nobr></DIV> |
| <DIV style="position:absolute;top:1072;left:268"><nobr><span class="ft23"><!ATTLIST item</span></nobr></DIV> |
| <DIV style="position:absolute;top:1085;left:268"><nobr><span class="ft23"> type CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1099;left:268"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>51</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 52 --> |
| <a name="52"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c052.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:193"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:169;left:224"><nobr><span class="ft5"><paragraph>You see the <b><item type="dialog">File Open</item></b> dialog. </span></nobr></DIV> |
| <DIV style="position:absolute;top:185;left:224"><nobr><span class="ft5"></paragraph></span></nobr></DIV> |
| <DIV style="position:absolute;top:227;left:193"><nobr><span class="ft8"><b>Lastedited</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:253;left:193"><nobr><span class="ft3">This element contains the date when the document was last edited inside the </span></nobr></DIV> |
| <DIV style="position:absolute;top:255;left:733"><nobr><span class="ft14">date </span></nobr></DIV> |
| <DIV style="position:absolute;top:275;left:193"><nobr><span class="ft3">attribute. Additional information can be specified as PCDATA.</span></nobr></DIV> |
| <DIV style="position:absolute;top:319;left:193"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:355;left:200"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:355;left:294"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:355;left:368"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:355;left:451"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:355;left:568"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:381;left:200"><nobr><span class="ft14">date</span></nobr></DIV> |
| <DIV style="position:absolute;top:381;left:294"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:381;left:368"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:381;left:568"><nobr><span class="ft5">Contains the date when the </span></nobr></DIV> |
| <DIV style="position:absolute;top:395;left:568"><nobr><span class="ft5">document was last edited, in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:408;left:568"><nobr><span class="ft5">format</span></nobr></DIV> |
| <DIV style="position:absolute;top:422;left:568"><nobr><span class="ft14">YYYY-MM-DDThh:mm:ss</span></nobr></DIV> |
| <DIV style="position:absolute;top:437;left:568"><nobr><span class="ft5">where: </span></nobr></DIV> |
| <DIV style="position:absolute;top:450;left:568"><nobr><span class="ft14">YYYY</span></nobr></DIV> |
| <DIV style="position:absolute;top:451;left:601"><nobr><span class="ft5"> = four-digit year</span></nobr></DIV> |
| <DIV style="position:absolute;top:466;left:568"><nobr><span class="ft9"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:466;left:585"><nobr><span class="ft14">MM</span></nobr></DIV> |
| <DIV style="position:absolute;top:466;left:601"><nobr><span class="ft5"> = two-digit month </span></nobr></DIV> |
| <DIV style="position:absolute;top:481;left:568"><nobr><span class="ft9"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:481;left:585"><nobr><span class="ft14">DD</span></nobr></DIV> |
| <DIV style="position:absolute;top:481;left:601"><nobr><span class="ft5"> = two-digit day of month</span></nobr></DIV> |
| <DIV style="position:absolute;top:496;left:568"><nobr><span class="ft9"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:496;left:585"><nobr><span class="ft14">hh</span></nobr></DIV> |
| <DIV style="position:absolute;top:497;left:601"><nobr><span class="ft5"> = two digits of 24 hour</span></nobr></DIV> |
| <DIV style="position:absolute;top:512;left:568"><nobr><span class="ft9"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:512;left:585"><nobr><span class="ft14">mm</span></nobr></DIV> |
| <DIV style="position:absolute;top:512;left:601"><nobr><span class="ft5"> = two digits of minute</span></nobr></DIV> |
| <DIV style="position:absolute;top:527;left:568"><nobr><span class="ft9"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:527;left:585"><nobr><span class="ft14">ss</span></nobr></DIV> |
| <DIV style="position:absolute;top:527;left:601"><nobr><span class="ft5"> = two digits of second</span></nobr></DIV> |
| <DIV style="position:absolute;top:553;left:193"><nobr><span class="ft18"><i>Table 20: Attributes of the lastedited element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:594;left:193"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:620;left:193"><nobr><span class="ft14">history</span></nobr></DIV> |
| <DIV style="position:absolute;top:662;left:193"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:688;left:193"><nobr><span class="ft3">none</span></nobr></DIV> |
| <DIV style="position:absolute;top:732;left:193"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:764;left:225"><nobr><span class="ft23"><!ELEMENT lastedited (#PCDATA)></span></nobr></DIV> |
| <DIV style="position:absolute;top:778;left:225"><nobr><span class="ft23"><!ATTLIST lastedited</span></nobr></DIV> |
| <DIV style="position:absolute;top:791;left:225"><nobr><span class="ft23"> date CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:805;left:225"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:838;left:193"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:872;left:224"><nobr><span class="ft5"><meta></span></nobr></DIV> |
| <DIV style="position:absolute;top:889;left:224"><nobr><span class="ft5"> <history></span></nobr></DIV> |
| <DIV style="position:absolute;top:906;left:224"><nobr><span class="ft5"> <created date="2002-05-20T15:15:00">New topic created</created></span></nobr></DIV> |
| <DIV style="position:absolute;top:923;left:224"><nobr><span class="ft4"><b> <lastedited date="2002-06-20T15:15:00">Made changes</lastedited></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:940;left:224"><nobr><span class="ft5"> </history></span></nobr></DIV> |
| <DIV style="position:absolute;top:957;left:224"><nobr><span class="ft5"></meta></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>52</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 53 --> |
| <a name="53"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c053.png" alt="background image"> |
| <DIV style="position:absolute;top:153;left:236"><nobr><span class="ft8"><b>Link</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:179;left:236"><nobr><span class="ft3">This element contains a link to another document inside or outside the help system. </span></nobr></DIV> |
| <DIV style="position:absolute;top:200;left:236"><nobr><span class="ft3">For links to other help files, the URL syntax is</span></nobr></DIV> |
| <DIV style="position:absolute;top:239;left:236"><nobr><span class="ft14">filename#anchor_target</span></nobr></DIV> |
| <DIV style="position:absolute;top:277;left:236"><nobr><span class="ft3">with</span></nobr></DIV> |
| <DIV style="position:absolute;top:315;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:319;left:290"><nobr><span class="ft14">filename</span></nobr></DIV> |
| <DIV style="position:absolute;top:340;left:290"><nobr><span class="ft3">Path and name of the help file as contained in the help jar archive, for </span></nobr></DIV> |
| <DIV style="position:absolute;top:361;left:290"><nobr><span class="ft3">instance </span></nobr></DIV> |
| <DIV style="position:absolute;top:363;left:350"><nobr><span class="ft14">text/swriter/01/123345.xhp</span></nobr></DIV> |
| <DIV style="position:absolute;top:361;left:560"><nobr><span class="ft3">. </span></nobr></DIV> |
| <DIV style="position:absolute;top:392;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:396;left:290"><nobr><span class="ft14">anchor_target</span></nobr></DIV> |
| <DIV style="position:absolute;top:417;left:290"><nobr><span class="ft3">Anchor target to jump to (optional). These can be the IDs of bookmarks, </span></nobr></DIV> |
| <DIV style="position:absolute;top:438;left:290"><nobr><span class="ft3">sections, or paragraphs.</span></nobr></DIV> |
| <DIV style="position:absolute;top:472;left:236"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:513;left:242"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:513;left:339"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:513;left:417"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:513;left:500"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:513;left:620"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:539;left:242"><nobr><span class="ft14">href</span></nobr></DIV> |
| <DIV style="position:absolute;top:539;left:339"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:539;left:417"><nobr><span class="ft5">URL</span></nobr></DIV> |
| <DIV style="position:absolute;top:539;left:620"><nobr><span class="ft5">This contains the link address as </span></nobr></DIV> |
| <DIV style="position:absolute;top:552;left:620"><nobr><span class="ft5">URL.</span></nobr></DIV> |
| <DIV style="position:absolute;top:579;left:242"><nobr><span class="ft14">name</span></nobr></DIV> |
| <DIV style="position:absolute;top:579;left:339"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:579;left:620"><nobr><span class="ft5">This is the link name, needed to </span></nobr></DIV> |
| <DIV style="position:absolute;top:592;left:620"><nobr><span class="ft5">fulfill accessibility requirements.</span></nobr></DIV> |
| <DIV style="position:absolute;top:618;left:242"><nobr><span class="ft14">type</span></nobr></DIV> |
| <DIV style="position:absolute;top:618;left:339"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:618;left:620"><nobr><span class="ft5">This specifies the link type, for </span></nobr></DIV> |
| <DIV style="position:absolute;top:632;left:620"><nobr><span class="ft5">example, a popup. Currently not </span></nobr></DIV> |
| <DIV style="position:absolute;top:645;left:620"><nobr><span class="ft5">evaluated.</span></nobr></DIV> |
| <DIV style="position:absolute;top:671;left:242"><nobr><span class="ft14">target</span></nobr></DIV> |
| <DIV style="position:absolute;top:671;left:339"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:671;left:620"><nobr><span class="ft5">Can be used to specify a target </span></nobr></DIV> |
| <DIV style="position:absolute;top:685;left:620"><nobr><span class="ft5">frame.</span></nobr></DIV> |
| <DIV style="position:absolute;top:709;left:236"><nobr><span class="ft18"><i>Table 21: Attributes of the link element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:756;left:236"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:789;left:236"><nobr><span class="ft14">ahelp</span></nobr></DIV> |
| <DIV style="position:absolute;top:786;left:276"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:789;left:284"><nobr><span class="ft14">caption</span></nobr></DIV> |
| <DIV style="position:absolute;top:786;left:341"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:789;left:350"><nobr><span class="ft14">caseinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:786;left:431"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:789;left:439"><nobr><span class="ft14">defaultinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:786;left:544"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:789;left:552"><nobr><span class="ft14">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:786;left:625"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:789;left:634"><nobr><span class="ft14">variable</span></nobr></DIV> |
| <DIV style="position:absolute;top:835;left:236"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:868;left:236"><nobr><span class="ft14">emph</span></nobr></DIV> |
| <DIV style="position:absolute;top:866;left:268"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:868;left:276"><nobr><span class="ft14">item</span></nobr></DIV> |
| <DIV style="position:absolute;top:866;left:309"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:868;left:317"><nobr><span class="ft14">variable</span></nobr></DIV> |
| <DIV style="position:absolute;top:866;left:382"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:868;left:390"><nobr><span class="ft14">embedvar</span></nobr></DIV> |
| <DIV style="position:absolute;top:866;left:455"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:868;left:463"><nobr><span class="ft14">switchinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:905;left:236"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:942;left:268"><nobr><span class="ft23"><!ELEMENT link (#PCDATA | embedvar | emph | item | variable | </span></nobr></DIV> |
| <DIV style="position:absolute;top:955;left:268"><nobr><span class="ft23"> switchinline)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:969;left:268"><nobr><span class="ft23"><!ATTLIST link</span></nobr></DIV> |
| <DIV style="position:absolute;top:982;left:268"><nobr><span class="ft23"> href CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:996;left:268"><nobr><span class="ft23"> name CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1010;left:268"><nobr><span class="ft23"> type CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1023;left:268"><nobr><span class="ft23"> target CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1037;left:268"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>53</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 54 --> |
| <a name="54"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c054.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:193"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:169;left:224"><nobr><span class="ft5">Please refer to <b><link href="http://www.openoffice.org" name="Link to </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:185;left:224"><nobr><span class="ft4"><b>the OpenOffice.org Website">the <emph>OpenOffice.org</emph> </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:200;left:224"><nobr><span class="ft4"><b>website</link></b> for further details.</span></nobr></DIV> |
| <DIV style="position:absolute;top:234;left:224"><nobr><span class="ft5">More details can be found in <b><link </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:249;left:224"><nobr><span class="ft4"><b>href="text/common/guide/overview.xhp" name="Link to the overview">the </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:265;left:224"><nobr><span class="ft4"><b>overview</link></b>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:307;left:193"><nobr><span class="ft8"><b>List</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:333;left:193"><nobr><span class="ft3">This element represents ordered (numbered) and unordered (bulleted) lists. The </span></nobr></DIV> |
| <DIV style="position:absolute;top:354;left:193"><nobr><span class="ft3">element itself does not contain any PCDATA, but only child elements that carry the </span></nobr></DIV> |
| <DIV style="position:absolute;top:376;left:193"><nobr><span class="ft3">content or comments.</span></nobr></DIV> |
| <DIV style="position:absolute;top:422;left:193"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:466;left:193"><nobr><span class="ft5"> Note that not all attributes are currently evaluated in the transformation style sheet (see also <i><A href="HelpAuthoring_c.html#16">The</i></a></span></nobr></DIV> |
| <DIV style="position:absolute;top:485;left:214"><nobr><span class="ft15"><A href="HelpAuthoring_c.html#16"><i>Main Transformation Style Sheet</i></a> on <A href="HelpAuthoring_c.html#16">page 16)</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:545;left:200"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:545;left:286"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:545;left:362"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:545;left:438"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:545;left:538"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:571;left:200"><nobr><span class="ft14">type</span></nobr></DIV> |
| <DIV style="position:absolute;top:571;left:286"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:571;left:362"><nobr><span class="ft5">fixed </span></nobr></DIV> |
| <DIV style="position:absolute;top:585;left:362"><nobr><span class="ft5">values</span></nobr></DIV> |
| <DIV style="position:absolute;top:571;left:438"><nobr><span class="ft5">"ordered" or </span></nobr></DIV> |
| <DIV style="position:absolute;top:585;left:438"><nobr><span class="ft5">"unordered"</span></nobr></DIV> |
| <DIV style="position:absolute;top:571;left:538"><nobr><span class="ft5">Describes the list type as either being </span></nobr></DIV> |
| <DIV style="position:absolute;top:585;left:538"><nobr><span class="ft4"><b>ordered</b> (numbered) or <b>unordered </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:598;left:538"><nobr><span class="ft5">(bulleted).</span></nobr></DIV> |
| <DIV style="position:absolute;top:624;left:200"><nobr><span class="ft14">startwith</span></nobr></DIV> |
| <DIV style="position:absolute;top:625;left:286"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:625;left:362"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:625;left:538"><nobr><span class="ft5">The starting number of an ordered list; if </span></nobr></DIV> |
| <DIV style="position:absolute;top:638;left:538"><nobr><span class="ft5">omitted, the list starts with 1.</span></nobr></DIV> |
| <DIV style="position:absolute;top:664;left:200"><nobr><span class="ft14">format</span></nobr></DIV> |
| <DIV style="position:absolute;top:664;left:286"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:664;left:362"><nobr><span class="ft5">fixed </span></nobr></DIV> |
| <DIV style="position:absolute;top:678;left:362"><nobr><span class="ft5">values</span></nobr></DIV> |
| <DIV style="position:absolute;top:664;left:438"><nobr><span class="ft5">"1", "i", "I", "a", </span></nobr></DIV> |
| <DIV style="position:absolute;top:678;left:438"><nobr><span class="ft5">"A"</span></nobr></DIV> |
| <DIV style="position:absolute;top:664;left:538"><nobr><span class="ft5">The number format used in numbered </span></nobr></DIV> |
| <DIV style="position:absolute;top:678;left:538"><nobr><span class="ft5">(ordered) lists:</span></nobr></DIV> |
| <DIV style="position:absolute;top:691;left:538"><nobr><span class="ft5">"1": arabic numerals</span></nobr></DIV> |
| <DIV style="position:absolute;top:704;left:538"><nobr><span class="ft5">"i": small roman numerals</span></nobr></DIV> |
| <DIV style="position:absolute;top:718;left:538"><nobr><span class="ft5">"I": capital roman numerals</span></nobr></DIV> |
| <DIV style="position:absolute;top:731;left:538"><nobr><span class="ft5">"a": small letters</span></nobr></DIV> |
| <DIV style="position:absolute;top:745;left:538"><nobr><span class="ft5">"A": capital letters</span></nobr></DIV> |
| <DIV style="position:absolute;top:758;left:538"><nobr><span class="ft5">If omitted the list uses "1".</span></nobr></DIV> |
| <DIV style="position:absolute;top:784;left:200"><nobr><span class="ft14">bullet</span></nobr></DIV> |
| <DIV style="position:absolute;top:784;left:286"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:784;left:362"><nobr><span class="ft5">fixed </span></nobr></DIV> |
| <DIV style="position:absolute;top:798;left:362"><nobr><span class="ft5">values</span></nobr></DIV> |
| <DIV style="position:absolute;top:784;left:438"><nobr><span class="ft5">"disc", "circle", </span></nobr></DIV> |
| <DIV style="position:absolute;top:798;left:438"><nobr><span class="ft5">"square"</span></nobr></DIV> |
| <DIV style="position:absolute;top:784;left:538"><nobr><span class="ft5">The bullet to be used in bulleted </span></nobr></DIV> |
| <DIV style="position:absolute;top:798;left:538"><nobr><span class="ft5">(unordered) lists.</span></nobr></DIV> |
| <DIV style="position:absolute;top:824;left:200"><nobr><span class="ft14">localize</span></nobr></DIV> |
| <DIV style="position:absolute;top:824;left:286"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:824;left:362"><nobr><span class="ft5">fixed value</span></nobr></DIV> |
| <DIV style="position:absolute;top:824;left:438"><nobr><span class="ft5">"false"</span></nobr></DIV> |
| <DIV style="position:absolute;top:824;left:538"><nobr><span class="ft5">See <i><A href="HelpAuthoring_c.html#35">Common Attributes </i></a>on page <A href="HelpAuthoring_c.html#35">35</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:852;left:200"><nobr><span class="ft14">sorted</span></nobr></DIV> |
| <DIV style="position:absolute;top:852;left:286"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:852;left:362"><nobr><span class="ft5">fixed </span></nobr></DIV> |
| <DIV style="position:absolute;top:866;left:362"><nobr><span class="ft5">values</span></nobr></DIV> |
| <DIV style="position:absolute;top:852;left:438"><nobr><span class="ft5">"asc", "desc"</span></nobr></DIV> |
| <DIV style="position:absolute;top:852;left:538"><nobr><span class="ft5">Specifies whether the list should be </span></nobr></DIV> |
| <DIV style="position:absolute;top:866;left:538"><nobr><span class="ft5">sorted, either ascending or descending. If </span></nobr></DIV> |
| <DIV style="position:absolute;top:879;left:538"><nobr><span class="ft5">this attribute is not given, the list is not </span></nobr></DIV> |
| <DIV style="position:absolute;top:892;left:538"><nobr><span class="ft5">sorted. If it is given, the listitem child </span></nobr></DIV> |
| <DIV style="position:absolute;top:906;left:538"><nobr><span class="ft5">elements are sorted according to the </span></nobr></DIV> |
| <DIV style="position:absolute;top:919;left:538"><nobr><span class="ft5">current locale.</span></nobr></DIV> |
| <DIV style="position:absolute;top:939;left:193"><nobr><span class="ft18"><i>Table 22: Attributes of the list element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:981;left:193"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:1013;left:193"><nobr><span class="ft14">body</span></nobr></DIV> |
| <DIV style="position:absolute;top:1010;left:225"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:1013;left:234"><nobr><span class="ft14">case</span></nobr></DIV> |
| <DIV style="position:absolute;top:1010;left:266"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:1013;left:275"><nobr><span class="ft14">default</span></nobr></DIV> |
| <DIV style="position:absolute;top:1010;left:331"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:1013;left:340"><nobr><span class="ft14">section</span></nobr></DIV> |
| <DIV style="position:absolute;top:1010;left:396"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:1013;left:405"><nobr><span class="ft14">tablecell</span></nobr></DIV> |
| <DIV style="position:absolute;top:1051;left:193"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:1083;left:193"><nobr><span class="ft14">listitem</span></nobr></DIV> |
| <DIV style="position:absolute;top:1080;left:258"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:1083;left:266"><nobr><span class="ft14">comment</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>54</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 55 --> |
| <a name="55"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c055.png" alt="background image"> |
| <DIV style="position:absolute;top:145;left:236"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:178;left:268"><nobr><span class="ft23"><!ELEMENT list (listitem | (comment)*)+></span></nobr></DIV> |
| <DIV style="position:absolute;top:191;left:268"><nobr><span class="ft23"><!ATTLIST list</span></nobr></DIV> |
| <DIV style="position:absolute;top:205;left:268"><nobr><span class="ft23"> type CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:218;left:268"><nobr><span class="ft23"> startwith CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:232;left:268"><nobr><span class="ft23"> format (1 | i | I | a | A) #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:245;left:268"><nobr><span class="ft23"> bullet (disc | circle | square) #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:259;left:268"><nobr><span class="ft23"> localize CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:272;left:268"><nobr><span class="ft23"> sorted (asc | desc) #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:286;left:268"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:332;left:236"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:369;left:267"><nobr><span class="ft4"><b><list type="ordered" startwith="5" format="a"></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:386;left:267"><nobr><span class="ft5"> <listitem>...</listitem></span></nobr></DIV> |
| <DIV style="position:absolute;top:403;left:267"><nobr><span class="ft4"><b></list></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:446;left:236"><nobr><span class="ft8"><b>Listitem</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:472;left:236"><nobr><span class="ft3">This element holds the contents of a </span></nobr></DIV> |
| <DIV style="position:absolute;top:474;left:481"><nobr><span class="ft14">list</span></nobr></DIV> |
| <DIV style="position:absolute;top:472;left:513"><nobr><span class="ft3"> in child elements.</span></nobr></DIV> |
| <DIV style="position:absolute;top:523;left:236"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:581;left:236"><nobr><span class="ft5"> Note that not all attributes are currently evaluated in the transformation style sheet (see also <i><A href="HelpAuthoring_c.html#16">The</i></a></span></nobr></DIV> |
| <DIV style="position:absolute;top:600;left:257"><nobr><span class="ft15"><A href="HelpAuthoring_c.html#16"><i>Main Transformation Style Sheet</i> </a>on page <A href="HelpAuthoring_c.html#16">16</a>)</span></nobr></DIV> |
| <DIV style="position:absolute;top:648;left:242"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:648;left:328"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:648;left:409"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:648;left:489"><nobr><span class="ft16"><b>Values </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:661;left:489"><nobr><span class="ft16"><b>allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:648;left:584"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:688;left:242"><nobr><span class="ft14">format</span></nobr></DIV> |
| <DIV style="position:absolute;top:688;left:328"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:688;left:409"><nobr><span class="ft5">fixed values</span></nobr></DIV> |
| <DIV style="position:absolute;top:688;left:489"><nobr><span class="ft5">"1", "i", "I", "a", </span></nobr></DIV> |
| <DIV style="position:absolute;top:701;left:489"><nobr><span class="ft5">"A"</span></nobr></DIV> |
| <DIV style="position:absolute;top:688;left:584"><nobr><span class="ft5">The number format used in numbered </span></nobr></DIV> |
| <DIV style="position:absolute;top:701;left:584"><nobr><span class="ft5">(ordered) list items:</span></nobr></DIV> |
| <DIV style="position:absolute;top:714;left:584"><nobr><span class="ft5">"1": arabic numerals</span></nobr></DIV> |
| <DIV style="position:absolute;top:728;left:584"><nobr><span class="ft5">"i": small roman numerals</span></nobr></DIV> |
| <DIV style="position:absolute;top:741;left:584"><nobr><span class="ft5">"I": capital roman numerals</span></nobr></DIV> |
| <DIV style="position:absolute;top:755;left:584"><nobr><span class="ft5">"a": small letters</span></nobr></DIV> |
| <DIV style="position:absolute;top:768;left:584"><nobr><span class="ft5">"A": capital letters</span></nobr></DIV> |
| <DIV style="position:absolute;top:782;left:584"><nobr><span class="ft5">If omitted the list item uses the value set </span></nobr></DIV> |
| <DIV style="position:absolute;top:795;left:584"><nobr><span class="ft5">in the list.</span></nobr></DIV> |
| <DIV style="position:absolute;top:821;left:242"><nobr><span class="ft14">bullet</span></nobr></DIV> |
| <DIV style="position:absolute;top:821;left:328"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:821;left:409"><nobr><span class="ft5">fixed values</span></nobr></DIV> |
| <DIV style="position:absolute;top:821;left:489"><nobr><span class="ft5">"disc", "circle", </span></nobr></DIV> |
| <DIV style="position:absolute;top:835;left:489"><nobr><span class="ft5">"square"</span></nobr></DIV> |
| <DIV style="position:absolute;top:821;left:584"><nobr><span class="ft5">The bullet to be used in bulleted </span></nobr></DIV> |
| <DIV style="position:absolute;top:835;left:584"><nobr><span class="ft5">(unordered) list items.</span></nobr></DIV> |
| <DIV style="position:absolute;top:861;left:242"><nobr><span class="ft14">localize</span></nobr></DIV> |
| <DIV style="position:absolute;top:861;left:328"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:861;left:409"><nobr><span class="ft5">fixed value</span></nobr></DIV> |
| <DIV style="position:absolute;top:861;left:489"><nobr><span class="ft5">"false"</span></nobr></DIV> |
| <DIV style="position:absolute;top:861;left:584"><nobr><span class="ft5">S<A href="HelpAuthoring_c.html#35">ee <i>Common Attributes </i></a>on page <A href="HelpAuthoring_c.html#35">35</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:889;left:242"><nobr><span class="ft14">class</span></nobr></DIV> |
| <DIV style="position:absolute;top:889;left:328"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:915;left:236"><nobr><span class="ft18"><i>Table 23: Attributes of the listitem element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:964;left:236"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:994;left:236"><nobr><span class="ft14">list</span></nobr></DIV> |
| <DIV style="position:absolute;top:1043;left:236"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:1075;left:236"><nobr><span class="ft14">comment</span></nobr></DIV> |
| <DIV style="position:absolute;top:1073;left:292"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:1075;left:301"><nobr><span class="ft14">section</span></nobr></DIV> |
| <DIV style="position:absolute;top:1073;left:357"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:1075;left:366"><nobr><span class="ft14">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:1073;left:439"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:1075;left:447"><nobr><span class="ft14">table</span></nobr></DIV> |
| <DIV style="position:absolute;top:1073;left:487"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:1075;left:496"><nobr><span class="ft14">switch</span></nobr></DIV> |
| <DIV style="position:absolute;top:1073;left:544"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:1075;left:553"><nobr><span class="ft14">embed</span></nobr></DIV> |
| <DIV style="position:absolute;top:1073;left:593"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:1075;left:602"><nobr><span class="ft14">bookmark</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>55</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 56 --> |
| <a name="56"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c056.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:193"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:172;left:225"><nobr><span class="ft23"><!ELEMENT listitem (comment | section | paragraph | table | </span></nobr></DIV> |
| <DIV style="position:absolute;top:185;left:225"><nobr><span class="ft23"> switch | embed | bookmark)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:199;left:225"><nobr><span class="ft23"><!ATTLIST listitem</span></nobr></DIV> |
| <DIV style="position:absolute;top:213;left:225"><nobr><span class="ft23"> format (1 | i | I | a | A) #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:226;left:225"><nobr><span class="ft23"> bullet (disc | circle | square) #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:240;left:225"><nobr><span class="ft23"> localize CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:253;left:225"><nobr><span class="ft23"> class CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:267;left:225"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:308;left:193"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:345;left:224"><nobr><span class="ft4"><b><listitem bullet="disc"></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:362;left:224"><nobr><span class="ft5"> <paragraph>Insert the CD.</paragraph></span></nobr></DIV> |
| <DIV style="position:absolute;top:379;left:224"><nobr><span class="ft4"><b></listitem></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:421;left:193"><nobr><span class="ft8"><b>Meta</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:447;left:193"><nobr><span class="ft3">This element contains sub-elements with data used to organize the help.</span></nobr></DIV> |
| <DIV style="position:absolute;top:491;left:193"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:517;left:193"><nobr><span class="ft3">none</span></nobr></DIV> |
| <DIV style="position:absolute;top:555;left:193"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:579;left:193"><nobr><span class="ft14">helpdocument</span></nobr></DIV> |
| <DIV style="position:absolute;top:616;left:193"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:642;left:193"><nobr><span class="ft14">topic</span></nobr></DIV> |
| <DIV style="position:absolute;top:639;left:234"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:642;left:242"><nobr><span class="ft14">history</span></nobr></DIV> |
| <DIV style="position:absolute;top:684;left:193"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:716;left:225"><nobr><span class="ft23"><!ELEMENT meta (topic, history?)></span></nobr></DIV> |
| <DIV style="position:absolute;top:749;left:193"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:783;left:224"><nobr><span class="ft5"><helpdocument></span></nobr></DIV> |
| <DIV style="position:absolute;top:800;left:224"><nobr><span class="ft5"> <b> <meta></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:817;left:224"><nobr><span class="ft5"> <history>...</history></span></nobr></DIV> |
| <DIV style="position:absolute;top:834;left:224"><nobr><span class="ft4"><b> </meta></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:851;left:224"><nobr><span class="ft5"> <body></span></nobr></DIV> |
| <DIV style="position:absolute;top:868;left:224"><nobr><span class="ft5"> </body></span></nobr></DIV> |
| <DIV style="position:absolute;top:885;left:224"><nobr><span class="ft5"></helpdocument></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>56</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 57 --> |
| <a name="57"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c057.png" alt="background image"> |
| <DIV style="position:absolute;top:153;left:236"><nobr><span class="ft8"><b>Object</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:179;left:236"><nobr><span class="ft3">This generic element contains information about objects to be embedded into the help </span></nobr></DIV> |
| <DIV style="position:absolute;top:200;left:236"><nobr><span class="ft3">page like audio or video files. It is reserved for future use.</span></nobr></DIV> |
| <DIV style="position:absolute;top:244;left:236"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:280;left:242"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:280;left:339"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:280;left:413"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:280;left:500"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:280;left:620"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:306;left:242"><nobr><span class="ft14">type</span></nobr></DIV> |
| <DIV style="position:absolute;top:307;left:339"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:307;left:413"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:307;left:620"><nobr><span class="ft5">Specifies the mime type of the </span></nobr></DIV> |
| <DIV style="position:absolute;top:320;left:620"><nobr><span class="ft5">embedded object data.</span></nobr></DIV> |
| <DIV style="position:absolute;top:346;left:242"><nobr><span class="ft14">id</span></nobr></DIV> |
| <DIV style="position:absolute;top:346;left:339"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:346;left:413"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:346;left:620"><nobr><span class="ft5">A unique ID to identify the image, </span></nobr></DIV> |
| <DIV style="position:absolute;top:360;left:620"><nobr><span class="ft5"><A href="HelpAuthoring_c.html#35">see <i>Common Attributes</a> </i>on page </span></nobr></DIV> |
| <DIV style="position:absolute;top:373;left:620"><nobr><span class="ft5"><A href="HelpAuthoring_c.html#35">35</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:399;left:242"><nobr><span class="ft14">data</span></nobr></DIV> |
| <DIV style="position:absolute;top:399;left:339"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:399;left:413"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:399;left:620"><nobr><span class="ft5">Specifies the object file.</span></nobr></DIV> |
| <DIV style="position:absolute;top:427;left:242"><nobr><span class="ft14">height</span></nobr></DIV> |
| <DIV style="position:absolute;top:427;left:339"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:427;left:413"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:427;left:620"><nobr><span class="ft5">Specifies the width of the object.</span></nobr></DIV> |
| <DIV style="position:absolute;top:456;left:242"><nobr><span class="ft14">width</span></nobr></DIV> |
| <DIV style="position:absolute;top:455;left:339"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:455;left:413"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:455;left:620"><nobr><span class="ft5">Specifies the height of the object.</span></nobr></DIV> |
| <DIV style="position:absolute;top:482;left:236"><nobr><span class="ft18"><i>Table 24: Attributes of the object element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:523;left:236"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:551;left:236"><nobr><span class="ft14">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:549;left:309"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:551;left:317"><nobr><span class="ft14">caseinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:549;left:398"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:551;left:406"><nobr><span class="ft14">defaultinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:549;left:512"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:551;left:520"><nobr><span class="ft14">variable</span></nobr></DIV> |
| <DIV style="position:absolute;top:593;left:236"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:619;left:236"><nobr><span class="ft3">none</span></nobr></DIV> |
| <DIV style="position:absolute;top:663;left:236"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:695;left:268"><nobr><span class="ft23"><!ELEMENT object EMPTY></span></nobr></DIV> |
| <DIV style="position:absolute;top:709;left:268"><nobr><span class="ft23"><!ATTLIST object</span></nobr></DIV> |
| <DIV style="position:absolute;top:722;left:268"><nobr><span class="ft23"> type CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:736;left:268"><nobr><span class="ft23"> id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:749;left:268"><nobr><span class="ft23"> data CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:763;left:268"><nobr><span class="ft23"> height CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:776;left:268"><nobr><span class="ft23"> width CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:790;left:268"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:824;left:236"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:857;left:267"><nobr><span class="ft5"><object data="clock.svg" id="objClock" type="image/svg+xml" </span></nobr></DIV> |
| <DIV style="position:absolute;top:872;left:267"><nobr><span class="ft5">width="200" height="200"></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>57</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 58 --> |
| <a name="58"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c058.png" alt="background image"> |
| <DIV style="position:absolute;top:153;left:193"><nobr><span class="ft8"><b>Paragraph</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:179;left:193"><nobr><span class="ft3">This element is the standard element holding content. The </span></nobr></DIV> |
| <DIV style="position:absolute;top:181;left:598"><nobr><span class="ft14">role</span></nobr></DIV> |
| <DIV style="position:absolute;top:179;left:630"><nobr><span class="ft3"> attribute defines its </span></nobr></DIV> |
| <DIV style="position:absolute;top:201;left:193"><nobr><span class="ft3">context in greater detail. See also <i><A href="HelpAuthoring_c.html#24">Paragraph Roles</i> </a>on page<A href="HelpAuthoring_c.html#24"> 24.</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:245;left:193"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:281;left:200"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:281;left:286"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:281;left:364"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:281;left:447"><nobr><span class="ft16"><b>Values </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:295;left:447"><nobr><span class="ft16"><b>allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:281;left:518"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:321;left:200"><nobr><span class="ft14">role</span></nobr></DIV> |
| <DIV style="position:absolute;top:321;left:286"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:321;left:364"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:321;left:518"><nobr><span class="ft5">Describes the current role of the paragraph, </span></nobr></DIV> |
| <DIV style="position:absolute;top:334;left:518"><nobr><span class="ft5">for example a simple paragraph or a heading </span></nobr></DIV> |
| <DIV style="position:absolute;top:348;left:518"><nobr><span class="ft5">or an example or a note. See also <i><A href="HelpAuthoring_c.html#24">Paragraph</i></a></span></nobr></DIV> |
| <DIV style="position:absolute;top:361;left:518"><nobr><span class="ft15"><A href="HelpAuthoring_c.html#24"><i>Roles</i></a> on page <A href="HelpAuthoring_c.html#24">24.</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:387;left:200"><nobr><span class="ft14">level</span></nobr></DIV> |
| <DIV style="position:absolute;top:387;left:286"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:387;left:518"><nobr><span class="ft5">Defines the heading level if the paragraph </span></nobr></DIV> |
| <DIV style="position:absolute;top:401;left:518"><nobr><span class="ft5">role is set to "heading".</span></nobr></DIV> |
| <DIV style="position:absolute;top:427;left:200"><nobr><span class="ft14">id</span></nobr></DIV> |
| <DIV style="position:absolute;top:427;left:286"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:427;left:518"><nobr><span class="ft5">S<A href="HelpAuthoring_c.html#35">ee <i>Common Attributes </i></a>on page <A href="HelpAuthoring_c.html#35">35</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:455;left:200"><nobr><span class="ft14">l10n</span></nobr></DIV> |
| <DIV style="position:absolute;top:455;left:286"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:455;left:518"><nobr><span class="ft5">Contains the localization status of the old </span></nobr></DIV> |
| <DIV style="position:absolute;top:469;left:518"><nobr><span class="ft5">help files and is only used for migration </span></nobr></DIV> |
| <DIV style="position:absolute;top:482;left:518"><nobr><span class="ft5">purposes.</span></nobr></DIV> |
| <DIV style="position:absolute;top:508;left:200"><nobr><span class="ft14">xml-lang</span></nobr></DIV> |
| <DIV style="position:absolute;top:508;left:286"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:508;left:364"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:508;left:518"><nobr><span class="ft5">S<A href="HelpAuthoring_c.html#35">ee <i>Common Attributes </i></a>on page <A href="HelpAuthoring_c.html#35">35</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:536;left:200"><nobr><span class="ft14">oldref</span></nobr></DIV> |
| <DIV style="position:absolute;top:536;left:286"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:536;left:364"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:536;left:518"><nobr><span class="ft5">This contains the reference number used by </span></nobr></DIV> |
| <DIV style="position:absolute;top:550;left:518"><nobr><span class="ft5">the old help files and is only used for </span></nobr></DIV> |
| <DIV style="position:absolute;top:563;left:518"><nobr><span class="ft5">migration purposes. </span></nobr></DIV> |
| <DIV style="position:absolute;top:590;left:200"><nobr><span class="ft14">localize</span></nobr></DIV> |
| <DIV style="position:absolute;top:589;left:286"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:589;left:364"><nobr><span class="ft5">fixed value</span></nobr></DIV> |
| <DIV style="position:absolute;top:589;left:447"><nobr><span class="ft5">"false"</span></nobr></DIV> |
| <DIV style="position:absolute;top:589;left:518"><nobr><span class="ft5">S<A href="HelpAuthoring_c.html#35">ee <i>Common Attributes </i></a>on page <A href="HelpAuthoring_c.html#35">35</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:616;left:193"><nobr><span class="ft18"><i>Table 25: Attributes of the paragraph element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:652;left:193"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:678;left:193"><nobr><span class="ft14">body</span></nobr></DIV> |
| <DIV style="position:absolute;top:675;left:225"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:678;left:234"><nobr><span class="ft14">case</span></nobr></DIV> |
| <DIV style="position:absolute;top:675;left:266"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:678;left:275"><nobr><span class="ft14">default</span></nobr></DIV> |
| <DIV style="position:absolute;top:675;left:331"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:678;left:340"><nobr><span class="ft14">listitem</span></nobr></DIV> |
| <DIV style="position:absolute;top:675;left:404"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:678;left:413"><nobr><span class="ft14">section</span></nobr></DIV> |
| <DIV style="position:absolute;top:675;left:469"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:678;left:478"><nobr><span class="ft14">tablecell</span></nobr></DIV> |
| <DIV style="position:absolute;top:715;left:193"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:740;left:193"><nobr><span class="ft14">image</span></nobr></DIV> |
| <DIV style="position:absolute;top:738;left:234"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:740;left:252"><nobr><span class="ft14">embedvar</span></nobr></DIV> |
| <DIV style="position:absolute;top:738;left:317"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:740;left:336"><nobr><span class="ft14">br</span></nobr></DIV> |
| <DIV style="position:absolute;top:738;left:352"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:740;left:371"><nobr><span class="ft14">emph</span></nobr></DIV> |
| <DIV style="position:absolute;top:738;left:403"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:740;left:422"><nobr><span class="ft14">help-id-missing</span></nobr></DIV> |
| <DIV style="position:absolute;top:738;left:543"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:740;left:562"><nobr><span class="ft14">item</span></nobr></DIV> |
| <DIV style="position:absolute;top:738;left:594"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:740;left:613"><nobr><span class="ft14">link</span></nobr></DIV> |
| <DIV style="position:absolute;top:738;left:645"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:740;left:664"><nobr><span class="ft14">switchinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:738;left:761"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:763;left:193"><nobr><span class="ft14">variable</span></nobr></DIV> |
| <DIV style="position:absolute;top:760;left:258"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:763;left:266"><nobr><span class="ft14">ahelp</span></nobr></DIV> |
| <DIV style="position:absolute;top:760;left:307"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:763;left:315"><nobr><span class="ft14">object</span></nobr></DIV> |
| <DIV style="position:absolute;top:760;left:364"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:763;left:372"><nobr><span class="ft14">bookmark</span></nobr></DIV> |
| <DIV style="position:absolute;top:800;left:193"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:829;left:225"><nobr><span class="ft23"><!ELEMENT paragraph (#PCDATA | image | comment | embedvar | br | </span></nobr></DIV> |
| <DIV style="position:absolute;top:843;left:225"><nobr><span class="ft23"> emph | item | link | switchinline | variable | </span></nobr></DIV> |
| <DIV style="position:absolute;top:856;left:225"><nobr><span class="ft23"> ahelp | object | bookmark)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:870;left:225"><nobr><span class="ft23"><!ATTLIST paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:884;left:225"><nobr><span class="ft23"> role CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:897;left:225"><nobr><span class="ft23"> level CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:911;left:225"><nobr><span class="ft23"> id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:924;left:225"><nobr><span class="ft23"> l10n CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:938;left:225"><nobr><span class="ft23"> xml-lang CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:951;left:225"><nobr><span class="ft23"> oldref CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:965;left:225"><nobr><span class="ft23"> localize CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:979;left:225"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>58</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 59 --> |
| <a name="59"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c059.png" alt="background image"> |
| <DIV style="position:absolute;top:145;left:236"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:179;left:267"><nobr><span class="ft4"><b><paragraph role="heading" level="1" id="par4711_001" xml_lang="en-US"></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:194;left:310"><nobr><span class="ft5">Italic characters</span></nobr></DIV> |
| <DIV style="position:absolute;top:209;left:267"><nobr><span class="ft4"><b></paragraph></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:243;left:267"><nobr><span class="ft4"><b><paragraph role="paragraph" id="par4711_002" xml_lang="en-US"></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:259;left:310"><nobr><span class="ft5">Proceed as follows to write an italic character</span></nobr></DIV> |
| <DIV style="position:absolute;top:274;left:267"><nobr><span class="ft4"><b></paragraph></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:316;left:236"><nobr><span class="ft8"><b>Section</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:342;left:236"><nobr><span class="ft3">This element serves as a generic container for multiple elements to make them able </span></nobr></DIV> |
| <DIV style="position:absolute;top:364;left:236"><nobr><span class="ft3">to be embedded in other documents. Each </span></nobr></DIV> |
| <DIV style="position:absolute;top:366;left:529"><nobr><span class="ft14">section</span></nobr></DIV> |
| <DIV style="position:absolute;top:364;left:585"><nobr><span class="ft3"> takes a unique </span></nobr></DIV> |
| <DIV style="position:absolute;top:365;left:695"><nobr><span class="ft9">ID</span></nobr></DIV> |
| <DIV style="position:absolute;top:364;left:711"><nobr><span class="ft3"> which is used </span></nobr></DIV> |
| <DIV style="position:absolute;top:386;left:236"><nobr><span class="ft3">to identify it when embedded in other documents. Subsections are allowed. A </span></nobr></DIV> |
| <DIV style="position:absolute;top:410;left:236"><nobr><span class="ft14">section</span></nobr></DIV> |
| <DIV style="position:absolute;top:407;left:292"><nobr><span class="ft3"> can only contain sub-elements.</span></nobr></DIV> |
| <DIV style="position:absolute;top:452;left:236"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:488;left:242"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:488;left:339"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:488;left:416"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:488;left:500"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:488;left:620"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:514;left:242"><nobr><span class="ft14">id</span></nobr></DIV> |
| <DIV style="position:absolute;top:514;left:339"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:514;left:620"><nobr><span class="ft5">S<A href="HelpAuthoring_c.html#35">ee <i>Common Attributes</a> </i>on page </span></nobr></DIV> |
| <DIV style="position:absolute;top:528;left:620"><nobr><span class="ft5"><A href="HelpAuthoring_c.html#35">35</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:554;left:242"><nobr><span class="ft14">localize</span></nobr></DIV> |
| <DIV style="position:absolute;top:554;left:339"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:554;left:416"><nobr><span class="ft5">fixed value</span></nobr></DIV> |
| <DIV style="position:absolute;top:554;left:500"><nobr><span class="ft5">"false"</span></nobr></DIV> |
| <DIV style="position:absolute;top:554;left:620"><nobr><span class="ft5">S<A href="HelpAuthoring_c.html#35">ee <i>Common Attributes</a> </i>on page </span></nobr></DIV> |
| <DIV style="position:absolute;top:567;left:620"><nobr><span class="ft5"><A href="HelpAuthoring_c.html#35">35</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:592;left:236"><nobr><span class="ft18"><i>Table 26: Attributes of the section element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:638;left:236"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:670;left:236"><nobr><span class="ft14">body</span></nobr></DIV> |
| <DIV style="position:absolute;top:668;left:268"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:670;left:276"><nobr><span class="ft14">listitem</span></nobr></DIV> |
| <DIV style="position:absolute;top:668;left:341"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:670;left:350"><nobr><span class="ft14">section</span></nobr></DIV> |
| <DIV style="position:absolute;top:668;left:406"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:670;left:414"><nobr><span class="ft14">tablecell</span></nobr></DIV> |
| <DIV style="position:absolute;top:668;left:487"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:670;left:496"><nobr><span class="ft14">case</span></nobr></DIV> |
| <DIV style="position:absolute;top:668;left:528"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:670;left:536"><nobr><span class="ft14">default</span></nobr></DIV> |
| <DIV style="position:absolute;top:722;left:236"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:755;left:236"><nobr><span class="ft14">section</span></nobr></DIV> |
| <DIV style="position:absolute;top:752;left:292"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:755;left:301"><nobr><span class="ft14">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:752;left:374"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:755;left:382"><nobr><span class="ft14">table</span></nobr></DIV> |
| <DIV style="position:absolute;top:752;left:422"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:755;left:431"><nobr><span class="ft14">list</span></nobr></DIV> |
| <DIV style="position:absolute;top:752;left:463"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:755;left:471"><nobr><span class="ft14">comment</span></nobr></DIV> |
| <DIV style="position:absolute;top:752;left:528"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:755;left:536"><nobr><span class="ft14">bookmark</span></nobr></DIV> |
| <DIV style="position:absolute;top:752;left:601"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:755;left:610"><nobr><span class="ft14">embed</span></nobr></DIV> |
| <DIV style="position:absolute;top:752;left:650"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:755;left:658"><nobr><span class="ft14">switch</span></nobr></DIV> |
| <DIV style="position:absolute;top:752;left:707"><nobr><span class="ft3">,</span></nobr></DIV> |
| <DIV style="position:absolute;top:755;left:711"><nobr><span class="ft9"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:755;left:719"><nobr><span class="ft14">sort</span></nobr></DIV> |
| <DIV style="position:absolute;top:803;left:236"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:839;left:268"><nobr><span class="ft23"><!ELEMENT section (section | paragraph | table | list | comment | </span></nobr></DIV> |
| <DIV style="position:absolute;top:853;left:268"><nobr><span class="ft23"> bookmark | embed | switch | sort )*></span></nobr></DIV> |
| <DIV style="position:absolute;top:867;left:268"><nobr><span class="ft23"><!ATTLIST section</span></nobr></DIV> |
| <DIV style="position:absolute;top:880;left:268"><nobr><span class="ft23"> id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:894;left:268"><nobr><span class="ft23"> localize CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:907;left:268"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:949;left:236"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:986;left:267"><nobr><span class="ft4"><b><section id="4711"></b><paragraph>This applies to multiple </span></nobr></DIV> |
| <DIV style="position:absolute;top:1001;left:267"><nobr><span class="ft5">applications</paragraph><b><section></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>59</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 60 --> |
| <a name="60"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c060.png" alt="background image"> |
| <DIV style="position:absolute;top:153;left:193"><nobr><span class="ft8"><b>Sort</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:179;left:193"><nobr><span class="ft3">This element is used to mark up a set of sections that are to be sorted. The sequence </span></nobr></DIV> |
| <DIV style="position:absolute;top:200;left:193"><nobr><span class="ft3">of the sections inside the sort element plays no role for the display sequence.</span></nobr></DIV> |
| <DIV style="position:absolute;top:253;left:193"><nobr><span class="ft5"> Note that sorting does not work for embedded sections.</span></nobr></DIV> |
| <DIV style="position:absolute;top:309;left:193"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:345;left:200"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:345;left:296"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:345;left:374"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:345;left:457"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:345;left:577"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:372;left:200"><nobr><span class="ft14">order</span></nobr></DIV> |
| <DIV style="position:absolute;top:372;left:296"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:372;left:374"><nobr><span class="ft5">fixed values</span></nobr></DIV> |
| <DIV style="position:absolute;top:372;left:457"><nobr><span class="ft5">"asc", "desc"</span></nobr></DIV> |
| <DIV style="position:absolute;top:372;left:577"><nobr><span class="ft5">Defines the sorting order as being </span></nobr></DIV> |
| <DIV style="position:absolute;top:385;left:577"><nobr><span class="ft4"><b>asc</b>ending or <b>desc</b>ending.</span></nobr></DIV> |
| <DIV style="position:absolute;top:409;left:193"><nobr><span class="ft18"><i>Table 27: Attributes of the sort element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:460;left:193"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:492;left:193"><nobr><span class="ft14">body</span></nobr></DIV> |
| <DIV style="position:absolute;top:489;left:225"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:492;left:234"><nobr><span class="ft14">section</span></nobr></DIV> |
| <DIV style="position:absolute;top:541;left:193"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:571;left:193"><nobr><span class="ft14">section</span></nobr></DIV> |
| <DIV style="position:absolute;top:620;left:193"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:656;left:225"><nobr><span class="ft23"><!ELEMENT sort (section+)></span></nobr></DIV> |
| <DIV style="position:absolute;top:669;left:225"><nobr><span class="ft23"><!ATTLIST sort</span></nobr></DIV> |
| <DIV style="position:absolute;top:683;left:225"><nobr><span class="ft23"> order (asc | desc) #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:696;left:225"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:738;left:193"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:775;left:224"><nobr><span class="ft4"><b><sort order="asc"></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:793;left:224"><nobr><span class="ft5"> <section id="123243">...</section></span></nobr></DIV> |
| <DIV style="position:absolute;top:809;left:224"><nobr><span class="ft5"> <section id="24345">...</section></span></nobr></DIV> |
| <DIV style="position:absolute;top:827;left:224"><nobr><span class="ft4"><b></sort></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>60</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 61 --> |
| <a name="61"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c061.png" alt="background image"> |
| <DIV style="position:absolute;top:153;left:236"><nobr><span class="ft8"><b>Switch</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:179;left:236"><nobr><span class="ft3">This element is used to switch </span></nobr></DIV> |
| <DIV style="position:absolute;top:181;left:471"><nobr><span class="ft14">sections</span></nobr></DIV> |
| <DIV style="position:absolute;top:179;left:536"><nobr><span class="ft3"> or </span></nobr></DIV> |
| <DIV style="position:absolute;top:181;left:569"><nobr><span class="ft14">paragraphs</span></nobr></DIV> |
| <DIV style="position:absolute;top:179;left:650"><nobr><span class="ft3"> for different platform, </span></nobr></DIV> |
| <DIV style="position:absolute;top:201;left:236"><nobr><span class="ft3">application, distribution, target medium or language context. For switching content </span></nobr></DIV> |
| <DIV style="position:absolute;top:223;left:236"><nobr><span class="ft3">inside paragraphs, </span></nobr></DIV> |
| <DIV style="position:absolute;top:225;left:363"><nobr><span class="ft14">switchinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:223;left:460"><nobr><span class="ft3"> must be used.</span></nobr></DIV> |
| <DIV style="position:absolute;top:267;left:236"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:303;left:242"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:303;left:339"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:303;left:417"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:303;left:500"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:303;left:620"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:330;left:242"><nobr><span class="ft14">select</span></nobr></DIV> |
| <DIV style="position:absolute;top:330;left:339"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:330;left:417"><nobr><span class="ft5">fixed values</span></nobr></DIV> |
| <DIV style="position:absolute;top:330;left:500"><nobr><span class="ft5">"sys"</span></nobr></DIV> |
| <DIV style="position:absolute;top:343;left:500"><nobr><span class="ft5">"appl"</span></nobr></DIV> |
| <DIV style="position:absolute;top:356;left:500"><nobr><span class="ft5">"distrib"</span></nobr></DIV> |
| <DIV style="position:absolute;top:370;left:500"><nobr><span class="ft5">"target"</span></nobr></DIV> |
| <DIV style="position:absolute;top:383;left:500"><nobr><span class="ft5">"lang"</span></nobr></DIV> |
| <DIV style="position:absolute;top:397;left:500"><nobr><span class="ft5">"ver"</span></nobr></DIV> |
| <DIV style="position:absolute;top:330;left:620"><nobr><span class="ft5">Defines the context that is to be </span></nobr></DIV> |
| <DIV style="position:absolute;top:343;left:620"><nobr><span class="ft5">evaluated, see al<A href="HelpAuthoring_c.html#27">so <i>Switching</i></a></span></nobr></DIV> |
| <DIV style="position:absolute;top:356;left:620"><nobr><span class="ft15"><A href="HelpAuthoring_c.html#27"><i>Content</i> </a>on page <A href="HelpAuthoring_c.html#27">27</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:423;left:242"><nobr><span class="ft14">localize</span></nobr></DIV> |
| <DIV style="position:absolute;top:423;left:339"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:423;left:417"><nobr><span class="ft5">fixed value</span></nobr></DIV> |
| <DIV style="position:absolute;top:423;left:500"><nobr><span class="ft5">"false"</span></nobr></DIV> |
| <DIV style="position:absolute;top:423;left:620"><nobr><span class="ft5">S<A href="HelpAuthoring_c.html#35">ee <i>Common Attributes</a> </i>on page </span></nobr></DIV> |
| <DIV style="position:absolute;top:436;left:620"><nobr><span class="ft5"><A href="HelpAuthoring_c.html#35">35</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:461;left:236"><nobr><span class="ft18"><i>Table 28: Attributes of the switch element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:511;left:236"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:543;left:236"><nobr><span class="ft14">body</span></nobr></DIV> |
| <DIV style="position:absolute;top:541;left:268"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:543;left:276"><nobr><span class="ft14">listitem</span></nobr></DIV> |
| <DIV style="position:absolute;top:541;left:341"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:543;left:350"><nobr><span class="ft14">section</span></nobr></DIV> |
| <DIV style="position:absolute;top:593;left:236"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:625;left:236"><nobr><span class="ft14">case</span></nobr></DIV> |
| <DIV style="position:absolute;top:623;left:268"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:625;left:276"><nobr><span class="ft14">comment</span></nobr></DIV> |
| <DIV style="position:absolute;top:623;left:333"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:625;left:341"><nobr><span class="ft14">default</span></nobr></DIV> |
| <DIV style="position:absolute;top:673;left:236"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:709;left:268"><nobr><span class="ft23"><!ELEMENT switch ((case | comment)* | default?)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:723;left:268"><nobr><span class="ft23"><!ATTLIST switch</span></nobr></DIV> |
| <DIV style="position:absolute;top:736;left:268"><nobr><span class="ft23"> select (sys | appl | distrib | target | lang | ver) #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:750;left:268"><nobr><span class="ft23"> localize CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:764;left:268"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>61</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 62 --> |
| <a name="62"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c062.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:193"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:173;left:224"><nobr><span class="ft4"><b><switch select="sys"></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:190;left:224"><nobr><span class="ft5"> <case select="WIN"></span></nobr></DIV> |
| <DIV style="position:absolute;top:207;left:224"><nobr><span class="ft5"> <paragraph>This appears in Windows.</paragraph></span></nobr></DIV> |
| <DIV style="position:absolute;top:224;left:224"><nobr><span class="ft5"> </case></span></nobr></DIV> |
| <DIV style="position:absolute;top:241;left:224"><nobr><span class="ft5"> <case select="UNIX"></span></nobr></DIV> |
| <DIV style="position:absolute;top:258;left:224"><nobr><span class="ft5"> <paragraph>This appears in Unix.</paragraph></span></nobr></DIV> |
| <DIV style="position:absolute;top:275;left:224"><nobr><span class="ft5"> </case></span></nobr></DIV> |
| <DIV style="position:absolute;top:292;left:224"><nobr><span class="ft5"> <default></span></nobr></DIV> |
| <DIV style="position:absolute;top:309;left:224"><nobr><span class="ft5"> <paragraph>This appears in all other cases</paragraph></span></nobr></DIV> |
| <DIV style="position:absolute;top:326;left:224"><nobr><span class="ft5"> </default></span></nobr></DIV> |
| <DIV style="position:absolute;top:343;left:224"><nobr><span class="ft4"><b></switch></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:386;left:193"><nobr><span class="ft8"><b>Switchinline</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:412;left:193"><nobr><span class="ft3">This element is used to switch parts of </span></nobr></DIV> |
| <DIV style="position:absolute;top:414;left:458"><nobr><span class="ft14">paragraphs</span></nobr></DIV> |
| <DIV style="position:absolute;top:412;left:539"><nobr><span class="ft3"> for different platform, application, </span></nobr></DIV> |
| <DIV style="position:absolute;top:434;left:193"><nobr><span class="ft3">distribution, target medium or language context. For switching complete paragraphs or </span></nobr></DIV> |
| <DIV style="position:absolute;top:455;left:193"><nobr><span class="ft3">sections </span></nobr></DIV> |
| <DIV style="position:absolute;top:458;left:252"><nobr><span class="ft14">switch</span></nobr></DIV> |
| <DIV style="position:absolute;top:455;left:301"><nobr><span class="ft3"> must be used.</span></nobr></DIV> |
| <DIV style="position:absolute;top:500;left:193"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:536;left:200"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:536;left:296"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:536;left:373"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:536;left:457"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:536;left:577"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:562;left:200"><nobr><span class="ft14">select</span></nobr></DIV> |
| <DIV style="position:absolute;top:562;left:296"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:562;left:373"><nobr><span class="ft5">fixed values</span></nobr></DIV> |
| <DIV style="position:absolute;top:562;left:457"><nobr><span class="ft5">"sys", "appl", </span></nobr></DIV> |
| <DIV style="position:absolute;top:576;left:457"><nobr><span class="ft5">"distrib", "target", </span></nobr></DIV> |
| <DIV style="position:absolute;top:589;left:457"><nobr><span class="ft5">"lang", "ver"</span></nobr></DIV> |
| <DIV style="position:absolute;top:562;left:577"><nobr><span class="ft5">Defines the context that is to be </span></nobr></DIV> |
| <DIV style="position:absolute;top:576;left:577"><nobr><span class="ft5">evaluated, see also <i><A href="HelpAuthoring_c.html#27">Switching</i></a></span></nobr></DIV> |
| <DIV style="position:absolute;top:589;left:577"><nobr><span class="ft15"><A href="HelpAuthoring_c.html#27"><i>Content</i></a> on <A href="HelpAuthoring_c.html#27">page 27.</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:613;left:193"><nobr><span class="ft18"><i>Table 29: Attributes of the switchinline element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:655;left:193"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:683;left:193"><nobr><span class="ft14">caption</span></nobr></DIV> |
| <DIV style="position:absolute;top:681;left:250"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:683;left:258"><nobr><span class="ft14">caseinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:681;left:339"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:683;left:347"><nobr><span class="ft14">defaultinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:681;left:453"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:683;left:461"><nobr><span class="ft14">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:681;left:534"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:683;left:542"><nobr><span class="ft14">variable</span></nobr></DIV> |
| <DIV style="position:absolute;top:681;left:607"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:683;left:615"><nobr><span class="ft14">link</span></nobr></DIV> |
| <DIV style="position:absolute;top:725;left:193"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:754;left:193"><nobr><span class="ft14">caseinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:751;left:274"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:754;left:282"><nobr><span class="ft14">defaultinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:796;left:193"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:828;left:225"><nobr><span class="ft23"><!ELEMENT switchinline ((caseinline)+, (defaultinline?)?)></span></nobr></DIV> |
| <DIV style="position:absolute;top:841;left:225"><nobr><span class="ft23"><!ATTLIST switchinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:855;left:225"><nobr><span class="ft23"> select (sys | appl | distrib | target | ver | lang) #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:869;left:225"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:902;left:193"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:935;left:224"><nobr><span class="ft5"><paragraph>Press the </span></nobr></DIV> |
| <DIV style="position:absolute;top:952;left:224"><nobr><span class="ft4"><b> <switchinline select="sys"></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:970;left:224"><nobr><span class="ft5"> <caseinline select="WIN">Ctrl</caseinline></span></nobr></DIV> |
| <DIV style="position:absolute;top:986;left:224"><nobr><span class="ft5"> <caseinline select="MAC">Apple</caseinline></span></nobr></DIV> |
| <DIV style="position:absolute;top:1004;left:224"><nobr><span class="ft5"> <defaultinline>any</defaultinline></span></nobr></DIV> |
| <DIV style="position:absolute;top:1021;left:224"><nobr><span class="ft4"><b> </switchinline> </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1038;left:224"><nobr><span class="ft5"> key to start.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1055;left:224"><nobr><span class="ft5"></paragraph></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>62</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 63 --> |
| <a name="63"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c063.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:236"><nobr><span class="ft8"><b>Table</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:162;left:236"><nobr><span class="ft3">This element defines a table containing one or more </span></nobr></DIV> |
| <DIV style="position:absolute;top:164;left:601"><nobr><span class="ft14">tablerows</span></nobr></DIV> |
| <DIV style="position:absolute;top:162;left:674"><nobr><span class="ft3">. The table element </span></nobr></DIV> |
| <DIV style="position:absolute;top:184;left:236"><nobr><span class="ft3">itself only contains child elements.</span></nobr></DIV> |
| <DIV style="position:absolute;top:228;left:236"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:281;left:236"><nobr><span class="ft5"> Note that not all attributes are currently evaluated in the transformation style sheet (see also <i><A href="HelpAuthoring_c.html#16">The</i></a></span></nobr></DIV> |
| <DIV style="position:absolute;top:301;left:257"><nobr><span class="ft15"><A href="HelpAuthoring_c.html#16"><i>Main Transformation Style Sheet</i> </a>on page <A href="HelpAuthoring_c.html#16">16</a>)</span></nobr></DIV> |
| <DIV style="position:absolute;top:349;left:242"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:349;left:332"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:349;left:408"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:349;left:483"><nobr><span class="ft16"><b>Values </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:362;left:483"><nobr><span class="ft16"><b>allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:349;left:558"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:388;left:242"><nobr><span class="ft14">name</span></nobr></DIV> |
| <DIV style="position:absolute;top:388;left:332"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:388;left:408"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:388;left:558"><nobr><span class="ft5">Contains a table name.</span></nobr></DIV> |
| <DIV style="position:absolute;top:416;left:242"><nobr><span class="ft14">width</span></nobr></DIV> |
| <DIV style="position:absolute;top:416;left:332"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:416;left:408"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:416;left:558"><nobr><span class="ft5">Contains the width of the table in units as </span></nobr></DIV> |
| <DIV style="position:absolute;top:430;left:558"><nobr><span class="ft5">given in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:430;left:622"><nobr><span class="ft9">units</span></nobr></DIV> |
| <DIV style="position:absolute;top:430;left:663"><nobr><span class="ft5"> attribute. If omitted, the </span></nobr></DIV> |
| <DIV style="position:absolute;top:445;left:558"><nobr><span class="ft5">table width is set by the help viewer.</span></nobr></DIV> |
| <DIV style="position:absolute;top:471;left:242"><nobr><span class="ft14">height</span></nobr></DIV> |
| <DIV style="position:absolute;top:471;left:332"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:471;left:408"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:471;left:558"><nobr><span class="ft5">Contains the height of the table in units as </span></nobr></DIV> |
| <DIV style="position:absolute;top:485;left:558"><nobr><span class="ft5">given in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:485;left:622"><nobr><span class="ft9">units</span></nobr></DIV> |
| <DIV style="position:absolute;top:485;left:663"><nobr><span class="ft5"> attribute. If omitted, the </span></nobr></DIV> |
| <DIV style="position:absolute;top:500;left:558"><nobr><span class="ft5">table height is set by the help viewer.</span></nobr></DIV> |
| <DIV style="position:absolute;top:526;left:242"><nobr><span class="ft14">unit</span></nobr></DIV> |
| <DIV style="position:absolute;top:526;left:332"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:526;left:408"><nobr><span class="ft5">fixed </span></nobr></DIV> |
| <DIV style="position:absolute;top:540;left:408"><nobr><span class="ft5">values</span></nobr></DIV> |
| <DIV style="position:absolute;top:526;left:483"><nobr><span class="ft5">"px", "pt", </span></nobr></DIV> |
| <DIV style="position:absolute;top:540;left:483"><nobr><span class="ft5">"cm", "in", </span></nobr></DIV> |
| <DIV style="position:absolute;top:553;left:483"><nobr><span class="ft5">"pct"</span></nobr></DIV> |
| <DIV style="position:absolute;top:527;left:558"><nobr><span class="ft5">Contains the unit to be used for table </span></nobr></DIV> |
| <DIV style="position:absolute;top:526;left:757"><nobr><span class="ft9">width </span></nobr></DIV> |
| <DIV style="position:absolute;top:542;left:558"><nobr><span class="ft5">and </span></nobr></DIV> |
| <DIV style="position:absolute;top:542;left:581"><nobr><span class="ft9">height</span></nobr></DIV> |
| <DIV style="position:absolute;top:542;left:630"><nobr><span class="ft5">:</span></nobr></DIV> |
| <DIV style="position:absolute;top:557;left:558"><nobr><span class="ft5">px = pixels</span></nobr></DIV> |
| <DIV style="position:absolute;top:570;left:558"><nobr><span class="ft5">pt = points</span></nobr></DIV> |
| <DIV style="position:absolute;top:584;left:558"><nobr><span class="ft5">cm = centimeters</span></nobr></DIV> |
| <DIV style="position:absolute;top:597;left:558"><nobr><span class="ft5">in = inches</span></nobr></DIV> |
| <DIV style="position:absolute;top:611;left:558"><nobr><span class="ft5">pct = percent (%)</span></nobr></DIV> |
| <DIV style="position:absolute;top:625;left:558"><nobr><span class="ft5">If omitted, pixels (</span></nobr></DIV> |
| <DIV style="position:absolute;top:624;left:652"><nobr><span class="ft9">px</span></nobr></DIV> |
| <DIV style="position:absolute;top:625;left:668"><nobr><span class="ft5">) are used as units.</span></nobr></DIV> |
| <DIV style="position:absolute;top:652;left:242"><nobr><span class="ft14">class</span></nobr></DIV> |
| <DIV style="position:absolute;top:652;left:332"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:652;left:408"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:652;left:558"><nobr><span class="ft5">Contains a class descriptor for the table </span></nobr></DIV> |
| <DIV style="position:absolute;top:666;left:558"><nobr><span class="ft5">which can be used to assign special formats.</span></nobr></DIV> |
| <DIV style="position:absolute;top:692;left:242"><nobr><span class="ft14">id</span></nobr></DIV> |
| <DIV style="position:absolute;top:692;left:332"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:692;left:408"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:692;left:558"><nobr><span class="ft5">S<A href="HelpAuthoring_c.html#35">ee <i>Common Attributes</a> </i>on <A href="HelpAuthoring_c.html#35">page 35.</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:720;left:242"><nobr><span class="ft14">localize</span></nobr></DIV> |
| <DIV style="position:absolute;top:720;left:332"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:720;left:408"><nobr><span class="ft5">fixed value</span></nobr></DIV> |
| <DIV style="position:absolute;top:720;left:483"><nobr><span class="ft5">"false"</span></nobr></DIV> |
| <DIV style="position:absolute;top:720;left:558"><nobr><span class="ft5">S<A href="HelpAuthoring_c.html#35">ee <i>Common Attributes</a> </i>on <A href="HelpAuthoring_c.html#35">page 35</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:746;left:236"><nobr><span class="ft18"><i>Table 30: Attributes of the table element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:788;left:236"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:816;left:236"><nobr><span class="ft14">body</span></nobr></DIV> |
| <DIV style="position:absolute;top:814;left:268"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:816;left:276"><nobr><span class="ft14">case</span></nobr></DIV> |
| <DIV style="position:absolute;top:814;left:309"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:816;left:317"><nobr><span class="ft14">default</span></nobr></DIV> |
| <DIV style="position:absolute;top:814;left:374"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:816;left:382"><nobr><span class="ft14">listitem</span></nobr></DIV> |
| <DIV style="position:absolute;top:814;left:447"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:816;left:455"><nobr><span class="ft14">section</span></nobr></DIV> |
| <DIV style="position:absolute;top:858;left:236"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:886;left:236"><nobr><span class="ft14">caption</span></nobr></DIV> |
| <DIV style="position:absolute;top:884;left:292"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:886;left:301"><nobr><span class="ft14">tablerow</span></nobr></DIV> |
| <DIV style="position:absolute;top:928;left:236"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:961;left:268"><nobr><span class="ft23"><!ELEMENT table (caption*, tablerow+)></span></nobr></DIV> |
| <DIV style="position:absolute;top:974;left:268"><nobr><span class="ft23"><!ATTLIST table</span></nobr></DIV> |
| <DIV style="position:absolute;top:988;left:268"><nobr><span class="ft23"> name CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1001;left:268"><nobr><span class="ft23"> width CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1015;left:268"><nobr><span class="ft23"> height CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1028;left:268"><nobr><span class="ft23"> unit CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1042;left:268"><nobr><span class="ft23"> class CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1055;left:268"><nobr><span class="ft23"> id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1069;left:268"><nobr><span class="ft23"> localize CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1083;left:268"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>63</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 64 --> |
| <a name="64"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| .ft27{font-size:11px;font-family:Times;color:#000000;} |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c064.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:193"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:169;left:224"><nobr><span class="ft4"><b><table id="tab4711" name="List of Shortcuts" </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:185;left:224"><nobr><span class="ft4"><b> width="90" unit="pct" class="shortcutlist"></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:202;left:224"><nobr><span class="ft5"> <caption></span></nobr></DIV> |
| <DIV style="position:absolute;top:217;left:224"><nobr><span class="ft5"> <paragraph>List of shortcuts</paragraph></span></nobr></DIV> |
| <DIV style="position:absolute;top:234;left:224"><nobr><span class="ft5"> </caption></span></nobr></DIV> |
| <DIV style="position:absolute;top:249;left:224"><nobr><span class="ft5"> <tablerow>...</tablerow></span></nobr></DIV> |
| <DIV style="position:absolute;top:266;left:224"><nobr><span class="ft27"><b></table></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:310;left:193"><nobr><span class="ft8"><b>Tablecell</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:336;left:193"><nobr><span class="ft3">This element contains child elements taking the cell content. Complex tables can be </span></nobr></DIV> |
| <DIV style="position:absolute;top:358;left:193"><nobr><span class="ft3">created using the </span></nobr></DIV> |
| <DIV style="position:absolute;top:360;left:312"><nobr><span class="ft14">rowspan</span></nobr></DIV> |
| <DIV style="position:absolute;top:358;left:369"><nobr><span class="ft3"> and </span></nobr></DIV> |
| <DIV style="position:absolute;top:360;left:402"><nobr><span class="ft14">colspan</span></nobr></DIV> |
| <DIV style="position:absolute;top:358;left:459"><nobr><span class="ft3"> attributes of </span></nobr></DIV> |
| <DIV style="position:absolute;top:360;left:546"><nobr><span class="ft14">tablecell</span></nobr></DIV> |
| <DIV style="position:absolute;top:358;left:619"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:402;left:193"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:456;left:193"><nobr><span class="ft5"> Note that not all attributes are currently evaluated in the transformation style sheet (see also <i><A href="HelpAuthoring_c.html#16">The</i></a></span></nobr></DIV> |
| <DIV style="position:absolute;top:475;left:214"><nobr><span class="ft15"><A href="HelpAuthoring_c.html#16"><i>Main Transformation Style Sheet</i></a> on <A href="HelpAuthoring_c.html#16">page 16)</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:523;left:200"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:523;left:296"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:523;left:375"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:523;left:457"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:523;left:577"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:549;left:200"><nobr><span class="ft14">colspan</span></nobr></DIV> |
| <DIV style="position:absolute;top:549;left:296"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:549;left:375"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:549;left:577"><nobr><span class="ft5">Contains the number of columns </span></nobr></DIV> |
| <DIV style="position:absolute;top:563;left:577"><nobr><span class="ft5">spanned by this cell. If omitted, </span></nobr></DIV> |
| <DIV style="position:absolute;top:576;left:577"><nobr><span class="ft5">the cell spans 1 column.</span></nobr></DIV> |
| <DIV style="position:absolute;top:602;left:200"><nobr><span class="ft14">rowspan</span></nobr></DIV> |
| <DIV style="position:absolute;top:602;left:296"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:602;left:375"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:602;left:577"><nobr><span class="ft5">Contains the number of rows </span></nobr></DIV> |
| <DIV style="position:absolute;top:616;left:577"><nobr><span class="ft5">spanned by this cell. If omitted, </span></nobr></DIV> |
| <DIV style="position:absolute;top:629;left:577"><nobr><span class="ft5">the cell spans 1 row.</span></nobr></DIV> |
| <DIV style="position:absolute;top:656;left:200"><nobr><span class="ft14">width</span></nobr></DIV> |
| <DIV style="position:absolute;top:655;left:296"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:655;left:375"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:655;left:577"><nobr><span class="ft5">Contains the width of the table </span></nobr></DIV> |
| <DIV style="position:absolute;top:669;left:577"><nobr><span class="ft5">cell in units as given in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:682;left:577"><nobr><span class="ft9">units</span></nobr></DIV> |
| <DIV style="position:absolute;top:683;left:618"><nobr><span class="ft5"> attribute. If omitted, the </span></nobr></DIV> |
| <DIV style="position:absolute;top:698;left:577"><nobr><span class="ft5">table cell width is set by the help </span></nobr></DIV> |
| <DIV style="position:absolute;top:711;left:577"><nobr><span class="ft5">viewer.</span></nobr></DIV> |
| <DIV style="position:absolute;top:737;left:200"><nobr><span class="ft14">unit</span></nobr></DIV> |
| <DIV style="position:absolute;top:737;left:296"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:737;left:375"><nobr><span class="ft5">fixed values</span></nobr></DIV> |
| <DIV style="position:absolute;top:737;left:457"><nobr><span class="ft5">"px", "pt", "cm", "in", </span></nobr></DIV> |
| <DIV style="position:absolute;top:751;left:457"><nobr><span class="ft5">"pct"</span></nobr></DIV> |
| <DIV style="position:absolute;top:737;left:577"><nobr><span class="ft5">Contains the unit to be used for </span></nobr></DIV> |
| <DIV style="position:absolute;top:751;left:577"><nobr><span class="ft9">width</span></nobr></DIV> |
| <DIV style="position:absolute;top:751;left:618"><nobr><span class="ft5">:</span></nobr></DIV> |
| <DIV style="position:absolute;top:766;left:577"><nobr><span class="ft5">px = pixels</span></nobr></DIV> |
| <DIV style="position:absolute;top:779;left:577"><nobr><span class="ft5">pt = points</span></nobr></DIV> |
| <DIV style="position:absolute;top:793;left:577"><nobr><span class="ft5">cm = centimeters</span></nobr></DIV> |
| <DIV style="position:absolute;top:806;left:577"><nobr><span class="ft5">in = inches</span></nobr></DIV> |
| <DIV style="position:absolute;top:820;left:577"><nobr><span class="ft5">pct = percent (%)</span></nobr></DIV> |
| <DIV style="position:absolute;top:833;left:577"><nobr><span class="ft5">If omitted, pixels (</span></nobr></DIV> |
| <DIV style="position:absolute;top:833;left:671"><nobr><span class="ft9">px</span></nobr></DIV> |
| <DIV style="position:absolute;top:833;left:687"><nobr><span class="ft5">) are used as </span></nobr></DIV> |
| <DIV style="position:absolute;top:848;left:577"><nobr><span class="ft5">units.</span></nobr></DIV> |
| <DIV style="position:absolute;top:875;left:200"><nobr><span class="ft14">class</span></nobr></DIV> |
| <DIV style="position:absolute;top:875;left:296"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:875;left:375"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:875;left:577"><nobr><span class="ft5">Contains a class descriptor for the </span></nobr></DIV> |
| <DIV style="position:absolute;top:888;left:577"><nobr><span class="ft5">table cell, which can be used to </span></nobr></DIV> |
| <DIV style="position:absolute;top:902;left:577"><nobr><span class="ft5">assign special formats.</span></nobr></DIV> |
| <DIV style="position:absolute;top:928;left:200"><nobr><span class="ft14">localize</span></nobr></DIV> |
| <DIV style="position:absolute;top:928;left:296"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:928;left:375"><nobr><span class="ft5">fixed value</span></nobr></DIV> |
| <DIV style="position:absolute;top:928;left:457"><nobr><span class="ft5">"false"</span></nobr></DIV> |
| <DIV style="position:absolute;top:928;left:577"><nobr><span class="ft5">See <i><A href="HelpAuthoring_c.html#35">Common Attributes </i></a>on page </span></nobr></DIV> |
| <DIV style="position:absolute;top:941;left:577"><nobr><span class="ft5"><A href="HelpAuthoring_c.html#35">35</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:965;left:193"><nobr><span class="ft18"><i>Table 31: Attributes of the tablecell element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:1012;left:193"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:1041;left:193"><nobr><span class="ft14">tablerow</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>64</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 65 --> |
| <a name="65"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c065.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:236"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:168;left:236"><nobr><span class="ft14">section</span></nobr></DIV> |
| <DIV style="position:absolute;top:166;left:292"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:168;left:301"><nobr><span class="ft14">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:166;left:374"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:168;left:382"><nobr><span class="ft14">comment</span></nobr></DIV> |
| <DIV style="position:absolute;top:166;left:439"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:168;left:447"><nobr><span class="ft14">embed</span></nobr></DIV> |
| <DIV style="position:absolute;top:166;left:487"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:168;left:496"><nobr><span class="ft14">bookmark</span></nobr></DIV> |
| <DIV style="position:absolute;top:166;left:561"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:168;left:569"><nobr><span class="ft14">image</span></nobr></DIV> |
| <DIV style="position:absolute;top:166;left:609"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:168;left:618"><nobr><span class="ft14">list</span></nobr></DIV> |
| <DIV style="position:absolute;top:223;left:236"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:259;left:268"><nobr><span class="ft23"><!ELEMENT tablecell (section | paragraph | comment | embed | </span></nobr></DIV> |
| <DIV style="position:absolute;top:272;left:268"><nobr><span class="ft23"> bookmark | image | list)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:286;left:268"><nobr><span class="ft23"><!ATTLIST tablecell</span></nobr></DIV> |
| <DIV style="position:absolute;top:299;left:268"><nobr><span class="ft23"> colspan CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:313;left:268"><nobr><span class="ft23"> rowspan CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:326;left:268"><nobr><span class="ft23"> width CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:340;left:268"><nobr><span class="ft23"> class CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:353;left:268"><nobr><span class="ft23"> unit CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:367;left:268"><nobr><span class="ft23"> localize CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:381;left:268"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:414;left:236"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:448;left:267"><nobr><span class="ft5"><table </span></nobr></DIV> |
| <DIV style="position:absolute;top:463;left:267"><nobr><span class="ft5"> id="tab_4711" name="List of Shortcuts" </span></nobr></DIV> |
| <DIV style="position:absolute;top:478;left:267"><nobr><span class="ft5"> width="90" unit="pct" class="shortcutlist"></span></nobr></DIV> |
| <DIV style="position:absolute;top:495;left:267"><nobr><span class="ft5"> <tablerow></span></nobr></DIV> |
| <DIV style="position:absolute;top:512;left:267"><nobr><span class="ft5"> <b> <tablecell>Column 1</tablecell></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:529;left:267"><nobr><span class="ft4"><b> <tablecell>Column 2</tablecell></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:546;left:267"><nobr><span class="ft4"><b> <tablecell>Column 3</tablecell></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:563;left:267"><nobr><span class="ft5"> </tablerow></span></nobr></DIV> |
| <DIV style="position:absolute;top:579;left:267"><nobr><span class="ft5"> <tablerow></span></nobr></DIV> |
| <DIV style="position:absolute;top:596;left:267"><nobr><span class="ft4"><b> <tablecell colspan="2"></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:613;left:267"><nobr><span class="ft5"> This cell spans 2 columns, namely column 1 and 2</span></nobr></DIV> |
| <DIV style="position:absolute;top:630;left:267"><nobr><span class="ft4"><b> </tablecell></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:647;left:267"><nobr><span class="ft4"><b> <tablecell></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:664;left:267"><nobr><span class="ft5"> This cell spans 1 column, namely column 3</span></nobr></DIV> |
| <DIV style="position:absolute;top:681;left:267"><nobr><span class="ft4"><b> </tablecell></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:698;left:267"><nobr><span class="ft5"> </tablerow></span></nobr></DIV> |
| <DIV style="position:absolute;top:715;left:267"><nobr><span class="ft9"></table></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>65</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 66 --> |
| <a name="66"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c066.png" alt="background image"> |
| <DIV style="position:absolute;top:153;left:193"><nobr><span class="ft8"><b>Tablerow</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:179;left:193"><nobr><span class="ft3">This element contains table rows, which themselves only contain table cells.</span></nobr></DIV> |
| <DIV style="position:absolute;top:223;left:193"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:259;left:200"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:259;left:296"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:259;left:379"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:259;left:457"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:259;left:577"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:285;left:200"><nobr><span class="ft14">height</span></nobr></DIV> |
| <DIV style="position:absolute;top:285;left:296"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:285;left:379"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:285;left:577"><nobr><span class="ft5">Contains the height of the table </span></nobr></DIV> |
| <DIV style="position:absolute;top:299;left:577"><nobr><span class="ft5">row in units as given in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:312;left:577"><nobr><span class="ft9">units</span></nobr></DIV> |
| <DIV style="position:absolute;top:312;left:618"><nobr><span class="ft5"> attribute. If omitted, the </span></nobr></DIV> |
| <DIV style="position:absolute;top:327;left:577"><nobr><span class="ft5">table row height is set by the help </span></nobr></DIV> |
| <DIV style="position:absolute;top:341;left:577"><nobr><span class="ft5">viewer.</span></nobr></DIV> |
| <DIV style="position:absolute;top:367;left:200"><nobr><span class="ft14">unit</span></nobr></DIV> |
| <DIV style="position:absolute;top:367;left:296"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:367;left:379"><nobr><span class="ft5">fixed values</span></nobr></DIV> |
| <DIV style="position:absolute;top:367;left:457"><nobr><span class="ft5">"px", "pt", "cm", "in", </span></nobr></DIV> |
| <DIV style="position:absolute;top:380;left:457"><nobr><span class="ft5">"pct"</span></nobr></DIV> |
| <DIV style="position:absolute;top:367;left:577"><nobr><span class="ft5">Contains the unit to be used for </span></nobr></DIV> |
| <DIV style="position:absolute;top:380;left:577"><nobr><span class="ft9">height</span></nobr></DIV> |
| <DIV style="position:absolute;top:381;left:626"><nobr><span class="ft5">:</span></nobr></DIV> |
| <DIV style="position:absolute;top:396;left:577"><nobr><span class="ft5">px = pixels</span></nobr></DIV> |
| <DIV style="position:absolute;top:409;left:577"><nobr><span class="ft5">pt = points</span></nobr></DIV> |
| <DIV style="position:absolute;top:422;left:577"><nobr><span class="ft5">cm = centimeters</span></nobr></DIV> |
| <DIV style="position:absolute;top:436;left:577"><nobr><span class="ft5">in = inches</span></nobr></DIV> |
| <DIV style="position:absolute;top:449;left:577"><nobr><span class="ft5">pct = percent (%)</span></nobr></DIV> |
| <DIV style="position:absolute;top:463;left:577"><nobr><span class="ft5">If omitted, pixels (</span></nobr></DIV> |
| <DIV style="position:absolute;top:463;left:671"><nobr><span class="ft9">px</span></nobr></DIV> |
| <DIV style="position:absolute;top:463;left:687"><nobr><span class="ft5">) are used as </span></nobr></DIV> |
| <DIV style="position:absolute;top:478;left:577"><nobr><span class="ft5">units.</span></nobr></DIV> |
| <DIV style="position:absolute;top:504;left:200"><nobr><span class="ft14">class</span></nobr></DIV> |
| <DIV style="position:absolute;top:504;left:296"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:504;left:379"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:504;left:577"><nobr><span class="ft5">Contains a class descriptor for the </span></nobr></DIV> |
| <DIV style="position:absolute;top:518;left:577"><nobr><span class="ft5">table row which can be used to </span></nobr></DIV> |
| <DIV style="position:absolute;top:531;left:577"><nobr><span class="ft5">assign special formats.</span></nobr></DIV> |
| <DIV style="position:absolute;top:557;left:200"><nobr><span class="ft14">localize</span></nobr></DIV> |
| <DIV style="position:absolute;top:557;left:296"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:557;left:379"><nobr><span class="ft5">fixed value</span></nobr></DIV> |
| <DIV style="position:absolute;top:557;left:457"><nobr><span class="ft5">"false"</span></nobr></DIV> |
| <DIV style="position:absolute;top:557;left:577"><nobr><span class="ft5">See <i><A href="HelpAuthoring_c.html#35">Common Attributes </i></a>on page </span></nobr></DIV> |
| <DIV style="position:absolute;top:571;left:577"><nobr><span class="ft5"><A href="HelpAuthoring_c.html#35">35</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:595;left:193"><nobr><span class="ft18"><i>Table 32: Attributes of the tablerow element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:637;left:193"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:663;left:193"><nobr><span class="ft14">table</span></nobr></DIV> |
| <DIV style="position:absolute;top:705;left:193"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:731;left:193"><nobr><span class="ft14">tablecell</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>66</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 67 --> |
| <a name="67"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c067.png" alt="background image"> |
| <DIV style="position:absolute;top:145;left:236"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:178;left:268"><nobr><span class="ft23"><!ELEMENT tablerow (tablecell+)></span></nobr></DIV> |
| <DIV style="position:absolute;top:191;left:268"><nobr><span class="ft23"><!ATTLIST tablerow</span></nobr></DIV> |
| <DIV style="position:absolute;top:205;left:268"><nobr><span class="ft23"> height CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:218;left:268"><nobr><span class="ft23"> class CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:232;left:268"><nobr><span class="ft23"> unit CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:245;left:268"><nobr><span class="ft23"> localize CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:259;left:268"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:293;left:236"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:326;left:267"><nobr><span class="ft5"><table id="tab_4711" name="List of Shortcuts" </span></nobr></DIV> |
| <DIV style="position:absolute;top:341;left:267"><nobr><span class="ft5"> width="90" unit="pct" class="shortcutlist"></span></nobr></DIV> |
| <DIV style="position:absolute;top:358;left:267"><nobr><span class="ft4"><b> <tablerow></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:375;left:267"><nobr><span class="ft5"> <tablecell>Column 1</tablecell></span></nobr></DIV> |
| <DIV style="position:absolute;top:392;left:267"><nobr><span class="ft5"> <tablecell>Column 2</tablecell></span></nobr></DIV> |
| <DIV style="position:absolute;top:409;left:267"><nobr><span class="ft5"> <tablecell>Column 3</tablecell></span></nobr></DIV> |
| <DIV style="position:absolute;top:426;left:267"><nobr><span class="ft4"><b> </tablerow></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:443;left:267"><nobr><span class="ft9"></table></span></nobr></DIV> |
| <DIV style="position:absolute;top:487;left:236"><nobr><span class="ft8"><b>Title</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:514;left:236"><nobr><span class="ft3">This is the title of the help page as displayed in the list on the </span></nobr></DIV> |
| <DIV style="position:absolute;top:515;left:644"><nobr><span class="ft11"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:514;left:716"><nobr><span class="ft3"> tab page, the </span></nobr></DIV> |
| <DIV style="position:absolute;top:537;left:236"><nobr><span class="ft11"><b>Index</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:536;left:281"><nobr><span class="ft3"> list and the search results. The title content can<i>not</i> contain HTML entities like </span></nobr></DIV> |
| <DIV style="position:absolute;top:561;left:236"><nobr><span class="ft14">&apos;</span></nobr></DIV> |
| <DIV style="position:absolute;top:559;left:284"><nobr><span class="ft3"> or </span></nobr></DIV> |
| <DIV style="position:absolute;top:561;left:306"><nobr><span class="ft14">&amp;</span></nobr></DIV> |
| <DIV style="position:absolute;top:559;left:346"><nobr><span class="ft3">. </span></nobr></DIV> |
| <DIV style="position:absolute;top:603;left:236"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:640;left:242"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:640;left:339"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:640;left:413"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:640;left:500"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:640;left:620"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:666;left:242"><nobr><span class="ft14">xml-lang</span></nobr></DIV> |
| <DIV style="position:absolute;top:666;left:339"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:666;left:413"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:666;left:620"><nobr><span class="ft5">S<A href="HelpAuthoring_c.html#35">ee <i>Common Attributes</a> </i>on page </span></nobr></DIV> |
| <DIV style="position:absolute;top:679;left:620"><nobr><span class="ft5"><A href="HelpAuthoring_c.html#35">35</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:706;left:242"><nobr><span class="ft14">id</span></nobr></DIV> |
| <DIV style="position:absolute;top:706;left:339"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:706;left:413"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:706;left:620"><nobr><span class="ft5">S<A href="HelpAuthoring_c.html#35">ee <i>Common Attributes</a> </i>on page </span></nobr></DIV> |
| <DIV style="position:absolute;top:719;left:620"><nobr><span class="ft5"><A href="HelpAuthoring_c.html#35">35</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:745;left:242"><nobr><span class="ft14">localize</span></nobr></DIV> |
| <DIV style="position:absolute;top:745;left:339"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:745;left:413"><nobr><span class="ft5">fixed value</span></nobr></DIV> |
| <DIV style="position:absolute;top:745;left:500"><nobr><span class="ft5">"false"</span></nobr></DIV> |
| <DIV style="position:absolute;top:745;left:620"><nobr><span class="ft5">S<A href="HelpAuthoring_c.html#35">ee <i>Common Attributes</a> </i>on page </span></nobr></DIV> |
| <DIV style="position:absolute;top:759;left:620"><nobr><span class="ft5"><A href="HelpAuthoring_c.html#35">35</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:783;left:236"><nobr><span class="ft18"><i>Table 33: Attributes of the title element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:824;left:236"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:850;left:236"><nobr><span class="ft14">topic</span></nobr></DIV> |
| <DIV style="position:absolute;top:892;left:236"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:918;left:236"><nobr><span class="ft3">none</span></nobr></DIV> |
| <DIV style="position:absolute;top:962;left:236"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:994;left:268"><nobr><span class="ft23"><!ELEMENT title (#PCDATA)></span></nobr></DIV> |
| <DIV style="position:absolute;top:1008;left:268"><nobr><span class="ft23"><!ATTLIST title</span></nobr></DIV> |
| <DIV style="position:absolute;top:1021;left:268"><nobr><span class="ft23"> xml-lang CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1035;left:268"><nobr><span class="ft23"> id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1048;left:268"><nobr><span class="ft23"> localize CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1062;left:268"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>67</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 68 --> |
| <a name="68"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c068.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:193"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:169;left:224"><nobr><span class="ft5"><topic></span></nobr></DIV> |
| <DIV style="position:absolute;top:186;left:224"><nobr><span class="ft5"> <b><title xml_lang="en-US" id="tit1233">Opening a text document</title></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:203;left:224"><nobr><span class="ft5"></topic></span></nobr></DIV> |
| <DIV style="position:absolute;top:246;left:193"><nobr><span class="ft8"><b>Topic</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:272;left:193"><nobr><span class="ft3">This element contains child elements with information about the current help topic.</span></nobr></DIV> |
| <DIV style="position:absolute;top:315;left:193"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:352;left:200"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:352;left:296"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:352;left:371"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:352;left:457"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:352;left:577"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:378;left:200"><nobr><span class="ft14">id</span></nobr></DIV> |
| <DIV style="position:absolute;top:378;left:296"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:378;left:371"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:378;left:577"><nobr><span class="ft5">See <i><A href="HelpAuthoring_c.html#35">Common Attributes </i></a>on page </span></nobr></DIV> |
| <DIV style="position:absolute;top:391;left:577"><nobr><span class="ft5"><A href="HelpAuthoring_c.html#35">35.</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:417;left:200"><nobr><span class="ft14">indexer</span></nobr></DIV> |
| <DIV style="position:absolute;top:418;left:296"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:418;left:371"><nobr><span class="ft5">fixed value</span></nobr></DIV> |
| <DIV style="position:absolute;top:418;left:457"><nobr><span class="ft5">"exclude", "include"</span></nobr></DIV> |
| <DIV style="position:absolute;top:418;left:577"><nobr><span class="ft5">Specifies whether the current file </span></nobr></DIV> |
| <DIV style="position:absolute;top:431;left:577"><nobr><span class="ft5">is to be excluded from the </span></nobr></DIV> |
| <DIV style="position:absolute;top:444;left:577"><nobr><span class="ft5">indexing process. An excluded file </span></nobr></DIV> |
| <DIV style="position:absolute;top:458;left:577"><nobr><span class="ft5">cannot be found using the help </span></nobr></DIV> |
| <DIV style="position:absolute;top:471;left:577"><nobr><span class="ft5">search facility.</span></nobr></DIV> |
| <DIV style="position:absolute;top:495;left:193"><nobr><span class="ft18"><i>Table 34: Attributes of the topic element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:537;left:193"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:563;left:193"><nobr><span class="ft14">meta</span></nobr></DIV> |
| <DIV style="position:absolute;top:605;left:193"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:633;left:193"><nobr><span class="ft14">title</span></nobr></DIV> |
| <DIV style="position:absolute;top:631;left:234"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:633;left:242"><nobr><span class="ft14">bookmark</span></nobr></DIV> |
| <DIV style="position:absolute;top:631;left:307"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:633;left:315"><nobr><span class="ft14">filename</span></nobr></DIV> |
| <DIV style="position:absolute;top:675;left:193"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:707;left:225"><nobr><span class="ft23"><!ELEMENT topic (title+, filename, bookmark*)></span></nobr></DIV> |
| <DIV style="position:absolute;top:721;left:225"><nobr><span class="ft23"><!ATTLIST topic</span></nobr></DIV> |
| <DIV style="position:absolute;top:735;left:225"><nobr><span class="ft23"> id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:748;left:225"><nobr><span class="ft23"> indexer (exclude | include) #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:762;left:225"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:795;left:193"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:829;left:224"><nobr><span class="ft4"><b><topic id="4711" indexer="exclude"></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:846;left:224"><nobr><span class="ft5"> <title xml_lang="en-US">Invisible help file</title></span></nobr></DIV> |
| <DIV style="position:absolute;top:863;left:224"><nobr><span class="ft5"> <filename>text/swriter/01/08154711</filename></span></nobr></DIV> |
| <DIV style="position:absolute;top:880;left:224"><nobr><span class="ft4"><b></topic></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>68</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 69 --> |
| <a name="69"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c069.png" alt="background image"> |
| <DIV style="position:absolute;top:153;left:236"><nobr><span class="ft8"><b>Variable</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:179;left:236"><nobr><span class="ft3">This element is used to define reusable text fragments. The fragments can be </span></nobr></DIV> |
| <DIV style="position:absolute;top:200;left:236"><nobr><span class="ft3">embedded in other contexts by means of the </span></nobr></DIV> |
| <DIV style="position:absolute;top:203;left:536"><nobr><span class="ft14">embedvar</span></nobr></DIV> |
| <DIV style="position:absolute;top:200;left:600"><nobr><span class="ft3"> element.</span></nobr></DIV> |
| <DIV style="position:absolute;top:245;left:236"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:281;left:242"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:281;left:340"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:281;left:422"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:281;left:499"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:281;left:619"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:307;left:242"><nobr><span class="ft14">id</span></nobr></DIV> |
| <DIV style="position:absolute;top:307;left:340"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:307;left:422"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:307;left:619"><nobr><span class="ft5">S<A href="HelpAuthoring_c.html#35">ee <i>Common Attributes </i></a>on page </span></nobr></DIV> |
| <DIV style="position:absolute;top:321;left:619"><nobr><span class="ft5"><A href="HelpAuthoring_c.html#35">35.</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:347;left:242"><nobr><span class="ft14">visibility</span></nobr></DIV> |
| <DIV style="position:absolute;top:347;left:340"><nobr><span class="ft5">no</span></nobr></DIV> |
| <DIV style="position:absolute;top:347;left:422"><nobr><span class="ft5">fixed values</span></nobr></DIV> |
| <DIV style="position:absolute;top:347;left:499"><nobr><span class="ft5">"hidden", "visible"</span></nobr></DIV> |
| <DIV style="position:absolute;top:347;left:619"><nobr><span class="ft5">Specifies whether the element </span></nobr></DIV> |
| <DIV style="position:absolute;top:361;left:619"><nobr><span class="ft5">content will be shown in the help </span></nobr></DIV> |
| <DIV style="position:absolute;top:374;left:619"><nobr><span class="ft5">viewer. If this attribute is omitted, </span></nobr></DIV> |
| <DIV style="position:absolute;top:387;left:619"><nobr><span class="ft5">the variable will be <b>visible</b>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:412;left:236"><nobr><span class="ft18"><i>Table 35: Attributes of the variable element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:460;left:236"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:492;left:236"><nobr><span class="ft14">ahelp</span></nobr></DIV> |
| <DIV style="position:absolute;top:490;left:276"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:492;left:284"><nobr><span class="ft14">caption</span></nobr></DIV> |
| <DIV style="position:absolute;top:490;left:341"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:492;left:350"><nobr><span class="ft14">caseinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:490;left:431"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:492;left:439"><nobr><span class="ft14">defaultinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:490;left:544"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:492;left:552"><nobr><span class="ft14">link</span></nobr></DIV> |
| <DIV style="position:absolute;top:490;left:585"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:492;left:593"><nobr><span class="ft14">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:490;left:666"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:492;left:674"><nobr><span class="ft14">variable</span></nobr></DIV> |
| <DIV style="position:absolute;top:542;left:236"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:574;left:236"><nobr><span class="ft14">ahelp</span></nobr></DIV> |
| <DIV style="position:absolute;top:571;left:276"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:574;left:284"><nobr><span class="ft14">embedvar</span></nobr></DIV> |
| <DIV style="position:absolute;top:571;left:349"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:574;left:358"><nobr><span class="ft14">br</span></nobr></DIV> |
| <DIV style="position:absolute;top:571;left:374"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:574;left:382"><nobr><span class="ft14">emph</span></nobr></DIV> |
| <DIV style="position:absolute;top:571;left:414"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:574;left:423"><nobr><span class="ft14">item</span></nobr></DIV> |
| <DIV style="position:absolute;top:571;left:455"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:574;left:464"><nobr><span class="ft14">link</span></nobr></DIV> |
| <DIV style="position:absolute;top:571;left:496"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:574;left:504"><nobr><span class="ft14">variable</span></nobr></DIV> |
| <DIV style="position:absolute;top:571;left:569"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:574;left:577"><nobr><span class="ft14">image</span></nobr></DIV> |
| <DIV style="position:absolute;top:571;left:618"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:574;left:626"><nobr><span class="ft14">object</span></nobr></DIV> |
| <DIV style="position:absolute;top:571;left:675"><nobr><span class="ft3">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:574;left:683"><nobr><span class="ft14">switchinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:623;left:236"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:659;left:268"><nobr><span class="ft23"><!ELEMENT variable (#PCDATA | ahelp | embedvar | br | emph | </span></nobr></DIV> |
| <DIV style="position:absolute;top:673;left:268"><nobr><span class="ft23"> item | link | variable | image | object | </span></nobr></DIV> |
| <DIV style="position:absolute;top:686;left:268"><nobr><span class="ft23"> switchinline)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:700;left:268"><nobr><span class="ft23"><!ATTLIST variable</span></nobr></DIV> |
| <DIV style="position:absolute;top:713;left:268"><nobr><span class="ft23"> id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:727;left:268"><nobr><span class="ft23"> visibility (hidden | visible) #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:740;left:268"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:781;left:236"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:818;left:267"><nobr><span class="ft5">You may use the <b><variable id="dlg_FileOpen"></b><item type="dialog">Open a </span></nobr></DIV> |
| <DIV style="position:absolute;top:834;left:267"><nobr><span class="ft5">file</item><b></variable></b> to open a file.</span></nobr></DIV> |
| <DIV style="position:absolute;top:868;left:267"><nobr><span class="ft5"><comment>List of menu names to be embedded</comment></span></nobr></DIV> |
| <DIV style="position:absolute;top:885;left:267"><nobr><span class="ft5"><paragraph xml_lang="en-US"></span></nobr></DIV> |
| <DIV style="position:absolute;top:902;left:267"><nobr><span class="ft4"><b><variable id="menu_File" visibility="hidden">File Menu</variable></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:919;left:267"><nobr><span class="ft4"><b><variable id="menu_Edit" visibility="hidden">Edit Menu</variable></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:936;left:267"><nobr><span class="ft4"><b><variable id="menu_View" visibility="hidden">View Menu</variable></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:953;left:267"><nobr><span class="ft5"></paragraph></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>69</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 70 --> |
| <a name="70"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c070.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:193"><nobr><span class="ft10"><b>Contents File (*.tree) Elements</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:171;left:193"><nobr><span class="ft3">The contents files (</span></nobr></DIV> |
| <DIV style="position:absolute;top:174;left:334"><nobr><span class="ft14">*.tree</span></nobr></DIV> |
| <DIV style="position:absolute;top:171;left:383"><nobr><span class="ft3">) are used to specify the hierarchy displayed on the </span></nobr></DIV> |
| <DIV style="position:absolute;top:195;left:193"><nobr><span class="ft11"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:194;left:265"><nobr><span class="ft3"> tab page of the help viewer (see also<A href="HelpAuthoring_c.html#10"> <i>Hierarchical List of Contents</i> </a>on page </span></nobr></DIV> |
| <DIV style="position:absolute;top:216;left:193"><nobr><span class="ft3"><A href="HelpAuthoring_c.html#10">10)</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:268;left:193"><nobr><span class="ft8"><b>Tree_view</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:294;left:193"><nobr><span class="ft3">This is the root element for a contents file.</span></nobr></DIV> |
| <DIV style="position:absolute;top:337;left:193"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:373;left:200"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:373;left:278"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:373;left:353"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:373;left:437"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:373;left:577"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:400;left:200"><nobr><span class="ft14">version</span></nobr></DIV> |
| <DIV style="position:absolute;top:400;left:278"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:400;left:353"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:426;left:193"><nobr><span class="ft18"><i>Table 36: Attributes of the tree_view element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:474;left:193"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:504;left:193"><nobr><span class="ft9">none</span></nobr></DIV> |
| <DIV style="position:absolute;top:553;left:193"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:583;left:193"><nobr><span class="ft14">help_section</span></nobr></DIV> |
| <DIV style="position:absolute;top:633;left:193"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:668;left:225"><nobr><span class="ft23"><!ELEMENT tree_view (help_section)+></span></nobr></DIV> |
| <DIV style="position:absolute;top:696;left:225"><nobr><span class="ft23"><!ATTLIST tree_view</span></nobr></DIV> |
| <DIV style="position:absolute;top:709;left:225"><nobr><span class="ft23"> version CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:723;left:225"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:764;left:193"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:801;left:224"><nobr><span class="ft4"><b><tree_view version="24-Aug-2004"></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:818;left:224"><nobr><span class="ft5"> <help_section application="swriter" id="01" title="Installation"></span></nobr></DIV> |
| <DIV style="position:absolute;top:835;left:224"><nobr><span class="ft5"> ...</span></nobr></DIV> |
| <DIV style="position:absolute;top:852;left:224"><nobr><span class="ft5"> </help_section></span></nobr></DIV> |
| <DIV style="position:absolute;top:869;left:224"><nobr><span class="ft4"><b></tree_view></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>70</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 71 --> |
| <a name="71"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c071.png" alt="background image"> |
| <DIV style="position:absolute;top:153;left:236"><nobr><span class="ft8"><b>Help_section</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:179;left:236"><nobr><span class="ft3">The </span></nobr></DIV> |
| <DIV style="position:absolute;top:181;left:267"><nobr><span class="ft14">help_sections</span></nobr></DIV> |
| <DIV style="position:absolute;top:179;left:372"><nobr><span class="ft3"> are the top-most elements in the table of contents as displayed </span></nobr></DIV> |
| <DIV style="position:absolute;top:201;left:236"><nobr><span class="ft3">by the help viewer.</span></nobr></DIV> |
| <DIV style="position:absolute;top:240;left:236"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:276;left:242"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:276;left:348"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:276;left:430"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:276;left:515"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:276;left:632"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:302;left:242"><nobr><span class="ft14">application</span></nobr></DIV> |
| <DIV style="position:absolute;top:302;left:348"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:302;left:430"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:302;left:632"><nobr><span class="ft5">Designates the help module </span></nobr></DIV> |
| <DIV style="position:absolute;top:315;left:632"><nobr><span class="ft5">that a help_section is referring </span></nobr></DIV> |
| <DIV style="position:absolute;top:329;left:632"><nobr><span class="ft5">to</span></nobr></DIV> |
| <DIV style="position:absolute;top:355;left:242"><nobr><span class="ft14">id</span></nobr></DIV> |
| <DIV style="position:absolute;top:355;left:348"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:355;left:430"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:383;left:242"><nobr><span class="ft14">title</span></nobr></DIV> |
| <DIV style="position:absolute;top:383;left:348"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:383;left:430"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:383;left:632"><nobr><span class="ft5">This is the title of a </span></nobr></DIV> |
| <DIV style="position:absolute;top:397;left:632"><nobr><span class="ft5">help_section as displayed in </span></nobr></DIV> |
| <DIV style="position:absolute;top:410;left:632"><nobr><span class="ft5">the help viewer</span></nobr></DIV> |
| <DIV style="position:absolute;top:434;left:236"><nobr><span class="ft18"><i>Table 37: Attributes of the help_section element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:470;left:236"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:494;left:236"><nobr><span class="ft14">tree_view</span></nobr></DIV> |
| <DIV style="position:absolute;top:531;left:236"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:554;left:236"><nobr><span class="ft14">node</span></nobr></DIV> |
| <DIV style="position:absolute;top:554;left:268"><nobr><span class="ft9">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:554;left:284"><nobr><span class="ft14">topic</span></nobr></DIV> |
| <DIV style="position:absolute;top:591;left:236"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:621;left:268"><nobr><span class="ft23"><!ELEMENT help_section (node|topic)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:648;left:268"><nobr><span class="ft23"><!ATTLIST help_section</span></nobr></DIV> |
| <DIV style="position:absolute;top:662;left:268"><nobr><span class="ft23"> application CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:675;left:268"><nobr><span class="ft23"> id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:689;left:268"><nobr><span class="ft23"> title CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:702;left:268"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:731;left:236"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:762;left:267"><nobr><span class="ft5"><tree_view version="24-Aug-2004"></span></nobr></DIV> |
| <DIV style="position:absolute;top:779;left:267"><nobr><span class="ft4"><b> <help_section application="swriter" id="01" title="Installation"></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:796;left:267"><nobr><span class="ft5"> ...</span></nobr></DIV> |
| <DIV style="position:absolute;top:813;left:267"><nobr><span class="ft4"><b> </help_section></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:830;left:267"><nobr><span class="ft5"></tree_view></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>71</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 72 --> |
| <a name="72"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c072.png" alt="background image"> |
| <DIV style="position:absolute;top:153;left:193"><nobr><span class="ft8"><b>Node</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:179;left:193"><nobr><span class="ft3">Nodes are the hierarchical elements that represent topic groups and contain help </span></nobr></DIV> |
| <DIV style="position:absolute;top:200;left:193"><nobr><span class="ft3">topics. In the help viewer, they are represented by book icons. Nodes can have </span></nobr></DIV> |
| <DIV style="position:absolute;top:222;left:193"><nobr><span class="ft3">subnodes.</span></nobr></DIV> |
| <DIV style="position:absolute;top:265;left:193"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:302;left:200"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:302;left:296"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:302;left:371"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:302;left:460"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:302;left:577"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:328;left:200"><nobr><span class="ft14">id</span></nobr></DIV> |
| <DIV style="position:absolute;top:328;left:296"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:328;left:371"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:356;left:200"><nobr><span class="ft14">title</span></nobr></DIV> |
| <DIV style="position:absolute;top:356;left:296"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:356;left:371"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:356;left:577"><nobr><span class="ft5">This is the title of a node as </span></nobr></DIV> |
| <DIV style="position:absolute;top:369;left:577"><nobr><span class="ft5">displayed in the help viewer</span></nobr></DIV> |
| <DIV style="position:absolute;top:394;left:193"><nobr><span class="ft18"><i>Table 38: Attributes of the node element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:442;left:193"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:472;left:193"><nobr><span class="ft14">help_section</span></nobr></DIV> |
| <DIV style="position:absolute;top:521;left:193"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:551;left:193"><nobr><span class="ft14">node</span></nobr></DIV> |
| <DIV style="position:absolute;top:551;left:225"><nobr><span class="ft9">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:551;left:242"><nobr><span class="ft14">topic</span></nobr></DIV> |
| <DIV style="position:absolute;top:601;left:193"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:636;left:225"><nobr><span class="ft23"><!ELEMENT node (topic)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:664;left:225"><nobr><span class="ft23"><!ATTLIST node</span></nobr></DIV> |
| <DIV style="position:absolute;top:677;left:225"><nobr><span class="ft23"> id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:691;left:225"><nobr><span class="ft23"> title CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:704;left:225"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:745;left:193"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:782;left:224"><nobr><span class="ft5"><tree_view version="24-Aug-2004"></span></nobr></DIV> |
| <DIV style="position:absolute;top:799;left:224"><nobr><span class="ft5"> <help_section application="swriter" id="10" title="Common Topics"></span></nobr></DIV> |
| <DIV style="position:absolute;top:816;left:224"><nobr><span class="ft4"><b> <node id="1001" title="General Information"></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:833;left:224"><nobr><span class="ft5"> <topic id="shared/text/shared/main0400.xhp">Shortcut </span></nobr></DIV> |
| <DIV style="position:absolute;top:849;left:224"><nobr><span class="ft5">Keys</topic></span></nobr></DIV> |
| <DIV style="position:absolute;top:866;left:224"><nobr><span class="ft5"> ...</span></nobr></DIV> |
| <DIV style="position:absolute;top:883;left:224"><nobr><span class="ft4"><b> </node></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:900;left:224"><nobr><span class="ft5"> </help_section></span></nobr></DIV> |
| <DIV style="position:absolute;top:917;left:224"><nobr><span class="ft5"></tree_view></span></nobr></DIV> |
| <DIV style="position:absolute;top:959;left:193"><nobr><span class="ft8"><b>Topic</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:985;left:193"><nobr><span class="ft3">Topics are links that point to help files. The </span></nobr></DIV> |
| <DIV style="position:absolute;top:987;left:486"><nobr><span class="ft14">id</span></nobr></DIV> |
| <DIV style="position:absolute;top:985;left:502"><nobr><span class="ft3"> attribute contains the URL of the file to </span></nobr></DIV> |
| <DIV style="position:absolute;top:1007;left:193"><nobr><span class="ft3">be loaded. The element contains the file title.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1060;left:193"><nobr><span class="ft5"> When the script </span></nobr></DIV> |
| <DIV style="position:absolute;top:1060;left:313"><nobr><span class="ft14">update_tree.pl</span></nobr></DIV> |
| <DIV style="position:absolute;top:1061;left:427"><nobr><span class="ft5"> from the </span></nobr></DIV> |
| <DIV style="position:absolute;top:1060;left:489"><nobr><span class="ft14">helpers</span></nobr></DIV> |
| <DIV style="position:absolute;top:1061;left:546"><nobr><span class="ft5"> directory in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:1060;left:647"><nobr><span class="ft14">helpcontent2 </span></nobr></DIV> |
| <DIV style="position:absolute;top:1080;left:214"><nobr><span class="ft5">module is used to update the tree files, the element content is automatically updated based on the </span></nobr></DIV> |
| <DIV style="position:absolute;top:1098;left:214"><nobr><span class="ft5">file titles. This also applies to localized languages.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>72</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 73 --> |
| <a name="73"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c073.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:236"><nobr><span class="ft25"><i>Attributes</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:170;left:242"><nobr><span class="ft16"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:170;left:338"><nobr><span class="ft16"><b>Required</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:170;left:413"><nobr><span class="ft16"><b>Contents</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:170;left:503"><nobr><span class="ft16"><b>Values allowed</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:170;left:619"><nobr><span class="ft16"><b>Description</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:196;left:242"><nobr><span class="ft14">id</span></nobr></DIV> |
| <DIV style="position:absolute;top:196;left:338"><nobr><span class="ft5">yes</span></nobr></DIV> |
| <DIV style="position:absolute;top:196;left:413"><nobr><span class="ft5">CDATA</span></nobr></DIV> |
| <DIV style="position:absolute;top:222;left:236"><nobr><span class="ft18"><i>Table 39: Attributes of the topic element</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:258;left:236"><nobr><span class="ft25"><i>Parent Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:282;left:236"><nobr><span class="ft14">help_section</span></nobr></DIV> |
| <DIV style="position:absolute;top:282;left:333"><nobr><span class="ft9">, </span></nobr></DIV> |
| <DIV style="position:absolute;top:282;left:349"><nobr><span class="ft14">node</span></nobr></DIV> |
| <DIV style="position:absolute;top:319;left:236"><nobr><span class="ft25"><i>Child Elements</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:342;left:236"><nobr><span class="ft9">none</span></nobr></DIV> |
| <DIV style="position:absolute;top:379;left:236"><nobr><span class="ft25"><i>Element Definition</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:409;left:268"><nobr><span class="ft23"><!ELEMENT topic (#PCDATA)></span></nobr></DIV> |
| <DIV style="position:absolute;top:436;left:268"><nobr><span class="ft23"><!ATTLIST topic</span></nobr></DIV> |
| <DIV style="position:absolute;top:450;left:268"><nobr><span class="ft23"> id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:463;left:268"><nobr><span class="ft23">></span></nobr></DIV> |
| <DIV style="position:absolute;top:504;left:236"><nobr><span class="ft25"><i>Example</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:541;left:267"><nobr><span class="ft5"><tree_view version="24-Aug-2004"></span></nobr></DIV> |
| <DIV style="position:absolute;top:558;left:267"><nobr><span class="ft5"> <help_section application="swriter" id="10" title="Common Topics"></span></nobr></DIV> |
| <DIV style="position:absolute;top:575;left:267"><nobr><span class="ft5"> <node id="1001" title="General Information"></span></nobr></DIV> |
| <DIV style="position:absolute;top:592;left:267"><nobr><span class="ft4"><b> <topic id="shared/text/shared/main0400.xhp">Shortcut </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:607;left:267"><nobr><span class="ft4"><b>Keys</topic></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:625;left:267"><nobr><span class="ft5"> ...</span></nobr></DIV> |
| <DIV style="position:absolute;top:641;left:267"><nobr><span class="ft5"> </node></span></nobr></DIV> |
| <DIV style="position:absolute;top:659;left:267"><nobr><span class="ft5"> </help_section></span></nobr></DIV> |
| <DIV style="position:absolute;top:676;left:267"><nobr><span class="ft5"></tree_view></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>73</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 74 --> |
| <a name="74"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c074.png" alt="background image"> |
| </DIV> |
| <!-- Page 75 --> |
| <a name="75"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c075.png" alt="background image"> |
| <DIV style="position:absolute;top:345;left:128"><nobr><span class="ft7">4 Authoring Help With OpenOffice.org </span></nobr></DIV> |
| <DIV style="position:absolute;top:400;left:236"><nobr><span class="ft5"> You need OpenOffice.org 1.1.x to use the help authoring environment. The authoring environment </span></nobr></DIV> |
| <DIV style="position:absolute;top:420;left:257"><nobr><span class="ft5">also is not yet compatible with OpenOffice.org 2.0.</span></nobr></DIV> |
| <DIV style="position:absolute;top:482;left:236"><nobr><span class="ft10"><b>Setting Up the Environment </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:516;left:236"><nobr><span class="ft3">There is an import/export filter available that allows for direct editing of OpenOffice.org </span></nobr></DIV> |
| <DIV style="position:absolute;top:538;left:236"><nobr><span class="ft3">help files without the need of extra conversion steps. The following describes how you </span></nobr></DIV> |
| <DIV style="position:absolute;top:559;left:236"><nobr><span class="ft3">set up the filter.</span></nobr></DIV> |
| <DIV style="position:absolute;top:598;left:236"><nobr><span class="ft3">The filters are xsl files that are used in conjunction with an import template and takes </span></nobr></DIV> |
| <DIV style="position:absolute;top:619;left:236"><nobr><span class="ft3">advantage of OpenOffice.org xsl filter functionality.</span></nobr></DIV> |
| <DIV style="position:absolute;top:672;left:236"><nobr><span class="ft5"> The help files use the extension <b>xhp</b>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:736;left:236"><nobr><span class="ft8"><b>Directory Hierarchy</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:761;left:236"><nobr><span class="ft3">The correct function of the help authoring environment with OpenOffice.org relies on </span></nobr></DIV> |
| <DIV style="position:absolute;top:783;left:236"><nobr><span class="ft3">the CVS module directory layout. Since all help file and image references are </span></nobr></DIV> |
| <DIV style="position:absolute;top:804;left:236"><nobr><span class="ft3">expressed relatively, the environment needs to know the absolute paths to be able to </span></nobr></DIV> |
| <DIV style="position:absolute;top:826;left:236"><nobr><span class="ft3">assemble and disassemble the references correctly for display in OpenOffice.org.</span></nobr></DIV> |
| <DIV style="position:absolute;top:864;left:236"><nobr><span class="ft3">Us the following directory structure when checking out the modules from CVS. If you </span></nobr></DIV> |
| <DIV style="position:absolute;top:886;left:236"><nobr><span class="ft3">work in a Child Workspace, this is the default directory layout:</span></nobr></DIV> |
| <DIV style="position:absolute;top:931;left:268"><nobr><span class="ft14">$root</span></nobr></DIV> |
| <DIV style="position:absolute;top:946;left:268"><nobr><span class="ft14">|__default_images <-- check out from CVS</span></nobr></DIV> |
| <DIV style="position:absolute;top:961;left:268"><nobr><span class="ft14">|__helpcontent2 <-- check out from CVS</span></nobr></DIV> |
| <DIV style="position:absolute;top:975;left:310"><nobr><span class="ft14">|__helpers</span></nobr></DIV> |
| <DIV style="position:absolute;top:990;left:310"><nobr><span class="ft14">|__util</span></nobr></DIV> |
| <DIV style="position:absolute;top:1004;left:310"><nobr><span class="ft14">|__prj</span></nobr></DIV> |
| <DIV style="position:absolute;top:1019;left:310"><nobr><span class="ft14">|__source</span></nobr></DIV> |
| <DIV style="position:absolute;top:1034;left:363"><nobr><span class="ft14">|__text</span></nobr></DIV> |
| <DIV style="position:absolute;top:1048;left:363"><nobr><span class="ft14">|__auxiliary</span></nobr></DIV> |
| <DIV style="position:absolute;top:1079;left:236"><nobr><span class="ft3">Before you set up the environment you need to select and create a root directory for </span></nobr></DIV> |
| <DIV style="position:absolute;top:1100;left:236"><nobr><span class="ft3">working on the help files (</span></nobr></DIV> |
| <DIV style="position:absolute;top:1103;left:406"><nobr><span class="ft14">$root</span></nobr></DIV> |
| <DIV style="position:absolute;top:1100;left:446"><nobr><span class="ft3">), for example: </span></nobr></DIV> |
| <DIV style="position:absolute;top:1103;left:546"><nobr><span class="ft14">/opt/ooohelp</span></nobr></DIV> |
| <DIV style="position:absolute;top:1100;left:643"><nobr><span class="ft3"> or </span></nobr></DIV> |
| <DIV style="position:absolute;top:1103;left:665"><nobr><span class="ft14">D:\ooohelp</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>75</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 76 --> |
| <a name="76"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c076.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:193"><nobr><span class="ft25"><i>Creating the image directory</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:162;left:193"><nobr><span class="ft3">The CVS module </span></nobr></DIV> |
| <DIV style="position:absolute;top:164;left:311"><nobr><span class="ft14">default_images</span></nobr></DIV> |
| <DIV style="position:absolute;top:162;left:425"><nobr><span class="ft3"> contains all images thatare used by the help.</span></nobr></DIV> |
| <DIV style="position:absolute;top:202;left:220"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:203;left:247"><nobr><span class="ft3">Check out the module </span></nobr></DIV> |
| <DIV style="position:absolute;top:206;left:409"><nobr><span class="ft14">default_images</span></nobr></DIV> |
| <DIV style="position:absolute;top:203;left:522"><nobr><span class="ft3"> from OpenOffice.org CVS into the </span></nobr></DIV> |
| <DIV style="position:absolute;top:226;left:247"><nobr><span class="ft3">help root directory (as described above).</span></nobr></DIV> |
| <DIV style="position:absolute;top:270;left:193"><nobr><span class="ft25"><i>Creating the help files directory</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:296;left:220"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:297;left:247"><nobr><span class="ft3">Check out the module </span></nobr></DIV> |
| <DIV style="position:absolute;top:300;left:401"><nobr><span class="ft14">helpcontent2</span></nobr></DIV> |
| <DIV style="position:absolute;top:297;left:498"><nobr><span class="ft3"> from OpenOffice.org CVS into the help </span></nobr></DIV> |
| <DIV style="position:absolute;top:320;left:247"><nobr><span class="ft3">root directory (as described above).</span></nobr></DIV> |
| <DIV style="position:absolute;top:371;left:193"><nobr><span class="ft8"><b>Installing The Import/Export Filters</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:397;left:193"><nobr><span class="ft3">Ensure that the XML Filter option is installed in OpenOffice.org. If this option is not </span></nobr></DIV> |
| <DIV style="position:absolute;top:419;left:193"><nobr><span class="ft3">installed, install it using the option from the the OpenOffice.org setup. </span></nobr></DIV> |
| <DIV style="position:absolute;top:457;left:220"><nobr><span class="ft3">1. Get the filter package from the </span></nobr></DIV> |
| <DIV style="position:absolute;top:460;left:479"><nobr><span class="ft14">helpers/helpauthoring</span></nobr></DIV> |
| <DIV style="position:absolute;top:457;left:649"><nobr><span class="ft3"> directory of the </span></nobr></DIV> |
| <DIV style="position:absolute;top:482;left:247"><nobr><span class="ft14">helpcontent 2</span></nobr></DIV> |
| <DIV style="position:absolute;top:480;left:355"><nobr><span class="ft3"> CVS module. There is one common package for Windows </span></nobr></DIV> |
| <DIV style="position:absolute;top:502;left:247"><nobr><span class="ft3">and Unix.</span></nobr></DIV> |
| <DIV style="position:absolute;top:541;left:220"><nobr><span class="ft3">2. The packages contain the <i>XSLT Import/Export filters</i> and the <i>template</i>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:580;left:220"><nobr><span class="ft3">3. Open a text document in OpenOffice.org. The menu item for the XML Settings </span></nobr></DIV> |
| <DIV style="position:absolute;top:601;left:247"><nobr><span class="ft3">will only be visible if a document is loaded.</span></nobr></DIV> |
| <DIV style="position:absolute;top:640;left:220"><nobr><span class="ft3">4. Choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:641;left:303"><nobr><span class="ft11"><b>Tools - XML Filter Settings</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:680;left:220"><nobr><span class="ft3">5. Click </span></nobr></DIV> |
| <DIV style="position:absolute;top:681;left:284"><nobr><span class="ft11"><b>Open Package</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:720;left:220"><nobr><span class="ft3">6. Browse to the filter package and click </span></nobr></DIV> |
| <DIV style="position:absolute;top:721;left:499"><nobr><span class="ft11"><b>Open</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:720;left:535"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:760;left:220"><nobr><span class="ft3">7. Click </span></nobr></DIV> |
| <DIV style="position:absolute;top:761;left:284"><nobr><span class="ft11"><b>Close</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:760;left:329"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:800;left:193"><nobr><span class="ft3">You can now open and save files in OpenOffice.org help format. </span></nobr></DIV> |
| <DIV style="position:absolute;top:839;left:193"><nobr><span class="ft3">Note that occasionally, OpenOffice.org seems to corrupt the packaged files while </span></nobr></DIV> |
| <DIV style="position:absolute;top:860;left:193"><nobr><span class="ft3">unpacking. If you are unable to load or save help files, check the xsl files in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:884;left:193"><nobr><span class="ft14">user/xslt/Help</span></nobr></DIV> |
| <DIV style="position:absolute;top:882;left:306"><nobr><span class="ft3"> directory and the template in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:884;left:551"><nobr><span class="ft14">user/template/Help</span></nobr></DIV> |
| <DIV style="position:absolute;top:882;left:696"><nobr><span class="ft3"> directory. </span></nobr></DIV> |
| <DIV style="position:absolute;top:904;left:193"><nobr><span class="ft3">You can also, extract the file manually from the package using a zip file utility.</span></nobr></DIV> |
| <DIV style="position:absolute;top:955;left:193"><nobr><span class="ft8"><b>Installing The Supporting Macros</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:981;left:193"><nobr><span class="ft3">The macro set is used to perform tasks inside the help files.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1034;left:193"><nobr><span class="ft5"> The macros are only tested with OpenOffice.org versions 1.1.x</span></nobr></DIV> |
| <DIV style="position:absolute;top:1054;left:214"><nobr><span class="ft5">Feel free to contact<A href="mailto:fpe@openoffice.org"> </a></span></nobr></DIV> |
| <DIV style="position:absolute;top:1054;left:320"><nobr><span class="ft6"><A href="mailto:fpe@openoffice.org">fpe@openoffice.org</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:1054;left:425"><nobr><span class="ft5"> if you want to port them to OOo 2.0!</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>76</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 77 --> |
| <a name="77"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c077.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:263"><nobr><span class="ft3">1. Get the macro archive</span></nobr></DIV> |
| <DIV style="position:absolute;top:136;left:534"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:138;left:538"><nobr><span class="ft14">HelpAuthoring.tar.gz</span></nobr></DIV> |
| <DIV style="position:absolute;top:136;left:700"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:136;left:729"><nobr><span class="ft3">from the </span></nobr></DIV> |
| <DIV style="position:absolute;top:161;left:290"><nobr><span class="ft14">helpers/helpauthoring</span></nobr></DIV> |
| <DIV style="position:absolute;top:158;left:460"><nobr><span class="ft3"> directory of the </span></nobr></DIV> |
| <DIV style="position:absolute;top:161;left:567"><nobr><span class="ft14">helpcontent 2</span></nobr></DIV> |
| <DIV style="position:absolute;top:158;left:672"><nobr><span class="ft3"> CVS module.</span></nobr></DIV> |
| <DIV style="position:absolute;top:198;left:263"><nobr><span class="ft3">2. Unpack it to a temporary directory.</span></nobr></DIV> |
| <DIV style="position:absolute;top:237;left:263"><nobr><span class="ft3">3. Choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:238;left:345"><nobr><span class="ft11"><b>Tools - Macros - Macro</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:237;left:543"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:277;left:263"><nobr><span class="ft3">4. Click </span></nobr></DIV> |
| <DIV style="position:absolute;top:278;left:326"><nobr><span class="ft11"><b>Organizer</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:277;left:407"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:317;left:263"><nobr><span class="ft3">5. Click the </span></nobr></DIV> |
| <DIV style="position:absolute;top:318;left:351"><nobr><span class="ft11"><b>Libraries</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:317;left:432"><nobr><span class="ft3"> tab</span></nobr></DIV> |
| <DIV style="position:absolute;top:357;left:263"><nobr><span class="ft3">6. Click </span></nobr></DIV> |
| <DIV style="position:absolute;top:358;left:331"><nobr><span class="ft11"><b>Append</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:357;left:385"><nobr><span class="ft3"> and browse to the temporary directory with the unpacked </span></nobr></DIV> |
| <DIV style="position:absolute;top:380;left:290"><nobr><span class="ft3">macros</span></nobr></DIV> |
| <DIV style="position:absolute;top:419;left:263"><nobr><span class="ft3">7. Select the file </span></nobr></DIV> |
| <DIV style="position:absolute;top:421;left:384"><nobr><span class="ft14">script.xlb</span></nobr></DIV> |
| <DIV style="position:absolute;top:419;left:465"><nobr><span class="ft3"> inside the macro directory and click </span></nobr></DIV> |
| <DIV style="position:absolute;top:420;left:707"><nobr><span class="ft11"><b>Open</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:419;left:743"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:459;left:263"><nobr><span class="ft3">8. Select </span></nobr></DIV> |
| <DIV style="position:absolute;top:460;left:335"><nobr><span class="ft11"><b>Replace existing libraries</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:459;left:569"><nobr><span class="ft3"> and click </span></nobr></DIV> |
| <DIV style="position:absolute;top:460;left:636"><nobr><span class="ft11"><b>Ok</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:459;left:654"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:499;left:263"><nobr><span class="ft3">9. Close the macro dialogs</span></nobr></DIV> |
| <DIV style="position:absolute;top:538;left:236"><nobr><span class="ft3">You can now use the macros for help authoring. The macros create a configuration </span></nobr></DIV> |
| <DIV style="position:absolute;top:559;left:236"><nobr><span class="ft3">file </span></nobr></DIV> |
| <DIV style="position:absolute;top:561;left:269"><nobr><span class="ft14">helpauthoring.cfg</span></nobr></DIV> |
| <DIV style="position:absolute;top:559;left:407"><nobr><span class="ft3"> to store various information and settings in your </span></nobr></DIV> |
| <DIV style="position:absolute;top:584;left:236"><nobr><span class="ft14">user/config</span></nobr></DIV> |
| <DIV style="position:absolute;top:581;left:325"><nobr><span class="ft3"> directory.</span></nobr></DIV> |
| <DIV style="position:absolute;top:635;left:236"><nobr><span class="ft5"> For some tasks, the macro set needs to recognize the paths to your help files and images as </span></nobr></DIV> |
| <DIV style="position:absolute;top:655;left:257"><nobr><span class="ft5">described on page <A href="HelpAuthoring_c.html#75">75</a>. You will be asked to provide these paths once a macro needs it. The paths </span></nobr></DIV> |
| <DIV style="position:absolute;top:673;left:257"><nobr><span class="ft5">will then be stored inside your </span></nobr></DIV> |
| <DIV style="position:absolute;top:673;left:423"><nobr><span class="ft14">user/config</span></nobr></DIV> |
| <DIV style="position:absolute;top:673;left:512"><nobr><span class="ft5"> directory in the file </span></nobr></DIV> |
| <DIV style="position:absolute;top:673;left:620"><nobr><span class="ft14">helpauthoring.cfg</span></nobr></DIV> |
| <DIV style="position:absolute;top:673;left:758"><nobr><span class="ft5">. You </span></nobr></DIV> |
| <DIV style="position:absolute;top:693;left:257"><nobr><span class="ft5">need to delete this file when the paths to your help files or images change.</span></nobr></DIV> |
| <DIV style="position:absolute;top:755;left:236"><nobr><span class="ft8"><b>Installing The Help Authoring Menu</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:781;left:236"><nobr><span class="ft3">The Help Authoring menu allows easy access to the macros to perform standard </span></nobr></DIV> |
| <DIV style="position:absolute;top:802;left:236"><nobr><span class="ft3">tasks with the help files.</span></nobr></DIV> |
| <DIV style="position:absolute;top:855;left:236"><nobr><span class="ft5"> This procedure overwrites any menu customization that you have made!</span></nobr></DIV> |
| <DIV style="position:absolute;top:906;left:263"><nobr><span class="ft3">1. Get the menu archive</span></nobr></DIV> |
| <DIV style="position:absolute;top:906;left:522"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:908;left:526"><nobr><span class="ft14">helpauthoring_menu.zip</span></nobr></DIV> |
| <DIV style="position:absolute;top:906;left:704"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:906;left:731"><nobr><span class="ft3">from the </span></nobr></DIV> |
| <DIV style="position:absolute;top:931;left:290"><nobr><span class="ft14">helpers/helpauthoring</span></nobr></DIV> |
| <DIV style="position:absolute;top:928;left:460"><nobr><span class="ft3"> directory of the </span></nobr></DIV> |
| <DIV style="position:absolute;top:931;left:567"><nobr><span class="ft14">helpcontent 2</span></nobr></DIV> |
| <DIV style="position:absolute;top:928;left:672"><nobr><span class="ft3"> CVS module.</span></nobr></DIV> |
| <DIV style="position:absolute;top:968;left:263"><nobr><span class="ft3">2. Choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:969;left:345"><nobr><span class="ft11"><b>Tools - Configure</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:968;left:498"><nobr><span class="ft3"> and select the </span></nobr></DIV> |
| <DIV style="position:absolute;top:969;left:600"><nobr><span class="ft11"><b>Menu</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:968;left:636"><nobr><span class="ft3"> tab</span></nobr></DIV> |
| <DIV style="position:absolute;top:1008;left:263"><nobr><span class="ft3">3. Click </span></nobr></DIV> |
| <DIV style="position:absolute;top:1009;left:326"><nobr><span class="ft11"><b>Load</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1008;left:362"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:1048;left:263"><nobr><span class="ft3">4. Locate the </span></nobr></DIV> |
| <DIV style="position:absolute;top:1050;left:364"><nobr><span class="ft14">helpauthoring_menu.zip</span></nobr></DIV> |
| <DIV style="position:absolute;top:1048;left:542"><nobr><span class="ft3"> file</span></nobr></DIV> |
| <DIV style="position:absolute;top:1088;left:263"><nobr><span class="ft3">5. Select the file and then click </span></nobr></DIV> |
| <DIV style="position:absolute;top:1089;left:480"><nobr><span class="ft11"><b>Ok</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1088;left:498"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>77</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 78 --> |
| <a name="78"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c078.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:193"><nobr><span class="ft3">If all steps were performed successfully, you should now be able to use the menu. </span></nobr></DIV> |
| <DIV style="position:absolute;top:188;left:193"><nobr><span class="ft10"><b>Editing Help Files - Basics</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:222;left:193"><nobr><span class="ft3">Since OpenOffice.org cannot simply be used as an XML edito,r we need to make </span></nobr></DIV> |
| <DIV style="position:absolute;top:243;left:193"><nobr><span class="ft3">some effort to map elements and attributes in the help file to elements that are </span></nobr></DIV> |
| <DIV style="position:absolute;top:265;left:193"><nobr><span class="ft3">recognized by OpenOffice.org.</span></nobr></DIV> |
| <DIV style="position:absolute;top:318;left:193"><nobr><span class="ft5"> For now, not all attributes for the elements are supported for editing in OpenOffice.org. The major </span></nobr></DIV> |
| <DIV style="position:absolute;top:337;left:214"><nobr><span class="ft5">ones, however, are available.</span></nobr></DIV> |
| <DIV style="position:absolute;top:399;left:193"><nobr><span class="ft8"><b>Paragraphs And Paragraph Formatting</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:425;left:193"><nobr><span class="ft3">Paragraphs are the central content carrying element in a help file. A </span></nobr></DIV> |
| <DIV style="position:absolute;top:427;left:651"><nobr><span class="ft14">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:425;left:724"><nobr><span class="ft3"> in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:447;left:193"><nobr><span class="ft3">help file maps to a paragraph in OpenOffice.org. The </span></nobr></DIV> |
| <DIV style="position:absolute;top:450;left:565"><nobr><span class="ft14">role</span></nobr></DIV> |
| <DIV style="position:absolute;top:447;left:597"><nobr><span class="ft3"> attribute of a paragraph </span></nobr></DIV> |
| <DIV style="position:absolute;top:470;left:193"><nobr><span class="ft3">maps to a paragraph <i>style</i> in OpenOffice.org.</span></nobr></DIV> |
| <DIV style="position:absolute;top:508;left:193"><nobr><span class="ft3">For every paragraph role in the help file there is a paragraph style beginning with </span></nobr></DIV> |
| <DIV style="position:absolute;top:511;left:733"><nobr><span class="ft14">hlp_ </span></nobr></DIV> |
| <DIV style="position:absolute;top:531;left:193"><nobr><span class="ft3">and ending with the role name, e.g. the role </span></nobr></DIV> |
| <DIV style="position:absolute;top:533;left:519"><nobr><span class="ft14">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:531;left:592"><nobr><span class="ft3"> maps to a style named </span></nobr></DIV> |
| <DIV style="position:absolute;top:555;left:193"><nobr><span class="ft14">hlp_paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:553;left:298"><nobr><span class="ft3">. </span></nobr></DIV> |
| <DIV style="position:absolute;top:593;left:193"><nobr><span class="ft3">There are also special paragraph styles that start with </span></nobr></DIV> |
| <DIV style="position:absolute;top:595;left:562"><nobr><span class="ft14">hlp_aux_</span></nobr></DIV> |
| <DIV style="position:absolute;top:593;left:627"><nobr><span class="ft3">. These are used for </span></nobr></DIV> |
| <DIV style="position:absolute;top:615;left:193"><nobr><span class="ft3">identifying special elements and should <i>never</i> be used for paragraphs. </span></nobr></DIV> |
| <DIV style="position:absolute;top:668;left:193"><nobr><span class="ft5"> Any paragraph that does <i>not</i> have a paragraph style starting with </span></nobr></DIV> |
| <DIV style="position:absolute;top:668;left:579"><nobr><span class="ft14">hlp_</span></nobr></DIV> |
| <DIV style="position:absolute;top:668;left:611"><nobr><span class="ft5"> will be <b>disregarded on </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:688;left:214"><nobr><span class="ft4"><b>export</b> by the export filter. Its content will be <b>lost</b> on the next reload of that file.</span></nobr></DIV> |
| <DIV style="position:absolute;top:737;left:193"><nobr><span class="ft3">The default paragraph styles for a help file (that is, the default roles of a paragraph) </span></nobr></DIV> |
| <DIV style="position:absolute;top:759;left:193"><nobr><span class="ft3">are already pre-defined in the help authoring template (</span></nobr></DIV> |
| <DIV style="position:absolute;top:761;left:562"><nobr><span class="ft14">xmlhelptemplate.stw</span></nobr></DIV> |
| <DIV style="position:absolute;top:759;left:716"><nobr><span class="ft3">) that is </span></nobr></DIV> |
| <DIV style="position:absolute;top:781;left:193"><nobr><span class="ft3">used for loading the help files in OpenOffice.org. This template is part of the </span></nobr></DIV> |
| <DIV style="position:absolute;top:802;left:193"><nobr><span class="ft3">import/export package and automatically installed in your </span></nobr></DIV> |
| <DIV style="position:absolute;top:805;left:575"><nobr><span class="ft14">user/template</span></nobr></DIV> |
| <DIV style="position:absolute;top:802;left:680"><nobr><span class="ft3"> directory.</span></nobr></DIV> |
| <DIV style="position:absolute;top:842;left:193"><nobr><span class="ft3">You can define new paragraph styles that are transformed to roles in the help files on </span></nobr></DIV> |
| <DIV style="position:absolute;top:863;left:193"><nobr><span class="ft3">export by creating a custom style beginning with </span></nobr></DIV> |
| <DIV style="position:absolute;top:866;left:529"><nobr><span class="ft14">hlp_</span></nobr></DIV> |
| <DIV style="position:absolute;top:863;left:562"><nobr><span class="ft3"> and ending in the role name. </span></nobr></DIV> |
| <DIV style="position:absolute;top:886;left:193"><nobr><span class="ft3">This new style will be recreated on loading that file in OpenOffice.org next time. </span></nobr></DIV> |
| <DIV style="position:absolute;top:907;left:193"><nobr><span class="ft3">However, there will be no formatting information for OpenOffice.org associated with it. </span></nobr></DIV> |
| <DIV style="position:absolute;top:928;left:193"><nobr><span class="ft3">For that, the style needs to be added to the template.</span></nobr></DIV> |
| <DIV style="position:absolute;top:967;left:193"><nobr><span class="ft3">Note, that these styles don't have any effect on the help as it is displayed <i>as such</i>. In </span></nobr></DIV> |
| <DIV style="position:absolute;top:988;left:193"><nobr><span class="ft3">order to adjust the help appearance the roles that are created from the paragraph </span></nobr></DIV> |
| <DIV style="position:absolute;top:1010;left:193"><nobr><span class="ft3">styles must be transformed by the main transformation style sheet and/or assigned to </span></nobr></DIV> |
| <DIV style="position:absolute;top:1031;left:193"><nobr><span class="ft3">formats using the cascading style sheets of the help.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>78</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 79 --> |
| <a name="79"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c079.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:236"><nobr><span class="ft8"><b>Sections</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:162;left:236"><nobr><span class="ft3">A </span></nobr></DIV> |
| <DIV style="position:absolute;top:164;left:253"><nobr><span class="ft14">section</span></nobr></DIV> |
| <DIV style="position:absolute;top:162;left:309"><nobr><span class="ft3"> in the help file maps to a section in OpenOffice.org. You can use the </span></nobr></DIV> |
| <DIV style="position:absolute;top:184;left:236"><nobr><span class="ft3">navigator to get an overview of existing sections or use the </span></nobr></DIV> |
| <DIV style="position:absolute;top:185;left:634"><nobr><span class="ft11"><b>Insert - Section</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:184;left:778"><nobr><span class="ft3"> and </span></nobr></DIV> |
| <DIV style="position:absolute;top:208;left:236"><nobr><span class="ft11"><b>Format - Sections </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:207;left:403"><nobr><span class="ft3">menus to modify existing sections. The section </span></nobr></DIV> |
| <DIV style="position:absolute;top:209;left:731"><nobr><span class="ft14">ID</span></nobr></DIV> |
| <DIV style="position:absolute;top:207;left:747"><nobr><span class="ft3"> maps to </span></nobr></DIV> |
| <DIV style="position:absolute;top:230;left:236"><nobr><span class="ft3">the section name in OpenOffice.org. Nested sections are supported. </span></nobr></DIV> |
| <DIV style="position:absolute;top:281;left:236"><nobr><span class="ft8"><b>Tables</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:307;left:236"><nobr><span class="ft3">A table in an OpenOffice.org help file transforms to a visible table in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:328;left:236"><nobr><span class="ft3">OpenOffice.org file. The table name holds all attributes for that table. If the table has a </span></nobr></DIV> |
| <DIV style="position:absolute;top:350;left:236"><nobr><span class="ft3">caption defined in the help file, a paragraph is created directly after the table that </span></nobr></DIV> |
| <DIV style="position:absolute;top:371;left:236"><nobr><span class="ft3">contains the caption. It is important that this sequence is <i>not modified</i> since the export </span></nobr></DIV> |
| <DIV style="position:absolute;top:392;left:236"><nobr><span class="ft3">filter relies on that sequence. </span></nobr></DIV> |
| <DIV style="position:absolute;top:431;left:236"><nobr><span class="ft3">Tables should no longer be used for formatting purposes, for instance, to place </span></nobr></DIV> |
| <DIV style="position:absolute;top:453;left:236"><nobr><span class="ft3">images or to mimic numbered lists. Nevertheless, there still is a considerable amount </span></nobr></DIV> |
| <DIV style="position:absolute;top:474;left:236"><nobr><span class="ft3">of legacy help files that do that.</span></nobr></DIV> |
| <DIV style="position:absolute;top:525;left:236"><nobr><span class="ft8"><b>Images</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:551;left:236"><nobr><span class="ft3">Images are mapped to image objects in OpenOffice.org that are <i>linked</i> (not </span></nobr></DIV> |
| <DIV style="position:absolute;top:572;left:236"><nobr><span class="ft3">embedded) to the OpenOffice.org file and anchored <i>as character</i>. The alternative text </span></nobr></DIV> |
| <DIV style="position:absolute;top:594;left:236"><nobr><span class="ft3">is defined in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:595;left:354"><nobr><span class="ft11"><b>Alternative</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:594;left:453"><nobr><span class="ft3"> property of the image object that can be accessed </span></nobr></DIV> |
| <DIV style="position:absolute;top:617;left:236"><nobr><span class="ft3">through the </span></nobr></DIV> |
| <DIV style="position:absolute;top:618;left:327"><nobr><span class="ft11"><b>Graphics</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:617;left:399"><nobr><span class="ft3"> properties dialog (by double-clicking the image) on the </span></nobr></DIV> |
| <DIV style="position:absolute;top:640;left:236"><nobr><span class="ft11"><b>Options</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:639;left:299"><nobr><span class="ft3"> tab page. The </span></nobr></DIV> |
| <DIV style="position:absolute;top:642;left:401"><nobr><span class="ft14">ID</span></nobr></DIV> |
| <DIV style="position:absolute;top:639;left:417"><nobr><span class="ft3"> of an image is stored in the name of the image object and </span></nobr></DIV> |
| <DIV style="position:absolute;top:662;left:236"><nobr><span class="ft3">should not be altered manually.</span></nobr></DIV> |
| <DIV style="position:absolute;top:715;left:236"><nobr><span class="ft5"> The images will only be displayed in OpenOffice.org correctly if the path to the image files was </span></nobr></DIV> |
| <DIV style="position:absolute;top:734;left:257"><nobr><span class="ft5">correctly specified in the import and export filters (<A href="HelpAuthoring_c.html#79">see </a>on <A href="HelpAuthoring_c.html#79">page )</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:796;left:236"><nobr><span class="ft8"><b>Lists</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:823;left:236"><nobr><span class="ft3">There are two types of lists in the help (unordered and ordered) that match to the </span></nobr></DIV> |
| <DIV style="position:absolute;top:844;left:236"><nobr><span class="ft3">corresponding list type in OpenOffice.org. </span></nobr></DIV> |
| <DIV style="position:absolute;top:895;left:236"><nobr><span class="ft8"><b>Embedding</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:921;left:236"><nobr><span class="ft3">The embedding technique is unique to the help. Therefore, we use some workarounds </span></nobr></DIV> |
| <DIV style="position:absolute;top:942;left:236"><nobr><span class="ft3">to implement embedding when editing the help files in OpenOffice.org: </span></nobr></DIV> |
| <DIV style="position:absolute;top:981;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:983;left:290"><nobr><span class="ft13"><i>Sections to be embedded</i> are represented as sections. </span></nobr></DIV> |
| <DIV style="position:absolute;top:1015;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:1016;left:290"><nobr><span class="ft13"><i>Paragraph parts to be embedded</i><b> </b>are surrounded by a </span></nobr></DIV> |
| <DIV style="position:absolute;top:1018;left:652"><nobr><span class="ft14">variable</span></nobr></DIV> |
| <DIV style="position:absolute;top:1016;left:717"><nobr><span class="ft3"> tag pair.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1048;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:1049;left:290"><nobr><span class="ft13"><i>Places where sections are embedded</i><b> </b>are designated by an </span></nobr></DIV> |
| <DIV style="position:absolute;top:1052;left:688"><nobr><span class="ft14">embed</span></nobr></DIV> |
| <DIV style="position:absolute;top:1049;left:729"><nobr><span class="ft3"> tag. </span></nobr></DIV> |
| <DIV style="position:absolute;top:1081;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:1083;left:290"><nobr><span class="ft13"><i>Places where parts of paragraphs are embedded</i><b> </b>are designated by an </span></nobr></DIV> |
| <DIV style="position:absolute;top:1108;left:290"><nobr><span class="ft14">embedvar</span></nobr></DIV> |
| <DIV style="position:absolute;top:1106;left:354"><nobr><span class="ft3"> tag. </span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>79</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 80 --> |
| <a name="80"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c080.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:193"><nobr><span class="ft10"><b>Character Formatting</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:170;left:193"><nobr><span class="ft3">Direct (hard) formatting is <i>not</i> supported. Any character with a direct format will <i>lose </i></span></nobr></DIV> |
| <DIV style="position:absolute;top:191;left:193"><nobr><span class="ft3">its format definition on export. Instead, character formatting is achieved using </span></nobr></DIV> |
| <DIV style="position:absolute;top:212;left:193"><nobr><span class="ft3">character styles. The importing template already contains a list of pre-defined </span></nobr></DIV> |
| <DIV style="position:absolute;top:234;left:193"><nobr><span class="ft3">character styles. All styles that begin with </span></nobr></DIV> |
| <DIV style="position:absolute;top:236;left:480"><nobr><span class="ft14">hlp_</span></nobr></DIV> |
| <DIV style="position:absolute;top:234;left:512"><nobr><span class="ft3"> can be used for character formatting </span></nobr></DIV> |
| <DIV style="position:absolute;top:256;left:193"><nobr><span class="ft3">except for the styles beginning with </span></nobr></DIV> |
| <DIV style="position:absolute;top:258;left:446"><nobr><span class="ft14">hlp_aux_</span></nobr></DIV> |
| <DIV style="position:absolute;top:256;left:511"><nobr><span class="ft3"> because those are used for internal </span></nobr></DIV> |
| <DIV style="position:absolute;top:278;left:193"><nobr><span class="ft3">purpose.</span></nobr></DIV> |
| <DIV style="position:absolute;top:317;left:193"><nobr><span class="ft3">Similar to the paragraph styles, you can define new character styles that are </span></nobr></DIV> |
| <DIV style="position:absolute;top:339;left:193"><nobr><span class="ft3">transformed to </span></nobr></DIV> |
| <DIV style="position:absolute;top:341;left:295"><nobr><span class="ft14">type</span></nobr></DIV> |
| <DIV style="position:absolute;top:339;left:327"><nobr><span class="ft3"> attributes of </span></nobr></DIV> |
| <DIV style="position:absolute;top:341;left:415"><nobr><span class="ft14">item</span></nobr></DIV> |
| <DIV style="position:absolute;top:339;left:447"><nobr><span class="ft3"> elements in the help files on export. To do this, </span></nobr></DIV> |
| <DIV style="position:absolute;top:361;left:193"><nobr><span class="ft3">create a custom character style beginning with </span></nobr></DIV> |
| <DIV style="position:absolute;top:363;left:524"><nobr><span class="ft14">hlp_</span></nobr></DIV> |
| <DIV style="position:absolute;top:361;left:556"><nobr><span class="ft3"> and ending in the type name </span></nobr></DIV> |
| <DIV style="position:absolute;top:383;left:193"><nobr><span class="ft3">(e.g., </span></nobr></DIV> |
| <DIV style="position:absolute;top:386;left:236"><nobr><span class="ft14">hlp_dialogname</span></nobr></DIV> |
| <DIV style="position:absolute;top:386;left:349"><nobr><span class="ft9">)</span></nobr></DIV> |
| <DIV style="position:absolute;top:383;left:357"><nobr><span class="ft3">. This new style will be recreated on loading that file in </span></nobr></DIV> |
| <DIV style="position:absolute;top:405;left:193"><nobr><span class="ft3">OpenOffice.org next time. However, there will be no formatting information for </span></nobr></DIV> |
| <DIV style="position:absolute;top:427;left:193"><nobr><span class="ft3">OpenOffice.org associated with it. For that, the style needs to be added to the help </span></nobr></DIV> |
| <DIV style="position:absolute;top:448;left:193"><nobr><span class="ft3">authoring template.</span></nobr></DIV> |
| <DIV style="position:absolute;top:501;left:193"><nobr><span class="ft5"> Note that these styles don't have any effect on the help as it is displayed <i>as such</i>. In order to adjust </span></nobr></DIV> |
| <DIV style="position:absolute;top:521;left:214"><nobr><span class="ft5">the help appearance, the item types that are created from the character styles must be transformed </span></nobr></DIV> |
| <DIV style="position:absolute;top:539;left:214"><nobr><span class="ft5">by the main transformation style sheet and/or assigned to formats using the style sheets of the help.</span></nobr></DIV> |
| <DIV style="position:absolute;top:602;left:193"><nobr><span class="ft10"><b>Working With the Help Files</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:650;left:193"><nobr><span class="ft5"> Ensure that you have set up your work environment correctly as described in <i><A href="HelpAuthoring_c.html#75">Setting Up the Envi</i>-</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:669;left:214"><nobr><span class="ft15"><A href="HelpAuthoring_c.html#75"><i>ronment</i></a> on <A href="HelpAuthoring_c.html#75">page 75.</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:731;left:193"><nobr><span class="ft8"><b>Creating A Help File</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:757;left:220"><nobr><span class="ft3">1. Start OpenOffice.org and open a new empty Writer window.</span></nobr></DIV> |
| <DIV style="position:absolute;top:778;left:247"><nobr><span class="ft3">The help authoring menu is only available in the <b>Writer context</b>. So you need </span></nobr></DIV> |
| <DIV style="position:absolute;top:800;left:247"><nobr><span class="ft3">to have a Writer window open.</span></nobr></DIV> |
| <DIV style="position:absolute;top:839;left:220"><nobr><span class="ft3">2. Choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:840;left:303"><nobr><span class="ft11"><b>Help Authoring - Create New Help File</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:839;left:636"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:861;left:247"><nobr><span class="ft3">You should always create a new file this way to ensure that all settings are </span></nobr></DIV> |
| <DIV style="position:absolute;top:883;left:247"><nobr><span class="ft3">made correctly.</span></nobr></DIV> |
| <DIV style="position:absolute;top:921;left:220"><nobr><span class="ft3">3. Select a file name inside the help directory structure</span></nobr></DIV> |
| <DIV style="position:absolute;top:943;left:247"><nobr><span class="ft3">The directory structure is described on page <A href="HelpAuthoring_c.html#75"> 75</a>. You will be automatically </span></nobr></DIV> |
| <DIV style="position:absolute;top:964;left:247"><nobr><span class="ft3">prompted to save the file. You need to save it before you can actually work on </span></nobr></DIV> |
| <DIV style="position:absolute;top:986;left:247"><nobr><span class="ft3">it.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1024;left:220"><nobr><span class="ft3">4. Insert an initial comment (optional)</span></nobr></DIV> |
| <DIV style="position:absolute;top:1046;left:247"><nobr><span class="ft3">You will be prompted to insert a comment on file creation. This comment will </span></nobr></DIV> |
| <DIV style="position:absolute;top:1067;left:247"><nobr><span class="ft3">be stored in the file metadata and cannot be changed using OpenOffice.org.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>80</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 81 --> |
| <a name="81"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c081.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:236"><nobr><span class="ft3">Now you have created a fresh empty help document. The file title is set to the generic </span></nobr></DIV> |
| <DIV style="position:absolute;top:157;left:236"><nobr><span class="ft3">term </span></nobr></DIV> |
| <DIV style="position:absolute;top:160;left:270"><nobr><span class="ft14"><Set Topic Title></span></nobr></DIV> |
| <DIV style="position:absolute;top:157;left:408"><nobr><span class="ft3">. To adjust the topic title see<A href="HelpAuthoring_c.html#94"> <i>Meta Data </i></a>on page<A href="HelpAuthoring_c.html#94"> 94.</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:197;left:236"><nobr><span class="ft3">Switch the Stylist to show </span></nobr></DIV> |
| <DIV style="position:absolute;top:198;left:413"><nobr><span class="ft11"><b>Custom</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:197;left:467"><nobr><span class="ft3"> styles to view a list of all styles that are allowed in </span></nobr></DIV> |
| <DIV style="position:absolute;top:220;left:236"><nobr><span class="ft3">the help file. None but these (and the ones created by you following the guidelines </span></nobr></DIV> |
| <DIV style="position:absolute;top:241;left:236"><nobr><span class="ft3">above) can be used.</span></nobr></DIV> |
| <DIV style="position:absolute;top:294;left:236"><nobr><span class="ft5"> After the file is finished it needs to be added to the list of files to be processed by the help compiler. </span></nobr></DIV> |
| <DIV style="position:absolute;top:314;left:257"><nobr><span class="ft5">This is done by adding the file to the makefile of its directory. You can either do that manually or run </span></nobr></DIV> |
| <DIV style="position:absolute;top:332;left:257"><nobr><span class="ft5">the </span></nobr></DIV> |
| <DIV style="position:absolute;top:332;left:277"><nobr><span class="ft14">createmakefiles.pl</span></nobr></DIV> |
| <DIV style="position:absolute;top:332;left:423"><nobr><span class="ft5"> script when you have finished working on the help files. For details, </span></nobr></DIV> |
| <DIV style="position:absolute;top:352;left:257"><nobr><span class="ft5">see <i><A href="HelpAuthoring_c.html#19">Building the Help Set </i></a>on page <A href="HelpAuthoring_c.html#19">19</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:414;left:236"><nobr><span class="ft8"><b>Opening A Help File</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:440;left:263"><nobr><span class="ft3">1. Choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:441;left:345"><nobr><span class="ft11"><b>File Open</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:440;left:448"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:462;left:290"><nobr><span class="ft3">Browse to the file you want to open and select </span></nobr></DIV> |
| <DIV style="position:absolute;top:463;left:623"><nobr><span class="ft11"><b>Help (*.xhp)</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:462;left:733"><nobr><span class="ft3"> as the file </span></nobr></DIV> |
| <DIV style="position:absolute;top:485;left:290"><nobr><span class="ft3">type</span></nobr></DIV> |
| <DIV style="position:absolute;top:524;left:263"><nobr><span class="ft3">2. Click </span></nobr></DIV> |
| <DIV style="position:absolute;top:525;left:326"><nobr><span class="ft11"><b>Open</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:524;left:362"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:576;left:236"><nobr><span class="ft8"><b>Removing A Help File</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:602;left:236"><nobr><span class="ft3">Since a help file is referenced from multiple locations, simply deleting a file from disk </span></nobr></DIV> |
| <DIV style="position:absolute;top:624;left:236"><nobr><span class="ft3">is <i>not</i> sufficient for removing a help file from the set of help files.</span></nobr></DIV> |
| <DIV style="position:absolute;top:662;left:236"><nobr><span class="ft3">To remove a help file from the set of help files that are compiled, you need to remove </span></nobr></DIV> |
| <DIV style="position:absolute;top:684;left:236"><nobr><span class="ft3">it from the <i>makefile</i> of its directory. In this way, it will not be included in the index, or </span></nobr></DIV> |
| <DIV style="position:absolute;top:705;left:236"><nobr><span class="ft3">the full text search. However, it will still be included in the help files archive </span></nobr></DIV> |
| <DIV style="position:absolute;top:708;left:733"><nobr><span class="ft14">*.jar</span></nobr></DIV> |
| <DIV style="position:absolute;top:705;left:774"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:745;left:236"><nobr><span class="ft3">To delete a help file completely, you need to <i>remove it from your local disk</i> and </span></nobr></DIV> |
| <DIV style="position:absolute;top:766;left:236"><nobr><span class="ft3">remove its entry in the <i>makefile</i> of its directory. If you work on the CVS you also need </span></nobr></DIV> |
| <DIV style="position:absolute;top:788;left:236"><nobr><span class="ft3">to <i>remove it from the CVS repository</i>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:826;left:236"><nobr><span class="ft3">You also need to remove all <i>dependency files</i> in the output tree that are created </span></nobr></DIV> |
| <DIV style="position:absolute;top:848;left:236"><nobr><span class="ft3">during a help build that refer to the deleted file See also <i><A href="HelpAuthoring_c.html#19">Building the Help Set</i> </a>on page </span></nobr></DIV> |
| <DIV style="position:absolute;top:869;left:236"><nobr><span class="ft3"><A href="HelpAuthoring_c.html#19">19</a>. If you haven't built the help set before you don't need to worry about this. If you </span></nobr></DIV> |
| <DIV style="position:absolute;top:891;left:236"><nobr><span class="ft3">have changed multiple files it is safer to remove the output tree completely and rebuild </span></nobr></DIV> |
| <DIV style="position:absolute;top:912;left:236"><nobr><span class="ft3">the help from scratch.</span></nobr></DIV> |
| <DIV style="position:absolute;top:951;left:236"><nobr><span class="ft3">Finally, you need to ensure that the deleted file is not referenced by other help files or </span></nobr></DIV> |
| <DIV style="position:absolute;top:972;left:236"><nobr><span class="ft3">by the content files </span></nobr></DIV> |
| <DIV style="position:absolute;top:974;left:365"><nobr><span class="ft14">*.tree</span></nobr></DIV> |
| <DIV style="position:absolute;top:972;left:413"><nobr><span class="ft3"> in the auxiliary directory.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1016;left:236"><nobr><span class="ft25"><i>To remove a help file</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:1043;left:263"><nobr><span class="ft3">1. If this change will be committed back to the CVS, remove the help file from </span></nobr></DIV> |
| <DIV style="position:absolute;top:1064;left:290"><nobr><span class="ft3">the CVS repository, for example, using the </span></nobr></DIV> |
| <DIV style="position:absolute;top:1066;left:575"><nobr><span class="ft14">cvs remove</span></nobr></DIV> |
| <DIV style="position:absolute;top:1064;left:656"><nobr><span class="ft3"> command. <A href="HelpAuthoring_c.html#81">[11]</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:1114;left:128"><nobr><span class="ft19">11 See<A href="http://tools.openoffice.org/"> </a></span></nobr></DIV> |
| <DIV style="position:absolute;top:1115;left:170"><nobr><span class="ft24"><A href="http://tools.openoffice.org/">http://tools.openoffice.org/</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:1115;left:170"><nobr><span class="ft24"><A href="http://tools.openoffice.org/"> </a></span></nobr></DIV> |
| <DIV style="position:absolute;top:1115;left:341"><nobr><span class="ft24"><A href="http://tools.openoffice.org/"> </a></span></nobr></DIV> |
| <DIV style="position:absolute;top:1114;left:350"><nobr><span class="ft19">for information about OpenOffice.org CVS</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>81</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 82 --> |
| <a name="82"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| .ft28{font-size:11px;font-family:Times;color:#666666;} |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c082.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:220"><nobr><span class="ft3">2. Delete the help file on your local disk. </span></nobr></DIV> |
| <DIV style="position:absolute;top:175;left:220"><nobr><span class="ft3">3. In the </span></nobr></DIV> |
| <DIV style="position:absolute;top:177;left:295"><nobr><span class="ft14">makefile.mk</span></nobr></DIV> |
| <DIV style="position:absolute;top:175;left:384"><nobr><span class="ft3"> of its directory, locate the help file's entry (it has the </span></nobr></DIV> |
| <DIV style="position:absolute;top:197;left:247"><nobr><span class="ft3">extension </span></nobr></DIV> |
| <DIV style="position:absolute;top:199;left:315"><nobr><span class="ft14">.hzip</span></nobr></DIV> |
| <DIV style="position:absolute;top:197;left:356"><nobr><span class="ft3"> instead of .</span></nobr></DIV> |
| <DIV style="position:absolute;top:199;left:433"><nobr><span class="ft14">xhp</span></nobr></DIV> |
| <DIV style="position:absolute;top:197;left:458"><nobr><span class="ft3">) and delete the corresponding line.</span></nobr></DIV> |
| <DIV style="position:absolute;top:197;left:725"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:219;left:247"><nobr><span class="ft3">This step is not required if you use the </span></nobr></DIV> |
| <DIV style="position:absolute;top:222;left:545"><nobr><span class="ft14">createmakefile.pl</span></nobr></DIV> |
| <DIV style="position:absolute;top:219;left:682"><nobr><span class="ft3"> script from </span></nobr></DIV> |
| <DIV style="position:absolute;top:244;left:247"><nobr><span class="ft14">helpcontent2/helpers</span></nobr></DIV> |
| <DIV style="position:absolute;top:242;left:409"><nobr><span class="ft3"> to update all makefiles before building the help.</span></nobr></DIV> |
| <DIV style="position:absolute;top:281;left:220"><nobr><span class="ft3">4. Check if the help file is referenced in on of the </span></nobr></DIV> |
| <DIV style="position:absolute;top:284;left:653"><nobr><span class="ft14">*.tree</span></nobr></DIV> |
| <DIV style="position:absolute;top:281;left:701"><nobr><span class="ft3"> files in </span></nobr></DIV> |
| <DIV style="position:absolute;top:306;left:247"><nobr><span class="ft14">helpcontent2/source/auxiliary</span></nobr></DIV> |
| <DIV style="position:absolute;top:304;left:482"><nobr><span class="ft3"> and delete its reference there, if required.</span></nobr></DIV> |
| <DIV style="position:absolute;top:343;left:220"><nobr><span class="ft3">5. If you have built the help before and you have an existing output tree with </span></nobr></DIV> |
| <DIV style="position:absolute;top:365;left:247"><nobr><span class="ft3">dependency files </span></nobr></DIV> |
| <DIV style="position:absolute;top:367;left:372"><nobr><span class="ft14">*.dphh</span></nobr></DIV> |
| <DIV style="position:absolute;top:365;left:421"><nobr><span class="ft3">, delete any dependency files that reference the </span></nobr></DIV> |
| <DIV style="position:absolute;top:387;left:247"><nobr><span class="ft3">deleted help file. A dependency file lists all files that it depends on.</span></nobr></DIV> |
| <DIV style="position:absolute;top:438;left:193"><nobr><span class="ft8"><b>Moving A Help File</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:464;left:193"><nobr><span class="ft3">From the build environment's view, moving a help file from one directory to another is </span></nobr></DIV> |
| <DIV style="position:absolute;top:485;left:193"><nobr><span class="ft3">equivalent to removing a file from one directory and creating a file in another directory.</span></nobr></DIV> |
| <DIV style="position:absolute;top:524;left:220"><nobr><span class="ft3">1. Copy the help files to the new directory.</span></nobr></DIV> |
| <DIV style="position:absolute;top:563;left:220"><nobr><span class="ft3">2. Follow the procedure described previously for removing a help file.</span></nobr></DIV> |
| <DIV style="position:absolute;top:602;left:220"><nobr><span class="ft3">3. Ensure that all links inside the moved help file to itself have been adjusted.</span></nobr></DIV> |
| <DIV style="position:absolute;top:641;left:220"><nobr><span class="ft3">4. Add the file to the </span></nobr></DIV> |
| <DIV style="position:absolute;top:643;left:368"><nobr><span class="ft14">makefile</span></nobr></DIV> |
| <DIV style="position:absolute;top:641;left:433"><nobr><span class="ft3"> of the new directory.</span></nobr></DIV> |
| <DIV style="position:absolute;top:663;left:247"><nobr><span class="ft3">This step is not required if you use the </span></nobr></DIV> |
| <DIV style="position:absolute;top:665;left:545"><nobr><span class="ft14">createmakefile.pl</span></nobr></DIV> |
| <DIV style="position:absolute;top:663;left:682"><nobr><span class="ft3"> script from </span></nobr></DIV> |
| <DIV style="position:absolute;top:687;left:247"><nobr><span class="ft14">helpcontent2/helpers</span></nobr></DIV> |
| <DIV style="position:absolute;top:685;left:409"><nobr><span class="ft3"> to update all makefiles before building the help.</span></nobr></DIV> |
| <DIV style="position:absolute;top:739;left:193"><nobr><span class="ft5"> Note that moving a help file </span></nobr></DIV> |
| <DIV style="position:absolute;top:738;left:365"><nobr><span class="ft28">can</span></nobr></DIV> |
| <DIV style="position:absolute;top:739;left:387"><nobr><span class="ft5"> create new localization effort since the moved help file looks like a </span></nobr></DIV> |
| <DIV style="position:absolute;top:758;left:214"><nobr><span class="ft5">brand new file to the localization process. However, translation memory systems should be able to </span></nobr></DIV> |
| <DIV style="position:absolute;top:776;left:214"><nobr><span class="ft5">automatically translate it because the content did not change - except for internal links.</span></nobr></DIV> |
| <DIV style="position:absolute;top:839;left:193"><nobr><span class="ft10"><b>Sections and Paragraphs</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:873;left:193"><nobr><span class="ft3">Sections are used to specify parts of help files that are used for referencing purpose in </span></nobr></DIV> |
| <DIV style="position:absolute;top:895;left:193"><nobr><span class="ft3">other files. Sections can be embedded and linked.</span></nobr></DIV> |
| <DIV style="position:absolute;top:946;left:193"><nobr><span class="ft8"><b>Where Are The Sections?</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:972;left:193"><nobr><span class="ft3">Since OpenOffice.org natively supports sections, we make use of them to represent </span></nobr></DIV> |
| <DIV style="position:absolute;top:993;left:193"><nobr><span class="ft3">sections in help files. The </span></nobr></DIV> |
| <DIV style="position:absolute;top:995;left:374"><nobr><span class="ft14">ID</span></nobr></DIV> |
| <DIV style="position:absolute;top:993;left:390"><nobr><span class="ft3"> attribute of a section in the help is represented by the </span></nobr></DIV> |
| <DIV style="position:absolute;top:1018;left:193"><nobr><span class="ft14">name</span></nobr></DIV> |
| <DIV style="position:absolute;top:1015;left:225"><nobr><span class="ft3"> property of the section in OpenOffice.org.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1055;left:193"><nobr><span class="ft3">All other properties of sections inside OpenOffice.org have no influence on the help </span></nobr></DIV> |
| <DIV style="position:absolute;top:1076;left:193"><nobr><span class="ft3">sections. Any layout settings made to sections (background, visibility...) are <i>lost</i> on </span></nobr></DIV> |
| <DIV style="position:absolute;top:1098;left:193"><nobr><span class="ft3">next reload.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>82</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 83 --> |
| <a name="83"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| .ft29{font-size:12px;font-family:Times;color:#000000;} |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c083.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:236"><nobr><span class="ft3">You can use the navigator to view and navigate sections. Nested sections are also </span></nobr></DIV> |
| <DIV style="position:absolute;top:157;left:236"><nobr><span class="ft3">supported ,both by the help and by OpenOffice.org.</span></nobr></DIV> |
| <DIV style="position:absolute;top:196;left:236"><nobr><span class="ft3">Sections start and end with a </span></nobr></DIV> |
| <DIV style="position:absolute;top:198;left:435"><nobr><span class="ft14">section</span></nobr></DIV> |
| <DIV style="position:absolute;top:196;left:492"><nobr><span class="ft3"> tag that is placed in the first paragraph directly </span></nobr></DIV> |
| <DIV style="position:absolute;top:218;left:236"><nobr><span class="ft3">after the section starts, and in the last paragraph before the section ends:</span></nobr></DIV> |
| <DIV style="position:absolute;top:476;left:236"><nobr><span class="ft3">If you want to insert something before or after a section, ensure that you place it </span></nobr></DIV> |
| <DIV style="position:absolute;top:497;left:236"><nobr><span class="ft3">before or after the section delimiter line, not just before or after the </span></nobr></DIV> |
| <DIV style="position:absolute;top:500;left:679"><nobr><span class="ft14">section</span></nobr></DIV> |
| <DIV style="position:absolute;top:497;left:736"><nobr><span class="ft3"> tag.</span></nobr></DIV> |
| <DIV style="position:absolute;top:537;left:236"><nobr><span class="ft3">If the section <i>starts at the top</i> of the document and you want to insert something </span></nobr></DIV> |
| <DIV style="position:absolute;top:558;left:236"><nobr><span class="ft3">before that section, go to the top of the section and press </span></nobr></DIV> |
| <DIV style="position:absolute;top:561;left:645"><nobr><span class="ft12"><b>Alt+Return</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:558;left:726"><nobr><span class="ft3"> to create a </span></nobr></DIV> |
| <DIV style="position:absolute;top:581;left:236"><nobr><span class="ft3">paragraph in front of the section.</span></nobr></DIV> |
| <DIV style="position:absolute;top:619;left:236"><nobr><span class="ft3">If the section <i>ends at the bottom</i> of the document and you want to insert something </span></nobr></DIV> |
| <DIV style="position:absolute;top:641;left:236"><nobr><span class="ft3">after that section, go to the bottom of the section and press </span></nobr></DIV> |
| <DIV style="position:absolute;top:643;left:648"><nobr><span class="ft12"><b>Alt+Return</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:641;left:729"><nobr><span class="ft3"> to create a </span></nobr></DIV> |
| <DIV style="position:absolute;top:663;left:236"><nobr><span class="ft3">paragraph after the section.</span></nobr></DIV> |
| <DIV style="position:absolute;top:714;left:236"><nobr><span class="ft8"><b>Adding A Section</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:740;left:263"><nobr><span class="ft3">1. Depending on whether you want to insert a new empty section or build a </span></nobr></DIV> |
| <DIV style="position:absolute;top:762;left:290"><nobr><span class="ft3">section around existing text, do one of the following:</span></nobr></DIV> |
| <DIV style="position:absolute;top:800;left:289"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:802;left:316"><nobr><span class="ft3">Place the cursor where you want to insert the new empty section.</span></nobr></DIV> |
| <DIV style="position:absolute;top:834;left:289"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:835;left:316"><nobr><span class="ft3">Mark the piece of the document that you want to include in a section.</span></nobr></DIV> |
| <DIV style="position:absolute;top:867;left:263"><nobr><span class="ft3">2. Choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:868;left:345"><nobr><span class="ft11"><b>Help Authoring - Insert Section</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:907;left:263"><nobr><span class="ft3">3. Insert an identifier for the section in the text box.</span></nobr></DIV> |
| <DIV style="position:absolute;top:929;left:290"><nobr><span class="ft3">This section identifier will be used as </span></nobr></DIV> |
| <DIV style="position:absolute;top:931;left:549"><nobr><span class="ft14">ID</span></nobr></DIV> |
| <DIV style="position:absolute;top:929;left:566"><nobr><span class="ft3"> attribute for the section in the help </span></nobr></DIV> |
| <DIV style="position:absolute;top:951;left:290"><nobr><span class="ft3">file. It must be <i>unique within the file</i>. It is advisable to use some kind of </span></nobr></DIV> |
| <DIV style="position:absolute;top:972;left:290"><nobr><span class="ft3">descriptive name. Use only letters, numbers and the underscore.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>83</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:441;left:236"><nobr><span class="ft15"><i>Fig. 6: Section tags and section areas</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:357;left:610"><nobr><span class="ft29">S</span></nobr></DIV> |
| <DIV style="position:absolute;top:347;left:610"><nobr><span class="ft29">ec</span></nobr></DIV> |
| <DIV style="position:absolute;top:332;left:610"><nobr><span class="ft29">tio</span></nobr></DIV> |
| <DIV style="position:absolute;top:316;left:610"><nobr><span class="ft29">n</span></nobr></DIV> |
| </DIV> |
| <!-- Page 84 --> |
| <a name="84"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c084.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:193"><nobr><span class="ft8"><b>Adding A Subsection</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:162;left:193"><nobr><span class="ft3">A subsection is a section that is the child of another section. OpenOffice.org supports </span></nobr></DIV> |
| <DIV style="position:absolute;top:183;left:193"><nobr><span class="ft3">nested sections. The procedure to insert a subsection is the same as inserting a </span></nobr></DIV> |
| <DIV style="position:absolute;top:205;left:193"><nobr><span class="ft3">section, except that if you insert a section with the cursor inside an existing section </span></nobr></DIV> |
| <DIV style="position:absolute;top:226;left:193"><nobr><span class="ft3">you will create a subsection.</span></nobr></DIV> |
| <DIV style="position:absolute;top:265;left:193"><nobr><span class="ft3">You cannot create overlapping sections. Neither the help format nor OpenOffice.org </span></nobr></DIV> |
| <DIV style="position:absolute;top:286;left:193"><nobr><span class="ft3">support this. </span></nobr></DIV> |
| <DIV style="position:absolute;top:337;left:193"><nobr><span class="ft8"><b>Removing A Section</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:364;left:220"><nobr><span class="ft3">1. If you want to remove a section <i>including</i> its content, delete the section </span></nobr></DIV> |
| <DIV style="position:absolute;top:385;left:247"><nobr><span class="ft3">content first.</span></nobr></DIV> |
| <DIV style="position:absolute;top:424;left:220"><nobr><span class="ft3">2. Choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:425;left:303"><nobr><span class="ft11"><b>Format Sections</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:424;left:456"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:464;left:220"><nobr><span class="ft3">3. Select the section you want to remove from the list of sections and click </span></nobr></DIV> |
| <DIV style="position:absolute;top:486;left:247"><nobr><span class="ft11"><b>Remove</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:485;left:301"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:508;left:247"><nobr><span class="ft3">If you remove a section that has subsections only, the selected section will be </span></nobr></DIV> |
| <DIV style="position:absolute;top:529;left:247"><nobr><span class="ft3">removed while the subsections will be preserved.</span></nobr></DIV> |
| <DIV style="position:absolute;top:582;left:193"><nobr><span class="ft5"> If you remove a section, ensure that no other file references it to avoid broken links.</span></nobr></DIV> |
| <DIV style="position:absolute;top:646;left:193"><nobr><span class="ft8"><b>Linking To A Section</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:672;left:193"><nobr><span class="ft3">You can create a link to a section by specifying the section ID as the target in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:693;left:193"><nobr><span class="ft3">hyperlink URL when creating a link, for example</span></nobr></DIV> |
| <DIV style="position:absolute;top:739;left:224"><nobr><span class="ft5"><link href="text/shared/guide/file_name.xhp#section_id"></span></nobr></DIV> |
| <DIV style="position:absolute;top:769;left:193"><nobr><span class="ft3">For details, see <i><A href="HelpAuthoring_c.html#94">Linking</i></a> on page <A href="HelpAuthoring_c.html#94">94.</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:820;left:193"><nobr><span class="ft8"><b>Embedding A Section</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:846;left:193"><nobr><span class="ft3">You can embed a section using the </span></nobr></DIV> |
| <DIV style="position:absolute;top:849;left:440"><nobr><span class="ft14">embed</span></nobr></DIV> |
| <DIV style="position:absolute;top:846;left:481"><nobr><span class="ft3"> element. You need the file name and the </span></nobr></DIV> |
| <DIV style="position:absolute;top:869;left:193"><nobr><span class="ft14">ID</span></nobr></DIV> |
| <DIV style="position:absolute;top:868;left:209"><nobr><span class="ft3"> of the section that you want to embed. The embedded section preserves its </span></nobr></DIV> |
| <DIV style="position:absolute;top:890;left:193"><nobr><span class="ft3">structure. For details on embedding, see <i><A href="HelpAuthoring_c.html#93">Embedding Content</a> </i>on page <A href="HelpAuthoring_c.html#93">93.</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:941;left:193"><nobr><span class="ft8"><b>Adding A Paragraph</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:967;left:193"><nobr><span class="ft3">Paragraphs in the Help have some attribute values that cannot be represented in </span></nobr></DIV> |
| <DIV style="position:absolute;top:988;left:193"><nobr><span class="ft3">OpenOffice.org without using certain workarounds. Therefore, you need to follow the </span></nobr></DIV> |
| <DIV style="position:absolute;top:1010;left:193"><nobr><span class="ft3">following instructions to create valid paragraphs.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1049;left:193"><nobr><span class="ft3">You can write the paragraph content in the usual way. You only have to ensure that</span></nobr></DIV> |
| <DIV style="position:absolute;top:1087;left:220"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:1089;left:247"><nobr><span class="ft3">the paragraph has <i>meta information</i> associated with it </span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>84</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 85 --> |
| <a name="85"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c085.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:137;left:290"><nobr><span class="ft3">the paragraph has a valid <i>paragraph format</i> assigned </span></nobr></DIV> |
| <DIV style="position:absolute;top:169;left:236"><nobr><span class="ft3">The paragraph <i>meta information</i> consists of the paragraph </span></nobr></DIV> |
| <DIV style="position:absolute;top:172;left:629"><nobr><span class="ft14">ID</span></nobr></DIV> |
| <DIV style="position:absolute;top:169;left:645"><nobr><span class="ft3">, the </span></nobr></DIV> |
| <DIV style="position:absolute;top:172;left:679"><nobr><span class="ft14">language</span></nobr></DIV> |
| <DIV style="position:absolute;top:169;left:744"><nobr><span class="ft3"> (which in </span></nobr></DIV> |
| <DIV style="position:absolute;top:192;left:236"><nobr><span class="ft3">the source files is always </span></nobr></DIV> |
| <DIV style="position:absolute;top:194;left:415"><nobr><span class="ft14">en-US</span></nobr></DIV> |
| <DIV style="position:absolute;top:192;left:455"><nobr><span class="ft3">), the </span></nobr></DIV> |
| <DIV style="position:absolute;top:194;left:497"><nobr><span class="ft14">localize</span></nobr></DIV> |
| <DIV style="position:absolute;top:192;left:562"><nobr><span class="ft3"> attribute, and some other attributes </span></nobr></DIV> |
| <DIV style="position:absolute;top:214;left:236"><nobr><span class="ft3">that are not relevant in this context.</span></nobr></DIV> |
| <DIV style="position:absolute;top:253;left:236"><nobr><span class="ft3">All of these values are stored in a <i>variable field</i> at the beginning of the paragraph. The </span></nobr></DIV> |
| <DIV style="position:absolute;top:274;left:236"><nobr><span class="ft3">paragraph </span></nobr></DIV> |
| <DIV style="position:absolute;top:276;left:308"><nobr><span class="ft14">ID</span></nobr></DIV> |
| <DIV style="position:absolute;top:274;left:324"><nobr><span class="ft3"> identifies the paragraph contents in the localization database. </span></nobr></DIV> |
| <DIV style="position:absolute;top:328;left:236"><nobr><span class="ft5"> If the </span></nobr></DIV> |
| <DIV style="position:absolute;top:328;left:288"><nobr><span class="ft14">ID</span></nobr></DIV> |
| <DIV style="position:absolute;top:328;left:304"><nobr><span class="ft5"> of a paragraph gets lost or is changed it is regarded as new for the database and needs to </span></nobr></DIV> |
| <DIV style="position:absolute;top:348;left:257"><nobr><span class="ft5">be localized again. So tampering with </span></nobr></DIV> |
| <DIV style="position:absolute;top:348;left:459"><nobr><span class="ft14">IDs</span></nobr></DIV> |
| <DIV style="position:absolute;top:348;left:483"><nobr><span class="ft5"> must be strictly avoided.</span></nobr></DIV> |
| <DIV style="position:absolute;top:399;left:236"><nobr><span class="ft3">Before saving the final file, each paragraph must have a valid and unique </span></nobr></DIV> |
| <DIV style="position:absolute;top:402;left:755"><nobr><span class="ft14">ID</span></nobr></DIV> |
| <DIV style="position:absolute;top:399;left:771"><nobr><span class="ft3">. The </span></nobr></DIV> |
| <DIV style="position:absolute;top:421;left:236"><nobr><span class="ft3">easiest way to do this is to place the cursor somewhere in the paragraph and to </span></nobr></DIV> |
| <DIV style="position:absolute;top:443;left:236"><nobr><span class="ft3">choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:444;left:288"><nobr><span class="ft11"><b>Help Authoring - Paragraph - Set Paragraph ID</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:443;left:694"><nobr><span class="ft3">. If the paragraph </span></nobr></DIV> |
| <DIV style="position:absolute;top:466;left:236"><nobr><span class="ft3">does not have the correct style associated (see below) ID creation will be denied. </span></nobr></DIV> |
| <DIV style="position:absolute;top:487;left:236"><nobr><span class="ft3">Paragraph IDs are also be assigned when the file is validated using </span></nobr></DIV> |
| <DIV style="position:absolute;top:488;left:691"><nobr><span class="ft11"><b>HelpAuthoring </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:511;left:236"><nobr><span class="ft11"><b> Validate</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:510;left:326"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:550;left:236"><nobr><span class="ft3">Not all paragraphs get IDs. Some paragraphs only contain structural information, such </span></nobr></DIV> |
| <DIV style="position:absolute;top:571;left:236"><nobr><span class="ft3">as opening and closing tags, or bookmarks, and don't need an ID because they don't </span></nobr></DIV> |
| <DIV style="position:absolute;top:593;left:236"><nobr><span class="ft3">transform back to content paragraphs in the help file. All these paragraphs have a </span></nobr></DIV> |
| <DIV style="position:absolute;top:614;left:236"><nobr><span class="ft3">paragraph style assigned that starts with </span></nobr></DIV> |
| <DIV style="position:absolute;top:616;left:508"><nobr><span class="ft14">hlp_aux_</span></nobr></DIV> |
| <DIV style="position:absolute;top:614;left:573"><nobr><span class="ft3">. </span></nobr></DIV> |
| <DIV style="position:absolute;top:654;left:236"><nobr><span class="ft3">If you forget to assign IDs to all corresponding paragraphs, the application will do that </span></nobr></DIV> |
| <DIV style="position:absolute;top:675;left:236"><nobr><span class="ft3">for you on saving, provided the template was correctly installed.</span></nobr></DIV> |
| <DIV style="position:absolute;top:726;left:236"><nobr><span class="ft8"><b>Editing A Paragraph</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:752;left:236"><nobr><span class="ft3">Editing the contents of a paragraph does not need any further action. The localization </span></nobr></DIV> |
| <DIV style="position:absolute;top:773;left:236"><nobr><span class="ft3">process finds out for itself when in the content of a paragraph has changed.[<A href="HelpAuthoring_c.html#85">12]</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:812;left:236"><nobr><span class="ft3">This has two consequences for the writers:</span></nobr></DIV> |
| <DIV style="position:absolute;top:851;left:263"><nobr><span class="ft3">1. You do not need to worry about whether a change has an influence on the </span></nobr></DIV> |
| <DIV style="position:absolute;top:872;left:290"><nobr><span class="ft3">localization.</span></nobr></DIV> |
| <DIV style="position:absolute;top:903;left:263"><nobr><span class="ft3">2. You cannot force re-translation of a paragraph by just setting any editing flag.</span></nobr></DIV> |
| <DIV style="position:absolute;top:933;left:236"><nobr><span class="ft3">For basic content management purposes, the </span></nobr></DIV> |
| <DIV style="position:absolute;top:935;left:554"><nobr><span class="ft14">l10n</span></nobr></DIV> |
| <DIV style="position:absolute;top:933;left:586"><nobr><span class="ft3"> attribute of a paragraph can be </span></nobr></DIV> |
| <DIV style="position:absolute;top:955;left:236"><nobr><span class="ft3">used for setting paragraph status values, since this attribute was only relevant for the </span></nobr></DIV> |
| <DIV style="position:absolute;top:977;left:236"><nobr><span class="ft3">migration phase.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1015;left:236"><nobr><span class="ft3">For instance, you can set the paragraph status to </span></nobr></DIV> |
| <DIV style="position:absolute;top:1018;left:595"><nobr><span class="ft14">NEW</span></nobr></DIV> |
| <DIV style="position:absolute;top:1015;left:619"><nobr><span class="ft3"> or </span></nobr></DIV> |
| <DIV style="position:absolute;top:1018;left:647"><nobr><span class="ft14">CHG</span></nobr></DIV> |
| <DIV style="position:absolute;top:1015;left:672"><nobr><span class="ft3"> (changed) to allow </span></nobr></DIV> |
| <DIV style="position:absolute;top:1038;left:236"><nobr><span class="ft3">reviewers to easily spot these paragraphs for content review. Any other values come </span></nobr></DIV> |
| <DIV style="position:absolute;top:1059;left:236"><nobr><span class="ft3">from the migration phase and are no longer relevant. Paragraphs that have been </span></nobr></DIV> |
| <DIV style="position:absolute;top:1081;left:236"><nobr><span class="ft3">reviewed don't carry an </span></nobr></DIV> |
| <DIV style="position:absolute;top:1083;left:394"><nobr><span class="ft14">l10n</span></nobr></DIV> |
| <DIV style="position:absolute;top:1081;left:427"><nobr><span class="ft3"> attribute (or carry an empty one).</span></nobr></DIV> |
| <DIV style="position:absolute;top:1114;left:128"><nobr><span class="ft19">12 For details on the localization process see </span></nobr></DIV> |
| <DIV style="position:absolute;top:1113;left:347"><nobr><span class="ft17">l10n.openoffice.org</span></nobr></DIV> |
| <DIV style="position:absolute;top:1114;left:484"><nobr><span class="ft19">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>85</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 86 --> |
| <a name="86"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c086.png" alt="background image"> |
| <DIV style="position:absolute;top:147;left:193"><nobr><span class="ft5"> Note that this attribute is evaluated <i>nowhere</i>. It only influences the display of the paragraph in </span></nobr></DIV> |
| <DIV style="position:absolute;top:166;left:214"><nobr><span class="ft5">OpenOffice.org (the meta data appear with yellow background). If you want to use it, you will have </span></nobr></DIV> |
| <DIV style="position:absolute;top:184;left:214"><nobr><span class="ft5">to take care of its evaluation in the context of content management yourself. </span></nobr></DIV> |
| <DIV style="position:absolute;top:246;left:193"><nobr><span class="ft8"><b>Paragraph Formatting</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:272;left:193"><nobr><span class="ft3">All paragraphs in a help file are formatted using paragraph styles. Direct formatting </span></nobr></DIV> |
| <DIV style="position:absolute;top:294;left:193"><nobr><span class="ft3">(borders, indentation, etc.) is <i>strictly unsupported</i>. In fact, all direct formatting will </span></nobr></DIV> |
| <DIV style="position:absolute;top:315;left:193"><nobr><span class="ft3">simply be <i>lost</i> on export.</span></nobr></DIV> |
| <DIV style="position:absolute;top:354;left:193"><nobr><span class="ft3">Use the predefined styles to format the paragraphs. The following styles are available </span></nobr></DIV> |
| <DIV style="position:absolute;top:375;left:193"><nobr><span class="ft3">in the help authoring template (switch to the </span></nobr></DIV> |
| <DIV style="position:absolute;top:376;left:487"><nobr><span class="ft11"><b>Custom</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:375;left:541"><nobr><span class="ft3"> view in the Stylist):</span></nobr></DIV> |
| <DIV style="position:absolute;top:420;left:220"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:423;left:247"><nobr><span class="ft14">hlp_default</span></nobr></DIV> |
| <DIV style="position:absolute;top:444;left:247"><nobr><span class="ft3">This is the parent style for all </span></nobr></DIV> |
| <DIV style="position:absolute;top:446;left:460"><nobr><span class="ft14">hlp_*</span></nobr></DIV> |
| <DIV style="position:absolute;top:444;left:501"><nobr><span class="ft3"> styles and only used as a fallback. It </span></nobr></DIV> |
| <DIV style="position:absolute;top:466;left:247"><nobr><span class="ft3">translates to a </span></nobr></DIV> |
| <DIV style="position:absolute;top:469;left:345"><nobr><span class="ft14">paragraph@role="paragraph"</span></nobr></DIV> |
| <DIV style="position:absolute;top:466;left:556"><nobr><span class="ft3"> in the help file.</span></nobr></DIV> |
| <DIV style="position:absolute;top:498;left:220"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:502;left:247"><nobr><span class="ft14">hlp_paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:500;left:352"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:523;left:247"><nobr><span class="ft3">This is the standard style to be used for paragraphs. It translates to a </span></nobr></DIV> |
| <DIV style="position:absolute;top:547;left:247"><nobr><span class="ft14">paragraph@role="paragraph"</span></nobr></DIV> |
| <DIV style="position:absolute;top:544;left:458"><nobr><span class="ft3"> in the help file.</span></nobr></DIV> |
| <DIV style="position:absolute;top:576;left:220"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:580;left:247"><nobr><span class="ft14">hlp_head</span></nobr></DIV> |
| <DIV style="position:absolute;top:578;left:312"><nobr><span class="ft3">, and </span></nobr></DIV> |
| <DIV style="position:absolute;top:580;left:349"><nobr><span class="ft14">hlp_head1...hlp_head5</span></nobr></DIV> |
| <DIV style="position:absolute;top:578;left:565"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:601;left:247"><nobr><span class="ft3">The </span></nobr></DIV> |
| <DIV style="position:absolute;top:603;left:280"><nobr><span class="ft14">hlp_head</span></nobr></DIV> |
| <DIV style="position:absolute;top:601;left:345"><nobr><span class="ft3"> style is the parent style for the other </span></nobr></DIV> |
| <DIV style="position:absolute;top:603;left:615"><nobr><span class="ft14">hlp_head*</span></nobr></DIV> |
| <DIV style="position:absolute;top:601;left:688"><nobr><span class="ft3"> styles and </span></nobr></DIV> |
| <DIV style="position:absolute;top:623;left:247"><nobr><span class="ft3">should never be used as such. The </span></nobr></DIV> |
| <DIV style="position:absolute;top:625;left:512"><nobr><span class="ft14">hlp_head*</span></nobr></DIV> |
| <DIV style="position:absolute;top:623;left:585"><nobr><span class="ft3"> styles designate heading </span></nobr></DIV> |
| <DIV style="position:absolute;top:645;left:247"><nobr><span class="ft3">elements</span></nobr></DIV> |
| <DIV style="position:absolute;top:645;left:326"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:645;left:349"><nobr><span class="ft3">of</span></nobr></DIV> |
| <DIV style="position:absolute;top:645;left:380"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:645;left:402"><nobr><span class="ft3">different</span></nobr></DIV> |
| <DIV style="position:absolute;top:645;left:475"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:645;left:497"><nobr><span class="ft3">levels.</span></nobr></DIV> |
| <DIV style="position:absolute;top:645;left:558"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:645;left:581"><nobr><span class="ft3">They</span></nobr></DIV> |
| <DIV style="position:absolute;top:645;left:632"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:645;left:655"><nobr><span class="ft3">translate</span></nobr></DIV> |
| <DIV style="position:absolute;top:645;left:731"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:645;left:753"><nobr><span class="ft3">to </span></nobr></DIV> |
| <DIV style="position:absolute;top:669;left:247"><nobr><span class="ft14">paragraph@role="heading"@level="x"</span></nobr></DIV> |
| <DIV style="position:absolute;top:667;left:522"><nobr><span class="ft3"> in the help file with </span></nobr></DIV> |
| <DIV style="position:absolute;top:669;left:658"><nobr><span class="ft9">x</span></nobr></DIV> |
| <DIV style="position:absolute;top:667;left:666"><nobr><span class="ft3"> corresponding </span></nobr></DIV> |
| <DIV style="position:absolute;top:689;left:247"><nobr><span class="ft3">to the heading level.</span></nobr></DIV> |
| <DIV style="position:absolute;top:720;left:220"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:724;left:247"><nobr><span class="ft14">hlp_listitem</span></nobr></DIV> |
| <DIV style="position:absolute;top:745;left:247"><nobr><span class="ft3">This is the style to be used for list items. Its use is optional, as paragraphs </span></nobr></DIV> |
| <DIV style="position:absolute;top:766;left:247"><nobr><span class="ft3">inside list items can also have the paragraph style. It translates to a </span></nobr></DIV> |
| <DIV style="position:absolute;top:790;left:247"><nobr><span class="ft14">paragraph@role="listitem"</span></nobr></DIV> |
| <DIV style="position:absolute;top:787;left:450"><nobr><span class="ft3"> in the help file.</span></nobr></DIV> |
| <DIV style="position:absolute;top:819;left:220"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:823;left:247"><nobr><span class="ft14">hlp_tablehead</span></nobr></DIV> |
| <DIV style="position:absolute;top:844;left:247"><nobr><span class="ft3">This is the style to be used for table header cells. It translates to a </span></nobr></DIV> |
| <DIV style="position:absolute;top:867;left:247"><nobr><span class="ft14">paragraph@role="tablehead"</span></nobr></DIV> |
| <DIV style="position:absolute;top:865;left:458"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:865;left:486"><nobr><span class="ft3">in the help file when the </span></nobr></DIV> |
| <DIV style="position:absolute;top:890;left:247"><nobr><span class="ft14">main_transform.xsl</span></nobr></DIV> |
| <DIV style="position:absolute;top:887;left:393"><nobr><span class="ft3"> stylesheet is used.</span></nobr></DIV> |
| <DIV style="position:absolute;top:919;left:220"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:923;left:247"><nobr><span class="ft14">hlp_tablecontent</span></nobr></DIV> |
| <DIV style="position:absolute;top:921;left:406"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:944;left:247"><nobr><span class="ft3">This is the style to be used for table content cells. It translates to a </span></nobr></DIV> |
| <DIV style="position:absolute;top:946;left:693"><nobr><span class="ft14">paragraph </span></nobr></DIV> |
| <DIV style="position:absolute;top:968;left:247"><nobr><span class="ft14">@role="tablecontent"</span></nobr></DIV> |
| <DIV style="position:absolute;top:966;left:409"><nobr><span class="ft3"> in the help file.</span></nobr></DIV> |
| <DIV style="position:absolute;top:998;left:220"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:1000;left:247"><nobr><span class="ft3">A couple of </span></nobr></DIV> |
| <DIV style="position:absolute;top:1002;left:326"><nobr><span class="ft14">hlp_aux_*</span></nobr></DIV> |
| <DIV style="position:absolute;top:1000;left:399"><nobr><span class="ft3"> styles</span></nobr></DIV> |
| <DIV style="position:absolute;top:1000;left:459"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:1023;left:247"><nobr><span class="ft3">These are not meant to be used by the writers. These styles designate </span></nobr></DIV> |
| <DIV style="position:absolute;top:1044;left:247"><nobr><span class="ft3">paragraphs that contain structural information rather than content.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>86</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 87 --> |
| <a name="87"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c087.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:236"><nobr><span class="ft8"><b>Creating New Styles</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:162;left:236"><nobr><span class="ft3">If the styles in the pre-defined set are not sufficient for your purpose you can create </span></nobr></DIV> |
| <DIV style="position:absolute;top:183;left:236"><nobr><span class="ft3">new styles as long as they follow these rules:</span></nobr></DIV> |
| <DIV style="position:absolute;top:222;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:224;left:290"><nobr><span class="ft3">A new paragraph style <i>must</i> be based on the </span></nobr></DIV> |
| <DIV style="position:absolute;top:226;left:591"><nobr><span class="ft14">hlp_default</span></nobr></DIV> |
| <DIV style="position:absolute;top:224;left:681"><nobr><span class="ft3"> style </span></nobr></DIV> |
| <DIV style="position:absolute;top:256;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:257;left:290"><nobr><span class="ft3">The style name <i>must</i> begin with </span></nobr></DIV> |
| <DIV style="position:absolute;top:259;left:505"><nobr><span class="ft14">hlp_</span></nobr></DIV> |
| <DIV style="position:absolute;top:257;left:537"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:289;left:263"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:290;left:290"><nobr><span class="ft3">The style name <i>must not</i> begin with </span></nobr></DIV> |
| <DIV style="position:absolute;top:293;left:530"><nobr><span class="ft14">hlp_aux_</span></nobr></DIV> |
| <DIV style="position:absolute;top:290;left:594"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:322;left:236"><nobr><span class="ft3">You can use these styles in the help document. They will be transformed to values of </span></nobr></DIV> |
| <DIV style="position:absolute;top:344;left:236"><nobr><span class="ft3">the </span></nobr></DIV> |
| <DIV style="position:absolute;top:346;left:261"><nobr><span class="ft9">role</span></nobr></DIV> |
| <DIV style="position:absolute;top:344;left:293"><nobr><span class="ft3"> attribute for a paragraph in the help file, for instance, </span></nobr></DIV> |
| <DIV style="position:absolute;top:346;left:653"><nobr><span class="ft14">hlp_mystyle</span></nobr></DIV> |
| <DIV style="position:absolute;top:344;left:742"><nobr><span class="ft3"> will result </span></nobr></DIV> |
| <DIV style="position:absolute;top:366;left:236"><nobr><span class="ft3">in a paragraph with the </span></nobr></DIV> |
| <DIV style="position:absolute;top:368;left:392"><nobr><span class="ft14">role</span></nobr></DIV> |
| <DIV style="position:absolute;top:366;left:425"><nobr><span class="ft3"> set to </span></nobr></DIV> |
| <DIV style="position:absolute;top:368;left:470"><nobr><span class="ft14">mystyle</span></nobr></DIV> |
| <DIV style="position:absolute;top:366;left:526"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:406;left:236"><nobr><span class="ft3">This style will be reconstructed when the help file is loaded. But any formatting </span></nobr></DIV> |
| <DIV style="position:absolute;top:427;left:236"><nobr><span class="ft3">information for OpenOffice.org will be lost. Also, the style will only be available in that </span></nobr></DIV> |
| <DIV style="position:absolute;top:448;left:236"><nobr><span class="ft3">file. If you want the style to be available for all documents and have a defined </span></nobr></DIV> |
| <DIV style="position:absolute;top:470;left:236"><nobr><span class="ft3">appearance it must be added to the help authoring template.</span></nobr></DIV> |
| <DIV style="position:absolute;top:509;left:236"><nobr><span class="ft3">In order to have a special appearance in the final help, the role must also be </span></nobr></DIV> |
| <DIV style="position:absolute;top:530;left:236"><nobr><span class="ft3">addressed in the stylesheets that are delivered with the help and define its </span></nobr></DIV> |
| <DIV style="position:absolute;top:551;left:236"><nobr><span class="ft3">appearance. </span></nobr></DIV> |
| <DIV style="position:absolute;top:607;left:236"><nobr><span class="ft8"><b>Changing A Paragraph Style</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:632;left:236"><nobr><span class="ft3">Changing the style of a paragraph has no impact on the localization process. Only the </span></nobr></DIV> |
| <DIV style="position:absolute;top:654;left:236"><nobr><span class="ft3">contents of a paragraph (including inline elements) are subject to localization.</span></nobr></DIV> |
| <DIV style="position:absolute;top:709;left:236"><nobr><span class="ft8"><b>Changing A Character Style</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:735;left:236"><nobr><span class="ft3">Changing the style of a character inside a paragraph <i>does</i> have an impact on the </span></nobr></DIV> |
| <DIV style="position:absolute;top:756;left:236"><nobr><span class="ft3">localization of that paragraph since the character style transforms to an </span></nobr></DIV> |
| <DIV style="position:absolute;top:780;left:236"><nobr><span class="ft14"><item type=""></span></nobr></DIV> |
| <DIV style="position:absolute;top:777;left:349"><nobr><span class="ft3"> inline element.</span></nobr></DIV> |
| <DIV style="position:absolute;top:834;left:236"><nobr><span class="ft8"><b>Moving A Paragraph Inside A Help File</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:859;left:236"><nobr><span class="ft3">You can safely move a paragraph in a help file without the need of further action. The </span></nobr></DIV> |
| <DIV style="position:absolute;top:881;left:236"><nobr><span class="ft3">paragraph styles might need adjustment if the paragraph is moved to a different </span></nobr></DIV> |
| <DIV style="position:absolute;top:902;left:236"><nobr><span class="ft3">context in a help file.</span></nobr></DIV> |
| <DIV style="position:absolute;top:955;left:236"><nobr><span class="ft5"> Ensure that you also move the paragraph meta data that are stored in the variable field at the start </span></nobr></DIV> |
| <DIV style="position:absolute;top:975;left:257"><nobr><span class="ft5">of the paragraph. If you <i>copy</i> a paragraph, however, <i>never</i> copy the meta data. The </span></nobr></DIV> |
| <DIV style="position:absolute;top:975;left:713"><nobr><span class="ft14">ID</span></nobr></DIV> |
| <DIV style="position:absolute;top:975;left:730"><nobr><span class="ft5"> of a para-</span></nobr></DIV> |
| <DIV style="position:absolute;top:994;left:257"><nobr><span class="ft5">graph <i>must</i> be unique within a help file. </span></nobr></DIV> |
| <DIV style="position:absolute;top:1061;left:236"><nobr><span class="ft8"><b>Moving A Paragraph To A Different Help File</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1086;left:236"><nobr><span class="ft3">Moving a paragraph from one file to another is a sequence of deleting and creating </span></nobr></DIV> |
| <DIV style="position:absolute;top:1108;left:236"><nobr><span class="ft3">that can be accomplished by cutting and pasting the paragraph <i>without</i> its meta data. </span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>87</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 88 --> |
| <a name="88"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c088.png" alt="background image"> |
| <DIV style="position:absolute;top:147;left:193"><nobr><span class="ft5"> For localization purposes, this will be recognized as a new paragraph.</span></nobr></DIV> |
| <DIV style="position:absolute;top:210;left:193"><nobr><span class="ft8"><b>Excluding A Paragraph From Localization</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:236;left:193"><nobr><span class="ft3">Paragraphs can be excluded from localization. In this case, the localized help files </span></nobr></DIV> |
| <DIV style="position:absolute;top:258;left:193"><nobr><span class="ft3">contain the English source for the corresponding paragraph. This is controlled by the </span></nobr></DIV> |
| <DIV style="position:absolute;top:281;left:193"><nobr><span class="ft14">localize</span></nobr></DIV> |
| <DIV style="position:absolute;top:279;left:258"><nobr><span class="ft3"> attribute of a paragraph. If it is set to </span></nobr></DIV> |
| <DIV style="position:absolute;top:281;left:540"><nobr><span class="ft14">false</span></nobr></DIV> |
| <DIV style="position:absolute;top:279;left:580"><nobr><span class="ft3"> the paragraph will not be </span></nobr></DIV> |
| <DIV style="position:absolute;top:301;left:193"><nobr><span class="ft3">localized, in <i>all other cases</i> it will.</span></nobr></DIV> |
| <DIV style="position:absolute;top:340;left:193"><nobr><span class="ft3">To exclude a paragraph from localization choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:341;left:528"><nobr><span class="ft11"><b>Help Authoring - Paragraph </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:364;left:193"><nobr><span class="ft11"><b>- Exclude from L10N</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:363;left:364"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>88</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 89 --> |
| <a name="89"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c089.png" alt="background image"> |
| <DIV style="position:absolute;top:154;left:236"><nobr><span class="ft10"><b>Tables </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:200;left:236"><nobr><span class="ft8"><b>Adding A Table</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:226;left:263"><nobr><span class="ft3">1. Choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:227;left:345"><nobr><span class="ft11"><b>Help Authoring - Table - Insert Table</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:226;left:678"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:469;left:263"><nobr><span class="ft3">2. Insert the initial number of rows and columns in the corresponding text boxes.</span></nobr></DIV> |
| <DIV style="position:absolute;top:508;left:263"><nobr><span class="ft3">3. You can change the table layout after creation, if required.</span></nobr></DIV> |
| <DIV style="position:absolute;top:547;left:263"><nobr><span class="ft3">4. The </span></nobr></DIV> |
| <DIV style="position:absolute;top:549;left:320"><nobr><span class="ft14">width</span></nobr></DIV> |
| <DIV style="position:absolute;top:547;left:360"><nobr><span class="ft3"> and </span></nobr></DIV> |
| <DIV style="position:absolute;top:549;left:393"><nobr><span class="ft14">height</span></nobr></DIV> |
| <DIV style="position:absolute;top:547;left:442"><nobr><span class="ft3"> values are currently unsupported.</span></nobr></DIV> |
| <DIV style="position:absolute;top:586;left:263"><nobr><span class="ft3">5. If required, insert a table caption in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:587;left:549"><nobr><span class="ft11"><b>Caption</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:586;left:612"><nobr><span class="ft3"> text field.</span></nobr></DIV> |
| <DIV style="position:absolute;top:626;left:263"><nobr><span class="ft3">6. You can exclude the caption from localization by clearing the </span></nobr></DIV> |
| <DIV style="position:absolute;top:628;left:736"><nobr><span class="ft11"><b>Localize </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:649;left:290"><nobr><span class="ft3">check box.</span></nobr></DIV> |
| <DIV style="position:absolute;top:688;left:263"><nobr><span class="ft3">7. Click </span></nobr></DIV> |
| <DIV style="position:absolute;top:689;left:326"><nobr><span class="ft11"><b>Ok</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:688;left:344"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:742;left:236"><nobr><span class="ft5"> Nested tables are unsupported. You cannot insert a table in another table. </span></nobr></DIV> |
| <DIV style="position:absolute;top:795;left:236"><nobr><span class="ft5"> The meta data of the table are stored "encoded" in the <i>Name</i> property of the table in </span></nobr></DIV> |
| <DIV style="position:absolute;top:814;left:257"><nobr><span class="ft5">OpenOffice.org. This must be left untouched.</span></nobr></DIV> |
| <DIV style="position:absolute;top:864;left:236"><nobr><span class="ft3">The created table is followed by a paragraph containing the caption, if a caption was </span></nobr></DIV> |
| <DIV style="position:absolute;top:885;left:236"><nobr><span class="ft3">defined. </span></nobr></DIV> |
| <DIV style="position:absolute;top:936;left:236"><nobr><span class="ft8"><b>Modifying The Table Layout</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:962;left:236"><nobr><span class="ft3">After creation of the table you can change the table layout to suit your needs. You can </span></nobr></DIV> |
| <DIV style="position:absolute;top:983;left:236"><nobr><span class="ft3">add or remove rows or columns. </span></nobr></DIV> |
| <DIV style="position:absolute;top:1022;left:236"><nobr><span class="ft3">Initially, the column widths will be distributed equally. You can manually resize the </span></nobr></DIV> |
| <DIV style="position:absolute;top:1044;left:236"><nobr><span class="ft3">column widths but for now this will <i>be lost</i> on next reload.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1097;left:236"><nobr><span class="ft5"> <i>Never ever</i> merge cells. Complex layouts are untested and </span></nobr></DIV> |
| <DIV style="position:absolute;top:1096;left:573"><nobr><span class="ft28">can</span></nobr></DIV> |
| <DIV style="position:absolute;top:1097;left:595"><nobr><span class="ft5"> lead to unexpected results. </span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>89</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 90 --> |
| <a name="90"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c090.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:193"><nobr><span class="ft8"><b>Deleting A Table</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:162;left:193"><nobr><span class="ft3">Delete a table as usual in OpenOffice.org. Make sure that the trailing paragraph with </span></nobr></DIV> |
| <DIV style="position:absolute;top:183;left:193"><nobr><span class="ft3">the caption is also removed.</span></nobr></DIV> |
| <DIV style="position:absolute;top:235;left:193"><nobr><span class="ft8"><b>Using A Table For Formatting Purposes</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:261;left:193"><nobr><span class="ft13"><i>Don't do that.</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:299;left:193"><nobr><span class="ft3">There are still many places in the help files that use tables for formatting. We will try to </span></nobr></DIV> |
| <DIV style="position:absolute;top:321;left:193"><nobr><span class="ft3">get rid of these occurrences over time.</span></nobr></DIV> |
| <DIV style="position:absolute;top:372;left:193"><nobr><span class="ft8"><b>Adding A Caption To An Existing Table</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:398;left:193"><nobr><span class="ft3">When you have created a table and want to add a caption to it proceed as follows:</span></nobr></DIV> |
| <DIV style="position:absolute;top:437;left:220"><nobr><span class="ft3">1. Place the cursor <i>after</i> the paragraph containing the table attributes.</span></nobr></DIV> |
| <DIV style="position:absolute;top:458;left:247"><nobr><span class="ft3">In any other place the script will reject adding a caption.</span></nobr></DIV> |
| <DIV style="position:absolute;top:497;left:220"><nobr><span class="ft3">2. Choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:498;left:303"><nobr><span class="ft11"><b>Help Authoring - Table - Insert Table Caption</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:497;left:708"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:537;left:220"><nobr><span class="ft3">3. Specify the caption text and click </span></nobr></DIV> |
| <DIV style="position:absolute;top:538;left:469"><nobr><span class="ft11"><b>Ok</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:537;left:487"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:590;left:193"><nobr><span class="ft10"><b>Lists</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:637;left:193"><nobr><span class="ft8"><b>Inserting, Removing, Modifying Lists</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:663;left:193"><nobr><span class="ft3">You can work with lists as you would usually do in OpenOffice.org if you note the </span></nobr></DIV> |
| <DIV style="position:absolute;top:684;left:193"><nobr><span class="ft3">following:</span></nobr></DIV> |
| <DIV style="position:absolute;top:735;left:193"><nobr><span class="ft8"><b>Interrupting A List</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:761;left:193"><nobr><span class="ft3">A list that is interrupted by a paragraph that is not part of the list, and then continued </span></nobr></DIV> |
| <DIV style="position:absolute;top:782;left:193"><nobr><span class="ft3">with the next number as displayed below on the left, is unsupported. If you create </span></nobr></DIV> |
| <DIV style="position:absolute;top:804;left:193"><nobr><span class="ft3">such a list in OpenOffice.org it will transform to the list below on the right after the </span></nobr></DIV> |
| <DIV style="position:absolute;top:825;left:193"><nobr><span class="ft3">reload. You will end up with two separate lists both starting with 1 (see<A href="HelpAuthoring_c.html#91"> Fig. 7)</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:864;left:193"><nobr><span class="ft3">A list where the paragraph is unnumbered but is still part of the list item is supported </span></nobr></DIV> |
| <DIV style="position:absolute;top:885;left:193"><nobr><span class="ft3">and will work fine. In OpenOffice.org you achieve this by pressing the </span></nobr></DIV> |
| <DIV style="position:absolute;top:888;left:664"><nobr><span class="ft12"><b>Backspace</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:885;left:737"><nobr><span class="ft3"> key </span></nobr></DIV> |
| <DIV style="position:absolute;top:908;left:193"><nobr><span class="ft3">once to get rid of the list number.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>90</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 91 --> |
| <a name="91"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c091.png" alt="background image"> |
| <DIV style="position:absolute;top:268;left:367"><nobr><span class="ft5">before</span></nobr></DIV> |
| <DIV style="position:absolute;top:266;left:539"><nobr><span class="ft5">after reload</span></nobr></DIV> |
| <DIV style="position:absolute;top:290;left:449"><nobr><span class="ft15"><i>Fig. 7: Incorrect list design</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:464;left:367"><nobr><span class="ft5">before</span></nobr></DIV> |
| <DIV style="position:absolute;top:464;left:539"><nobr><span class="ft5">after reload</span></nobr></DIV> |
| <DIV style="position:absolute;top:486;left:455"><nobr><span class="ft15"><i>Fig. 8: Correct list design</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:517;left:236"><nobr><span class="ft3">Images in lists can be placed in such paragraphs. There is no need to mimic lists </span></nobr></DIV> |
| <DIV style="position:absolute;top:538;left:236"><nobr><span class="ft3">using table constructions.</span></nobr></DIV> |
| <DIV style="position:absolute;top:590;left:236"><nobr><span class="ft10"><b>Working with Images</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:636;left:236"><nobr><span class="ft8"><b>Help Image Repository</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:662;left:236"><nobr><span class="ft3">Help images are stored inside the </span></nobr></DIV> |
| <DIV style="position:absolute;top:665;left:470"><nobr><span class="ft14">res/helpimg</span></nobr></DIV> |
| <DIV style="position:absolute;top:662;left:559"><nobr><span class="ft3"> subdirectory of the </span></nobr></DIV> |
| <DIV style="position:absolute;top:665;left:695"><nobr><span class="ft14">default_images </span></nobr></DIV> |
| <DIV style="position:absolute;top:685;left:236"><nobr><span class="ft3">CVS module. Images that are used by the help need to be added to this repository </span></nobr></DIV> |
| <DIV style="position:absolute;top:706;left:236"><nobr><span class="ft3">module. See </span></nobr></DIV> |
| <DIV style="position:absolute;top:708;left:327"><nobr><span class="ft14">tools.openoffice.org</span></nobr></DIV> |
| <DIV style="position:absolute;top:706;left:489"><nobr><span class="ft3"> for details on working with the OpenOffice.org </span></nobr></DIV> |
| <DIV style="position:absolute;top:728;left:236"><nobr><span class="ft3">CVS repository.</span></nobr></DIV> |
| <DIV style="position:absolute;top:767;left:236"><nobr><span class="ft3">The </span></nobr></DIV> |
| <DIV style="position:absolute;top:770;left:268"><nobr><span class="ft14">helpimg</span></nobr></DIV> |
| <DIV style="position:absolute;top:767;left:325"><nobr><span class="ft3"> directory contains all help images in English. Subdirectories for each </span></nobr></DIV> |
| <DIV style="position:absolute;top:789;left:236"><nobr><span class="ft3">language (except for the source language which is </span></nobr></DIV> |
| <DIV style="position:absolute;top:792;left:609"><nobr><span class="ft14">en-US</span></nobr></DIV> |
| <DIV style="position:absolute;top:789;left:650"><nobr><span class="ft3">) contain the localized </span></nobr></DIV> |
| <DIV style="position:absolute;top:812;left:236"><nobr><span class="ft3">images. If an image does not need localization it only needs to be present in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:835;left:236"><nobr><span class="ft14">helpimg</span></nobr></DIV> |
| <DIV style="position:absolute;top:833;left:292"><nobr><span class="ft3"> directory. The subdirectories are named using the ISO codes for language </span></nobr></DIV> |
| <DIV style="position:absolute;top:855;left:236"><nobr><span class="ft3">and country as described on page <A href="HelpAuthoring_c.html#13">13</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:899;left:236"><nobr><span class="ft25"><i>To add an image to the repository</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:925;left:263"><nobr><span class="ft3">1. Place the English image inside the </span></nobr></DIV> |
| <DIV style="position:absolute;top:927;left:585"><nobr><span class="ft14">res/helpimg</span></nobr></DIV> |
| <DIV style="position:absolute;top:925;left:674"><nobr><span class="ft3"> directory of the </span></nobr></DIV> |
| <DIV style="position:absolute;top:950;left:290"><nobr><span class="ft14">default_images</span></nobr></DIV> |
| <DIV style="position:absolute;top:947;left:403"><nobr><span class="ft3"> module.</span></nobr></DIV> |
| <DIV style="position:absolute;top:978;left:263"><nobr><span class="ft3">2. Place the localized images inside the corresponding language subdirectories of </span></nobr></DIV> |
| <DIV style="position:absolute;top:1002;left:290"><nobr><span class="ft14">res/helpimg</span></nobr></DIV> |
| <DIV style="position:absolute;top:1000;left:377"><nobr><span class="ft3">, for example </span></nobr></DIV> |
| <DIV style="position:absolute;top:1002;left:466"><nobr><span class="ft14">zh-CN</span></nobr></DIV> |
| <DIV style="position:absolute;top:1000;left:506"><nobr><span class="ft3"> for simplified Chinese.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1022;left:290"><nobr><span class="ft3">You must mark the image as to be localized using the </span></nobr></DIV> |
| <DIV style="position:absolute;top:1023;left:663"><nobr><span class="ft11"><b>Help Authoring - </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1046;left:290"><nobr><span class="ft11"><b>Image Image needs L10N</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1045;left:510"><nobr><span class="ft3"> menu. An image that needs localization will </span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>91</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 92 --> |
| <a name="92"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c092.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:247"><nobr><span class="ft3">appear with a red border in OpenOffice.org (not in the final help, of course).</span></nobr></DIV> |
| <DIV style="position:absolute;top:157;left:247"><nobr><span class="ft3">You can use </span></nobr></DIV> |
| <DIV style="position:absolute;top:159;left:338"><nobr><span class="ft11"><b>Help Authoring - Image No L10N for Image</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:157;left:713"><nobr><span class="ft3"> to clear </span></nobr></DIV> |
| <DIV style="position:absolute;top:180;left:247"><nobr><span class="ft3">the localization mark.</span></nobr></DIV> |
| <DIV style="position:absolute;top:217;left:268"><nobr><span class="ft5">If the image is not marked as to be localized, the help will <b>always</b> display the English </span></nobr></DIV> |
| <DIV style="position:absolute;top:235;left:268"><nobr><span class="ft5">image regardless whether there are localized images available.</span></nobr></DIV> |
| <DIV style="position:absolute;top:268;left:220"><nobr><span class="ft3">3. Open the file </span></nobr></DIV> |
| <DIV style="position:absolute;top:271;left:351"><nobr><span class="ft14">helpimg.ilst</span></nobr></DIV> |
| <DIV style="position:absolute;top:268;left:448"><nobr><span class="ft3"> in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:271;left:508"><nobr><span class="ft14">util</span></nobr></DIV> |
| <DIV style="position:absolute;top:268;left:541"><nobr><span class="ft3"> directory of the </span></nobr></DIV> |
| <DIV style="position:absolute;top:271;left:668"><nobr><span class="ft14">helpcontent2 </span></nobr></DIV> |
| <DIV style="position:absolute;top:291;left:247"><nobr><span class="ft3">module and add the English and all localized variants to the file. Keep the file </span></nobr></DIV> |
| <DIV style="position:absolute;top:312;left:247"><nobr><span class="ft3">entries sorted.</span></nobr></DIV> |
| <DIV style="position:absolute;top:347;left:193"><nobr><span class="ft25"><i>To Remove an Image from the Repository</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:373;left:220"><nobr><span class="ft3">1. Remove the English and localized files from the CVS</span></nobr></DIV> |
| <DIV style="position:absolute;top:403;left:220"><nobr><span class="ft3">2. Open the file </span></nobr></DIV> |
| <DIV style="position:absolute;top:406;left:351"><nobr><span class="ft14">helpimg.ilst</span></nobr></DIV> |
| <DIV style="position:absolute;top:403;left:448"><nobr><span class="ft3"> in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:406;left:508"><nobr><span class="ft14">util</span></nobr></DIV> |
| <DIV style="position:absolute;top:403;left:541"><nobr><span class="ft3"> directory of the </span></nobr></DIV> |
| <DIV style="position:absolute;top:406;left:668"><nobr><span class="ft14">helpcontent2 </span></nobr></DIV> |
| <DIV style="position:absolute;top:426;left:247"><nobr><span class="ft3">module and remove the corresponding file entries.</span></nobr></DIV> |
| <DIV style="position:absolute;top:468;left:193"><nobr><span class="ft8"><b>Inserting A Block Image</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:494;left:193"><nobr><span class="ft3">A block image is an image that is located in a paragraph of its own. It can contain a </span></nobr></DIV> |
| <DIV style="position:absolute;top:516;left:193"><nobr><span class="ft3">caption.</span></nobr></DIV> |
| <DIV style="position:absolute;top:546;left:220"><nobr><span class="ft3">1. Choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:547;left:303"><nobr><span class="ft11"><b>HelpAuthoring - Image - Insert Image</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:546;left:627"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:578;left:220"><nobr><span class="ft3">2. Select an image file to insert and click </span></nobr></DIV> |
| <DIV style="position:absolute;top:579;left:502"><nobr><span class="ft11"><b>Open</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:578;left:538"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:600;left:247"><nobr><span class="ft3">The image <i>must</i> be located inside the help file hierarchy as described in </span></nobr></DIV> |
| <DIV style="position:absolute;top:622;left:247"><nobr><span class="ft13"><A href="HelpAuthoring_c.html#75"><i>Setting Up the Environment </i></a>on page<A href="HelpAuthoring_c.html#75"> 75.</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:652;left:220"><nobr><span class="ft3">3. Specify an alternative text for the image (<i>mandatory</i>). This text is needed to </span></nobr></DIV> |
| <DIV style="position:absolute;top:673;left:247"><nobr><span class="ft3">comply with accessibility regulations.</span></nobr></DIV> |
| <DIV style="position:absolute;top:704;left:220"><nobr><span class="ft3">4. Specify a caption text for the image (<i>optional</i>).</span></nobr></DIV> |
| <DIV style="position:absolute;top:734;left:193"><nobr><span class="ft3">The image will be added on a paragraph of its own surrounded by </span></nobr></DIV> |
| <DIV style="position:absolute;top:736;left:658"><nobr><span class="ft14">img</span></nobr></DIV> |
| <DIV style="position:absolute;top:734;left:682"><nobr><span class="ft3"> tags. If you </span></nobr></DIV> |
| <DIV style="position:absolute;top:756;left:193"><nobr><span class="ft3">have specified a caption this caption text will appear inside </span></nobr></DIV> |
| <DIV style="position:absolute;top:759;left:586"><nobr><span class="ft14">imgcaption</span></nobr></DIV> |
| <DIV style="position:absolute;top:756;left:667"><nobr><span class="ft3"> tags.</span></nobr></DIV> |
| <DIV style="position:absolute;top:800;left:193"><nobr><span class="ft8"><b>Inserting An Inline Image</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:826;left:193"><nobr><span class="ft3">An inline image is an image that is displayed inline in between paragraph text. It can </span></nobr></DIV> |
| <DIV style="position:absolute;top:847;left:193"><nobr><span class="ft3">not contain a caption.</span></nobr></DIV> |
| <DIV style="position:absolute;top:878;left:220"><nobr><span class="ft3">1. Choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:879;left:303"><nobr><span class="ft11"><b>HelpAuthoring - Image - Insert Inline Image</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:878;left:690"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:909;left:220"><nobr><span class="ft3">2. Select an image file to insert and click </span></nobr></DIV> |
| <DIV style="position:absolute;top:910;left:502"><nobr><span class="ft11"><b>Open</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:909;left:538"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:932;left:247"><nobr><span class="ft3">The image <i>must</i> be located inside the help file hierarchy as described in </span></nobr></DIV> |
| <DIV style="position:absolute;top:953;left:247"><nobr><span class="ft13"><A href="HelpAuthoring_c.html#75"><i>Setting Up the Environment </i></a>on page<A href="HelpAuthoring_c.html#75"> 75.</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:984;left:220"><nobr><span class="ft3">3. Specify an alternative text for the image (<i>mandatory</i>).</span></nobr></DIV> |
| <DIV style="position:absolute;top:1005;left:247"><nobr><span class="ft3">This text is needed to comply with accessibility regulations. The image will be </span></nobr></DIV> |
| <DIV style="position:absolute;top:1026;left:247"><nobr><span class="ft3">added to the paragraph surrounded by </span></nobr></DIV> |
| <DIV style="position:absolute;top:1029;left:507"><nobr><span class="ft9">img</span></nobr></DIV> |
| <DIV style="position:absolute;top:1026;left:531"><nobr><span class="ft3"> tags.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>92</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 93 --> |
| <a name="93"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c093.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:236"><nobr><span class="ft8"><b>Adding An Image Caption</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:162;left:236"><nobr><span class="ft3">You can add a caption to an existing block image.</span></nobr></DIV> |
| <DIV style="position:absolute;top:192;left:263"><nobr><span class="ft3">1. Choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:193;left:345"><nobr><span class="ft11"><b>HelpAuthoring - Image - Insert Caption</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:192;left:687"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:224;left:263"><nobr><span class="ft3">2. Specify a caption and click </span></nobr></DIV> |
| <DIV style="position:absolute;top:225;left:471"><nobr><span class="ft11"><b>Ok</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:224;left:489"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:277;left:236"><nobr><span class="ft10"><b>Embedding Content </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:324;left:236"><nobr><span class="ft8"><b>Embedding A Section Or Variable</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:350;left:267"><nobr><span class="ft3">1. Choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:351;left:345"><nobr><span class="ft11"><b>Help Authoring - Embed Sections or Variables</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:350;left:741"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:568;left:267"><nobr><span class="ft3">2. Enter the name of the file that contains the section or variable to be </span></nobr></DIV> |
| <DIV style="position:absolute;top:590;left:289"><nobr><span class="ft3">embedded in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:591;left:410"><nobr><span class="ft11"><b>File Name</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:590;left:493"><nobr><span class="ft3"> text box or click </span></nobr></DIV> |
| <DIV style="position:absolute;top:591;left:614"><nobr><span class="ft11"><b>Browse</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:590;left:668"><nobr><span class="ft3"> to browse for a file. </span></nobr></DIV> |
| <DIV style="position:absolute;top:612;left:289"><nobr><span class="ft3">The path starts with the </span></nobr></DIV> |
| <DIV style="position:absolute;top:615;left:462"><nobr><span class="ft9">text</span></nobr></DIV> |
| <DIV style="position:absolute;top:612;left:494"><nobr><span class="ft3"> directory in the help directory hierarchy (see </span></nobr></DIV> |
| <DIV style="position:absolute;top:635;left:289"><nobr><span class="ft3">page<A href="HelpAuthoring_c.html#75"> 75)</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:673;left:267"><nobr><span class="ft3">3. Select whether a variable (text block in a paragraph or the complete contents </span></nobr></DIV> |
| <DIV style="position:absolute;top:695;left:289"><nobr><span class="ft3">of a paragraph) or a section is to be embedded.</span></nobr></DIV> |
| <DIV style="position:absolute;top:734;left:267"><nobr><span class="ft3">4. Insert the section or variable </span></nobr></DIV> |
| <DIV style="position:absolute;top:736;left:504"><nobr><span class="ft14">ID</span></nobr></DIV> |
| <DIV style="position:absolute;top:734;left:520"><nobr><span class="ft3"> or click Browse to browse all sections, </span></nobr></DIV> |
| <DIV style="position:absolute;top:756;left:289"><nobr><span class="ft3">variables, and paragraphs in the selected file.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>93</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 94 --> |
| <a name="94"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c094.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:193"><nobr><span class="ft10"><b>Linking</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:182;left:193"><nobr><span class="ft8"><b>Linking To Another Help File</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:208;left:220"><nobr><span class="ft3">1. Mark the text that you want to appear as hyperlink.</span></nobr></DIV> |
| <DIV style="position:absolute;top:247;left:220"><nobr><span class="ft3">2. Choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:248;left:303"><nobr><span class="ft11"><b>Help Authoring - Insert Link</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:247;left:555"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:287;left:220"><nobr><span class="ft3">3. Enter the name of the file to link to in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:288;left:527"><nobr><span class="ft11"><b>Link target</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:287;left:626"><nobr><span class="ft3"> box. The path starts </span></nobr></DIV> |
| <DIV style="position:absolute;top:309;left:247"><nobr><span class="ft3">with the </span></nobr></DIV> |
| <DIV style="position:absolute;top:312;left:303"><nobr><span class="ft9">text</span></nobr></DIV> |
| <DIV style="position:absolute;top:309;left:336"><nobr><span class="ft3"> directory in the help file hierarchy. The path can contain a target </span></nobr></DIV> |
| <DIV style="position:absolute;top:332;left:247"><nobr><span class="ft3">anchor, for example, </span></nobr></DIV> |
| <DIV style="position:absolute;top:334;left:388"><nobr><span class="ft14">text/swriter/01/01020304.xhp#anchor</span></nobr></DIV> |
| <DIV style="position:absolute;top:371;left:220"><nobr><span class="ft3">4. Click </span></nobr></DIV> |
| <DIV style="position:absolute;top:372;left:284"><nobr><span class="ft11"><b>Ok</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:371;left:302"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:424;left:193"><nobr><span class="ft8"><b>Linking To The WWW</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:449;left:193"><nobr><span class="ft3">Proceed as with links to help files, but instead specify a WWW URL as link target.</span></nobr></DIV> |
| <DIV style="position:absolute;top:501;left:193"><nobr><span class="ft10"><b>Meta Data</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:530;left:193"><nobr><span class="ft3">The meta data are available through the </span></nobr></DIV> |
| <DIV style="position:absolute;top:531;left:479"><nobr><span class="ft11"><b>Help Authoring - Meta Data</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:530;left:722"><nobr><span class="ft3"> menu </span></nobr></DIV> |
| <DIV style="position:absolute;top:552;left:193"><nobr><span class="ft3">that calls the </span></nobr></DIV> |
| <DIV style="position:absolute;top:553;left:281"><nobr><span class="ft11"><b>Meta Data</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:552;left:362"><nobr><span class="ft3"> dialog:</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>94</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 95 --> |
| <a name="95"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c095.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:236"><nobr><span class="ft8"><b>Setting The Topic Title</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:162;left:236"><nobr><span class="ft3">On help file creation, the topic title is set to a generic string. This must be changed </span></nobr></DIV> |
| <DIV style="position:absolute;top:183;left:236"><nobr><span class="ft3">before finally saving the file.</span></nobr></DIV> |
| <DIV style="position:absolute;top:222;left:263"><nobr><span class="ft3">1. Choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:223;left:345"><nobr><span class="ft11"><b>Help Authoring - Meta Data</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:222;left:579"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:262;left:263"><nobr><span class="ft3">2. Insert a topic title in the corresponding text box or click </span></nobr></DIV> |
| <DIV style="position:absolute;top:263;left:678"><nobr><span class="ft11"><b>Fetch</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:262;left:723"><nobr><span class="ft3"> to fetch the </span></nobr></DIV> |
| <DIV style="position:absolute;top:285;left:290"><nobr><span class="ft3">topic title from the first heading in the document.</span></nobr></DIV> |
| <DIV style="position:absolute;top:338;left:236"><nobr><span class="ft5"> The topic title must not be empty.</span></nobr></DIV> |
| <DIV style="position:absolute;top:401;left:236"><nobr><span class="ft8"><b>Setting The Topic ID</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:427;left:236"><nobr><span class="ft3">On document creation, the topic ID will be set from the file name. There is usually no </span></nobr></DIV> |
| <DIV style="position:absolute;top:449;left:236"><nobr><span class="ft3">need for setting the topic ID manually but you can do so by entering the ID in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:470;left:236"><nobr><span class="ft3">corresponding text box. Characters that are not allowed are automatically stripped </span></nobr></DIV> |
| <DIV style="position:absolute;top:491;left:236"><nobr><span class="ft3">from the ID. Clicking </span></nobr></DIV> |
| <DIV style="position:absolute;top:493;left:376"><nobr><span class="ft11"><b>Suggest</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:491;left:439"><nobr><span class="ft3"> creates an ID based on the filename (like when the file </span></nobr></DIV> |
| <DIV style="position:absolute;top:514;left:236"><nobr><span class="ft3">is created).</span></nobr></DIV> |
| <DIV style="position:absolute;top:565;left:236"><nobr><span class="ft8"><b>Excluding A File From The Search Index</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:591;left:236"><nobr><span class="ft3">By default, all files are included in the full text search index creation. You can exclude </span></nobr></DIV> |
| <DIV style="position:absolute;top:613;left:236"><nobr><span class="ft3">files form this search index by selecting the </span></nobr></DIV> |
| <DIV style="position:absolute;top:614;left:526"><nobr><span class="ft11"><b>exclude</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:613;left:589"><nobr><span class="ft3"> option in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:614;left:679"><nobr><span class="ft11"><b>Indexing</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:613;left:751"><nobr><span class="ft3"> section. </span></nobr></DIV> |
| <DIV style="position:absolute;top:665;left:236"><nobr><span class="ft8"><b>Changing The Initial File Creation Comment</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:691;left:236"><nobr><span class="ft3">If you are do not like your initial comment you need to patch the </span></nobr></DIV> |
| <DIV style="position:absolute;top:694;left:661"><nobr><span class="ft14">xhp</span></nobr></DIV> |
| <DIV style="position:absolute;top:691;left:685"><nobr><span class="ft3"> file.</span></nobr></DIV> |
| <DIV style="position:absolute;top:743;left:236"><nobr><span class="ft8"><b>Changing The Last Edited Comment</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:769;left:236"><nobr><span class="ft3">You can insert a comment when you edit and save a help file. This comment can be </span></nobr></DIV> |
| <DIV style="position:absolute;top:791;left:236"><nobr><span class="ft3">used to describe why a change was made and what changes were performed. A new </span></nobr></DIV> |
| <DIV style="position:absolute;top:812;left:236"><nobr><span class="ft3">comment overrides existing comments.</span></nobr></DIV> |
| <DIV style="position:absolute;top:864;left:236"><nobr><span class="ft10"><b>Bookmarks</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:898;left:236"><nobr><span class="ft3">Bookmarks host index entries, help IDs, and entries for the table of contents </span></nobr></DIV> |
| <DIV style="position:absolute;top:919;left:236"><nobr><span class="ft3">(TOC)<A href="HelpAuthoring_c.html#95">[13</a>]</span></nobr></DIV> |
| <DIV style="position:absolute;top:971;left:236"><nobr><span class="ft8"><b>Adding A New Bookmark Set With Index Entries</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:997;left:263"><nobr><span class="ft3">1. Place the cursor where you want the index entry to appear.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1018;left:290"><nobr><span class="ft3">Remember that an index entry transforms to an anchor target in the help file. </span></nobr></DIV> |
| <DIV style="position:absolute;top:1039;left:290"><nobr><span class="ft3">Therefore, an index entry should always be placed directly <i>above</i> the text it </span></nobr></DIV> |
| <DIV style="position:absolute;top:1061;left:290"><nobr><span class="ft3">refers to. Index entries that refer to the complete help topic should be placed </span></nobr></DIV> |
| <DIV style="position:absolute;top:1082;left:290"><nobr><span class="ft3">at the top of the file.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1115;left:128"><nobr><span class="ft19">13 TOC entries are currently unused.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>95</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 96 --> |
| <a name="96"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c096.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:220"><nobr><span class="ft3">2. Choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:137;left:305"><nobr><span class="ft11"><b>Help Authoring - Bookmarks - Insert Index Entries</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:136;left:761"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:440;left:247"><nobr><span class="ft3">Enter the first and second level of the index entry in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:441;left:635"><nobr><span class="ft11"><b>Index Entry</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:440;left:736"><nobr><span class="ft3"> text </span></nobr></DIV> |
| <DIV style="position:absolute;top:463;left:247"><nobr><span class="ft3">boxes and click </span></nobr></DIV> |
| <DIV style="position:absolute;top:464;left:356"><nobr><span class="ft11"><b>Add</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:463;left:383"><nobr><span class="ft3"> or press the </span></nobr></DIV> |
| <DIV style="position:absolute;top:465;left:474"><nobr><span class="ft12"><b>Ins</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:463;left:498"><nobr><span class="ft3"> key to add it to the list of index entries.</span></nobr></DIV> |
| <DIV style="position:absolute;top:507;left:247"><nobr><span class="ft3">You can remove index entries from the list by selecting them and clicking </span></nobr></DIV> |
| <DIV style="position:absolute;top:529;left:247"><nobr><span class="ft11"><b>Remove Selected</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:528;left:382"><nobr><span class="ft3">. </span></nobr></DIV> |
| <DIV style="position:absolute;top:568;left:220"><nobr><span class="ft3">3. Select </span></nobr></DIV> |
| <DIV style="position:absolute;top:570;left:294"><nobr><span class="ft11"><b>Add parent bookmark tag</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:568;left:504"><nobr><span class="ft3"> to create a new set of index entries. If </span></nobr></DIV> |
| <DIV style="position:absolute;top:591;left:247"><nobr><span class="ft3">you want to add index entries to an existing set you need to clear this box </span></nobr></DIV> |
| <DIV style="position:absolute;top:613;left:247"><nobr><span class="ft3">(see next procedure).</span></nobr></DIV> |
| <DIV style="position:absolute;top:651;left:220"><nobr><span class="ft3">4. Click </span></nobr></DIV> |
| <DIV style="position:absolute;top:652;left:284"><nobr><span class="ft11"><b>Ok</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:651;left:302"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:704;left:193"><nobr><span class="ft8"><b>Adding Index Entries To An Existing Bookmark Set</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:744;left:193"><nobr><span class="ft5"> You cannot mix different types of bookmarks (index entries, help ids, and TOC entries).</span></nobr></DIV> |
| <DIV style="position:absolute;top:795;left:220"><nobr><span class="ft3">1. Place the cursor inside the set of index entries where you want to add index </span></nobr></DIV> |
| <DIV style="position:absolute;top:816;left:247"><nobr><span class="ft3">entries.</span></nobr></DIV> |
| <DIV style="position:absolute;top:855;left:220"><nobr><span class="ft3">2. Choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:856;left:303"><nobr><span class="ft11"><b>Help Authoring - Bookmarks - Insert Index Entries</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:855;left:744"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:895;left:220"><nobr><span class="ft3">3. Compile the list of index entries that you want to add to the bookmark set like </span></nobr></DIV> |
| <DIV style="position:absolute;top:917;left:247"><nobr><span class="ft3">described in the previous procedure.</span></nobr></DIV> |
| <DIV style="position:absolute;top:955;left:220"><nobr><span class="ft3">4. Clear the </span></nobr></DIV> |
| <DIV style="position:absolute;top:957;left:312"><nobr><span class="ft11"><b>Add parent bookmark tag</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:955;left:519"><nobr><span class="ft3"> box.</span></nobr></DIV> |
| <DIV style="position:absolute;top:978;left:247"><nobr><span class="ft3">If the box is checked a <i>new</i> bookmark set with the specified index entries will </span></nobr></DIV> |
| <DIV style="position:absolute;top:1000;left:247"><nobr><span class="ft3">be created after the set at the cursor position.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1038;left:220"><nobr><span class="ft3">5. Click </span></nobr></DIV> |
| <DIV style="position:absolute;top:1039;left:284"><nobr><span class="ft11"><b>Ok</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1038;left:302"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>96</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 97 --> |
| <a name="97"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c097.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:236"><nobr><span class="ft8"><b>Modifying Index Entries In An Existing Bookmark Set</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:162;left:236"><nobr><span class="ft3">If you need to modify an existing index entry (for instance, to correct a typographical </span></nobr></DIV> |
| <DIV style="position:absolute;top:183;left:236"><nobr><span class="ft3">error) delete and recreate this index entry as described previously.</span></nobr></DIV> |
| <DIV style="position:absolute;top:234;left:236"><nobr><span class="ft8"><b>Adding A New Bookmark Set With TOC Entries[<A href="HelpAuthoring_c.html#97">14]</b></a></span></nobr></DIV> |
| <DIV style="position:absolute;top:260;left:263"><nobr><span class="ft3">1. Place the cursor where you want the TOC entry to appear.</span></nobr></DIV> |
| <DIV style="position:absolute;top:299;left:263"><nobr><span class="ft3">2. Remember that a TOC entry transforms to an anchor target in the help file. </span></nobr></DIV> |
| <DIV style="position:absolute;top:320;left:290"><nobr><span class="ft3">Therefore, a TOC entry should always be placed directly <b>above</b> the text it </span></nobr></DIV> |
| <DIV style="position:absolute;top:341;left:290"><nobr><span class="ft3">refers to.</span></nobr></DIV> |
| <DIV style="position:absolute;top:363;left:290"><nobr><span class="ft3">TOC entries that refer to the complete help topic must be placed at the start of </span></nobr></DIV> |
| <DIV style="position:absolute;top:384;left:290"><nobr><span class="ft3">the help topic.</span></nobr></DIV> |
| <DIV style="position:absolute;top:423;left:263"><nobr><span class="ft3">3. Choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:424;left:350"><nobr><span class="ft11"><b>Help Authoring - Bookmarks - Insert TOC Entries</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:423;left:804"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:703;left:290"><nobr><span class="ft3">Enter the TOC entry string in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:704;left:514"><nobr><span class="ft11"><b>TOC Entry</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:703;left:595"><nobr><span class="ft3"> text box and click </span></nobr></DIV> |
| <DIV style="position:absolute;top:704;left:722"><nobr><span class="ft11"><b>Add</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:703;left:749"><nobr><span class="ft3"> to add it </span></nobr></DIV> |
| <DIV style="position:absolute;top:726;left:290"><nobr><span class="ft3">to the list of TOC entries.</span></nobr></DIV> |
| <DIV style="position:absolute;top:747;left:290"><nobr><span class="ft3">The TOC levels are separated using a slash </span></nobr></DIV> |
| <DIV style="position:absolute;top:750;left:586"><nobr><span class="ft9">/</span></nobr></DIV> |
| <DIV style="position:absolute;top:747;left:594"><nobr><span class="ft3">, for details see page <A href="HelpAuthoring_c.html#25">25.</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:770;left:290"><nobr><span class="ft3">You can remove TOC entries from the list by selecting them and clicking </span></nobr></DIV> |
| <DIV style="position:absolute;top:792;left:290"><nobr><span class="ft11"><b>Remove Selected</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:791;left:425"><nobr><span class="ft3">. </span></nobr></DIV> |
| <DIV style="position:absolute;top:831;left:263"><nobr><span class="ft3">4. Select </span></nobr></DIV> |
| <DIV style="position:absolute;top:832;left:336"><nobr><span class="ft11"><b>Add parent bookmark tag</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:831;left:546"><nobr><span class="ft3"> to create a new bookmark set of TOC </span></nobr></DIV> |
| <DIV style="position:absolute;top:854;left:290"><nobr><span class="ft3">entries. If you want to add TOC entries to an existing bookmark set you need </span></nobr></DIV> |
| <DIV style="position:absolute;top:875;left:290"><nobr><span class="ft3">to clear this box (see next procedure).</span></nobr></DIV> |
| <DIV style="position:absolute;top:914;left:263"><nobr><span class="ft3">5. Click </span></nobr></DIV> |
| <DIV style="position:absolute;top:915;left:326"><nobr><span class="ft11"><b>Ok</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:914;left:344"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:966;left:236"><nobr><span class="ft8"><b>Adding TOC Entries To An Existing Bookmark Set</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1007;left:236"><nobr><span class="ft5"> You cannot mix different types of bookmarks (index entries, help ids, and TOC entries).</span></nobr></DIV> |
| <DIV style="position:absolute;top:1058;left:263"><nobr><span class="ft3">1. Place the cursor inside the bookmark set of TOC entries where you want to </span></nobr></DIV> |
| <DIV style="position:absolute;top:1079;left:290"><nobr><span class="ft3">add TOC entries.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1115;left:128"><nobr><span class="ft19">14 These bookmarks are currently not evaluated when the help is compiled.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>97</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 98 --> |
| <a name="98"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c098.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:220"><nobr><span class="ft3">2. Choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:137;left:303"><nobr><span class="ft11"><b>Help Authoring - Bookmarks - Insert TOC Entries</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:136;left:726"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:176;left:220"><nobr><span class="ft3">3. Compile the list of TOC entries that you want to add to the bookmark set, as </span></nobr></DIV> |
| <DIV style="position:absolute;top:197;left:247"><nobr><span class="ft3">described previously.</span></nobr></DIV> |
| <DIV style="position:absolute;top:236;left:220"><nobr><span class="ft3">4. Clear the </span></nobr></DIV> |
| <DIV style="position:absolute;top:237;left:312"><nobr><span class="ft11"><b>Add parent bookmark tag</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:236;left:519"><nobr><span class="ft3"> box.</span></nobr></DIV> |
| <DIV style="position:absolute;top:276;left:220"><nobr><span class="ft3">5. If the box is checked a <i>new</i> bookmark set with the specified TOC entries will </span></nobr></DIV> |
| <DIV style="position:absolute;top:298;left:247"><nobr><span class="ft3">be created after the set at the cursor position.</span></nobr></DIV> |
| <DIV style="position:absolute;top:337;left:220"><nobr><span class="ft3">6. Click </span></nobr></DIV> |
| <DIV style="position:absolute;top:338;left:284"><nobr><span class="ft11"><b>Ok</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:337;left:302"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:389;left:193"><nobr><span class="ft8"><b>Determining A Help ID</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:415;left:193"><nobr><span class="ft3">The help ID inserted into the help file must either be the <i>symbolic ID</i> or an <i>UNO </i></span></nobr></DIV> |
| <DIV style="position:absolute;top:436;left:193"><nobr><span class="ft13"><i>command</i> (see<A href="HelpAuthoring_c.html#26"> <i>"hid" Branch</i></a> on page <A href="HelpAuthoring_c.html#26">26</a>). You can determine the <i>numerical ID</i> or the </span></nobr></DIV> |
| <DIV style="position:absolute;top:458;left:193"><nobr><span class="ft13"><i>UNO command</i> from the UI by setting an environmental variable </span></nobr></DIV> |
| <DIV style="position:absolute;top:460;left:652"><nobr><span class="ft14">HELP_DEBUG</span></nobr></DIV> |
| <DIV style="position:absolute;top:458;left:733"><nobr><span class="ft3"> and </span></nobr></DIV> |
| <DIV style="position:absolute;top:480;left:193"><nobr><span class="ft3">setting it to </span></nobr></DIV> |
| <DIV style="position:absolute;top:482;left:270"><nobr><span class="ft14">TRUE</span></nobr></DIV> |
| <DIV style="position:absolute;top:480;left:302"><nobr><span class="ft3"> before you start OpenOffice.org.</span></nobr></DIV> |
| <DIV style="position:absolute;top:520;left:193"><nobr><span class="ft3">If the variable is set you will see the help ID of an element together with its extended </span></nobr></DIV> |
| <DIV style="position:absolute;top:541;left:193"><nobr><span class="ft3">tip whenever you rest the mouse over it (provided the extended tips are enabled). This </span></nobr></DIV> |
| <DIV style="position:absolute;top:563;left:193"><nobr><span class="ft3">help ID can either be</span></nobr></DIV> |
| <DIV style="position:absolute;top:601;left:220"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:603;left:247"><nobr><span class="ft3">a <b>numerical ID</b>, in this case it must be converted to the symbolic ID before </span></nobr></DIV> |
| <DIV style="position:absolute;top:626;left:247"><nobr><span class="ft3">inserting it into the help file (see below)</span></nobr></DIV> |
| <DIV style="position:absolute;top:656;left:220"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:658;left:247"><nobr><span class="ft3">an <b>UNO command.</b> This can be inserted into the help file without need for </span></nobr></DIV> |
| <DIV style="position:absolute;top:680;left:247"><nobr><span class="ft3">conversion</span></nobr></DIV> |
| <DIV style="position:absolute;top:725;left:193"><nobr><span class="ft5"> To convert the numerical help </span></nobr></DIV> |
| <DIV style="position:absolute;top:724;left:392"><nobr><span class="ft28">ID</span></nobr></DIV> |
| <DIV style="position:absolute;top:725;left:405"><nobr><span class="ft5"> into a symbolic help </span></nobr></DIV> |
| <DIV style="position:absolute;top:724;left:533"><nobr><span class="ft28">ID</span></nobr></DIV> |
| <DIV style="position:absolute;top:725;left:547"><nobr><span class="ft5"> you need a matching table called </span></nobr></DIV> |
| <DIV style="position:absolute;top:744;left:214"><nobr><span class="ft14">help_hid.lst</span></nobr></DIV> |
| <DIV style="position:absolute;top:745;left:312"><nobr><span class="ft5"> that can be found in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:744;left:454"><nobr><span class="ft14">helpers</span></nobr></DIV> |
| <DIV style="position:absolute;top:745;left:511"><nobr><span class="ft5"> directory of the </span></nobr></DIV> |
| <DIV style="position:absolute;top:744;left:603"><nobr><span class="ft14">helpcontent2</span></nobr></DIV> |
| <DIV style="position:absolute;top:745;left:700"><nobr><span class="ft5"> module </span></nobr></DIV> |
| <DIV style="position:absolute;top:764;left:214"><nobr><span class="ft5">(<A href="HelpAuthoring_c.html#18">see <i>Structure of the CVS Help Module</i> </a>on page <A href="HelpAuthoring_c.html#18">18</a>).</span></nobr></DIV> |
| <DIV style="position:absolute;top:828;left:193"><nobr><span class="ft5"> You can either use this mapping table to look up a symbolic help </span></nobr></DIV> |
| <DIV style="position:absolute;top:827;left:575"><nobr><span class="ft28">ID</span></nobr></DIV> |
| <DIV style="position:absolute;top:828;left:588"><nobr><span class="ft5"> yourself, or you can place it </span></nobr></DIV> |
| <DIV style="position:absolute;top:848;left:214"><nobr><span class="ft5">into your local user/configuration directory of OpenOffice.org to allow the corresponding help </span></nobr></DIV> |
| <DIV style="position:absolute;top:866;left:214"><nobr><span class="ft5">authoring macro convert it for you.</span></nobr></DIV> |
| <DIV style="position:absolute;top:928;left:193"><nobr><span class="ft8"><b>Adding A Help ID</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:954;left:220"><nobr><span class="ft3">1. Place the cursor where you want the Help ID to appear.</span></nobr></DIV> |
| <DIV style="position:absolute;top:975;left:247"><nobr><span class="ft3">Remember that a Help ID transforms to an anchor target in the help file. </span></nobr></DIV> |
| <DIV style="position:absolute;top:997;left:247"><nobr><span class="ft3">Therefore, the Help ID must be placed directly <i>above</i> the text it refers to and </span></nobr></DIV> |
| <DIV style="position:absolute;top:1018;left:247"><nobr><span class="ft3">above any extended tip that it corresponds to.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1039;left:247"><nobr><span class="ft3">Help IDs that refer to the complete help topic must be placed at the beginning </span></nobr></DIV> |
| <DIV style="position:absolute;top:1061;left:247"><nobr><span class="ft3">of the help topic.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1099;left:220"><nobr><span class="ft3">2. Choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:1101;left:303"><nobr><span class="ft11"><b>Help Authoring - Bookmarks - Insert Help ID</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1099;left:690"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>98</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 99 --> |
| <a name="99"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c099.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:263"><nobr><span class="ft3">3. Insert the Help ID in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:137;left:451"><nobr><span class="ft11"><b>Help ID</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:136;left:514"><nobr><span class="ft3"> text box</span></nobr></DIV> |
| <DIV style="position:absolute;top:176;left:263"><nobr><span class="ft3">4. If you only have the numerical help ID, click </span></nobr></DIV> |
| <DIV style="position:absolute;top:177;left:584"><nobr><span class="ft11"><b>Convert to Symbol</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:176;left:738"><nobr><span class="ft3"> to convert </span></nobr></DIV> |
| <DIV style="position:absolute;top:199;left:290"><nobr><span class="ft3">it to the symbolic Help ID. If this button is disabled you need to place a </span></nobr></DIV> |
| <DIV style="position:absolute;top:223;left:290"><nobr><span class="ft14">help_hid.lst</span></nobr></DIV> |
| <DIV style="position:absolute;top:220;left:387"><nobr><span class="ft3"> file into the </span></nobr></DIV> |
| <DIV style="position:absolute;top:223;left:515"><nobr><span class="ft14">user/configuration</span></nobr></DIV> |
| <DIV style="position:absolute;top:220;left:661"><nobr><span class="ft3"> directory of your </span></nobr></DIV> |
| <DIV style="position:absolute;top:242;left:290"><nobr><span class="ft3">OpenOffice.org installation.</span></nobr></DIV> |
| <DIV style="position:absolute;top:281;left:263"><nobr><span class="ft3">5. Click </span></nobr></DIV> |
| <DIV style="position:absolute;top:282;left:326"><nobr><span class="ft11"><b>Ok</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:281;left:344"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:335;left:236"><nobr><span class="ft10"><b>Switching Content</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:381;left:236"><nobr><span class="ft8"><b>Inline Switching</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:407;left:236"><nobr><span class="ft3">Inline switching uses conditional tags to switch parts of a paragraph for different </span></nobr></DIV> |
| <DIV style="position:absolute;top:428;left:236"><nobr><span class="ft3">context situations. An inline switch consists of an outer </span></nobr></DIV> |
| <DIV style="position:absolute;top:431;left:620"><nobr><span class="ft14">switchinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:428;left:717"><nobr><span class="ft3"> element that </span></nobr></DIV> |
| <DIV style="position:absolute;top:451;left:236"><nobr><span class="ft3">encloses one or more </span></nobr></DIV> |
| <DIV style="position:absolute;top:453;left:388"><nobr><span class="ft14">caseinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:451;left:469"><nobr><span class="ft3"> elements that define the conditions and optionally </span></nobr></DIV> |
| <DIV style="position:absolute;top:473;left:236"><nobr><span class="ft3">one </span></nobr></DIV> |
| <DIV style="position:absolute;top:475;left:265"><nobr><span class="ft14">defaultinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:473;left:370"><nobr><span class="ft3"> element. The complete switch must be in one paragraph. </span></nobr></DIV> |
| <DIV style="position:absolute;top:520;left:267"><nobr><span class="ft5"><switchinline select="switch_type"></span></nobr></DIV> |
| <DIV style="position:absolute;top:535;left:267"><nobr><span class="ft5"> <caseinline select="condition_1"></caseinline></span></nobr></DIV> |
| <DIV style="position:absolute;top:550;left:267"><nobr><span class="ft5"> <caseinline select="condition_2"></caseinline></span></nobr></DIV> |
| <DIV style="position:absolute;top:566;left:267"><nobr><span class="ft5"> ...</span></nobr></DIV> |
| <DIV style="position:absolute;top:581;left:267"><nobr><span class="ft5"> <defaultinline></defaultinline></span></nobr></DIV> |
| <DIV style="position:absolute;top:596;left:267"><nobr><span class="ft5"></switchinline> </span></nobr></DIV> |
| <DIV style="position:absolute;top:626;left:263"><nobr><span class="ft3">1. Place the cursor where you want the inline switch to start or select the text </span></nobr></DIV> |
| <DIV style="position:absolute;top:648;left:290"><nobr><span class="ft3">passage that you want in the first condition.</span></nobr></DIV> |
| <DIV style="position:absolute;top:686;left:263"><nobr><span class="ft3">2. Choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:688;left:345"><nobr><span class="ft11"><b>Help Authoring - Switching - Open Switchinline </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:890;left:263"><nobr><span class="ft3">3. Select a switch type from the dialog. Currently, there are three switch types </span></nobr></DIV> |
| <DIV style="position:absolute;top:912;left:290"><nobr><span class="ft3">available:</span></nobr></DIV> |
| <DIV style="position:absolute;top:950;left:289"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:952;left:316"><nobr><span class="ft13"><i>System</i><b> </b>switches are used to switch between different platforms </span></nobr></DIV> |
| <DIV style="position:absolute;top:975;left:316"><nobr><span class="ft3">(Windows, Unix,...). </span></nobr></DIV> |
| <DIV style="position:absolute;top:1005;left:289"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:1007;left:316"><nobr><span class="ft13"><i>Application </i>switches are used to switch between different applications </span></nobr></DIV> |
| <DIV style="position:absolute;top:1030;left:316"><nobr><span class="ft3">(Writer, Calc, Draw,...) </span></nobr></DIV> |
| <DIV style="position:absolute;top:1060;left:289"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:1061;left:316"><nobr><span class="ft13"><i>Distribution</i> switches are used to switch between open source and </span></nobr></DIV> |
| <DIV style="position:absolute;top:1084;left:316"><nobr><span class="ft3">commercial distributions (OpenOffice.org, StarOffice,...) [<A href="HelpAuthoring_c.html#99">15</a>]</span></nobr></DIV> |
| <DIV style="position:absolute;top:1115;left:128"><nobr><span class="ft19">15 Not currently evaluated.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:795"><nobr><span class="ft4"><b>99</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 100 --> |
| <a name="100"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c100.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:220"><nobr><span class="ft3">4. Click </span></nobr></DIV> |
| <DIV style="position:absolute;top:137;left:284"><nobr><span class="ft11"><b>Ok</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:136;left:302"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:176;left:220"><nobr><span class="ft3">5. Select the first condition (</span></nobr></DIV> |
| <DIV style="position:absolute;top:179;left:416"><nobr><span class="ft14">caseinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:176;left:497"><nobr><span class="ft3">).</span></nobr></DIV> |
| <DIV style="position:absolute;top:198;left:247"><nobr><span class="ft3">You can either select one of the pre-defined conditions from the list or specify </span></nobr></DIV> |
| <DIV style="position:absolute;top:220;left:247"><nobr><span class="ft3">your own condition string.</span></nobr></DIV> |
| <DIV style="position:absolute;top:455;left:220"><nobr><span class="ft3">6. Enter further conditions by selecting text and choosing </span></nobr></DIV> |
| <DIV style="position:absolute;top:456;left:611"><nobr><span class="ft11"><b>Help Authoring - </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:479;left:247"><nobr><span class="ft11"><b>Switching - Insert Caseinline</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:478;left:508"><nobr><span class="ft3"> for the corresponding switch type.</span></nobr></DIV> |
| <DIV style="position:absolute;top:500;left:299"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:522;left:247"><nobr><span class="ft3">There is no text allowed (including spaces or line breaks) between a closing </span></nobr></DIV> |
| <DIV style="position:absolute;top:543;left:247"><nobr><span class="ft3">and an opening tag inside an inline switch, e.g.</span></nobr></DIV> |
| <DIV style="position:absolute;top:565;left:247"><nobr><span class="ft13"><i>wrong:</i> </span></nobr></DIV> |
| <DIV style="position:absolute;top:567;left:296"><nobr><span class="ft14"></caseinline> <caseinline></span></nobr></DIV> |
| <DIV style="position:absolute;top:565;left:507"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:587;left:247"><nobr><span class="ft13"><i>correct:</i> </span></nobr></DIV> |
| <DIV style="position:absolute;top:589;left:301"><nobr><span class="ft14"></caseinline><caseinline></span></nobr></DIV> |
| <DIV style="position:absolute;top:626;left:220"><nobr><span class="ft3">7. Optionally, insert a default condition by selecting text and choosing </span></nobr></DIV> |
| <DIV style="position:absolute;top:628;left:729"><nobr><span class="ft11"><b>Help </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:650;left:247"><nobr><span class="ft11"><b>Authoring - Switching - Insert Defaultinline</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:649;left:643"><nobr><span class="ft3">. </span></nobr></DIV> |
| <DIV style="position:absolute;top:689;left:220"><nobr><span class="ft3">8. Insert a closing </span></nobr></DIV> |
| <DIV style="position:absolute;top:692;left:362"><nobr><span class="ft9">switchinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:689;left:459"><nobr><span class="ft3"> element <b>directly</b> after the last </span></nobr></DIV> |
| <DIV style="position:absolute;top:692;left:684"><nobr><span class="ft9">caseinline </span></nobr></DIV> |
| <DIV style="position:absolute;top:712;left:247"><nobr><span class="ft3">element by choosing </span></nobr></DIV> |
| <DIV style="position:absolute;top:713;left:415"><nobr><span class="ft11"><b>Help Authoring - Switching - Close </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:735;left:247"><nobr><span class="ft11"><b>Switchinline</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:734;left:355"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:757;left:247"><nobr><span class="ft3">If you have inserted a default condition as described above, the </span></nobr></DIV> |
| <DIV style="position:absolute;top:781;left:247"><nobr><span class="ft9">switchinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:778;left:344"><nobr><span class="ft3"> element will automatically be closed. </span></nobr></DIV> |
| <DIV style="position:absolute;top:818;left:193"><nobr><span class="ft3">If you are not sure if you have actually created a valid switch choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:819;left:729"><nobr><span class="ft11"><b>Help </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:842;left:193"><nobr><span class="ft11"><b>Authoring - Validate</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:841;left:373"><nobr><span class="ft3"> and you will be notified of any errors.</span></nobr></DIV> |
| <DIV style="position:absolute;top:895;left:193"><nobr><span class="ft5"> The pre-defined conditions are processed when the help is displayed. If you want to specify your </span></nobr></DIV> |
| <DIV style="position:absolute;top:915;left:214"><nobr><span class="ft5">own condition string, you will have to ensure that the condition is processed when the help is </span></nobr></DIV> |
| <DIV style="position:absolute;top:933;left:214"><nobr><span class="ft5">compiled (see <A href="HelpAuthoring_c.html#19">page 19)</a> and displayed. Usually, you will only use the pre-defined conditions. </span></nobr></DIV> |
| <DIV style="position:absolute;top:995;left:193"><nobr><span class="ft8"><b>Switching Complete Sections Or Paragraphs</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1021;left:193"><nobr><span class="ft3">Other than inline switches, this type of switches encloses one or more paragraphs </span></nobr></DIV> |
| <DIV style="position:absolute;top:1042;left:193"><nobr><span class="ft3">including graphics and tables. Similar to inline switches, they consist of an outer </span></nobr></DIV> |
| <DIV style="position:absolute;top:1066;left:193"><nobr><span class="ft14">switch</span></nobr></DIV> |
| <DIV style="position:absolute;top:1063;left:242"><nobr><span class="ft3"> element that encloses one or more </span></nobr></DIV> |
| <DIV style="position:absolute;top:1066;left:490"><nobr><span class="ft9">case</span></nobr></DIV> |
| <DIV style="position:absolute;top:1063;left:523"><nobr><span class="ft3"> elements that define the conditions </span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>100</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 101 --> |
| <a name="101"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c101.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:236"><nobr><span class="ft3">and optionally one </span></nobr></DIV> |
| <DIV style="position:absolute;top:138;left:363"><nobr><span class="ft14">default</span></nobr></DIV> |
| <DIV style="position:absolute;top:136;left:420"><nobr><span class="ft3"> element. Each of those elements must be in a paragraph </span></nobr></DIV> |
| <DIV style="position:absolute;top:158;left:236"><nobr><span class="ft3">of its own that is assigned the </span></nobr></DIV> |
| <DIV style="position:absolute;top:161;left:445"><nobr><span class="ft14">hlp_aux_switch</span></nobr></DIV> |
| <DIV style="position:absolute;top:158;left:558"><nobr><span class="ft3"> style. The macros handle all that for </span></nobr></DIV> |
| <DIV style="position:absolute;top:181;left:236"><nobr><span class="ft3">you. </span></nobr></DIV> |
| <DIV style="position:absolute;top:219;left:263"><nobr><span class="ft3">1. Place the cursor where you want the switch to start.</span></nobr></DIV> |
| <DIV style="position:absolute;top:241;left:290"><nobr><span class="ft3">If you are in a non-empty paragraph the switch will start <i>before</i> that </span></nobr></DIV> |
| <DIV style="position:absolute;top:262;left:290"><nobr><span class="ft3">paragraph.</span></nobr></DIV> |
| <DIV style="position:absolute;top:301;left:263"><nobr><span class="ft3">2. Choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:302;left:345"><nobr><span class="ft11"><b>Help Authoring - Switching - Open Switch</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:505;left:263"><nobr><span class="ft3">3. Select a switch type from the dialog. Currently, there are three switch types </span></nobr></DIV> |
| <DIV style="position:absolute;top:526;left:290"><nobr><span class="ft3">available:</span></nobr></DIV> |
| <DIV style="position:absolute;top:565;left:289"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:566;left:316"><nobr><span class="ft13"><i>System</i> switches are used to switch between different platforms </span></nobr></DIV> |
| <DIV style="position:absolute;top:589;left:316"><nobr><span class="ft3">(Windows, Unix,...). </span></nobr></DIV> |
| <DIV style="position:absolute;top:620;left:289"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:621;left:316"><nobr><span class="ft13"><i>Application</i> switches are used to switch between different applications </span></nobr></DIV> |
| <DIV style="position:absolute;top:644;left:316"><nobr><span class="ft3">(Writer, Calc, Draw,...)</span></nobr></DIV> |
| <DIV style="position:absolute;top:674;left:289"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:676;left:316"><nobr><span class="ft13"><i>Distribution</i> switches are used to switch between open source and </span></nobr></DIV> |
| <DIV style="position:absolute;top:699;left:316"><nobr><span class="ft3">commercial distributions (OpenOffice.org, StarOffice,...). </span></nobr></DIV> |
| <DIV style="position:absolute;top:729;left:263"><nobr><span class="ft3">4. Select the first condition (</span></nobr></DIV> |
| <DIV style="position:absolute;top:731;left:458"><nobr><span class="ft14">case</span></nobr></DIV> |
| <DIV style="position:absolute;top:729;left:490"><nobr><span class="ft3">).</span></nobr></DIV> |
| <DIV style="position:absolute;top:751;left:290"><nobr><span class="ft3">You can either select one of the pre-defined conditions from the list or specify </span></nobr></DIV> |
| <DIV style="position:absolute;top:773;left:290"><nobr><span class="ft3">your own condition string.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1008;left:263"><nobr><span class="ft3">5. Place the cursor where the condition ends.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1029;left:290"><nobr><span class="ft3">If you are in a non-empty paragraph the condition will end <b>after</b> that </span></nobr></DIV> |
| <DIV style="position:absolute;top:1051;left:290"><nobr><span class="ft3">paragraph.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:788"><nobr><span class="ft4"><b>101</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 102 --> |
| <a name="102"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c102.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:220"><nobr><span class="ft3">6. Choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:137;left:307"><nobr><span class="ft11"><b>Help Authoring - Switching - Close Case</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:136;left:684"><nobr><span class="ft3"> to close a </span></nobr></DIV> |
| <DIV style="position:absolute;top:159;left:247"><nobr><span class="ft3">condition.</span></nobr></DIV> |
| <DIV style="position:absolute;top:197;left:220"><nobr><span class="ft3">7. Now insert further conditions by</span></nobr></DIV> |
| <DIV style="position:absolute;top:236;left:246"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:238;left:273"><nobr><span class="ft3">placing the cursor in the <i>first</i> paragraph of the condition </span></nobr></DIV> |
| <DIV style="position:absolute;top:270;left:246"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:271;left:273"><nobr><span class="ft3">choosing </span></nobr></DIV> |
| <DIV style="position:absolute;top:272;left:338"><nobr><span class="ft11"><b>Help Authoring - Switching - Open Case</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:271;left:680"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:303;left:246"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:305;left:273"><nobr><span class="ft3">placing the cursor in the <i>last</i> paragraph of the condition </span></nobr></DIV> |
| <DIV style="position:absolute;top:336;left:246"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:338;left:273"><nobr><span class="ft3">choosing </span></nobr></DIV> |
| <DIV style="position:absolute;top:339;left:338"><nobr><span class="ft11"><b>Help Authoring - Switching - Close Case</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:338;left:689"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:379;left:247"><nobr><span class="ft3">There are no paragraphs allowed between a closing and an opening tag </span></nobr></DIV> |
| <DIV style="position:absolute;top:400;left:247"><nobr><span class="ft3">inside an switch, for example: </span></nobr></DIV> |
| <DIV style="position:absolute;top:421;left:247"><nobr><span class="ft13"><i>Wrong:</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:455;left:278"><nobr><span class="ft5"></case></span></nobr></DIV> |
| <DIV style="position:absolute;top:470;left:278"><nobr><span class="ft5">{Some other text, even an empty paragraph}</span></nobr></DIV> |
| <DIV style="position:absolute;top:486;left:278"><nobr><span class="ft5"><case></span></nobr></DIV> |
| <DIV style="position:absolute;top:520;left:247"><nobr><span class="ft13"><i>Correct:</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:549;left:278"><nobr><span class="ft4"><b></case></b></span></nobr></DIV> |
| <DIV style="position:absolute;top:564;left:278"><nobr><span class="ft4"><b><case> </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:607;left:220"><nobr><span class="ft3">8. You can optionally enter a default condition as follows:</span></nobr></DIV> |
| <DIV style="position:absolute;top:646;left:246"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:647;left:273"><nobr><span class="ft3">place the cursor in the <i>first</i> paragraph of the default condition </span></nobr></DIV> |
| <DIV style="position:absolute;top:679;left:246"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:680;left:273"><nobr><span class="ft3">choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:682;left:326"><nobr><span class="ft11"><b>Help Authoring - Switching - Open Default</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:712;left:246"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:714;left:273"><nobr><span class="ft3">place the cursor in the <i>last</i> paragraph of the default condition</span></nobr></DIV> |
| <DIV style="position:absolute;top:746;left:246"><nobr><span class="ft3">·</span></nobr></DIV> |
| <DIV style="position:absolute;top:747;left:273"><nobr><span class="ft3">choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:748;left:326"><nobr><span class="ft11"><b>Help Authoring - Switching - Close Default</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:747;left:704"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:779;left:220"><nobr><span class="ft3">9. Close the switch by placing the cursor <i>directly</i> behind the last </span></nobr></DIV> |
| <DIV style="position:absolute;top:781;left:674"><nobr><span class="ft9">case</span></nobr></DIV> |
| <DIV style="position:absolute;top:779;left:706"><nobr><span class="ft3"> element </span></nobr></DIV> |
| <DIV style="position:absolute;top:801;left:247"><nobr><span class="ft3">and choosing </span></nobr></DIV> |
| <DIV style="position:absolute;top:802;left:341"><nobr><span class="ft11"><b>Help Authoring - Switching - Close Switch</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:801;left:710"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:824;left:247"><nobr><span class="ft3">If you have inserted a default condition the switch will automatically be closed.</span></nobr></DIV> |
| <DIV style="position:absolute;top:863;left:193"><nobr><span class="ft3">If you are not sure if you have actually created a valid switch, choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:864;left:729"><nobr><span class="ft11"><b>Help </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:887;left:193"><nobr><span class="ft11"><b>Authoring - Validate</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:886;left:373"><nobr><span class="ft3"> and you will be notified of any errors.</span></nobr></DIV> |
| <DIV style="position:absolute;top:940;left:193"><nobr><span class="ft5"> The pre-defined conditions are processed when the help is displayed. If you want to specify your </span></nobr></DIV> |
| <DIV style="position:absolute;top:959;left:214"><nobr><span class="ft5">own condition string you will have to ensure that the condition is processed when the help is </span></nobr></DIV> |
| <DIV style="position:absolute;top:977;left:214"><nobr><span class="ft5">compiled (see <A href="HelpAuthoring_c.html#19">page 19)</a> and displayed. Usually, you will only use the pre-defined conditions. </span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>102</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 103 --> |
| <a name="103"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c103.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:236"><nobr><span class="ft10"><b>Miscellaneous</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:182;left:236"><nobr><span class="ft8"><b>Extended Tips</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:208;left:236"><nobr><span class="ft3">Extended tips come in two flavors, <i>visible</i> and <i>hidden</i>. Visible extended tips are part of </span></nobr></DIV> |
| <DIV style="position:absolute;top:230;left:236"><nobr><span class="ft3">the normal help text while hidden extended tips are hidden from the normal help </span></nobr></DIV> |
| <DIV style="position:absolute;top:251;left:236"><nobr><span class="ft3">content. Each extended tip is assigned a help ID to which it responds.</span></nobr></DIV> |
| <DIV style="position:absolute;top:292;left:236"><nobr><span class="ft5"> In the current implementation, the </span></nobr></DIV> |
| <DIV style="position:absolute;top:292;left:442"><nobr><span class="ft14">hid</span></nobr></DIV> |
| <DIV style="position:absolute;top:292;left:466"><nobr><span class="ft5"> attribute of the extended tip elements </span></nobr></DIV> |
| <DIV style="position:absolute;top:292;left:673"><nobr><span class="ft14">AVIS</span></nobr></DIV> |
| <DIV style="position:absolute;top:292;left:706"><nobr><span class="ft5"> and </span></nobr></DIV> |
| <DIV style="position:absolute;top:292;left:733"><nobr><span class="ft14">AHID</span></nobr></DIV> |
| <DIV style="position:absolute;top:292;left:766"><nobr><span class="ft5"> are </span></nobr></DIV> |
| <DIV style="position:absolute;top:312;left:257"><nobr><span class="ft5">not evaluated. The corresponding Help IDs must be placed as bookmarks in a paragraph before the </span></nobr></DIV> |
| <DIV style="position:absolute;top:330;left:257"><nobr><span class="ft5">extended tip. The extended tip will be shown for <i>all help IDs</i> specified as bookmarks <i>after the last </i></span></nobr></DIV> |
| <DIV style="position:absolute;top:348;left:257"><nobr><span class="ft15"><i>extended tip</i> in the file. </span></nobr></DIV> |
| <DIV style="position:absolute;top:381;left:263"><nobr><span class="ft3">1. Select the part of the paragraph that you want to use as extended tip.</span></nobr></DIV> |
| <DIV style="position:absolute;top:403;left:290"><nobr><span class="ft3">An extended tip <i>must not</i> be spread over multiple paragraphs.</span></nobr></DIV> |
| <DIV style="position:absolute;top:433;left:263"><nobr><span class="ft3">2. Choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:434;left:347"><nobr><span class="ft11"><b>Help Authoring - Insert Visible Extended Tip</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:433;left:748"><nobr><span class="ft3"> or </span></nobr></DIV> |
| <DIV style="position:absolute;top:434;left:772"><nobr><span class="ft11"><b>Help </b></span></nobr></DIV> |
| <DIV style="position:absolute;top:457;left:290"><nobr><span class="ft11"><b>Authoring - Insert Hidden Extended Tip</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:456;left:632"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:479;left:290"><nobr><span class="ft3">If you enclose text by a hidden extended tip this text portion will <i>no longer be </i></span></nobr></DIV> |
| <DIV style="position:absolute;top:500;left:290"><nobr><span class="ft13"><i>visible</i> in the help viewer.</span></nobr></DIV> |
| <DIV style="position:absolute;top:530;left:263"><nobr><span class="ft3">3. Insert a help ID to be assigned to the extended tip. Note the comment about </span></nobr></DIV> |
| <DIV style="position:absolute;top:552;left:290"><nobr><span class="ft3">help IDs above.</span></nobr></DIV> |
| <DIV style="position:absolute;top:603;left:236"><nobr><span class="ft8"><b>Sorting</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:629;left:236"><nobr><span class="ft3">Sorting is a new feature in OpenOffice.org Help. It can be used to sort sections based </span></nobr></DIV> |
| <DIV style="position:absolute;top:650;left:236"><nobr><span class="ft3">on their content. This is useful, for example, for glossaries or other sorted lists that are </span></nobr></DIV> |
| <DIV style="position:absolute;top:671;left:236"><nobr><span class="ft3">localized and would otherwise lose their correct sort order.</span></nobr></DIV> |
| <DIV style="position:absolute;top:713;left:236"><nobr><span class="ft5"> Note that sorting does not work for embedded sections.</span></nobr></DIV> |
| <DIV style="position:absolute;top:748;left:263"><nobr><span class="ft3">1. Place the cursor <i>before</i> the first section to be sorted.</span></nobr></DIV> |
| <DIV style="position:absolute;top:769;left:290"><nobr><span class="ft3">In the current implementation the </span></nobr></DIV> |
| <DIV style="position:absolute;top:771;left:518"><nobr><span class="ft9">sort</span></nobr></DIV> |
| <DIV style="position:absolute;top:769;left:550"><nobr><span class="ft3"> element sorts the content of sections. </span></nobr></DIV> |
| <DIV style="position:absolute;top:791;left:290"><nobr><span class="ft3">The sort element must not have any other child elements than </span></nobr></DIV> |
| <DIV style="position:absolute;top:794;left:705"><nobr><span class="ft14">section</span></nobr></DIV> |
| <DIV style="position:absolute;top:791;left:761"><nobr><span class="ft3">s.</span></nobr></DIV> |
| <DIV style="position:absolute;top:822;left:263"><nobr><span class="ft3">2. Choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:823;left:345"><nobr><span class="ft11"><b>Help Authoring - Sorting - Open Sort</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:822;left:669"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:854;left:263"><nobr><span class="ft3">3. Place the cursor <i>after</i> the last section to be sorted.</span></nobr></DIV> |
| <DIV style="position:absolute;top:884;left:263"><nobr><span class="ft3">4. Choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:885;left:345"><nobr><span class="ft11"><b>Help Authoring - Sorting - Close Sort</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:884;left:678"><nobr><span class="ft3"> </span></nobr></DIV> |
| <DIV style="position:absolute;top:937;left:236"><nobr><span class="ft8"><b>Validating</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:963;left:236"><nobr><span class="ft3">There is a basic validation procedure available that tests the help files before they are </span></nobr></DIV> |
| <DIV style="position:absolute;top:984;left:236"><nobr><span class="ft3">exported from OpenOffice.org. To call it, choose </span></nobr></DIV> |
| <DIV style="position:absolute;top:985;left:559"><nobr><span class="ft11"><b>Help Authoring - Validate</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:984;left:784"><nobr><span class="ft3">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1016;left:236"><nobr><span class="ft3">Note that this procedure catches some of the most common and severe errors but it is </span></nobr></DIV> |
| <DIV style="position:absolute;top:1037;left:236"><nobr><span class="ft3">not fool-proof. It does <i>not</i> perform an XML validation on the file.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1067;left:236"><nobr><span class="ft3">It is, however, recommended to validate a file before saving.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:788"><nobr><span class="ft4"><b>103</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 104 --> |
| <a name="104"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c104.png" alt="background image"> |
| <DIV style="position:absolute;top:154;left:193"><nobr><span class="ft10"><b>Troubleshooting</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:200;left:193"><nobr><span class="ft8"><b>A Help File Cannot Be Opened</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:226;left:193"><nobr><span class="ft3">The reason is probably an invalid help </span></nobr></DIV> |
| <DIV style="position:absolute;top:228;left:453"><nobr><span class="ft14">xhp</span></nobr></DIV> |
| <DIV style="position:absolute;top:226;left:477"><nobr><span class="ft3"> file. To verify this, open the help file in any </span></nobr></DIV> |
| <DIV style="position:absolute;top:248;left:193"><nobr><span class="ft3">XML or text editor and check its validity. Fix any invalid syntax and reload the file. </span></nobr></DIV> |
| <DIV style="position:absolute;top:287;left:193"><nobr><span class="ft3">If the XML file is valid and you cannot open <i>any</i> help file, see below.</span></nobr></DIV> |
| <DIV style="position:absolute;top:338;left:193"><nobr><span class="ft8"><b>A Help File Cannot Be Saved</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:364;left:193"><nobr><span class="ft3">The reason could be insufficient access rights to the directory or file you want to save </span></nobr></DIV> |
| <DIV style="position:absolute;top:386;left:193"><nobr><span class="ft3">to. Change the access rights accordingly.</span></nobr></DIV> |
| <DIV style="position:absolute;top:425;left:193"><nobr><span class="ft3">If you cannot save <i>any</i> help file, see below.</span></nobr></DIV> |
| <DIV style="position:absolute;top:476;left:193"><nobr><span class="ft8"><b>No Help File Can Be Opened Or Saved</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:502;left:193"><nobr><span class="ft3">The reason is probably a corrupted XSLT export/import filter. Occasionally, installing </span></nobr></DIV> |
| <DIV style="position:absolute;top:523;left:193"><nobr><span class="ft3">the help authoring filter produces an error in the xsl files. To repair this proceed as </span></nobr></DIV> |
| <DIV style="position:absolute;top:544;left:193"><nobr><span class="ft3">follows:</span></nobr></DIV> |
| <DIV style="position:absolute;top:588;left:193"><nobr><span class="ft25"><i>If you are familiar with XSLT</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:614;left:220"><nobr><span class="ft3">1. Change to the </span></nobr></DIV> |
| <DIV style="position:absolute;top:616;left:345"><nobr><span class="ft14">user/xslt/Help</span></nobr></DIV> |
| <DIV style="position:absolute;top:614;left:459"><nobr><span class="ft3"> directory of your OpenOffice.org installation.</span></nobr></DIV> |
| <DIV style="position:absolute;top:654;left:220"><nobr><span class="ft3">2. Open the import and/or export xsl file.</span></nobr></DIV> |
| <DIV style="position:absolute;top:692;left:220"><nobr><span class="ft3">3. Got to the end of the file and check if there is any obvious duplicated content. </span></nobr></DIV> |
| <DIV style="position:absolute;top:714;left:247"><nobr><span class="ft3">Occasionally, the last lines of the stylesheet get duplicated. There must only </span></nobr></DIV> |
| <DIV style="position:absolute;top:735;left:247"><nobr><span class="ft3">be one single </span></nobr></DIV> |
| <DIV style="position:absolute;top:738;left:341"><nobr><span class="ft14"></xsl:stylesheet></span></nobr></DIV> |
| <DIV style="position:absolute;top:735;left:478"><nobr><span class="ft3"> tag in the file.</span></nobr></DIV> |
| <DIV style="position:absolute;top:780;left:193"><nobr><span class="ft25"><i>If you are unfamiliar with XSLT</i></span></nobr></DIV> |
| <DIV style="position:absolute;top:806;left:220"><nobr><span class="ft3">1. Get the help authoring filter package (see<A href="HelpAuthoring_c.html#76"> <i>Installing the Import/Export Filters</a> </i></span></nobr></DIV> |
| <DIV style="position:absolute;top:827;left:247"><nobr><span class="ft3">on page<A href="HelpAuthoring_c.html#76"> 76</a>) and unpack it to a temporary directory.</span></nobr></DIV> |
| <DIV style="position:absolute;top:866;left:220"><nobr><span class="ft3">2. Copy the </span></nobr></DIV> |
| <DIV style="position:absolute;top:868;left:318"><nobr><span class="ft14">*.xsl</span></nobr></DIV> |
| <DIV style="position:absolute;top:866;left:359"><nobr><span class="ft3"> files from the Help subdirectory of the files that you just </span></nobr></DIV> |
| <DIV style="position:absolute;top:888;left:247"><nobr><span class="ft3">unpacked to the </span></nobr></DIV> |
| <DIV style="position:absolute;top:890;left:359"><nobr><span class="ft14">user/xslt/Help</span></nobr></DIV> |
| <DIV style="position:absolute;top:888;left:472"><nobr><span class="ft3"> directory of your OpenOffice.org installation </span></nobr></DIV> |
| <DIV style="position:absolute;top:910;left:247"><nobr><span class="ft3">overwriting the existing files.</span></nobr></DIV> |
| <DIV style="position:absolute;top:961;left:193"><nobr><span class="ft8"><b>Paragraph Content Has Vanished On Reload</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:988;left:193"><nobr><span class="ft3">The reason is probably the use of a wrong paragraph format. Remember, that for </span></nobr></DIV> |
| <DIV style="position:absolute;top:1009;left:193"><nobr><span class="ft3">paragraphs with content you must use one of the predefined </span></nobr></DIV> |
| <DIV style="position:absolute;top:1011;left:604"><nobr><span class="ft14">hlp_*</span></nobr></DIV> |
| <DIV style="position:absolute;top:1009;left:645"><nobr><span class="ft3"> paragraph styles. </span></nobr></DIV> |
| <DIV style="position:absolute;top:1031;left:193"><nobr><span class="ft3">See also <i><A href="HelpAuthoring_c.html#78">Paragraphs and Paragraph Formatting</i></a> on page <A href="HelpAuthoring_c.html#78">78.</a></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>104</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 105 --> |
| <a name="105"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| .ft30{font-size:11px;font-family:Times;color:#34546a;} |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c105.png" alt="background image"> |
| <DIV style="position:absolute;top:345;left:128"><nobr><span class="ft7">5 Appendix</span></nobr></DIV> |
| <DIV style="position:absolute;top:399;left:236"><nobr><span class="ft10"><b>Glossary</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:445;left:236"><nobr><span class="ft30"><b>Application</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:445;left:309"><nobr><span class="ft9"> A OpenOffice.org "module" for different document types. There are the following </span></nobr></DIV> |
| <DIV style="position:absolute;top:460;left:278"><nobr><span class="ft9">applications: <i>Writer</i> for text documents, <i>Calc</i> for spreadsheets, <i>Impress</i> for </span></nobr></DIV> |
| <DIV style="position:absolute;top:476;left:278"><nobr><span class="ft9">presentations, <i>Draw</i> for drawings, <i>Math</i> for formulas, <i>Basic</i> for Macros.</span></nobr></DIV> |
| <DIV style="position:absolute;top:508;left:236"><nobr><span class="ft30"><b>Active Help</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:508;left:309"><nobr><span class="ft9"> - A synonym for an extended tip.</span></nobr></DIV> |
| <DIV style="position:absolute;top:540;left:236"><nobr><span class="ft30"><b>Anchor</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:540;left:283"><nobr><span class="ft9"> A location inside a help file which serves as a bookmark to which the help viewer </span></nobr></DIV> |
| <DIV style="position:absolute;top:555;left:278"><nobr><span class="ft9">jumps, displaying the help for a certain context.</span></nobr></DIV> |
| <DIV style="position:absolute;top:587;left:236"><nobr><span class="ft30"><b>Attribute</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:587;left:292"><nobr><span class="ft9"> Component of an XML element carrying information that specifies the element in </span></nobr></DIV> |
| <DIV style="position:absolute;top:602;left:278"><nobr><span class="ft9">greater detail, for example, the </span></nobr></DIV> |
| <DIV style="position:absolute;top:603;left:465"><nobr><span class="ft14">role</span></nobr></DIV> |
| <DIV style="position:absolute;top:602;left:497"><nobr><span class="ft9"> attribute in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:603;left:591"><nobr><span class="ft14">paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:602;left:663"><nobr><span class="ft9"> element.</span></nobr></DIV> |
| <DIV style="position:absolute;top:635;left:236"><nobr><span class="ft30"><b>Bookmark</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:635;left:302"><nobr><span class="ft9"> 1. A help function that allows you to set user-defined bookmarks to help topics to </span></nobr></DIV> |
| <DIV style="position:absolute;top:650;left:278"><nobr><span class="ft9">make them easier to access. 2. An element of a help XML file that is used to define </span></nobr></DIV> |
| <DIV style="position:absolute;top:665;left:278"><nobr><span class="ft9">anchor points for help ids or keywords.</span></nobr></DIV> |
| <DIV style="position:absolute;top:698;left:236"><nobr><span class="ft30"><b>Build List</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:698;left:297"><nobr><span class="ft9"> The file </span></nobr></DIV> |
| <DIV style="position:absolute;top:699;left:360"><nobr><span class="ft14">build.lst</span></nobr></DIV> |
| <DIV style="position:absolute;top:698;left:433"><nobr><span class="ft9"> controls the build process of a module by defining module </span></nobr></DIV> |
| <DIV style="position:absolute;top:714;left:278"><nobr><span class="ft9">directories to be built and application dependencies between them.</span></nobr></DIV> |
| <DIV style="position:absolute;top:746;left:236"><nobr><span class="ft30"><b>Cascading Style Sheet</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:746;left:380"><nobr><span class="ft9"> The style sheet used to define the layout of a help page displayed in </span></nobr></DIV> |
| <DIV style="position:absolute;top:761;left:278"><nobr><span class="ft9">the help viewer.</span></nobr></DIV> |
| <DIV style="position:absolute;top:793;left:236"><nobr><span class="ft30"><b>Context-Sensitive Help</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:793;left:383"><nobr><span class="ft9"> When called from within the OpenOffice.org application, the help </span></nobr></DIV> |
| <DIV style="position:absolute;top:808;left:278"><nobr><span class="ft9">receives information about the user interface context,such as active dialog, or selected </span></nobr></DIV> |
| <DIV style="position:absolute;top:823;left:278"><nobr><span class="ft9">element. This information is used by the help to display information related to that </span></nobr></DIV> |
| <DIV style="position:absolute;top:838;left:278"><nobr><span class="ft9">context, provided this relation is defined in the help files. <i>Help IDs</i> are used to define this </span></nobr></DIV> |
| <DIV style="position:absolute;top:853;left:278"><nobr><span class="ft9">relation.</span></nobr></DIV> |
| <DIV style="position:absolute;top:886;left:236"><nobr><span class="ft30"><b>CVS</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:886;left:263"><nobr><span class="ft9"> Concurrent Versioning System, a widespread version control system that is also used by </span></nobr></DIV> |
| <DIV style="position:absolute;top:901;left:278"><nobr><span class="ft9">OpenOffice.org. See </span></nobr></DIV> |
| <DIV style="position:absolute;top:902;left:405"><nobr><span class="ft14">tools.openoffice.org</span></nobr></DIV> |
| <DIV style="position:absolute;top:901;left:567"><nobr><span class="ft9">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:934;left:236"><nobr><span class="ft30"><b>CVS Module</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:934;left:314"><nobr><span class="ft9"> A part of the CVS that contains code for a section of the OpenOffice.org </span></nobr></DIV> |
| <DIV style="position:absolute;top:949;left:278"><nobr><span class="ft9">product.</span></nobr></DIV> |
| <DIV style="position:absolute;top:981;left:236"><nobr><span class="ft30"><b>Dependency Files</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:981;left:350"><nobr><span class="ft9"> When a module is re-compiled, only changed files and files that depend </span></nobr></DIV> |
| <DIV style="position:absolute;top:996;left:278"><nobr><span class="ft9">on them need to be compiled again. Dependency files describe these dependencies. </span></nobr></DIV> |
| <DIV style="position:absolute;top:1011;left:278"><nobr><span class="ft9">These files are used by the </span></nobr></DIV> |
| <DIV style="position:absolute;top:1012;left:444"><nobr><span class="ft14">make</span></nobr></DIV> |
| <DIV style="position:absolute;top:1011;left:476"><nobr><span class="ft9"> utility. </span></nobr></DIV> |
| <DIV style="position:absolute;top:1045;left:236"><nobr><span class="ft30"><b>DTD</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1045;left:263"><nobr><span class="ft9"> Document Type Definition, a file that describes the document syntax for an XML </span></nobr></DIV> |
| <DIV style="position:absolute;top:1060;left:278"><nobr><span class="ft9">document. The DTD is needed to validate an XML file.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1092;left:236"><nobr><span class="ft30"><b>Embedding</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1092;left:309"><nobr><span class="ft9"> In OpenOffice.org help files can contain references to parts of other help files </span></nobr></DIV> |
| <DIV style="position:absolute;top:1107;left:278"><nobr><span class="ft9">that are dynamically inserted when the help is displayed.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:788"><nobr><span class="ft4"><b>105</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 106 --> |
| <a name="106"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c106.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:193"><nobr><span class="ft30"><b>Extended Tip</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:136;left:278"><nobr><span class="ft9"> Yellow "bubble" on the application user interface that contains information </span></nobr></DIV> |
| <DIV style="position:absolute;top:151;left:236"><nobr><span class="ft9">about the element under the mouse cursor. Extended tips appear when the mouse </span></nobr></DIV> |
| <DIV style="position:absolute;top:166;left:236"><nobr><span class="ft9">cursor rests over a user interface element. In OpenOffice.org 1.1.x they are </span></nobr></DIV> |
| <DIV style="position:absolute;top:182;left:236"><nobr><span class="ft9">enabled/disabled using </span></nobr></DIV> |
| <DIV style="position:absolute;top:181;left:378"><nobr><span class="ft11"><b>Help Extended Tips</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:182;left:558"><nobr><span class="ft9">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:215;left:193"><nobr><span class="ft30"><b>Full-Text Search</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:215;left:298"><nobr><span class="ft9"> A help function that allows you to search through the text of the set of help </span></nobr></DIV> |
| <DIV style="position:absolute;top:230;left:236"><nobr><span class="ft9">files. The function uses a search index that is created when the help files are compiled </span></nobr></DIV> |
| <DIV style="position:absolute;top:245;left:236"><nobr><span class="ft9">and built. Help files can be excluded from this search index using the </span></nobr></DIV> |
| <DIV style="position:absolute;top:246;left:650"><nobr><span class="ft14">exclude</span></nobr></DIV> |
| <DIV style="position:absolute;top:245;left:707"><nobr><span class="ft9"> value in </span></nobr></DIV> |
| <DIV style="position:absolute;top:262;left:236"><nobr><span class="ft9">the </span></nobr></DIV> |
| <DIV style="position:absolute;top:263;left:258"><nobr><span class="ft14">indexer</span></nobr></DIV> |
| <DIV style="position:absolute;top:262;left:315"><nobr><span class="ft9"> attribute of the </span></nobr></DIV> |
| <DIV style="position:absolute;top:263;left:409"><nobr><span class="ft14">topic</span></nobr></DIV> |
| <DIV style="position:absolute;top:262;left:449"><nobr><span class="ft9"> element.</span></nobr></DIV> |
| <DIV style="position:absolute;top:295;left:193"><nobr><span class="ft30"><b>Help Authoring Template</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:295;left:354"><nobr><span class="ft9"> The help authoring filter contains XSLT import/export filters and a </span></nobr></DIV> |
| <DIV style="position:absolute;top:310;left:236"><nobr><span class="ft9">help authoring template that specifies the layout of the help documents inside </span></nobr></DIV> |
| <DIV style="position:absolute;top:325;left:236"><nobr><span class="ft9">OpenOffice.org.</span></nobr></DIV> |
| <DIV style="position:absolute;top:357;left:193"><nobr><span class="ft30"><b>Help Compiler</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:357;left:285"><nobr><span class="ft9"> A program that compiles the help files into an intermediate "object" format </span></nobr></DIV> |
| <DIV style="position:absolute;top:372;left:236"><nobr><span class="ft9">that is used by the help linker to assemble the final help files that are installed with </span></nobr></DIV> |
| <DIV style="position:absolute;top:387;left:236"><nobr><span class="ft9">OpenOffice.org.</span></nobr></DIV> |
| <DIV style="position:absolute;top:419;left:193"><nobr><span class="ft30"><b>Help Content Provider</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:419;left:336"><nobr><span class="ft9"> A service inside OpenOffice.org that provides the Help to the help </span></nobr></DIV> |
| <DIV style="position:absolute;top:435;left:236"><nobr><span class="ft9">viewer.</span></nobr></DIV> |
| <DIV style="position:absolute;top:467;left:193"><nobr><span class="ft30"><b>Help IDs</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:467;left:247"><nobr><span class="ft9"> Numerical or symbolic identifiers that are defined for user interface elements in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:482;left:236"><nobr><span class="ft9">application code. Help IDs can be used to identify the context in which the help is called </span></nobr></DIV> |
| <DIV style="position:absolute;top:497;left:236"><nobr><span class="ft9">and to define a relation between an application context and the help topic that is </span></nobr></DIV> |
| <DIV style="position:absolute;top:512;left:236"><nobr><span class="ft9">displayed.</span></nobr></DIV> |
| <DIV style="position:absolute;top:544;left:193"><nobr><span class="ft30"><b>Help Module</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:544;left:273"><nobr><span class="ft9"> Each OpenOffice.org application has a help module associated: <i>Writer</i>, <i>Calc</i>, </span></nobr></DIV> |
| <DIV style="position:absolute;top:559;left:236"><nobr><span class="ft18"><i>Draw</i>, <i>Impress</i>, <i>Math</i>, <i>Basic</i>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:591;left:193"><nobr><span class="ft30"><b>Help Section</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:591;left:275"><nobr><span class="ft9"> A subdirectory of </span></nobr></DIV> |
| <DIV style="position:absolute;top:592;left:395"><nobr><span class="ft14">helpcontent2/source/text</span></nobr></DIV> |
| <DIV style="position:absolute;top:591;left:589"><nobr><span class="ft9">. Each help module contains </span></nobr></DIV> |
| <DIV style="position:absolute;top:607;left:236"><nobr><span class="ft9">the help files of one or more help sections.</span></nobr></DIV> |
| <DIV style="position:absolute;top:640;left:193"><nobr><span class="ft30"><b>Help Topic</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:640;left:262"><nobr><span class="ft9"> The contents of a help file. Usually, a help topic describes one task or a logical </span></nobr></DIV> |
| <DIV style="position:absolute;top:655;left:236"><nobr><span class="ft9">group of reference information.</span></nobr></DIV> |
| <DIV style="position:absolute;top:687;left:193"><nobr><span class="ft30"><b>Help Viewer</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:687;left:270"><nobr><span class="ft9"> - OpenOffice.org component that displays the help files and provides help </span></nobr></DIV> |
| <DIV style="position:absolute;top:702;left:236"><nobr><span class="ft9">functionality.</span></nobr></DIV> |
| <DIV style="position:absolute;top:734;left:193"><nobr><span class="ft30"><b>Icon</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:734;left:221"><nobr><span class="ft9"> An image that is taken from the resource repository of the application itself. Icons are </span></nobr></DIV> |
| <DIV style="position:absolute;top:749;left:236"><nobr><span class="ft9">stored in different CVS modules and after installation are available in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:750;left:672"><nobr><span class="ft14">images.zip </span></nobr></DIV> |
| <DIV style="position:absolute;top:765;left:236"><nobr><span class="ft9">file.</span></nobr></DIV> |
| <DIV style="position:absolute;top:797;left:193"><nobr><span class="ft30"><b>Image</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:797;left:232"><nobr><span class="ft9"> Graphical content that is specific to the help files. All images are stored in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:813;left:236"><nobr><span class="ft14">helpimg</span></nobr></DIV> |
| <DIV style="position:absolute;top:812;left:292"><nobr><span class="ft9"> directory of the </span></nobr></DIV> |
| <DIV style="position:absolute;top:813;left:389"><nobr><span class="ft14">res</span></nobr></DIV> |
| <DIV style="position:absolute;top:812;left:413"><nobr><span class="ft9"> CVS module and after installation are available in the </span></nobr></DIV> |
| <DIV style="position:absolute;top:830;left:236"><nobr><span class="ft14">images.zip</span></nobr></DIV> |
| <DIV style="position:absolute;top:829;left:317"><nobr><span class="ft9"> file.</span></nobr></DIV> |
| <DIV style="position:absolute;top:862;left:193"><nobr><span class="ft30"><b>Block Image</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:862;left:273"><nobr><span class="ft9"> An image that is on a paragraph of its own. Block images can have captions. </span></nobr></DIV> |
| <DIV style="position:absolute;top:894;left:193"><nobr><span class="ft30"><b>Inline Image</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:894;left:271"><nobr><span class="ft9"> An image that is part of another paragraph and surrounded by text content. </span></nobr></DIV> |
| <DIV style="position:absolute;top:911;left:236"><nobr><span class="ft9">Inline images </span></nobr></DIV> |
| <DIV style="position:absolute;top:909;left:319"><nobr><span class="ft3">cannot</span></nobr></DIV> |
| <DIV style="position:absolute;top:911;left:364"><nobr><span class="ft9"> have captions.</span></nobr></DIV> |
| <DIV style="position:absolute;top:943;left:193"><nobr><span class="ft30"><b>Import/Export Filter</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:943;left:318"><nobr><span class="ft9"> XSLT files that control the conversion of the help files from </span></nobr></DIV> |
| <DIV style="position:absolute;top:944;left:686"><nobr><span class="ft14">xhp</span></nobr></DIV> |
| <DIV style="position:absolute;top:943;left:710"><nobr><span class="ft9"> to </span></nobr></DIV> |
| <DIV style="position:absolute;top:959;left:236"><nobr><span class="ft9">OpenOffice.org and vice versa. Using a template they also control the appearance of the </span></nobr></DIV> |
| <DIV style="position:absolute;top:974;left:236"><nobr><span class="ft9">files in OpenOffice.org.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1006;left:193"><nobr><span class="ft30"><b>Index of Keywords</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1006;left:313"><nobr><span class="ft9"> A two-level list of keywords associated with help topics. Keywords are </span></nobr></DIV> |
| <DIV style="position:absolute;top:1021;left:236"><nobr><span class="ft9">explicitly defined in the help files.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1054;left:193"><nobr><span class="ft30"><b>Instructional Information</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1054;left:352"><nobr><span class="ft9"> Information in OpenOffice.org help that provides instructions on </span></nobr></DIV> |
| <DIV style="position:absolute;top:1069;left:236"><nobr><span class="ft9">how to fulfill tasks.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1101;left:193"><nobr><span class="ft30"><b>makefile</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:1101;left:247"><nobr><span class="ft9"> File that describes the processes for "making" (compiling/linking) files inside a </span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>106</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 107 --> |
| <a name="107"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c107.png" alt="background image"> |
| <DIV style="position:absolute;top:136;left:278"><nobr><span class="ft9">directory. Used by the </span></nobr></DIV> |
| <DIV style="position:absolute;top:137;left:413"><nobr><span class="ft14">make</span></nobr></DIV> |
| <DIV style="position:absolute;top:136;left:446"><nobr><span class="ft9"> utility.</span></nobr></DIV> |
| <DIV style="position:absolute;top:169;left:236"><nobr><span class="ft30"><b>Meta Data</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:169;left:299"><nobr><span class="ft9"> Help file data that describe the help file, like file name, topic title, creation date. </span></nobr></DIV> |
| <DIV style="position:absolute;top:184;left:278"><nobr><span class="ft9">These are stored inside the </span></nobr></DIV> |
| <DIV style="position:absolute;top:185;left:446"><nobr><span class="ft14">meta</span></nobr></DIV> |
| <DIV style="position:absolute;top:184;left:478"><nobr><span class="ft9"> element of the help file.</span></nobr></DIV> |
| <DIV style="position:absolute;top:218;left:236"><nobr><span class="ft30"><b>Nested Sections</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:218;left:341"><nobr><span class="ft9"> Sections containing other subsections. Nested sections are supported in </span></nobr></DIV> |
| <DIV style="position:absolute;top:233;left:278"><nobr><span class="ft9">the help files.</span></nobr></DIV> |
| <DIV style="position:absolute;top:265;left:236"><nobr><span class="ft30"><b>Nested Tables</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:265;left:327"><nobr><span class="ft9"> Tables containing other tables. Nested tables are <i>unsupported</i> in the help </span></nobr></DIV> |
| <DIV style="position:absolute;top:280;left:278"><nobr><span class="ft9">files.</span></nobr></DIV> |
| <DIV style="position:absolute;top:312;left:236"><nobr><span class="ft30"><b>Node</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:312;left:269"><nobr><span class="ft9"> A node is a part of the help content tree that is used to group help topics. See <i><A href="HelpAuthoring_c.html#25">Contents</i></a></span></nobr></DIV> |
| <DIV style="position:absolute;top:327;left:278"><nobr><span class="ft18"><A href="HelpAuthoring_c.html#25"><i>Branch</i></a> on page<A href="HelpAuthoring_c.html#25"> 25</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:359;left:236"><nobr><span class="ft30"><b>Output Tree</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:359;left:312"><nobr><span class="ft9"> A directory tree (aka <i>solver</i>) that takes all files that are produced on "making" </span></nobr></DIV> |
| <DIV style="position:absolute;top:374;left:278"><nobr><span class="ft9">(compiling/linking) source files. See </span></nobr></DIV> |
| <DIV style="position:absolute;top:375;left:494"><nobr><span class="ft14">tools.openoffice.org</span></nobr></DIV> |
| <DIV style="position:absolute;top:374;left:656"><nobr><span class="ft9">.</span></nobr></DIV> |
| <DIV style="position:absolute;top:408;left:236"><nobr><span class="ft30"><b>Platform</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:408;left:290"><nobr><span class="ft9"> Operating System, such as Linux, Solaris x86, Solaris SPARC, or Windows.</span></nobr></DIV> |
| <DIV style="position:absolute;top:440;left:236"><nobr><span class="ft30"><b>Reference Information</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:440;left:379"><nobr><span class="ft9"> Information in OpenOffice.org help that explains the effect or function </span></nobr></DIV> |
| <DIV style="position:absolute;top:455;left:278"><nobr><span class="ft9">of a user interface element.</span></nobr></DIV> |
| <DIV style="position:absolute;top:487;left:236"><nobr><span class="ft30"><b>Role</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:487;left:265"><nobr><span class="ft9"> In the help files that type of a paragraph is specified by its </span></nobr></DIV> |
| <DIV style="position:absolute;top:488;left:627"><nobr><span class="ft14">role</span></nobr></DIV> |
| <DIV style="position:absolute;top:487;left:660"><nobr><span class="ft9"> attribute.</span></nobr></DIV> |
| <DIV style="position:absolute;top:520;left:236"><nobr><span class="ft30"><b>Section Delimiter Line</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:520;left:377"><nobr><span class="ft9"> A section inside OpenOffice.org is delimited by two gray lines.</span></nobr></DIV> |
| <DIV style="position:absolute;top:552;left:236"><nobr><span class="ft30"><b>Solver</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:552;left:277"><nobr><span class="ft9"> see <i>Output Tree</i>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:584;left:236"><nobr><span class="ft30"><b>Style Sheet</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:584;left:308"><nobr><span class="ft9"> A document containing commands for transforming an XML file (transformation </span></nobr></DIV> |
| <DIV style="position:absolute;top:599;left:278"><nobr><span class="ft9">style sheet) or for displaying an XML or HTML file (cascading style sheet).</span></nobr></DIV> |
| <DIV style="position:absolute;top:632;left:236"><nobr><span class="ft30"><b>Symbolic Name</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:632;left:336"><nobr><span class="ft9"> The help IDs used in the applications can be transformed to symbolic </span></nobr></DIV> |
| <DIV style="position:absolute;top:647;left:278"><nobr><span class="ft9">names that are defined in the list of help ids, </span></nobr></DIV> |
| <DIV style="position:absolute;top:648;left:546"><nobr><span class="ft14">hid.lst</span></nobr></DIV> |
| <DIV style="position:absolute;top:647;left:603"><nobr><span class="ft9">. They are symbolic identifiers that </span></nobr></DIV> |
| <DIV style="position:absolute;top:663;left:278"><nobr><span class="ft9">give the number a somewhat descriptive name.</span></nobr></DIV> |
| <DIV style="position:absolute;top:695;left:236"><nobr><span class="ft30"><b>Tool Tip</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:695;left:288"><nobr><span class="ft9"> A synonym for an extended tip.</span></nobr></DIV> |
| <DIV style="position:absolute;top:728;left:236"><nobr><span class="ft30"><b>Topic ID</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:728;left:289"><nobr><span class="ft9"> Each help file (aka topic) has a unique topic </span></nobr></DIV> |
| <DIV style="position:absolute;top:727;left:569"><nobr><span class="ft3">ID</span></nobr></DIV> |
| <DIV style="position:absolute;top:728;left:584"><nobr><span class="ft9"> to be identified. It usually is created </span></nobr></DIV> |
| <DIV style="position:absolute;top:744;left:278"><nobr><span class="ft9">from the help file name.</span></nobr></DIV> |
| <DIV style="position:absolute;top:776;left:236"><nobr><span class="ft30"><b>Transformation Style Sheet</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:776;left:411"><nobr><span class="ft9"> The style sheet used for transformation.</span></nobr></DIV> |
| <DIV style="position:absolute;top:808;left:236"><nobr><span class="ft30"><b>Transformation</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:808;left:335"><nobr><span class="ft9"> In this context, the process of converting the XML format of the help </span></nobr></DIV> |
| <DIV style="position:absolute;top:823;left:278"><nobr><span class="ft9">document. The major transformation takes place when the help is displayed. The </span></nobr></DIV> |
| <DIV style="position:absolute;top:838;left:278"><nobr><span class="ft9">transformation style sheet </span></nobr></DIV> |
| <DIV style="position:absolute;top:839;left:437"><nobr><span class="ft14">main_transform.xsl</span></nobr></DIV> |
| <DIV style="position:absolute;top:838;left:582"><nobr><span class="ft9"> is used for that.</span></nobr></DIV> |
| <DIV style="position:absolute;top:871;left:236"><nobr><span class="ft30"><b>UNO Command Name</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:871;left:376"><nobr><span class="ft9"> One type of help ID that is used in the applications. Other than </span></nobr></DIV> |
| <DIV style="position:absolute;top:887;left:278"><nobr><span class="ft9">"normal" help ids which are numerical, these command names are symbolic identifiers </span></nobr></DIV> |
| <DIV style="position:absolute;top:902;left:278"><nobr><span class="ft9">and don't need to be converted.</span></nobr></DIV> |
| <DIV style="position:absolute;top:934;left:236"><nobr><span class="ft30"><b>Validation</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:934;left:300"><nobr><span class="ft9"> The process of checking the validity of a help file. See <i><A href="HelpAuthoring_c.html#103">Validating</i></a> on page <A href="HelpAuthoring_c.html#103">103</a>.</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:788"><nobr><span class="ft4"><b>107</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 108 --> |
| <a name="108"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| .ft31{font-size:8px;font-family:Times;color:#34546a;} |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c108.png" alt="background image"> |
| <DIV style="position:absolute;top:154;left:193"><nobr><span class="ft10"><b>XML Help Document Type Definition</b></span></nobr></DIV> |
| <DIV style="position:absolute;top:194;left:225"><nobr><span class="ft31"><!-- </span></nobr></DIV> |
| <DIV style="position:absolute;top:206;left:225"><nobr><span class="ft31"> Version 03-Feb-2006</span></nobr></DIV> |
| <DIV style="position:absolute;top:218;left:225"><nobr><span class="ft31"> added optional localize attribute to images</span></nobr></DIV> |
| <DIV style="position:absolute;top:230;left:225"><nobr><span class="ft31">--></span></nobr></DIV> |
| <DIV style="position:absolute;top:253;left:225"><nobr><span class="ft31"><!ELEMENT ahelp (#PCDATA | embedvar | br | comment | emph | item | link | </span></nobr></DIV> |
| <DIV style="position:absolute;top:265;left:225"><nobr><span class="ft31">switchinline | variable)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:277;left:225"><nobr><span class="ft31"><!ATTLIST ahelp</span></nobr></DIV> |
| <DIV style="position:absolute;top:289;left:225"><nobr><span class="ft31"> hid CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:301;left:225"><nobr><span class="ft31"> visibility (hidden | visible) #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:313;left:225"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:337;left:225"><nobr><span class="ft31"><!ELEMENT alt (#PCDATA)></span></nobr></DIV> |
| <DIV style="position:absolute;top:349;left:225"><nobr><span class="ft31"><!ATTLIST alt</span></nobr></DIV> |
| <DIV style="position:absolute;top:361;left:225"><nobr><span class="ft31"> xml-lang CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:373;left:225"><nobr><span class="ft31"> id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:385;left:225"><nobr><span class="ft31"> localize CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:397;left:225"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:420;left:225"><nobr><span class="ft31"><!ELEMENT body (section | paragraph | table | comment | bookmark | switch | </span></nobr></DIV> |
| <DIV style="position:absolute;top:432;left:225"><nobr><span class="ft31">embed | list | sort)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:456;left:225"><nobr><span class="ft31"><!ELEMENT bookmark (bookmark_value)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:468;left:225"><nobr><span class="ft31"><!ATTLIST bookmark</span></nobr></DIV> |
| <DIV style="position:absolute;top:480;left:225"><nobr><span class="ft31"> branch CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:492;left:225"><nobr><span class="ft31"> xml-lang CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:504;left:225"><nobr><span class="ft31"> id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:516;left:225"><nobr><span class="ft31"> localize CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:528;left:225"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:552;left:225"><nobr><span class="ft31"><!ELEMENT bookmark_value (#PCDATA | embedvar)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:576;left:225"><nobr><span class="ft31"><!ELEMENT br EMPTY></span></nobr></DIV> |
| <DIV style="position:absolute;top:599;left:225"><nobr><span class="ft31"><!ELEMENT caption (#PCDATA | embedvar | br | emph | item | link | switchinline | </span></nobr></DIV> |
| <DIV style="position:absolute;top:611;left:225"><nobr><span class="ft31">variable)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:623;left:225"><nobr><span class="ft31"><!ATTLIST caption</span></nobr></DIV> |
| <DIV style="position:absolute;top:635;left:225"><nobr><span class="ft31"> xml-lang CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:647;left:225"><nobr><span class="ft31"> id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:659;left:225"><nobr><span class="ft31"> localize CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:671;left:225"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:695;left:225"><nobr><span class="ft31"><!ELEMENT case (paragraph | table | comment | bookmark | embed | link | list | </span></nobr></DIV> |
| <DIV style="position:absolute;top:707;left:225"><nobr><span class="ft31">switch | section | sort)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:719;left:225"><nobr><span class="ft31"><!ATTLIST case</span></nobr></DIV> |
| <DIV style="position:absolute;top:730;left:225"><nobr><span class="ft31"> select CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:742;left:225"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:766;left:225"><nobr><span class="ft31"><!ELEMENT caseinline (#PCDATA | image | embedvar | br | emph | item | link | </span></nobr></DIV> |
| <DIV style="position:absolute;top:778;left:225"><nobr><span class="ft31">switchinline | variable | ahelp | object)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:790;left:225"><nobr><span class="ft31"><!ATTLIST caseinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:802;left:225"><nobr><span class="ft31"> select CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:814;left:225"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:838;left:225"><nobr><span class="ft31"><!ELEMENT comment (#PCDATA)></span></nobr></DIV> |
| <DIV style="position:absolute;top:862;left:225"><nobr><span class="ft31"><!ELEMENT created (#PCDATA)></span></nobr></DIV> |
| <DIV style="position:absolute;top:874;left:225"><nobr><span class="ft31"><!ATTLIST created</span></nobr></DIV> |
| <DIV style="position:absolute;top:886;left:225"><nobr><span class="ft31"> date CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:897;left:225"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:921;left:225"><nobr><span class="ft31"><!ELEMENT default (paragraph | table | comment | bookmark | embed | link | list </span></nobr></DIV> |
| <DIV style="position:absolute;top:933;left:225"><nobr><span class="ft31">| switch | section | sort)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:957;left:225"><nobr><span class="ft31"><!ELEMENT defaultinline (#PCDATA | image | embedvar | br | emph | item | link | </span></nobr></DIV> |
| <DIV style="position:absolute;top:969;left:225"><nobr><span class="ft31">switchinline | variable | ahelp | object)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:993;left:225"><nobr><span class="ft31"><!ELEMENT embed EMPTY></span></nobr></DIV> |
| <DIV style="position:absolute;top:1005;left:225"><nobr><span class="ft31"><!ATTLIST embed</span></nobr></DIV> |
| <DIV style="position:absolute;top:1017;left:225"><nobr><span class="ft31"> href CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1029;left:225"><nobr><span class="ft31"> role CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1041;left:225"><nobr><span class="ft31"> level CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1053;left:225"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:1076;left:225"><nobr><span class="ft31"><!ELEMENT embedvar EMPTY></span></nobr></DIV> |
| <DIV style="position:absolute;top:1088;left:225"><nobr><span class="ft31"><!ATTLIST embedvar</span></nobr></DIV> |
| <DIV style="position:absolute;top:1100;left:225"><nobr><span class="ft31"> href CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>108</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 109 --> |
| <a name="109"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c109.png" alt="background image"> |
| <DIV style="position:absolute;top:147;left:268"><nobr><span class="ft31"> markup (keep | ignore) #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:159;left:268"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:183;left:268"><nobr><span class="ft31"><!ELEMENT emph (#PCDATA | item | comment | help-id-missing)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:206;left:268"><nobr><span class="ft31"><!ELEMENT filename (#PCDATA)></span></nobr></DIV> |
| <DIV style="position:absolute;top:230;left:268"><nobr><span class="ft31"><!ELEMENT helpdocument (meta, body)></span></nobr></DIV> |
| <DIV style="position:absolute;top:242;left:268"><nobr><span class="ft31"><!ATTLIST helpdocument</span></nobr></DIV> |
| <DIV style="position:absolute;top:254;left:268"><nobr><span class="ft31"> version CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:266;left:268"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:290;left:268"><nobr><span class="ft31"><!ELEMENT history (created, lastedited)></span></nobr></DIV> |
| <DIV style="position:absolute;top:314;left:268"><nobr><span class="ft31"><!ELEMENT image (caption* | alt+)?></span></nobr></DIV> |
| <DIV style="position:absolute;top:326;left:268"><nobr><span class="ft31"><!ATTLIST image</span></nobr></DIV> |
| <DIV style="position:absolute;top:338;left:268"><nobr><span class="ft31"> src CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:349;left:268"><nobr><span class="ft31"> width CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:361;left:268"><nobr><span class="ft31"> height CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:373;left:268"><nobr><span class="ft31"> id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:385;left:268"><nobr><span class="ft31"> localize CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:397;left:268"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:421;left:268"><nobr><span class="ft31"><!ELEMENT item (#PCDATA)></span></nobr></DIV> |
| <DIV style="position:absolute;top:433;left:268"><nobr><span class="ft31"><!ATTLIST item</span></nobr></DIV> |
| <DIV style="position:absolute;top:445;left:268"><nobr><span class="ft31"> type CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:457;left:268"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:481;left:268"><nobr><span class="ft31"><!ELEMENT lastedited (#PCDATA)></span></nobr></DIV> |
| <DIV style="position:absolute;top:493;left:268"><nobr><span class="ft31"><!ATTLIST lastedited</span></nobr></DIV> |
| <DIV style="position:absolute;top:505;left:268"><nobr><span class="ft31"> date CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:516;left:268"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:540;left:268"><nobr><span class="ft31"><!ELEMENT link (#PCDATA | embedvar | emph | item | variable | switchinline)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:552;left:268"><nobr><span class="ft31"><!ATTLIST link</span></nobr></DIV> |
| <DIV style="position:absolute;top:564;left:268"><nobr><span class="ft31"> href CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:576;left:268"><nobr><span class="ft31"> name CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:588;left:268"><nobr><span class="ft31"> type CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:600;left:268"><nobr><span class="ft31"> target CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:612;left:268"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:636;left:268"><nobr><span class="ft31"><!ELEMENT list (listitem | (comment)*)+></span></nobr></DIV> |
| <DIV style="position:absolute;top:648;left:268"><nobr><span class="ft31"><!ATTLIST list</span></nobr></DIV> |
| <DIV style="position:absolute;top:660;left:268"><nobr><span class="ft31"> type CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:672;left:268"><nobr><span class="ft31"> startwith CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:683;left:268"><nobr><span class="ft31"> format (1 | i | I | a | A) #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:695;left:268"><nobr><span class="ft31"> bullet (disc | circle | square) #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:707;left:268"><nobr><span class="ft31"> sorted (asc | desc) #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:719;left:268"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:743;left:268"><nobr><span class="ft31"><!ELEMENT listitem (comment | section | paragraph | table | switch | embed | </span></nobr></DIV> |
| <DIV style="position:absolute;top:755;left:268"><nobr><span class="ft31">bookmark)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:767;left:268"><nobr><span class="ft31"><!ATTLIST listitem</span></nobr></DIV> |
| <DIV style="position:absolute;top:779;left:268"><nobr><span class="ft31"> format (1 | i | I | a | A) #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:791;left:268"><nobr><span class="ft31"> bullet (disc | circle | square) #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:803;left:310"><nobr><span class="ft31">class CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:815;left:268"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:838;left:268"><nobr><span class="ft31"><!ELEMENT meta (topic, history?)></span></nobr></DIV> |
| <DIV style="position:absolute;top:862;left:268"><nobr><span class="ft31"><!ELEMENT object EMPTY></span></nobr></DIV> |
| <DIV style="position:absolute;top:874;left:268"><nobr><span class="ft31"><!ATTLIST object</span></nobr></DIV> |
| <DIV style="position:absolute;top:886;left:268"><nobr><span class="ft31"> type CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:898;left:268"><nobr><span class="ft31"> id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:910;left:268"><nobr><span class="ft31"> data CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:922;left:268"><nobr><span class="ft31"> height CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:934;left:268"><nobr><span class="ft31"> width CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:946;left:268"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:970;left:268"><nobr><span class="ft31"><!ELEMENT paragraph (#PCDATA | image | comment | embedvar | br | emph | item | </span></nobr></DIV> |
| <DIV style="position:absolute;top:982;left:268"><nobr><span class="ft31">link | switchinline | variable | ahelp | object | bookmark | help-id-missing)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:993;left:268"><nobr><span class="ft31"><!ATTLIST paragraph</span></nobr></DIV> |
| <DIV style="position:absolute;top:1005;left:268"><nobr><span class="ft31"> role CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1017;left:268"><nobr><span class="ft31"> level CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1029;left:268"><nobr><span class="ft31"> id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1041;left:268"><nobr><span class="ft31"> l10n CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1053;left:268"><nobr><span class="ft31"> xml-lang CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1065;left:268"><nobr><span class="ft31"> oldref CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1077;left:268"><nobr><span class="ft31"> localize CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:1089;left:268"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:1113;left:268"><nobr><span class="ft31"><!ELEMENT section (section | paragraph | table | list | comment | bookmark | </span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:788"><nobr><span class="ft4"><b>109</b></span></nobr></DIV> |
| </DIV> |
| <!-- Page 110 --> |
| <a name="110"></a> |
| <DIV style="position:relative;width:892;height:1263;"> |
| <STYLE type="text/css"> |
| <!-- |
| --> |
| </STYLE> |
| <IMG width="892" height="1263" src="HelpAuthoring_c110.png" alt="background image"> |
| <DIV style="position:absolute;top:147;left:225"><nobr><span class="ft31">embed | switch | sort )*></span></nobr></DIV> |
| <DIV style="position:absolute;top:159;left:225"><nobr><span class="ft31"><!ATTLIST section</span></nobr></DIV> |
| <DIV style="position:absolute;top:171;left:225"><nobr><span class="ft31"> id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:183;left:225"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:206;left:225"><nobr><span class="ft31"><!ELEMENT sort (section+)></span></nobr></DIV> |
| <DIV style="position:absolute;top:218;left:225"><nobr><span class="ft31"><!ATTLIST sort</span></nobr></DIV> |
| <DIV style="position:absolute;top:230;left:225"><nobr><span class="ft31"> order (asc | desc) #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:242;left:225"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:266;left:225"><nobr><span class="ft31"><!ELEMENT switch ((case | comment)* | default?)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:278;left:225"><nobr><span class="ft31"><!ATTLIST switch</span></nobr></DIV> |
| <DIV style="position:absolute;top:290;left:225"><nobr><span class="ft31"> select (sys | appl | distrib | target | lang | ver) #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:302;left:225"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:326;left:225"><nobr><span class="ft31"><!ELEMENT switchinline ((caseinline)+, (defaultinline?)?)></span></nobr></DIV> |
| <DIV style="position:absolute;top:338;left:225"><nobr><span class="ft31"><!ATTLIST switchinline</span></nobr></DIV> |
| <DIV style="position:absolute;top:349;left:225"><nobr><span class="ft31"> select (sys | appl | distrib | target | ver | lang) #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:361;left:225"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:385;left:225"><nobr><span class="ft31"><!ELEMENT table (caption*, tablerow+)></span></nobr></DIV> |
| <DIV style="position:absolute;top:397;left:225"><nobr><span class="ft31"><!ATTLIST table</span></nobr></DIV> |
| <DIV style="position:absolute;top:409;left:225"><nobr><span class="ft31"> name CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:421;left:225"><nobr><span class="ft31"> width CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:433;left:225"><nobr><span class="ft31"> height CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:445;left:225"><nobr><span class="ft31"> unit CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:457;left:225"><nobr><span class="ft31"> class CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:469;left:225"><nobr><span class="ft31"> id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:481;left:225"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:505;left:225"><nobr><span class="ft31"><!ELEMENT tablecell (section | paragraph | comment | embed | bookmark | image | </span></nobr></DIV> |
| <DIV style="position:absolute;top:516;left:225"><nobr><span class="ft31">list)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:528;left:225"><nobr><span class="ft31"><!ATTLIST tablecell</span></nobr></DIV> |
| <DIV style="position:absolute;top:540;left:225"><nobr><span class="ft31"> colspan CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:552;left:225"><nobr><span class="ft31"> rowspan CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:564;left:225"><nobr><span class="ft31"> width CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:576;left:225"><nobr><span class="ft31"> class CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:588;left:225"><nobr><span class="ft31"> unit CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:600;left:225"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:624;left:225"><nobr><span class="ft31"><!ELEMENT tablerow (tablecell+)></span></nobr></DIV> |
| <DIV style="position:absolute;top:636;left:225"><nobr><span class="ft31"><!ATTLIST tablerow</span></nobr></DIV> |
| <DIV style="position:absolute;top:648;left:225"><nobr><span class="ft31"> height CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:660;left:225"><nobr><span class="ft31"> class CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:672;left:225"><nobr><span class="ft31"> unit CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:683;left:225"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:707;left:225"><nobr><span class="ft31"><!ELEMENT title (#PCDATA)></span></nobr></DIV> |
| <DIV style="position:absolute;top:719;left:225"><nobr><span class="ft31"><!ATTLIST title</span></nobr></DIV> |
| <DIV style="position:absolute;top:731;left:225"><nobr><span class="ft31"> xml-lang CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:743;left:225"><nobr><span class="ft31"> id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:755;left:225"><nobr><span class="ft31"> localize CDATA #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:767;left:225"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:791;left:225"><nobr><span class="ft31"><!ELEMENT topic (title+, filename, bookmark*)></span></nobr></DIV> |
| <DIV style="position:absolute;top:803;left:225"><nobr><span class="ft31"><!ATTLIST topic</span></nobr></DIV> |
| <DIV style="position:absolute;top:815;left:225"><nobr><span class="ft31"> id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:826;left:225"><nobr><span class="ft31"> indexer (exclude | include) #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:838;left:267"><nobr><span class="ft31">status (DRAFT | FINAL | PUBLISH | STALLED | DEPRECATED) #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:850;left:225"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:874;left:225"><nobr><span class="ft31"><!ELEMENT variable (#PCDATA | ahelp | embedvar | br | emph | item | link | </span></nobr></DIV> |
| <DIV style="position:absolute;top:886;left:225"><nobr><span class="ft31">variable | image | object | switchinline)*></span></nobr></DIV> |
| <DIV style="position:absolute;top:898;left:225"><nobr><span class="ft31"><!ATTLIST variable</span></nobr></DIV> |
| <DIV style="position:absolute;top:910;left:225"><nobr><span class="ft31"> id CDATA #REQUIRED</span></nobr></DIV> |
| <DIV style="position:absolute;top:922;left:225"><nobr><span class="ft31"> visibility (hidden | visible) #IMPLIED</span></nobr></DIV> |
| <DIV style="position:absolute;top:934;left:225"><nobr><span class="ft31">></span></nobr></DIV> |
| <DIV style="position:absolute;top:958;left:225"><nobr><span class="ft31"><!ELEMENT help-id-missing EMPTY></span></nobr></DIV> |
| <DIV style="position:absolute;top:1148;left:85"><nobr><span class="ft4"><b>110</b></span></nobr></DIV> |
| </DIV> |
| <hr> |
| <A name="outline"></a><h1>Document Outline</h1> |
| <ul><li><A href="HelpAuthoring_c.html#9">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#9">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#9">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#9">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#10">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#10">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#10">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#11">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#11">þÿ</A> |
| </ul><li><A href="HelpAuthoring_c.html#13">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#13">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#14">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#15">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#15">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#15">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#16">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#16">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#16">þÿ</A> |
| </ul><li><A href="HelpAuthoring_c.html#16">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#18">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#19">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#19">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#19">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#21">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#22">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#22">þÿ</A> |
| </ul></ul><li><A href="HelpAuthoring_c.html#23">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#23">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#23">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#24">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#25">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#25">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#26">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#26">þÿ</A> |
| </ul><li><A href="HelpAuthoring_c.html#27">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#27">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#28">þÿ</A> |
| </ul><li><A href="HelpAuthoring_c.html#28">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#29">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#29">þÿ</A> |
| </ul><li><A href="HelpAuthoring_c.html#30">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#31">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#31">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#31">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#32">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#32">þÿ</A> |
| </ul></ul><li><A href="HelpAuthoring_c.html#35">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#35">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#35">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#36">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#36">þÿ</A> |
| </ul><li><A href="HelpAuthoring_c.html#37">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#37">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#38">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#38">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#39">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#40">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#41">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#41">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#42">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#43">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#43">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#44">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#45">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#45">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#46">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#47">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#48">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#48">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#49">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#49">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#50">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#50">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#51">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#52">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#53">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#54">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#55">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#56">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#57">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#58">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#59">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#60">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#61">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#62">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#63">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#64">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#66">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#67">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#68">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#69">þÿ</A> |
| </ul><li><A href="HelpAuthoring_c.html#70">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#70">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#71">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#72">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#72">þÿ</A> |
| </ul></ul><li><A href="HelpAuthoring_c.html#75">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#75">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#75">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#76">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#76">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#77">þÿ</A> |
| </ul><li><A href="HelpAuthoring_c.html#78">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#78">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#79">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#79">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#79">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#79">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#79">þÿ</A> |
| </ul><li><A href="HelpAuthoring_c.html#80">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#80">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#80">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#81">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#81">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#82">þÿ</A> |
| </ul><li><A href="HelpAuthoring_c.html#82">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#82">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#83">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#84">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#84">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#84">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#84">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#84">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#85">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#86">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#87">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#87">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#87">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#87">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#87">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#88">þÿ</A> |
| </ul><li><A href="HelpAuthoring_c.html#89">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#89">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#89">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#90">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#90">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#90">þÿ</A> |
| </ul><li><A href="HelpAuthoring_c.html#90">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#90">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#90">þÿ</A> |
| </ul><li><A href="HelpAuthoring_c.html#91">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#91">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#92">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#92">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#93">þÿ</A> |
| </ul><li><A href="HelpAuthoring_c.html#93">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#93">þÿ</A> |
| </ul><li><A href="HelpAuthoring_c.html#94">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#94">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#94">þÿ</A> |
| </ul><li><A href="HelpAuthoring_c.html#94">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#95">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#95">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#95">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#95">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#95">þÿ</A> |
| </ul><li><A href="HelpAuthoring_c.html#95">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#95">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#96">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#97">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#97">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#97">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#98">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#98">þÿ</A> |
| </ul><li><A href="HelpAuthoring_c.html#99">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#99">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#100">þÿ</A> |
| </ul><li><A href="HelpAuthoring_c.html#103">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#103">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#103">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#103">þÿ</A> |
| </ul><li><A href="HelpAuthoring_c.html#104">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#104">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#104">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#104">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#104">þÿ</A> |
| </ul></ul><li><A href="HelpAuthoring_c.html#105">þÿ</A> |
| <ul><li><A href="HelpAuthoring_c.html#105">þÿ</A> |
| <li><A href="HelpAuthoring_c.html#108">þÿ</A> |
| </ul></ul></BODY> |
| </HTML> |
