aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorchrysn <chrysn@fsfe.org>2013-08-22 11:51:54 +0200
committerchrysn <chrysn@fsfe.org>2013-08-22 11:51:54 +0200
commit106525199001cfd9c466937cb38568f003351661 (patch)
tree1cea07847fb9dbf31fcd2fd15ca745102faa83f0 /doc
parent60314c0d308f762604941ccf492f4bb82d29d698 (diff)
downloadikiwiki-106525199001cfd9c466937cb38568f003351661.tar
ikiwiki-106525199001cfd9c466937cb38568f003351661.tar.gz
vcard proposal
Diffstat (limited to 'doc')
-rw-r--r--doc/forum/debconf13_ikiwiki_bof.mdwn19
-rw-r--r--doc/todo/vCard_rendering.mdwn100
-rw-r--r--doc/users/chrysn/interests.mdwn1
3 files changed, 102 insertions, 18 deletions
diff --git a/doc/forum/debconf13_ikiwiki_bof.mdwn b/doc/forum/debconf13_ikiwiki_bof.mdwn
index fcf03e87a..8659da7c3 100644
--- a/doc/forum/debconf13_ikiwiki_bof.mdwn
+++ b/doc/forum/debconf13_ikiwiki_bof.mdwn
@@ -105,21 +105,4 @@ The topic of combining ikiwiki with
[[in another event|http://penta.debconf.org/dc13_schedule/events/1087.en.html]]
during the same DebConf.
-Short outline: Calypso's collection of vCards can go into an ikiwiki underlay,
-and be rendered with a yet-to-be-completed `.vcf` rendering plugin.
-
-Remaining questions:
-
-* It would be nice to have all contacts inside a group. Should they all be
- tagged 'Contact'? / How can that be localized?
-
- Using plugin options in the VCF plugin would be an option. Also, another
- option could contain a string to be prefixed to the categories defined inside
- the vCard.
-
-* Linking vCards is not trivial, as they don't have friendly names. This calls
- for the [[todo/alias directive]].
-
-* Would the same thing be useful with contacts too?
-
-A partial implementation is pending publication.
+For further details, see [[todo/vCard rendering]].
diff --git a/doc/todo/vCard_rendering.mdwn b/doc/todo/vCard_rendering.mdwn
new file mode 100644
index 000000000..d9a98bdee
--- /dev/null
+++ b/doc/todo/vCard_rendering.mdwn
@@ -0,0 +1,100 @@
+Addressbooks are commonly kept on a CardDAV server, where the individual
+contacts are represented as single vCard (`.vcf`) files. Supporting those files
+as a source format could facilitate integration between ikiwiki and address
+books, and allow linking wiki entries to people. With the plugin presented here
+and the [[calypso|http://keithp.com/blogs/calypso/]] server, that is easily
+possible.
+
+The idea was first presented on [[forum/debconf13 ikiwiki bof|DebConf13]] by
+[[chrysn]].
+
+Software involved
+=================
+
+* CardDAV server
+
+ ikiwiki generates its pages from the local file system. Using the
+ [[calypso|http://keithp.com/blogs/calypso/]] CardDAV/CalDAV server makes that
+ trivial, as it stores its contacts as plain files already (and under git
+ version control!).
+
+ The files can be pulled into ikiwiki in the form of an underlay.
+
+* Rendering VCF files
+
+ A python plugin called `vcf` has been published in chrysn's plugin repository
+ at `git://prometheus.amsuess.com/ikiwiki-plugins`. It supports contact images
+ (as `data:` URLs) as well as all the attributes Evolution generates, creates
+ external hyperlinks for those attributes that can be dereferenced (including
+ telephone numbers), and renders vCard categories into ikiwiki tags.
+
+ Python was chosen as a programming language due to the availability of the
+ [[`vobject`|http://vobject.skyhouseconsulting.com/]] python module and the
+ author's personal preference.
+
+* Linking to contacts
+
+ File names of vCard files are usually not usable
+ (`4FD53349-51280409-28AD50CB.vcf`). To make links like "`I've talked to
+ \[[John Doe]] about this`" possible, the [[todo/alias directive]] has to be
+ implemented in the same repository. (Work in progress.)
+
+Issues / Further development
+============================
+
+* The rendered output is currently a plain definition list, and could need some
+ theming and/or grouping.
+
+ The current implementation does not use templating, and instead generates
+ HTML directly in Python (with the help of the
+ [[MarkupSafe|https://pypi.python.org/pypi/MarkupSafe]] module). Due to the
+ [[limitations of the foreign language API|plugins/write/external]], ikiwiki's
+ regular templating can't be used anyway.
+
+* Addresses are rendered by `python-vcard` builtin address renderer (plus a
+ hack to get unicode out of it), and are not always most beautiful; moreover,
+ this kind of rendering is not themable.
+
+* The `paramlist` words in the vcards are plain dumped out after the respective
+ fields. That's unsuitable for theming, and would need localization.
+
+* In general, the plugin is not internationalized.
+
+* All VCF pages currently receive a 'Contact' tag. That needs configurability
+ and/or localization. In the same vein, prefix configuration for the category
+ taggings would be useful too.
+
+* The alias plugin is not ready yet.
+
+* vCards can not be edited. To be precise: vCards can be edited, but they show
+ vCard sources which are not suitable for user editing. Moreover, the changes
+ would be committed into the wiki main from the underlay, and not travel back.
+
+ Two approaches would make editing feasible, a relatively easy one and a
+ hard-but-wow-if-it-works one:
+
+ * Use a dedicated vCard editing online tool like CardDavMate, which accepts
+ URLs for editing (unlike CardDavMate). Ideally we would even hijack the
+ edit button on vCard pages to take the user to a proper editor.
+
+ * Have a simple edit mask for vCard objects. (It'd be ok if it was incomplete
+ with respect to fields, the vCard format is designed to make that
+ possible). That's related to the
+ [[forum/an alternative approach to structured data|structured data]] issue.
+
+ In such a setup, the vCard list would not go to an underlay, but rather to
+ a git checkout in a subdirectory or a submodule, from which the change
+ could then be pushed back to Calypso. (AFAIK, different git roots are not
+ supported in ikiwiki yet.)
+
+* Would such a renderer be useful for vCalendar too? (vCard and vCalendar only
+ differ in what they can represent, not in how they do it.)
+
+Status
+======
+
+The setup is currently usable, but just barely so. Once the basic issues are
+solved (aliases, parameters for tags, enhanced appearence), I will suggest this
+plugin for inclusion in ikiwiki.
+
+-- [[chrysn]]
diff --git a/doc/users/chrysn/interests.mdwn b/doc/users/chrysn/interests.mdwn
index 592ef58e1..aafe7e4a2 100644
--- a/doc/users/chrysn/interests.mdwn
+++ b/doc/users/chrysn/interests.mdwn
@@ -28,4 +28,5 @@ these are the topics [[chrysn]] is or was interested in inside ikiwiki:
* [[todo/tracking bugs with dependencies]]
* [[todo/unaccent url instead of encoding]]
* [[todo/Using page titles in internal links]]
+* [[todo/vCard rendering]]
* [[todo/wikitrails]]