XMLmind FO Converter XMLmind XML Editor - User's Guide Hussein Shafie Pixware <xmleditor-support@xmlmind.com> XMLmind XML Editor - User's Guide Hussein Shafie Pixware <xmleditor-support@xmlmind.com> Published July 21, 2008 Abstract This document is essentially a tutorial for XMLmind XML Editor (XXE for short). It also contains installation instructions for Unix and information about the content of the distribution. 1. Install PAGEREF install 0 1. Installing XXE PAGEREF installing_xxe 0 1.1. Requirements PAGEREF d0e50 0 1.2. Install on Linux (or manual install on the Mac) PAGEREF d0e121 0 1.3. Manual install on Windows PAGEREF d0e166 0 2. Content of the installation directory PAGEREF content_of_install_dir 0 3. Acknowledgments PAGEREF acknowledgments 0 2. Tutorial: basics PAGEREF tutorial_basics 0 1. Starting XXE PAGEREF starting_xxe 0 2. Creating a new document PAGEREF new_document 0 3. Inserting elements PAGEREF insert_element 0 4. Selecting elements PAGEREF select_element 0 4.1. The implicit element selection PAGEREF d0e920 0 4.2. The text selection PAGEREF d0e938 0 4.3. The node selection PAGEREF d0e952 0 4.3.1. Most general method PAGEREF d0e955 0 4.3.2. Directly selecting a node PAGEREF d0e1046 0 4.3.3. Selecting a node range PAGEREF d0e1101 0 5. Navigating through elements PAGEREF navigate_through_elements 0 5.1. Using Tab to go from a #text to the other, just like in a form PAGEREF d0e1190 0 5.2. XXE makes a difference between the end of a #text node and the beginning of the #text node next to it PAGEREF d0e1250 0 6. Copy, cut, paste, delete PAGEREF copy_cut_paste 0 6.1. Copy, cut, paste, delete applied to the text selection PAGEREF d0e1437 0 6.2. Copy, cut, paste, delete applied to the node selection PAGEREF d0e1519 0 7. Splitting and joining elements PAGEREF split_join_element 0 7.1. Simple Split and Join PAGEREF d0e1595 0 7.2. Split and Join generalized PAGEREF d0e1658 0 8. Replacing elements PAGEREF replace_element 0 9. Converting elements PAGEREF convert_element 0 9.1. Convert applied to the text selection PAGEREF d0e1931 0 9.2. Convert applied to the node selection PAGEREF d0e1989 0 10. Editing element attributes PAGEREF edit_attributes 0 10.1. Required attributes in newly created elements PAGEREF d0e2235 0 11. Checking document validity PAGEREF check_validity 0 3. Tutorial: creating a modular document PAGEREF tutorial_modular_document 0 1. Creating the Copyright.html document PAGEREF create_module 0 2. Inserting a reference to Copyright.html into the XHTML page PAGEREF insert_reference_to_module 0 3. Extensive use of the "Copy as Reference" command PAGEREF extensive_copy_as_reference 0 4. Creating modular documents which are highly interchangeable with other applications PAGEREF interchangeable_modular_documents 0 4. Being productive with XXE PAGEREF being_productive 0 1. Do not use the tree view PAGEREF no_tree_view 0 2. Quickly type plain text after a bold or italic element PAGEREF insert_key 0 3. Quickly insert after an element, another element of the same type PAGEREF add_same_element 0 4. Use auto-completion as much as possible PAGEREF auto_completion 0 5. When possible, apply commands to node ranges PAGEREF node_range 0 6. Learn important keyboard shortcuts PAGEREF keyboard_shortcuts 0 7. Quickly paste selected text using mouse button #2 PAGEREF paste_with_button2 0 8. Drop graphics files on img , imagedata , image , etc, elements PAGEREF drop_graphics_files 0 9. Easily select paragraphs, list items, table rows, etc, using the ``interactive gray margins'' PAGEREF interactive_gray_margins 0 10. Quickly insert ``XML variables'' in your document using the Include tool PAGEREF include_tool 0 XMLmind XML Editor - User's Guide XMLmind XML Editor - User's Guide Chapter 1. Install 1. Installing XXE 1.1. Requirements Sun or Apple Java ™ runtime 1.5 or above. At least 512Mb of memory and a 1GHz CPU. 60Mb of free disk space, 120Mb for a self-contained distribution which includes a Java ™ 1.6 runtime. XXE is officially supported on Windows 2000/XP/Vista, on Linux 2.6 and on Mac OS X 10.4 (Tiger) and 10.5 (Leopard). It is possible to use it on other Java ™ 1.5+ platforms (e.g. Solaris), but without support from XMLmind. XXE has been tested with: Sun Java ™ runtime 1.5+ (up to 1.6.0_07) under Windows 2000, XP, Vista, openSUSE Linux 9.3, 10.2, Ubuntu Linux 7.04 (Feisty Fawn). Mac OS X 10.4.11 (Tiger) or 10.5.4 (Leopard) and the latest Java ™ 1.5 runtime (and also with newest 1.6.0_05 runtime). Apache HTTP server 2.0.44 + mod_dav with mod_dav_fs and mod_dav_svn ( Subversion ) backends. Apache Tomcat WebDAV servlet. Various Unix FTP servers. Windows 2003 IIS HTTP server + its WebDAV extension. Windows 2003 FTP server. 1.2. Install on Linux (or manual install on the Mac) Tip On the Mac, it is strongly recommended to download and install the auto-installable .dmg file. Make sure that the Java ™ bin/ directory is referenced in the $PATH and, at the same time, check that the Java ™ runtime in the $PATH has the right version: $ java -version java version "1.6.0" Java(TM) SE Runtime Environment (build 1.6.0-b105) Java HotSpot(TM) Client VM (build 1.6.0-b105, mixed mode, sharing) Unpack the XXE distribution inside any directory you want: $ cd $ tar zxvf xxe-perso-4_0_0.tar.gz $ ls xxe-perso-4_0_0 addon/ bin/ demo/ doc/ XXE is intended to be used directly from the xxe-perso-4_0_0/ directory. That is, you can start XXE by simply executing: $ xxe-perso-4_0_0/bin/xxe & After that, you may want to add xxe-perso-4_0_0/bin/ to your $PATH. 1.3.  Manual install on Windows Tip On Windows, it is strongly recommended to download and install one of the two auto-installable setup.exe files. Make sure that you have a Java ™ 1.5+ runtime installed on your machine. To check this, open a command window and type " java -version " followed by Enter. You should get something looking like this: C:\> java -version java version "1.6.0_05" Java(TM) SE Runtime Environment (build 1.6.0_05-b13) Java HotSpot(TM) Client VM (build 10.0-b19, mixed mode, sharing) Use a tool like WinZip , 7-Zip or Info-Zip 1 Note that Windows XP has built-in support for .zip archives. 1 to unzip the XXE distribution inside any directory you want: C:\> mkdir XMLmind C:\> cd XMLmind C:\XMLmind> unzip xxe-perso-4_0_0.zip C:\XMLmind> dir xxe-perso-4_0_0 ... <DIR> addon ... <DIR> bin ... <DIR> demo ... <DIR> doc XXE is intended to be used directly from the xxe-perso-4_0_0/ directory. That is, you can start XXE by simply executing: C:\XMLmind> xxe-perso-4_0_0\bin\xxe.exe After that, you may want to add a shortcut to " C:\XMLmind\xxe-perso-4_0_0\bin\xxe.exe " on your desktop. Note that the bin directory contains not only xxe.exe , but also an equivalent xxe.bat which may be handy if you intend to customize the way XXE is started. 2. Content of the installation directory bin/ Contains XXE code ( .jar files) and many scripts used to start XXE and its associated utilities. bin/xxe, xxe.bat Scripts used to start XXE. Use xxe on any Unix system. Use xxe.bat on Windows. bin/xxe.exe, xxe.jstart Only when installing XXE on Windows using any of the * setup * .exe distributions. File xxe.exe is XXE launcher and xxe.jstart is its (plain text, UTF-8 encoded) associated parameter file. bin/deploywebstart, deploywebstart.bat Scripts used to generate a Java </