webgen 0.4.7 → 0.5.0

data/doc/src/index.page

@@ -1,32 +0,0 @@
----
-title: HomePage
-inMenu: true
-directoryName: webgen
----
-h2. About _webgen_
-
-webgen is used to generate web pages from page and template files. You create one or more template
-files in which you define the layout of your page and where the content should go. After that you
-create page files in which you only define the content.
-
-When webgen is run it combines the template with each of the page files and generates the HTML
-output files. During this process special tags are substituted so that, for example, a menu is
-generated. Actually, this website was generated with webgen and, for example, the menu that you can
-see was created dynamically. For more information look at the documentation!
-
-This whole site was generated with webgen and provides an online demonstration of its features.
-Choose from the menu what you want to see from or know about webgen!
-
-If you have an idea for a new feature, "request
-it!":http://rubyforge.org/tracker/?atid=1210&group_id=296&func=browse. If you have found a bug, you
-can "report it here!":http://rubyforge.org/tracker/?atid=1207&group_id=296&func=browse Also, there
-are "forums":http://rubyforge.org/forum/?group_id=296 and a "mailing
-list":http://rubyforge.org/mail/?group_id=296 available if you have any questions!
-
-
-h2. Author
-
-* *Thomas Leitner*
-* Web: "http://webgen.rubyforge.org":http://webgen.rubyforge.org
-* e-Mail: "t_leitner@gmx.at":mailto:t_leitner@gmx.at
-* GPG Key-Id: 0xD942E7F6

data/doc/src/js/sipttra.js

@@ -1,7 +0,0 @@
-function toogle( element ) {
-  if (document.getElementById(element).style.display == "block") {
-    document.getElementById(element).style.display = "none";
-  } else {
-    document.getElementById(element).style.display = "block";
-  }
-}

data/doc/src/news.page

