[Gaea] Named optional attributes
Matias Capeletto <[email protected]>
| Newsgroups | gmane.comp.lib.boost.documentation |
|---|---|
| Message-ID | <CAJiTyxyvf-BNvVJ0b-K2VqNwtmjqiVd10nfE9ies9utRz1M3pw@mail.gmail.com> |
Hi,
I was trying to see how some of the current Quickbook constructs will
look in the IR Joel is proposing based on Gaea (
http://pastebin.com/FBdpSsS8 ).
There are some things that are not possible with that definition and
seems to be necessary to represent complete documents.
>From Quickbook docs: "From version 1.5, you can also use DocBook
imagedata attributes"
[$image.jpg [width 200in] [height 200in]]
I think it will be a good idea to support this kind of named optional
attributes directly in Gaea. If we augment the definition of templates
like:
[def [$ path [.width] [.height]]
... [path]
... [if [defined [width]] [ ...[width]... ] [ ... ]] // Or something
like this...
]
We can then use them like:
[$image.jpg [.width 200in][.height 200in]]
This is very close to the current [$ ...] and even the main argument
can remain unwrapped in []s, following current practice.
Examples in other constructs:
[document The Document Title
[.quickbook 1.5]
[.version 1.0]
[.id the_document_name]
[.dirname the_document_dir]
[.copyright 2000 2002 2003 Joe Blow, Jane Doe]
[.purpose The document's reason for being]
[.category The document's category]
[.authors [Blow, Joe] [Doe, Jane]]
[.license The document's license]
[.source_mode source-type]
...
[section Title [.id section_id]
...
]
...
]
Best regards
Matias