deplate 0.7.3 → 0.8

data/AUTHORS.TXT

@@ -13,6 +13,7 @@ Contributors:
       htmlslides-navbar-fh module
     Frederik Eaton :: Suggestions concering inline latex support
     Csaba Henk :: Nested elements in lists (patch)
+    Andrea Rota :: blosxom plugin, generic textpipe perl module
 
 Credits:
     - The manual-directory contains ASCIIMathML.js by Peter Jipsen 
@@ -21,6 +22,8 @@ Credits:
       (http://www.matterform.com/).
     - term.rb is written by Florian Frank 
       (http://raa.ruby-lang.org/project/ansicolor/)
+    - setup.rb is written by Minero Aoki
+      (http://raa.ruby-lang.org/project/setup/)
 
 
 % vim: ft=viki:tw=72

data/CHANGES.TXT

@@ -1,177 +1,250 @@
-2005-03-23  deplate 0.7.3
-	* elements.rb: Disabled #Html, #Latex shortcuts for #Native.
-	* templates.rb: Made the template formatter accessible (for use with the 
-	template input filter).
-	* plain.rb: Limited support for alphabethic lists.
-	* particle-math.rb: LaTeX-like $\math$ markup
-	* messages.rb: Reimplementation of localized messages
-	* configure: Added a pseudo configure script for support for: configure && 
-	make && make install
-	* common.rb: Variables can now be arrays and hashes
-	* html.rb: auxiliaryDirSuffix: images and other auxiliary files are stored 
-	in the "#{DESTINATION}#{SUFFIX}" subdir. Currently for HTML output only.
-	* formatter.rb: Slightly improved word-wrap.
-	* marshal.rb: Simply dump metadata using Marshal.dump
-	* messages.rb: deplate can now be fully localized, including the messages 
-	in the log.
-	* de.latin1: Complete German message catalog.
-	* structured.rb, html.rb, latex.rb: Prototype of format_label has changed: 
-	format_label(invoker, mode=nil, label=nil)
-	* html.rb, formatter.rb: Reference by ID (no additional label required).
-	* html.rb: Reference to objects (e.g. tables). The ref macro behaves like 
-	in LaTeX output.
-	* formatter.rb, elements.rb: Fixed problem with duplicate labels in lists.
-	* commands.rb: #LANG command to change the document's language (might be 
-	necessary when loading a language module from within the document)
-	* core.rb: If HOME isn't set, the configuration directory is 
-	ENV['USERPROFILE']/deplate.rc where ENV['USERPROFILE'] (on MS Win) is 
-	something like 'c:\Documents and Settings\USER\'.
-	* utf8.rb: New module that provides improved unicode awareness.
-	* recode.rb, iconv.rb: 2 new modules providing on-the-fly conversion 
-	between character sets (iconv is the preferred solution).
-	* formatter.rb: Adapted #plain_text for use with iconv.
-	* core.rb: --log FILE command line option ('-' send log to stdout)
-	* core.rb: don't include files twice
-	* imgurl.rb: A module that make deplate insert urls/links to images as 
-	images and not as references
-	* core.rb, deplate.ini: Read user settings from deplate.ini
-	* php.rb: A simple variant of html.rb that can be used for php output
-	* inlatex-compound.rb: __New module:__ Collect LaTeX fragments in one 
-	file, compile them as one, separate the output afterwards. The advantage: 
-	you can define LaTeX commands in #Inlatex regions and they integrate well 
-	with the rest of the document.
-	* regions.rb: #Inlatex: @deplate.formatter.inlatex(self) is already called 
-	by #setup for 2 reasons: (1) cooperate with inlatex-compound.rb; (2) make 
-	it possible to change inlatex related variables
-	* particles.rb: In extended wiki links, the destination part gets fully 
-	parsed too
-	* particles.rb, macro.rb, input.rb: Fixed the handling of single escaped 
-	curly braces in macro arguments.
-	* core.rb, regions.rb: Changed the way how inline ruby code is evaluated; 
-	added a sandbox by Florian Gross, flgr AT ccan.de, so that you can set 
-	--allow-ruby to 5 without compromising deplate's functionality
-	* html-deplate-button.rb: New module
-	* rdoc.rb: Fixed problem with description lists.
-	* wiki-markup.rb: Fixed rdoc incompatibility (_word_ etc.)
-	* core.rb: deplate.ini may contain multi-line variable definitions (saved 
-	as array)
-	* html.rb: A list items leading character is reflected in the items class.  
-	This may change in the future as the current handling of changing leading 
-	characters isn't correct. Basically a different leading character (e.g.  
-	"+" instead of "-") should create a new list environment, which currently 
-	isn't the case. So if you alternately use "+" and "-" to mark list items, 
-	this will some day in the future create many lists instead of just one 
-	list environment at it is currently the case.
-	* define.rb: #DefElement
-	* particles.rb: Fixed minor problem with \''verbatim\'' text
-	* html.rb: Fixed problem with empty or duplicate IDs in headings
-	* input.rb: embeddedTextRx (deplate text can be hidden in comments, and 
-	normal text can be converted into, e.g., verbatim or code regions)
-	* html-obfuscate-email.rb: new module
-	* define.rb: #DefElement now uses the standard template formatter
-	* define.rb: #DefParticle
-	* html.rb: Fixed problem with duplicate labels
-	* xmlrpc.rb: Options weren't propagated
-	* html.rb: Solved once and for all the problem with duplicate labels in 
-	html output
-	* core.rb: Don't generate file labels when running in included mode
-	* dbk-snippet.rb, html-snippet.rb, latex-snippet.rb, formatter-snippet.rb: 
-	Minor variants of the corresponding formatters that are meant to be used 
-	to format single phrases, single words etc. (the main difference is that 
-	paragraphs simply return their content)
-	* xmlrpc.rb: The xmlrpc server now always creates a new converter for each 
-	request unless the ''xmlrpcReuseInterpreter'' variable ist defined, which 
-	will make it reuse the previous converter (which was the default behaviour 
-	in earlier versions)
-	* regions.rb: Footnotes IDs can be defined in the ''id'' argument __or__ 
-	the "region note" (how it was done before).
-	* html.rb: Footnotes are wrapped in a div (class=footnotes) tag.
-	* particles.rb: Wiki names must begin with A-Z even then wiki chars were 
-	redefined
-	* formatter.rb: If the bib file wasn't found, use kpsewhich to locate it.  
-	Fixed some problems with bibliographies.
-	* commands.rb: Reenabled #INC's inputFormat argument.
-	* particles.rb, several other files: Dynamically created particles are no 
-	longer registered in @@particles but are added to @deplate.input's 
-	particles list. This should prevent problems when using several output 
-	format via the converter or xmlrpc modules. This possibly breaks modules 
-	like anyword, zh-cn, ru ...
-	* makefile.rb: A module to create a standard makefile for the given input 
-	files
-	* commands.rb: #CAPTION: Don't assign a caption to an element that already 
-	has one
-	* regions.rb: If the rScanTable variable is set, guess column breaks in R 
-	generated tables (doesn't work yet properly)
-	* formatter.rb: (inadvertent) wiki names in bibliographic entries don't 
-	get translated as hyperlinks; in citations, insert a space between the 
-	note and the author's name; other minor citation related tweaks
-	* particles.rb, html.rb: URLs/wiki names may have a target attribute. If 
-	an extended wiki name has the form [[url]*] (see the '*'), the destination 
-	will be opened in a new window (target=_blank).
-	* regions.rb: #Quote and #Abstract regions can now take (block-level) 
-	elements (e.g., lists, tables) as body.
-	* koma.rb: Fixed missing argument in format_pagenumber
-	* core.rb: Options can be set in the ini file by prepending the name with 
-	':', i.e. 'option foo=bar' is equivalent to ':foo=bar'
-	* core.rb: There is a new "--allow" command line option. The argument is a 
-	comma separated list of flags: x, X, :
-	* elements.rb: If ":" is allowed, you can access options in some 
-	situations by prepending a name with ":" (e.g. #IF tests).
-	* etc.rb: New file.
-	* common.rb, elements.rb, particles.rb, macros.rb: Slightly refactored 
-	base classes & modules hierarchy.
-	* define.rb: Fixed DefMacro (as a side effect, macro definitions may now 
-	contain #IF statements).
-	* formatter.rb etc.: NAME, RX etc. are now class properties/attributes.  
-	''declare_formatter'' is called automatically when setting the formatter's 
-	name.
-	* html.rb: Slightly improved parsing of dates.
-	* html.rb: The LIST command has some new options: min, max, top, sub, 
-	levels (HTML only; this provides for partial listings)
-	* elements.rb, html.rb: subToC parameter (currently only useful for HTML 
-	output)
-	* plain.rb: Arity of format_figure.
-	* commands.rb: If the #INCLUDE command has an explicit file argument and 
-	an anonymous argument, the explicit one overrides the anonymous one; a 
-	message is displayed (fixes BUG 1325550).
-	* input.rb: Minor changes. Successfully mix input formats by including a 
-	rdoc document into a deplate/viki document.
-	* makefile.rb: The makefile module propagates command line arguments.
-	* common.rb, elements.rb: Fixed handling of styles.
-	* core.rb: Fixed interaction between -d & -o command line options.
-	* particles.rb: Markup of camel case names (back to 0.7.2) again.
-	* core.rb: Fixed #pop_input_format. tc-mixed-input.rb succeeds.
-	* html-obfuscate-email.rb: Minor change.
-	* core.rb: Fixed file not found handling.
-	* regions.rb: Fixed #do_xtable.
-	* html.rb: Handle special characters in the img.alt argument. The alt text 
-	of an image created by the ltx macro is the latex source.
-	* input.rb: Fixed interaction of line continuation & comments
-	* makefile.rb: Split makefile: Makefile & Makefile.config (which won't be 
-	overwritten).
-	* koma.rb: Fixed use of tables in header & footer.
-	* makefile.rb: make view: (uses a generic viewer to display the latest 
-	output)
-	* koma.rb: Fixed slot warning.
-	* docbook.rb: Fix problem arising from allowing block elements in 
-	abstracts and quotes.
-	* xml.rb: Don't require symbol modules twice.
-	* particles.rb: Fixed bug introduced when caching autoindex particles.
-	* input.rb: (parse_args) Bool vars can be defined as var=true and 
-	var=false.
-	* macros.rb: Fixed problem with false boolean values.
-	* elements.rb: If the an ordered list is explicitly numbered, this 
-	numbering is maintained (not supported by all formatters).
-	* formatter.rb: Fixed incorrect formatting of lists.
-	* core.rb, html.rb etc.: Fix: absolute vs. relative path name.
-	* core.rb: Also check the data dir (/usr/share) for compatibility with 
-	setup.rb.
-	* commands.rb: Use Deplate::Core.library_directories() for #INC.
-	* core.rb: Fix: file names of autogenerates breaks (eg MAKEBIB & 
-	htmlsite).
-	* latex.rb: texLists option
-	* latex.rb, html.rb, formatter.rb: Improved support for explicitly 
-	numbered lists (not for docbook yet).
-
+deplate 0.8
+	* external.rb: With ruby-mswin, add .exe to the name of an external 
+	application (if not specified).
+	* common.rb: moved @accum from \CommonElement to Element.
+	* elements.rb: @accum defaults to [].
+	* commands.rb: PAGE command (same as ''---8<---'').
+	* elements.rb (do_accumulate): set indentation.
+	* common.rb: class attributes.
+	* elements.rb, html.rb, latex.rb, structures.rb: Embedded elements in 
+	lists.
+	* input.rb: FIX: boolean variables.
+	* plain.rb: If ansiColor is defined, some text styles are used.
+	* docbook.rb, structured.rb: Fix: indentation of verbatim region, headings 
+	etc.
+	* setup.rb: Updated to 3.4.1
+	* html.rb: In a mailto url, the protocol is removed from the name.
+	* html.rb: Support for task lists (html, plain text, latex).
+	* input.rb: If embeddedVerbatim is empty, the text will be swallowed.
+	* core.rb, commands.rb: The handling of the search path has changed; css & 
+	templates are searched in $PWD/deplate.rc too.
+	* core.rb: If an unknown language is set (using #LANG), try to load a 
+	module of the same name (if the allow flags contain 'l').
+	* htmlsite.rb: The page body is wrapped in a div.
+	* html.rb, latex.rb, structured.rb: include_image and macros/commands 
+	depending on it, accept a file argument.
+	* elements.rb: FIX: numbering of tables/figures (created by #Table).
+	* html.rb: FIX: nextKey (jump between pages of multi html output by single 
+	key press) didn't work.
+	* html.rb: html_navigation_buttons service.
+	* html.rb: FIX: inconsistent handling of html classes.
+	* particles.rb: Allow interwiki names for extended wiki names, e.g 
+	''[[WIKI::FooBar#a][Foo and Bar]]''. \(experimental)
+	* region.rb: #Ins alias for #Native.
+	* macros.rb: Output of the ruby macro gets formatted by default.
+	* input.rb: FIX: comments in regions were removed by the input handler.
+	* elements.rb, ...: Renamed list: Numbered -> Ordered
+	* formatter.rb, html.rb, latex.rb: Generalized handling of the style 
+	attribute/option.
+	* elements.rb, particles.rb, formatter.rb ...: Refactoring: more use of 
+	home-grown class attributes.
+	* formatter.rb, html.rb, plain.rb: Generalized listings, counters (html, 
+	plain text, latex).
+	* commands.rb: New: #DEFLIST, #REGISTER commands.
+	* elements.rb: Chaining formatters for elements: set_formatter accepts 
+	arrays. \(experimental)
+	* commands.rb: #ARG: accept default argument
+	* html.rb: FIX: The value argument in explicitly numbered lists was 
+	invalid.
+	* code-gvim.rb: Replace <font> tags with <span> so that the output is 
+	valid 4.1t html.
+	* regions.rb: FIX: Labelling of #Foreach generated output was wrong.
+	* latex.rb: elementStyle and particleStyle options (for different markup 
+	of styles). (obsolete)
+	* macros.rb: The text macro can be used to attach a style to some inline 
+	text.
+	* elements.rb, common.rb: Generate most get_* methods by way of def_get.
+	* macro.rb: New counter macro.
+	* core.rb: Some adjustments for use of counters.
+	* core.rb: Use counters for toc.
+	* core.rb: FIX: bug #1363959.
+	* elements.rb: FIX: Exception when a clip was empty.
+	* input.rb, elements.rb: Improved handling of ''if'' arguments.
+	* define.rb: Consistent use of Deplate::Cache.
+	* symbols-*.rb, xml.rb ...: Revamped symbols code.
+	* htmlsite.rb, output.rb: Got rid of the @idx counter.
+	* core.rb, output.rb: Removed Deplate::Core#current_top (this was a 
+	leftover from experiments with setting the output already during the first 
+	pass).
+	* core.rb, html.rb, htmlsite.rb: Use def_service to define & register 
+	services.
+	* core.rb, etc.rb, elements.rb: Counters are now transparently 
+	hierarchical. The use of the variable ''#{entity}Numbering'' has changed.  
+	If it is set to 0, the numbering is flat. If it is 1, the chapter number 
+	is prepended to the element's number. Sooner or later, higher values will 
+	yield useful results too.
+	* core.rb: @counters and @listings moved to @options.
+	* latex.rb: FIX: Can't include remote images (use the basename instead)
+	* docbook.rb: FIX: Close headings when in "included" mode (put closing 
+	tags in the main body).
+	* docbook.rb: FIX: Inadvertent hyperlinks in bib entries; other problem 
+	with MAKEBIB.
+	* macros.rb, commands.rb: The (x)val macros and (X)VAL commands know some 
+	new options: sub, tr, upcase, downcase, capitalize.
+	* particles.rb: Try to be a little bit smarter when selecting opening or 
+	closing quotes.
+	* regions.rb: #Write region: Write an expanded template to a file 
+	\(requires the w or W allow flags to be set).
+	* etc.rb, elements.rb, core.rb: Counters can depend on other (parent) 
+	counters.
+	* core.rb: FIX: Make the object() service work.
+	* macros.rb, etc.rb, core.rb: ''.'' allow flag; make something like 
+	''{arg: obj[method]}'' work.
+	* elements.rb: The default value for date related commands/macros is 
+	"today".
+	* elements.rb: FIX: In some cases a label pointed to an obsolete objects, 
+	which were unified with another object
+	* core.rb: FIX: allow=x,X was ignored
+	* elements.rb: Table rows are accumulated right away.
+	* deplate-string.rb: NEW: ''DeplateString'' convenience class.
+	* variables.rb, counters.rb: Extract from etc.rb.
+	* core.rb, converter.rb: FIX: to_xhtml10t didn't work.
+	* commmands.rb: Allow ''#VAR id=var: value''.
+	* converter.rb: Missing methods are forwarded to the instance of 
+	Deplate::Core.
+	* nukumi2.rb: NEW: Experimental hack for using deplate with nukumi2 
+	(v0.5).
+	* core.rb: NEW: ''auxiliaryDir'' and ''mandatoryID'' variables.
+	* commands.rb: NEW: KEYWORDS command (a simple wrapper for ''#VAR 
+	id=keywords'').
+	* wiki-markup.rb: FIX: to_be_continued? in 
+	Deplate::Input::Wiki::ParagraphIndentedVerbatim
+	* macro.rb: FIX: ''var'' macro.
+	* core.rb: prefixID variable; if not defined, prefix autogenerated 
+	auxiliary files with the current document's base name.
+	* core.rb, particles.rb: autoindexed elements are now registered in 
+	@deplate.options.
+	* elements.rb: The ''#REGISTER'' command is volatile, which could result 
+	in a different result from ''{counter}'' when used in the registered 
+	element.
+	* macros.rb: Disabled the byId argument for the ''ref'' macro.
+	* common.rb, elements.rb: Elements have a ''volatile'' class attribute.
+	* input.rb, particles.rb: Simple Wiki names now check for the surrounding 
+	text, which should avoid some problem with international characters.
+	* html.rb, latex.rb, plain.rb, structured.rb: The ref macro can take a 
+	''prefix'' argument (default: nonbreaking space).
+	* formatter.rb, latex.rb: New ''bibStyle'' variable (can be set instead of 
+	passing an argument to #MAKEBIB)
+	* macros.rb: The ''cite'' macro allows names to be separated by [ ,;].
+	* formatter.rb: Improved formatting & bibtex-compatibility of the 
+	bibliography. Handle @string entries.
+	* core.rb, input.rb: Boolean variables where not properly set when defined 
+	on the command line (-D).
+	* core.rb: --list-modules, --list-css command line options.
+	* core.rb: Create the directory given in the -d command line option if 
+	necessary.
+	* commands.rb: #MAKEBIB sets the ''bibStyle'' variable if not already set
+	* core.rb: allow 'r' flag to enable the deplate.rc hierarchy (only 
+	partially supported yet); if set, config.rb is loaded from deplate.rc too.
+	* core.rb: Allow command line options in deplate.ini; add ''allow'' 
+	directive for deplate.ini.
+	* latex.rb: Set DIV in class document options, not as argument to the 
+	typearea package.
+	* plain.rb: FIX: #Abstract and #Quote regions were word wrapped twice 
+	which resulted in malformed output.
+	* elements.rb: Avoid multiple whitespace.
+	* plain.rb, external.rb: Use jave to convert images to ascii 
+	representations (requires the ''asciiArt'' variable to be set).
+	* core.rb: Variables in deplate.ini weren't set according to the canonic 
+	rules.
+	* plain.rb: Changed the suffix to ".text"
+	* smiley.rb: Ignore imgSfx, smileySfx; use the formatter's default suffix 
+	rules.
+	* makefile.rb: The module now searches the library for a Makefile.config 
+	template.
+	* elements.rb: If a heading has an url option attached, it is turned into 
+	a hyperlink (experimental; inspired by a hack by Chen Shou: 
+	http://blog.csdn.net/Solstice/archive/2006/02/22/606266.aspx)
+	* html.rb: CSS files defined via the css variable are copied to the 
+	destination too.
+	* core.rb, html.rb, htmlsite.rb: ''--split-level'' command line option; 
+	split files at any level (experimental; based on a hack by Chen Shou)
+	* core.rb: The numbering of auto-numbered file names has slightly changed; 
+	the first file is named 'basename.suffix', the next one 
+	'basename00001.suffix' and so on (before, all files were numbered).
+	* core.rb: A ''homeIndex'' variable was introduced to help ''deplate'' 
+	determine the heading level of the first page in multi-file output (which 
+	is otherwise assumed to be 0 but this is wrong in some situations).
+	* core.rb: A ''autoBaseName'' variable was introduced to deduce the output 
+	file name from the current input file. (based on a hack by Chen Shou)
+	* particles.rb: Defined how to disable certain particles or symbols.
+	* formatter.rb: Restricted LaTeX: Remove blacklisted commands from LaTeX 
+	code (based on class.latexrender.php by Benjamin Zeiss & Steve Mayer: 
+	http://www.mayer.dial.pipex.com/tex.htm#latexrender) unless the allow 
+	flags contain ''t''.
+	* external.rb: Default value for ps2imgRes was changed to 120.
+	* formatter.rb: Default value for ltxPointsize was changed to 10.
+	* commands.rb: The handling of backslashes in the #ABBREV command has
+	slightly changed. (experimental)
+	* html.rb: New htmlCssUrl and htmlImgUrl variables (the value should be a 
+	format string); these are used for formatting image and css paths.
+	* deplate-restricted.rb, input.rb: In restricted mode #VAR may only set 
+	variables beginning with an underscore (_).
+	* htmlsite.rb: Changed css class for tabBar*Active/Inactive.
+	* html-jsmath.rb: Support for jsMath for setting mathematical stuff in 
+	html output (similar to asciimath).
+	* deplate-restricted.rb: Disabled macros were still accessible.
+	* html.rb: More general solution for handling key presses via javascript.
+	* html.rb: Added some javascript magic to display page contents step by 
+	step (this should be sufficient for doing presentations for Powerpoint 
+	conditioned people). This can be enabled by putting something like ''#ARG: 
+	stepwiseDisplay()'' into the template.
+	* core.rb, html.rb, htmlsite.rb: "Services" are now formatter specific.
+	* smart-dash.rb: New module.
+	* variables.rb: Make this :option notation generally known.
+	* core.rb: Allow flags can be set (''+x,x'') and removed (''-x'').
+	* regions.rb, html.rb, latex.rb, plain.rb, structured.rb: Footnotes now
+	contain block elements (eg lists etc.).
+	* html.rb: The image tag's classes were joined with commas.
+	* core.rb: Work-around for some original idiocy in the handling of 
+	multi-file output.
+	* formatter.rb: Lists containing elements weren't properly closed in some 
+	situations.
+	* html.rb: Any image can have a ''hi'' attribute for roll-over effect.
+	* formatter.rb: outputFilename() and outputBasename() services.
+	* macros.rb: New msg macro (insert localized messages).
+	* template.rb: Enable msg macro for templates.
+	* php-extra.rb, page-comment.inc.php: Poor people's page comments (file 
+	based, requires a writeable directory).
+	* html.rb: Quotations may have a source argument (at the moment HTML 
+	only).
+	* core.rb: Set homeIndex to the first non-empty output.
+	* html.rb, htmlsite.rb: Escape references in automatically generated 
+	hyperlinks.
+	* particles.rb: Deplate::Particle.build_rx() has changed and moved to 
+	Deplate::Rx.
+	* skeletons.rb: Pre-processing, string-based micro-template/skeleton 
+	expansion: skeleton (foo: ''Foo is {arg: @body}'') + input (''{{foo: 
+	bar}}'') = new input (''Foo is bar'').
+	* elements.rb: Elements have an embedable attribute.
+	* commands.rb: #NOP command -- can be used to split lists.
+	* macros.rb: ''{unknown}'' will be to a clip or variable's value if such a 
+	clip or variable is defined (older yet undocumented change).
+	* variables.rb: ''arg'' & ''var'' type of macros can have ''join'', 
+	''values'', ''keys'' arguments to deal with hashes and array.
+	* elements.rb: Problem with task lists containing percents as completion 
+	index.
+	* deplate.sty: This is now handled as a template. On the long run, all 
+	files in the lib subdirectory should be templates and/or valid deplate 
+	input files.
+	* particles.rb: Pass ''{}'' through.
+	* html.rb, elements.rb: The #DATE command accepts a ''none'' argument, 
+	that prevents deplate from including a timestamp in the document's meta 
+	data (HTML output).
+	* skeletons.rb: The use of a dedicated skeletons directory was removed; 
+	skeletons are now looked for in the lib subdirectory (as does the ''#INC'' 
+	command). The difference is that skeletons are expanded at load-time but 
+	the #INC command at run-time, so to say.
+	* skeletons.rb: Skeletons are properly indented.
+	* html.rb, structured.rb, latex.rb, plain.rb ...: Image related commands 
+	now take a noGuess argument that makes deplate use the filename as given.
+	* common.rb: ''@args[:id]'' doesn't get accidentally overridden -> solves 
+	some problems with docbook output.
+	* common.rb: output_file_name() returns '' if the output file is the 
+	current (element's) one.
+	* docbook.rb, structured.rb: Fixed wiki & ref formatting.
+	* docbook.rb: Fixed formatting of footnotes & custom lists.
+	* input.rb: Macros also take an ''else'' argument in addition to the 
+	''if'' argument, e.g. ''{text if=cat else=Chirp: Meow}''.
 
 vim: ft=changelog

data/NEWS.TXT

@@ -1,29 +1,33 @@
-* deplate 0.7.3
+* deplate 0.8
 
-This release contains many small changes, fixes, and improvements.
+This release contains many small changes and fixes. The main user-visible improvements are: better support for bibliographies, embedded elements in lists, task lists, a general style attribute, custom listings, hierarchical counters, load-time-expanded skeletons etc.
 
-Easier configuration; can be fully localized; define elements and particles right in the document; some new modules & formatters; improved support for rdoc input.
+    - Custom listings and hierarchical counters (toc, lof & lot are now implemented this way)
+    - Skeletons were introduced; skeletons are expanded at load-time before the document is parsed
+    - Improved support for bibliographies
+    - Improved lists:
+        - Enable nested/embedded elements in lists
+        - Some support for task lists
+    - Remove blacklisted LaTeX commands from input (unless allow=t is set)
+    - Support for a general style attribute (support for styled LaTeX and HTML output; not supported for DocBook output)
+    - Extended wiki names my include interwikis (e.g. [[WIKI::FooBar#a][Foo and Bar]])
+    - Slightly improved support for international characters in camel-case type wiki names
+    - More commands were made volatile (i.e. they don't close elements)
+    - Experimental hack for nukumi2 (v0.5)
+    - Support for jsMath
+    - A php hack was included to provide cheap/unsafe per-page user comments
+    - A javascript hack was included to provided step-by-step display of HTML pages
+    - Footnotes now contain block elements
+    - New commands: #PAGE, #DEFLIST, #REGISTER, #KEYWORDS, #NOP
+    - New regions: #Write
+    - New macros: counter, msg
+    - New variables: auxiliaryDir, mandatoryID, prefixID, bibStyle
+    - New services: outputFilename(), outputBasename()
+    - New classes: DeplateString convenience class
+    - New command line options: --list-modules, --list-css command
 
-Changes:
-    - The #Html, #Latex shortcuts for #Native were disabled.
-    - Template formatter can be used from the command line.
-    - Module for LaTeX like ($\math$) math markup.
-    - deplate can be fully localized.
-    - Variables can be hashes & array; improved support for boolean variables.
-    - Auxiliary files can be putted in a subdirectory (e.g., FILENAME_files).
-    - Improved utf8 support. On-the-fly transcoding via iconv (if available).
-    - Read user setting from ~/deplate/deplate.ini (which should make ruby hacking obsolete for most users).
-    - Php output (basically the same as HTML).
-    - In extended wiki links, both arguments get fully parsed (i.e., they may contain macros).
-    - Improved support for rdoc
-    - New elements, particles can be defined in the source document, no ruby hacking requires (experimental).
-    - Text can be embedded in comments.
-    - Can mix input formats (currently, only the inclusion of rdoc documents in deplate documents is supported).
-    - Improved xmlrpc server.
-    - Formatters for small text snippets.
-    - Improved support for bibtex files.
-    - Run "deplate -m makefile INPUT FILES" to create a standard Makefile.
+NOTE: The way files are automatically numbered with multi-file output (e.g. when using the htmlsite formatter) has changed which may result in a different numbering under certain conditions.
 
-For other changes please see the log.
+For other changes please see the CHANGES.TXT.
 
-% vi: ft=viki:tw=0:ts=4
+% vi: ft=text:tw=0:ts=4