diff options
Diffstat (limited to 'doc')
-rw-r--r-- | doc/bugs/aggregate_plugin_should_honour_a_post__39__s_mctime.mdwn | 7 | ||||
-rw-r--r-- | doc/bugs/blog_posts_not_added_to_mercurial_repo.mdwn | 3 | ||||
-rw-r--r-- | doc/bugs/htmltidy_has_no_possibilty_to_use_an_alternative_config_file_which_may_break_other_usages.mdwn | 4 | ||||
-rw-r--r-- | doc/plugins/contrib/hnb.mdwn | 2 | ||||
-rw-r--r-- | doc/plugins/contrib/hnb/discussion.mdwn | 19 | ||||
-rw-r--r-- | doc/plugins/teximg.mdwn | 4 | ||||
-rw-r--r-- | doc/plugins/teximg/discussion.mdwn | 2 | ||||
-rw-r--r-- | doc/plugins/write.mdwn | 2 | ||||
-rw-r--r-- | doc/todo/openid_user_filtering.mdwn (renamed from doc/bugs/openid_user_filtering.mdwn) | 0 |
9 files changed, 41 insertions, 2 deletions
diff --git a/doc/bugs/aggregate_plugin_should_honour_a_post__39__s_mctime.mdwn b/doc/bugs/aggregate_plugin_should_honour_a_post__39__s_mctime.mdwn index 6d837dbdd..b9a661e35 100644 --- a/doc/bugs/aggregate_plugin_should_honour_a_post__39__s_mctime.mdwn +++ b/doc/bugs/aggregate_plugin_should_honour_a_post__39__s_mctime.mdwn @@ -1 +1,8 @@ It would be nice if the [[aggregate_plugin|plugin/aggregate]] would try to extract the m/ctime out of each post and touch the files on the filesystem appropriately, so that ikiwiki reflects the actual time of the post via the [[inline_plugin|plugin/inline]], rather than the time when the aggregation ran to pull the post in. --[[madduck]] + +> Like this? (Existing code in aggregate.pm...) --[[Joey]] + + # Set the mtime, this lets the build process get the right creation + # time on record for the new page. + utime $mtime, $mtime, pagefile($guid->{page}) + if defined $mtime && $mtime <= time; diff --git a/doc/bugs/blog_posts_not_added_to_mercurial_repo.mdwn b/doc/bugs/blog_posts_not_added_to_mercurial_repo.mdwn index e754868cc..04fce53d7 100644 --- a/doc/bugs/blog_posts_not_added_to_mercurial_repo.mdwn +++ b/doc/bugs/blog_posts_not_added_to_mercurial_repo.mdwn @@ -19,3 +19,6 @@ If I then edit the blog post, **then** the file gets commited and I can see the >>you will consider this behavior a bug, since it's strictly speaking a misconfiguration but it >>still causes ikiwiki's mercurial backend to fail. A quick note in the docs might be a good idea. For my part, please >>close this bug, and thanks for the help. --[[buo]] + +>>> So, in a non-utf8 locale, mercurial fails to commit if the commit +>>> message contains utf8? --[[Joey]] diff --git a/doc/bugs/htmltidy_has_no_possibilty_to_use_an_alternative_config_file_which_may_break_other_usages.mdwn b/doc/bugs/htmltidy_has_no_possibilty_to_use_an_alternative_config_file_which_may_break_other_usages.mdwn index 163f01750..02caac4a3 100644 --- a/doc/bugs/htmltidy_has_no_possibilty_to_use_an_alternative_config_file_which_may_break_other_usages.mdwn +++ b/doc/bugs/htmltidy_has_no_possibilty_to_use_an_alternative_config_file_which_may_break_other_usages.mdwn @@ -9,3 +9,7 @@ I see two possibilities how to fix this: -show-warnings no --tidy-mark no --write-back yes');" -- This is the fastest fix, but not very elegant, since it doesn't solve the general problem. 2) Make it configurable via ikiwiki.setup as e.g.with the tags plugin. Haven't looked into this code yet. + +> I don't understand why you're talking about setting --write-back. The +> htmltidy plugin communicates with tidy using stdio. No files are used, so +> write-back settings should be irrelevant. --[[Joey]] diff --git a/doc/plugins/contrib/hnb.mdwn b/doc/plugins/contrib/hnb.mdwn index 4f4457cd6..8352e1a9b 100644 --- a/doc/plugins/contrib/hnb.mdwn +++ b/doc/plugins/contrib/hnb.mdwn @@ -1,5 +1,5 @@ [[template id=plugin name=hnb author="[[XTaran]]"]] -[[tag type/format]] +[[tag type/format type/slow]] This plugin allows ikiwiki to process `.hnb` XML files, as created by the Hierachical Notebook [hnb](http://hnb.sourceforge.net/). To use it, you need to have diff --git a/doc/plugins/contrib/hnb/discussion.mdwn b/doc/plugins/contrib/hnb/discussion.mdwn new file mode 100644 index 000000000..716753878 --- /dev/null +++ b/doc/plugins/contrib/hnb/discussion.mdwn @@ -0,0 +1,19 @@ +I've reviewed this plugin's code, and there is one major issue with it, +namely this line: + + system("hnb '$params{page}.hnb' 'go root' 'export_html $tmp' > /dev/null"); + +This could potentially allow execution of artibtary shell code, if the filename +contains a single quote. Which ikiwiki doesn't allow by default, but I prefer +to never involve a shell where one is not needed. The otl plugin is a good +example of how to safely fork a child process without involving the shell. + +Other problems: + +* Use of shell mktemp from perl is suboptimal. File::Temp would be better. +* The htmlize hook should not operate on the contents of `$params{page}.hnb`. + The content that needs to be htmlized is passed in to the hook in + `$params{content}`. + +If these problems are resolved and a copyright statement is added to the file, +I'd be willing to include this plugin in ikiwiki. --[[Joey]] diff --git a/doc/plugins/teximg.mdwn b/doc/plugins/teximg.mdwn index 5c35aa2e8..588bf5407 100644 --- a/doc/plugins/teximg.mdwn +++ b/doc/plugins/teximg.mdwn @@ -3,6 +3,10 @@ This plugin renders LaTeX formulas into images. +Of course you will need LaTeX installed for this to work. The plugin +also uses mhchem.sty, which in Debian is in the texlive-science package and +may not be part of a regular texlive installation. + ## examples \[[teximg code="\ce{[Cu(NH3)3]^{2+}}"]] diff --git a/doc/plugins/teximg/discussion.mdwn b/doc/plugins/teximg/discussion.mdwn index 17f677c21..019298670 100644 --- a/doc/plugins/teximg/discussion.mdwn +++ b/doc/plugins/teximg/discussion.mdwn @@ -1,2 +1,4 @@ A minor nitpick: if, while editing, you preview your page two times without changing anything, the second time produces an error. --[[buo]] + +> Fixed --[[Joey]] diff --git a/doc/plugins/write.mdwn b/doc/plugins/write.mdwn index 410d49aaf..b9d7c01c2 100644 --- a/doc/plugins/write.mdwn +++ b/doc/plugins/write.mdwn @@ -512,7 +512,7 @@ version of the file. In particular, in preview mode, this should still be called even if the file isn't going to be written to during the preview. Ikiwiki uses this information to automatically clean up rendered files when -the page that rendered them goes away or is changes to no longer render +the page that rendered them goes away or is changed to no longer render them. will_render also does a few important security checks. #### `pagetype($)` diff --git a/doc/bugs/openid_user_filtering.mdwn b/doc/todo/openid_user_filtering.mdwn index 8b2d0082e..8b2d0082e 100644 --- a/doc/bugs/openid_user_filtering.mdwn +++ b/doc/todo/openid_user_filtering.mdwn |