]> git.vanrenterghem.biz Git - git.ikiwiki.info.git/commitdiff
generic insert links: it's a Markdown file
authorGiuseppe Bilotta <giuseppe.bilotta@gmail.com>
Sun, 2 Jan 2011 22:08:26 +0000 (23:08 +0100)
committerJoey Hess <joey@kitenet.net>
Wed, 5 Jan 2011 16:19:18 +0000 (12:19 -0400)
(cherry picked from commit 139c050ca48c2fe7bdcd4ea22623739cbb25ceda)

doc/todo/generic_insert_links [deleted file]
doc/todo/generic_insert_links.mdwn [new file with mode: 0644]

diff --git a/doc/todo/generic_insert_links b/doc/todo/generic_insert_links
deleted file mode 100644 (file)
index 050f32e..0000000
+++ /dev/null
@@ -1,24 +0,0 @@
-The attachment plugin's Insert Links button currently only knows
-how to insert plain wikilinks and img directives (for images).
-
-[[wishlist]]: Generalize this, so a plugin can cause arbitrary text
-to be inserted for a particular file. --[[Joey]] 
-
-Design:
-
-Add an insertlinks hook. Each plugin using the hook would be called,
-and passed the filename of the attachment. If it knows how to handle
-the file type, it returns a the text that should be inserted on the page.
-If not, it returns undef, and the next plugin is tried.
-
-This would mean writing plugins in order to handle links for 
-special kinds of attachments. To avoid that for simple stuff,
-a fallback plugin could run last and look for a template
-named like `templates/embed_$extension`, and insert a directive like:
-
-       \[[!template id=embed_vp8 file=my_movie.vp8]]
-
-Then to handle a new file type, a user could just make a template
-that expands to some relevant html. In the example above,
-`templates/embed_vp8` could make a html5 video tag, possibly with some
-flash fallback code even.
diff --git a/doc/todo/generic_insert_links.mdwn b/doc/todo/generic_insert_links.mdwn
new file mode 100644 (file)
index 0000000..050f32e
--- /dev/null
@@ -0,0 +1,24 @@
+The attachment plugin's Insert Links button currently only knows
+how to insert plain wikilinks and img directives (for images).
+
+[[wishlist]]: Generalize this, so a plugin can cause arbitrary text
+to be inserted for a particular file. --[[Joey]] 
+
+Design:
+
+Add an insertlinks hook. Each plugin using the hook would be called,
+and passed the filename of the attachment. If it knows how to handle
+the file type, it returns a the text that should be inserted on the page.
+If not, it returns undef, and the next plugin is tried.
+
+This would mean writing plugins in order to handle links for 
+special kinds of attachments. To avoid that for simple stuff,
+a fallback plugin could run last and look for a template
+named like `templates/embed_$extension`, and insert a directive like:
+
+       \[[!template id=embed_vp8 file=my_movie.vp8]]
+
+Then to handle a new file type, a user could just make a template
+that expands to some relevant html. In the example above,
+`templates/embed_vp8` could make a html5 video tag, possibly with some
+flash fallback code even.