> I''m very new to webgen, but I like the concept. I have some
questions,
> please try to bare with me! ;-)
Welcome to webgen! :-)
> Is there a way to have more than page-file on a single web page?
The extension that handles page files
(http://webgen.rubyforge.org/documentation/sourcehandler/page.html)
converts one page to one html file. However, you can pack anything in a
page file. For example, you could iterate over all page files of a
directory and render them into one output file. This has to be done
manually, ie. you have to code the small ERB fragment for such an
iteration yourself in the page file - but this is not difficult, also
see below.
> Is there a way to mark my page-files with "category tags" and
show a
> list of categories on a page. If a category X is clicked on this page,
> another page with a listing of the names of all posts marked with
> category X is shown.
On the TODO list but currently not implemented. If you know the Ruby
programming language, you could try to implement this yourself. I also
remember a recent thread with a similar topic - the subject was " 2
questions: printable version / labels".
> If any of the answers to the above two questions is yes, is there
> support for pagination?
No, but any ideas on how this might be implemented are very welcome!
For example, how should webgen decide when to paginate a certain page
file? Does it have to know the contents of the page file or is
pagination only something for special pages?
> Is there a tag to link posts together. It could be used if I''m
writing
> a tutorial series for example. If there isn''t that''s not
a big deal as
> I could just link between the pages the normal way.
No, such a tag is not available. What exactly do you mean by linking
posts together? Should webgen have a tag that automatically displays
all "linked posts"? How should such "linked posts" be
defined? Should
webgen try to determine them automatically by checking for similar
words on the pages like some other generators do?
> How do I generate a RSS or Atom feed for my pages? Do I have any
> control over how the feed is built and what''s included?
Use the feed source handler
(http://webgen.rubyforge.org/documentation/sourcehandler/feed.html). It
allows you to generate RSS and/or atom feeds from a set of page files.
Some attributes of the generated feed are customizable.
> The list of available extensions (
> http://webgen.rubyforge.org/documentation/extensions.html ), are all
> those extensions included and available to be used by default? (Even
> though the ext dir is empty ) I''m a bit confused at which tags I
have
> at my disposal when writing pages and changing the template. Is there
> a compact list somewhere? In case there isn''t, would it be of
interest
> if I helped out creating one? (Maybe it''s not necessary and
I''m too
> new to webgen to see it :-) )
Yes, all those extensions are shipped with webgen and can be used. Some
of the extensions need external libraries (like the feed handler), so
you have to install them before you can actually use the extension.
Extension are loaded "on demand", so if you don''t use, for
example, the
feed handler, you also don''t need to have the dependent libraries
installed. This is true for all extensions.
The ext/ directory of a webgen website is for adding extensions
yourself, for example, when you implement some webgen tag or source
handler.
So: every extension listed on that page can be used with the default
webgen installation!
If you have any other questions, just shoot! :-)
-- Thomas