aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJoey Hess <joey@gnu.kitenet.net>2010-04-16 17:53:31 -0400
committerJoey Hess <joey@gnu.kitenet.net>2010-04-16 17:53:31 -0400
commitd3ebc80cd07ea42dc574d9e1421c300b85dc8daa (patch)
treee965a4d814a81497a83aee1b53586d9a5f6da367 /doc
parentb14f84c4acccbc8450a9102b3b647013989b27bb (diff)
parente3e245956fe6dcbb884428d24bed4cb9eb7c8ba7 (diff)
downloadikiwiki-d3ebc80cd07ea42dc574d9e1421c300b85dc8daa.tar
ikiwiki-d3ebc80cd07ea42dc574d9e1421c300b85dc8daa.tar.gz
Merge branch 'master' of ssh://git.ikiwiki.info/srv/git/ikiwiki.info
Diffstat (limited to 'doc')
-rw-r--r--doc/examples/softwaresite/news.mdwn2
-rw-r--r--doc/todo/Multiple_categorization_namespaces.mdwn19
-rw-r--r--doc/todo/auto-create_tag_pages_according_to_a_template.mdwn5
3 files changed, 25 insertions, 1 deletions
diff --git a/doc/examples/softwaresite/news.mdwn b/doc/examples/softwaresite/news.mdwn
index 9b53c7d99..20efba6e0 100644
--- a/doc/examples/softwaresite/news.mdwn
+++ b/doc/examples/softwaresite/news.mdwn
@@ -1,4 +1,4 @@
-This is where annoucements of new releases, features, and other news is
+This is where announcements of new releases, features, and other news is
posted. FooBar users are recommended to subscribe to this page's RSS
feed.
diff --git a/doc/todo/Multiple_categorization_namespaces.mdwn b/doc/todo/Multiple_categorization_namespaces.mdwn
index eb1f58cfa..ee3bbd88d 100644
--- a/doc/todo/Multiple_categorization_namespaces.mdwn
+++ b/doc/todo/Multiple_categorization_namespaces.mdwn
@@ -51,3 +51,22 @@ and the tags would appear at the bottom of the post, the Rubrica next to the tit
>> I would like to point out however that there are some functional differences between categorization metadata vs other metadata that might suggest to keep fields and (my extended) tags separate. For examples, in feeds you'd want all categorization metadata to fall in one place, with some appropriate manipulation (which I still have to implement, by the way), while things like author or title would go to the corresponding feed item properties. Although it all would be possible with appropriate report or template juggling, having such default metadata handled natively looks like a bonus to me.
>>> Whereas I prefer being able to control such things with templates, because it gives more flexibility AND control. - K.A.
+
+>>>> Flexibility and control is good for tuning and power-usage, but sensible defaults are a must for a platform to be usable out of the box without much intervention. Moreover, there's a possible problem with what kind of data must be passed over to templates.
+
+Aside from the name of the plugin (and thus of the main directive), which could be `tag`, `meta`, `field` or whatever (maybe extending `meta` would be the most sensible choice), the features we want are
+
+ 1. allow multiple values per type/attribute/field/whatever (fields currently only allows one)
+ 2. allow both hidden and visible references (à la tag vs taglink)
+ 3. allow each type/attribute/field to be exposed under multiple queries (e.g. tags and categories; this is mostly important for backwards compatibility, not sure if it might have other uses too)
+ 4. allow arbitrary types/attributes/fields/whatever (even 'undefined' ones)
+
+Each type/attribute/field/whatever (predefined, user-defined, arbitrary) would thus have the following parameters:
+
+ * `directive` : the name of the directive that can be used to set the value as a hidden reference; we can discuss whether, for pre- or user-defined types, it being undef means no directive or a default directive matching the attribute name would be defined.
+ * `linkdirective` : the name of the directive that can be used for a visible reference; no such directive would be defined by default
+ * `linktype` : link type for (hidden and visible) references
+ * `linkbase` : akin to the tagbase parameter
+ * `queries` : list of template queries this type/attribute/field/whatever is exposed to
+
+Where this approach is limiting is on the kind of data that is passed to (template) queries. The value of the metadata fields might need some massaging (e.g. compare how tags are passed to tags queries vs cateogires queries). I have problems on picturing an easy way to make this possible user-side (i.e. via templates and not in Perl modules). Suggestions welcome.
diff --git a/doc/todo/auto-create_tag_pages_according_to_a_template.mdwn b/doc/todo/auto-create_tag_pages_according_to_a_template.mdwn
index 1259552bf..8fc97578c 100644
--- a/doc/todo/auto-create_tag_pages_according_to_a_template.mdwn
+++ b/doc/todo/auto-create_tag_pages_according_to_a_template.mdwn
@@ -236,6 +236,11 @@ wrong direction.
>>>>> so it was necessary. (Another way to look at this is that
>>>>> `%pagestate` is not the ideal data structure.) --[[Joey]]
+>>>>>> Aha! Having looked at [[plugins/write]] again, it turns out that what this
+>>>>>> feature should really use is `%wikistate`, I think? :-) --[[smcv]]
+
+>>>>> Ok, now I know what you mean. --[[David_Riebenbauer]]
+
>>> * `autoindex` forgets that a page was deleted when that page is
>>> re-created