From f0d07e12f6268e76d1b92b3f854a2fa2d0357a4e Mon Sep 17 00:00:00 2001 From: emmajane <> Date: Mon, 24 Jan 2005 03:42:43 +0000 Subject: [PATCH] Added Vex and Conglomerate DocBook visual editors. --- .../LDP-Author-Guide/tools-text-editors.xml | 325 +++++++++--------- .../tools-word-processors.xml | 17 + 2 files changed, 180 insertions(+), 162 deletions(-) diff --git a/LDP/guide/docbook/LDP-Author-Guide/tools-text-editors.xml b/LDP/guide/docbook/LDP-Author-Guide/tools-text-editors.xml index e3fb74c7..657a00a9 100644 --- a/LDP/guide/docbook/LDP-Author-Guide/tools-text-editors.xml +++ b/LDP/guide/docbook/LDP-Author-Guide/tools-text-editors.xml @@ -21,150 +21,8 @@ some tweaking, handle DocBook files. + &configure-emacs; - -
-VIM - vim - - Editors - vim - - - http://www.vim.org - - - No mention of text editors is complete - without talking about vi. - The VIM (Vi IMproved) - editor has the functionality of - regular vi and includes syntax - highlighting of tags. - -
-Getting Started - - There are many versions of vi. - New authors will likely want one of the more - feature-packed versions for syntax highlighting and - a graphical interface including mouse control. - - - Red Hat users will want the following packages: - vim-common, vim-minimal and vim-enhanced. - Debian users will want the following package: vim. - For an X interface (including GUI menus and - mouse control) users will want - gvim. The g in gvim is for - Graphical. - -VIM compiles very easy should you need to build your own. Both vim and gvim are built by default. Syntax highlighting is included but not enabled by default if you have to start from scratch; use the :syntax enable command in VIM to turn this feature on. - -
- -
-Creating New DocBook XML Files - - In both vim and - gvim, .xml files will be - recognized and enter into SGML mode. - A series of known DocBook tags and attributes have - been entered into vim - and will be highlighted one color if the name is known - and another if it is not (for this author the colors are yellow and blue). - - - Having the - correct document type declaration at the top of your - document should add the syntax highlighting. - If you do not see this highlighting you will need to - force VIM into SGML mode (even for XML files) using the - command :set ft=sgml. If you are - working with multiple files for a single XML document you - can add your document type in <-- comments --> to - the top of the file to get the correct syntax - highlighting (you will need to restart the program to see - the change in highlighting). The top line of this file - (tools-text-editors.xml) looks like this: - - - --> -]]> - - -
- -
- Spell Check - - As in Emacs, - Vim, will work quite happily with - aspell. It can be run from within Vim - with the following: - :! aspell -c %. - - - - For more sophisticated spell check alternatives, give Cream or vimspell a try. - -
- -
- Tag Completion - - - The following information is provided by Kwan Lowe. - - - - Vim has a DocBook helper script which can be easily copied into - your .vimscripts - directory and used to auto complete tags while - writing DocBook documents. The script can be downloaded from: - . - - -
- - Grab the file, then untar it. Copy the - dbhelper.vim to your .vimscripts directory if you have one. - - - $ mkdir .vimscripts - $ cp dbhelper.vim .vimscripts - - - - You'll also have to convert the dbhelper.vim file to unix formatting: - - - - $ dos2unix dbhelper.vim - - - - Next, edit your .vimrc file and add the line: - source - /home/yourname/.vimscripts/dbhelper.vim - - - - To use the scripts, enter vi and go into insert mode. Press - , (comma) followed by the shortcut. For example: - ,dtbk - -
- -
- -
epcEdit @@ -218,6 +76,32 @@
+
+Morphon XML editor + + + http://www.morphon.com/xmleditor/index.shtml + + + This is a commercial application which is currently + available for free (with an optional user registration). + It is written in Java, allowing it to run on any platform + that has a Java Virtual Machine (that is, works in both + Windows and Linux). + + + On the plus sides of XMLEditor is the left side of the + screen shows the hierarchy of the document (starting with Book + and so on). Selecting an item in the list brings you to that + part of the document so you can edit it. The right part of the + screen shows the text without any markup or tags being shown. + If you have external files as ELEMENTS (as the LDP Author Guide + does), XMLEditor will follow the links and load the files, so + you always work on the entire work. On the minus side of this, + you will get errors if a file is missing. + +
+
nedit nedit @@ -392,32 +276,149 @@ turn it on explicitly using:
-
-Morphon XML editor +
+VIM + vim + + Editors + vim + - - http://www.morphon.com/xmleditor/index.shtml + http://www.vim.org + + + No mention of text editors is complete + without talking about vi. + The VIM (Vi IMproved) + editor has the functionality of + regular vi and includes syntax + highlighting of tags. + +
+Getting Started + + There are many versions of vi. + New authors will likely want one of the more + feature-packed versions for syntax highlighting and + a graphical interface including mouse control. - This is a commercial application which is currently - available for free (with an optional user registration). - It is written in Java, allowing it to run on any platform - that has a Java Virtual Machine (that is, works in both - Windows and Linux). + Red Hat users will want the following packages: + vim-common, vim-minimal and vim-enhanced. + Debian users will want the following package: vim. + For an X interface (including GUI menus and + mouse control) users will want + gvim. The g in gvim is for + Graphical. - - On the plus sides of XMLEditor is the left side of the - screen shows the hierarchy of the document (starting with Book - and so on). Selecting an item in the list brings you to that - part of the document so you can edit it. The right part of the - screen shows the text without any markup or tags being shown. - If you have external files as ELEMENTS (as the LDP Author Guide - does), XMLEditor will follow the links and load the files, so - you always work on the entire work. On the minus side of this, - you will get errors if a file is missing. +VIM compiles very easy should you need to build your own. Both vim and gvim are built by default. Syntax highlighting is included but not enabled by default if you have to start from scratch; use the :syntax enable command in VIM to turn this feature on.
+
+Creating New DocBook XML Files + + In both vim and + gvim, .xml files will be + recognized and enter into SGML mode. + A series of known DocBook tags and attributes have + been entered into vim + and will be highlighted one color if the name is known + and another if it is not (for this author the colors are yellow and blue). + + + Having the + correct document type declaration at the top of your + document should add the syntax highlighting. + If you do not see this highlighting you will need to + force VIM into SGML mode (even for XML files) using the + command :set ft=sgml. If you are + working with multiple files for a single XML document you + can add your document type in <-- comments --> to + the top of the file to get the correct syntax + highlighting (you will need to restart the program to see + the change in highlighting). The top line of this file + (tools-text-editors.xml) looks like this: + + + --> +]]> + + +
+ +
+ Spell Check + + As in Emacs, + Vim, will work quite happily with + aspell. It can be run from within Vim + with the following: + :! aspell -c %. + + + + For more sophisticated spell check alternatives, give Cream or vimspell a try. + +
+ +
+ Tag Completion + + + The following information is provided by Kwan Lowe. + + + + Vim has a DocBook helper script which can be easily copied into + your .vimscripts + directory and used to auto complete tags while + writing DocBook documents. The script can be downloaded from: + . + + +
+ + Grab the file, then untar it. Copy the + dbhelper.vim to your .vimscripts directory if you have one. + + + $ mkdir .vimscripts + $ cp dbhelper.vim .vimscripts + + + + You'll also have to convert the dbhelper.vim file to unix formatting: + + + + $ dos2unix dbhelper.vim + + + + Next, edit your .vimrc file and add the line: + source + /home/yourname/.vimscripts/dbhelper.vim + + + + To use the scripts, enter vi and go into insert mode. Press + , (comma) followed by the shortcut. For example: + ,dtbk + +
+ +
+ +
+
XMLmind XML Editor (XXE) diff --git a/LDP/guide/docbook/LDP-Author-Guide/tools-word-processors.xml b/LDP/guide/docbook/LDP-Author-Guide/tools-word-processors.xml index d3cfac33..9e7c284d 100644 --- a/LDP/guide/docbook/LDP-Author-Guide/tools-word-processors.xml +++ b/LDP/guide/docbook/LDP-Author-Guide/tools-word-processors.xml @@ -314,4 +314,21 @@ Office 2000)
+
+Conglomerate + conglomerate + Editorsconglomerate + + + + According to their web site, Conglomerate aims to be an XML editor that everyone can use. In particular, our primary goal is to create the ultimate editor for DocBook and similar formats. It aims to hide the jargon and complexity of XML and present the information in your documents in a way that makes sense. +
+ +
+Vex: a visual editor for XML + + +According to their web site, The visual part comes from the fact that Vex hides the raw XML tags from the user, providing instead a wordprocessor-like interface. Because of this, Vex is best suited for document-style XML documents such as XHTML and DocBook rather than data-style XML documents. +
+