This applies to projects and files used with Xilize 2.0.
defadddl signature is not yet implemented (pure oversight)The ErrorList plugin is required now. The Xilize parser generates errors and warning to the ErrorList window where you can click to jump to the relevant file and line. You may find it convenient to turn on all the options in The ErrorList plugin's options panel.
(I see handling errors and warnings this way as a great benefit. Feedback appreciated.)
Use Plugins > Xilize > options to install the mode file. You will then get propper syntax highlighting (to the extent possible with jEdit and Xilize markup) for the new signatures.
Previous projects where identified by the location of a *.xilize file (or the existence of a *.xilize file that contained information about the location of the project root directory.) That restriction has been removed.
At the beginning of translation, Xilize now looks up the directory tree for a root.xilconfig file. If found its directory is used as the project root directory. If not, it looks up the tree again, this time for a dir.xilconfig file — stopping as soon as one is located — and takes that as the project root. If neither of these files is found, the current directory is used as the root. See the section below. (From the command line this is achieved with the --find-root option.)
So if you Xilize a single file and the search for a root fails you get a near equivalent to the old "classic mode" translation. The benefit is you generally don't have to be concerned one way or the other.
Xilize2 introduced "natural" mode and used the term "classic" to distinguish it from the way the orginal Xilize worked. Both modes were supported. That distinction is no longer necessary and has been removed without loss of functionality.
To get Xilize 3.0 to simulate the "classic" mode of 2.0, use
define. _Natural_ false
The easiest way to do this depends on your use of Xilize, however, if you put this line in root.xilconfig at the top of a directory tree it will apply to the whole tree. It can also go in a dir.xilconfig to apply to a subtree.
A new per-directory configuration file has been introduced: dir.xilconfig and symbol definitions there (e.g. define, defadd, signature) apply to all files in that directory and its subdirectories and to only those files.
*.xilize, the old project configuration file is now root.xilconfig. Much of what is there might better go in a dir.xilconfig file. Rename *.xilize to root.xilconfig.
common.xilinc is honored, but there are advantages to using the new dir.xilconfig instead.
*.{xil*,css,js,bsh} is a handy filter in jEdit's File System Browser.
defaddPrevious versions gave special handling of style and script keys. When the define directive was used with either of these new values was appended to the existing one. That special handling has been removed and an additional directive — defadd — has generalized the behavior. If you have been using this feature replace define with defadd for style and script keys.
A paragraph beginning with a single word sentence may generate a warning looks like a signature. To turn the warning off use
define. NoWarnOnLooksLikeSig true
Put this in the *.xil or *.xilinc file that is generating the warning. It is very useful to leave it enabled.
Any occurance of &{ ... } will be interpreted as a macro. To avoid that interpretation use &{ ... }.
See command line use in Xilize by Example.
On startup Xilize loads the system properties — as returned by System.getProperties() — into its environment. (Thanks for the suggestion, Tiago.)
| ${java.version} | 1.6.0_01 |
| ${java.vendor} | Sun Microsystems Inc. |
| ${java.vendor.url} | http://java.sun.com/ |
| ${java.home} | /home/andy/wdev/bin/jdk1.6.0_01/jre |
| ${java.vm.specification.version} | 1.0 |
| ${java.vm.specification.vendor} | Sun Microsystems Inc. |
| ${java.vm.specification.name} | Java Virtual Machine Specification |
| ${java.vm.version} | 1.6.0_01-b06 |
| ${java.vm.vendor} | Sun Microsystems Inc. |
| ${java.vm.name} | Java HotSpot™ Client VM |
| ${java.specification.version} | 1.6 |
| ${java.specification.vendor} | Sun Microsystems Inc. |
| ${java.specification.name} | Java Platform API Specification |
| ${java.class.version} | 50.0 |
| ${java.class.path} | /home/andy/jedit/4.3pre9/jedit.jar |
| ${java.io.tmpdir} | /tmp |
| ${java.compiler} | ${java.compiler} |
| ${java.ext.dirs} | /home/andy/wdev/bin/jdk1.6.0_01/jre/lib/ext:/usr/java/packages/lib/ext |
| ${os.name} | Linux |
| ${os.arch} | i386 |
| ${os.version} | 2.6.8-2-386 |
| ${file.separator} | / |
| ${path.separator} | : |
| ${user.name} | andy |
| ${user.home} | /home/andy |
| ${user.dir} | /home/andy |
Tables with column specifiers, like this one:
table(cer). {{columns:
|{background:LemonChiffon;}. 70
|{background:LavenderBlush;}. 70
|=. 15
|{background:wheat;}=. 280
|{background:LemonChiffon}. *
}}
_| CER | NER | display | description | charsets
| & | & | & | ampersand | |
must be altered like this:
table(cer). &{columns:
|{background:LemonChiffon;}. 70
|{background:LavenderBlush;}. 70
|=. 15
|{background:wheat;}=. 280
|{background:LemonChiffon}. *
} >>> note single '}'
_| CER | NER | display | description | charsets
| & | & | & | ampersand | |
to conform to the new syntax for macros.
What was {{toc:xxx}} and {{tocEntry:xxx}} is now &{toc:xxx} and &{tocEntry:xxx} to match the macro syntax.
A group of consecutive footnotes fnN is no longer automatically placed in a <div>. Use the div signature to achieve the same effect.
