Development Version: 0.9.0
Stable Version: 0.8.0

Mlview Manual V 0.2

Mohinze Tidjani

Wrote this document
GNOME Documentation Project

Baptiste Mille-Mathias

MlView development team

Dodji Seketeli

MlView development team

This manual describes version 0.7.1 of MView XML Editor.

Feedback

To report a bug or make a suggestion regarding the MlView application or this manual, follow the directions in the GNOME Feedback Page.

Revision History
Revision MlView Manual V0.2December 2004

Mohinze Tidjani

GNOME Documentation Project


Introduction

MlView is a generic XML Editor to edit xml files in a user friendly manner. MlView focuses on the support for multiple and different editing views for documents. Its goal is to support comfortable editing of every XML file and provide a powerful platform structured documents editing.

Getting Started

To Start MlView

You can start MlView in the following ways:

Applications menu

Choose Submenu Name ->MlView.

Command line

To start MlView from a command line, type the following command, then press Return:

mlview myxmlfilename.xml

where myxmlfilename.xml is the name of the file you want to open.

MlView is designed around the concept of "Multiple editing views". When you open an xml document, MlView creates an editing view to let you edit that document. The editing view is actually the grapical representation of the document.

When You Start MlView

When you start MlView, the following window is displayed.

Figure 1. MlView Start Up Window

Shows MlView main window. Contains titlebar, menubar, toolbar, display area, and
	      scrollbars. Menubar contains File, Edit, Tools, and Help menus.

The MlView window contains the following elements:

Menubar.

The menus on the menubar contain all of the commands you need to work with files in MlView.

Toolbar.

The toolbar contains a subset of the commands that you can access from the menubar.

Usage

You can use the MlView application to perform the following tasks:

Open a XML File

to open a xml file, choose File->Open . The Open File dialog is displayed. Select the file that you want to open, then click OK. To open a file from a location, choose File->Open a location. Enter the URI-> where the distant file reside.

If you try to open a file format that MlView does not recognize, the application displays an error message.

While loading the file, if a DTD is specified in you document, Mlview ask you if you want to load this DTD or if you want to use another DTD.

Open another View

In MlView, when you open a document, the graphical representation of the document you see on the screen is called an "editing view" of that document. The document itself is an abstraction that is kept in memory.

To Open another View of your opened xml document, choose Tools->New View . The main windows will now display another view of your opened document.

Information about multi view: This feature would be part of the mlview 0.8 release version

Caution

This feature in not part on the mlview 0.7.1 release version

Scroll a XML File

To scroll a xml file that is larger than the image window or full screen window, you can use the following methods:

  • Use the arrow keys on the keyboard.

  • Use the scrollbars on the window.

Edit an opened XML Document

To edit an opened xml document, you can do one of the following actions :

  • Add a Child Node. To do so, choose Edit->Add A Child Node.

  • Insert a node before the current node. To do so, choose Edit->Insert A Node Before.

  • Insert a node after the current node. To do so, choose Edit->Insert A Node After.

  • Copy a node. To do so, choose Edit->Copy A Node.

  • Cut a node. To do so, choose Edit->Cut A Node.

  • Paste a node as child of the current node. To do so, choose Edit->Paste A Node As Child.

  • Paste A Node As preceding-sibling. To do so, choose Edit->Paste A Node As preceding-sibling.

  • Paste A Node As following-sibling. To do so, choose Edit->Paste A Node As following-sibling.

  • Select Next Node. To do so, choose Edit->Select Next Node.

  • Select Previous Node. To do so, choose Edit->Select Previous Node.

  • Select Parent Node. To do so, choose Edit->Select Parent Node.

  • Search for A Node. To do so, choose Edit->Search for A Node.

To Transform an XML Document

To tranform an xml document into another xml document, using xslt and a template, do the following:

  • From the Tool Bar, clikc on->Apply A XSL Transfromation.

  • From the menu bar, choose Tools->Apply A XSL Transfromation.

Tip

MlView will ask you to open the xsl file you want to use for the transfromation. If one or more xsl file are already open, mlview will ask which one you want to use for your transformation.

To Validate a XML Document

To validate a xml document against a DTD, do the folowing:

  • From the menu bar, choose Tools->Schemasto load the DTD file you want to validate your document against.

  • Once the DTD file is load on MlView, From the menu bar, choose Tools->Validate a XML Document. A validation windows pop up and ask you to run the validation again the choosen DTD file

  • From the validation windows, choose Run. The validation windows indicate wether the validation was succesfull or not.

Tip

To Close a XML Document

To close a xml file, choose File->Close

To Close MlView

To close MlView application, choose File->Exit. If there is some opened documents, MlView will close all of the windows before to quit.

Warning

If there is some unsaved document, MlView will warn you and ask you if you want to save them.

Settings

To configure MlView, choose Settings->Preferences. The Preferences dialog contains the following tabbed sections:

Display

Plugins

You can set the following plugins preferences:

About MlView

MlView was written by Dodji Seketeli (Author and maintainer) ().

Substantial contributors: Nicolas Centa () Philippe Mechai () Baptiste Mille-Mathias ()

Former contributors: Gael Chamoulaud Stephane Bonhomme

To find more information about MlView, please visit the MlView Web page.

To report a bug or make a suggestion regarding this application or this manual, follow the directions in this document.

This program is distributed under the terms of the GNU General Public license as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license can be found at this link, or in the file COPYING included with the source code of this program.