@@ -1,256 +0,0 @@
----
-title: News
-inMenu: true
----
-h2. News
-
-
-h3(#news-2007-12-31). 31.12.2007 - webgen 0.4.7
-
-Minor release with feature enhancements:
-
-* added support for Haml markup {plugin: ContentConverter/Haml}
-* added support for Sass markup {plugin: ContentConverter/Sass}
-* gallery file handler is now multilingual aware
-* hidden files can now be used by the file handler plugins if the parameter {param:
-  Core/FileHandler:useHiddenFiles} is set to true
-
-
-h3(#news-2007-09-08). 08.09.2007 - webgen 0.4.6
-
-This is a bug fix release:
-
-* fixed bug in handling of meta information in File/Pagehandler (thanks to Andrea Ferro)
-* fixed bug in handling of directory and file names with special characters (see Bug #13757)
-
-
-h3(#news-2007-06-29). 29.06.2007 - webgen 0.4.5
-
-This release contains some bug fixes:
-
-* a small bug fix for Tag/News - there have been some cases where loading the
-  plugin lead to an error. This has been fixed now!
-* fixed a bug with file name resolution: filenames are now searched using a case insensitive
-  search sothat, for example, images with an uppercase extension are processed correctly
-* fixed bug in File/ThumbnailWriter: no check was performed if a thumbnail for a given
-  image already existed
-
-One new feature: links can now be customized by providing a custom link renderer via the meta
-information @link_callback@ - more information on the
-<a href="{relocatable: documentation/references/meta_info_reference.page}">Meta Information Reference</a>
-
-
-h3(#news-2007-05-20). 20.05.2007 - webgen 0.4.4
-
-Only a (very) small bug fix version due to Rubygems being case sensitive when it comes to gem names.
-This version fixes the installation problem with Rubygems! Everything else is identical to the
-0.4.3 version!
-
-
-h3(#news-2007-05-19). 19.05.2007 - webgen 0.4.3
-
-I got mails about webgen not working with Ruby 1.8.6 on Windows anymore. It seems that a bug in the
-1.8.6 release prevents webgen from correctly finding directories. However, this bug has already been
-fixed which means that webgen should work again with the next One-Click-Installer for Windows. Until
-then I recommend using webgen with the latest 1.8.5 version on Windows (I found that it is no
-problem to have two versions of Ruby installed on Windows using the One-Click-Installer).
-
-And now on to the new features and other changes:
-
-* Updated exifr support to version 0.10 - versions lower than 0.10 are not supported anymore!
-* redcloth is now a dependency sothat all the examples and website templates really work out-of-the-box!
-* Removed website style @plain@ due to incompatible license.
-* Added submitted plugin {plugin: Tag/HtmlMetaInfo} from Andrea Censi - thanks!
-* Added submitted plugin {plugin: Tag/News} from Jeremy Hinegardner - thanks!
-* Added submitted plugin {plugin: ContentConverter/Maruku} from Andrea Censi - thanks!
-
-Closed bugs:
-
-* Page and template files can now be written using either Windows, Mac or Unix EOL encodings!
-* Fixed order of webgen data directory discovery - local data directories are preferred now!
-* File/TemplateHandler will not use the default metainfo from File/PageHandler anymore!
-
-
-h3(#news-2007-02-28). 28.02.2007 - webgen 0.4.2
-
-
-Another minor release which concentrates on fixing some bugs and adding some new features:
-
-New features:
-
-* Implemented support for <a href="{relocatable:/documentation/references/sipttra_format.page}">sipttra</a> (Simple Plain Text Tracker) files and using it for the <a href="{relocatable: project.page}">project status page</a>
-* HTML is now the default content format for template files (also see "FR#7893":http://rubyforge.org/tracker/?func=detail&atid=1210&aid=7893&group_id=296)
-* New parameters for {plugin: Tag/BreadcrumbTrail}: {param: Tag/BreadcrumbTrail:omitLast} and {param: Tag/BreadcrumbTrail:omitIndexFile} (also see "Patch#7942":http://rubyforge.org/tracker/?func=detail&atid=1209&aid=7942&group_id=296)
-* New parameter {param: Core/Configuration:customVars} for storing custom global variables and a new plugin {plugin: Tag/CustomVar} for accessing them
-* Added an example websites section to the examples section (also see "FR#7827":http://rubyforge.org/tracker/?func=detail&atid=1210&aid=7827&group_id=296)!
-* Added a <a href="{relocatable: documentation/howto.page}">HowTo page</a> which answer some often asked questions!
-* Added a man page contributed by the Debian project
-
-Closed bugs:
-
-* Specifying arguments to the @run@ command to render only certain files now actually works! ;-)
-* Fixed bug when loading site specific plugins: the use of @load_plugin@ should now work correctly!
-* All website styles updated to behave correctly when {param: File/DefaultHandler:linkToCurrentPage} is false
-
-Thanks for the many comments and suggestions since the last release, especially to Bill Paxton,
-Massimiliano Filacchioni, Erhard Karger, Alejandro Sierra, Fritz Heinrichmeyer and Vincent Fourmond!
-
-
-h3(#news-2007-01-12). 12.01.2007 - webgen 0.4.1
-
-
-A minor release with bug fixes and some small enhancements:
-
-* webgen Windows bug resolved: webgen now really runs on Windows - thanks for the fast feedback!
-* Rake task for running webgen - thanks to Jeremy Hinegardner for providing it!
-* Meta information @template@ can now be set to @nil@ to specify that no template should be used!
-* Small documentation updates - thanks to John Gabriel for pointing out some flaws!
-
-
-h3(#news-2007-01-05). 05.01.2007 - webgen 0.4.0
-
-
-This is a major release with many updates to the webgen core, the plugins and the documentation.
-Plugins written for prior version won't work with this one anymore. However, changing them to work
-again is easy. As an upgrade guide is currently not available have a look at webgen plugins and the
-API documentation to see how to do upgrade plugins.
-
-Major changes:
-
-* New website layout :-)
-* webgen now includes many <a href="{relocatable: examples/website_styles}">website styles</a> which can be used out of the box!
-* Template files have the same format as page files now and can be nested!
-* Speed-up through caching of node information
-* New and cool gallery style
-* New content converter plugin ({plugin: ContentConverter/XmlBuilder})
-* New plugin for syntax highlighting ({plugin: Misc/SyntaxHighlighter})
-* Many changes to the core (plugin system revised, webgen can now be used from other Ruby applications directly, faster node resolution, hooks are now spelled with only lowercase letters, ...)
-* Structure of meta information @blocks@ changed
-* New meta information @linkAttrs@ for setting additional attributes on links
-* Handling and structure of meta information backing file changed
-* Evaluation of page files changed (first converted to HTML, then ERB, then webgen tags)
-* "Static" menus now available
-* New sub-commands for the webgen command
-* Gallery editor application deprecated.
-* Many tests have been added.
-* Documentation on the homepage as well as the API documentation is now more complete
-* Fixed many bugs
-* *Many other changes*
-
-For detailed information have a look at the ChangeLog file included in the webgen distribution!
-
-*Upcoming features:*
-
-* More documentation
-* Blogging plugins
-* RSS generation plugins
-
-
-h3(#news-2005-12-29). 29.12.2005 - webgen 0.3.8
-
-
-Bug fix release
-
-
-h3(#news-2005-11-27). 27.11.2005 - webgen 0.3.7
-
-
-Major changes:
-
-* Now using cmdparse version 2.0.0!
-* %{color:red}Attention%: For unified naming in reference to image galleries, I have removed all occurences of the word "picture" from the code and documentation and replaced it with "image". Therefore you may need to adapt your code, especially custom gallery layouters!
-* %{color:red}Attention%: Many documentation and library files have been renamed for better consistency! Custom plugins may have to be adapted!
-* New application for managing image galleries (only alpha quality currently!)
-* Smileys are now optionally replaced with emoticons (<notextile>:-) ;-) :'-( 8-)</notextile>, several different emoticon packs available) -> see {plugin: Misc/SmileyReplacer}
-* <a href="{relocatable: documentation/extending_webgen.page}">Site specific commands</a> (used in command line processing) can now be used
-* New plugin {plugin: Tag/Download} for nice download links
-* New parameters: PageFileHandler:defaultPageMetaData, SitemapTag:honorInMenu
-* Removed parameters: PageFileHandler:useERB, PageFileHandler:defaultContentFormat
-* Renamed tag <b>navbar</b> to <b>breadcrumbTrail</b>
-* Images in image galleries can now be ordered by specifying the @orderInfo@ meta information
-* The use of directory index files is now optional: by setting the parameter File/DirectoryHandler:indexFile to nil directory index files are not used
-* Languages can now be specified using 2-char ISO-639-1 codes or 3-char ISO-639-2 codes
-* Now there is a link (next to the wiki link) to the source of each page unless the page was programmatically generated.
-
-
-h3(#news-2005-06-24). 24.06.2005 - webgen 0.3.5
-
-
-Major changes:
-
-* Now using cmdparse version 1.0.3!
-* New CLI command "clean" for deleting the generated or all files from the output directory
-* Restructured menu tag -> five different menu styles now available (see {plugin: MenuStyle})
-* New plugin {plugin: Core/ResourceManager} for defining resources
-* New plugin {plugin: Tag/Resource} for accessing resources
-* Pages files can now be referenced in @relocatable@ tag and backing files with a standardified name, despite an eventually self defined naming scheme
-* New parameters: LangbarTag:showOwnLang
-* Changed paramters: PageFileHandler:validator (now deactivated by default)
-* Fixed bugs
-
-
-h3(#news-2005-05-12). 12.05.2005 - webgen 0.3.4
-
-
-Major changes:
-
-* FileHandler now uses path patterns and/or extensions for determining which files to process !
-* ERB (embedded ruby) can now be used in templates and page files !
-* Relocatable tag now accepts complex URIs (URIs with query and fragment part, absolute URIs)
-* Changed meta info name *menuOrder* to *orderInfo* (e.g. used for specifying order information for menus) -- you have to adapt your page and backing files!!!
-* New parameters: PageFileHandler:useERB
-* Changed parameters: FileHandler:ignorePaths, CopyFileHandler:paths
-* New page describing meta information items used by plugins
-* Fixed bugs
-
-
-h3(#news-2005-04-21). 21.04.2005 - webgen 0.3.3
-
-
-Major changes:
-
-* New command line interface based on "CommandParser":http://cmdparse.rubyforge.org
-* Now you can let webgen create the basic directories and files by executing @webgen create my_site@
-* New logging plugin lets you have more control over logging and log files
-* Now each website can have a plugin directory
-* New parameters for: Tag/WikiLink
-* Changed format of backing files -> have a look at the documentation
-* Removed obsolete Extension Loader plugin
-* Fixed bugs
-
-
-h3(#news-2005-03-17). 17.03.2005 - webgen 0.3.2
-
-
-Bug fix release for bug #1637 and other bugs
-
-
-h3(#news-2005-03-16). 16.03.2005 - webgen 0.3.1
-
-
-Major changes:
-
-* Better DefaultLayouter for image galleries
-* Output names for page files now customizable (see {plugin: File/PageHandler})
-* On-the-fly creation of thumbnails for images with RMagick
-* New tags: {plugin: Tag/Sitemap}
-* Tag @lang@ renamed, new name @langbar@!
-* New parameters for @menu@ tag
-* Automatic checking of HTML files on their validness
-* Fixed bugs
-
-
-h3(#news-2005-02-21). 21.02.2005 - webgen 0.3.0
-
-
-Major changes:
-
-* Textile, Markdown, RDOC and HTML as content format supported!!!
-* New tags: {plugin: Tag/WikiLink}
-* Improved plugin system
-* On-the-fly creation of new tags
-* Fixed bugs
-* Improved online documentation: pages on file handlers and tags now show parameters and other
-  additional info
-* Added comprehensive test suite
-* and more...

data/doc/src/plugin.template

@@ -1,10 +0,0 @@
---- content, textile
-h1. General Information
-
-<notextile>
-
-{describe: <%= node['plugin'] %>}
-
-{block: content}
-
-</notextile>

data/doc/src/project.todo

@@ -1,144 +0,0 @@
----
-webgen-metainfo:
-  inMenu: true
-  title: Project Status
----
-
-The following category defines all milestones for webgen:
-
-
-###### Milestones ######
-
-* Dez07 (2007-12-31) Bug fixes and small enhancements
-
-* Jun07 (2007-06-30) Bug fixes
-
-* Apr07 (2007-04-30) Bug fixes and small enhancements
-  - include submitted plugins
-  - fix issues that have arisen since the last release
-
-  This release gets a little bit delayed since I do not have enough time in April, will be released
-  in May!
-
-* Feb07 (2007-02-28) Bug fixes and small enhancements
-  - include patches/requests created since 0.4.1 release
-  - add support for sipttra (Simple Plain Text Tracker) files
-
-
-* F: Ideas and todo items for future versions
-
-  This milestone holds all ideas/todo items/requests which are implemented some
-  time in the future.
-
-
-Categories for implementation issues:
-
-
-###### Implementation (open) ######
-
-
-## Implementation (closed) ##
-
-* T003 [F] add additional tests for sipttra implementation
-  done in the next major version of webgen 0.5.0
-
-* T023 [F] Add the possibility to add a prefix to webgen tags
-  If the prefix is wg then a tag should look like \\{wg:menu:} or \\{wg:relocatable: default.css}
-  this is available in the next major version 0.5.0
-
-* T002 [F] add localization support for all files
-  See also FR#7891
-  This is available in the next major version 0.5.0
-
-* T004 [Feb07] use HTML as default format for templates
-  See also FR#7893
-
-* T006 [Feb07] add parameter for not showing index files in breadcrumb trail
-  See also PATCH#7942
-
-* T007 [Feb07] implement a plugin for storing/accessing global variables
-
-* T001 [Feb07] add support for sipttra files
-
-* T017 [Apr07] add the parameters from MenuStyle/Vertical to MenuStyle/Horizontal
-  added @startLevel@ and @maxLevels@ parameters to MenuStyle/Horizontal - the other parameters
-  from MenuStyle/Vertical aren't useful for MenuStyle/Horizontal
-
-* T018 [Apr07] add the submitted plugins from Andrea Censi and Jeremy Hinegardner
-  Also see FR#9707, Added Tag/HtmlMetaInfo from Andrea Censi, Tag/News from Jeremy Hinegardner,
-  ContentConverter/Maruku from Andrea Censi
-
-###### Bugs (open) ######
-
-## Bugs (closed) ##
-
-* T026 [Dez07] make Core/FileHandler aware of hidden files
-  use a parameter to enable usage of hidden files or enable it by default
-
-  now using a parameter Core/FileHandler:useHiddenFiles which is false by default
-
-* T027 [Dez07]  make gallery file handler multi-lingual aware
-  see mail exchange with Phil Hughes
-
-* T005 [Feb07] check all styles for correctly selected menu items
-  style issues because of new span element when File/DefaultHandler:linkToCurrentPage is false
-
-* T009 [Feb07] PluginManager#init: log typo for "creating plugin of class..."
-
-* T012 [Feb07] update copyright notices for included website templates
-  See also Bug#8725
-
-* T008 [Feb07] PluginLoader shouldn't load plugins that are already loaded in the DEFAULT_WRAPPER_MODULE
-  When site plugins use the load_plugin command to load plugins that are shipped with webgen and loaded by
-  default, some plugins don't work correctly as plugin classes get defined twice with different oids.
-
-* T013 [Feb07] fix TreeWalker
-  Make TreeWalker work as in 0.3.8 again, name it 'Misc/TreeWalker' and call it after building and
-  before writing tree
-
-* T016 [Apr07] fix order of data directory discovery
-  webgen searches now for a local directory first, then for a global one
-
-* T020 [Apr07] File/TemplateHandler should not use the default metainfo from File/PageHandler
-
-* T022 [Apr07] Remove plain website style due to incompatible license
-
-* T021 [Apr07] Problem with templates/example sites not working out of the box due to missing Textile support
-  Either
-
-  * Update templates to not use Textile sothat they work out of the box or
-  * include redcloth as dependency
-
-  Since not using Textile makes the templates/examples not very 'nice' to view, redcloth is now a dependency
-  of webgen.
-
-* T019 [Apr07] normalize EOL encoding to \n so that page files with any EOL encoding work properly
-  \r and \r\n are now converted to \n sothat the $ operator for regular expressions works correctly
-
-* T024 [Jun07] bug in gallery generation when images have upper case extensions
-  Also see FR#10736
-
-* T025 [Jun07] multiple thumbnails are created when running the demo photo gallery
-  for images that are used by two different image galleries
-
-
-Category for documentation issues:
-
-
-###### Documentation (open) ######
-
-
-## Documentation (closed) ##
-
-* T014 [F] add plugin developer documentation
-  - document how to write various plugins (file handler, tag, CLI command, ...)
-  - caveat when using classes in modules
-  --> done in version 0.5.0
-
-* T010 [Feb07] add some example sites
-  It was requested that one should be able to download some zipped examples sites from the examples
-  section showing basic use cases for webgen.
-
-* T011 [Feb07] add example section for sipttra style files
-
-* T015 [Feb07] add a resource reference page with the table of resources